Use Mech-Eye Viewer to Adjust Camera Parameters for GenICam Client¶
Setting camera parameters such as Auto-Exposure ROI, Depth Range and ROI usually requires the assistance of visualized tools for several rounds of fine tuning. Since GenICam-compliant third-party machine vision software (GenICam clients) does not provide visualized tools, you can set these parameters by using the visualized tools provided by Mech-Eye Viewer.
After setting these parameters using Mech-Eye Viewer, you can read the latest camera configuration in a GenICam client directly.
Preparation¶
Before you adjust parameters in Mech-Eye Viewer, complete the following steps:
Save the changes that you made in the GenICam client.
Disconnect from the camera in the GenICam client.
In Mech-Eye Viewer’s parameter panel on the right, select the parameter group to which you want to save the parameter values.
Note
A GenICam client can read parameter groups, but not add or delete parameter groups. For instructions on adding/deleting a parameter group, please refer to Parameter Group.
Adjust Parameters with Visualized Tools¶
Below you can find instructions on setting Auto-Exposure ROI, Depth Range and ROI, respectively.
Set Auto-Exposure ROI¶
To set Auto-Exposure ROI, follow these steps:
In Mech-Eye Viewer’s parameter panel, locate the 2D Parameters category.
From the drop-down menu of Exposure Mode, select Auto.
Double-click Edit next to Auto-Exposure ROI.
You can set an auto-exposure ROI in the pop-up window. For detailed instructions, please refer to Auto-Exposure ROI.
The correspondence between parameters related to Auto-Exposure ROI of a GenICam client and Mech-Eye Viewer is as follows:
Parameter in GenICam Client |
Parameter in Mech-Eye Viewer |
Scan2DROILeft |
Upper-left coordinates - x |
Scan2DROITop |
Upper-left coordinates - y |
Scan2DROIHeight |
Dimensions - Height |
Scan2DROIWidth |
Dimensions - Width |
Set Depth Range¶
To set Depth Range, follow these steps:
In Mech-Eye Viewer’s parameter panel, locate the Depth Range category.
Double-click Edit next to Depth Range.
You can set the depth range in the pop-up window. For detailed instructions, please refer to Depth Range.
The correspondence between parameters related to Depth Range of a GenICam client and Mech-Eye Viewer is as follows:
Parameter in GenICam Client
Parameter in Mech-Eye Viewer
DepthLowerLimit
Depth Range - Depth Lower Limit
DepthUpperLimit
Depth Range - Depth Upper Limit
Set ROI¶
To set ROI, follow these steps:
In Mech-Eye Viewer’s parameter panel, locate the ROI category.
Double-click Edit next to ROI.
You can set an ROI in the pop-up window. For detailed instructions, please refer to ROI.
The correspondence between parameters related to ROI of a GenICam client and Mech-Eye Viewer is as follows:
Parameter in GenICam Client
Parameter in Mech-Eye Viewer
Scan3DROILeft
Upper-left coordinates - x
Scan3DROITop
Upper-left coordinates - y
Scan3DROIHeight
Dimensions - Height
Scan3DROIWidth
Dimensions - Width
Read Altered Values into GenICam Client¶
After setting Auto-Exposure ROI, Depth Range and ROI in Mech-Eye Viewer, complete the following steps to ensure that the GenICam client can read the modified parameter values:
In Mech-Eye Viewer, click Save in the Prameter Group category or press Ctrl+S on the keyboard to save the configuration changes into the parameter group.
Disconnect from the camera in Mech-Eye Viewer.
Connect to the camera in the GenICam client.
In the GenICam client, select and read the configuration of the parameter group.