Light Source Preset#
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:
- Set the pixel format to one of the supported pixel formats.
- 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:
- Set the
BslLightSourcePresetFeatureSelector
parameter to the desired feature, e.g.,ColorAdjustment
. - Set the
BslLightSourcePresetFeatureEnable
parameter totrue
(feature enabled) orfalse
(feature disabled). - Repeat steps 1 and 2 for all features that you want to enable or disable.
External Links#
Specifics#
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 |
a2A2590-22gcBAS | All | Off | Off Daylight 5000 K Daylight 6500 K Tungsten | Yes | Yes |
a2A2590-22gcPRO | All | Off | Off Daylight 5000 K Daylight 6500 K Tungsten | Yes | Yes |
a2A2590-22gmBAS | Light Source Preset feature not supported | Light Source Preset feature not supported | Light Source Preset feature not supported | No | No |
a2A2590-22gmPRO | Light Source Preset feature not supported | Light Source Preset feature not supported | Light Source Preset feature not supported | No | No |
a2A2590-60ucBAS | All | Off | Off Daylight 5000 K Daylight 6500 K Tungsten | Yes | Yes |
a2A2590-60ucPRO | All | Off | Off Daylight 5000 K Daylight 6500 K Tungsten | Yes | Yes |
a2A2590-60umBAS | Light Source Preset feature not supported | Light Source Preset feature not supported | Light Source Preset feature not supported | No | No |
a2A2590-60umPRO | 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-13gcPRO | 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-13gmPRO | 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-45ucPRO | 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 |
a2A3840-45umPRO | 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 |
-
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 theBalanceRatio
parameter value for all color channels (red, green, and blue) to 1. -
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.