S2PLOT:Controls

From S2PLOT

(Difference between revisions)
Jump to: navigation, search
Revision as of 06:50, 26 October 2007
S2plot admin (Talk | contribs)

← 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% >Key</th><th>Description</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+<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
-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 [[Function:cs2scb | cs2scb]].</td></tr>
-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__ __NOTOC__
__NOEDITSECTION__ __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

KeyDescription
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, FFocus camera on centre of geometry
h, H, HomeHome position - Returns camera to original starting position
r, RCycle rendering mode: wireframe, flat, diffuse and specular shading
Left arrowRotate camera left
Right arrowRotate 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, AToggle 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-ENTERReturn control to program when using s2disp
TABMove between panels: see xs2cp
shift-q, shift-ESCQuit the program


Function Keys and Saving Images or Geometry

KeyDescription
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

KeyDescription
z, ZToggle drawing of dynamic geometry by disabling/enabling a callback function set with cs2scb.
0...9Available 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 BarThis 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

KeyDescription
shift-sToggle drawing of handles for selection
shift-CToggle 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.


Personal tools