MGED CMD dm

dm

Syntax

dm subcommand [args]

Argument(s)

Subcommands

Valid Subcommand

Args

Optional. Subcommand specific arguments.

Return Value(s)

No Return Values for this command.

Description

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)

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

No related commands.

---

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