XEMA Camera Parameter Tuning Guide
About 4729 wordsAbout 16 min
This document uses PickWiz to explain the software connection, configuration, accuracy correction, and imaging parameter tuning procedures for XEMA cameras.
First, connect the camera to power and the network. For hardware installation, see the XEMA Series Camera Hardware Installation Manual. For models and specifications, see Available Cameras and Product Information.
1. Connect the Camera
Before you begin, confirm that the camera is connected to power and the network, and that PickWiz is running.
1.1 Open the Camera Page
On the PickWiz main screen, open the “Camera” panel to access the camera connection page.

1.2 Search for a XEMA Camera
On the camera connection page, select “XEMA” as the camera brand and click “Refresh.” The software scans the current network for discoverable XEMA cameras and displays their IP addresses and connection status.

Find the camera you want to use in the search results, verify its IP address, and connect to it.

1.3 Connect by IP Address
If the camera cannot be found through a search, or if you need to connect to a specific device, enter the camera IP address in the IP address field and click “Connect Camera.”
1.4 Select the Camera for the Current Task
After the camera connects successfully, go to the “Task Information” page and select the connected XEMA camera in the camera selection field for the current task.

1.5 Confirm the Connection Status
After selecting the camera, check its connection status in the status bar. You can open the camera configuration page to capture images and tune parameters only after the status shows “Connected.”
Caution
If the status does not show “Connected,” check the camera power supply, network cable connection, computer network configuration, and IP address before searching for or connecting to the camera again.
2. Camera Configuration
A camera configuration stores a set of capture and imaging parameters. After connecting the camera, you can first select a default configuration to check the imaging results. If you need to adjust parameters, copy the default configuration and edit the new configuration.
2.1 Select a Camera Configuration
On the “Camera” page, find the connected XEMA camera, expand the configuration dropdown list, and select a default configuration suitable for the current target.
Default configurations cannot be modified. If you need to adjust their parameters, first copy a configuration as described in Section 2.2.
Click “Trigger Capture” to capture an image with the selected configuration. After acquisition is complete, switch among “2D Image,” “Point Cloud,” and “Depth Image” in the visualization window to check the imaging results.

2.2 Copy and Edit a Configuration
- On the camera page, select the default configuration you want to copy.
- Click “+” beside the configuration list to create an editable configuration based on the current one.

- Select the new configuration from the configuration dropdown list.

- Click the settings button beside the configuration list to open the parameter configuration screen.

- Adjust the parameters based on the imaging results for the target, then trigger another capture to check the results. See Chapter 4 for specific parameter tuning methods.
- After tuning the parameters, select this camera and the configuration you want to use on the “Task Information” page for the current task.
2.3 Save Acquisition Results
After capturing an image, click “Save Image” to save the current 2D image, Point Cloud, and Depth Image to the local computer.

Images are saved under config/camera/image/拍摄时间 in the project folder, where 拍摄时间 is the capture-time folder. You can check the software log for the actual save location.
| File extension | Saved content |
|---|---|
.bmp | 2D image |
.ply | Point Cloud |
.tiff | Depth Image |

2.4 View Camera Intrinsic Parameters
On the camera page, click “View Intrinsic Parameters” to view information about the current camera’s intrinsic parameters, including lens focal length, principal point coordinates, and distortion coefficients.

2.5 Disconnect the Camera
When you need to switch devices, click “Disconnect” on the camera page. After disconnecting the current camera, select the camera you want to connect. See Chapter 1 for the connection steps.

2.6 Import a Camera Configuration
To use an existing configuration file, open the parameter configuration screen for an editable configuration, click “Import Camera Configuration,” and select and import the existing camera configuration file.
New camera configuration files use the *.json format. You can find the corresponding configuration file under config/camera/CamewraParam/对应相机型号 in the project folder, where 对应相机型号 is the camera-model folder. The folder contains default configuration files. The default configuration files cannot be modified; if changes are needed, copy one and edit the new configuration.
After importing, check the parameters in the configuration and trigger a capture to confirm the imaging results.
2.7 Delete a New Configuration
In the configuration list on the camera page, select the new configuration you want to delete and click “—” beside the list.

2.8 Capture Images and Check Imaging Results
2.8.1 Trigger a Capture
On the camera parameter configuration screen, click “Trigger Capture” to perform one acquisition with the current configuration and view the corresponding 2D image, Point Cloud, and Depth Image.

First check the exposure of the 2D image. Then use the Point Cloud and Depth Image to determine whether the target’s surface information is complete. The following examples show underexposure, normal exposure, and overexposure.
![]() | ![]() | ![]() |
|---|---|---|
| Underexposure | Normal exposure | Overexposure |
If the default configuration does not meet the imaging requirements, copy the configuration before tuning its parameters. See Chapter 4, “Camera Parameter Tuning,” for details about the parameters.
2.8.2 Show Overexposed Areas
On the parameter configuration screen, enable “Show Overexposed Areas” to view overexposed areas of the current image in the visualization window and help determine whether the exposure is appropriate.

2.8.3 Continuous Acquisition
When you need to observe the imaging results continuously, click “Continuous Acquisition.” The camera continues capturing images and updating the acquisition results in the visualization window. When you have finished observing, click “Cancel Acquisition” to stop capturing images.
3. Camera Accuracy
On the parameter configuration screen, click “Camera Accuracy” to open the page for viewing and correcting accuracy. See Chapter 3, “Camera Accuracy,” for calibration board preparation, accuracy verification, and correction steps.
3.1 View Camera Accuracy
- Place the Calibration Board within the camera’s field of view and click
Camera Accuracyon the camera configuration screen. The Camera Accuracy screen appears, as shown below.

- Select the corresponding Calibration Board. If the selected board does not match the actual board, a “Please check the Calibration Board type” warning dialog appears, as shown below. Selecting the A3 Calibration Board type causes the warning dialog to appear.


- After selecting the correct Calibration Board type, click
View Camera Accuracy. PickWiz automatically calculates the current camera accuracy. If the accuracy meets the requirements, proceed directly to adjusting the camera imaging parameters. If the camera accuracy error is too large, a dialog displays “The error is too large. Camera accuracy correction is recommended.”

For each camera series, camera accuracy <Xmm indicates that the accuracy meets the requirements.
XEMA-D:0.2mm
XEMA-S:0.2mm
XEMA-L:0.5mm
3.2 Correct Camera Accuracy
During actual camera use, and after Extrinsic Parameter correction, verify whether the camera’s current accuracy meets the requirements.
View the camera accuracy. If the camera accuracy error is abnormal, correct the camera accuracy.
If the Point Cloud captured by the current camera has large fluctuations, correct the camera accuracy.
Before correcting camera accuracy, enable
Show Overexposed Areasto check the exposure of the camera image. If there are overexposed areas, adjust the single exposure time to ensure that the camera image is exposed normally.After correction is complete, switch the camera imaging parameters back to the original configuration.

Click
Camera Accuracyon the camera configuration screen.Select the corresponding Calibration Board. If the selected board does not match the actual board, a “Please check the Calibration Board type” warning dialog appears, as shown below. Selecting the A3 Calibration Board type causes the warning dialog to appear.


- After selecting the correct Calibration Board type, click
Correct Camera Accuracy.

- Place the Calibration Board horizontally in the center of the camera’s field of view and click
Add Sample. The camera begins collecting and validating the sample. If the collected sample passes validation, it is added underCollected Samples, as shown below.


Click Sample x to view a collected sample. For a sample that passes validation, the centers of all concentric circles on the Calibration Board turn green.

- Move the Calibration Board to each of the 4 corners of the camera’s field of view and add samples.
![]() | ![]() | ![]() | ![]() |
|---|
Raise the Calibration Board at an angle in each corner. Position it at 15-30°; the tilt angle must be neither too large nor too small.
- After adding 5 samples, click
Calculate Correction Result.

- After correction is complete, a dialog appears stating, “Camera accuracy correction is complete. The corrected accuracy is x, and the error is normal. Overwrite the current camera parameter configuration?”

If you choose to overwrite the current camera parameter configuration, the camera accuracy correction result is updated to the camera. The camera must be restarted for the change to take effect.

4. Camera Parameter Tuning
This chapter recommends tuning parameters in the following order: imaging first, then the Point Cloud, and finally the overlay output. Adjust only one parameter at a time. After triggering a capture, check the 2D image, Point Cloud, and Depth Image together. Continue to the next parameter only after confirming a stable improvement.
5. Troubleshooting
If the camera cannot connect, image capture fails, or imaging is abnormal, first check the camera power supply, network, and IP address. Then see Camera Issues and Solutions.






