2.2 documentation
[jalview.git] / help / html / keys.html
1 <html>
2 <head><title>Key Strokes</title></head>
3 <body>
4 <p><strong>Key Strokes</strong></p>
5 <p>
6 Jalview has two distinct modes of keyboard operation - in 'Normal'
7  mode, single keystrokes (including those shown next to menu items)
8  provide short cuts to common commands. In <a
9  href="features/cursorMode.html">'Cursor'</a> mode (enabled by
10  <em>F2</em>), some of these are disabled and more complex 'Compound
11  Keystrokes' can be entered to perform precise navigation, selection
12  and editing operations.
13 </p>
14 <table border="1">
15   <tr> 
16     <td><strong>Key</strong></td>
17     <td><strong>Which Mode</strong></td>
18     <td><strong>Action</strong></td>
19   </tr>
20   <!--<tr>
21 <td><strong>Escape</strong></td><td>Both</td>
22 <td>The Panic button.</td></tr>
23 <tr> -->
24   <tr><td><strong> Escape</strong></td>
25   <td>Normal</td>
26   <td>Clears the current selection region, highlighted columns and highlghted 
27     residues. </td>
28   </tr>
29   <tr> 
30     <td><strong>Escape</strong></td>
31     <td>Cursor</td>
32     <td>As in normal mode, but also cancels any partially entered commands</td></tr>
33   <tr> 
34     <td><strong><em>F1</em></strong></td>
35     <td>Both</td>
36     <td>Show Help Documentation</td></tr>
37   <tr> 
38     <td><strong><em>F2</em></strong></td>
39     <td></td>
40     <td>Toggle Cursor mode on / off</td>
41   </tr>
42   <tr> 
43     <td><strong>Control 'Z'</strong></td>
44     <td>Both</td>
45     <td>Undoes the last sequence edit</td>
46   </tr>
47   <tr> 
48     <td><strong>Control 'Y'</strong></td>
49     <td>Both</td>
50     <td>Redo the last sequence edit undone.</td>
51   </tr>
52   <tr> 
53     <td><strong>Up Arrow</strong></td>
54     <td>Normal</td>
55     <td>Moves selected sequence(s) up the alignment</td></tr>
56   <tr> 
57     <td><strong>Down Arrow</strong></td>
58     <td>Normal</td>
59     <td>Moves selected sequence(s) down the alignment.</td></tr>
60   <tr><td><strong>Cursor Keys<br>
61     (Arrow Keys)</strong></td>
62     <td>Cursor</td>
63     <td>Move cursor around alignment</td>
64   </tr>
65   <tr><td><strong>Page Up</strong></td><td>Both</td><td>Scroll up the alignment view</td></tr>
66   <tr><td><strong>Page Down</strong></td><td>Both</td><td>Scroll down the alignment view</td></tr>
67   <tr> 
68     <td><strong>Control 'A'</strong></td>
69     <td>Both</td>
70     <td>Selects all sequences in the alignment</td>
71   </tr>
72   <tr>
73   <td><strong>Control 'I'</strong></td>
74   <td>Both
75   </td>
76   <td>Invert sequence selection.
77   </td>
78   </tr>
79   <tr>
80   <td><strong>Control Alt 'I'</strong></td>
81   <td>Both
82   </td>
83   <td>Invert column selection.
84   </td>
85   </tr>
86   <tr> 
87     <td><strong>Control 'C'</strong></td>
88     <td>Both</td>
89     <td>Copies the selected region into the clipboard as a Fasta format file<br> 
90       <em>nb. not available in applet, as no clipboard is available</em></td>
91   </tr>
92   <tr> 
93     <td><strong>Control 'V'</strong></td>
94     <td>Both</td>
95     <td>
96     Paste the contents of the clipboard to the current alignment
97     window. (Alignment Window->Edit->Paste->Add to this Alignment)<br>
98     <em>nb. if the paste is from a Jalview alignment, any sequence and alignment 
99     annotations will also be copied over.</em></td></tr>
100   <tr> 
101     <td><strong>Control Shift 'V'</strong></td>
102     <td>Both</td>
103     <td>Paste the contents of the clipboard to a new alignment
104     window. (Alignment Window->Edit->Paste->To New Alignment)</td>
105   </tr>
106   <tr> 
107     <td><strong>Control 'X'</strong></td>
108     <td>Both</td>
109     <td>Cuts the (fully) selected sequences from the alignment. 
110       <!-- not yet in this version 
111 This will not happen if only some
112 columns are selected, you should use the <a href="features/regionHiding.html">Hide Regions feature</a> instead.-->
113     </td>
114   </tr>
115   <tr> 
116     <td><strong>Control 'F'</strong></td>
117     <td>Both</td>
118     <td>Launches the search window</td>
119   </tr>
120   <tr> 
121     <td><strong>H</strong></td>
122     <td>Both</td>
123     <td>Hides / Reveals selected columns and sequences</td>
124   </tr>
125   <tr> 
126     <td><strong>Control 'H'</strong></td>
127     <td>Both</td>
128     <td>Hides / Reveals selected columns</td>
129   </tr>
130   <tr> 
131     <td><strong>Shift 'H'</strong></td>
132     <td>Both</td>
133     <td>Hides / Reveals selected sequences</td>
134   </tr>
135   <tr> 
136     <td><strong>Control 'O'</strong></td>
137     <td>Both</td>
138     <td>Input new alignment from file</td>
139   </tr>
140   <tr> 
141     <td><strong>Control 'S'</strong></td>
142     <td>Both</td>
143     <td>Save alignment with current filename and format</td>
144   </tr>
145   <tr> 
146     <td><strong>Control Shift 'S'</strong></td>
147     <td>Both</td>
148     <td>Save alignment as a new file or with a different format</td>
149   </tr>
150   <tr> 
151     <td><strong>Control 'P'</strong></td>
152     <td>Both</td>
153     <td>Opens the print dialog box to print the current view</td>
154   </tr>
155   <tr> 
156     <td><strong>Control 'W'</strong></td>
157     <td>Both</td>
158     <td>Closes the current view or the current alignment</td>
159   </tr>
160   <tr> 
161     <td><strong>Backspace</strong></td>
162     <td>Normal</td>
163     <td>Delete the currently selected rows or columns from the alignment.</td>
164   </tr>
165   <tr> 
166     <td><strong>Control 'L'</strong></td>
167     <td>Left</td>
168     <td>Remove columns to left of left-most column marker.</td>
169   </tr>
170   <tr> 
171     <td><strong>Control 'R'</strong></td>
172     <td>Both</td>
173     <td>Remove columns to right of right-most column marker.</td>
174   </tr>
175   <tr> 
176     <td><strong>Control 'E'</strong></td>
177     <td>Both</td>
178     <td>Remove gapped columns</td>
179   </tr>
180   <tr> 
181     <td><strong>Control Shift 'E'</strong></td>
182     <td>Both</td>
183     <td>Remove all gaps</td>
184   </tr>
185   <tr> 
186     <td><strong>Control 'D'</strong></td>
187     <td>Both</td>
188     <td>Open the 'Remove redundancy' Dialog box.</td>
189   </tr>
190
191   <tr> 
192     <td><strong></strong></td>
193     <td>Normal</td>
194     <td></td>
195   </tr>
196
197
198 </table>
199 <p>The compound commands available in the Cursor mode are summarised
200 below. Single letter commands can be prefixed by digits to specify a repetition
201 number, and some more complex commands take one or more numeric
202 parameters (prefixing the command key and separated by commas).</p>
203 <table border=1><tr><td><strong>Compound
204 Command</strong></td><td>Mode</td><td>Action (and parameter description)</td></tr>
205 <tr><td><strong>0-9</strong></td><td>Cursor</td><td>Begin entering a
206 numeric parameter (<strong><em>p</em></strong>) or repetition number for a cursor movement or edit
207 command.</td></tr>
208 <tr><td><strong>,</strong></td><td>Cursor</td><td>Separates one or
209 more numeric parameters (<em>e.g. <strong>p1</strong>,<strong>p2</strong></em>) for a command.</td></tr>
210 <tr><td><strong><strong><em>p1</em></strong>,<strong><em>p2</em></strong><br>Return</strong></td><td>Cursor</td><td>Move cursor to a particular column (<strong><em>p1</em></strong>) and row (<strong><em>p2</em></strong>) in the alignment.<br><em>e.g. '5,6&lt;Return&gt;' moves the cursor to the 5th column in the 6th sequence.</em></td></tr>
211 <tr><td><strong><em>p</em>S</strong></td><td>Cursor</td><td>Jump to the <strong><em>p</em></strong>'th sequence in the alignment.</td></tr>
212 <tr><td><strong><em>p</em>P</strong></td><td>Cursor</td><td>Jump to <em><strong>p</strong></em>'th amino acid in current sequence.</td></tr>
213 <tr><td><strong><em>p</em>C</strong></td><td>Cursor</td><td>Jump to <em><strong>p</strong></em>'th column in the alignment.</td></tr>
214 <tr><td><strong>Q</strong></td><td>Cursor</td><td>Marks the top left corner of the selection area</td></tr>
215 <tr><td><strong>M</strong></td><td>Cursor</td><td>Marks the bottom right corner of the selection area</td></tr>
216 <tr><td><strong><em>[p]</em><br>Space</strong></td><td>Cursor</td><td>Inserts
217 one (or optionally <strong><em>p</em></strong>) gaps at the current position.<br><em>Hold down Control or Shift to insert gaps over a sequence group</em></td></tr>
218 <tr><td><strong><em>[p]</em><br>Delete<br></strong></td><td>Cursor</td><td>Removes
219 one (or optionally <strong><em>p</em></strong>) gaps at the cursor position.<br><em>Hold down Control or Shift to insert gaps over a sequence group</em></td></tr>
220 <tr><td><strong><em>[p]</em><br>Backspace<br></strong></td><td>Cursor</td><td>Removes
221 one (or optionally <strong><em>p</em></strong>) gaps at the cursor position.<br><em>Hold down Control or Shift to insert gaps over a sequence group</em></td></tr></table>
222 <p>&nbsp;</p>
223 <p>&nbsp;</p>
224 </body>
225 </html>