MGED CMD dm


dm[edit]

Syntax[edit]

dm subcommand [args]


Argument(s)[edit]

Subcommands
Valid Subcommand
Args
Optional. Subcommand specific arguments.


Return Value(s)[edit]

No Return Values for this command.


Description[edit]

The "dm" command provides a means to interact with the display manager at a lower level. The dm command accepts the following subcommands:

set [var [val]]
The "set" subcommand provides a means to set or query display manager-specific variables. Invoked without any arguments, the set subcommand will return a list of all available internal display manager variables. If only the var argument is specified, the value of that variable is returned. If both var and val are given, then var will be set to val.
size [width height]
The "size" subcommand provides a means to set or query the window size. If no arguments are given, the display manager’s window size is returned. If width and height are specified, the display manager makes a request to have its window resized. Note that a size request is just that, a request, so it may be ignored, especially if the user has resized the window using the mouse.
m button x y
The "m" subcommand is used to simulate an M command. The button argument determines which mouse button is being used to trigger a call to this command. This value is used in the event handler to effect dragging the faceplate scrollbars. The x and y arguments are in X screen coordinates, which are converted to MGED screen coordinates before being passed to the M command.
am < r|t|s > x y
The "am" subcommand effects mged’s alternate mouse mode. The alternate mouse mode gives the user a different way of manipulating the view or an object. For example, the user can drag an object or perhaps rotate the view while using the mouse. The first argument indicates the type of operation to perform (i.e., r for rotation, t for translation, and s for scale). The x and y arguments are in X screen coordinates and are transformed appropriately before being passed to the knob command.
adc < 1|2|t|d > x y
The "adc" subcommand provides a way of manipulating the angle distance cursor while using the mouse. The first argument indicates the type of operation to perform (i.e., 1 for angle 1, 2 for angle 2, t for translate, and d for tick distance). The x and y arguments are in X screen coordinates and are transformed appropriately before being passed to the adc command (i.e., not "dm adc").
con < r|t|s < x|y|z > > xpos ypos
This form of the "con" subcommand provides a way to effect constrained manipulation of the view or an object while using the mouse. This simulates the behavior of sliders without taking up screen real estate. The first argument indicates the type of operation to perform (i.e., r for rotation, t for translation, and s for scale). The < x|y|z > argument is the axis of rotation, translation, or scale. The xpos and ypos arguments are in X screen coordinates and are transformed appropriately before being passed to the knob command.
con a < x|y|1|2|d > xpos ypos
This form of the "con" subcommand provides a way to effect constrained manipulation of the angle distance cursor while using the mouse. This simulates the behavior of sliders without taking up screen real estate. The first argument indicates that this is to be applied to the angle distance cursor. The next argument indicates the type of operation to perform (i.e., x for translate in the x direction, y for translate in the y direction, 1 for angle 1, 2 for angle 2, and d for tick distance). The xpos and ypos arguments are in x screen coordinates and are transformed appropriately before being passed to the knob command.


Example(s)[edit]

mged> dm set perspective 1
Turn on perspective projection in the display
mged> dm size
Return the size to the display manager
mged> dm size 900 900
Request that the display manager window be resized to 900x900
mged> dm m 2 100 200
Simulate a button2 press at (100, 200) in X screen coordinates
mged> dm am r 400 100
Start an alternate mouse mode rotation
mged> dm adc d 300 200
Start a tick distance manipulation
mged> dm con t z 200 200
Start a constrained translation down the Z axis
mged> dm con a d 200 100
Start a constrained tick distance manipulation
mged> dm idle
End drag.


See Also[edit]

No related commands.



Page Generated by David Loman on: 10/11/2007 at: 12:25:36 PM