AW00118508000 Features
Basler racer Camera Link 129
Creating a "Usershading" File for Offset Shading Correction
The generation of a "usershading" file requires a certain minimum number of line acquisitions.
Higher line rates require larger numbers of line acquisitions to reach the minimum number.
When the minimum number is reached, the "usershading" file is automatically created. It is stored
in the camera’s non-volatile memory and is not lost if the camera power is switched off.
The Create value and the value of the Offset Shading Create register (see below) change to Off
when the minimum number of line acquisitions is reached.
Hint: To ease acquisition of the required number of lines Basler recommends to set the line start
trigger mode to Off for automatic line start triggering.
Example: At a line acquisition rate of 100 Hz or less, a new "usershading" file will generally have
been generated by the time approximately 2300 line acquisitions have occurred.
1. Adjust the optics, line rate, exposure time control mode, exposure time, gain, and camera tem-
perature as you would for normal operation.
2. Make sure Exposure Auto and Gain Auto are disabled.
3. Prevent light from striking the camera’s sensor: Cover the camera lens, close the iris in the
camera lens, or darken the room so that the camera will be capturing lines in complete
darkness.
4. Set the camera’s OffsetX and Width parameters so that the entire width of the sensor will be
used during line acquisition.
Note: You can create a "usershading" file for an AOI that is narrower than the entire width of
the sensor. In this case, however, the "usershading" file will only apply to the narrower AOI or
to smaller included AOIs. Basler recommends using the entire width of the sensor.
5. If you use Basler pylon, select Offset Shading in the Basler pylon Viewer or via the Basler
pylon API.
6. If you use Basler pylon, select the "usershading" file in the Basler pylon Viewer or via the
Basler pylon API.
If you use direct register access, set the value of the Offset Shading Set Selector register to the
desired user set, e.g. User Shading Set 1.
7. If you use Basler pylon, go to the Create enumeration in the Basler pylon Viewer and select
Once or send a create command via the Basler pylon API.
Creating a "usershading" file for offset shading correction will overwrite any
"usershading" file for offset shading correction that is already in the camera’s
memory.
If you want to preserve the previous "usershading" file save it to your computer
before creating the new "usershading" file.
For information about saving a "usershading" file to the computer, see
Section 8.9.3.2 on page 132.
To create a "usershading" file for offset shading correction: