S2PLOT:Controls

From S2PLOT

---

Revision as of 06:48, 26 October 2007

Contents 1 Keyboard and Mouse Controls 1.1 General Interaction and Camera Control 1.2 Function Keys and Saving Images or Geometry 1.3 Callback System 1.4 Handles

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
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
a, A	Toggle autospin
<,>	Decrease/increase autospin and interaction speed
q, Q, 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 the S2PLOT command <a href="reference.php?e=cs2scb&s=11">cs2scb</a>
0...9	Available for assigning to callback functions using S2PLOT 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
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 an example, see the sample programs s2uc7.c (C) or fs2uc7*.f (FORTRAN)	</tr> </table> Handles Key Description shift-s, shift-S Toggle drawing of handles for selection shift-C, shift-C Toggle drawing of cross-hairs Right Mouse Button (press) Select a handle