| Customize Help
| Save Settings

MgraControlList



Function Map
Synopsis
Control the graphics contained within the 2D graphics list.
Syntax
void MgraControlList(
MIL_ID GraListId, //in
MIL_INT LabelOrIndex, //in
MIL_INT SubIndex, //in
MIL_INT64 ControlType, //in
MIL_DOUBLE ControlValue //in
)
Description

This function allows you to control the settings of graphics contained within the 2D graphics list. Most of the control type settings can be inquired using MgraInquireList().

When graphics are added to the list, they inherit the current settings of the 2D graphics context. However, subsequent changes to the 2D graphics context (for example, with MgraControl()) do not affect graphics already in the list. The settings of graphics in the list can only be modified using MgraControlList().

Using this function, you can also control a sub-element of a graphic in a 2D graphics list. This is useful when a single point of a graphic requires repositioning. For example, you can reposition (M_POSITION_X and M_POSITION_Y) a vertex point of a polygon (MgraLines() with M_POLYGON) by specifying the polygon graphic (LabelOrIndex), and one of its points (SubIndex).

All geometric type changes that you make to the graphics (such as, rotation, scaling, and translation) are applied according to the current input units of each graphic in the list, as specified with M_INPUT_UNITS, on a per graphic basis. For example, if you change the position of two graphics in the list, a dot set in pixel units and a rectangle set in world units, the dot's position will change in pixel units and the rectangle's position will change in world units. However, changing M_INPUT_UNITS to a different value will not convert a graphic's position.

Unlike most other functions that modify a MIL object, you can call this function concurrently from multiple threads on the same MIL 2D graphics list (GraListId) without using an M_MUTEX object, as long as all the other parameters of the concurrent calls do not also share data.

Note that when using a C compiler (not a C++ or other compiler) in 64-bit mode, MgraControlList() internally calls the MIL_DOUBLE version of this function (MgraControlListDouble()). If you need to pass integer values, call the MIL_INT64 version of this function (MgraControlListInt64()).
Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
GraListId

Specifies the identifier of the 2D graphics list to control. The 2D graphics list must have been previously allocated on the required system using MgraAllocList().

LabelOrIndex

Specifies the graphic (one or all) to control. This parameter must be set to one of the following values:

function map For specifying the 2D graphics list or graphic therein
Click to summarizeValue Description
Click to summarize

Specifies the index of an existing graphic on which to apply the control setting.

(summarize)
Parameters

Specifies the index. The index is from 0 (inclusive) to the total number of graphics in the list minus 1. You can get the number graphics in the list using MgraInquireList() with M_NUMBER_OF_GRAPHICS.

If the control setting is not supported on the graphic specified, an error is generated. For example, a dot (MgraDot()) cannot be scaled (M_APPLY_SCALE) or rotated (M_ROTATE).

Click to summarize

Specifies the label of an existing graphic on which to apply the control setting.

(summarize)
Parameters

Specifies the label. The label must be greater than 0. You can retrieve the label of the last graphic added to the list using MgraInquireList() with M_LAST_LABEL.

If the control setting is not supported on the graphic specified, an error is generated. For example, a dot (MgraDot()) cannot be scaled (M_APPLY_SCALE) or rotated (M_ROTATE).

Click to summarize M_ALL

Applies the specified control setting to all the graphics contained within the 2D graphics list. The graphics that do not support the specified control type setting remain unchanged.

(summarize)
Click to summarize M_ALL_SELECTED

Applies the specified control setting to all the graphics contained within the 2D graphics list that are currently selected (that is, all graphics with M_GRAPHIC_SELECTED set to M_TRUE). The graphics that are not selected remain unchanged.

(summarize)
Click to summarize M_LIST

Applies the specified control setting to the 2D graphics list itself.

SubIndex

Specifies the index of the sub-element of the graphic on which to apply the control setting. If this information is not required or supported, set this parameter to M_DEFAULT.

function map For specifying the index of a graphic's sub-element
Click to summarizeValue Description
Click to summarize M_DEFAULT

Specifies to apply the control setting to the graphic itself (instead of just a sub-element).

Click to summarize 0 <= Value <= M_NUMBER_OF_SUB_ELEMENTS

Specifies the index of the sub-element of the graphic on which to apply the control setting. The following table lists all the graphics for which you can control their individual sub-elements and outlines how sub-indices are assigned for each of these.

Graphics types

Index of sub-element values

Dots (created using MgraDots()).

The indices, starting from 0, are assigned to each dot in order of creation.

A single line (created using MgraLine() or user-defined using MgraInteractive() set to M_GRAPHIC_TYPE_LINE).

0 is assigned to the specified start point, and 1 is assigned to the specified end point of the line.

Sets of finite length lines (created using MgraLines() with M_LINE_LIST).

The indices, starting from 0, are assigned to the specified start point and end point of each line, in order of creation. For example, the start point of the first line has an index of 0 and the end point has an index of 1, and the start point of the second line has an index of 2 and the end point has an index of 3.

Sets of infinite lines (created using MgraLines() with M_INFINITE_LINES).

The indices, starting from 0, are assigned to the first and second specified point of each line, in order of creation. For example, the first specified point of the first line has an index of 0 and its second specified point has an index of 1, and the first specified point of the second line has an index of 2 and its second specified point has an index of 3.

A polygon (created using MgraLines() with M_POLYGON or user-defined using MgraInteractive() set to M_GRAPHIC_TYPE_POLYGON).

The indices, starting from 0, are assigned to each polygon vertex in order of creation.

A polyline (created using MgraLines() with M_POLYLINE or user-defined using MgraInteractive() set to M_GRAPHIC_TYPE_POLYLINE).

The indices, starting from 0, are assigned to each polyline point in order of creation.

(summarize)
ControlType

Specifies the 2D graphics list setting to control.

See the Parameter associations section for possible values that can be specified.

ControlValue

Specifies the value to assign to the 2D graphics list setting.

See the Parameter associations section for possible values that can be specified.

The following ControlType and corresponding ControlValue parameter settings are used to change general settings of a 2D graphics list itself. In this case, set the LabelOrIndex parameter to M_LIST and the SubIndex parameter to M_DEFAULT.

function map For changing general settings of the 2D graphics list itself
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_ANGLE_SNAPPING_VALUE

Sets the angular value to use as a multiple when rotating the graphic. This value only applies when using M_ANGLE_SNAPPING. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 15.0°.

Click to summarize 1.0 <= Value <= 180.0

Specifies the value to use as a multiple, in degrees. The value must be a divisor of 180.0.

(summarize)
Click to summarize M_EASY_SELECTION

Sets whether MIL allows the easy selection of graphics on the display. When easy selection is enabled, you can select closed graphics (such as circles) by clicking anywhere inside them, even if they are not filled. To select non-filled graphics when easy selection is disabled, you must click on their contour. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that MIL does not allow for the easy selection of graphics on the display.

Click to summarize M_ENABLE

Specifies that MIL allows for the easy selection of graphics on the display.

Click to summarize M_INTERACTIVE_ANNOTATIONS_COLOR +

Sets the color of the selection box and handles in interactive mode. INQ

(summarize)
Click to summarize
M_RGB888(
MIL_INT Red,
MIL_INT Green,
MIL_INT Blue
)

Specifies an RGB value when drawing in an 8-bit, 3-band buffer. The red, green, and blue values must be between 0 and 255, inclusive.

When drawing in a 16-bit or 32-bit multi-band buffer, the components of the RGB value are cast to the type of the destination buffer's bands.

To specify a 16-bit or 32-bit color component, use MgraControlList() with M_INTERACTIVE_ANNOTATIONS_COLOR combined with the appropriate constant (M_RED, M_GREEN, or M_BLUE).

(summarize)
Parameters

Specifies the red component, as a value between 0 and 255.

Specifies the green component, as a value between 0 and 255.

Specifies the blue component, as a value between 0 and 255.

Click to summarize M_COLOR_BLACK

Specifies the color black.

Click to summarize M_COLOR_BLUE

Specifies the color blue.

Click to summarize M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

Click to summarize M_COLOR_CYAN

Specifies the color cyan.

Click to summarize M_COLOR_DARK_BLUE

Specifies the color dark blue.

Click to summarize M_COLOR_DARK_CYAN

Specifies the color dark cyan.

Click to summarize M_COLOR_DARK_GREEN

Specifies the color dark green.

Click to summarize M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

Click to summarize M_COLOR_DARK_RED

Specifies the color dark red.

Click to summarize M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

Click to summarize M_COLOR_GRAY

Specifies the color gray.

Click to summarize M_COLOR_GREEN

Specifies the color green.

Click to summarize M_COLOR_LIGHT_BLUE

Specifies the color light blue.

Click to summarize M_COLOR_LIGHT_GRAY

Specifies the color light gray.

Click to summarize M_COLOR_LIGHT_GREEN

Specifies the color light green.

Click to summarize M_COLOR_LIGHT_WHITE

Specifies the color light white.

Click to summarize M_COLOR_MAGENTA

Specifies the color magenta.

Click to summarize M_COLOR_RED

Specifies the color red.

Click to summarize M_COLOR_WHITE

Specifies the color white.

Click to summarize M_COLOR_YELLOW

Specifies the color yellow.

Click to summarize Value

Specifies a grayscale value. The buffer can be a 1-band or multi-band buffer. The specified value is cast to the buffer type and depth.

Note that a grayscale value can be any integer or floating-point number. If the given value exceeds the range of the possible values that can be stored in each band of the destination buffer, the least significant bits of the value are used.

(summarize)
Click to summarize M_MODE_RESIZE

Sets the interactive behavior when resizing the graphic using its selection box. To resize the graphic, click and move one of its selection box's eight resize handles. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_FIXED_CORNER.

Click to summarize M_FIXED_CENTER +

Specifies that all sides of the selection box move symmetrically, and the center does not move, when resizing the graphic.

Click to summarize M_FIXED_CORNER +

Specifies that the center moves, and the opposite corner does not move, when resizing the graphic. If you click on a selection box handle that is not a corner, the opposite side (which includes its corners) does not move when resizing.

(summarize)
Click to summarize M_MODE_RESIZE_ALT

Sets the interactive behavior when resizing the graphic using its selection box and pressing the Alt key. To resize the graphic, click and move (while pressing Alt) one of its selection box's eight resize handles.

If multiple key values (M_MODE_RESIZE_ALT, M_MODE_RESIZE_CTRL, or M_MODE_RESIZE_SHIFT) are set to one of M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO, and multiple keys (Alt, Ctrl, or Shift) are pressed when resizing, M_FIXED_ASPECT_RATIO takes precedence over M_SQUARE_ASPECT_RATIO, and M_SQUARE_ASPECT_RATIO takes precedence over M_NO_CONSTRAINT.

If multiple key values (M_MODE_RESIZE_ALT, M_MODE_RESIZE_CTRL, or M_MODE_RESIZE_SHIFT) are set to one of M_FIXED_CENTER or M_FIXED_CORNER, and multiple keys (Alt, Ctrl, or Shift) are pressed when resizing, M_FIXED_CENTER takes precedence over M_FIXED_CORNER.

If the graphic's aspect ratio is set to 1 using MgraControlList() with M_CONSTRAIN_ASPECT_RATIO, it will remain 1 (M_MODE_RESIZE_ALT will not change it). INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_SQUARE_ASPECT_RATIO.

Click to summarize M_DISABLE

Specifies that pressing the Alt key does not affect how to resize the graphic. In this case, MIL uses M_MODE_RESIZE.

(summarize)
Click to summarize M_FIXED_ASPECT_RATIO

Specifies that the aspect ratio of the graphic remains constant, when resizing the graphic while pressing the Alt key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_FIXED_CENTER

Specifies that all sides of the selection box move symmetrically, and the center does not move, when resizing the graphic while pressing the Alt key. This overrides the value set with M_MODE_RESIZE. The aspect ratio combination value that M_MODE_RESIZE uses (M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO) is not overridden.

(summarize)
Click to summarize M_FIXED_CORNER

Specifies that the center moves, and the opposite corner does not move, when resizing the graphic while pressing the Alt key. If you click on a selection box handle that is not a corner, the opposite side (which includes its corners) does not move when resizing. This overrides the value set with M_MODE_RESIZE. The aspect ratio combination value that M_MODE_RESIZE uses (M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO) is not overridden.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies that the aspect ratio of the graphic can change, when resizing it while pressing the Alt key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_SQUARE_ASPECT_RATIO

Specifies that the aspect ratio of the graphic will be 1:1 (square), when resizing it while pressing the Alt key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_MODE_RESIZE_CTRL

Sets the interactive behavior when resizing the graphic using its selection box and pressing the Ctrl key. To resize the graphic, click and move (while pressing Ctrl) one of its selection box's eight resize handles.

If multiple key values (M_MODE_RESIZE_ALT, M_MODE_RESIZE_CTRL, or M_MODE_RESIZE_SHIFT) are set to one of M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO, and multiple keys (Alt, Ctrl, or Shift) are pressed when resizing, M_FIXED_ASPECT_RATIO takes precedence over M_SQUARE_ASPECT_RATIO, and M_SQUARE_ASPECT_RATIO takes precedence over M_NO_CONSTRAINT.

If multiple key values (M_MODE_RESIZE_ALT, M_MODE_RESIZE_CTRL, or M_MODE_RESIZE_SHIFT) are set to one of M_FIXED_CENTER or M_FIXED_CORNER, and multiple keys (Alt, Ctrl, or Shift) are pressed when resizing, M_FIXED_CENTER takes precedence over M_FIXED_CORNER.

If the graphic's aspect ratio is set to 1 using MgraControlList() with M_CONSTRAIN_ASPECT_RATIO, it will remain 1 (M_MODE_RESIZE_CTRL will not change it). INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_FIXED_CENTER.

Click to summarize M_DISABLE

Specifies that pressing the Ctrl key does not affect how to resize the graphic. In this case, MIL uses M_MODE_RESIZE.

(summarize)
Click to summarize M_FIXED_ASPECT_RATIO

Specifies that the aspect ratio of the graphic remains constant, when resizing the graphic while pressing the Ctrl key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_FIXED_CENTER

Specifies that all sides of the selection box move symmetrically, and the center does not move, when resizing the graphic while pressing the Ctrl key. This overrides the value set with M_MODE_RESIZE. The aspect ratio combination value that M_MODE_RESIZE uses (M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO) is not overridden.

(summarize)
Click to summarize M_FIXED_CORNER

Specifies that the center moves, and the opposite corner does not move, when resizing the graphic while pressing the Ctrl key. If you click on a selection box handle that is not a corner, the opposite side (which includes its corners) does not move when resizing. This overrides the value set with M_MODE_RESIZE. The aspect ratio combination value that M_MODE_RESIZE uses (M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO) is not overridden.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies that the aspect ratio of the graphic can change, when resizing it while pressing the Ctrl key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_SQUARE_ASPECT_RATIO

Specifies that the aspect ratio of the graphic will be 1:1 (square), when resizing it while pressing the Ctrl key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_MODE_RESIZE_SECONDARY_DIMENSION

Sets how to establish the graphic's secondary dimension when defining the graphic interactively on the display. This only applies when creating the graphic using MgraInteractive() with M_GRAPHIC_TYPE_RECT set to M_ORIENTED_RECT. In this case, the graphic's secondary dimension refers to the rectangle's height. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_ONE_SIDED.

Click to summarize M_ONE_SIDED

Specifies to establish the graphic's secondary dimension on one side of a previously established part. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on one side of the width line. The side depends on whether you move your mouse above or below the width line.

(summarize)
Click to summarize M_SYMMETRIC

Specifies to establish the graphic's secondary dimension symmetrically on both sides of a previously established part. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on both sides of the width line. Moving your mouse above or below the width line adjusts the height equally on each side.

(summarize)
Click to summarize M_MODE_RESIZE_SECONDARY_DIMENSION_ALT

Sets how to establish the graphic's secondary dimension when defining the graphic interactively on the display and pressing the Alt key. This only applies when creating the graphic using MgraInteractive() with M_GRAPHIC_TYPE_RECT set to M_ORIENTED_RECT. In this case, the graphic's secondary dimension refers to the rectangle's height.

Unless you disable M_MODE_RESIZE_SECONDARY_DIMENSION_ALT, its value overrides the value set with M_MODE_RESIZE_SECONDARY_DIMENSION. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that pressing the Alt key does not affect how to establish the graphic's secondary dimension when defining it interactively on the display. In this case, MIL uses M_MODE_RESIZE_SECONDARY_DIMENSION.

(summarize)
Click to summarize M_ONE_SIDED

Specifies to establish the graphic's secondary dimension on one side of a previously established part, while pressing the Alt key. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on one side of the width line. The side depends on whether you move your mouse (while pressing Alt) above or below the width line.

(summarize)
Click to summarize M_SYMMETRIC

Specifies to establish the graphic's secondary dimension symmetrically on both sides of a previously established part, while pressing the Alt key. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on both sides of the width line. Moving your mouse (while pressing Alt) above or below the width line adjusts the height equally on each side.

(summarize)
Click to summarize M_MODE_RESIZE_SECONDARY_DIMENSION_CTRL

Sets how to establish the graphic's secondary dimension when defining the graphic interactively on the display and pressing the Ctrl key. This only applies when creating the graphic using MgraInteractive() with M_GRAPHIC_TYPE_RECT set to M_ORIENTED_RECT. In this case, the graphic's secondary dimension refers to the rectangle's height.

Unless you disable M_MODE_RESIZE_SECONDARY_DIMENSION_CTRL, its value overrides the value set with M_MODE_RESIZE_SECONDARY_DIMENSION. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_SYMMETRIC.

Click to summarize M_DISABLE

Specifies that pressing the Ctrl key does not affect how to establish the graphic's secondary dimension when defining it interactively on the display. In this case, MIL uses M_MODE_RESIZE_SECONDARY_DIMENSION.

(summarize)
Click to summarize M_ONE_SIDED

Specifies to establish the graphic's secondary dimension on one side of a previously established part, while pressing the Ctrl key. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on one side of the width line. The side depends on whether you move your mouse (while pressing Ctrl) above or below the width line.

(summarize)
Click to summarize M_SYMMETRIC

Specifies to establish the graphic's secondary dimension symmetrically on both sides of a previously established part, while pressing the Ctrl key. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on both sides of the width line. Moving your mouse (while pressing Ctrl) above or below the width line adjusts the height equally on each side.

(summarize)
Click to summarize M_MODE_RESIZE_SECONDARY_DIMENSION_SHIFT

Sets how to establish the graphic's secondary dimension when defining the graphic interactively on the display and pressing the Shift key. This only applies when creating the graphic using MgraInteractive() with M_GRAPHIC_TYPE_RECT set to M_ORIENTED_RECT. In this case, the graphic's secondary dimension refers to the rectangle's height.

Unless you disable M_MODE_RESIZE_SECONDARY_DIMENSION_SHIFT, its value overrides the value set with M_MODE_RESIZE_SECONDARY_DIMENSION. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that pressing the Shift key does not affect how to establish the graphic's secondary dimension when defining it interactively on the display. In this case, MIL uses M_MODE_RESIZE_SECONDARY_DIMENSION.

(summarize)
Click to summarize M_ONE_SIDED

Specifies to establish the graphic's secondary dimension on one side of a previously established part, while pressing the Shift key. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on one side of the width line. The side depends on whether you move your mouse (while pressing Shift) above or below the width line.

(summarize)
Click to summarize M_SYMMETRIC

Specifies to establish the graphic's secondary dimension symmetrically on both sides of a previously established part, while pressing the Shift key. For example, when interactively defining an oriented rectangle graphic, the first two clicks on the display define a line that represents the rectangle's width, and the third click defines its height on both sides of the width line. Moving your mouse (while pressing Shift) above or below the width line adjusts the height equally on each side.

(summarize)
Click to summarize M_MODE_RESIZE_SHIFT

Sets the interactive behavior when resizing the graphic using its selection box and pressing the Shift key. To resize the graphic, click and move (while pressing Shift) one of the selection box's eight resize handles.

If multiple key values (M_MODE_RESIZE_ALT, M_MODE_RESIZE_CTRL, or M_MODE_RESIZE_SHIFT) are set to one of M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO, and multiple keys (Alt, Ctrl, or Shift) are pressed when resizing, M_FIXED_ASPECT_RATIO takes precedence over M_SQUARE_ASPECT_RATIO, and M_SQUARE_ASPECT_RATIO takes precedence over M_NO_CONSTRAINT.

If multiple key values (M_MODE_RESIZE_ALT, M_MODE_RESIZE_CTRL, or M_MODE_RESIZE_SHIFT) are set to one of M_FIXED_CENTER or M_FIXED_CORNER, and multiple keys (Alt, Ctrl, or Shift) are pressed when resizing, M_FIXED_CENTER takes precedence over M_FIXED_CORNER.

If the graphic's aspect ratio is set to 1 using MgraControlList() with M_CONSTRAIN_ASPECT_RATIO, it will remain 1 (M_MODE_RESIZE_SHIFT will not change it). INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_FIXED_ASPECT_RATIO.

Click to summarize M_DISABLE

Specifies that pressing the Shift key does not affect how to resize the graphic. In this case, MIL uses M_MODE_RESIZE.

(summarize)
Click to summarize M_FIXED_ASPECT_RATIO

Specifies that the aspect ratio of the graphic remains constant, when resizing the graphic while pressing the Shift key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_FIXED_CENTER

Specifies that all sides of the selection box move symmetrically, and the center does not move, when resizing the graphic while pressing the Shift key. This overrides the value set with M_MODE_RESIZE. The aspect ratio combination value that M_MODE_RESIZE uses (M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO) is not overridden.

(summarize)
Click to summarize M_FIXED_CORNER

Specifies that the center moves, and the opposite corner does not move, when resizing the graphic while pressing the Shift key. If you click on a selection box handle that is not a corner, the opposite side (which includes its corners) does not move when resizing. This overrides the value set with M_MODE_RESIZE. The aspect ratio combination value that M_MODE_RESIZE uses (M_FIXED_ASPECT_RATIO, M_NO_CONSTRAINT, or M_SQUARE_ASPECT_RATIO) is not overridden.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies that the aspect ratio of the graphic can change, when resizing it while pressing the Shift key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_SQUARE_ASPECT_RATIO

Specifies that the aspect ratio of the graphic will be 1:1 (square), when resizing it while pressing the Shift key. This overrides the aspect ratio combination value set for M_MODE_RESIZE. The value that M_MODE_RESIZE uses (M_FIXED_CENTER or M_FIXED_CORNER) is not overridden.

(summarize)
Click to summarize M_MODE_ROTATE

Sets the interactive behavior when rotating the graphic using its selection box. To rotate the graphic, click and move its selection box's rotate handle. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_NO_CONSTRAINT.

Click to summarize M_ANGLE_SNAPPING

Specifies to rotate the graphic by snapping it to an angle that is a multiple of the value set by M_ANGLE_SNAPPING_VALUE.

Click to summarize M_NO_CONSTRAINT

Specifies to rotate the graphic freely.

Click to summarize M_MODE_ROTATE_ALT

Sets the interactive behavior when rotating the graphic using its selection box and pressing the Alt key. To rotate the graphic, click and move (while pressing Alt) its selection box's rotate handle. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_ANGLE_SNAPPING.

Click to summarize M_ANGLE_SNAPPING

Specifies to rotate the graphic by snapping it to an angle that is a multiple of the value set by M_ANGLE_SNAPPING_VALUE, when rotating it while pressing the Alt key. This overrides the value set with M_MODE_ROTATE.

(summarize)
Click to summarize M_DISABLE

Specifies that pressing the Alt key does not affect how to rotate the graphic. In this case, MIL uses M_MODE_ROTATE.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies to rotate the graphic freely, when rotating it while pressing the Alt key. This overrides the value set with M_MODE_ROTATE.

(summarize)
Click to summarize M_MODE_ROTATE_CTRL

Sets the interactive behavior when rotating the graphic using its selection box and pressing the Ctrl key. To rotate the graphic, click and move (while pressing Ctrl) its selection box's rotate handle. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_ANGLE_SNAPPING

Specifies to rotate the graphic by snapping it to an angle that is a multiple of the value set by M_ANGLE_SNAPPING_VALUE, when rotating it while pressing the Ctrl key. This overrides the value set with M_MODE_ROTATE.

(summarize)
Click to summarize M_DISABLE

Specifies that pressing the Ctrl key does not affect how to rotate the graphic. In this case, MIL uses M_MODE_ROTATE.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies to rotate the graphic freely, when rotating it while pressing the Ctrl key. This overrides the value set with M_MODE_ROTATE.

(summarize)
Click to summarize M_MODE_ROTATE_SHIFT

Sets the interactive behavior when rotating the graphic using its selection box and pressing the Shift key. To rotate the graphic, click and move (while pressing Shift) its selection box's rotate handle. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_ANGLE_SNAPPING

Specifies to rotate the graphic by snapping it to an angle that is a multiple of the value set by M_ANGLE_SNAPPING_VALUE, when rotating it while pressing the Shift key. This overrides the value set with M_MODE_ROTATE.

(summarize)
Click to summarize M_DISABLE

Specifies that pressing the Shift key does not affect how to rotate the graphic. In this case, MIL uses M_MODE_ROTATE.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies to rotate the graphic freely, when rotating it while pressing the Shift key. This overrides the value set with M_MODE_ROTATE.

(summarize)
Click to summarize M_MODE_TRANSLATE

Sets the interactive behavior when moving (translating) the graphic using its selection box. To move the graphic, hover over its selection box border until the mouse arrow pointer changes to the move pointer, and then click and drag the graphic to a different location on the display. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_NO_CONSTRAINT.

Click to summarize M_AXIS_ALIGNED

Specifies to move the graphic along the X- and Y-axes.

Click to summarize M_NO_CONSTRAINT

Specifies to move the graphic freely.

Click to summarize M_MODE_TRANSLATE_ALT

Sets the interactive behavior when moving (translating) the graphic using its selection box and pressing the Alt key. To move the graphic, hover over its selection box border until the mouse arrow pointer changes to the move pointer, and then click and drag the graphic (while pressing Alt) to a different location on the display. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_AXIS_ALIGNED

Specifies to move the graphic along the X- and Y-axes, when moving it while pressing the Alt key. This overrides the value set with M_MODE_TRANSLATE.

(summarize)
Click to summarize M_DISABLE

Specifies that pressing the Alt key does not affect how to move the graphic. In this case, MIL uses M_MODE_TRANSLATE.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies to move the graphic freely, when moving it while pressing the Alt key. This overrides the value set with M_MODE_TRANSLATE.

(summarize)
Click to summarize M_MODE_TRANSLATE_CTRL

Sets the interactive behavior when moving (translating) the graphic using its selection box and pressing the Ctrl key. To move the graphic, hover over its selection box border until the mouse arrow pointer changes to the move pointer, and then click and drag the graphic (while pressing Ctrl) to a different location on the display. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_AXIS_ALIGNED

Specifies to move the graphic along the X- and Y-axes, when moving it while pressing the Ctrl key. This overrides the value set with M_MODE_TRANSLATE.

(summarize)
Click to summarize M_DISABLE

Specifies that pressing the Ctrl key does not affect how to move the graphic. In this case, MIL uses M_MODE_TRANSLATE.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies to move the graphic freely, when moving it while pressing the Ctrl key. This overrides the value set with M_MODE_TRANSLATE.

(summarize)
Click to summarize M_MODE_TRANSLATE_SHIFT

Sets the interactive behavior when moving (translating) the graphic using its selection box and pressing the Shift key. To move the graphic, hover over its selection box border until the mouse arrow pointer changes to the move pointer, and then click and drag the graphic (while pressing Shift) to a different location on the display. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_AXIS_ALIGNED.

Click to summarize M_AXIS_ALIGNED

Specifies to move the graphic along the X- and Y-axes, when moving it while pressing the Shift key. This overrides the value set with M_MODE_TRANSLATE.

(summarize)
Click to summarize M_DISABLE

Specifies that pressing the Shift key does not affect how to move the graphic. In this case, MIL uses M_MODE_TRANSLATE.

(summarize)
Click to summarize M_NO_CONSTRAINT

Specifies to move the graphic freely, when moving it while pressing the Shift key. This overrides the value set with M_MODE_TRANSLATE.

(summarize)
Click to summarize M_MULTIPLE_SELECTION

Sets whether to permit interactive multiple selection using the Ctrl key. When this setting is enabled, a user can select multiple graphics by holding down the Ctrl key and clicking on the graphics that need to be selected. Note that, even if this is disabled, multiple selection is still possible programmatically using M_GRAPHIC_SELECTED. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that interactive multiple selection is not permitted.

Click to summarize M_ENABLE

Specifies that interactive multiple selection is permitted.

This is the default value.

(summarize)
Click to summarize M_MULTIPLE_SELECTION_KEY

Sets the keyboard key that you can press to select multiple graphics with your mouse on the display. Clicking on a graphic that you have already selected, while pressing the specified key, deselects that graphic. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_CTRL.

Click to summarize M_KEY_ALT

Specifies that you can press the Alt key to select (or deselect) multiple graphics.

Click to summarize M_KEY_CTRL

Specifies that you can press the Ctrl key to select (or deselect) multiple graphics.

Click to summarize M_KEY_SHIFT

Specifies that you can press the Shift key to select (or deselect) multiple graphics.

Click to summarize M_SELECTED_COLOR +

Sets the color of the selected graphics in interactive mode. INQ

(summarize)
Click to summarize
M_RGB888(
MIL_INT Red,
MIL_INT Green,
MIL_INT Blue
)

Specifies an RGB value when drawing in an 8-bit, 3-band buffer. The red, green, and blue values must be between 0 and 255, inclusive.

When drawing in a 16-bit or 32-bit multi-band buffer, the components of the RGB value are cast to the type of the destination buffer's bands.

To specify a 16-bit or 32-bit color component, use MgraControlList() with M_SELECTED_COLOR combined with the appropriate constant (M_RED, M_GREEN, or M_BLUE).

(summarize)
Parameters

Specifies the red component, as a value between 0 and 255.

Specifies the green component, as a value between 0 and 255.

Specifies the blue component, as a value between 0 and 255.

Click to summarize M_COLOR_BLACK

Specifies the color black.

Click to summarize M_COLOR_BLUE

Specifies the color blue.

Click to summarize M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

Click to summarize M_COLOR_CYAN

Specifies the color cyan.

Click to summarize M_COLOR_DARK_BLUE

Specifies the color dark blue.

Click to summarize M_COLOR_DARK_CYAN

Specifies the color dark cyan.

Click to summarize M_COLOR_DARK_GREEN

Specifies the color dark green.

Click to summarize M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

Click to summarize M_COLOR_DARK_RED

Specifies the color dark red.

Click to summarize M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

Click to summarize M_COLOR_GRAY

Specifies the color gray.

Click to summarize M_COLOR_GREEN

Specifies the color green.

Click to summarize M_COLOR_LIGHT_BLUE

Specifies the color light blue.

Click to summarize M_COLOR_LIGHT_GRAY

Specifies the color light gray.

Click to summarize M_COLOR_LIGHT_GREEN

Specifies the color light green.

Click to summarize M_COLOR_LIGHT_WHITE

Specifies the color light white.

Click to summarize M_COLOR_MAGENTA

Specifies the color magenta.

Click to summarize M_COLOR_RED

Specifies the color red.

Click to summarize M_COLOR_WHITE

Specifies the color white.

Click to summarize M_COLOR_YELLOW

Specifies the color yellow.

Click to summarize Value

Specifies a grayscale value. The buffer can be a 1-band or multi-band buffer. The specified value is cast to the buffer type and depth.

Note that a grayscale value can be any integer or floating-point number. If the given value exceeds the range of the possible values that can be stored in each band of the destination buffer, the least significant bits of the value are used.

(summarize)
Click to summarize M_SELECTION_RADIUS

Sets the size of the selection-radius in interactive mode. Selection-radius refers to how close a mouse click needs to be to a graphic to select it. For example if a graphic is at a position that is 4 units radially away from where you clicked, the graphic will appear selected if the selection-radius is set to a value greater than or equal to 4 units. INQ

(summarize)
Click to summarize Value >= 1.0

Specifies the size of the selection-radius, in display units (these are pixel units that remain unaltered when you pan or zoom the display).

The default value is 8.0.

(summarize)
Combination values for M_FIXED_CENTER (when ControlType=M_MODE_RESIZE and ControlValue=M_FIXED_CENTER); M_FIXED_CORNER (when ControlType=M_MODE_RESIZE and ControlValue=M_FIXED_CORNER).

You can add one of the following values to the above-mentioned values to specify the aspect ratio when resizing the graphic.

The following values will not modify the graphic's aspect ratio if it is set to 1 using MgraControlList() with M_CONSTRAIN_ASPECT_RATIO.

function map For specifying the aspect ratio when resizing the graphic
Click to summarize
Combination value
Description
Click to summarize M_FIXED_ASPECT_RATIO

Specifies that the aspect ratio of the graphic remains constant when resizing it.

Click to summarize M_NO_CONSTRAINT

Specifies that the aspect ratio of the graphic can change when resizing it.

This is the default value.

(summarize)
Click to summarize M_SQUARE_ASPECT_RATIO

Specifies that the aspect ratio of the graphic will be 1:1 (square) when resizing it.

The following ControlType and corresponding ControlValue parameter settings are used to change the general settings inherited from the 2D graphics context when a graphic is initially added to the list. Unless otherwise specified, these affect all types of graphics.

In this case, the LabelOrIndex parameter can be set to one or all graphics and the SubIndex parameter must be set to M_DEFAULT.

function map For changing the general settings inherited from the 2D graphics context
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_COLOR +

Sets the foreground color of the graphic. INQ

(summarize)
Click to summarize
M_RGB888(
MIL_INT Red,
MIL_INT Green,
MIL_INT Blue
)

Specifies an RGB value when drawing in an 8-bit, 3-band buffer. The red, green, and blue values must be between 0 and 255, inclusive.

When drawing in a 16-bit or 32-bit multi-band buffer, the components of the RGB value are cast to the type of the destination buffer's bands.

To specify a 16-bit or 32-bit color component, use MgraControlList() with M_COLOR combined with the appropriate constant (M_RED, M_GREEN, or M_BLUE).

(summarize)
Parameters

Specifies the red component, as a value between 0 and 255.

Specifies the green component, as a value between 0 and 255.

Specifies the blue component, as a value between 0 and 255.

Click to summarize M_COLOR_BLACK

Specifies the color black.

Click to summarize M_COLOR_BLUE

Specifies the color blue.

Click to summarize M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

Click to summarize M_COLOR_CYAN

Specifies the color cyan.

Click to summarize M_COLOR_DARK_BLUE

Specifies the color dark blue.

Click to summarize M_COLOR_DARK_CYAN

Specifies the color dark cyan.

Click to summarize M_COLOR_DARK_GREEN

Specifies the color dark green.

Click to summarize M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

Click to summarize M_COLOR_DARK_RED

Specifies the color dark red.

Click to summarize M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

Click to summarize M_COLOR_GRAY

Specifies the color gray.

Click to summarize M_COLOR_GREEN

Specifies the color green.

Click to summarize M_COLOR_LIGHT_BLUE

Specifies the color light blue.

Click to summarize M_COLOR_LIGHT_GRAY

Specifies the color light gray.

Click to summarize M_COLOR_LIGHT_GREEN

Specifies the color light green.

Click to summarize M_COLOR_LIGHT_WHITE

Specifies the color light white.

Click to summarize M_COLOR_MAGENTA

Specifies the color magenta.

Click to summarize M_COLOR_RED

Specifies the color red.

Click to summarize M_COLOR_WHITE

Specifies the color white.

Click to summarize M_COLOR_YELLOW

Specifies the color yellow.

Click to summarize Value

Specifies a grayscale value. The buffer can be a 1-band or multi-band buffer. The specified value is cast to the buffer type and depth.

The default value is -1. For example, this value is equivalent to 0xFF for an 8-bit buffer.

Note that a grayscale value can be any integer or floating-point number. If the given value exceeds the range of the possible values that can be stored in each band of the destination buffer, the least significant bits of the value are used.

(summarize)
Click to summarize M_DRAW_DIRECTION

Sets how to draw (render) an arrow pointing in the direction with which a graphic was defined. This only affects graphics that are not filled, and that have such a direction as part of their definition; for example, arc, ellipse, line, rectangle, and ring. MIL ignores this setting for other graphics. This setting does not affect drawings created using a processing or analysis module draw function (M...Draw()).

For more information about how the directions are drawn for different graphics, see the Drawing graphics in a calibrated image subsection of the Drawing graphics section of Chapter 24: Generating graphics. INQ

(summarize)
Click to summarize M_NONE

Specifies that no direction is drawn.

Click to summarize M_PRIMARY_DIRECTION

Specifies to draw an arrow showing the primary direction of the graphic. For example, if you draw the primary direction for a rectangle defined with MgraRectAngle(), the arrow will point in the angular direction set with the Angle parameter.

(summarize)
Click to summarize M_PRIMARY_DIRECTION + M_SECONDARY_DIRECTION

Specifies to draw an arrow showing both the primary and secondary direction of the graphic.

Click to summarize M_SECONDARY_DIRECTION

Specifies to draw an arrow showing the secondary direction of the graphic. For example, a rectangle's secondary direction is equal to its PrimaryDirection - 90°.

(summarize)
Click to summarize M_DRAW_OFFSET_X

Sets the offset to subtract from the source X-coordinates before rendering the graphic.

This is useful to take results obtained relative to an offset and draw them relative to the top-left corner of the destination image of a draw operation. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.0 pixels.

Click to summarize Value

Specifies the X-coordinate offset to subtract, in pixels.

Click to summarize M_DRAW_OFFSET_Y

Sets the offset to subtract from the source Y-coordinates before rendering the graphic.

This is useful to take results obtained relative to an offset and draw them relative to the top-left corner of the destination image of a draw operation. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.0 pixels.

Click to summarize Value

Specifies the Y-coordinate offset to subtract, in pixels.

Click to summarize M_DRAW_ZOOM_X

Sets the scaling factor in the X-direction. This value is useful to zoom in on drawings of results. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.0.

Click to summarize Value > 0

Specifies the scaling factor in the X-direction.

Click to summarize M_DRAW_ZOOM_Y

Sets the scaling factor in the Y-direction. This value is useful to zoom in on drawings of results. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.0.

Click to summarize Value > 0

Specifies the scaling factor in the Y-direction.

Click to summarize M_FIXTURE

Sets the camera calibration information to use when rendering (drawing or displaying) a graphic that has been defined in world units (M_INPUT_UNITS set to M_WORLD).

MIL can interpret positioning and dimensioning information of the graphic solely using the camera calibration information associated with the destination image buffer (or the image buffer selected to the display). Alternatively, you can have MIL use the explicitly specified camera calibration information (M_GRAPHIC_SOURCE_CALIBRATION). If only the destination or the graphic is associated with camera calibration information, it will be used to render the graphic. However, if both are available, you should use M_FIXTURE to identify with respect to which of their relative coordinate systems has positioning and dimensioning information been specified. If with respect to that of the destination camera calibration information (M_USE_DESTINATION_FIRST), the source camera calibration information is not used. If with respect to that of the source camera calibration information (M_USE_SOURCE_FIRST), positions and dimensions are transformed from this relative coordinate system to the absolute coordinate system; then, since it is assumed that there is only one absolute coordinate system, these positions and dimensions are transformed from the absolute coordinate system to the pixel coordinate system, using the destination camera calibration information. INQ

(summarize)
Click to summarize M_USE_DESTINATION_FIRST

Specifies that the camera calibration information of the destination is used when rendering the graphic. In this case, the graphic follows the relative coordinate system of the destination. This is most often used when working with ROIs.

(summarize)
Click to summarize M_USE_SOURCE_FIRST

Specifies that the camera calibration information of the graphic, set with M_GRAPHIC_SOURCE_CALIBRATION, is used when rendering the graphic. In this case, the graphic is positioned independent of the destination's relative coordinate system; the destination camera calibration information is only used, if available, for the world to pixel mapping.

(summarize)
Click to summarize M_GRAPHIC_CONVERSION_MODE

Sets how the shape of a graphic, defined in world units, is converted to pixels (rendered).

Drawings created using a processing or analysis module draw function (M...Draw()) ignore this control type; instead the graphics are drawn using settings defined in their respective modules. INQ

(summarize)
Click to summarize M_PRESERVE_SHAPE_AVERAGE

Specifies to render the graphic so that its shape is preserved even if it means not respecting the camera calibration information exactly. For example, a rectangle in world units will be mapped to a rectangle in pixel units, even if the accurate conversion would not yield a rectangle.

This setting applies only to dots (MgraDot() and MgraDots()) and to rectangles (MgraRect() and MgraRectAngle()).

(summarize)
Click to summarize M_RESHAPE_FOLLOWING_DISTORTION

Specifies that all points along the contour of the graphic will be converted using the camera calibration information, following any non-linear distortion. This mode is slower, but more accurate.

(summarize)
Click to summarize M_RESHAPE_FROM_POINTS

Specifies that only a few key points or features will be converted using the camera calibration information; from these points, the rest of the graphic will be rendered respecting the shape of the graphic. For example, when converting a line segment from world to pixel units, the two end points are mapped to pixel units, and then a straight line is drawn connecting these two points, ignoring any non-linear distortion in-between. This is the fastest mode, and is accurate as long as there is only linear distortion.

(summarize)
Click to summarize M_GRAPHIC_SOURCE_CALIBRATION

Sets the camera calibration information to use to interpret positioning and dimensioning information of a graphic defined in world units (M_INPUT_UNITS set to M_WORLD), if you have set M_FIXTURE to M_USE_SOURCE_FIRST. If the destination also has camera calibration information, positioning and dimensioning information are transformed from the relative coordinate system of the source camera calibration information to its absolute coordinate system. Then, since it is assumed that there is only one absolute coordinate system, the dimensions and positions are transformed from the absolute coordinate system to the pixel coordinate system, using the destination camera calibration information.

Note that this camera calibration information is also used if you have set M_FIXTURE to M_USE_DESTINATION_FIRST, but the graphic is drawn in an image buffer that has no camera calibration information. INQ

(summarize)
Click to summarize M_NULL

Specifies that no source camera calibration information is available to interpret positioning and dimensioning information of a graphic defined in world units.

Click to summarize MIL identifier

Specifies the identifier of a camera calibration context, image buffer or processing or analysis module result buffer, whose camera calibration information to use. Note that the camera calibration information of this object is copied to an internal camera calibration context; the specified object is not associated with the 2D graphics list. Since the information is being copied, MgraInquireList() will not return the same identifier as the one passed to MgraControlList(); instead it will return the identifier of the copy. This identifier is automatically generated by MIL. If, for example, the relative coordinate system changes after using M_GRAPHIC_SOURCE_CALIBRATION, it will have no effect on the graphic.

(summarize)
Click to summarize M_INPUT_UNITS

Sets the unit with which to interpret the graphic's positional and dimensional information, for graphics already added to the 2D graphics list. This essentially sets the input coordinate system to use. INQ

(summarize)
Click to summarize M_DISPLAY

Specifies to interpret the values in pixel units that, unlike M_PIXEL, are not altered when the display is panned or zoomed. This can be useful if, for example, you always want to display the camera's current frame rate at the top-left corner. M_DISPLAY must only be specified when the 2D graphics list is used to annotate the display non-destructively, using MdispControl() with M_ASSOCIATED_GRAPHIC_LIST_ID.

(summarize)
Click to summarize M_PIXEL

Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. If the 2D graphics list is used to annotate the display non-destructively (M_ASSOCIATED_GRAPHIC_LIST_ID), the graphics will be zoomed and panned according to the display's zoom and pan settings. This is not the case when setting the units to M_DISPLAY, which also uses pixel units.

(summarize)
Click to summarize M_WORLD

Specifies to interpret the values in world units, with respect to the relative coordinate system. If the 2D graphics list is used to annotate the display non-destructively (M_ASSOCIATED_GRAPHIC_LIST_ID), the graphic will be zoomed and panned according to the display's zoom and pan settings.

When using M_WORLD, a graphic's coordinates are interpreted as real-world values and transformed to pixel values before being drawn or associated with the display non-destructively.

Note that using the camera calibration information associated with the image (M_WORLD), ensures that whenever the relative coordinate system moves (for example, with McalRelativeOrigin(), McalSetCoordinateSystem(), or McalFixture()), the non-destructive annotations move accordingly. In this case, the position of the graphics is set according to the position of the relative coordinate system.

If world units are specified, calling MgraDraw() generates an error if the operation is performed on an uncalibrated image and M_GRAPHIC_SOURCE_CALIBRATION is set to M_NULL. When the 2D graphics list is associated with the display, nothing will be drawn.

(summarize)

The following ControlType and corresponding ControlValue parameter settings are used to change settings inherited from the 2D graphics context that affect the interactivity of a graphic, drawn in a 2D graphics list associated with a display, when interactive mode is enabled (MdispControl() with M_GRAPHIC_LIST_INTERACTIVE set to M_ENABLE).

You can still change these settings even if interactive mode is disabled, but they will have no effect until interactive mode is enabled. If you attempt to change one of these settings to M_ENABLE for a graphics type that cannot be assigned this value, an error is generated.

In this case, the LabelOrIndex parameter can be set to one or all graphics and the SubIndex parameter must be set to M_DEFAULT.

function map For changing the interactive properties of graphics in the list
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_EDITABLE

Sets whether a graphic can be edited, via user interaction in an interactive display. If a graphic is not visible or if it is not selectable, it is not editable and this setting is ignored.

This setting applies to all types of graphics except dots (MgraDots()), text (MgraText()), sets of finite length lines (MgraLines() with M_LINE_LIST), and drawings created using a processing or analysis module draw function (M...Draw()). Enabling this setting when specifying an unsupported graphic type will generate an error. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the graphic cannot be edited via user interaction. Note that the graphic can still be modified using MgraControlList().

(summarize)
Click to summarize M_ENABLE

Specifies that the graphic can be edited via user interaction.

Click to summarize M_GRAPHIC_SELECTED

Sets whether a graphic is selected. In an interactive display, a selected graphic will be surrounded by a selection box with handles that allow user interaction.

This setting applies to all types of graphics. INQ

(summarize)
Click to summarize M_FALSE

Specifies that the graphic is not selected.

Click to summarize M_TRUE

Specifies that the graphic is selected.

Click to summarize M_RESIZABLE

Sets whether a graphic can be resized, via user interaction in an interactive display. If a graphic is not visible, not selectable, or not editable, it is not resizable and the setting is ignored.

This setting applies to all types of graphics except a dot (MgraDot()), dots (MgraDots()), text (MgraText()), sets of finite length lines (MgraLines() with M_LINE_LIST), and drawings created using a processing or analysis module draw function (M...Draw()). Enabling this setting when specifying an unsupported graphic type will generate an error. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the graphic cannot be resized via user interaction and the resize handles will not be displayed if a graphic is selected. Note that the graphic can still be resized using MgraControlList().

(summarize)
Click to summarize M_ENABLE

Specifies that the graphic can be resized via user interaction by clicking and dragging one of the resize handle.

Click to summarize M_ROTATABLE

Sets whether a graphic can be rotated, via user interaction in an interactive display. If a graphic is not visible, not selectable, or not editable, it is not rotatable and the setting is ignored.

This setting applies to all types of graphics except a dot (MgraDot()), dots (MgraDots()), text (MgraText()), sets of finite length lines (MgraLines() with M_LINE_LIST), and drawings created using a processing or analysis module draw function (M...Draw()). Enabling this setting when specifying an unsupported graphic type will generate an error. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the graphic cannot be rotated via user interaction and the rotate handle will not be displayed if a graphic is selected. Note that the graphic can still be rotated using MgraControlList().

(summarize)
Click to summarize M_ENABLE

Specifies that the graphic can be rotated via user interaction by clicking and dragging the rotation handle.

Click to summarize M_SELECTABLE

Sets whether a graphic can be selected, via user interaction in an interactive display. If a graphic is not visible, it is not selectable and this setting is ignored.

This setting applies to all graphics except dots (MgraDots()) and sets of finite length lines (MgraLines() with M_LINE_LIST). Enabling this setting when specifying an unsupported graphic type will generate an error. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the graphic cannot be selected via user interaction. Note that the graphic can still be selected using MgraControlList().

(summarize)
Click to summarize M_ENABLE

Specifies that the graphic can be selected by clicking on it.

Click to summarize M_SPECIFIC_FEATURES_EDITABLE

Sets whether a graphic can be modified using handles that are specific to its graphic type via user interaction in an interactive display. If a graphic is not visible, not selectable, or not editable, it cannot be modified using type-specific handles and the setting is ignored.

This setting applies to all types of graphics except dots (MgraDots()), text (MgraText()), sets of finite length lines (MgraLines() with M_LINE_LIST), and drawings created using a processing or analysis module draw function (M...Draw()). Enabling this setting when specifying an unsupported graphic type will generate an error. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the graphic cannot be modified via user interaction and its specific feature handles will not be displayed if a graphic is selected. Note that the graphic can still be modified using MgraControlList().

(summarize)
Click to summarize M_ENABLE

Specifies that the graphic can be modified via user interaction by clicking and dragging one of the type-specific handles.

Click to summarize M_TRANSLATABLE

Sets whether a graphic can be translated (moved), via user interaction in an interactive display. If a graphic is not visible, not selectable, or not editable, it is not movable and the setting is ignored.

This setting applies to all types of graphics except dots (MgraDots()), text (MgraText()), sets of finite length lines (MgraLines() with M_LINE_LIST), and drawings created using a processing or analysis module draw function (M...Draw()). Enabling this setting when specifying an unsupported graphic type will generate an error. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the graphic cannot be moved via user interaction. Note that the graphic can still be moved using MgraControlList().

(summarize)
Click to summarize M_ENABLE

Specifies that the graphic can be moved via user interaction by clicking and dragging the graphic, its selection box, or its center handle.

Click to summarize M_VISIBLE

Sets whether a graphic is rendered on the display. Note that a graphic that is not visible will not be affected by any user interaction in an interactive display.

This setting applies to all types of graphics. INQ

(summarize)
Click to summarize M_FALSE

Specifies that the graphic is not rendered.

Click to summarize M_TRUE

Specifies that the graphic is rendered.

The following ControlType and corresponding ControlValue parameter settings are used to change the settings inherited from the 2D graphics context when text (MgraText()) is added to the list.

In this case, the LabelOrIndex parameter can be set to the label or index of text in the 2D graphics list and the SubIndex parameter must be set to M_DEFAULT. Attempting to change one of the following settings on graphics other than text will generate an error.

function map For changing the settings of text
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_BACKCOLOR +

Sets the background color of the text. INQ

(summarize)
Click to summarize
M_RGB888(
MIL_INT Red,
MIL_INT Green,
MIL_INT Blue
)

Specifies an RGB value when drawing in an 8-bit, 3-band buffer. The red, green, and blue values must be between 0 and 255, inclusive.

When drawing in a 16-bit or 32-bit multi-band buffer, the components of the RGB value are cast to the type of the destination buffer's bands.

To specify a 16-bit or 32-bit color component, use MgraControlList() with M_BACKCOLOR combined with the appropriate constant (M_RED, M_GREEN, or M_BLUE).

(summarize)
Parameters

Specifies the red component, as a value between 0 and 255.

Specifies the green component, as a value between 0 and 255.

Specifies the blue component, as a value between 0 and 255.

Click to summarize M_COLOR_BLACK

Specifies the color black.

Click to summarize M_COLOR_BLUE

Specifies the color blue.

Click to summarize M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

Click to summarize M_COLOR_CYAN

Specifies the color cyan.

Click to summarize M_COLOR_DARK_BLUE

Specifies the color dark blue.

Click to summarize M_COLOR_DARK_CYAN

Specifies the color dark cyan.

Click to summarize M_COLOR_DARK_GREEN

Specifies the color dark green.

Click to summarize M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

Click to summarize M_COLOR_DARK_RED

Specifies the color dark red.

Click to summarize M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

Click to summarize M_COLOR_GRAY

Specifies the color gray.

Click to summarize M_COLOR_GREEN

Specifies the color green.

Click to summarize M_COLOR_LIGHT_BLUE

Specifies the color light blue.

Click to summarize M_COLOR_LIGHT_GRAY

Specifies the color light gray.

Click to summarize M_COLOR_LIGHT_GREEN

Specifies the color light green.

Click to summarize M_COLOR_LIGHT_WHITE

Specifies the color light white.

Click to summarize M_COLOR_MAGENTA

Specifies the color magenta.

Click to summarize M_COLOR_RED

Specifies the color red.

Click to summarize M_COLOR_WHITE

Specifies the color white.

Click to summarize M_COLOR_YELLOW

Specifies the color yellow.

Click to summarize Value

Specifies a grayscale value. The buffer can be a 1-band or multi-band buffer. The specified value is cast to the buffer type and depth.

Note that a grayscale value can be any integer or floating-point number. If the given value exceeds the range of the possible values that can be stored in each band of the destination buffer, the least significant bits of the value are used.

(summarize)
Click to summarize M_BACKGROUND_MODE

Sets whether to fill the text's background. INQ

(summarize)
Click to summarize M_OPAQUE

Specifies that the background will be filled with the current background color before drawing text.

Click to summarize M_TRANSPARENT

Specifies not to change the background before drawing text. This creates a transparent background for printed characters.

(summarize)
Click to summarize M_FONT

Sets the font of the characters in the text. INQ

(summarize)
Click to summarize
MIL_FONT_NAME(
MIL_TEXT_PTR Font
)

Specifies the font. In this case, MgraText() will use TrueType and Unicode features to draw text. This allows you to draw text using different sizes and TrueType fonts installed on your computer. This also allows you to draw any Unicode text (depending on the font).

(summarize)
Parameters

Specifies either a font and its features or a path to a font.

M_FONT_DEFAULT_TTF

Specifies the default TrueType font of your operating system.

MIL_TEXT("FontFamily:Weight:Slant") 1

Specifies the font according to the following format, Family: Weight: Slant.

Family must be set to the name of the font's family, such as Arial, Times New Roman, and Wingdings.

Weight can be set to one of the following: Thin, ExtraLight, UltraLight, Light, Book, Normal, Regular, Medium, SemiBold, DemiBold, Bold, ExtraBold, UltraBold, Heavy, Black, ExtraBlack, or UltraBlack.

Slant can be set to one of the following: Italic, Oblique, or Roman.

You can omit Weight and Slant; also, you can provide the Weight and Slant in any order.

MIL_TEXT("FontFile") 1

Specifies a full path to a TrueType file name.

Click to summarize M_FONT_DEFAULT

Same as M_FONT_DEFAULT_SMALL.

Click to summarize M_FONT_DEFAULT_LARGE

Specifies a large bitmap font, where each character is drawn in a 16x32 pixel area.

Click to summarize M_FONT_DEFAULT_MEDIUM

Specifies a medium bitmap font, where each character is drawn in a 12x24 pixel area.

Click to summarize M_FONT_DEFAULT_SMALL

Specifies a small bitmap font, where each character is drawn in a 8x16 pixel area.

Click to summarize M_FONT_AUTO_SELECT

Sets whether MIL should search for a suitable font to draw the text, if the currently selected font (M_FONT) is a TrueType font that does not support the character code. MIL will first attempt to make its selection from already used fonts, and then from system fonts. INQ

(summarize)
Click to summarize M_DISABLE

Specifies that MIL will not search for a suitable font. An error is returned if the character code cannot be drawn using the current TrueType font.

(summarize)
Click to summarize M_ENABLE

Specifies that MIL will search for a suitable font.

Click to summarize M_FONT_SIZE

Sets the font size, when using a TrueType font. When using a bitmap font, use M_FONT_X_SCALE and M_FONT_Y_SCALE to set the font size. INQ

(summarize)
Click to summarize Value >= 1

Specifies the text's font size, in points.

Click to summarize M_FONT_X_SCALE

Sets the font's horizontal scaling factor. This setting only applies to bitmap fonts. For TrueType fonts, use M_FONT_SIZE to set the font size. INQ

(summarize)
Click to summarize Value > 0

Specifies the factor with which to multiply the width of the font characters. Note that using a font with a scale of 1.0 accelerates text drawing.

(summarize)
Click to summarize M_FONT_Y_SCALE

Sets the font's vertical scaling factor. This setting only applies to bitmap fonts. For TrueType fonts, use M_FONT_SIZE to set the font size. INQ

(summarize)
Click to summarize Value > 0

Specifies the factor with which to multiply the height of the font characters. Note that using a font with a scale of 1.0 accelerates text drawing.

(summarize)
Click to summarize M_TEXT_ALIGN_HORIZONTAL

Sets the horizontal alignment of the text.

The alignment is relative to the point at which the text starts, as specified using MgraText() or using MgraControlList() with M_POSITION_X. INQ

(summarize)
Click to summarize M_CENTER

Specifies that the text is horizontally centered.

Click to summarize M_LEFT

Specifies that the text is left-aligned.

Click to summarize M_RIGHT

Specifies that the text is right-aligned.

Click to summarize M_TEXT_ALIGN_VERTICAL

Sets the vertical alignment of the text.

The alignment is relative to the point at which the text starts, as specified using MgraText() or using MgraControlList() with M_POSITION_Y. INQ

(summarize)
Click to summarize M_BOTTOM

Specifies that the text is bottom-aligned.

Click to summarize M_CENTER

Specifies that the text is vertically centered.

Click to summarize M_TOP

Specifies that the text is top-aligned.

Click to summarize M_TEXT_BORDER

Sets borders around the text.

Note that the possible settings can be combined. For example, to draw a box around the text, use M_TOP + M_BOTTOM + M_LEFT + M_RIGHT. INQ

(summarize)
Click to summarize M_BOTTOM

Specifies that a line is drawn underneath the text.

Click to summarize M_LEFT

Specifies that a line is drawn to the left of the text.

Click to summarize M_NONE

Specifies that no border is drawn around the text. This setting cannot be combined with any other setting.

(summarize)
Click to summarize M_RIGHT

Specifies that a line is drawn to the right of the text.

Click to summarize M_TOP

Specifies that a line is drawn above the text.

Click to summarize M_TEXT_DIRECTION

Sets the direction to draw the text, when using a TrueType font. INQ

(summarize)
Click to summarize M_LEFT_TO_RIGHT

Specifies that text will be drawn from left to right.

Click to summarize M_RIGHT_TO_LEFT

Specifies that text will be drawn from right to left.

1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().

You can add one of the following values to the above-mentioned values to specify the color component.

function map For specifying the color component (for 16- or 32-bit multi-band buffers)
Click to summarize
Combination value
Description
Click to summarize M_BLUE

Specifies the blue color component.

Click to summarize M_GREEN

Specifies the green color component.

Click to summarize M_RED

Specifies the red color component.

The following ControlType and corresponding ControlValue parameter settings are used to change a graphic's characteristics that have been set using the Mgra...() function with which the graphic was added to the list. In this case, the LabelOrIndex parameter can be set to one or all graphics. Unless otherwise specified, the SubIndex parameter should be set to M_DEFAULT.

function map For changing the position and dimensional information of a graphic
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_ANGLE

Sets the angle of the graphic.

This setting applies to all types of graphics except dot (MgraDot()), text (MgraText()), and drawings created using a processing or analysis module draw function (M...Draw()). INQ

(summarize)
Click to summarize -360.0 <= Value <= 360.0

Specifies the angle, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup.

(summarize)
Click to summarize M_ANGLE_END

Sets the angle at which to stop drawing the arc.

This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()). INQ

(summarize)
Click to summarize Value

Specifies the end angle, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup.

(summarize)
Click to summarize M_ANGLE_START

Sets the angle at which to start drawing the arc.

This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()). INQ

(summarize)
Click to summarize Value

Specifies the start angle, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup.

(summarize)
Click to summarize M_ARC_STYLE

Sets whether to draw an arc or a sector.

This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()). INQ

(summarize)
Click to summarize M_CONTOUR

Specifies that the arc (the curve between the specified start and end angles) is drawn without lines extending from the center of the ellipse to the start and end points of the arc.

Click to summarize M_SECTOR

Specifies that a sector is drawn with lines extending from the center of the ellipse to the start and end points of the arc, unless the specified start and end angles form a closed curve.

Click to summarize M_CONSTRAIN_ASPECT_RATIO

Sets whether to force the width and height of a graphic to be equal. This affects both interactive and programmatic manipulations.

This setting applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()) and rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ

(summarize)
Click to summarize M_DISABLE

Specifies that the width and height of a graphic are not forced to be equal.

Click to summarize 1.0

Specifies that the width and height of a graphic are forced to be equal. This is considered a 1:1 (square) aspect ratio. Changing this setting on a graphic that does not meet this condition will change the dimensions of the graphic accordingly. Any attempts to change one of the dimensions, either programatically or interactively, will scale the other so that the condition (1:1) is met.

(summarize)
Click to summarize M_FILLED

Sets whether to fill the graphic.

This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()), polygons (MgraLines() with M_POLYGON), and rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ

(summarize)
Click to summarize M_FALSE

Specifies that the graphic is not filled.

Click to summarize M_TRUE

Specifies that the graphic is filled.

Click to summarize M_POSITION_TYPE +

Sets how to interpret M_POSITION_X and M_POSITION_Y for a rectangle.

This setting only applies to rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ

(summarize)
Click to summarize M_CENTER_AND_DIMENSION

Specifies to interpret M_POSITION_X and M_POSITION_Y as the rectangle's center.

Click to summarize M_CORNER_AND_DIMENSION

Specifies to interpret M_POSITION_X and M_POSITION_Y as the rectangle's top-left corner.

Click to summarize M_POSITION_X

Sets the X-position of a graphic, or of one of its sub-elements (position-points).

If SubIndex is set to M_DEFAULT, this setting affects the entire graphic. If a sub-element is specified, a single point, within the graphic, is affected by this setting.

This setting applies to all types of graphics except drawings created using a processing or analysis module draw function (M...Draw()). INQ

(summarize)
Click to summarize Value

Specifies the X-position. You can specify any positive or negative value.

(summarize)
Click to summarize M_POSITION_Y

Sets the Y-position of a graphic, or of one of its sub-elements (position-points).

If SubIndex is set to M_DEFAULT, this setting affects the entire graphic. If a sub-element is specified, a single point, within the graphic, is affected by this setting.

This setting applies to all types of graphics except drawings created using a processing or analysis module draw function (M...Draw()). INQ

(summarize)
Click to summarize Value

Specifies the Y-position. You can specify any positive or negative value.

(summarize)
Click to summarize M_RADIUS_X

Sets the radius of the arc in the X-direction.

This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()). INQ

(summarize)
Click to summarize Value >= 0

Specifies the radius.

Click to summarize M_RADIUS_Y

Sets the radius of the arc in the Y-direction.

This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()). INQ

(summarize)
Click to summarize Value >= 0

Specifies the radius.

Click to summarize M_RECTANGLE_HEIGHT

Sets the height of the rectangle.

This setting only applies to rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ

(summarize)
Click to summarize Value

Specifies the height.

Click to summarize M_RECTANGLE_WIDTH

Sets the width of the rectangle.

This setting only applies to rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ

(summarize)
Click to summarize Value

Specifies the width.

The following ControlType and corresponding ControlValue parameter settings are used to perform geometric operations on graphics. Using one of the following operations on a graphic will change its current position and dimensional settings (the settings listed in the For changing the position and dimensional information of a graphic table). Once an operation has occurred, the value specified cannot be inquired.

In this case, the LabelOrIndex parameter can be set to one or all graphics. Unless otherwise specified, the SubIndex parameter should be set to M_DEFAULT.

function map For performing geometric operations on graphics
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_APPLY_SCALE

Performs a uniform scaling operation on the graphic. A uniform scaling operation enlarges or shrinks graphics by a scale factor in both X- and Y-directions, relative to the point specified by M_POSITION_X and M_POSITION_Y; the point specified by M_POSITION_X and M_POSITION_Y remains the same after a uniform scaling operation. For example, if you specify a scale factor of one half to dots (MgraDots()), each dot will have its distance from M_POSITION_X and M_POSITION_Y reduced by one half.

This setting applies to all types of graphics except dot (MgraDot()) and drawings created using a processing or analysis module draw function (M...Draw()).

(summarize)
Click to summarize Value > 0.0

Specifies the scale factor.

Click to summarize M_RESIZE_HEIGHT

Increases or decreases the graphic's height. This does not affect the graphic's X- and Y-position (M_POSITION_X and M_POSITION_Y remains the same).

MIL typically resizes the height on both sides of the graphic; therefore, the height is actually modified by twice the specified resize value. This does not occur for rectangle graphics whose position (M_POSITION_TYPE) is interpreted as its top-left corner (M_CORNER_AND_DIMENSION). In that case, MIL only applies the resize value to the opposite side.

This setting applies to all types of graphics except dot (MgraDot()), text (MgraText()), and drawings created using a processing or analysis module draw function (M...Draw()).

(summarize)
Click to summarize Value

Specifies the value by which to resize the height.

Click to summarize M_RESIZE_WIDTH

Increases or decreases the graphic's width. This does not affect the graphic's X- and Y-position (M_POSITION_X and M_POSITION_Y remains the same).

MIL typically resizes the width on both sides of the graphic; therefore, the width is actually modified by twice the specified resize value. This does not occur for rectangle graphics whose position (M_POSITION_TYPE) is interpreted as its top-left corner (M_CORNER_AND_DIMENSION). In that case, MIL only applies the resize value to the opposite side.

This setting applies to all types of graphics except dot (MgraDot()), text (MgraText()), and drawings created using a processing or analysis module draw function (M...Draw()).

(summarize)
Click to summarize Value

Specifies the value by which to resize the width.

Click to summarize M_ROTATE

Performs a rotation operation on the graphic, or one of its sub-elements. Graphics are rotated around the point specified with M_POSITION_X and M_POSITION_Y.

This setting applies to all types of graphics except dot (MgraDot()), text (MgraText()), and drawings created using a processing or analysis module draw function (M...Draw()).

(summarize)
Click to summarize -360.0 <= Value <= 360.0

Specifies the angle of rotation, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS. The value specified will be added to the graphic's current angle (M_ANGLE).

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup.

(summarize)
Click to summarize M_TRANSLATE_X

Performs a horizontal translation of a graphic, or of one of its sub-elements.

If SubIndex is set to M_DEFAULT, this setting affects the entire graphic. If a sub-element is specified, a single point, within the graphic, is affected by this setting.

This setting applies to all types of graphics except drawings created using a processing or analysis module draw function (M...Draw()).

(summarize)
Click to summarize Value

Specifies the horizontal displacement. You can specify any positive or negative value. The value specified will be added to the graphic's current X-position (M_POSITION_X).

(summarize)
Click to summarize M_TRANSLATE_Y

Performs a vertical translation of a graphic, or of one of its sub-elements.

If SubIndex is set to M_DEFAULT, this setting affects the entire graphic. If a sub-element is specified, a single point, within the graphic, is affected by this setting.

This setting applies to all types of graphics except drawings created using a processing or analysis module draw function (M...Draw()).

(summarize)
Click to summarize Value

Specifies the vertical displacement. You can specify any positive or negative value. The value specified will be added to the graphic's current Y-position (M_POSITION_Y).

(summarize)
Combination value for M_POSITION_TYPE.

You can add the following value to the above-mentioned value to specify that a rectangle should stay at the same location in the image regardless of how MIL interprets its reference position.

function map For specifying that a rectangle should stay at the same location regardless of how MIL interprets its position
Click to summarize
Combination value
Description
Click to summarize M_SAME_LOCATION

Specifies that, when you set M_POSITION_TYPE, MIL also adjusts the rectangle's actual position in the image so it remains at the same location.

The following ControlType and corresponding ControlValue parameter settings are used to delete graphics from the 2D graphics list. The LabelOrIndex parameter can be set to one or all graphics and the SubIndex parameter must be set to M_DEFAULT.

function map For deleting graphics (one or all) from the list
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_DELETE

Deletes the graphic (one or all), as specified by the LabelOrIndex parameter setting. When a graphic is deleted, the indices of the 2D graphics list are reassigned; that is, index values greater than that of the removed graphic are reduced by one.

(summarize)
Click to summarize M_DEFAULT

Implements the default behavior.

The following ControlType and corresponding ControlValue parameter settings are used to specify general settings for using keyboard keys to interactively modify graphics. In this case, set the LabelOrIndex parameter to M_LIST and the SubIndex parameter to M_DEFAULT. These settings apply to the 2D graphics list itself.

function map For specifying general keyboard key settings to interactively modify graphics
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_ACTION_KEYS

Sets whether the 2D graphics list allows you to interactively modify its graphics by pressing keys on the keyboard (keyboard events). INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that the 2D graphics list ignores keyboard events.

Click to summarize M_ENABLE

Specifies that the 2D graphics list allows keyboard events to interactively modify its graphics. In this case, you must still enable the 2D graphics list's interactivity (MdispControl() with M_GRAPHIC_LIST_INTERACTIVE).

(summarize)
Click to summarize M_ACTION_MODIFIER_SPEED

Set the additional keyboard key that you can press to select an alternate speed to rotate, resize, or translate interactively selected graphics with the keyboard. This affects M_ACTION_KEY_ROTATE_..., M_ACTION_KEY_RESIZE_..., and M_ACTION_KEY_TRANSLATE_... settings. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_CTRL.

Click to summarize M_KEY_ALT

Specifies to use the Alt key to select an alternate speed.

Click to summarize M_KEY_CTRL

Specifies to use the Ctrl key to select an alternate speed.

Click to summarize M_KEY_SHIFT

Specifies to use the Shift key to select an alternate speed.

Click to summarize M_NONE

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_RESIZE_INCREMENT

Sets the value with which to increase or decrease the width or height of the interactively selected graphic for a single key press. This affects the M_ACTION_KEY_RESIZE_... settings. Note that if the graphic is in world units, the increment is converted to world units using the calibration's average pixel size in the resizing direction.

To keep the graphic's position fixed, MIL typically applies this increment value to both sides of the graphic. Therefore, the graphic's width or height is actually modified by twice the specified value. This does not occur for rectangle graphics whose position (M_POSITION_TYPE) is interpreted as its top-left corner (M_CORNER_AND_DIMENSION). In that case, MIL only applies the increment to the opposite side. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.0.

Click to summarize Value > 0.0

Specifies the increment, in display units (these are pixel units that remain unaltered when you pan or zoom the display).

Click to summarize M_ACTION_RESIZE_INCREMENT_ALTERNATE

Sets an alternate value with which to increase or decrease the width or height of the interactively selected graphic for a single key press. M_ACTION_RESIZE_INCREMENT_ALTERNATE behaves like M_ACTION_RESIZE_INCREMENT. MIL uses M_ACTION_RESIZE_INCREMENT_ALTERNATE instead of M_ACTION_RESIZE_INCREMENT when you press the key specified for M_ACTION_MODIFIER_SPEED while you resize the graphic using the keyboard. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 10.0.

Click to summarize Value > 0.0

Specifies the increment, in display units (these are pixel units that remain unaltered when you pan or zoom the display).

Click to summarize M_ACTION_ROTATE_INCREMENT

Sets the angle with which to rotate the interactively selected graphic for a single key press. This affects the M_ACTION_KEY_ROTATE_... settings. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.0°.

Click to summarize Value > 0.0

Specifies the angle, in degrees.

Click to summarize M_ACTION_ROTATE_INCREMENT_ALTERNATE

Sets an alternate angle with which to rotate the interactively selected graphic for a single key press. M_ACTION_ROTATE_INCREMENT_ALTERNATE behaves like M_ACTION_ROTATE_INCREMENT. MIL uses M_ACTION_ROTATE_INCREMENT_ALTERNATE instead of M_ACTION_ROTATE_INCREMENT when you press the key specified for M_ACTION_MODIFIER_SPEED while you rotate the graphic using the keyboard. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 15.0°.

Click to summarize Value > 0.0

Specifies the angle, in degrees.

Click to summarize M_ACTION_TRANSLATE_AXES

Set the axes along which MIL translates a graphic that is in world units, when the translation is done using the keyboard. This affects M_ACTION_TRANSLATE_INCREMENT and M_ACTION_TRANSLATE_INCREMENT_ALTERNATE. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_PIXEL.

Click to summarize M_ACCORDING_TO_CALIBRATION

Specifies to convert the translation increment to world units using the calibration's average pixel size in the translation direction, then apply it along the world axes.

Click to summarize M_PIXEL

Specifies to apply the translation increment to the graphic position, along the image axes, in display units (these are pixel units that remain unaltered when you pan or zoom the display).

Click to summarize M_ACTION_TRANSLATE_INCREMENT

Sets the value with which to translate (move) the interactively selected graphics for a single key press. This affects the M_ACTION_KEY_TRANSLATE_... settings. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.0.

Click to summarize Value > 0.0

Specifies the increment, in display units (these are pixel units that remain unaltered when you pan or zoom the display). Note that if the graphic is in world units, the behavior depends on M_ACTION_TRANSLATE_AXES.

(summarize)
Click to summarize M_ACTION_TRANSLATE_INCREMENT_ALTERNATE

Sets an alternate value with which to translate (move) the interactively selected graphics for a single key press. M_ACTION_TRANSLATE_INCREMENT_ALTERNATE behaves like M_ACTION_TRANSLATE_INCREMENT. MIL uses M_ACTION_TRANSLATE_INCREMENT_ALTERNATE instead of M_ACTION_TRANSLATE_INCREMENT when you press the key specified for M_ACTION_MODIFIER_SPEED while you move the graphic using the keyboard. INQ

(summarize)
Click to summarize M_DEFAULT

Specifies the default value; the default value is 10.0.

Click to summarize Value > 0.0

Specifies the increment, in display units (these are pixel units that remain unaltered when you pan or zoom the display). Note that if the graphic is in world units, the increment depends on M_ACTION_TRANSLATE_AXES.

(summarize)

The following ControlType and corresponding ControlValue parameter settings are used to specify explicit keyboard keys to interactively modify graphics. In this case, set the LabelOrIndex parameter to M_LIST and the SubIndex parameter to M_DEFAULT. These settings apply to the 2D graphics list itself.

function map For specifying explicit keyboard keys to interactively modify graphics
Click to summarize
ControlType
Description
ControlValue
Click to summarize M_ACTION_KEY_CANCEL

Sets the keyboard keys that you can press to cancel the interactive graphic modification you are currently performing. MIL recommends using the Esc key. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

If you press the specified cancel key while you are interactively translating (moving), resizing, or rotating the graphic, MIL returns the graphic to its initial state (before you started interacting with it). If you press the specified cancel key while interactively creating the graphic, MIL removes from the display any part of the graphic you started to define, and also removes the graphic from the 2D graphics list (the graphic is typically added to the 2D graphics list before it is entirely defined). If you press the specified cancel key when there is no interaction to cancel, MIL deselects all selected graphics.

M_ACTION_KEY_CANCEL only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_NONE.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_DELETE

Sets the keyboard keys that you can press to delete the interactively selected graphics. MIL recommends using the Delete key. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_DELETE only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_NONE.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_RESIZE_HEIGHT_DOWN

Sets the keyboard keys that you can press to reduce the height of the interactively selected graphics. MIL recommends using the Down Arrow key and the Shift key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_RESIZE_HEIGHT_DOWN only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_DOWN + M_KEY_SHIFT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_RESIZE_HEIGHT_UP

Sets the keyboard keys that you can press to increase the height of the interactively selected graphics. MIL recommends using the Up Arrow key and the Shift key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_RESIZE_HEIGHT_UP only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_UP + M_KEY_SHIFT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_RESIZE_WIDTH_DOWN

Sets the keyboard keys that you can press to reduce the width of the interactively selected graphics. MIL recommends using the Left Arrow key and the Shift key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_RESIZE_WIDTH_DOWN only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_LEFT + M_KEY_SHIFT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_RESIZE_WIDTH_UP

Sets the keyboard keys that you can press to increase the width of the interactively selected graphics. MIL recommends using the Right Arrow key and the Shift key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_RESIZE_WIDTH_UP only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_RIGHT + M_KEY_SHIFT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_ROTATE_CLOCKWISE

Sets the keyboard keys that you can press to rotate the interactively selected graphics clockwise. MIL recommends using the Right Arrow key and the Alt key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_ROTATE_CLOCKWISE only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_RIGHT + M_KEY_ALT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_ROTATE_COUNTER_CLOCKWISE

Sets the keyboard keys that you can press to rotate the interactively selected graphics counter-clockwise. MIL recommends using the Left Arrow key and the Alt key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_ROTATE_COUNTER_CLOCKWISE only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_LEFT + M_KEY_ALT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_TRANSLATE_DOWN

Sets the keyboard keys that you can press to translate (move) the interactively selected graphics down. MIL recommends specifying the Down Arrow key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_TRANSLATE_DOWN only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_DOWN.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_TRANSLATE_LEFT

Sets the keyboard keys that you can press to translate (move) the interactively selected graphics left. MIL recommends specifying the Left Arrow key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_TRANSLATE_LEFT only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_LEFT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_TRANSLATE_RIGHT

Sets the keyboard keys that you can press to translate (move) the interactively selected graphics right. MIL recommends specifying the Right Arrow key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_TRANSLATE_RIGHT only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_RIGHT.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Click to summarize M_ACTION_KEY_TRANSLATE_UP

Sets the keyboard keys that you can press to translate (move) the interactively selected graphics up. MIL recommends specifying the Up Arrow key, which is the default. If the keyboard key that you specify is used by another action setting (M_ACTION_KEY_...), MIL sets that other action setting to M_NONE.

M_ACTION_KEY_TRANSLATE_UP only has an effect if you enable M_ACTION_KEYS. INQ

(summarize)
Click to summarize M_DEFAULT

Same as M_KEY_ARROW_UP.

Click to summarize M_KEY_ADD +

Specifies the Add key (+).

Click to summarize M_KEY_ARROW_DOWN +

Specifies the Down Arrow key.

Click to summarize M_KEY_ARROW_LEFT +

Specifies the Left Arrow key.

Click to summarize M_KEY_ARROW_RIGHT +

Specifies the Right Arrow key.

Click to summarize M_KEY_ARROW_UP +

Specifies the Up Arrow key.

Click to summarize M_KEY_BACK +

Specifies the Back key.

Click to summarize M_KEY_CLEAR +

Specifies the Clear key.

Click to summarize M_KEY_DECIMAL +

Specifies the Period key located on your number pad.

Click to summarize M_KEY_DELETE +

Specifies the Delete key.

Click to summarize M_KEY_DIVIDE +

Specifies the Divide key (/).

Click to summarize M_KEY_END +

Specifies the End key.

Click to summarize M_KEY_ESC +

Specifies the Esc key.

Click to summarize M_KEY_EXECUTE +

Specifies the Execute key.

Click to summarize M_KEY_Fn +

Specifies the n key, where n is a value from 1 to 24.

Click to summarize M_KEY_HOME +

Specifies the Home key.

Click to summarize M_KEY_INSERT +

Specifies the Insert key.

Click to summarize M_KEY_MULTIPLY +

Specifies the Multiply key (*).

Click to summarize M_KEY_n +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_NUM_LOCK +

Specifies the Num Lock key.

Click to summarize M_KEY_NUMPADn +

Specifies the n key, where n is a value from 0 to 9.

Click to summarize M_KEY_PAGEDOWN +

Specifies the Pagedown key.

Click to summarize M_KEY_PAGEUP +

Specifies the Pageup key.

Click to summarize M_KEY_PAUSE +

Specifies the Pause key.

Click to summarize M_KEY_RETURN +

Specifies the Return key (Enter).

Click to summarize M_KEY_SCROLL_LOCK +

Specifies the Scroll Lock key.

Click to summarize M_KEY_SEPARATOR +

Specifies the Separator key.

Click to summarize M_KEY_SPACE +

Specifies the Space key.

Click to summarize M_KEY_SUBTRACT +

Specifies the Subtract key (-).

Click to summarize M_KEY_TAB +

Specifies the Tab key.

Click to summarize M_KEY_xxx +

Specifies the letter key xxx, where xxx can be a letter from A to Z.

Click to summarize M_NONE +

Specifies that there are no keyboard keys for this action setting.

Combination values for the values of the ControlValue parameter listed in For specifying explicit keyboard keys to interactively modify graphics.

You can add one or more of the following values to the above-mentioned values to specify an additional keyboard key.

For example, to specify that you must press the Right Arrow key while pressing the Alt key to rotate the interactively selected graphic clockwise, set the ControlType parameter to M_ACTION_KEY_ROTATE_CLOCKWISE, and set the ControlValue parameter to M_KEY_ARROW_RIGHT + M_KEY_ALT.

function map For specifying additional keyboard keys
Click to summarize
Combination value
Description
Click to summarize M_KEY_ALT

Specifies the Alt key.

Click to summarize M_KEY_CTRL

Specifies the Ctrl key.

Click to summarize M_KEY_SHIFT

Specifies the Shift key.

Type-specific versions of the function when using a C compiler under 64-bit
void MgraControlListDouble (MIL_ID GraListId, MIL_INT LabelOrIndex, MIL_INT SubIndex, MIL_INT64 ControlType, MIL_DOUBLE ControlValue)
Parameters

GraListId

See GraListId of the main function for a description.

LabelOrIndex

See LabelOrIndex of the main function for a description.

SubIndex

See SubIndex of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.

void MgraControlListInt64 (MIL_ID GraListId, MIL_INT LabelOrIndex, MIL_INT SubIndex, MIL_INT64 ControlType, MIL_INT64 ControlValue)
Parameters

GraListId

See GraListId of the main function for a description.

LabelOrIndex

See LabelOrIndex of the main function for a description.

SubIndex

See SubIndex of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.

Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll.
NUMBER OF GRAPHICS ALL ALL SELECTED LIST DEFAULT NUMBER OF SUB ELEMENTS ANGLE SNAPPING VALUE DEFAULT EASY SELECTION DEFAULT DISABLE ENABLE INTERACTIVE ANNOTATIONS COLOR COLOR BLACK COLOR BLUE COLOR BRIGHT GRAY COLOR CYAN COLOR DARK BLUE COLOR DARK CYAN COLOR DARK GREEN COLOR DARK MAGENTA COLOR DARK RED COLOR DARK YELLOW COLOR GRAY COLOR GREEN COLOR LIGHT BLUE COLOR LIGHT GRAY COLOR LIGHT GREEN COLOR LIGHT WHITE COLOR MAGENTA COLOR RED COLOR WHITE COLOR YELLOW MODE RESIZE DEFAULT FIXED CENTER FIXED CORNER MODE RESIZE ALT DEFAULT DISABLE FIXED ASPECT RATIO FIXED CENTER FIXED CORNER NO CONSTRAINT SQUARE ASPECT RATIO MODE RESIZE CTRL DEFAULT DISABLE FIXED ASPECT RATIO FIXED CENTER FIXED CORNER NO CONSTRAINT SQUARE ASPECT RATIO MODE RESIZE SECONDARY DIMENSION DEFAULT ONE SIDED SYMMETRIC MODE RESIZE SECONDARY DIMENSION ALT DEFAULT DISABLE ONE SIDED SYMMETRIC MODE RESIZE SECONDARY DIMENSION CTRL DEFAULT DISABLE ONE SIDED SYMMETRIC MODE RESIZE SECONDARY DIMENSION SHIFT DEFAULT DISABLE ONE SIDED SYMMETRIC MODE RESIZE SHIFT DEFAULT DISABLE FIXED ASPECT RATIO FIXED CENTER FIXED CORNER NO CONSTRAINT SQUARE ASPECT RATIO MODE ROTATE DEFAULT ANGLE SNAPPING NO CONSTRAINT MODE ROTATE ALT DEFAULT ANGLE SNAPPING DISABLE NO CONSTRAINT MODE ROTATE CTRL DEFAULT ANGLE SNAPPING DISABLE NO CONSTRAINT MODE ROTATE SHIFT DEFAULT ANGLE SNAPPING DISABLE NO CONSTRAINT MODE TRANSLATE DEFAULT AXIS ALIGNED NO CONSTRAINT MODE TRANSLATE ALT DEFAULT AXIS ALIGNED DISABLE NO CONSTRAINT MODE TRANSLATE CTRL DEFAULT AXIS ALIGNED DISABLE NO CONSTRAINT MODE TRANSLATE SHIFT DEFAULT AXIS ALIGNED DISABLE NO CONSTRAINT MULTIPLE SELECTION DISABLE ENABLE MULTIPLE SELECTION KEY DEFAULT KEY ALT KEY CTRL KEY SHIFT SELECTED COLOR COLOR BLACK COLOR BLUE COLOR BRIGHT GRAY COLOR CYAN COLOR DARK BLUE COLOR DARK CYAN COLOR DARK GREEN COLOR DARK MAGENTA COLOR DARK RED COLOR DARK YELLOW COLOR GRAY COLOR GREEN COLOR LIGHT BLUE COLOR LIGHT GRAY COLOR LIGHT GREEN COLOR LIGHT WHITE COLOR MAGENTA COLOR RED COLOR WHITE COLOR YELLOW SELECTION RADIUS FIXED ASPECT RATIO NO CONSTRAINT SQUARE ASPECT RATIO COLOR COLOR BLACK COLOR BLUE COLOR BRIGHT GRAY COLOR CYAN COLOR DARK BLUE COLOR DARK CYAN COLOR DARK GREEN COLOR DARK MAGENTA COLOR DARK RED COLOR DARK YELLOW COLOR GRAY COLOR GREEN COLOR LIGHT BLUE COLOR LIGHT GRAY COLOR LIGHT GREEN COLOR LIGHT WHITE COLOR MAGENTA COLOR RED COLOR WHITE COLOR YELLOW DRAW DIRECTION NONE PRIMARY DIRECTION PRIMARY DIRECTION M SECONDARY DIRECTION SECONDARY DIRECTION DRAW OFFSET X DEFAULT DRAW OFFSET Y DEFAULT DRAW ZOOM X DEFAULT DRAW ZOOM Y DEFAULT FIXTURE USE DESTINATION FIRST USE SOURCE FIRST GRAPHIC CONVERSION MODE PRESERVE SHAPE AVERAGE RESHAPE FOLLOWING DISTORTION RESHAPE FROM POINTS GRAPHIC SOURCE CALIBRATION NULL NULL INPUT UNITS DISPLAY PIXEL WORLD EDITABLE DISABLE ENABLE GRAPHIC SELECTED FALSE TRUE RESIZABLE DISABLE ENABLE ROTATABLE DISABLE ENABLE SELECTABLE DISABLE ENABLE SPECIFIC FEATURES EDITABLE DISABLE ENABLE TRANSLATABLE DISABLE ENABLE VISIBLE FALSE TRUE BACKCOLOR COLOR BLACK COLOR BLUE COLOR BRIGHT GRAY COLOR CYAN COLOR DARK BLUE COLOR DARK CYAN COLOR DARK GREEN COLOR DARK MAGENTA COLOR DARK RED COLOR DARK YELLOW COLOR GRAY COLOR GREEN COLOR LIGHT BLUE COLOR LIGHT GRAY COLOR LIGHT GREEN COLOR LIGHT WHITE COLOR MAGENTA COLOR RED COLOR WHITE COLOR YELLOW BACKGROUND MODE OPAQUE TRANSPARENT FONT FONT DEFAULT TTF FONT DEFAULT FONT DEFAULT LARGE FONT DEFAULT MEDIUM FONT DEFAULT SMALL FONT AUTO SELECT DISABLE ENABLE FONT SIZE FONT X SCALE FONT Y SCALE TEXT ALIGN HORIZONTAL CENTER LEFT RIGHT TEXT ALIGN VERTICAL BOTTOM CENTER TOP TEXT BORDER BOTTOM LEFT NONE RIGHT TOP TEXT DIRECTION LEFT TO RIGHT RIGHT TO LEFT BLUE GREEN RED ANGLE ANGLE END ANGLE START ARC STYLE CONTOUR SECTOR CONSTRAIN ASPECT RATIO DISABLE FILLED FALSE TRUE POSITION TYPE CENTER AND DIMENSION CORNER AND DIMENSION POSITION X POSITION Y RADIUS X RADIUS Y RECTANGLE HEIGHT RECTANGLE WIDTH APPLY SCALE RESIZE HEIGHT RESIZE WIDTH ROTATE TRANSLATE X TRANSLATE Y SAME LOCATION DELETE DEFAULT ACTION KEYS DEFAULT DISABLE ENABLE ACTION MODIFIER SPEED DEFAULT KEY ALT KEY CTRL KEY SHIFT NONE ACTION RESIZE INCREMENT DEFAULT ACTION RESIZE INCREMENT ALTERNATE DEFAULT ACTION ROTATE INCREMENT DEFAULT ACTION ROTATE INCREMENT ALTERNATE DEFAULT ACTION TRANSLATE AXES DEFAULT ACCORDING TO CALIBRATION PIXEL ACTION TRANSLATE INCREMENT DEFAULT ACTION TRANSLATE INCREMENT ALTERNATE DEFAULT ACTION KEY CANCEL DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY DELETE DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY RESIZE HEIGHT DOWN DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY RESIZE HEIGHT UP DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY RESIZE WIDTH DOWN DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY RESIZE WIDTH UP DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY ROTATE CLOCKWISE DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY ROTATE COUNTER CLOCKWISE DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY TRANSLATE DOWN DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY TRANSLATE LEFT DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY TRANSLATE RIGHT DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE ACTION KEY TRANSLATE UP DEFAULT KEY ADD KEY ARROW DOWN KEY ARROW LEFT KEY ARROW RIGHT KEY ARROW UP KEY BACK KEY CLEAR KEY DECIMAL KEY DELETE KEY DIVIDE KEY END KEY ESC KEY EXECUTE KEY Fn KEY HOME KEY INSERT KEY MULTIPLY KEY n KEY NUM LOCK KEY NUMPADn KEY PAGEDOWN KEY PAGEUP KEY PAUSE KEY RETURN KEY SCROLL LOCK KEY SEPARATOR KEY SPACE KEY SUBTRACT KEY TAB KEY xxx NONE KEY ALT KEY CTRL KEY SHIFT LIST DEFAULT LIST DEFAULT LIST ALL ALL SELECTED DEFAULT GRAPHIC TYPE TEXT LIST LIST DEFAULT M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx M_KEY_Fn M_KEY_n M_KEY_NUMPADn M_KEY_xxx