This website is being translated through machine translation by a third-party service. Basler does not warrant the accuracy, reliability or timeliness of any information translated by this system and will not accept liability for loss or damage incurred as a result. Content that has not yet been translated appears in English. Switch to English version
Parameter names may not apply to your camera model.
To display appropriate parameter names, select a camera model:
a2A1280-125umSWIR
a2A1280-80gmSWIR
a2A1920-160ucBAS
a2A1920-160ucPRO
a2A1920-160umBAS
a2A1920-160umPRO
a2A1920-165g5cBAS
a2A1920-165g5mBAS
a2A1920-51gcBAS
a2A1920-51gcPRO
a2A1920-51gmBAS
a2A1920-51gmPRO
a2A2048-110umSWIR
a2A2048-35gmSWIR
a2A2440-98g5cBAS
a2A2440-98g5mBAS
a2A2448-105g5cBAS
a2A2448-105g5mBAS
a2A2448-120cc
a2A2448-120cm
a2A2448-210cc
a2A2448-210cm
a2A2448-23gcBAS
a2A2448-23gcPRO
a2A2448-23gmBAS
a2A2448-23gmPRO
a2A2448-75ucBAS
a2A2448-75ucPRO
a2A2448-75umBAS
a2A2448-75umPRO
a2A2560-20gmSWIR
a2A2560-70umSWIR
a2A2590-22gcBAS
a2A2590-22gcPRO
a2A2590-22gmBAS
a2A2590-22gmPRO
a2A2590-60ucBAS
a2A2590-60ucPRO
a2A2590-60umBAS
a2A2590-60umPRO
a2A2600-20gcBAS
a2A2600-20gcPRO
a2A2600-20gmBAS
a2A2600-20gmPRO
a2A2600-64ucBAS
a2A2600-64ucPRO
a2A2600-64umBAS
a2A2600-64umPRO
a2A2840-14gcBAS
a2A2840-14gcPRO
a2A2840-14gmBAS
a2A2840-14gmPRO
a2A2840-14gmUV
a2A2840-48ucBAS
a2A2840-48ucPRO
a2A2840-48umBAS
a2A2840-48umPRO
a2A2840-48umUV
a2A2840-67g5cBAS
a2A2840-67g5mBAS
a2A2840-67g5mUV
a2A2840-86cc
a2A2840-86cm
a2A3840-13gcBAS
a2A3840-13gcPRO
a2A3840-13gmBAS
a2A3840-13gmPRO
a2A3840-45ucBAS
a2A3840-45ucPRO
a2A3840-45umBAS
a2A3840-45umPRO
a2A4096-30ucBAS
a2A4096-30ucPRO
a2A4096-30umBAS
a2A4096-30umPRO
a2A4096-44g5cBAS
a2A4096-44g5mBAS
a2A4096-67cc
a2A4096-67cm
a2A4096-9gcBAS
a2A4096-9gcPRO
a2A4096-9gmBAS
a2A4096-9gmPRO
a2A4200-12gcBAS
a2A4200-12gcPRO
a2A4200-12gmBAS
a2A4200-12gmPRO
a2A4200-40ucBAS
a2A4200-40ucPRO
a2A4200-40umBAS
a2A4200-40umPRO
a2A4504-18ucBAS
a2A4504-18ucPRO
a2A4504-18umBAS
a2A4504-18umPRO
a2A4504-27g5cBAS
a2A4504-27g5mBAS
a2A4504-42cc
a2A4504-42cm
a2A4504-5gcBAS
a2A4504-5gcPRO
a2A4504-5gmBAS
a2A4504-5gmPRO
a2A4508-20ucBAS
a2A4508-20ucPRO
a2A4508-20umBAS
a2A4508-20umPRO
a2A4508-6gcBAS
a2A4508-6gcPRO
a2A4508-6gmBAS
a2A4508-6gmPRO
a2A5320-23ucBAS
a2A5320-23ucPRO
a2A5320-23umBAS
a2A5320-23umPRO
a2A5320-34g5cBAS
a2A5320-34g5mBAS
a2A5320-52cc
a2A5320-52cm
a2A5320-7gcBAS
a2A5320-7gcPRO
a2A5320-7gmBAS
a2A5320-7gmPRO
a2A5328-15ucBAS
a2A5328-15ucPRO
a2A5328-15umBAS
a2A5328-15umPRO
a2A5328-22g5cBAS
a2A5328-22g5mBAS
a2A5328-35cc
a2A5328-35cm
a2A5328-4gcBAS
a2A5328-4gcPRO
a2A5328-4gmBAS
a2A5328-4gmPRO
a2A640-240gmSWIR
a2A640-240umSWIR
acA1280-60gc
acA1280-60gm
acA1300-200uc
acA1300-200um
acA1300-60gc
acA1300-60gm
acA1300-60gmNIR
acA1300-75gc
acA1300-75gm
acA1440-220uc
acA1440-220um
acA1440-73gc
acA1440-73gm
acA1600-20gc
acA1600-20uc
acA1600-60gc
acA1600-60gm
acA1920-150uc
acA1920-150um
acA1920-155uc
acA1920-155ucMED
acA1920-155um
acA1920-155umMED
acA1920-25gc
acA1920-25gm
acA1920-25uc
acA1920-25um
acA1920-40gc
acA1920-40gm
acA1920-40uc
acA1920-40ucMED
acA1920-40um
acA1920-40umMED
acA1920-48gc
acA1920-48gm
acA1920-50gc
acA1920-50gm
acA2000-165uc
acA2000-165um
acA2000-50gc
acA2000-50gm
acA2040-120uc
acA2040-120um
acA2040-25gc
acA2040-25gm
acA2040-25gmNIR
acA2040-35gc
acA2040-35gm
acA2040-55uc
acA2040-55um
acA2040-90uc
acA2040-90um
acA2040-90umNIR
acA2440-20gc
acA2440-20gm
acA2440-35uc
acA2440-35ucMED
acA2440-35um
acA2440-35umMED
acA2440-75uc
acA2440-75ucMED
acA2440-75um
acA2440-75umMED
acA2500-14gc
acA2500-14gm
acA2500-14uc
acA2500-14um
acA2500-20gc
acA2500-20gcMED
acA2500-20gm
acA2500-20gmMED
acA2500-60uc
acA2500-60um
acA3088-16gc
acA3088-16gm
acA3088-57uc
acA3088-57ucMED
acA3088-57um
acA3088-57umMED
acA3800-10gc
acA3800-10gm
acA3800-14uc
acA3800-14um
acA4024-29uc
acA4024-29um
acA4024-8gc
acA4024-8gm
acA4096-11gc
acA4096-11gm
acA4096-30uc
acA4096-30ucMED
acA4096-30um
acA4096-30umMED
acA4096-40uc
acA4096-40ucMED
acA4096-40um
acA4096-40umMED
acA4112-20uc
acA4112-20ucMED
acA4112-20um
acA4112-20umMED
acA4112-30uc
acA4112-30ucMED
acA4112-30um
acA4112-30umMED
acA4112-8gc
acA4112-8gm
acA5472-17uc
acA5472-17ucMED
acA5472-17um
acA5472-17umMED
acA5472-5gc
acA5472-5gm
acA640-121gm
acA640-300gc
acA640-300gm
acA640-750uc
acA640-750um
acA720-290gc
acA720-290gm
acA720-520uc
acA720-520um
acA800-200gc
acA800-200gm
acA800-510uc
acA800-510um
blaze-101
blaze-102
boA13440-17cm
boA1936-400cc
boA1936-400cm
boA2448-250cc
boA2448-250cm
boA2832-190cc
boA2832-190cm
boA4096-180cc
boA4096-180cm
boA4096-93cc
boA4096-93cm
boA4112-68cc
boA4112-68cm
boA4500-45cc
boA4500-45cm
boA4504-100cc
boA4504-100cm
boA5120-150cc
boA5120-150cm
boA5120-230cc
boA5120-230cm
boA5320-150cc
boA5320-150cm
boA5328-100cc
boA5328-100cm
boA6500-36cc
boA6500-36cm
boA8100-16cc
boA8100-16cm
boA9344-30cc
boA9344-30cm
boA9344-70cc
boA9344-70cm
daA1280-54uc
daA1280-54um
daA1440-220uc
daA1440-220um
daA1600-60uc
daA1600-60um
daA1920-15um
daA1920-160uc
daA1920-160um
daA1920-30uc
daA1920-30um
daA2448-70uc
daA2448-70um
daA2500-14uc
daA2500-14um
daA2500-60mc
daA2500-60mci
daA3840-30mc
daA3840-45uc
daA3840-45um
daA4200-30mci
daA720-520uc
daA720-520um
dmA1440-73gc
dmA1440-73gm
dmA1920-51gc
dmA1920-51gm
dmA720-290gc
dmA720-290gm
puA1280-54uc
puA1280-54um
puA1600-60uc
puA1600-60um
puA1920-30uc
puA1920-30um
puA2500-14uc
puA2500-14um
r2L16384-120cm
r2L2048-172cm
r2L2048-172g5m
r2L2048-29gc
r2L2048-58gm
r2L2048-62cc
r2L2048-62g5c
r2L4096-14gc
r2L4096-29gm
r2L4096-42cc
r2L4096-42g5c
r2L4096-84cm
r2L4096-84g5m
r2L8192-200cm
The information in this topic does not apply to your camera model.
The Color Transformation camera feature allows you to correct the color information delivered by the sensor.
Using a color transformation matrix, the feature can correct color shifts caused by the light source used during image acquisition as well as compensate for imperfections in the sensor's color generation process.
Info
You should only use this feature if you are thoroughly familiar with matrix color transformations. It is nearly impossible to enter correct values in the transformation matrix by trial and error.
Make sure the white balance is configured appropriately.
Set the ProcessedRawEnable parameter to true (if available and if you're using a Bayer pixel format).
Set the LightSourceSelector parameter to Custom (if available).
Set the ColorTransformationValueSelector parameter to the desired position in the matrix, e.g., Gain00.
Enter the desired value for the ColorTransformationValue parameter to adjust the value at the selected position. The parameter's value range is -8.0 to +7.96875.
Info
The transformation matrix is already populated with color transformation values. They are related to previously selected light source presets, correspond to unit vectors, or result from a previous use of the color transformation feature.
ColorTransformationMatrixFactor Parameter
This parameter, which is only available on ace Classic/U/L cameras with GigE interface, determines the extent to which the color matrix influences the color values. If set to 0, the matrix is effectively disabled. Basler recommends leaving it at the default setting (1).
The color transformation feature uses a transformation matrix to deliver modified red, green, and blue pixel data for each pixel.
The transformation is performed by premultiplying a 3 x 1 matrix containing R, G, and B pixel values by a 3 x 3 matrix containing the color transformation values:
You can set each matrix value (Gain00, Gain01, etc.) according to your requirements.
// Select position Gain00 in the matrixcamera.ColorTransformationValueSelector.SetValue(ColorTransformationValueSelector_Gain00);// Enter a floating point value for the selected positioncamera.ColorTransformationValue.SetValue(1.5625);// Select position Gain01 in the matrixcamera.ColorTransformationValueSelector.SetValue(ColorTransformationValueSelector_Gain01);// Enter a floating point value for the selected positioncamera.ColorTransformationValue.SetValue(-0.4375);
INodeMap&nodemap=camera.GetNodeMap();// Select position Gain00 in the matrixCEnumParameter(nodemap,"ColorTransformationValueSelector").SetValue("Gain00");// Enter a floating point value for the selected positionCFloatParameter(nodemap,"ColorTransformationValue").SetValue(1.5625);// Select position Gain01 in the matrixCEnumParameter(nodemap,"ColorTransformationValueSelector").SetValue("Gain01");// Enter a floating point value for the selected positionCFloatParameter(nodemap,"ColorTransformationValue").SetValue(-0.4375);
// Select position Gain00 in the matrixcamera.Parameters[PLCamera.ColorTransformationValueSelector].SetValue(PLCamera.ColorTransformationValueSelector.Gain00);// Enter a floating point value for the selected positioncamera.Parameters[PLCamera.ColorTransformationValue].SetValue(1.5625);// Select position Gain01 in the matrixcamera.Parameters[PLCamera.ColorTransformationValueSelector].SetValue(PLCamera.ColorTransformationValueSelector.Gain01);// Enter a floating point value for the selected positioncamera.Parameters[PLCamera.ColorTransformationValue].SetValue(-0.4375);
/* Macro to check for errors */#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)GENAPIC_RESULTerrRes=GENAPI_E_OK;/* Return value of pylon methods *//* Select position Gain00 in the matrix */errRes=PylonDeviceFeatureFromString(hdev,"ColorTransformationValueSelector","Gain00");CHECK(errRes);/* Enter a floating point value for the selected position */errRes=PylonDeviceSetFloatFeature(hdev,"ColorTransformationValue",1.5625);CHECK(errRes);/* Select position Gain01 in the matrix */errRes=PylonDeviceFeatureFromString(hdev,"ColorTransformationValueSelector","Gain01");CHECK(errRes);/* Enter a floating point value for the selected position */errRes=PylonDeviceSetFloatFeature(hdev,"ColorTransformationValue",-0.4375);CHECK(errRes);
# Select position Gain00 in the matrixcamera.ColorTransformationValueSelector.Value="Gain00"# Enter a floating point value for the selected positioncamera.ColorTransformationValue.Value=1.5625# Select position Gain01 in the matrixcamera.ColorTransformationValueSelector.Value="Gain01"# Enter a floating point value for the selected positioncamera.ColorTransformationValue.Value=-0.4375