S2PLOT:Controls
From S2PLOT
(Difference between revisions)
| Revision as of 06:49, 26 October 2007 S2plot admin (Talk | contribs) (→Callback System) ← Previous diff |
Current revision S2plot admin (Talk | contribs) |
||
| Line 5: | Line 5: | ||
| ===General Interaction and Camera Control=== | ===General Interaction and Camera Control=== | ||
| - | <table class="type1" width=100%> | + | <table width=100% border=1> |
| - | <tr><th width=35% class="gray"><p class="tablehead">Key</p></th><th class="gray"><p class="tablehead">Description</p></th></tr> | + | <tr><th width=25% >Key</th><th>Description</th></tr> |
| <tr><td>Left Mouse Button (Hold)</td><td>Free rotation of geometry</td></tr> | <tr><td>Left Mouse Button (Hold)</td><td>Free rotation of geometry</td></tr> | ||
| <tr><td>Middle Mouse Button (Hold)</td><td>Rotate (roll) camera clockwise/anti-clockwise</td></tr> | <tr><td>Middle Mouse Button (Hold)</td><td>Rotate (roll) camera clockwise/anti-clockwise</td></tr> | ||
| + | <tr><td>Right Mouse Button (Click)</td><td>Select/deselect a handle - see [[Function:cs2shcb | cs2shcb]]</td></tr> | ||
| + | <tr><td>Shift-Right Mouse Button (Hold)</td><td>Drag a handle - see [[Function:cs2sdhcb | cs2sdhcb]]</td></tr> | ||
| <tr><td>f, F</td><td>Focus camera on centre of geometry</td></tr> | <tr><td>f, F</td><td>Focus camera on centre of geometry</td></tr> | ||
| <tr><td>h, H, Home</td><td>Home position - Returns camera to original starting position</td></tr> | <tr><td>h, H, Home</td><td>Home position - Returns camera to original starting position</td></tr> | ||
| Line 20: | Line 22: | ||
| <tr><td> +, - </td><td>Track camera forward/backwards</td></tr> | <tr><td> +, - </td><td>Track camera forward/backwards</td></tr> | ||
| <tr><td> [, ] </td><td>Roll anticlockwise, clockwise - same as the middle mouse button</td></tr> | <tr><td> [, ] </td><td>Roll anticlockwise, clockwise - same as the middle mouse button</td></tr> | ||
| + | <tr><td> {, } </td><td>Increase/decrease the eye-separation for stereo modes</td></tr> | ||
| <tr><td>a, A</td><td>Toggle autospin</td></tr> | <tr><td>a, A</td><td>Toggle autospin</td></tr> | ||
| - | <tr><td><,></td><td>Decrease/increase autospin and interaction speed</td></tr> | + | <tr><td><,></td><td>Decrease/increase camera interaction speed</td></tr> |
| - | <tr><td>q, Q, Esc</td><td>Quit the program</td></tr> | + | <tr><td>*,/</td><td>Decrease/increase autospin speed</td></tr> |
| + | <tr><td>~</td><td>Activate the command prompt for use with [[Function:cs2spcb | cs2spcb]]</td></tr> | ||
| + | <tr><td>`</td><td>Toggle between odd and even scan lines for the /s2inter (interlaced stereo) device mode</td></tr> | ||
| + | <tr><td>shift-ENTER</td><td>Return control to program when using [[Function:s2disp | s2disp]]</td></tr> | ||
| + | <tr><td>TAB</td><td>Move between panels: see [[Function:xs2cp | xs2cp]]</td></tr> | ||
| + | <tr><td>shift-q, shift-ESC</td><td>Quit the program</td></tr> | ||
| </table> | </table> | ||
| Line 28: | Line 36: | ||
| ===Function Keys and Saving Images or Geometry=== | ===Function Keys and Saving Images or Geometry=== | ||
| - | <table class="type1"> | + | <table border=1> |
| - | <tr><th width=10% class="gray"><p class="tablehead">Key</p></th><th class="gray"><p class="tablehead">Description</p></th></tr> | + | <tr><th width=15% >Key</th><th>Description</th></tr> |
| <tr><td> F1 </td><td>Toggle help information - displays a list of keyboard options</td></tr> | <tr><td> F1 </td><td>Toggle help information - displays a list of keyboard options</td></tr> | ||
| <tr><td> F2 </td><td> Toggle bounding box</td></tr> | <tr><td> F2 </td><td> Toggle bounding box</td></tr> | ||
| Line 44: | Line 52: | ||
| position, frame rates, etc.</td></tr> | position, frame rates, etc.</td></tr> | ||
| </table> | </table> | ||
| + | |||
| Notes: | Notes: | ||
| * Saved images are in TGA format and are numbered sequentially and uniquely | * Saved images are in TGA format and are numbered sequentially and uniquely | ||
| Line 50: | Line 59: | ||
| ===Callback System=== | ===Callback System=== | ||
| - | <table class="type1" border=1> | + | <table border=1> |
| - | <tr><th width=15% class="gray">Key</p></th><th class="gray">Description</th></tr> | + | <tr><th width=15% >Key</th><th>Description</th></tr> |
| - | <tr><td>z, Z</td><td>Toggle drawing of dynamic geometry by | + | <tr><td>z, Z</td><td>Toggle drawing of dynamic geometry by disabling/enabling a callback function set with [[Function:cs2scb | cs2scb]].</td></tr> |
| - | disabling/enabling a callback function set with the <tt>S2PLOT</tt> command | + | <tr><td>0...9</td><td>Available for assigning to callback functions using [[Function:cs2sncb | cs2sncb]]. The default operation of keys 1...7 is to display standard camera views. |
| - | <a href="reference.php?e=cs2scb&s=11">cs2scb</a></td></tr> | + | |
| - | <tr><td>0...9</td><td>Available for assigning to callback functions using | + | |
| - | <tt>S2PLOT</tt> function <a href="reference.php?e=cs2sncb&s=11">cs2sncb</a>. The default operation of keys 1...7 is to display standard camera views. | + | |
| 0, 8 and 9 have no default behaviour</td></tr> | 0, 8 and 9 have no default behaviour</td></tr> | ||
| - | + | <tr><td>Space Bar</td><td>This key press is available through the callback system for programmer-assigned tasks. The number of times the space | |
| - | <tr><td>Space Bar</td><td>This key press is available through the callback | + | bar key is pressed is passed to a callback function as a parameter. For examples, see [[Function:cs2scb | cs2scb]].</td></tr> |
| - | system for programmer-assigned tasks. The number of times the space | + | |
| - | bar key is pressed is passed to a callback function as a parameter. For an | + | |
| - | example, see the sample programs <tt>s2uc7.c</tt> (C) or <tt>fs2uc7*.f</tt> | + | |
| - | (FORTRAN) | + | |
| - | <td></tr> | + | |
| </table> | </table> | ||
| ===Handles=== | ===Handles=== | ||
| - | <table class="type1" width=100%> | + | <table border=1 width=100%> |
| - | <tr><th width=30% class="gray"><p class="tablehead">Key</p></th><th class="gray"><p class="tablehead">Description</p></th></tr> | + | <tr><th width=15% >Key</th><th>Description</th></tr> |
| - | + | <tr><td>shift-s</td><td>Toggle drawing of handles for selection</td></tr> | |
| - | <tr><td>shift-s, shift-S</td><td>Toggle drawing of handles for selection</td></tr> | + | <tr><td>shift-C</td><td>Toggle drawing of cross-hairs</td></tr> |
| - | <tr><td>shift-C, shift-C</td><td>Toggle drawing of cross-hairs</td></tr> | + | |
| <tr><td>Right Mouse Button (press)</td><td>Select a handle</td></tr> | <tr><td>Right Mouse Button (press)</td><td>Select a handle</td></tr> | ||
| + | <tr><td>Shift-Right Mouse Button (hold)</td><td>Drag a handle</td></tr> | ||
| + | <tr><td>Ctrl+Shift-Mouse pad (hold)</td><td>Drag a handle</td></tr> | ||
| </table> | </table> | ||
| + | |||
| + | [[S2PLOT | Back]] to S2PLOT home page. | ||
| + | __NOTOC__ | ||
| + | __NOEDITSECTION__ | ||
Current revision
Keyboard and Mouse Controls
This is intended to be a comprehensive list of all the keyboard and mouse controls available in S2PLOT as well as a description of how they work.
General Interaction and Camera Control
| Key | Description |
|---|---|
| Left Mouse Button (Hold) | Free rotation of geometry |
| Middle Mouse Button (Hold) | Rotate (roll) camera clockwise/anti-clockwise |
| Right Mouse Button (Click) | Select/deselect a handle - see cs2shcb |
| Shift-Right Mouse Button (Hold) | Drag a handle - see cs2sdhcb |
| f, F | Focus camera on centre of geometry |
| h, H, Home | Home position - Returns camera to original starting position |
| r, R | Cycle rendering mode: wireframe, flat, diffuse and specular shading |
| Left arrow | Rotate camera left |
| Right arrow | Rotate camera right |
| Down arrow | Rotate camera down |
| Up arrow | Rotate camera up |
| i, k | Move (translate) camera up, down |
| j, l | Move (translate) camera left, right |
| +, - | Track camera forward/backwards |
| [, ] | Roll anticlockwise, clockwise - same as the middle mouse button |
| {, } | Increase/decrease the eye-separation for stereo modes |
| a, A | Toggle autospin |
| <,> | Decrease/increase camera interaction speed |
| *,/ | Decrease/increase autospin speed |
| ~ | Activate the command prompt for use with cs2spcb |
| ` | Toggle between odd and even scan lines for the /s2inter (interlaced stereo) device mode |
| shift-ENTER | Return control to program when using s2disp |
| TAB | Move between panels: see xs2cp |
| shift-q, shift-ESC | Quit the program |
Function Keys and Saving Images or Geometry
| Key | Description |
|---|---|
| F1 | Toggle help information - displays a list of keyboard options |
| F2 | Toggle bounding box |
| F5 | Write geometry and camera view file to disk |
| F6 | Write geometry, camera view file and current screen image to disk |
| F7 | Toggle recording of geometry, camera view file and image |
| F9 | Write large (3 x 3) image to disk - saves a series of 'chopped up' images for recombining to make a high quality image |
| F10 | Write current screen image to disk, saved in the current working directory |
| F11 | Create QTVR object images - rotates the scene creating a series of images (e.g. each frame can be joined to make a movie) |
| F12 | Toggle image recording - same as F11 but allows the user to rotate the geometry themselves |
| c | Append current camera position to camera.path file |
| d | Toggle debug mode - provides information on camera position, frame rates, etc. |
Notes:
- Saved images are in TGA format and are numbered sequentially and uniquely
- On Apple OSX platforms, it is usually necesary to hold down the fn key while using the above keystrokes
Callback System
| Key | Description |
|---|---|
| z, Z | Toggle drawing of dynamic geometry by disabling/enabling a callback function set with cs2scb. |
| 0...9 | Available for assigning to callback functions using cs2sncb. The default operation of keys 1...7 is to display standard camera views. 0, 8 and 9 have no default behaviour |
| Space Bar | This key press is available through the callback system for programmer-assigned tasks. The number of times the space bar key is pressed is passed to a callback function as a parameter. For examples, see cs2scb. |
Handles
| Key | Description |
|---|---|
| shift-s | Toggle drawing of handles for selection |
| shift-C | Toggle drawing of cross-hairs |
| Right Mouse Button (press) | Select a handle |
| Shift-Right Mouse Button (hold) | Drag a handle |
| Ctrl+Shift-Mouse pad (hold) | Drag a handle |
Back to S2PLOT home page.
