MGED CMD knob

From BRL-CAD
Revision as of 21:06, 12 May 2010 by 68.37.119.2 (talk) (put the arguments in a table instead of a list; remove superfluous whitespace; put the program name in code tags)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

knob

Syntax

knob [-e -i -m -v] [-o v|m|e|k] [zap|zero|(id [val])]


Argument(s)

-e
Knob effects applied to the edited Object.
-i
Value is applied as increment to the indicated knob.
-m
Adjust the model coordinates without modifying geometry.
-v
Adjust the view coordinates without modifying geometry.
[-o v|m|e|k]
Sets origin of rotation.
Zap|Zero (id [Val])
Knobs reset to zero, or to Val.


Return Value(s)

No Return Values for this command.


Description

The knob command is used internally by MGED in the processing of knob input devices and is not recommended for users. The knob command provides a method for simulating knob input. With no options, it will display the current values for the knobs. With the zap or zero command provided, all the knob values will be reset to zero. If an id and value are provided, the specified knob setting will be simulated. If the -i option is specified, then the value provided will be used as an increment to be applied to the indicated knob. The knobs have different functions depending on the current mode. For example, if in primitive or matrix edit mode and a rotation or translation function is selected, the knob effects are applied to the edited object by default. However, the -v (view coordinates) and -m (model coordinates) options may be used to adjust the view without modifying primitives or matrices. The -e option allows the knob effects to be applied to the edited object when they would normally be applied to the view. The -o option allows the origin of rotation to be specified with v, m, e, and k, indicating view, model, and eye and keypoint, respectively. The units for value are degrees for rotation and local units for translation. The available knob ids are:

x rate-based rotation about horizontal axis.
y rate-based rotation about vertical axis.
z rate-based rotation about axis normal to screen.
X rate-based translation in horizontal direction.
Y rate-based translation in vertical direction.
Z rate-based translation in direction normal to screen.
S rate-based scale or zoom.
ax absolute rotation about horizontal axis.
ay absolute rotation about vertical axis.
az absolute rotation about axis normal to screen.
aX absolute translation in horizontal direction.
aY absolute translation in vertical direction.
aZ absolute translation in direction normal to screen.
aS absolute scale or zoom.
xadc absolute translation of adc in horizontal direction (screen coordinates -2048 to +2048).
yadc absolute translation of adc in vertical direction (screen coordinates -2048 to +2048).
ang1 absolute rotation of adc angle1 (degrees).
ang2 absolute rotation of adc angle2 (degrees).
distadc distance setting of the adc (screen coordinates -2048 to +2048).

Example(s)

mged> knob y 1
Start the view rotating about the vertical axis.


See Also

adc

Page Generated by David Loman on: 10/11/2007 at: 1:27:28 PM