MIL_ID SysId, | //in |
MIL_INT64 InquireType, | //in |
void *UserVarPtr | //out |
This function inquires about the specified system setting.
Note that you can use MsysControl() to control specific system settings.
You can also interactively inquire most of the system settings in real-time, using Matrox Intellicam's Feature Browser.
Specifies the system identifier. This parameter should be set to one of the following values:
For the system identifier
|
|||||||||||||||||||||||||||||||||||||||
Value | Description
|
||||||||||||||||||||||||||||||||||||||
M_DEFAULT_HOST |
Specifies the default Host system of the current MIL application. |
||||||||||||||||||||||||||||||||||||||
MIL system identifier |
Specifies a valid system identifier, which you have allocated using the MsysAlloc() function. |
Specifies the type of system setting about which to inquire.
See the Parameter associations section for possible values that can be specified.
Specifies the address in which to write the requested information. Since the MsysInquire() 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.
The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.
The following inquire types allow you to inquire general system settings.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For general system settings
|
|||||||||||||||||||||||||||||||||||||||
InquireType | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ACCELERATOR_PRESENT |
Inquires whether the processing accelerator is present. (more details...) |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_NO |
Specifies that the processing accelerator is not present. |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_YES |
Specifies that the processing accelerator is present. |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_ALLOCATION_OVERSCAN |
Inquires whether image buffers, allocated on the system, will be allocated with an overscan region. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DISABLE |
Specifies that image buffers allocated on the system will have no overscan region. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_ENABLE |
Specifies that image buffers are allocated on the system with an overscan region. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_ALLOCATION_OVERSCAN_SIZE |
Inquires the size of the overscan region, added around all subsequently allocated image buffers (MbufAlloc...()). SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
Value |
Specifies the size of the overscan region, in pixels. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_ASYNCHRONOUS_CALL_SUPPORT |
Inquires whether the system supports asynchronous function execution or not. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_NO |
Specifies that the system does not support asynchronous execution. |
† | a | b | c | e | o | s | |||||||||||||||||||||||||||||||
M_YES |
Specifies that the system supports asynchronous execution. |
† | d | f | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||
M_BOARD_REVISION |
Inquires the board revision number. (more details...) |
† | a | b | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the board revision number. |
† | a | b | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||||
M_BOARD_SUB_REVISION |
Inquires the board sub-revision number. (more details...) |
† | a | f | |||||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the board sub-revision number. |
† | a | f | |||||||||||||||||||||||||||||||||||
M_BOARD_TYPE |
Inquires the type of system board. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_CRONOSPLUS |
Specifies a Matrox CronosPlus board. |
† | b | ||||||||||||||||||||||||||||||||||||
M_GIGE_VISION |
Specifies a camera that uses the Matrox GigE Vision driver. |
† | c | s | |||||||||||||||||||||||||||||||||||
M_GPU |
Specifies a board that uses the Matrox GPU driver. |
† | d | ||||||||||||||||||||||||||||||||||||
M_HOST |
[This is
only applicable to Non-Matrox computer platform]
Specifies a host system. |
† | a | ||||||||||||||||||||||||||||||||||||
M_HOST+ M_4SIGHT + M_4SIGHT_GP |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies a Matrox 4Sight GP with a Host system. |
† | a | ||||||||||||||||||||||||||||||||||||
M_HOST+ M_4SIGHT + M_4SIGHT_GPM |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies a Matrox 4Sight GPm with a Host system. |
† | a | ||||||||||||||||||||||||||||||||||||
M_HOST+ M_4SIGHT + M_4SIGHT_X |
[This is
only applicable to Matrox 4Sight-X platform]
Specifies a Matrox 4Sight X with a Host system. |
† | a | ||||||||||||||||||||||||||||||||||||
M_HOST + M_SUPERSIGHT |
[This is
only applicable to Matrox Supersight platform]
Specifies a Matrox SuperSight with a host system. |
† | a | ||||||||||||||||||||||||||||||||||||
M_IEEE_1394_IIDC |
Specifies a board that uses the Matrox IEEE 1394 IIDC driver. |
† | e | ||||||||||||||||||||||||||||||||||||
M_IEEE_1394_IIDC + M_CONCORD |
Specifies a Concord F-Series adaptor board. |
† | e | ||||||||||||||||||||||||||||||||||||
M_IRIS_GT + M_GT300 |
Specifies a Matrox Iris GT 300. |
† | f | ||||||||||||||||||||||||||||||||||||
M_IRIS + M_GT1200 |
Specifies a Matrox Iris GT 1200. |
† | f | ||||||||||||||||||||||||||||||||||||
M_IRIS + M_GT1900 |
Specifies a Matrox Iris GT 1900. |
† | f | ||||||||||||||||||||||||||||||||||||
M_MORPHIS + M_2VD + M_IO |
Specifies a Matrox Morphis board with two video decoders and the I/O module. |
† | g | ||||||||||||||||||||||||||||||||||||
M_MORPHISQXT + M_4VD + M_IO |
Specifies a Matrox Morphis QxT board with four video decoders and the I/O module. |
† | h | ||||||||||||||||||||||||||||||||||||
M_MORPHISQXT + M_16VD + M_IO |
Specifies a Matrox Morphis QxT analog color/monochrome x4 PCIe frame grabber board with 16 video decoders. |
† | h | ||||||||||||||||||||||||||||||||||||
M_ORION_HD |
Specifies a Matrox Orion HD board. |
† | i | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CL + M_DBCL + M_PF |
Specifies a Matrox Radient eCL dual-Base Camera Link board with a customizable FPGA-based processing core. |
† | j | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CL + M_DFCL + M_PF |
Specifies a Matrox Radient eCL dual-Full Camera Link board with a customizable FPGA-based processing core. |
† | j | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CL + M_QBCL + M_PF |
Specifies a Matrox Radient eCL quad-Base Camera Link board with a customizable FPGA-based processing core. |
† | j | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CL + M_SFCL + M_PF |
Specifies a Matrox Radient eCL single-Base Camera Link board with a customizable FPGA-based processing core. |
† | j | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CXP + M_D3G |
Specifies a Matrox Radient eV-CXP Dual Q3G board. |
† | k | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CXP + M_D6G |
Specifies a Matrox Radient eV-CXP Dual Q6G board. |
† | k | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CXP + M_Q3G |
Specifies a Matrox Radient eV-CXP Quad Q3G board. |
† | k | ||||||||||||||||||||||||||||||||||||
M_RADIENT + M_CXP + M_Q6G |
Specifies a Matrox Radient eV-CXP Quad Q6G board. |
† | k | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XA + M_DA |
Specifies a Matrox Solios eA/XA dual analog board. |
† | l | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XA + M_QA |
Specifies a Matrox Solios eA/XA quad analog board. |
† | l | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XA + M_SA |
Specifies a Matrox Solios eA/XA single analog board. |
† | l | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_DBCL |
Specifies a Matrox Solios eCL/XCL dual-Base Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_DBCL + M_FAST |
Specifies a Matrox Solios eCL/XCL dual-Base fast Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_DBCL + M_PF |
Specifies a Matrox Solios eCL/XCL dual-Base Camera Link board with a customizable FPGA-based processing core. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SBCL |
Specifies a Matrox Solios eCL/XCL single-Base Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SBCL + M_FAST |
Specifies a Matrox Solios eCL/XCL single-Base fast Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SBCL + M_PF |
Specifies a Matrox Solios eCL/XCL single-Base Camera Link board with a customizable FPGA-based processing core. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SFCL |
Specifies a Matrox Solios eCL/XCL single-Full Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SFCL + M_FAST |
Specifies a Matrox Solios eCL/XCL single-Full fast Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SFCL + M_PF |
Specifies a Matrox Solios eCL/XCL single-Full Camera Link board with a customizable FPGA-based processing core. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SMCL |
Specifies a Matrox Solios eCL/XCL single-Medium Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SMCL + M_FAST |
Specifies a Matrox Solios eCL/XCL single-Medium fast Camera Link board. |
† | m | ||||||||||||||||||||||||||||||||||||
M_SOLIOS + M_XCL + M_SMCL + M_PF |
Specifies a Matrox Solios eCL/XCL single-Medium Camera Link board with a customizable FPGA-based processing core. |
† | m | ||||||||||||||||||||||||||||||||||||
M_USB3_VISION |
Specifies a camera that uses the Matrox USB3 Vision driver. |
† | o | ||||||||||||||||||||||||||||||||||||
M_VIO + M_SA |
Specifies a Matrox Vio Analog board. |
† | n | ||||||||||||||||||||||||||||||||||||
M_VIO + M_SA + M_DVI |
Specifies a Matrox Vio DVI-A board. |
† | n | ||||||||||||||||||||||||||||||||||||
M_VIO + M_SA + M_SDI |
Specifies a Matrox Vio Duo board. |
† | n | ||||||||||||||||||||||||||||||||||||
M_CURRENT_THREAD_ID |
Inquires the identifier of the current system thread. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_ID |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DCF_SUPPORTED |
Inquires whether the system supports downloadable digitizer configuration format (DCF) files. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_FALSE |
Specifies that DCF files are not supported. |
† | a | d | |||||||||||||||||||||||||||||||||||
M_TRUE |
Specifies that DCF files are supported. |
† | b | c | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||||
M_DEFAULT_PITCH_BYTE_MULTIPLE |
Inquires the pitch (or stride) multiple (in bytes) for the buffers allocated on the system. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
Value |
Specifies the pitch multiple, in bytes. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DIGITIZER_NUM |
Inquires the total number of possible independent acquisition paths on the system. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Inquires the total number of GigE Vision cameras discovered. |
† | c | o | s | |||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the number of independent acquisition paths available. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DIGITIZER_TYPE + |
Inquires the type of frame grabber(s) available to allocate a digitizer on the system. (more details...) |
† | a | f | |||||||||||||||||||||||||||||||||||
M_GT300 |
Specifies a Matrox Iris GT300 or a Matrox 4SightGP GT 300. (more details...) |
† | a | f | |||||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP platform]
Note that a host system is only available with the Matrox 4SightGP GT 300. |
† | a | |||||||||||||||||||||||||||||||||||||
M_GT1200 |
Specifies a Matrox Iris GT1200. |
† | f | ||||||||||||||||||||||||||||||||||||
M_GT1900 |
Specifies a Matrox Iris GT1900. |
† | f | ||||||||||||||||||||||||||||||||||||
M_DISPLAY_OUTPUT_NUM |
Inquires the number of video output controllers available on your Matrox imaging board. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
Value >= 0 |
Specifies the number of video output controllers. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_EXTENDED_INIT_FLAG |
Inquires the system initialization flag. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT64 |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DEFAULT |
Same as M_COMPLETE. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_COMPLETE |
Specifies to initialize the system completely; the system is initialized to its default state and any required resident software is downloaded. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_PARTIAL |
Specifies to initialize the system to its default state, but it does not download any resident software. INFO |
† | d | ||||||||||||||||||||||||||||||||||||
M_FIRMWARE_BUILDDATE |
Inquires the date when the grab firmware was built. (more details...) |
† | a | f | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the grab firmware build date. |
† | a | f | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||
M_FIRMWARE_BUILDDATE_PROCESSING |
Inquires the date when the processing firmware was built. (more details...) |
† | j | l | m | ||||||||||||||||||||||||||||||||||
Value |
Specifies the processing firmware build date. |
† | j | l | m | ||||||||||||||||||||||||||||||||||
M_FIRMWARE_REVISION |
Inquires the revision number of the grab firmware. (more details...) |
† | a | f | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the grab firmware revision number. |
† | a | f | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||
M_FIRMWARE_REVISION_PROCESSING |
Inquires the revision number of the processing firmware. (more details...) |
† | j | m | |||||||||||||||||||||||||||||||||||
Value |
Specifies the grab firmware revision number. |
† | j | m | |||||||||||||||||||||||||||||||||||
M_GRAB_FPGA_FAN_RPM |
Inquires the revolutions per minute (RPM) of the grab firmware's fan. (more details...) |
† | k | q | |||||||||||||||||||||||||||||||||||
Value |
Specifies the speed of the grab firmware's fan, in RPM. |
† | k | q | |||||||||||||||||||||||||||||||||||
M_LOCATION |
Inquires the location of the specified system. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_LOCAL |
Specifies that the system is on the master computer. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_REMOTE |
Specifies that the system is on the remote computer. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_MEMORY_FREE |
Inquires the total amount of free on-board memory. (more details...) |
† | g | h | j | k | l | m | n | p | q | r | |||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Note that, if the specified system is a Matrox Solios eCL/XCL with Processing FPGA, the dedicated Processing FPGA memory is included in the amount returned. |
† | m | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the amount of free on-board memory, in bytes. |
† | g | h | j | k | l | m | n | p | q | r | |||||||||||||||||||||||||||
M_MEMORY_FREE_BANK_0 |
Inquires the total amount of free on-board memory the first SDRAM bank. (more details...) |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
Value |
Specifies the amount of free on-board memory in the first SDRAM bank, in bytes. |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_MEMORY_FREE_BANK_1 |
Inquires the total amount of free on-board memory second SDRAM bank. (more details...) |
† | j | m | p | r | |||||||||||||||||||||||||||||||||
Value |
Specifies the amount of free on-board memory second SDRAM bank, in bytes. |
† | j | m | p | r | |||||||||||||||||||||||||||||||||
M_MEMORY_FREE_BANK_2 |
Inquires the total amount of free on-board memory in the third SDRAM bank. (more details...) |
† | m | ||||||||||||||||||||||||||||||||||||
Value |
Specifies the amount of free on-board memory in the third SDRAM bank, in bytes. |
† | m | ||||||||||||||||||||||||||||||||||||
M_MEMORY_SIZE |
Inquires the amount of on-board memory. (more details...) |
† | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Note that, if the specified system is a Matrox Solios eCL/XCL with Processing FPGA, the dedicated Processing FPGA memory is included in the amount returned. |
† | m | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the total amount of on-board memory, in Mbytes. |
† | g | h | i | j | k | l | m | n | p | q | r | ||||||||||||||||||||||||||
M_MEMORY_SIZE_BANK_0 |
Inquires the total amount of on-board shared memory in the first SDRAM bank. (more details...) |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
Value |
Specifies the total amount of on-board shared memory in the first SDRAM bank, in Mbytes. |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_MEMORY_SIZE_BANK_1 |
Inquires the total amount of on-board shared memory. (more details...) |
† | j | l | m | p | r | ||||||||||||||||||||||||||||||||
Value |
Specifies the total amount of on-board shared memory, in Mbytes. (more details...) |
† | j | l | m | p | r | ||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This is the second bank of SDRAM. |
† | l | m | ||||||||||||||||||||||||||||||||||||
This is a bank of SRAM. |
† | j | p | r | |||||||||||||||||||||||||||||||||||
M_MEMORY_SIZE_BANK_2 |
Inquires the total amount of on-board shared memory in the second SRAM bank. (more details...) |
† | l | m | |||||||||||||||||||||||||||||||||||
Value |
Specifies the total amount of on-board shared memory in the second SRAM bank, in Mbytes. |
† | l | m | |||||||||||||||||||||||||||||||||||
M_MODIFIED_BUFFER_HOOK_MODE |
Inquires whether to run user-defined functions hooked to a buffer modification on separate threads, up to the number of CPU cores present in the computer. SET (more details...) |
† | c | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||||||
M_MULTI_THREAD + |
Specifies to run user-defined functions hooked to a buffer modification on separate threads. INFO |
† | c | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||||||
M_SINGLE_THREAD |
Specifies that only one thread should be created and that all user-defined functions hooked to buffer modifications are run on the same thread. |
† | c | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||||||
M_NUM_CAMERA_PRESENT |
Inquires the number of GigE Vision-compliant cameras connected to the allocated system. (more details...) |
† | c | o | s | ||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT |
† | c | o | s | ||||||||||||||||||||||||||||||||||
Value |
Specifies the number of GigE Vision-compliant cameras. |
† | c | o | s | ||||||||||||||||||||||||||||||||||
M_NUMBER |
Inquires the board number of the system. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DEVn |
Specifies the n th board of the specified system type. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_OWNER_APPLICATION |
Inquires the MIL identifier of the application context in which the system has been allocated. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_ID |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL application ID |
Specifies the MIL application context identifier. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_PCIE_NUMBER_OF_LANES |
Inquires the number of PCIe lanes that are currently active. (more details...) |
† | j | k | p | q | r | ||||||||||||||||||||||||||||||||
1; 2; 4; 8; 16 |
Specifies the number of active lanes. |
† | j | k | p | q | r | ||||||||||||||||||||||||||||||||
M_PROCESSING_FPGA_FAN_RPM |
Inquires the revolutions per minute (RPM) of the processing firmware's fan. (more details...) |
† | j | p | r | ||||||||||||||||||||||||||||||||||
Value |
Specifies the speed of the processing firmware's fan, in RPM. |
† | j | p | r | ||||||||||||||||||||||||||||||||||
M_PROCESSOR_NUM |
Inquires the number of processors (CPUs) available on the allocated Matrox imaging board. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Note that, when dealing with a Matrox Solios eCL/XCL with the optional Processing FPGA, the FPGA will register as a processor. To find out what type of Matrox Solios you are using, use M_BOARD_TYPE. |
† | l | m | ||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the number of processors available. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_SERIAL_NUMBER |
Inquires the serial number of the Matrox Imaging board, as a string. (more details...) |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | p | q | r | s | ||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP, Matrox 4Sight-X, and Matrox
Supersight platforms]
M_SERIAL_NUMBER only applies to Matrox products. When a host system is allocated on a non-Matrox computer, no serial number is returned. |
† | a | |||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: array of type MIL_TEXT_CHAR |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | p | q | r | s | ||||||||||||||||||||
M_SERIAL_NUMBER_SIZE |
Inquires the length of the string returned by M_SERIAL_NUMBER. (more details...) |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | p | q | r | s | ||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP, Matrox 4Sight-X, and Matrox
Supersight platforms]
M_SERIAL_NUMBER only applies to Matrox products. When a host system is allocated on a non-Matrox computer, no serial number is returned. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the length of the string, including the terminating null character ("\0"), in Mbytes. |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | p | q | r | s | ||||||||||||||||||||
M_SHARED_MEMORY_FREE |
Inquires the total amount of free on-board shared memory. (more details...) |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
Value |
Specifies the total amount of free on-board shared memory, in bytes. |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_SHARED_MEMORY_SIZE |
Inquires the total amount of on-board shared memory. (more details...) |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
Value |
Specifies the total amount of on-board shared memory, in Mbytes. |
† | j | k | l | m | p | q | r | ||||||||||||||||||||||||||||||
M_SYSTEM_DESCRIPTOR |
Inquires the system descriptor. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
UserVarPtr data type info |
Data
type: array of type MIL_TEXT_CHAR |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_SYSTEM_1394 |
Specifies a MIL IEEE 1394b IIDC system. |
† | e | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_CRONOSPLUS |
Specifies a MIL CronosPlus system. |
† | b | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_DEFAULT |
Specifies the default system. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_SYSTEM_GIGE_VISION |
Specifies a MIL GigE Vision system. INFO |
† | c | s | |||||||||||||||||||||||||||||||||||
M_SYSTEM_GPU |
Specifies a MIL GPU system. |
† | d | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_HOST |
Specifies a Host system. INFO |
† | a | f | |||||||||||||||||||||||||||||||||||
M_SYSTEM_IRIS_GT |
Specifies a MIL Iris GT system. |
† | f | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_MORPHIS |
Specifies a MIL Morphis system. |
† | g | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_MORPHISQXT |
Specifies a MIL Morphis QxT system. |
† | h | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_ORION_HD |
Specifies a MIL Orion HD system. |
† | i | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_RADIENT |
Specifies a MIL Radient system. |
† | j | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_RADIENTCXP |
Specifies a MIL Radient eV-CXP system. |
† | k | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_SOLIOS |
Specifies a MIL Solios system. |
† | l | m | |||||||||||||||||||||||||||||||||||
M_SYSTEM_USB3_VISION |
Specifies a MIL USB3 Vision system. INFO |
† | o | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_VIO |
Specifies a MIL Vio system. |
† | n | ||||||||||||||||||||||||||||||||||||
MIL_TEXT("dmilpcie://[Passkey:]RemoteComputerName[:Port]/MILSystemType") 1 |
[This is
only applicable to Matrox Supersight platform]
Specifies a DMIL remote system on a remote Matrox Supersight SHB that will communicate with the local SHB, using the PCIe protocol. INFO |
† | a | b | c | d | e | f | g | h | i | j | l | m | n | o | p | r | s | ||||||||||||||||||||
MIL_TEXT("dmilshm://[Passkey:]localhost[:Port]/MILSystemType") 1 |
Specifies a DMIL remote system for a separate process on the local computer, using the DMIL SHM protocol. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL_TEXT("dmiltcp://[Passkey:]RemoteComputerName[:Port]/MILSystemType") 1 |
Specifies a DMIL remote system on a remote or local computer, using the TCP/IP protocol. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_SYSTEM_DESCRIPTOR_SIZE |
Inquires the length of the string returned by M_SYSTEM_DESCRIPTOR. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
Value |
Specifies the length of the string, including the terminating null character ("\0"). |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_SYSTEM_TYPE |
Inquires the type of system allocated. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_SYSTEM_1394_TYPE |
Specifies a MIL IEEE 1394 IIDC system. |
† | e | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_CRONOSPLUS_TYPE |
Specifies a MIL CronosPlus system. |
† | b | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_GIGE_VISION_TYPE |
Specifies a MIL GigE Vision system. |
† | c | s | |||||||||||||||||||||||||||||||||||
M_SYSTEM_GPU_TYPE |
Specifies a MIL GPU system. |
† | d | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_HOST_TYPE |
Specifies the Host. |
† | a | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_IRIS_GT_TYPE |
Specifies a MIL Iris GT system. |
† | f | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_MORPHIS_TYPE |
Specifies a MIL Morphis system. |
† | g | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_MORPHISQXT_TYPE |
Specifies a MIL Morphis QxT system. |
† | h | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_ORION_HD_TYPE |
Specifies a MIL Orion HD system. |
† | i | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_RADIENT_TYPE |
Specifies a MIL Radient system. |
† | j | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_RADIENTCXP_TYPE |
Specifies a MIL Radient eV-CXP system. |
† | k | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_SOLIOS_TYPE |
Specifies a MIL Solios system. |
† | l | m | |||||||||||||||||||||||||||||||||||
M_SYSTEM_USB3_VISION_TYPE |
Specifies a MIL USB3 Vision system. |
† | o | ||||||||||||||||||||||||||||||||||||
M_SYSTEM_VIO_TYPE |
Specifies a MIL Vio system. |
† | n | ||||||||||||||||||||||||||||||||||||
M_TEMPERATURE |
Inquires the current temperature of the graphics controller. (more details...) |
† | i | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | i | ||||||||||||||||||||||||||||||||||||
Value |
Specifies the current temperature, in degrees Celsius. |
† | i | ||||||||||||||||||||||||||||||||||||
M_TEMPERATURE_FPGA |
Inquires the current temperature of the grab firmware. (more details...) |
† | j | k | p | q | r | ||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | j | k | p | q | r | ||||||||||||||||||||||||||||||||
Value |
Specifies the current temperature, in degrees Celsius. |
† | j | k | p | q | r | ||||||||||||||||||||||||||||||||
M_TEMPERATURE_FPGA_MAX_MEASURED |
Inquires the maximum temperature of the grab firmware measured. (more details...) |
† | j | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | j | ||||||||||||||||||||||||||||||||||||
Value |
Specifies the maximum measured temperature, in degrees Celsius. |
† | j | ||||||||||||||||||||||||||||||||||||
M_TEMPERATURE_FPGA_PROCESSING |
Inquires the current temperature of the processing firmware. (more details...) |
† | j | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | j | ||||||||||||||||||||||||||||||||||||
Value |
Specifies the current temperature, in degrees Celsius. |
† | j | ||||||||||||||||||||||||||||||||||||
M_TEMPERATURE_FPGA_PROCESSING_MAX_MEASURED |
Inquires the maximum temperature of the processing firmware measured. (more details...) |
† | j | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | j | ||||||||||||||||||||||||||||||||||||
Value |
Specifies the maximum measured temperature, in degrees Celsius. |
† | j | ||||||||||||||||||||||||||||||||||||
M_THREAD_MODE |
Inquires whether threads allocated on the system can execute in asynchronous mode. SET (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_ASYNCHRONOUS |
Specifies that threads allocated on the system can execute in asynchronous mode. INFO |
† | b | c | d | e | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||||
M_SYNCHRONOUS |
Specifies that threads allocated on the system can only execute in synchronous mode. INFO |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_TIMEOUT |
Inquires the maximum amount of time for the Host to wait for a synchronous function to return before generating a time-out error. SET (more details...) |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||
M_INFINITE |
Waits indefinitely. |
† | f | l | |||||||||||||||||||||||||||||||||||
Value |
Specifies the time to wait, in secs. |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||
M_UART_PRESENT |
Inquires the number of UARTs on the system. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the number of UARTs on the system. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_WATCHDOG_PRESENT |
Inquires whether Watchdog circuitry is present. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_FALSE |
Specifies that Watchdog circuitry is not present. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_TRUE |
Specifies that Watchdog circuitry is present. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s |
1 If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().
The following value might be combined with the above-mentioned value to determine the number of hook threads.
Returns the number of hook threads that
were allocated
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
Value >= 1 |
Specifies the number of hook threads that were allocated . INFO |
† | c | g | h | j | k | l | m | n | o | p | q | r | s |
You can add the following value to the above-mentioned value to specify the acquisition path to inquire.
For specifying the acquisition path to
inquire
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_DEV0 |
Specifies the number of the acquisition path to inquire. |
† | f |
The following inquire types and inquire values allow you to inquire the number, mode, and the purpose of I/O signals (such as, auxiliary signal). Once the format, routing, and mode are determined for an I/O signal, you can further inquire the I/O signal using the inquire types described in the For inquiring the state of specified user-bits in a static-user-output register table.
Note that for other Matrox imaging boards that have auxiliary I/O signals, but are not supported with the constants below, see MdigInquire().
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For inquiring I/O signals and their
mode
|
|||||||||||||||||||||||||||||||||||||||
InquireType | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_AUX_IO_COUNT |
Inquires the total number of auxiliary signals. (more details...) |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
Value |
Specifies the total number of auxiliary signals. |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
M_AUX_IO_COUNT_IN |
Inquires the total number of auxiliary input and I/O signals. (more details...) |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
Value |
Specifies the total number of auxiliary input and I/O signals. |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
M_AUX_IO_COUNT_OUT |
Inquires the total number of auxiliary output and I/O signals. (more details...) |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
Value |
Specifies the total number of auxiliary output and I/O signals. |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
M_IO_DEBOUNCE_TIME + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the amount of time that the specified auxiliary input signal is debounced. SET (more details...) |
† | a | f | |||||||||||||||||||||||||||||||||||
0 <= Value <= 503316450 |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies the minimum amount of time to ignore any additional signal transitions after accepting a signal transition, in nsecs. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
250;1000;5000;10000;1000000;10000000;25000000 |
Specifies the amount of time that an auxiliary input signal must be active for it to be accepted, in nsecs. |
† | f | ||||||||||||||||||||||||||||||||||||
M_IO_FORMAT + |
Inquires the format for an I/O signal. (more details...) |
† | a | f | |||||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
M_CURRENT_SOURCE |
Specifies that the specified I/O is an current-controlled output. |
† | a | f | |||||||||||||||||||||||||||||||||||
M_OPEN_DRAIN |
Specifies that the specified I/O is an open collector (open drain) I/O signal. |
† | a | f | |||||||||||||||||||||||||||||||||||
M_OPTO |
Specifies that the specified I/O is an opto-coupled I/O signal. |
† | a | f | |||||||||||||||||||||||||||||||||||
M_IO_GLITCH_FILTER_STATE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires whether the glitch filter is enabled. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies not to use a glitch filter. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to use a glitch filter. |
† | a | ||||||||||||||||||||||||||||||||||||
M_IO_INTERRUPT_ACTIVATION + |
Inquires the signal transition upon which to generate an interrupt, if interrupt generation has been enabled for the specified I/O signal. SET (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
M_ANY_EDGE |
Specifies to generate an interrupt upon both a low-to-high and a high-to-low signal transition. |
† | b | e | g | h | |||||||||||||||||||||||||||||||||
M_EDGE_FALLING |
Specifies that an interrupt will be generated upon a high-to-low signal transition. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_EDGE_RISING |
Specifies that an interrupt will be generated upon a low-to-high signal transition. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_IO_INTERRUPT_STATE + |
Inquires whether to generate an interrupt upon the specified transition of the I/O signal. SET (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies not to generate an interrupt. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to generate an interrupt. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_IO_MODE + |
Inquires mode of the specified I/O signal. SET (more details...) |
† | b | f | g | h | |||||||||||||||||||||||||||||||||
M_INPUT |
Specifies that the signal is for input. |
† | b | f | g | h | |||||||||||||||||||||||||||||||||
M_OUTPUT |
Specifies that the signal is for output. |
† | b | f | g | h | |||||||||||||||||||||||||||||||||
M_IO_SOURCE + |
Inquires the type of signal to route to an output signal, or an I/O signal set to output mode. SET (more details...) |
† | a | f | g | h | |||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to route auxiliary signal n, where n is a number of the auxiliary signal. |
† | a | f | g | h | |||||||||||||||||||||||||||||||||
M_EXPOSURE |
Specifies to route the exposure signal of the camera. |
† | f | ||||||||||||||||||||||||||||||||||||
M_GRAB_TRIGGER |
Specifies to route the grab trigger signal. |
† | f | ||||||||||||||||||||||||||||||||||||
M_IO_COMMAND_LISTn + |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies to route the output a bit of the I/O command register of I/O command list n, where n is the number of the I/O command list. INFO (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODERn |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies to route the output of rotary encoder n, where n is the number of rotary encoders available. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER2 |
Specifies to route the output of timer 2. |
† | f | ||||||||||||||||||||||||||||||||||||
M_TIMERn |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies to route the output of timer n, where n is the number of timers available. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_USER_BITn |
Specifies to route the state of bit n of the main static-user-output register, where n is the bit number. INFO |
† | a | f | |||||||||||||||||||||||||||||||||||
M_IO_STATUS + |
Inquires the status of the specified I/O signal. (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Inquiring the status of signals dedicated for trigger inputs will generate an error. |
† | b | f | g | |||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
M_INVALID |
Specifies that the I/O signal is disabled. |
† | a | b | e | g | h | ||||||||||||||||||||||||||||||||
M_OFF |
Specifies that the I/O signal is off. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_ON |
Specifies that the I/O signal is on. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_UNKNOWN |
Specifies that the I/O signal cannot be inquired with its current configuration. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_IO_STATUS_ALL + |
Inquires the status of all available I/O signals. (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT64 |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
Value |
Specifies the bit-encoded value representing the status of all available and inquirable I/O signals. (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
The status of signals dedicated for trigger inputs are indeterminable. The bit(s) representing dedicated trigger signal(s) are to be ignored. |
† | b | f | g |
You must add the following value to the above-mentioned values to specify the type and number of the I/O signal .
For inquiring the type and number of the
I/O signal
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to affect auxiliary signal n, where n is the signal number. INFO |
† | a | b | e | f | g | h |
You can add the following value to the above-mentioned value to specify the type of I/O signal to inquire.
For specifying the type of I/O signal to
inquire
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_AUX_IO |
Specifies to inquire all auxiliary signals. |
† | a | b | e | f | g | h |
The following inquire types and inquire values specify the settings for specified bits in a static-user-output register. The user-bits are the bits associated with output signals or I/O signals set to output. To establish which user-bits can be routed to a specific signal, see the connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board.
Note that for other Matrox imaging boards that have user-bits, but are not supported with the constants below, see MdigInquire().
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For inquiring the state of specified
user-bits in a static-user-output register
|
|||||||||||||||||||||||||||||||||||||||
InquireType | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_USER_BIT_COUNT |
Inquires the total number of bits of the main static-user-output register. (more details...) |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
Value |
Specifies the number of bits in the main static-user-output register. |
† | a | b | e | f | g | h | n | ||||||||||||||||||||||||||||||
M_USER_BIT_STATE + |
Inquires the state of the specified bit in a static-user-output register. SET (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
M_OFF |
Specifies that the specified bit is set to off. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_ON |
Specifies that the specified bit is set to on. |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
M_USER_BIT_STATE_ALL |
Inquires the state of all the bits in the main static-user-output register. SET (more details...) |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Matrox 4Sight GP and Matrox 4Sight-X
platforms]
This constant is only available on a host system if the host system has been allocated on a Matrox 4Sight. |
† | a | |||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT64 |
† | a | b | e | f | g | h | |||||||||||||||||||||||||||||||
Value |
Specifies a bit-encoded value that establishes the value of all the bits of the specified static-user-output register. INFO |
† | a | b | e | f | g | h |
You must add the following value to the above-mentioned value to specify the bit in the static-user-output register.
For inquiring the bit in the
static-user-output register
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_USER_BITn |
Specifies to affect bit n of the main static-user-output register. |
† | a | b | e | f | g | h |
The following inquire types and inquire values allow you to inquire about timers and the signals generated from a timer (timer output signals). For more information, see the Timers and coordinating events section of Chapter 24: I/O signals and communicating with external devices.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For inquiring the settings of a
timer
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_TIMER_ARM + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires whether to enable the timer arming mechanism. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that timer arming is disabled. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that timer arming is enabled. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_ARM_ACTIVATION + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the signal transition upon which to arm the timer. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_ANY_EDGE |
Specifies that the timer will be armed by both a high-to-low and a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_FALLING |
Specifies that the timer will be armed upon a high-to-low signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_RISING |
Specifies that the timer will be armed upon a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_LEVEL_HIGH |
Specifies that a timer is continuously armed during a high signal polarity. |
† | a | ||||||||||||||||||||||||||||||||||||
M_LEVEL_LOW |
Specifies that a timer is continuously armed during a low signal polarity. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_ARM_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires which input signal will arm the timer. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the source signal used to arm the specified timer, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_SOFTWARE |
Specifies to use software to arm the specified timer. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMERn |
Specifies to use the output signal of the specified timer as the source signal to arm the timer, where n is the timer number. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_CLOCK_ACTIVATION + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the edge of the signal that will increment the clock used to control the active portion of the timer's output signal. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_ANY_EDGE |
Specifies that the clock will be incremented by both a high-to-low and a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_FALLING |
Specifies that the clock will be incremented by a high-to-low signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_RISING |
Specifies that the clock will be incremented by a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_CLOCK_FREQUENCY + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the frequency of the clock source signal for the active portion of the timer's output signal (M_TIMER_CLOCK_SOURCE). SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | a | ||||||||||||||||||||||||||||||||||||
M_UNKNOWN |
Specifies that the signal is not periodic or the frequency is unknown. |
† | a | ||||||||||||||||||||||||||||||||||||
0 < Value <= Frequency of M_SYSCLK |
Specifies the frequency, in Hz. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_CLOCK_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the source of the clock that drives the active portion of the specified timer's output signal. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the clock source, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODERn |
Specifies to use rotary decoder n as the clock source, where n is the number of the rotary decoder. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_SYSCLK |
Specifies to use the allocated system's clock source. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_DELAY + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the delay between the timer trigger and the active portion of the timer's output signal. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | a | ||||||||||||||||||||||||||||||||||||
0 <= Value <= Max. value |
Specifies the delay. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_DELAY_CLOCK_ACTIVATION + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the signal transition that will increment the clock used to control the delay between the timer's trigger and the active portion of the timer's output signal. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_ANY_EDGE |
Specifies that the clock will be incremented by both a high-to-low and a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_FALLING |
Specifies that the clock will be incremented by a high-to-low signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_RISING |
Specifies that the clock will be incremented by a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_DELAY_CLOCK_FREQUENCY + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the frequency of the clock source signal for the delay between the timer's trigger and the active portion of the timer's output signal (M_TIMER_DELAY_CLOCK_SOURCE). SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | a | ||||||||||||||||||||||||||||||||||||
M_UNKNOWN |
Specifies that the signal is not periodic or the frequency is unknown. |
† | a | ||||||||||||||||||||||||||||||||||||
0 < Value <= Frequency of M_SYSCLK |
Specifies the frequency, in Hz. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_DELAY_CLOCK_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the source of the clock that drives the delay between the timer's trigger and the active portion of the specified timer's output signal. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the clock source, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_FOLLOW_TIMER_CLOCK |
Specifies to use the clock source specified by M_TIMER_CLOCK_SOURCE. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODERn |
Specifies to use rotary decoder n as the clock source, where n is the number of the rotary decoder. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_SYSCLK |
Specifies to use the allocated system's clock source. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_DURATION + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the duration for the active portion of the timer's output signal. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | a | ||||||||||||||||||||||||||||||||||||
0 <= Value <= Max. value |
Specifies the duration of the active portion of the timer output signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_OUTPUT_INVERTER + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires whether the output of the timer should be inverted. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies not to invert the output of the timer. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to invert the output of the timer. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_STATE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the state of the specified timer. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that the timer is disabled. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that the timer is enabled. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_TRIGGER_ACTIVATION + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the signal variation upon which to generate a timer trigger, if the specified timer is enabled. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_ANY_EDGE |
Specifies that a timer trigger will be generated both upon a high-to-low and a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_FALLING |
Specifies that a timer trigger will be generated upon a high-to-low signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_RISING |
Specifies that a timer trigger will be generated upon a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_LEVEL_HIGH |
Specifies that a timer trigger is continuously issued during a high signal polarity. |
† | a | ||||||||||||||||||||||||||||||||||||
M_LEVEL_LOW |
Specifies that a timer trigger is continuously issued during a low signal polarity. |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_TRIGGER_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the trigger source for the specified timer. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_CONTINUOUS |
Specifies to run the specified timer in periodic mode; no actual trigger signal is used. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_IO_COMMAND_LISTn + |
Specifies to use a bit of the I/O command register of I/O command list n, where n is the number of the I/O command list. INFO (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODERn |
Specifies to use rotary decoder n as the trigger source, where n is the number of the rotary decoder. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_SOFTWARE |
Specifies to use a software trigger as the trigger source. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMERn |
Specifies to use the output signal of the specified timer as the trigger source, where n is the timer number. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_USAGE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires how the timer should be used. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_PULSE_GENERATION |
Specifies the normal use of the timer, as described in the Timers and coordinating events section of Chapter 24: I/O signals and communicating with external devices. |
† | a | ||||||||||||||||||||||||||||||||||||
M_PULSE_MEASUREMENT |
Specifies to use the timer to measure the duration of the pulse that occurs on the timer's trigger source. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_TIMER_VALUE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the current value of the timer's duration. (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
† | a | ||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies current value of the timer's duration. (more details...) |
† | a |
You must add the following value to the above-mentioned values to specify which on-board timer to inquire.
For specifying which on-board
timer to inquire
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_TIMERn |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies on-board timer n, where n is the number of the timer. INFO |
† | a |
The following value is combined with the above-mentioned values to specify which I/O command register bit was used.
For specifying which I/O command
register bit was used
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_IO_COMMAND_BITn |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies I/O command register bit n, where n represents the bit number. INFO |
† | a |
You can add one of the following values to the above-mentioned values to determine the maximum or minimum value for the setting.
For inquiring the maximum or
minimum value for the setting
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_MAX_VALUE |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies the maximum value for this setting. |
† | a | ||||||||||||||||||||||||||||||||||||
M_MIN_VALUE |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies the minimum value for this setting. |
† | a |
The following inquire types and inquire values allow you to inquire about the settings of a rotary decoder.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For inquiring the settings of a
rotary decoder
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_BIT0_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the auxiliary input signal on which to receive bit 0 of the 2-bit Gray code. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the signal on which to receive bit 0 of the 2-bit Gray code, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_BIT1_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the auxiliary input signal on which to receive bit 1 of the 2-bit Gray code. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the signal on which to receive bit 1 of the 2-bit Gray code, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_OUTPUT_MODE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the rotary decoder's counter value and/or the direction of movement upon which the rotary decoder should output a pulse. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_POSITION_TRIGGER |
Specifies to output a pulse upon the trigger generated by M_ROTARY_ENCODER_POSITION_TRIGGER. |
† | a | ||||||||||||||||||||||||||||||||||||
M_STEP_ANY |
Specifies to output a pulse upon any change in the rotary decoder's counter value (position change in any direction). |
† | a | ||||||||||||||||||||||||||||||||||||
M_STEP_BACKWARD |
Specifies to output a pulse upon a rotary decoder counter decrement only. |
† | a | ||||||||||||||||||||||||||||||||||||
M_STEP_FORWARD |
Specifies to output a pulse upon a rotary decoder counter increment only. |
† | a | ||||||||||||||||||||||||||||||||||||
M_STEP_FORWARD_NEW_POSITIVE |
Specifies to output a pulse upon a rotary decoder counter increment of a new value that has not been reached before. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_POSITION_TRIGGER + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the value of the rotary decoder's counter upon which a trigger is generated. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
0 <= Value <= 0xFFFFFFFF |
Specifies the value of the counter upon which a trigger is generated. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_RESET_ACTIVATION + |
[This is
only applicable to Matrox 4Sight GP platform]
Sets the signal transition upon which to reset the rotary decoder's coutner to 0. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_FALLING |
Specifies to reset the rotary decoder upon a high-to-low signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_EDGE_RISING |
Specifies to reset the rotary decoder upon a low-to-high signal transition. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_RESET_SOURCE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires the signal source to use to reset the rotary decoder's counter to 0. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_NULL |
Specifies not to reset using a hardware signal source. |
† | a | ||||||||||||||||||||||||||||||||||||
M_AUX_IOn |
Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. INFO |
† | a | ||||||||||||||||||||||||||||||||||||
M_POSITION_TRIGGER |
Specifies to use the trigger signal generated by the rotary decoder when the counter reaches the value specified with M_ROTARY_ENCODER_POSITION_TRIGGER. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODER_STATE + |
[This is
only applicable to Matrox 4Sight GP platform]
Inquires whether the specified rotary decoder is enabled. SET (more details...) |
† | a | ||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that the rotary decoder is disabled. |
† | a | ||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that the rotary decoder is enabled. |
† | a |
You must add the following value to the above-mentioned values to specify which rotary decoder to inquire.
For specifying which rotary
decoder to inquire about
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_ROTARY_ENCODERn |
[This is
only applicable to Matrox 4Sight GP platform]
Specifies rotary decoder n, where n is the number of the rotary decoder. INFO |
† | a |
The following inquire types allow you to inquire UART settings.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For UART settings
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_COM_PORT_NUMBER + |
Inquires the Microsoft Windows COM port number associated with the specified UART. (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the Microsoft Windows COM port number associated with the specified UART. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_BYTES_READ + |
Inquires the number of bytes read from the UART, after waiting for the UART read operation (using MsysControl() with M_UART_READ_STRING) to complete. (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the number of bytes read from the UART. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_BYTES_WRITTEN + |
Inquires the number of bytes written to the UART, after waiting for the UART write operation (using MsysControl() with M_UART_WRITE_STRING) to complete. (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the number of bytes written to the UART, in bytes. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_DATA_PENDING + |
Inquires whether the UART input buffer has pending data or not. (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_FALSE |
Specifies that the UART input buffer does not have pending data. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_TRUE |
Specifies that the UART input buffer has pending data. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_DATA_SIZE + |
Inquires the number of data bits per character that is sent or received by the UART. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
7 |
Specifies that the data length is 7 bits. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
8 |
Specifies that the data length is 8 bits. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_INTERFACE_TYPE + |
Inquires the type of interface used by the UART. (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_RS232 |
Specifies that an RS-232 interface is used. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_RS485 |
Specifies that an RS-485 interface is used. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_PARITY + |
Inquires whether character data is sent or recieved with a parity bit and how the parity bit is set. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_DISABLE |
Species that no extra bit is added (no parity). |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_EVEN |
Specifies that the number of 1's will be even. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_ODD |
Specifies that the number of 1's will be odd. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_READ_STRING_MAXIMUM_SIZE + |
Inquires the maximum length of the string to be read using M_UART_READ_STRING. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the maximum length of the string, in bytes. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_READ_STRING_SIZE + |
Inquires the number of bytes to read when calling MsysControl() with M_UART_READ_STRING. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the use of M_UART_STRING_DELIMITER to delineate the end of the string to read. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the string length, in bytes. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_SPEED + |
Inquires the baud rate of the UART. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
300;600;1200;1800;2400;4800;7200;9600;14400; 19200;38400;57600;115200 |
Specifies the baud rate of the UART. INFO |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_STOP_BITS + |
Inquires the number of extra data bit(s) that are added to each character to indicate the end of a character. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
1 |
Specifies that there is 1 stop bit. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
2 |
Specifies that there are 2 stop bits. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_STRING_DELIMITER + |
Inquires the character used to terminate strings of incoming or outgoing data. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the character used to terminate strings. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_TIMEOUT + |
Inquires the maximum time to wait between each byte when reading incoming data. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_INFINITE |
Waits indefinitely. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the time to wait, in msecs. |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
M_UART_WRITE_STRING_SIZE + |
Inquires the length of the string to be sent to the UART for transmission. SET (more details...) |
† | g | j | l | m | p | r | |||||||||||||||||||||||||||||||
Value |
Specifies the string length, in bytes. |
† | g | j | l | m | p | r |
You can add the following value to the above-mentioned values to set which UART to inquire.
For COM Ports and
UARTs
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
Specifies which UART should be inquired. (more details...) |
† | g | j | l | m | p | r | ||||||||||||||||||||||||||||||||
Parameters | |||||||||||||||||||||||||||||||||||||||
Specifies a device (UART) to inquire. |
† | g | j | l | m | p | r | ||||||||||||||||||||||||||||||||
|
† | g | j | l | m | p | r | ||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
There is 1 UART available on Matrox Morphis. |
† | g | |||||||||||||||||||||||||||||||||||||
There are 4 UARTs available on Matrox Solios eA/XA Quad, 2 on Matrox Solios eA/XA Dual, and 1 on Matrox Solios eA/XA Single. |
† | l | |||||||||||||||||||||||||||||||||||||
There are 2 UARTs are available on Matrox Solios eCL/XCL dual-Base/single-Medium operating in dual-Base mode, and 1 is available on Matrox Solios eCL/XCL-B, eCL/XCL-F, and eCL/XCL dual-Base/single-Medium operating in single-Medium mode. |
† | j | m | p | r | ||||||||||||||||||||||||||||||||||
There are 2 UARTS available on Matrox Radient eCL-DB and eCL-DF, 4 on Matrox Radient eCL-QB, and 1 on Matrox Radient eCL-SF. Note that, using the CLProtocol will occupy one COM port per allocated digitizer. |
† | j | p | r |
The following inquire types and inquire values specify the settings for the Watchdog.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.
For Watchdog
settings
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_WATCHDOG_MODE |
Inquires the current state of the Watchdog. SET (more details...) |
† | g | h | |||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that the Watchdog is disabled. |
† | g | h | |||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that the Watchdog is enabled. |
† | g | h | |||||||||||||||||||||||||||||||||||
M_WATCHDOG_REBOOT_TIMEOUT |
Inquires the timeout value of the Watchdog's reboot timer. SET (more details...) |
† | g | h | |||||||||||||||||||||||||||||||||||
Value |
Specifies the timeout value, in msecs. |
† | g | h | |||||||||||||||||||||||||||||||||||
M_WATCHDOG_RESET_COUNTER |
Inquires the number of times the Watchdog has rebooted your computer. (more details...) |
† | g | h | |||||||||||||||||||||||||||||||||||
Value |
Specifies the number of Watchdog reboots. |
† | g | h | |||||||||||||||||||||||||||||||||||
M_WATCHDOG_TIMEOUT |
Inquires the timeout value of the Watchdog's main timer. SET (more details...) |
† | g | h | |||||||||||||||||||||||||||||||||||
Value |
Specifies the timeout value, in msecs. |
† | g | h | |||||||||||||||||||||||||||||||||||
M_WATCHDOG_WARNING_TIME |
Inquires the timeout value of the Watchdog's warning timer. SET (more details...) |
† | g | h | |||||||||||||||||||||||||||||||||||
M_INFINITE |
Specifies that the Watchdog will never receive a warning. |
† | g | h | |||||||||||||||||||||||||||||||||||
Value |
Specifies the warning time interval, in msecs. |
† | g | h |
The following example uses M_BOARD_TYPE. The returned value is then masked so that only the board type is returned.
/* To return only the main board type, and not the sub-board types (for example M_XCL,
M_FAST, or M_SDI), mask the return value with M_BOARD_TYPE_MASK.
*/
/* Call MsysInquire with M_BOARD_TYPE to inquire the full board type. */
MsysInquire(MilSystem, M_BOARD_TYPE, &BoardType);
/* Use M_BOARD_TYPE_MASK to verify the main board type. */
if ((BoardType & M_BOARD_TYPE_MASK) == M_SOLIOS)
{
/* Perform a Matrox Solios-specific task. */
}
Header | Include mil.h. |
Library | Use mil.lib. |
DLL | Requires mil.dll. |