Configuring the Camera
BASLER L304
kc 4-13
Draft
Setting the Absolute Red Gain
If you set the red gain by writing a value to the Absolute Red Gain field of the Red Gain CSR, you
can write a floating point value from -6.00 to +20.00 (decimal) in increments of 0.01. Writing a
floating point value to the absolute register sets the red gain directly in dB. For example, if the
absolute red gain field is set to 13.42, then the camera would be set for 13.42 dB of red gain.
Guidelines
When you are working with a parameter that can be set as either raw or absolute, there are two
important things to keep in mind:
• You do not need to set both the raw field and the absolute field. Setting just one of the fields
is sufficient and you can choose to set whichever field best suits your needs.
• If you are setting a parameter by writing to the absolute field, the value in the absolute field
must be the equivalent of entering a value in the raw field. Lets use the red gain parameter
again as an example.
Using the formula from the previous page, we can calculate the dB of red gain that the camera
would produce for three different settings in the raw red gain field of the red gain CSR:
This means that if you are writing a value to the absolute field, a value of 1.38, 1.41, or 1.44
would be “valid” because they are the equivalent of writing 300, 301, or 302 to the raw field.
Writing a value of 1.42 in the absolute field, for example, would not be valid because it is not
the equivalent of any value you could write in the raw field.
So what happens if you write an “invalid” value to the absolute field? This is not really a
problem because the camera will automatically change the value you entered to the nearest
valid value. For example, if you write 1.42 to the raw red gain field, the camera will
automatically change the value to 1.41.
Because the camera automatically changes any entry in an absolute field to the nearest “valid”
value, you do not need to worry about making sure that the values you write to the absolute
field are the equivalent of writing a value to the raw field. But you do need to be aware that
when you write a value to an absolute field, the camera may make a small change to the value
to make it “valid.” If you read back a value in an absolute field, you may find that it is slightly
different from the value that you wrote to the field.
Note: This description of setting the red gain assumes that the gain lock feature is disabled.
When the gain lock feature is enabled, the range of settings available for the red gain may be
restricted (see Section 3.6.2).
Raw Red Gain
Value Setting
Resulting
Red Gain
300 1.38 dB
301 1.41 dB
302 1.44 dB