Skip to content

Light Source Preset#

The Light Source Preset camera feature allows you to correct color shifts caused by certain light sources.

Depending on its specific color temperature, the light used for image acquisition can cause color shifts in the image. You can correct these color shifts by selecting the related light source preset.

Using the Feature#

Selecting a Light Source Preset#

To select a light source preset:

  1. Set the pixel format to one of the supported pixel formats.
  2. Set the LightSourcePreset parameter to one of the following values (if available):
    • Off: No light source preset is selected.
    • Daylight5000K: The camera corrects color shifts caused by daylight lighting that has a color temperature of about 5 000 K.
    • Daylight6500K: The camera corrects color shifts caused by daylight lighting that has a color temperature of about 6 500 K.
    • Tungsten2800K: The camera corrects color shifts caused by tungsten lighting that has a color temperature of about 2 500 to 3 000 K.
    • MicroscopeLED4500K: The camera corrects color shifts caused by microscope LED lighting that has a color temperature of about 4 500 K.
    • MicroscopeLED5500K: The camera corrects color shifts caused by microscope LED lighting that has a color temperature of about 5 500 K.
    • MicroscopeLED6000K: The camera corrects color shifts caused by microscope LED lighting that has a color temperature of about 6 000 K.
    • Fluorescent4000K: The camera corrects color shifts caused by fluorescent lighting that has a color temperature of about 4 000 K.
    • Custom: Selecting this preset enables the Color Transformation feature which allows you to customize the light source settings. You should only select this preset if you are thoroughly familiar with matrix color transformations. The camera also adjusts the Balance White and Color Adjustment settings so that they have neutral values that do not change the appearance of the colors.

The default light source preset varies by camera model.

Impact on Other Features#

When you select a light source preset, the camera adjusts the settings of the following color enhancement features:

The settings will be optimized for the selected light source.

On some camera models, you can choose which features you want the camera to adjust.

Separate Processing#

On some camera models, when you select a light source preset, the camera processes the changes to the features listed above separately. This means that the values of the corresponding parameters visible in the pylon API and the pylon Viewer are not changed.

Example: If you select the Daylight6500K light source preset, the camera adjusts the white balance, but the values of the BalanceRatio parameter don't change.

This has the advantage that you don't lose your color enhancement feature settings when you change the light source preset. Your own settings are independent from the light source preset adjustments.

No Separate Processing#

On some camera models, when you select a light source preset, the camera doesn't process the feature changes separately. Instead, the camera directly adjusts the corresponding parameter values.

Example: If you select the Daylight6500K light source preset, the values of the BalanceRatio parameter change. You can see the changes in the pylon Viewer or by accessing the parameter via the pylon API.

This means if you set up the color enhancement features and then change the light source preset, your settings will be overwritten.

Light Source Preset Feature Selector#

On some camera models, the BslLightSourcePresetFeatureSelector parameter is available.

If the parameter is available, you can select which features you want the camera to adjust when you select a light source preset.

By default, the camera adjusts all features.

To enable or disable adjustment of a specific feature:

  1. Set the BslLightSourcePresetFeatureSelector parameter to the desired feature, e.g., ColorAdjustment.
  2. Set the BslLightSourcePresetFeatureEnable parameter to true (feature enabled) or false (feature disabled).
  3. Repeat steps 1 and 2 for all features that you want to enable or disable.

Specifics#

Show all camera models

Camera Model Pixel Formats Supported Default Light Source Preset Available Light Source Presets Separate Processing Feature Selector Available
a2A1920-51gcBAS All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Yes Yes
a2A1920-51gcPRO All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Yes Yes
a2A1920-51gmBAS Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
a2A1920-51gmPRO Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
a2A1920-160ucBAS All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Yes Yes
a2A1920-160ucPRO All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Yes Yes
a2A1920-160umBAS Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
a2A1920-160umPRO Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
a2A3840-13gcBAS All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Yes Yes
a2A3840-13gmBAS Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
a2A3840-45ucBAS All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Yes Yes
a2A3840-45umBAS Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-90gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA640-90gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-90uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA640-90um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-120gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA640-120gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-120uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA640-120um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-121gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-300gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA640-300gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA640-750uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA640-750um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA720-290gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA720-290gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA720-520uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA720-520um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA780-75gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA780-75gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA800-200gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA800-200gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA800-510uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA800-510um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1280-60gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1280-60gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-22gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1300-22gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-30gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1300-30gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-30uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1300-30um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-60gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1300-60gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-60gmNIR Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-75gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1300-75gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1300-200uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1300-200um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1440-73gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1440-73gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1440-220uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1440-220um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1600-20gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1600-20gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1600-20uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1600-20um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1600-60gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1600-60gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-25gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1920-25gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-25uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1920-25um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-40gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1920-40gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-40uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1920-40ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA1920-40um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-40umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-48gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1920-48gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-50gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA1920-50gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-150uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1920-150um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-155uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA1920-155ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA1920-155um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA1920-155umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2000-50gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA2000-50gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2000-50gmNIR Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2000-165uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2000-165um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2000-165umNIR Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-25gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA2040-25gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-25gmNIR Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-35gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA2040-35gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-55uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2040-55um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-90uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2040-90um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-90umNIR Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2040-120uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2040-120um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2440-20gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA2440-20gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2440-35uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2440-35ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA2440-35um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2440-35umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2440-75uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2440-75ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA2440-75um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2440-75umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2500-14gc All Off Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA2500-14gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2500-14uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2500-14um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2500-20gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA2500-20gcMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Custom
No No
acA2500-20gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2500-20gmMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA2500-60uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA2500-60um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA3088-16gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA3088-16gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA3088-57uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA3088-57um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA3800-10gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA3800-10gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA3800-14uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA3800-14um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4024-8gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA4024-8gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4024-29uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA4024-29um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4096-11gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA4096-11gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4096-30uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA4096-30ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA4096-30um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4096-30umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4096-40uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA4096-40ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA4096-40um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4096-40umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4112-8gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA4112-8gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4112-20uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA4112-20ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA4112-20um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4112-20umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4112-30uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA4112-30ucMED All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Microscope LED 4500 K
Microscope LED 5500 K
Microscope LED 6000 K
Tungsten 2800 K
No No
acA4112-30um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4112-30umMED Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA4600-7gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA4600-10uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA5472-5gc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten
Custom
No No
acA5472-5gm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
acA5472-17uc All Daylight 5000 K Off
Daylight 5000 K
Daylight 6500 K
Tungsten 2800 K
No No
acA5472-17um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
boA4096-93cc All Off Off
Daylight 5000 Kb
Daylight 6500 Kb
Tungstenb
Yes Yes
boA4096-93cm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
boA4112-68cc All Off Off
Daylight 5000 Kb
Daylight 6500 Kb
Tungstenb
Yes Yes
boA4112-68cm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA1280-54lc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA1280-54lm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA1280-54uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA1280-54um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA1600-60lc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA1600-60lm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA1600-60uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA1600-60um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA1920-15um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA1920-30uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA1920-30um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA2500-14lc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA2500-14lm Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA2500-14uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
daA2500-14um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA2500-60mc All Daylight 5000 K Daylight 5000 K
Daylight 6500 K
Fluorescent 4000 K
Tungsten 2800 K
No No
daA2500-60mci Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
daA4200-30mci Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
puA1280-54uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
puA1280-54um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported
puA1600-60uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
puA1600-60um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
puA1920-30uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
puA1920-30um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No
puA2500-14uc YCbCr422
RGB 8
Daylight 5000 K Off
Daylight 5000 Ka
Daylight 6500 Ka
Tungsten 2800 Ka
No No
puA2500-14um Light Source Preset feature not supported Light Source Preset feature not supported Light Source Preset feature not supported No No

  1. If the Balance White Auto auto function is set to Off, you must reset the white balance before changing the light source preset. To do so, set the BalanceRatio parameter value for all color channels (red, green, and blue) to 1.

  2. Valid when an IR cut filter is used which passes the range from 400–700 nm of the visible light.

Sample Code#

ace 2 and boost Cameras#

// Disable light source presets (no correction)
camera.BslLightSourcePreset.SetValue(BslLightSourcePreset_Off);
// Set the light source preset for daylight (at about 5000K)
camera.BslLightSourcePreset.SetValue(BslLightSourcePreset_Daylight5000K);
// Set the light source preset for tungsten lighting
camera.BslLightSourcePreset.SetValue(BslLightSourcePreset_Tungsten2800K);
// Disable adjustment of a specific feature
camera.BslLightSourcePresetFeatureSelector.SetValue(BslLightSourcePresetFeatureSelector_ColorAdjustment);
camera.BslLightSourcePresetFeatureEnable.SetValue(false);
INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumerationPtr(nodemap.GetNode("BslLightSourcePreset"))->FromString("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumerationPtr(nodemap.GetNode("BslLightSourcePreset"))->FromString("Daylight5000K");
// Set the light source preset for tungsten lighting
CEnumerationPtr(nodemap.GetNode("BslLightSourcePreset"))->FromString("Tungsten2800K");
// Disable adjustment of a specific feature
CEnumerationPtr(nodemap.GetNode("BslLightSourcePresetFeatureSelector"))->FromString("ColorAdjustment");
CBooleanPtr(nodemap.GetNode("BslLightSourcePresetFeatureEnable"))->SetValue(false);
INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumParameter(nodemap, "BslLightSourcePreset").SetValue("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumParameter(nodemap, "BslLightSourcePreset").SetValue("Daylight5000K");
// Set the light source preset for tungsten lighting
CEnumParameter(nodemap, "BslLightSourcePreset").SetValue("Tungsten2800K");
// Disable adjustment of a specific feature
CEnumParameter(nodemap, "BslLightSourcePresetFeatureSelector").SetValue("ColorAdjustment");
CBooleanParameter(nodemap, "BslLightSourcePresetFeatureEnable").SetValue(false);
// Disable light source presets (no correction)
camera.Parameters[PLCamera.BslLightSourcePreset].SetValue(PLCamera.BslLightSourcePreset.Off);
// Set the light source preset for daylight (at about 5000K)
camera.Parameters[PLCamera.BslLightSourcePreset].SetValue(PLCamera.BslLightSourcePreset.Daylight5000K);
// Set the light source preset for tungsten lighting
camera.Parameters[PLCamera.BslLightSourcePreset].SetValue(PLCamera.BslLightSourcePreset.Tungsten2800K);
// Disable adjustment of a specific feature
camera.Parameters[PLCamera.BslLightSourcePresetFeatureSelector].SetValue(PLCamera.BslLightSourcePresetFeatureSelector.ColorAdjustment);
camera.Parameters[PLCamera.BslLightSourcePresetFeatureEnable].SetValue(false);
// Disable light source presets (no correction)
Pylon.DeviceFeatureFromString(hdev, "BslLightSourcePreset", "Off");
// Set the light source preset for daylight (at about 5000K)
Pylon.DeviceFeatureFromString(hdev, "BslLightSourcePreset", "Daylight5000K");
// Set the light source preset for tungsten lighting
Pylon.DeviceFeatureFromString(hdev, "BslLightSourcePreset", "Tungsten2800K");
// Disable adjustment of a specific feature
Pylon.DeviceFeatureFromString(hdev, "BslLightSourcePresetFeatureSelector", "ColorAdjustment");
Pylon.DeviceSetBooleanFeature(hdev, "BslLightSourcePresetFeatureEnable", false);
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Disable light source presets (no correction) */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePreset", "Off");
CHECK(errRes);
/* Set the light source preset for daylight (at about 5000K) */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePreset", "Daylight5000K");
CHECK(errRes);
/* Set the light source preset for tungsten lighting */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePreset", "Tungsten2800K");
CHECK(errRes);
/* Disable adjustment of a specific feature */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePresetFeatureSelector", "ColorAdjustment");
CHECK(errRes);
errRes = PylonDeviceSetBooleanFeature(hdev, "BslLightSourcePresetFeatureEnable", 0);
CHECK(errRes);

ace classic/U/L GigE Cameras#

// Disable light source presets (no correction)
camera.LightSourceSelector.SetValue(LightSourceSelector_Off);
// Set the light source preset for daylight (at about 5000K)
camera.LightSourceSelector.SetValue(LightSourceSelector_Daylight);
// Set the light source preset for tungsten lighting
camera.LightSourceSelector.SetValue(LightSourceSelector_Tungsten);
INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumerationPtr(nodemap.GetNode("LightSourceSelector"))->FromString("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumerationPtr(nodemap.GetNode("LightSourceSelector"))->FromString("Daylight");
// Set the light source preset for tungsten lighting
CEnumerationPtr(nodemap.GetNode("LightSourceSelector"))->FromString("Tungsten");
INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumParameter(nodemap, "LightSourceSelector").SetValue("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumParameter(nodemap, "LightSourceSelector").SetValue("Daylight");
// Set the light source preset for tungsten lighting
CEnumParameter(nodemap, "LightSourceSelector").SetValue("Tungsten");
// Disable light source presets (no correction)
camera.Parameters[PLCamera.LightSourceSelector].SetValue(PLCamera.LightSourceSelector.Off);
// Set the light source preset for daylight (at about 5000K)
camera.Parameters[PLCamera.LightSourceSelector].SetValue(PLCamera.LightSourceSelector.Daylight);
// Set the light source preset for tungsten lighting
camera.Parameters[PLCamera.LightSourceSelector].SetValue(PLCamera.LightSourceSelector.Tungsten);
// Disable light source presets (no correction)
Pylon.DeviceFeatureFromString(hdev, "LightSourceSelector", "Off");
// Set the light source preset for daylight (at about 5000K)
Pylon.DeviceFeatureFromString(hdev, "LightSourceSelector", "Daylight");
// Set the light source preset for tungsten lighting
Pylon.DeviceFeatureFromString(hdev, "LightSourceSelector", "Tungsten");
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Disable light source presets (no correction) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourceSelector", "Off");
CHECK(errRes);
/* Set the light source preset for daylight (at about 5000K) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourceSelector", "Daylight");
CHECK(errRes);
/* Set the light source preset for tungsten lighting */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourceSelector", "Tungsten");
CHECK(errRes);

Other Cameras#

// Disable light source presets (no correction)
camera.LightSourcePreset.SetValue(LightSourcePreset_Off);
// Set the light source preset for daylight (at about 5000K)
camera.LightSourcePreset.SetValue(LightSourcePreset_Daylight5000K);
// Set the light source preset for tungsten lighting
camera.LightSourcePreset.SetValue(LightSourcePreset_Tungsten2800K);
INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumerationPtr(nodemap.GetNode("LightSourcePreset"))->FromString("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumerationPtr(nodemap.GetNode("LightSourcePreset"))->FromString("Daylight5000K");
// Set the light source preset for tungsten lighting
CEnumerationPtr(nodemap.GetNode("LightSourcePreset"))->FromString("Tungsten2800K");
INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumParameter(nodemap, "LightSourcePreset").SetValue("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumParameter(nodemap, "LightSourcePreset").SetValue("Daylight5000K");
// Set the light source preset for tungsten lighting
CEnumParameter(nodemap, "LightSourcePreset").SetValue("Tungsten2800K");
// Disable light source presets (no correction)
camera.Parameters[PLCamera.LightSourcePreset].SetValue(PLCamera.LightSourcePreset.Off);
// Set the light source preset for daylight (at about 5000K)
camera.Parameters[PLCamera.LightSourcePreset].SetValue(PLCamera.LightSourcePreset.Daylight5000K);
// Set the light source preset for tungsten lighting
camera.Parameters[PLCamera.LightSourcePreset].SetValue(PLCamera.LightSourcePreset.Tungsten2800K);
// Disable light source presets (no correction)
Pylon.DeviceFeatureFromString(hdev, "LightSourcePreset", "Off");
// Set the light source preset for daylight (at about 5000K)
Pylon.DeviceFeatureFromString(hdev, "LightSourcePreset", "Daylight5000K");
// Set the light source preset for tungsten lighting
Pylon.DeviceFeatureFromString(hdev, "LightSourcePreset", "Tungsten2800K");
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Disable light source presets (no correction) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourcePreset", "Off");
CHECK(errRes);
/* Set the light source preset for daylight (at about 5000K) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourcePreset", "Daylight5000K");
CHECK(errRes);
/* Set the light source preset for tungsten lighting */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourcePreset", "Tungsten2800K");
CHECK(errRes);

You can also use the pylon Viewer to easily set the parameters.