MgraControlList

Filters
See also

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

3dplanarity.cpp
alphablending.cpp
chromasens3dpixa.cpp
defectdetectionexample.cpp
examplemanager.cpp
fixturingusingblob.cpp
mdispgtkview.cpp
mdispmfcview.cpp
mdispqtview.cpp
mgrainteractive.cpp
mgrainteractive.cs
mgrainteractive.vb
multiviewannotations.cpp

Function Map

- GraListId

Table:

For specifying the graphics list or graphic therein

- SubIndex

Table:

For specifying the index of a graphic's sub-element

- ControlType

- ControlValue

Parameter Associations

Table:	For changing the settings of the graphics list itself
Table:	For changing the settings inherited from the graphics context
Table:	For changing the interactive properties of graphics in the list
Table:	For changing the settings of text
+ combination:	For specifying the color component (for 16- or 32-bit multi-band buffers)
Table:	For changing the position and dimensional information of a graphic
Table:	For performing geometric operations on graphics
Table:	For deleting graphics (one or all) from the list

Type specific versions of the function when using a C compiler under 64-bit

Compilation information

Synopsis

Control the graphics contained within the 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 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 graphics context. However, subsequent changes to the 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 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 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 if there is complementary information.

Parameters

This function is not supported on the selected boards.

Parameters

GraListId

Specifies the identifier of the graphics list to control. The 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:

For specifying the graphics list or graphic therein
Value	Description
M_GRAPHIC_INDEX( MIL_INT Index )	Specifies the index of an existing graphic on which to apply the control setting. (summarize) Specifies the index of an existing graphic on which to apply the control setting. (more details...)
		Parameters
		Index 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).
M_GRAPHIC_LABEL( MIL_INT Label )	Specifies the label of an existing graphic on which to apply the control setting. (summarize) Specifies the label of an existing graphic on which to apply the control setting. (more details...)
		Parameters
		Label 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).
M_ALL	Applies the specified control setting to all the graphics contained within the graphics list. The graphics that do not support the specified control type setting remain unchanged. (summarize) Applies the specified control setting to all the graphics contained within the graphics list. (more details...)
M_ALL_SELECTED	Applies the specified control setting to all the graphics contained within the 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) Applies the specified control setting to all the graphics contained within the graphics list that are currently selected (that is, all graphics with M_GRAPHIC_SELECTED set to M_TRUE). (more details...)
M_LIST	Applies the specified control setting to the 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.

For specifying the index of a graphic's sub-element

Value

Description

M_DEFAULT

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

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)

Specifies the index of the sub-element of the graphic on which to apply the control setting.

(more details...)

ControlType

Specifies the 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 graphics list setting.

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

Parameter associations

The tables below list possible values for the ControlType and ControlValue parameters.

For changing the settings of the graphics list itself
For changing the settings inherited from the graphics context
For changing the interactive properties of graphics in the list
For changing the settings of text
For changing the position and dimensional information of a graphic
For performing geometric operations on graphics
For deleting graphics (one or all) from the list

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

For changing the settings of the graphics list itself
ControlType		Description
	ControlValue	Description
M_INTERACTIVE_ANNOTATIONS_COLOR +		Sets the color of the selection box and handles when in interactive mode. INQ (summarize) Sets the color of the selection box and handles when in interactive mode. INQ (more details...)
	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) Specifies an RGB value when drawing in an 8-bit, 3-band buffer. (more details...)
			Parameters
			Red Specifies the red component, as a value between 0 and 255.
			Green Specifies the green component, as a value between 0 and 255.
			Blue Specifies the blue component, as a value between 0 and 255.
	M_COLOR_BLACK	Specifies the color black.
	M_COLOR_BLUE	Specifies the color blue.
	M_COLOR_BRIGHT_GRAY	Specifies the color bright gray.
	M_COLOR_CYAN	Specifies the color cyan.
	M_COLOR_DARK_BLUE	Specifies the color dark blue.
	M_COLOR_DARK_CYAN	Specifies the color dark cyan.
	M_COLOR_DARK_GREEN	Specifies the color dark green.
	M_COLOR_DARK_MAGENTA	Specifies the color dark magenta.
	M_COLOR_DARK_RED	Specifies the color dark red.
	M_COLOR_DARK_YELLOW	Specifies the color dark yellow.
	M_COLOR_GRAY	Specifies the color gray.
	M_COLOR_GREEN	Specifies the color green.
	M_COLOR_LIGHT_BLUE	Specifies the color light blue.
	M_COLOR_LIGHT_GRAY	Specifies the color light gray.
	M_COLOR_LIGHT_GREEN	Specifies the color light green.
	M_COLOR_LIGHT_WHITE	Specifies the color light white.
	M_COLOR_MAGENTA	Specifies the color magenta.
	M_COLOR_RED	Specifies the color red.
	M_COLOR_WHITE	Specifies the color white.
	M_COLOR_YELLOW	Specifies the color yellow.
	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) Specifies a grayscale value. (more details...)
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) Sets whether to permit interactive multiple selection using the Ctrl key. INQ (more details...)
	M_DISABLE	Specifies that interactive multiple selection is not permitted.
	M_ENABLE	Specifies that interactive multiple selection is permitted. This is the default value. (summarize) Specifies that interactive multiple selection is permitted. (more details...)
M_SELECTED_COLOR +		Sets the color of the selected graphics in interactive mode. INQ (summarize) Sets the color of the selected graphics in interactive mode. INQ (more details...)
	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) Specifies an RGB value when drawing in an 8-bit, 3-band buffer. (more details...)
			Parameters
			Red Specifies the red component, as a value between 0 and 255.
			Green Specifies the green component, as a value between 0 and 255.
			Blue Specifies the blue component, as a value between 0 and 255.
	M_COLOR_BLACK	Specifies the color black.
	M_COLOR_BLUE	Specifies the color blue.
	M_COLOR_BRIGHT_GRAY	Specifies the color bright gray.
	M_COLOR_CYAN	Specifies the color cyan.
	M_COLOR_DARK_BLUE	Specifies the color dark blue.
	M_COLOR_DARK_CYAN	Specifies the color dark cyan.
	M_COLOR_DARK_GREEN	Specifies the color dark green.
	M_COLOR_DARK_MAGENTA	Specifies the color dark magenta.
	M_COLOR_DARK_RED	Specifies the color dark red.
	M_COLOR_DARK_YELLOW	Specifies the color dark yellow.
	M_COLOR_GRAY	Specifies the color gray.
	M_COLOR_GREEN	Specifies the color green.
	M_COLOR_LIGHT_BLUE	Specifies the color light blue.
	M_COLOR_LIGHT_GRAY	Specifies the color light gray.
	M_COLOR_LIGHT_GREEN	Specifies the color light green.
	M_COLOR_LIGHT_WHITE	Specifies the color light white.
	M_COLOR_MAGENTA	Specifies the color magenta.
	M_COLOR_RED	Specifies the color red.
	M_COLOR_WHITE	Specifies the color white.
	M_COLOR_YELLOW	Specifies the color yellow.
	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) Specifies a grayscale value. (more details...)
M_SELECTION_RADIUS		Sets the size of the selection-radius when 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 4 display units radially away from where the user clicked, the graphic will appear selected if the selection-radius is set to a value greater than or equal to 4 display units. INQ (summarize) Sets the size of the selection-radius when in interactive mode. INQ (more details...)
	Value >= 1.0	Specifies the size of the selection-radius, in display units. The default value is 5.0. (summarize) Specifies the size of the selection-radius, in display units. (more details...)

The following ControlType and corresponding ControlValue parameter settings are used to change the settings inherited from the graphics context when a graphic is initially added to the list. The settings apply to 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.

For changing the settings inherited from the graphics context
ControlType		Description
	ControlValue	Description
M_COLOR +		Sets the foreground color of the graphic. INQ (summarize) Sets the foreground color of the graphic. INQ (more details...)
	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) Specifies an RGB value when drawing in an 8-bit, 3-band buffer. (more details...)
			Parameters
			Red Specifies the red component, as a value between 0 and 255.
			Green Specifies the green component, as a value between 0 and 255.
			Blue Specifies the blue component, as a value between 0 and 255.
	M_COLOR_BLACK	Specifies the color black.
	M_COLOR_BLUE	Specifies the color blue.
	M_COLOR_BRIGHT_GRAY	Specifies the color bright gray.
	M_COLOR_CYAN	Specifies the color cyan.
	M_COLOR_DARK_BLUE	Specifies the color dark blue.
	M_COLOR_DARK_CYAN	Specifies the color dark cyan.
	M_COLOR_DARK_GREEN	Specifies the color dark green.
	M_COLOR_DARK_MAGENTA	Specifies the color dark magenta.
	M_COLOR_DARK_RED	Specifies the color dark red.
	M_COLOR_DARK_YELLOW	Specifies the color dark yellow.
	M_COLOR_GRAY	Specifies the color gray.
	M_COLOR_GREEN	Specifies the color green.
	M_COLOR_LIGHT_BLUE	Specifies the color light blue.
	M_COLOR_LIGHT_GRAY	Specifies the color light gray.
	M_COLOR_LIGHT_GREEN	Specifies the color light green.
	M_COLOR_LIGHT_WHITE	Specifies the color light white.
	M_COLOR_MAGENTA	Specifies the color magenta.
	M_COLOR_RED	Specifies the color red.
	M_COLOR_WHITE	Specifies the color white.
	M_COLOR_YELLOW	Specifies the color yellow.
	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) Specifies a grayscale value. (more details...)
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) Sets the offset to subtract from the source X-coordinates before rendering the graphic. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0 pixels.
	Value	Specifies the X-coordinate offset to subtract, in pixels.
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) Sets the offset to subtract from the source Y-coordinates before rendering the graphic. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0 pixels.
	Value	Specifies the Y-coordinate offset to subtract, in pixels.
M_DRAW_ZOOM_X		Sets the scale factor in the X-direction. This value is useful to zoom drawings of results. INQ (summarize) Sets the scale factor in the X-direction. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.0.
	Value > 0	Specifies the scale factor in the X-direction.
M_DRAW_ZOOM_Y		Sets the scale factor in the Y-direction. This value is useful to zoom drawings of results. INQ (summarize) Sets the scale factor in the Y-direction. INQ (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.0.
	Value > 0	Specifies the scale factor in the Y-direction.
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) 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). INQ (more details...)
	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) Specifies that the camera calibration information of the destination is used when rendering the graphic. (more details...)
	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) Specifies that the camera calibration information of the graphic, set with M_GRAPHIC_SOURCE_CALIBRATION, is used when rendering the graphic. (more details...)
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) Sets how the shape of a graphic, defined in world units, is converted to pixels (rendered). INQ (more details...)
	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) Specifies to render the graphic so that its shape is preserved even if it means not respecting the camera calibration information exactly. (more details...)
	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) Specifies that all points along the contour of the graphic will be converted using the camera calibration information, following any non-linear distortion. (more details...)
	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) 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. (more details...)
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) 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. INQ (more details...)
	M_NULL	Specifies that no source camera calibration information is available to interpret positioning and dimensioning information of a graphic defined in world units.
	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 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) Specifies the identifier of a camera calibration context, image buffer or processing or analysis module result buffer, whose camera calibration information to use. (more details...)
M_INPUT_UNITS		Sets the units with which to interpret the graphic's position and dimensional information, for graphics already added to the graphics list. This essentially sets the input coordinate system to use. INQ (summarize) Sets the units with which to interpret the graphic's position and dimensional information, for graphics already added to the graphics list. INQ (more details...)
	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 graphics list is used to annotate the display non-destructively, using MdispControl() with M_ASSOCIATED_GRAPHIC_LIST_ID. (summarize) Specifies to interpret the values in pixel units that, unlike M_PIXEL, are not altered when the display is panned or zoomed. (more details...)
	M_PIXEL	Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. If the 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) Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. (more details...)
	M_WORLD	Specifies to interpret the values in world units, with respect to the relative coordinate system. If the 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 graphics list is associated with the display, nothing will be drawn. (summarize) Specifies to interpret the values in world units, with respect to the relative coordinate system. (more details...)

The following ControlType and corresponding ControlValue parameter settings are used to change settings inherited from the graphics context that affect the interactivity of a graphic, drawn in a 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.

For changing the interactive properties of graphics in the list
ControlType		Description
	ControlValue	Description
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) Sets whether a graphic can be edited via user interaction in an interactive display. INQ (more details...)
	M_DISABLE	Specifies that the graphic cannot be edited via user interaction. Note that the graphic can still be modified using MgraControlList(). (summarize) Specifies that the graphic cannot be edited via user interaction. (more details...)
	M_ENABLE	Specifies that the graphic can be edited via user interaction.
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) Sets whether a graphic is selected. INQ (more details...)
	M_FALSE	Specifies that the graphic is not selected.
	M_TRUE	Specifies that the graphic is selected.
M_MOVABLE		Sets whether a graphic can be 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) Sets whether a graphic can be moved via user interaction in an interactive display. INQ (more details...)
	M_DISABLE	Specifies that the graphic cannot be moved via user interaction. Note that the graphic can still be moved using MgraControlList(). (summarize) Specifies that the graphic cannot be moved via user interaction. (more details...)
	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.
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) Sets whether a graphic can be resized via user interaction in an interactive display. INQ (more details...)
	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) Specifies that the graphic cannot be resized via user interaction and the resize handles will not be displayed if a graphic is selected. (more details...)
	M_ENABLE	Specifies that the graphic can be resized via user interaction by clicking and dragging one of the resize handle.
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) Sets whether a graphic can be rotated via user interaction in an interactive display. INQ (more details...)
	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) Specifies that the graphic cannot be rotated via user interaction and the rotate handle will not be displayed if a graphic is selected. (more details...)
	M_ENABLE	Specifies that the graphic can be rotated via user interaction by clicking and dragging the rotation handle.
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) Sets whether a graphic can be selected via user interaction in an interactive display. INQ (more details...)
	M_DISABLE	Specifies that the graphic cannot be selected via user interaction. Note that the graphic can still be selected using MgraControlList(). (summarize) Specifies that the graphic cannot be selected via user interaction. (more details...)
	M_ENABLE	Specifies that the graphic can be selected by clicking on it.
M_SPECIFIC_FEATURES_EDITABLE		Sets whether a graphic can be modified via user interaction in an interactive display using handles that are specific to its graphic type. 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) Sets whether a graphic can be modified via user interaction in an interactive display using handles that are specific to its graphic type. INQ (more details...)
	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) Specifies that the graphic cannot be modified via user interaction and its specific feature handles will not be displayed if a graphic is selected. (more details...)
	M_ENABLE	Specifies that the graphic can be modified via user interaction by clicking and dragging one of the type-specific handles.
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) Sets whether a graphic is rendered on the display. INQ (more details...)
	M_FALSE	Specifies that the graphic is not rendered.
	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 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 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.

For changing the settings of text

ControlType

Description

ControlValue

M_BACKCOLOR +

Sets the background color of the text. INQ

(summarize)

Sets the background color of the text. INQ

(more details...)

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)

Specifies an RGB value when drawing in an 8-bit, 3-band buffer.

(more details...)

Parameters

Red

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

Green

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

Blue

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

M_COLOR_BLACK

Specifies the color black.

M_COLOR_BLUE

Specifies the color blue.

M_COLOR_BRIGHT_GRAY

Specifies the color bright gray.

M_COLOR_CYAN

Specifies the color cyan.

M_COLOR_DARK_BLUE

Specifies the color dark blue.

M_COLOR_DARK_CYAN

Specifies the color dark cyan.

M_COLOR_DARK_GREEN

Specifies the color dark green.

M_COLOR_DARK_MAGENTA

Specifies the color dark magenta.

M_COLOR_DARK_RED

Specifies the color dark red.

M_COLOR_DARK_YELLOW

Specifies the color dark yellow.

M_COLOR_GRAY

Specifies the color gray.

M_COLOR_GREEN

Specifies the color green.

M_COLOR_LIGHT_BLUE

Specifies the color light blue.

M_COLOR_LIGHT_GRAY

Specifies the color light gray.

M_COLOR_LIGHT_GREEN

Specifies the color light green.

M_COLOR_LIGHT_WHITE

Specifies the color light white.

M_COLOR_MAGENTA

Specifies the color magenta.

M_COLOR_RED

Specifies the color red.

M_COLOR_WHITE

Specifies the color white.

M_COLOR_YELLOW

Specifies the color yellow.

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)

Specifies a grayscale value.

(more details...)

M_BACKGROUND_MODE

Sets whether to fill the text's background. INQ

(summarize)

Sets whether to fill the text's background. INQ

(more details...)

M_OPAQUE

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

M_TRANSPARENT

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

(summarize)

Specifies not to change the background before drawing text.

(more details...)

M_FONT

Sets the font of the characters in text. INQ

(summarize)

Sets the font of the characters in text. INQ

(more details...)

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)

Specifies the font.

(more details...)

Parameters

Font

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") ¹

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") ¹

Specifies a full path to a TrueType file name.

M_FONT_DEFAULT

Same as M_FONT_DEFAULT_SMALL.

M_FONT_DEFAULT_LARGE

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

M_FONT_DEFAULT_MEDIUM

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

M_FONT_DEFAULT_SMALL

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

M_FONT_AUTO_SELECT

Sets whether MIL should search for a suitable font to draw 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)

Sets whether MIL should search for a suitable font to draw text if the currently selected font (M_FONT) is a TrueType font that does not support the character code. INQ

(more details...)

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)

Specifies that MIL will not search for a suitable font.

(more details...)

M_ENABLE

Specifies that MIL will search for a suitable font.

M_FONT_SIZE

Sets the size to draw text 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)

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

(more details...)

Value >= 1

Specifies the text's font size, in points.

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)

Sets the font's horizontal scaling factor. INQ

(more details...)

Value > 0

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

(summarize)

Specifies the factor by which to multiply the width of the font characters.

(more details...)

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)

Sets the font's vertical scaling factor. INQ

(more details...)

Value > 0

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

(summarize)

Specifies the factor by which to multiply the height of the font characters.

(more details...)

M_TEXT_ALIGN_HORIZONTAL

Sets the horizontal alignment of 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)

Sets the horizontal alignment of text. INQ

(more details...)

M_CENTER

Specifies that text is horizontally centered.

M_LEFT

Specifies that text is left-aligned.

M_RIGHT

Specifies that text is right-aligned.

M_TEXT_ALIGN_VERTICAL

Sets the vertical alignment of 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)

Sets the vertical alignment of text. INQ

(more details...)

M_BOTTOM

Specifies that text is bottom-aligned.

M_CENTER

Specifies that text is vertically centered.

M_TOP

Specifies that text is top-aligned.

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)

Sets borders around the text. INQ

(more details...)

M_BOTTOM

Specifies that a line is drawn underneath the text.

M_LEFT

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

M_NONE

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

(summarize)

Specifies that no border is drawn around the text.

(more details...)

M_RIGHT

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

M_TOP

Specifies that a line is drawn above the text.

M_TEXT_DIRECTION

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

(summarize)

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

(more details...)

M_LEFT_TO_RIGHT

Specifies that text will be drawn from left to right.

M_RIGHT_TO_LEFT

Specifies that text will be drawn from right to left.

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

Combination values for M_BACKCOLOR; M_COLOR; M_INTERACTIVE_ANNOTATIONS_COLOR; M_SELECTED_COLOR.

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

For specifying the color component (for 16- or 32-bit multi-band buffers)
Combination value	Description
M_BLUE	Specifies the blue color component.
M_GREEN	Specifies the green color component.
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.

For changing the position and dimensional information of a graphic
ControlType		Description
	ControlValue	Description
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) Sets the angle of the graphic. INQ (more details...)
	-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 27: Calibrating your camera setup. (summarize) Specifies the angle, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS. (more details...)
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) Sets the angle at which to stop drawing the arc. INQ (more details...)
	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 27: Calibrating your camera setup. (summarize) Specifies the end angle, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS. (more details...)
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) Sets the angle at which to start drawing the arc. INQ (more details...)
	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 27: Calibrating your camera setup. (summarize) Specifies the start angle, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS. (more details...)
M_ARC_STYLE		Sets whether to draw an arc or a sector. This setting only applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()). INQ (summarize) Sets whether to draw an arc or a sector. INQ (more details...)
	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.
	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.
M_CONSTRAIN_ASPECT_RATIO		Sets whether to force the width and height of a graphic to be equal. This control type affects both interactive and programmatic manipulations. This setting applies to arcs (MgraArc(), MgraArcFill(), and MgraArcAngle()) and rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ (summarize) Sets whether to force the width and height of a graphic to be equal. INQ (more details...)
	M_DISABLE	Specifies that the width and height of a graphic are not forced to be equal.
	1.0	Specifies that the width and height of a graphic are forced to be equal. 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 is met. (summarize) Specifies that the width and height of a graphic are forced to be equal. (more details...)
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) Sets whether to fill the graphic. INQ (more details...)
	M_FALSE	Specifies that the graphic is not filled.
	M_TRUE	Specifies that the graphic is filled.
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) Sets how to interpret M_POSITION_X and M_POSITION_Y for a rectangle. INQ (more details...)
	M_CENTER_AND_DIMENSION	Specifies to interpret M_POSITION_X and M_POSITION_Y as the rectangle's center.
	M_CORNER_AND_DIMENSION	Specifies to interpret M_POSITION_X and M_POSITION_Y as the rectangle's top-left corner.
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) Sets the X-position of a graphic or of one of its sub-elements (position-points). INQ (more details...)
	Value	Specifies the X-position. You can specify any positive or negative value. (summarize) Specifies the X-position. (more details...)
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) Sets the Y-position of a graphic or of one of its sub-elements (position-points). INQ (more details...)
	Value	Specifies the Y-position. You can specify any positive or negative value. (summarize) Specifies the Y-position. (more details...)
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) Sets the radius of the arc, in the X-direction. INQ (more details...)
	Value >= 0	Specifies the radius.
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) Sets the radius of the arc, in the Y-direction. INQ (more details...)
	Value >= 0	Specifies the radius.
M_RECTANGLE_HEIGHT		Sets the height of the rectangle. This setting only applies to rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ (summarize) Sets the height of the rectangle. INQ (more details...)
	Value	Specifies the height.
M_RECTANGLE_WIDTH		Sets the width of the rectangle. This setting only applies to rectangles (MgraRect(), MgraRectFill(), and MgraRectAngle()). INQ (summarize) Sets the width of the rectangle. INQ (more details...)
	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 specfied 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.

For performing geometric operations on graphics
ControlType		Description
	ControlValue	Description
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) Performs a uniform scaling operation on the graphic. (more details...)
	Value > 0.0	Specifies the scale factor.
M_ROTATE		Performs a rotation operation on the graphic. 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) Performs a rotation operation on the graphic. (more details...)
	-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 27: Calibrating your camera setup. (summarize) Specifies the angle of rotation, in degrees, relative to the input coordinate system specified using M_INPUT_UNITS. (more details...)
M_TRANSLATE_X		Performs a horizontal translation of a graphic, or 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) Performs a horizontal translation of a graphic, or one of its sub-elements. (more details...)
	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) Specifies the horizontal displacement. (more details...)
M_TRANSLATE_Y		Performs a vertical translation of a graphic, or 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) Performs a vertical translation of a graphic, or one of its sub-elements. (more details...)
	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) Specifies the vertical displacement. (more details...)

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

For deleting graphics (one or all) from the list
ControlType		Description
	ControlValue	Description
M_DELETE		Deletes the graphic (one or all), as specified by the LabelOrIndex parameter setting. When a graphic is deleted, the indices of the graphics list are reassigned; that is, index values greater than that of the removed graphic are reduced by one. (summarize) Deletes the graphic (one or all), as specified by the LabelOrIndex parameter setting. (more details...)
	M_DEFAULT	Implements the default behavior.

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)

Details

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)

Details

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.