MgraInquire

See also

Reference:

MdispControl MgraAlloc MgraBackColor MgraColor MgraControl MgraControlList MgraFont MgraFontScale MgraInquireList MgraText MsysInquire

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox Indio (Update 53 or Update 68) (w)

Not supported on Matrox Concord PoE with ToE (Update 82) (z)

Fully supported on:

Fully supported on Host system (a)

Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Fully supported on Matrox Morphis (g)

Fully supported on Matrox Morphis QxT (h)

Fully supported on Matrox Orion HD (i)

Fully supported on Matrox Radient eCL (j)

Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Fully supported on Matrox Solios eA/XA (l)

Fully supported on Matrox Solios ecl/xcl/ev-cl (m)

Fully supported on Matrox USB3 Vision driver (Update 19) (o)

Fully supported on Matrox RadientPro-CL (Update 7) (p)

Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)

Fully supported on Matrox GenTL driver (Update 34) (v)

Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

milapplication.cs
milapplication.vb
mmoddefinemodelatangle.cpp
mpatdefinemodelatangle.cpp
mpatfindmultiplemodels.cpp
publishingapplication.cpp
publishingapplication.cs
regionmanager.cpp

Function Map

Table:

For specifying the 2D graphics context

- InquireType

- UserVarPtr

Parameter Associations

Table:	For inquiring about general 2D graphics context settings
Table:	For inquiring about a setting related to interactivity
Table:	For inquiring about a setting specific to text
+ combination:	For inquiring the color value used (for 16- or 32-bit multi-band buffers)
+ combination:	For specifying the data type

Return value

Compilation information

Synopsis

Inquire information about a 2D graphics context.

Syntax

MIL_INT MgraInquire(

MIL_ID ContextGraId,	//in
MIL_INT64 InquireType,	//in
void *UserVarPtr	//out

)

Description

This function inquires information about a specified 2D graphics context. To inquire about a 2D graphics list, use MgraInquireList().

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

ContextGraId

Specifies the identifier of the 2D graphics context about which to inquire information. This parameter must be set to one of the following values:

For specifying the 2D graphics context
Value	Description
M_DEFAULT	Specifies that the default 2D graphics context of the current MIL application is used. Note that there is a different default 2D graphics context for each thread. (summarize) Specifies that the default 2D graphics context of the current MIL application is used. (more details...)
MIL 2D graphics context identifier	Specifies a valid 2D graphics context identifier, which you have allocated using MgraAlloc().

InquireType

Specifies the 2D graphics context setting to inquire.

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

UserVarPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

MIL_DOUBLE
MIL_ID
MIL_INT
MIL_INT32
MIL_INT64

Specifies the address in which to write the requested information. Since the MgraInquire() function also returns the requested information, you can set this parameter to M_NULL.

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

Parameter associations

The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For inquiring about general 2D graphics context settings
For inquiring about a setting related to interactivity
For inquiring about a setting specific to text

To inquire general 2D graphics context settings, the InquireType parameter should be set to one of the following values. Unless otherwise specified, these affect all types of graphics.

For inquiring about general 2D graphics context settings
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_COLOR +		Inquires the foreground color. SET SET (summarize) Inquires the foreground color. SET SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	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.
	Byte-encoded RGB value	Specifies an encoded RGB value. To verify if the value is a byte-encoded RGB value, use the M_IS_RGB888 macro. To retrieve the R, G, and B components, use the M_RGB888_R, M_RGB888_G, and M_RGB888_B macros. (summarize) Specifies an encoded RGB value. (more details...)
	Value	Specifies a grayscale value. INFO
M_DRAW_DIRECTION +		Inquires how to draw (render) an arrow pointing in the direction with which a graphic was defined. SET (summarize) Inquires how to draw (render) an arrow pointing in the direction with which a graphic was defined. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_NONE	Specifies that no direction is drawn.
	M_PRIMARY_DIRECTION	Specifies to draw an arrow showing the primary direction of the graphic. INFO
	M_PRIMARY_DIRECTION + M_SECONDARY_DIRECTION	Specifies to draw an arrow showing both the primary and secondary direction of the graphic.
	M_SECONDARY_DIRECTION	Specifies to draw an arrow showing the secondary direction of the graphic. INFO
M_DRAW_OFFSET_X +		Inquires the offset subtracted from the source X-coordinates. SET (summarize) Inquires the offset subtracted from the source X-coordinates. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	Value	Specifies the X-coordinate offset to subtract, in pixels.
M_DRAW_OFFSET_Y +		Inquires the offset subtracted from the source Y-coordinates. SET (summarize) Inquires the offset subtracted from the source Y-coordinates. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-coordinate offset to subtract, in pixels.
M_DRAW_ZOOM_X +		Inquires the scale factor in the X-direction. SET (summarize) Inquires the scale factor in the X-direction. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	Value > 0	Specifies the scale factor in the X-direction.
M_DRAW_ZOOM_Y +		Inquires the scale factor in the Y-direction. SET (summarize) Inquires the scale factor in the Y-direction. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	Value > 0	Specifies the scale factor in the Y-direction.
M_FIXTURE +		Inquires the camera calibration information used when rendering (drawing or displaying) a graphic defined in world units, when both source camera calibration information and destination camera calibration information are available to interpret positioning and dimensioning information. 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. SET (summarize) Inquires the camera calibration information used when rendering (drawing or displaying) a graphic defined in world units, when both source camera calibration information and destination camera calibration information are available to interpret positioning and dimensioning information. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_USE_DESTINATION_FIRST	Specifies that the camera calibration information of the destination is used when rendering the graphic. INFO
	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. INFO
M_GRAPHIC_CONVERSION_MODE +		Inquires how the shape of a graphic, defined in world units, is converted to pixels (rendered). SET (summarize) Inquires how the shape of a graphic, defined in world units, is converted to pixels (rendered). SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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. INFO
	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. INFO
	M_RESHAPE_FROM_POINTS	Specifies that only a few key points or features will be converted using the camera calibration information; from these converted points, the rest of the graphic will be rendered respecting the shape of the graphic. INFO
M_GRAPHIC_SOURCE_CALIBRATION +		Inquires the identifier of the camera calibration information used to interpret positioning and dimensioning information of a graphic defined in world units. SET (summarize) Inquires the identifier of the camera calibration information used to interpret positioning and dimensioning information of a graphic defined in world units. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID
	M_NULL	Specifies that no source camera calibration information is available to interpret positioning and dimensioning information of a graphic defined in world units, except when the graphic is drawn using the draw function (M...Draw()) of a processing or analysis module; in this case, the camera calibration information of the drawn setting or result will be used.
	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; this object is only associated with the 2D graphics context, not copied. INFO
M_INPUT_UNITS +		Inquires the units with which to interpret the graphic's positional and dimensional information. SET (summarize) Inquires the units with which to interpret the graphic's positional and dimensional information. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_DISPLAY	Specifies to interpret the values in pixel units that, unlike M_PIXEL, are not altered when the display is panned or zoomed. INFO
	M_PIXEL	Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. INFO
	M_WORLD	Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO
M_OWNER_SYSTEM +		Inquires the MIL identifier (MIL_ID) of the system on which the 2D graphics context has been allocated. SET (summarize) Inquires the MIL identifier (MIL_ID) of the system on which the 2D graphics context has been allocated. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID
	M_DEFAULT_HOST	Specifies the default Host system of the current MIL application.
	MIL system identifier	Specifies a valid system identifier, previously allocated using MsysAlloc().
M_OWNER_SYSTEM_TYPE +		Inquires the type of system on which the 2D graphics context was allocated. SET (summarize) Inquires the type of system on which the 2D graphics context was allocated. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_SYSTEM_CLARITY_UHD_TYPE	Specifies a MIL Clarity UHD system.
	M_SYSTEM_GENTL_TYPE	Specifies a MIL GenTL system.
	M_SYSTEM_GIGE_VISION_TYPE	Specifies a MIL GigE Vision system.
	M_SYSTEM_HOST_TYPE	Specifies the Host.
	M_SYSTEM_IRIS_GTR_TYPE	Specifies a MIL Iris GTR system.
	M_SYSTEM_MORPHIS_TYPE	Specifies a MIL Morphis system.
	M_SYSTEM_MORPHISQXT_TYPE	Specifies a MIL Morphis QxT system.
	M_SYSTEM_ORION_HD_TYPE	Specifies a MIL Orion HD system.
	M_SYSTEM_RADIENT_TYPE	Specifies a MIL Radient system.
	M_SYSTEM_RADIENTCXP_TYPE	Specifies a MIL Radient eV-CXP system.
	M_SYSTEM_RADIENTEVCL_TYPE	Specifies a MIL Radient eV-CL system.
	M_SYSTEM_RADIENTPRO_TYPE	Specifies a MIL Radient Pro system.
	M_SYSTEM_RAPIXOCL_TYPE	Specifies a MIL Rapixo Pro CL system.
	M_SYSTEM_RAPIXOCXP_TYPE	Specifies a MIL Rapixo CXP system.
	M_SYSTEM_SOLIOS_TYPE	Specifies a MIL Solios system.
	M_SYSTEM_USB3_VISION_TYPE	Specifies a MIL USB3 Vision system.

To inquire 2D graphics context settings 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), the InquireType parameter should be set to one of the following values.

For inquiring about a setting related to interactivity
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_EDITABLE +		Inquires 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. SET (summarize) Inquires whether a graphic can be edited via user interaction in an interactive display. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_DISABLE	Specifies that the graphic cannot be edited via user interaction. INFO
	M_ENABLE	Specifies that the graphic can be edited via user interaction.
M_RESIZABLE +		Inquires 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 this setting is ignored. SET (summarize) Inquires whether a graphic can be resized via user interaction in an interactive display. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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. INFO
	M_ENABLE	Specifies that the graphic can be resized via user interaction by clicking and dragging one of the resize handles.
M_ROTATABLE +		Inquires 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 this setting is ignored. SET (summarize) Inquires whether a graphic can be rotated via user interaction in an interactive display. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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. INFO
	M_ENABLE	Specifies that the graphic can be rotated via user interaction by clicking and dragging the rotation handle.
M_SELECTABLE +		Inquires whether a graphic in a 2D graphics list 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. SET (summarize) Inquires whether a graphic in a 2D graphics list can be selected via user interaction in an interactive display. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_DISABLE	Specifies that the graphic cannot be selected via user interaction. INFO
	M_ENABLE	Specifies that the graphic can be selected by clicking on it.
M_SPECIFIC_FEATURES_EDITABLE +		Inquires 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 its type-specific handles and this setting is ignored. SET (summarize) Inquires whether a graphic can be modified via user interaction in an interactive display using handles that are specific to its graphic type. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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. INFO
	M_ENABLE	Specifies that the graphic can be modified via user interaction by clicking and dragging one of the specific feature handles.
M_TRANSLATABLE +		Inquires whether a graphic can be moved (translated) via user interaction in an interactive display. If a graphic is not visible, not selectable, or not editable, it is not movable and this setting is ignored. SET (summarize) Inquires whether a graphic can be moved (translated) via user interaction in an interactive display. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_DISABLE	Specifies that the graphic cannot be moved via user interaction. INFO
	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_VISIBLE +		Inquires whether a graphic is rendered on the display. SET (summarize) Inquires whether a graphic is rendered on the display. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_FALSE	Specifies that the graphic is not rendered.
	M_TRUE	Specifies that the graphic is rendered.

To inquire 2D graphics context settings that apply only to text (MgraText()), the InquireType parameter should be set to one of the following values.

For inquiring about a setting specific to text
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_BACKCOLOR +		Inquires the background color. SET SET (summarize) Inquires the background color. SET SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	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.
	Byte-encoded RGB value	Specifies an encoded RGB value. To verify if the value is a byte-encoded RGB value, use the M_IS_RGB888 macro. To retrieve the R, G, and B components, use the M_RGB888_R, M_RGB888_G, and M_RGB888_B macros. (summarize) Specifies an encoded RGB value. (more details...)
	Value	Specifies a grayscale value. INFO
M_BACKGROUND_MODE +		Inquires whether the text's background is filled. SET (summarize) Inquires whether the text's background is filled. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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. INFO
M_FONT +		Inquires the character font. SET (summarize) Inquires the character font. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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_TTF	Specifies a TrueType font. This value is returned when using MgraFont() with MIL_FONT_NAME(). (summarize) Specifies a TrueType font. (more details...)
M_FONT_AUTO_SELECT +		Inquires whether MIL will search for a suitable font to draw text if the currently selected font is a TrueType font that does not support the character code. SET (summarize) Inquires whether MIL will search for a suitable font to draw text if the currently selected font is a TrueType font that does not support the character code. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	M_DISABLE	Specifies that MIL will not search for a suitable font. INFO
	M_ENABLE	Specifies that MIL will search for a suitable font.
M_FONT_SIZE +		Inquires the size text is drawn when using a TrueType font. SET (summarize) Inquires the size text is drawn when using a TrueType font. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	Value >= 1	Specifies the text's font size, in points.
M_FONT_X_SCALE +		Inquires the font's horizontal scaling factor. SET SET (summarize) Inquires the font's horizontal scaling factor. SET SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	Value > 0	Specifies the factor by which to multiply the width of the font's characters. INFO
M_FONT_Y_SCALE +		Inquires the font's vertical scaling factor. SET SET (summarize) Inquires the font's vertical scaling factor. SET SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
	Value > 0	Specifies the factor by which to multiply the height of the font's characters. INFO
M_TEXT_ALIGN_HORIZONTAL +		Inquires the horizontal alignment of text. SET (summarize) Inquires the horizontal alignment of text. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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 +		Inquires the vertical alignment of text. SET (summarize) Inquires the vertical alignment of text. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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 +		Inquires how borders are drawn around the text. Note that a combination of the values below can be returned. Bitwise operators must be used to verify the presence of a specific border. SET (summarize) Inquires how borders are drawn around the text. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT MORE Data type: address of a MIL_INT Bitwise return value; values listed below can be established using bitwise operators. Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT MORE Data type: address of a MIL_INT Bitwise return value; values listed below can be established using bitwise operators. Data type: address of a MIL_INT
	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. INFO
	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 +		Inquires the direction text is drawn when using a TrueType font. SET (summarize) Inquires the direction text is drawn when using a TrueType font. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
	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.

Combination values for M_BACKCOLOR; M_COLOR.

You can add one of the following values to the above-mentioned values to get the color used in the 2D graphics context for a 16-bit or 32-bit multi-band buffer.

You must inquire each color component (R,G, and B) separately.

For inquiring the color value used (for 16- or 32-bit multi-band buffers)
Combination value	Description
M_BLUE	Inquires the blue color component.
M_GREEN	Inquires the green color component.
M_RED	Inquires the red color component.

Combination values for

Tables:

For inquiring about general 2D graphics context settings
For inquiring about a setting related to interactivity
For inquiring about a setting specific to text

the values listed in all the parameter association tables.

You can add one of the following values to the above-mentioned values to cast the requested information to a required data type.

For specifying the data type
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_TYPE_MIL_DOUBLE		Casts the requested information to a MIL_DOUBLE. (summarize) Casts the requested information to a MIL_DOUBLE. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE Data type: address of a MIL_DOUBLE
M_TYPE_MIL_ID		Casts the requested information to a MIL_ID. Note that M_TYPE_MIL_ID should only be used with M_OWNER_SYSTEM and M_GRAPHIC_SOURCE_CALIBRATION. (summarize) Casts the requested information to a MIL_ID. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID Data type: address of a MIL_ID
M_TYPE_MIL_INT		Casts the requested information to a MIL_INT. (summarize) Casts the requested information to a MIL_INT. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT Data type: address of a MIL_INT
M_TYPE_MIL_INT32		Casts the requested information to a MIL_INT32. (summarize) Casts the requested information to a MIL_INT32. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT32 Data type: address of a MIL_INT32 Data type info: Data type: address of a MIL_INT32 Data type: address of a MIL_INT32
M_TYPE_MIL_INT64		Casts the requested information to a MIL_INT64. (summarize) Casts the requested information to a MIL_INT64. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT64 Data type: address of a MIL_INT64 Data type info: Data type: address of a MIL_INT64 Data type: address of a MIL_INT64

Return value

The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.

Compilation information

Header	Include mil.h.
Library	Use mil.lib.
DLL	Requires mil.dll.