McalInquire

Filters
See also

Availability

Not 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

Function Map

Parameter Associations

Table:	For a camera calibration context
Table:	For a camera calibration context calibrated using McalGrid()
+ combination:	For getting the string size
Table:	For a camera calibration context calibrated using McalGrid() or McalList()
Table:	For a camera calibration context calibrated using McalGrid(), McalList(), or McalUniform()
Table:	For a 3D-based camera calibration context
Table:	For any image, digitizer, or result buffer
Table:	For a camera calibration context, image, or result buffer
Table:	For a calibrated image or result buffer
Table:	For a calibrated image or result buffer, with a constant pixel size
+ combination:	For inquiring the default value
Table:	For a fixturing offset object
+ combination:	For specifying the data type

Return value

Compilation information

Synopsis

Inquire about a camera calibration context, a calibrated image, a calibrated result buffer, a fixturing offset object, or about the camera calibration state of an image, digitizer, or result buffer.

Syntax

MIL_INT McalInquire(

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

)

Description

This function inquires about a setting of a camera calibration context, a calibrated image, a calibrated result buffer, or a fixturing offset object. It can also be used to determine if a camera calibration context is associated with an image, digitizer, or result buffer, and whether or not an image has been corrected.

When working in M_3D_ROBOTICS camera calibration mode, the function returns information about the last camera calibration performed on that object. To inquire about previous camera calibration poses within the M_3D_ROBOTICS camera calibration context, you can use McalInquireSingle() with the Index parameter set to the required camera calibration pose.

If the inquired setting is set to M_DEFAULT (for example, using McalControl()), McalInquire() will return M_DEFAULT. To inquire the actual default value, add M_DEFAULT to the InquireType parameter.

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

CalibrationOrMilId

Specifies the identifier of the camera calibration context, image buffer, result buffer, digitizer, or fixturing offset object.

InquireType

Specifies the setting about which to inquire. The setting for InquireType depends on whether you are inquiring about a camera calibration context, image, result buffer, or digitizer.

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):

array of type MIL_DOUBLE
array of type MIL_TEXT_CHAR
char
MIL_DOUBLE
MIL_FLOAT
MIL_ID
MIL_INT
MIL_INT16
MIL_INT32
MIL_INT64

Specifies the address in which to return the value of the inquired setting. Since the McalInquire() 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 a camera calibration context
For a camera calibration context calibrated using McalGrid()
For a camera calibration context calibrated using McalGrid() or McalList()
For a camera calibration context calibrated using McalGrid(), McalList(), or McalUniform()
For a 3D-based camera calibration context
For any image, digitizer, or result buffer
For a camera calibration context, image, or result buffer
For a calibrated image or result buffer
For a calibrated image or result buffer, with a constant pixel size
For a fixturing offset object

For a camera calibration context, InquireType can be set to one of the following.

For a camera calibration context
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_CALIBRATION_INPUT_DATA +		Specifies the type of data that was used to perform the camera calibration. (summarize) Specifies the type of data that was used to perform the camera calibration. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_NULL	Specifies that no camera calibration was performed on the camera calibration context.
	M_GRID	Specifies that the camera calibration was performed using a camera calibration grid (McalGrid()).
	M_LIST	Specifies that the camera calibration was performed by explicitly specifying the correspondence between some pixels and their real-world coordinates (McalList()).
	M_PARAMETRIC	Specifies that the camera calibration was performed using an explicitly specified translation, scale, and offset from the absolute world coordinate system (McalUniform()).
M_CALIBRATION_PLANE +		Inquires the plane in which the calibration points are defined. SET (summarize) Inquires the plane in which the calibration points are defined. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Same as M_ABSOLUTE_COORDINATE_SYSTEM.
	M_ABSOLUTE_COORDINATE_SYSTEM	Specifies that the calibration points are defined in the absolute coordinate system.
	M_RELATIVE_COORDINATE_SYSTEM	Specifies that the calibration points are defined in the relative coordinate system.
M_CALIBRATION_STATUS +		Inquires the status of a camera calibration. (summarize) Inquires the status of a camera calibration. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_CALIBRATED	Specifies that the camera calibration was successful.
	M_CALIBRATING	Specifies that the last call to McalGrid() / McalList() was made with M_ACCUMULATE and the camera calibration was successful.
	M_GRID_NOT_FOUND	Specifies that McalGrid() was unable to find an appropriate camera calibration grid in the provided image.
	M_INVALID_CALIBRATION_POINTS	Specifies that the provided calibration points do not contain sufficient spatial information to perform a camera calibration.
	M_MATHEMATICAL_EXCEPTION	Specifies that the calculation of the camera's parameters has failed.
	M_NOT_INITIALIZED	Specifies that no camera calibration has been performed yet.
	M_PLANE_ANGLE_TOO_SMALL	Specifies that the camera's optical axis is not sufficiently inclined. For full M_TSAI_BASED camera calibration, the camera's optical axis should be placed at least at a 30-degrees angle away from the axis perpendicular to the camera calibration plane. (summarize) Specifies that the camera's optical axis is not sufficiently inclined. (more details...)
	M_TOO_MANY_OUTLIERS	Specifies that the calculation performed by McalGrid() or McalList() with M_DISPLACE_CAMERA_COORD or M_DISPLACE_RELATIVE_COORD has failed. There were too many possible outliers to correctly compute the new location of the coordinate system. (summarize) Specifies that the calculation performed by McalGrid() or McalList() with M_DISPLACE_CAMERA_COORD or M_DISPLACE_RELATIVE_COORD has failed. (more details...)
M_LINK_TOOL_AND_CAMERA +		Inquires whether a rigid link exists between the camera coordinate system and the tool coordinate system. SET (summarize) Inquires whether a rigid link exists between the camera coordinate system and the tool coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Same as M_ENABLE.
	M_DISABLE	Specifies to remove the link between the two coordinate systems, allowing both to be moved independently.
	M_ENABLE	Specifies to link the two coordinate systems, allowing both to be moved together.
M_LOCALIZATION_NB_ITERATIONS_MAX +		Inquires the maximum number of iterations to attempt to fit the provided points when calculating the new position of the camera or relative coordinate system, when using McalList() and McalGrid() with M_DISPLACE_CAMERA_COORD or M_DISPLACE_RELATIVE_COORD respectively. SET (summarize) Inquires the maximum number of iterations to attempt to fit the provided points when calculating the new position of the camera or relative coordinate system, when using McalList() and McalGrid() with M_DISPLACE_CAMERA_COORD or M_DISPLACE_RELATIVE_COORD respectively. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 250.
M_LOCALIZATION_NB_OUTLIERS_MAX +		Inquires the maximum number of possible outliers that can occur in the data set used by McalList() or McalGrid() with M_DISPLACE_CAMERA_COORD or M_DISPLACE_RELATIVE_COORD. SET (summarize) Inquires the maximum number of possible outliers that can occur in the data set used by McalList() or McalGrid() with M_DISPLACE_CAMERA_COORD or M_DISPLACE_RELATIVE_COORD. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 0.
M_OWNER_SYSTEM +		Inquires the identifier of the system on which the camera calibration context has been allocated. SET (summarize) Inquires the identifier of the system on which the camera calibration context has been allocated. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID (more details...) Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID Data type info: Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID (more details...) Data type: address of a MIL_DOUBLE Recommended casting type: 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_RELATIVE_ORIGIN_ANGLE +		Inquires the angle of rotation of the relative world coordinate system. For 2D-based camera calibration contexts, the angle of rotation is of the relative coordinate system about the Z-axis of the absolute coordinate system. A positive angle corresponds to the rotation of the X-axis in the direction of the negative Y-axis. For 3D-based camera calibration contexts (M_TSAI_BASED or M_3D_ROBOTICS), the axis of rotation is not necessarily the Z-axis. The returned value is equivalent to Param4Ptr of M_ROTATION_AXIS_ANGLE in McalGetCoordinateSystem(). The angle of rotation of the relative coordinate system is affected by transformations performed using McalSetCoordinateSystem() or McalRelativeOrigin() with AngularOffset. If you are using a 3D-based camera calibration context, it is recommended to use McalGetCoordinateSystem(). SET (summarize) Inquires the angle of rotation of the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the angle of rotation, in degrees.
M_RELATIVE_ORIGIN_X +		Inquires the X-coordinate of the origin of the relative world coordinate system. The X-coordinate of the origin of the relative coordinate system is affected by transformations performed using McalSetCoordinateSystem() or McalRelativeOrigin() with XOffset. If you are using a 3D-based camera calibration context, it is recommended to use McalSetCoordinateSystem(). SET (summarize) Inquires the X-coordinate of the origin of the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the X-coordinate.
M_RELATIVE_ORIGIN_Y +		Inquires the Y-coordinate of the origin of the relative world coordinate system. The Y-coordinate of the origin of the relative coordinate system is affected by transformations performed using McalSetCoordinateSystem() or McalRelativeOrigin() with YOffset. If you are using a 3D-based camera calibration context, it is recommended to use McalSetCoordinateSystem(). SET (summarize) Inquires the Y-coordinate of the origin of the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-coordinate.
M_RELATIVE_ORIGIN_Z +		Inquires the Z-coordinate of the origin of the relative world coordinate system. The Z-coordinate of the origin of the relative coordinate system is affected by transformations performed using McalSetCoordinateSystem() or McalRelativeOrigin() with ZOffset. If you are using a 3D-based camera calibration context, it is recommended to use McalSetCoordinateSystem(). SET (summarize) Inquires the Z-coordinate of the origin of the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Z-coordinate.
M_TOOL_POSITION_X +		Inquires the X-position of the origin of the tool coordinate system. SET (summarize) Inquires the X-position of the origin of the tool coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the X-coordinate, in world units.
M_TOOL_POSITION_Y +		Inquires the Y-position of the origin of the tool coordinate system. SET (summarize) Inquires the Y-position of the origin of the tool coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-coordinate, in world units.
M_TOOL_POSITION_Z +		Inquires the Z-position of the origin of the tool coordinate system. SET (summarize) Inquires the Z-position of the origin of the tool coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	Value	Specifies the Z-coordinate, in world units.
M_TRANSFORM_CACHE +		Inquires whether a cache is used to accelerate McalTransformImage(). SET (summarize) Inquires whether a cache is used to accelerate McalTransformImage(). SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DISABLE	Specifies not to use a cache. INFO
	M_ENABLE	Specifies to use a cache.

For a camera calibration context that has been calibrated using McalGrid(), the InquireType parameter can be set to one of the following values.

For a camera calibration context calibrated using McalGrid()
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_COLUMN_NUMBER +		Inquires the number of columns in the camera calibration grid. SET (summarize) Inquires the number of columns in the camera calibration grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 2	Specifies the number of columns.
M_COLUMN_SPACING +		Inquires the number of world units between columns. SET (summarize) Inquires the number of world units between columns. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value > 0.0	Specifies the spacing between columns.
M_FOREGROUND_VALUE +		Inquires whether the grid's circles are lighter or darker than the background. SET (summarize) Inquires whether the grid's circles are lighter or darker than the background. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Determines the appropriate setting automatically.
	M_FOREGROUND_BLACK	Specifies that the grid's circles are darker than the background.
	M_FOREGROUND_WHITE	Specifies that the grid's circles are lighter than the background.
M_GRID_FIDUCIAL +		Inquires whether the partial chessboard grid has a fiducial. SET (summarize) Inquires whether the partial chessboard grid has a fiducial. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Same as M_NONE.
	M_DATAMATRIX	Specifies that a Data Matrix code is used as a fiducial in a chessboard grid. INFO
	M_NONE	Specifies that there is no fiducial in the grid.
M_GRID_HINT_ANGLE_X +		Inquires the hint angle used to help determine the orientation of the X-axis when calibrating your camera with a partial chessboard grid. SET (summarize) Inquires the hint angle used to help determine the orientation of the X-axis when calibrating your camera with a partial chessboard grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_NONE	Specifies that no hint angle is used. INFO
	Value	Specifies the hint angle, measured counter-clockwise.
M_GRID_HINT_PIXEL_X +		Inquires the X-coordinate of the hint pixel used to help determine the grid's reference calibration point when calibrating your camera with a grid. SET (summarize) Inquires the X-coordinate of the hint pixel used to help determine the grid's reference calibration point when calibrating your camera with a grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Same as M_NONE.
	M_NONE	Specifies not to use a hint pixel. INFO
	Value	Specifies the X-coordinate of the hint pixel, in the pixel coordinate system.
M_GRID_HINT_PIXEL_Y +		Inquires the Y-coordinate of the hint pixel used to help determine the grid's reference calibration point when calibrating your camera with a grid. SET (summarize) Inquires the Y-coordinate of the hint pixel used to help determine the grid's reference calibration point when calibrating your camera with a grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Same as M_NONE.
	M_NONE	Specifies not to use a hint pixel. INFO
	Value	Specifies the Y-coordinate of the hint pixel, in the pixel coordinate system.
M_GRID_ORIGIN_X +		Inquires the X-coordinate of the grid's reference calibration point, in the world coordinate system. The world coordinate system could be either the absolute coordinate system or the relative coordinate system, depending on which coordinate system was specified when you called McalGrid(). SET (summarize) Inquires the X-coordinate of the grid's reference calibration point, in the world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the X-coordinate.
M_GRID_ORIGIN_Y +		Inquires the Y-coordinate of the grid's reference calibration point, in the world coordinate system. The world coordinate system could be either the absolute coordinate system or the relative coordinate system, depending on which coordinate system was specified when you called McalGrid(). SET (summarize) Inquires the Y-coordinate of the grid's reference calibration point, in the world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-coordinate.
M_GRID_ORIGIN_Z +		Inquires the Z-coordinate of the grid's reference calibration point, in the world coordinate system. The world coordinate system could be either the absolute coordinate system or the relative coordinate system, depending on which coordinate system was specified when you called McalGrid(). SET (summarize) Inquires the Z-coordinate of the grid's reference calibration point, in the world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Z-coordinate.
M_GRID_PARTIAL +		Inquires whether the chessboard grid in the camera calibration image is allowed to be a partial grid. SET (summarize) Inquires whether the chessboard grid in the camera calibration image is allowed to be a partial grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DISABLE	Specifies that McalGrid() will only calibrate the camera setup when a complete grid is found in the image. INFO
	M_ENABLE	Specifies that McalGrid() can calibrate the camera setup when a partial grid is found in the image. INFO
M_GRID_SHAPE +		Inquires whether the partial chessboard grid in the camera calibration image is assumed to be a rectangle. SET (summarize) Inquires whether the partial chessboard grid in the camera calibration image is assumed to be a rectangle. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Same as M_RECTANGLE.
	M_ANY	Specifies to include all potential calibration points in the image; McalGrid() will not look for the boundary of the real-world grid. INFO
	M_RECTANGLE	Specifies to exclude potential calibration points in the image that McalGrid() determines are outside the boundaries of the partial grid. INFO
M_GRID_TYPE +		Inquires the type of grid used to perform the camera calibration. SET (summarize) Inquires the type of grid used to perform the camera calibration. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_CHESSBOARD_GRID	Specifies a chessboard grid. INFO
	M_CIRCLE_GRID	Specifies a grid of circles. INFO
M_GRID_UNIT_SHORT_NAME +		Inquires the abbreviated name of the world units encoded in the Data Matrix code of the fiducial grid used to calibrate the camera calibration context. Note that this information is not used by the Calibration module. No unit consistency is enforced and no unit conversion is performed. (summarize) Inquires the abbreviated name of the world units encoded in the Data Matrix code of the fiducial grid used to calibrate the camera calibration context. (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size:(McalInquire() with M_GRID_UNIT_SHORT_NAME + M_STRING_SIZE) Note: You can also use M_GRID_UNIT_SHORT_NAME_MAX_SIZE as the array size. Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size:(McalInquire() with M_GRID_UNIT_SHORT_NAME + M_STRING_SIZE) Note: You can also use M_GRID_UNIT_SHORT_NAME_MAX_SIZE as the array size.
	MIL_TEXT("cm") ¹	Specifies the grid units are centimeters.
	MIL_TEXT("ft") ¹	Specifies the grid units are feet.
	MIL_TEXT("in") ¹	Specifies the grid units are inches.
	MIL_TEXT("km") ¹	Specifies the grid units are kilometers.
	MIL_TEXT("m") ¹	Specifies the grid units are meters.
	MIL_TEXT("miles") ¹	Specifies the grid units are miles.
	MIL_TEXT("mils") ¹	Specifies the grid units are mils.
	MIL_TEXT("mm") ¹	Specifies the grid units are millimeters.
	MIL_TEXT("um") ¹	Specifies the grid units are micrometers. Note that micrometers are abbreviated as "um" to ensure easy printing in a non-unicode environment. (summarize) Specifies the grid units are micrometers. (more details...)
	MIL_TEXT("units") ¹	Specifies the grid units are unknown.
M_GRID_UNITS +		Inquires the world units that were encoded in the Data Matrix code of the fiducial grid used to calibrate the camera calibration context. Note that this information is not used by the Calibration module. No unit consistency is enforced and no unit conversion is performed. (summarize) Inquires the world units that were encoded in the Data Matrix code of the fiducial grid used to calibrate the camera calibration context. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_CENTIMETERS	Specifies that the grid units are measured in centimeters.
	M_FEET	Specifies that the grid units are measured in feet.
	M_INCHES	Specifies that the grid units are measured in inches.
	M_KILOMETERS	Specifies that the grid units are measured in kilometers.
	M_METERS	Specifies that the grid units are measured in meters.
	M_MICROMETERS	Specifies that the grid units are measured in micrometers.
	M_MILES	Specifies that the grid units are measured in miles.
	M_MILLIMETERS	Specifies that the grid units are measured in millimeters.
	M_MILS	Specifies that the grid units are measured in mils.
	M_UNKNOWN	Specifies that grid units are measured in an unknown unit. If your calibration grid does not have a fiducial, the grid units are unknown. (summarize) Specifies that grid units are measured in an unknown unit. (more details...)
M_ROW_NUMBER +		Inquires the number of rows in the camera calibration grid. SET (summarize) Inquires the number of rows in the camera calibration grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 2	Specifies the number of rows.
M_ROW_SPACING +		Inquires the spacing between rows in the camera calibration grid. SET (summarize) Inquires the spacing between rows in the camera calibration grid. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value > 0.0	Specifies the spacing between rows, in world units.

¹ If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().

Combination value for M_GRID_UNIT_SHORT_NAME.

You can add the following value to the above-mentioned value to get the string's length.

For getting the string size
Combination value	Description
M_STRING_SIZE	Retrieves the length of the string, including the terminating null character ("\0").

For a camera calibration context that has been calibrated using McalGrid() or McalList(), the InquireType parameter can be set to one of the following values.

For a camera calibration context calibrated using McalGrid() or McalList()
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_AVERAGE_PIXEL_ERROR +		Inquires the average camera calibration error in the pixel coordinate system. You can only inquire this value for a successfully calibrated camera calibration context. This is the average distance in the pixel coordinate system between the initial calibration points and their projected points in an image. When working in M_3D_ROBOTICS camera calibration mode, this only returns the average camera calibration error of the last camera calibration call. To return an average camera calibration error for all camera calibration grids used, it is recommended to use M_GLOBAL_AVERAGE_PIXEL_ERROR instead. (summarize) Inquires the average camera calibration error in the pixel coordinate system. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the average camera calibration error, in pixels.
M_AVERAGE_WORLD_ERROR +		Inquires the average camera calibration error in the absolute coordinate system. You can only inquire this value for a successfully calibrated camera calibration context. This is the average distance in the absolute coordinate system between the initial calibration points and their projected points in an image. When working in M_3D_ROBOTICS camera calibration mode, this only returns the average camera calibration error of the last camera calibration call. To return an average camera calibration error for all camera calibration grids used, it is recommended to use M_GLOBAL_AVERAGE_WORLD_ERROR instead. (summarize) Inquires the average camera calibration error in the absolute coordinate system. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the average camera calibration error, in world units.
M_CALIBRATION_IMAGE_POINTS_X +		Inquires the X-pixel coordinate of the calibration points. If you used McalGrid() to calibrate your camera setup, the calibration points' pixel coordinates are determined by the pixel positions of the centers of the circles in a circle grid or the intersections of four squares/rectangles in a chessboard grid. If you used McalList() to calibrate your camera setup, you explicitly set the calibration points' pixel coordinates with the PixCoordXArrayPtr parameter. SET (summarize) Inquires the X-pixel coordinate of the calibration points. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS
	Value	Specifies the X-coordinate, in pixels.
M_CALIBRATION_IMAGE_POINTS_Y +		Inquires the Y-pixel coordinate of the calibration points. If you used McalGrid() to calibrate your camera setup, the calibration points' pixel coordinates are determined by the pixel positions of the centers of the circles in a circle grid or the intersections of four squares/rectangles in a chessboard grid. If you used McalList() to calibrate your camera setup, you explicitly set the calibration points' pixel coordinates with the PixCoordYArrayPtr parameter. SET (summarize) Inquires the Y-pixel coordinate of the calibration points. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS
	Value	Specifies the Y-coordinate, in pixels.
M_CALIBRATION_WORLD_POINTS_X +		Inquires the X-world coordinate of the calibration points. The coordinate is expressed in world units of the camera calibration plane (M_CALIBRATION_PLANE). If you used McalGrid() to calibrate your camera setup, the calibration points are computed from the parameters GridOffsetX, ColumnNumber, and ColumnSpacing. If you used McalList() to calibrate your camera setup, the world coordinates of the calibration points are those you set with the WorldCoordXArrayPtr parameter. SET (summarize) Inquires the X-world coordinate of the calibration points. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS
	Value	Specifies the X-coordinate, in real-world units of the camera calibration plane (M_CALIBRATION_PLANE).
M_CALIBRATION_WORLD_POINTS_Y +		Inquires the Y-world coordinate of the calibration points. The coordinate is expressed in world units of the camera calibration plane (M_CALIBRATION_PLANE). If you used McalGrid() to calibrate your camera setup, the calibration points are computed from the parameters GridOffsetY, RowNumber, and RowSpacing. If you used McalList() to calibrate your camera setup, the world coordinates of the calibration points are those you set with the WorldCoordYArrayPtr parameter. SET (summarize) Inquires the Y-world coordinate of the calibration points. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS
	Value	Specifies the Y-coordinate, in real-world units of the camera calibration plane (M_CALIBRATION_PLANE).
M_CALIBRATION_WORLD_POINTS_Z +		Inquires the Z-world coordinate of the calibration points that are based on explicitly specified values. The computed calibration points are expressed in world units of the camera calibration plane (M_CALIBRATION_PLANE). If this value is inquired for 2D-based camera calibration contexts, the specified array will be filled with 0.0 values. If you used McalList() to calibrate your camera setup, you explicitly set the calibration points' pixel coordinates with the WorldCoordZArrayPtr parameter. If you used McalGrid() to calibrate your camera setup, you explicitly set the Z-coordinate of all the calibration points with the GridOffsetZ parameter. SET (summarize) Inquires the Z-world coordinate of the calibration points that are based on explicitly specified values. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS Data type info: Data type: array of type MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size: McalInquire() with M_NUMBER_OF_CALIBRATION_POINTS
	Value	Specifies the Z-coordinate, in real-world units of the camera calibration plane (M_CALIBRATION_PLANE).
M_GLOBAL_AVERAGE_PIXEL_ERROR +		Inquires the average camera calibration error, in pixels, for all the points used in all successive calls to McalGrid() and McalList(). You can only inquire this value for a successfully calibrated M_3D_ROBOTICS camera calibration context. (summarize) Inquires the average camera calibration error, in pixels, for all the points used in all successive calls to McalGrid() and McalList(). (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the average camera calibration error, in pixels.
M_GLOBAL_AVERAGE_WORLD_ERROR +		Inquires the average camera calibration error, in world units, for all the points used in all successive calls to McalGrid() and McalList(). You can only inquire this value for a successfully calibrated M_3D_ROBOTICS camera calibration context. (summarize) Inquires the average camera calibration error, in world units, for all the points used in all successive calls to McalGrid() and McalList(). (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the average camera calibration error, in world units.
M_GLOBAL_MAXIMUM_PIXEL_ERROR +		Inquires the maximum camera calibration error, in pixels, for all the points used in all successive calls to McalGrid() and McalList(). You can only inquire this value for a successfully calibrated M_3D_ROBOTICS camera calibration context. (summarize) Inquires the maximum camera calibration error, in pixels, for all the points used in all successive calls to McalGrid() and McalList(). (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the maximum camera calibration error, in pixels.
M_GLOBAL_MAXIMUM_WORLD_ERROR +		Inquires the maximum camera calibration error, in world units, for all the points used in all successive calls to McalGrid() and McalList(). You can only inquire this value for a successfully calibrated M_3D_ROBOTICS camera calibration context. (summarize) Inquires the maximum camera calibration error, in world units, for all the points used in all successive calls to McalGrid() and McalList(). (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the maximum camera calibration error, in world units.
M_MAXIMUM_PIXEL_ERROR +		Inquires the maximum camera calibration error, in pixels. You can only inquire this value for a successfully calibrated camera calibration context. For an M_3D_ROBOTICS camera calibration context, this only returns the average camera calibration error of the last camera calibration call. To return an average camera calibration error for all camera calibration grids used, it is recommended to use M_GLOBAL_MAXIMUM_PIXEL_ERROR instead. (summarize) Inquires the maximum camera calibration error, in pixels. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the maximum camera calibration error, in pixels.
M_MAXIMUM_WORLD_ERROR +		Inquires the maximum camera calibration error, in world units. You can only inquire this value for a successfully calibrated camera calibration context. For an M_3D_ROBOTICS camera calibration context, this only returns the average camera calibration error of the last camera calibration call. To return an average camera calibration error for all camera calibration grids used, it is recommended to use M_GLOBAL_MAXIMUM_WORLD_ERROR instead. (summarize) Inquires the maximum camera calibration error, in world units. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0.0	Specifies the maximum camera calibration error, in world units.
M_NUMBER_OF_CALIBRATION_POINTS +		Inquires the number of calibration points found by McalGrid() or passed to McalList(). If you used McalList() to calibrate your camera setup, you can explicitly set the number of calibration points with the NumPoint parameter. If you used McalGrid() to calibrate your camera setup, the number of calibration points is determined by the number of columns and rows in your grid. SET (summarize) Inquires the number of calibration points found by McalGrid() or passed to McalList(). SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0	Specifies the number of calibration points.
M_NUMBER_OF_CALIBRATION_POSES +		Inquires the number of calls made to McalGrid() or McalList() with the same CalibrationOrMilId parameter passed. You can only inquire this value for a successfully calibrated M_3D_ROBOTICS camera calibration context. (summarize) Inquires the number of calls made to McalGrid() or McalList() with the same CalibrationOrMilId parameter passed. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value >= 0	Specifies the number of camera calibration poses.

For a camera calibration context that has been calibrated using McalGrid(), McalList(), or McalUniform(), the InquireType parameter can be set to one of the following values.

For a camera calibration context calibrated using McalGrid(), McalList(), or McalUniform()
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_ASPECT_RATIO +		Inquires the average aspect ratio. The ratio is the average pixel width, divided by average pixel height, calculated with world units. (summarize) Inquires the average aspect ratio. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_INVALID_SCALE	Specifies that camera calibration was not successful. This value can also be returned if the camera is positioned and oriented in such a way that all points in the image plane are invalid. (summarize) Specifies that camera calibration was not successful. (more details...)
	Value > 0.0	Specifies the average aspect ratio.

For a 3D-based camera calibration context ( M_TSAI_BASED or M_3D_ROBOTICS), the InquireType parameter can be set to one of the following values.

For a 3D-based camera calibration context
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_CCD_ASPECT_RATIO +		Inquires the width to height ratio of the individual elements of the CCD. SET (summarize) Inquires the width to height ratio of the individual elements of the CCD. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	1.0	Specifies that the width and height of the CCD element are equal.
	Value > 0	Specifies the value of the width of a CCD element divided by its height.
M_DISTORTION_RADIAL_1 +		Inquires the value of the second order radial distortion coefficient used in the camera calibration algorithm. Radial distortion refers to image distortions caused by the camera's lens. (summarize) Inquires the value of the second order radial distortion coefficient used in the camera calibration algorithm. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the value of the second order radial distortion coefficient.
M_FOCAL_LENGTH +		Inquires the effective focal length of the pinhole camera model used in the camera calibration. (summarize) Inquires the effective focal length of the pinhole camera model used in the camera calibration. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the effective focal length of the pinhole camera model, expressed in horizontal pixels.
M_PRINCIPAL_POINT_X +		Inquires the X-coordinate of the intersection of the camera's optical axis and the image plane. SET (summarize) Inquires the X-coordinate of the intersection of the camera's optical axis and the image plane. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Specifies half of the image's width, in pixels.
	Value	Specifies the X-coordinate, in pixels.
M_PRINCIPAL_POINT_Y +		Inquires the Y-coordinate of the intersection of the camera's optical axis and the image plane. SET (summarize) Inquires the Y-coordinate of the intersection of the camera's optical axis and the image plane. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_DEFAULT	Specifies half of the image's height, in pixels.
	Value	Specifies the Y-coordinate, in pixels.

For any image, result buffer, or digitizer, the InquireType parameter can be set to the following value.

For any image, digitizer, or result buffer
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_ASSOCIATED_CALIBRATION +		Inquires the identifier of the associated camera calibration context. (summarize) Inquires the identifier of the associated camera calibration context. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID (more details...) Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID Data type info: Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID (more details...) Data type: address of a MIL_DOUBLE Recommended casting type: MIL_ID
	M_NULL	Specifies that there is no camera calibration context associated with the image or digitizer.
	M_DEFAULT_UNIFORM_CALIBRATION	Specifies that the image was calibrated using McalUniform().
	MIL Calibration object identifier	Specifies the camera calibration context that is associated with the image or digitizer.

For a camera calibration context, image, or result buffer, the InquireType parameter can be set to one of the following values. Note that a result buffer has exactly the same calibration information as the calibration information of the image used to obtain the results, if the result buffer's MIL module supports returning results in real-world units; so when you inquire about a result buffer, the information returned is about the image on which the results were obtained.

For a camera calibration context, image, or result buffer
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_CALIBRATION_CATEGORY +		Inquires whether the specified MIL object is or is associated with a camera calibration context, and whether the associated context was allocated with a 2D-based or 3D-based calibration mode. SET (summarize) Inquires whether the specified MIL object is or is associated with a camera calibration context, and whether the associated context was allocated with a 2D-based or 3D-based calibration mode. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_NULL	Specifies the MIL object is not associated with a camera calibration context. Inquiring the camera calibration category of a camera calibration context never returns M_NULL. (summarize) Specifies the MIL object is not associated with a camera calibration context. (more details...)
	M_2D_CALIBRATION	Specifies that the camera calibration context was allocated with a 2D-based camera calibration mode, such as M_LINEAR_INTERPOLATION. When the specified MIL object is an image with a constant pixel size, such as corrected images and depth maps, M_2D_CALIBRATION is returned, regardless of the calibration mode of the camera calibration context with which the object is associated. (summarize) Specifies that the camera calibration context was allocated with a 2D-based camera calibration mode, such as M_LINEAR_INTERPOLATION. (more details...)
	M_3D_CALIBRATION	Specifies that the camera calibration context was allocated with a 3D-based camera calibration mode, such as M_3D_ROBOTICS.
M_CALIBRATION_MODE +		Inquires the camera calibration mode of the associated camera calibration of the specified MIL object. SET (summarize) Inquires the camera calibration mode of the associated camera calibration of the specified MIL object. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_NULL	Specifies the MIL object is not associated with a camera calibration. Inquiring the camera calibration mode of a camera calibration context never returns M_NULL. (summarize) Specifies the MIL object is not associated with a camera calibration. (more details...)
	M_3D_ROBOTICS	Specifies a 3D camera calibration mode for a camera setup with the camera mounted on a robot arm at an unknown position. INFO
	M_LINEAR_INTERPOLATION	Specifies piecewise linear interpolation mode.
	M_PERSPECTIVE_TRANSFORMATION	Specifies perspective transformation mode.
	M_TSAI_BASED	Specifies a 3D camera calibration mode based on the technique developed by Roger Y Tsai. INFO
	M_UNIFORM_TRANSFORMATION	Specifies uniform transformation mode. Images with a constant pixel size (including corrected images and depth maps) are always uniform, even if the camera calibration mode of their associated camera calibration is not. (summarize) Specifies uniform transformation mode. (more details...)
M_CONSTANT_PIXEL_SIZE +		Inquires whether the image has a constant pixel size. When inquiring a camera calibration context, M_CONSTANT_PIXEL_SIZE will always return M_FALSE. (summarize) Inquires whether the image has a constant pixel size. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_FALSE	Specifies that the image does not have a constant pixel size, or that you are inquiring a camera calibration context. The size of each pixel depends on the camera calibration context associated with the image. (summarize) Specifies that the image does not have a constant pixel size, or that you are inquiring a camera calibration context. (more details...)
	M_TRUE	Specifies that the image has a constant pixel size. Note, however, that pixels are not necessarily square; they can be rectangular and might be rotated. (summarize) Specifies that the image has a constant pixel size. (more details...)
M_CORRECTION_STATE +		Inquires whether the image has been physically corrected. Physically corrected images have square pixels with a constant size and no rotation between the pixel and absolute coordinate systems. Images can be corrected using McalTransformImage() with M_FULL_CORRECTION. When inquiring a camera calibration context, M_CORRECTION_STATE will always return M_FALSE. (summarize) Inquires whether the image has been physically corrected. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_FALSE	Specifies that the image has been neither corrected nor calibrated, or that you are inquiring a camera calibration context.
	M_TRUE	Specifies that the image has been corrected.
M_DEPTH_MAP +		Inquires whether the MIL object is a fully corrected depth map. (summarize) Inquires whether the MIL object is a fully corrected depth map. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_FALSE	Specifies that the MIL object is not a fully corrected depth map. Inquiring M_DEPTH_MAP on a camera calibration context returns M_FALSE. (summarize) Specifies that the MIL object is not a fully corrected depth map. (more details...)
	M_TRUE	Specifies that the image is a fully corrected depth map. Note that when M_DEPTH_MAP returns M_TRUE, M_CONSTANT_PIXEL_SIZE also returns M_TRUE and M_GRAY_LEVEL_SIZE_Z cannot return M_INVALID_SCALE. (summarize) Specifies that the image is a fully corrected depth map. (more details...)
M_Y_AXIS_DIRECTION +		Inquires the direction the Y-axis of the absolute coordinate system is oriented with respect to its positive X-axis. If you used McalList() to calibrate your camera setup, the Y-axis orientation was determined by the calibration points that you specified. For more information, see the Calibrating using calibration points from a list section of Chapter 27: Calibrating your camera setup. If you used McalGrid() to calibrate your camera setup, the explicitly specified Y-axis orientation is used. Note that this constant does not support images without an associated camera calibration context. An uncalibrated image will return an error. SET (summarize) Inquires the direction the Y-axis of the absolute coordinate system is oriented with respect to its positive X-axis. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_Y_AXIS_CLOCKWISE	Specifies that the positive Y-axis is oriented 90° clockwise with respect to the positive X-axis.
	M_Y_AXIS_COUNTER_CLOCKWISE	Specifies that the positive Y-axis is oriented 90° counter-clockwise with respect to the positive X-axis.

For an image or result buffer that is calibrated, the InquireType parameter can be set to one of the following values. Note that a result buffer has exactly the same calibration information as the calibration information of the image used to obtain the results, if the result buffer's MIL module supports returning results in real-world units; so when you inquire about a result buffer, the information returned is about the image on which the results were obtained.

For a calibrated image or result buffer
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_CALIBRATION_CHILD_OFFSET_X +		Inquires the X-offset of a child buffer relative to the highest calibrated parent image that was originally associated with the camera calibration context. SET (summarize) Inquires the X-offset of a child buffer relative to the highest calibrated parent image that was originally associated with the camera calibration context. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the X-offset, relative to the child buffer's highest order calibrated parent buffer.
M_CALIBRATION_CHILD_OFFSET_Y +		Inquires the Y-offset of a child buffer relative to the highest calibrated parent image that was originally associated with the camera calibration context. SET (summarize) Inquires the Y-offset of a child buffer relative to the highest calibrated parent image that was originally associated with the camera calibration context. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-offset, relative to the child buffer's highest order calibrated parent buffer.

The following formulas give the relationship between coordinates in pixel units and world units when an image or result buffer is calibrated and has a constant pixel size:

If an image or result buffer is calibrated and has a constant pixel-size, the InquireType parameter can be set to one of the following values.

For a calibrated image or result buffer, with a constant pixel size
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_GRAY_LEVEL_SIZE_Z +		Inquires the step, in world units, along the Z-axis of the relative coordinate system, represented by one gray level. Since the Z-axis is pointing downwards, positive M_GRAY_LEVEL_SIZE_Z values mean that lower (darker) pixel values represent higher world points (top-black); negative M_GRAY_LEVEL_SIZE_Z values mean that higher (brighter) pixel values represent higher world points (top-white). This inquire type is only useful when inquiring about an image buffer that contains a depth map. SET (summarize) Inquires the step, in world units, along the Z-axis of the relative coordinate system, represented by one gray level. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	M_INVALID_SCALE	Specifies that the image is not a depth map.
	Value	Specifies the height, in world units, corresponding to a difference of one gray level. INFO
M_PIXEL_ROTATION +		Inquires the angle of the X-axis of the pixel coordinate system measured in the relative world coordinate system, starting from the positive X-axis of the relative world coordinate system and going towards its positive Y-axis. This value corresponds to R in the above formulas. SET (summarize) Inquires the angle of the X-axis of the pixel coordinate system measured in the relative world coordinate system, starting from the positive X-axis of the relative world coordinate system and going towards its positive Y-axis. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the angle, in degrees.
M_PIXEL_SIZE_X +		Inquires the width of the pixels in the corrected image. You can multiply a measure in pixels, along the X-axis, by M_PIXEL_SIZE_X to get the measure in world units. If there is rotation between the relative world coordinate system and the pixel coordinate system, this distance won't be along the X-axis of the relative world coordinate system. This value corresponds to S_x in the above formulas. SET (summarize) Inquires the width of the pixels in the corrected image. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value > 0.0	Specifies the width, in world units/pixel.
M_PIXEL_SIZE_Y +		Inquires the height of the pixels in the corrected image. You can multiply a measure in pixels, along the Y-axis, by M_PIXEL_SIZE_Y to get the measure in world units. If there is rotation between the relative world coordinate system and the pixel coordinate system, this distance won't be along the Y-axis of the relative world coordinate system. This value corresponds to S_y in the above formulas. SET (summarize) Inquires the height of the pixels in the corrected image. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value > 0.0	Specifies the height, in world units/pixel.
M_WORLD_POS_X +		Inquires the X-coordinate of the center of the top-left pixel in the corrected image. This value corresponds to T_x in the above formulas. SET (summarize) Inquires the X-coordinate of the center of the top-left pixel in the corrected image. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the X-coordinate, expressed in the relative world coordinate system.
M_WORLD_POS_Y +		Inquires the Y-coordinate of the center of the top-left pixel in the corrected image. This value corresponds to T_y in the above formulas. SET (summarize) Inquires the Y-coordinate of the center of the top-left pixel in the corrected image. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-coordinate, expressed in the relative world coordinate system.
M_WORLD_POS_Z +		Inquires the Z-coordinate of gray level 0 in the corrected image. SET (summarize) Inquires the Z-coordinate of gray level 0 in the corrected image. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the base height of a gray level of 0, expressed in the relative world coordinate system .

Combination value for the values listed in For a calibrated image or result buffer; and for the following values: M_CALIBRATION_PLANE; M_CCD_ASPECT_RATIO; M_FOREGROUND_VALUE; M_GRAY_LEVEL_SIZE_Z; M_GRID_FIDUCIAL; M_GRID_HINT_ANGLE_X; M_GRID_HINT_PIXEL_X; M_GRID_HINT_PIXEL_Y; M_LINK_TOOL_AND_CAMERA; M_RELATIVE_ORIGIN_ANGLE; M_RELATIVE_ORIGIN_X; M_RELATIVE_ORIGIN_Y; M_RELATIVE_ORIGIN_Z; M_TOOL_POSITION_X; M_TOOL_POSITION_Y; M_TOOL_POSITION_Z; M_TRANSFORM_CACHE; M_WORLD_POS_Z.

You can add the following value to the above-mentioned values to determine the default value of an inquire type, regardless of the current value of the inquire type.

For inquiring the default value
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_DEFAULT		Inquires the default value of the specified inquire type. (summarize) Inquires the default value of the specified inquire type. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE

For a fixturing offset object, the InquireType parameter can be set to one of the following values.

For a fixturing offset object
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_ANGLE +		Inquires the angular offset to apply to the reference location when setting the relative world coordinate system. SET (summarize) Inquires the angular offset to apply to the reference location when setting the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the angular offset.
M_POSITION_X +		Inquires the X-offset to apply to the reference location when setting the relative world coordinate system. SET (summarize) Inquires the X-offset to apply to the reference location when setting the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the X-offset.
M_POSITION_Y +		Inquires the Y-offset to apply to the reference location when setting the relative world coordinate system. SET (summarize) Inquires the Y-offset to apply to the reference location when setting the relative world coordinate system. SET (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE
	Value	Specifies the Y-offset.

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

For specifying the data type
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_TYPE_CHAR		Casts the requested information to a char. (summarize) Casts the requested information to a char. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a char Data type info: Data type: address of a char
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: array of type MIL_DOUBLE \| address of a MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size:(defined elsewhere) Note: When multiple results. Data type: address of a MIL_DOUBLE Note: When a single result. Data type info: Data type: array of type MIL_DOUBLE \| address of a MIL_DOUBLE (more details...) Data type: array of type MIL_DOUBLE Required array size:(defined elsewhere) Note: When multiple results. Data type: address of a MIL_DOUBLE Note: When a single result.
M_TYPE_MIL_FLOAT		Casts the requested information to a MIL_FLOAT. (summarize) Casts the requested information to a MIL_FLOAT. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_FLOAT Data type info: Data type: address of a MIL_FLOAT
M_TYPE_MIL_ID		Casts the requested information to a MIL_ID. (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 info: 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 info: Data type: address of a MIL_INT
M_TYPE_MIL_INT16		Casts the requested results to a MIL_INT16. (summarize) Casts the requested results to a MIL_INT16. (more details...)
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT16 Data type info: Data type: address of a MIL_INT16
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 info: 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 info: 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; milcal.lib.
DLL	Requires mil.dll; milcal.dll.