BCON for MIPI Features#
General Information#
Because BCON for MIPI cameras are developed specifically for embedded vision applications and hardware, some of their features are implemented slightly differently than on other Basler cameras. These features are described in this topic.
For features where the implementation is identical, see the Features section.
Auto Function Profile#
If available, this feature allows you to specify how gain and exposure time are balanced when the camera is making automatic adjustments.
Basic Functionality#
Regardless of the profile you choose, if both Exposure Auto and Gain Auto are enabled, BCON for MIPI cameras with the Auto Function Profile feature always balance gain and exposure time like this:
- While keeping gain as low as possible, the camera adjusts the exposure time up to a certain limit to achieve a target brightness value.
- If the target brightness value can't be reached, the camera adjusts the gain up to a certain limit.
- If the target brightness value still can't be reached, the camera adjusts the exposure time again, up to a maximum limit.
- If the target brightness value still can't be reached, the camera adjusts the gain again, up to a maximum limit.
Flicker Reduction#
By choosing an auto function profile, you can also reduce flickering.
If the camera is operating in an environment where the lighting flickers at a 50-Hz or a 60-Hz rate, the flickering light can cause significant changes in brightness from image to image. Enabling an anti-flicker profile may reduce the effect of the flickering in the captured images.
To configure flicker reduction:
- Set the Gain Auto auto function and the Exposure Auto auto function to
Continuous
. - Set the
AutoFunctionProfile
parameter to one of the following values:AntiFlicker50Hz
: Enables flicker reduction for a power line frequency of 50 Hz (applies to, e.g., Europe).AntiFlicker60Hz
: Enables flicker reduction for a power line frequency of 60 Hz (applies to, e.g., North America).AntiFlickerAuto
: Enables flicker reduction with automatic power line frequency detection.AntiFlickerOff
: Disables flicker reduction.
Gain/Exposure Auto#
If available, this feature automatically adjusts gain and exposure time. These settings are always adjusted together.
To adjust gain or exposure time manually, use the Gain and Exposure Time features.
To enable or disable Gain/Exposure Auto, set either the GainAuto
parameter or the ExposureAuto
parameter to one of the following operating modes:
Continuous
: The camera adjusts gain and exposure time continuously while images are being acquired.
If you set theGainAuto
parameter toContinuous
, theExposureAuto
parameter is automatically set toContinuous
as well, and vice versa.Off
: Disables the auto function. Gain and exposure time remain at the values resulting from the last automatic adjustment.
If you set theGainAuto
parameter toOff
, theExposureAuto
parameter is automatically set toOff
as well, and vice versa.
Info
When the camera is capturing images continuously, the auto function takes effect with a short delay. The first few images may not be affected by the auto function.
Scaling#
If available, this feature scales images from sensor size to the size of the image ROI.
For example, assume your camera sensor has a resolution of 2592 x 1944 pixels. Also assume you set the image ROI to 640 x 480 pixels. Now, if you enable scaling, images will be downscaled from 2592 x 1944 to 640 x 480 pixels.
If the aspect ratio of the image ROI doesn't match the aspect ratio of the sensor, output images will be cropped to avoid distortion. For example, assume the aspect ratio of the sensor is 4:3 (e.g., 2592 x 1944 pixels). Also assume you set the image ROI to 500 x 300 pixels. Keeping an aspect ratio of 4:3 would require a resolution of 500 x 375. Therefore, to avoid distortion, the camera crops 75 pixels from the width.
To enable scaling, set the BslScalingEnable
parameter to true
.
Sharpness Enhancement#
If available, this feature increases the sharpness of the images. The higher the sharpness, the more distinct the contours of the image objects will be. This is especially useful in applications where cameras must correctly identify numbers or letters.
To specify the desired level of sharpness, set the BslSharpnessEnhancement
parameter to a value between 0 and 1.0. The higher the parameter value, the more sharpening is applied.
Specifics#
Camera Model | Available BCON for MIPI Features |
---|---|
a2A1920-51gcBAS | BCON for MIPI features not supported |
a2A1920-51gcPRO | BCON for MIPI features not supported |
a2A1920-51gmBAS | BCON for MIPI features not supported |
a2A1920-51gmPRO | BCON for MIPI features not supported |
a2A1920-160ucBAS | BCON for MIPI features not supported |
a2A1920-160ucPRO | BCON for MIPI features not supported |
a2A1920-160umBAS | BCON for MIPI features not supported |
a2A1920-160umPRO | BCON for MIPI features not supported |
a2A2590-22gcBAS | BCON for MIPI features not supported |
a2A2590-22gcPRO | BCON for MIPI features not supported |
a2A2590-22gmBAS | BCON for MIPI features not supported |
a2A2590-22gmPRO | BCON for MIPI features not supported |
a2A2590-60ucBAS | BCON for MIPI features not supported |
a2A2590-60ucPRO | BCON for MIPI features not supported |
a2A2590-60umBAS | BCON for MIPI features not supported |
a2A2590-60umPRO | BCON for MIPI features not supported |
a2A3840-13gcBAS | BCON for MIPI features not supported |
a2A3840-13gcPRO | BCON for MIPI features not supported |
a2A3840-13gmBAS | BCON for MIPI features not supported |
a2A3840-13gmPRO | BCON for MIPI features not supported |
a2A3840-45ucBAS | BCON for MIPI features not supported |
a2A3840-45ucPRO | BCON for MIPI features not supported |
a2A3840-45umBAS | BCON for MIPI features not supported |
a2A3840-45umPRO | BCON for MIPI features not supported |
acA640-90gc | BCON for MIPI features not supported |
acA640-90gm | BCON for MIPI features not supported |
acA640-90uc | BCON for MIPI features not supported |
acA640-90um | BCON for MIPI features not supported |
acA640-120gc | BCON for MIPI features not supported |
acA640-120gm | BCON for MIPI features not supported |
acA640-120uc | BCON for MIPI features not supported |
acA640-120um | BCON for MIPI features not supported |
acA640-121gm | BCON for MIPI features not supported |
acA640-300gc | BCON for MIPI features not supported |
acA640-300gm | BCON for MIPI features not supported |
acA640-750uc | BCON for MIPI features not supported |
acA640-750um | BCON for MIPI features not supported |
acA720-290gc | BCON for MIPI features not supported |
acA720-290gm | BCON for MIPI features not supported |
acA720-520uc | BCON for MIPI features not supported |
acA720-520um | BCON for MIPI features not supported |
acA780-75gc | BCON for MIPI features not supported |
acA780-75gm | BCON for MIPI features not supported |
acA800-200gc | BCON for MIPI features not supported |
acA800-200gm | BCON for MIPI features not supported |
acA800-510uc | BCON for MIPI features not supported |
acA800-510um | BCON for MIPI features not supported |
acA1280-60gc | BCON for MIPI features not supported |
acA1280-60gm | BCON for MIPI features not supported |
acA1300-22gc | BCON for MIPI features not supported |
acA1300-22gm | BCON for MIPI features not supported |
acA1300-30gc | BCON for MIPI features not supported |
acA1300-30gm | BCON for MIPI features not supported |
acA1300-30uc | BCON for MIPI features not supported |
acA1300-30um | BCON for MIPI features not supported |
acA1300-60gc | BCON for MIPI features not supported |
acA1300-60gm | BCON for MIPI features not supported |
acA1300-60gmNIR | BCON for MIPI features not supported |
acA1300-75gc | BCON for MIPI features not supported |
acA1300-75gm | BCON for MIPI features not supported |
acA1300-200uc | BCON for MIPI features not supported |
acA1300-200um | BCON for MIPI features not supported |
acA1440-73gc | BCON for MIPI features not supported |
acA1440-73gm | BCON for MIPI features not supported |
acA1440-220uc | BCON for MIPI features not supported |
acA1440-220um | BCON for MIPI features not supported |
acA1600-20gc | BCON for MIPI features not supported |
acA1600-20gm | BCON for MIPI features not supported |
acA1600-20uc | BCON for MIPI features not supported |
acA1600-20um | BCON for MIPI features not supported |
acA1600-60gc | BCON for MIPI features not supported |
acA1600-60gm | BCON for MIPI features not supported |
acA1920-25gc | BCON for MIPI features not supported |
acA1920-25gm | BCON for MIPI features not supported |
acA1920-25uc | BCON for MIPI features not supported |
acA1920-25um | BCON for MIPI features not supported |
acA1920-40gc | BCON for MIPI features not supported |
acA1920-40gm | BCON for MIPI features not supported |
acA1920-40uc | BCON for MIPI features not supported |
acA1920-40ucMED | BCON for MIPI features not supported |
acA1920-40um | BCON for MIPI features not supported |
acA1920-40umMED | BCON for MIPI features not supported |
acA1920-48gc | BCON for MIPI features not supported |
acA1920-48gm | BCON for MIPI features not supported |
acA1920-50gc | BCON for MIPI features not supported |
acA1920-50gm | BCON for MIPI features not supported |
acA1920-150uc | BCON for MIPI features not supported |
acA1920-150um | BCON for MIPI features not supported |
acA1920-155uc | BCON for MIPI features not supported |
acA1920-155ucMED | BCON for MIPI features not supported |
acA1920-155um | BCON for MIPI features not supported |
acA1920-155umMED | BCON for MIPI features not supported |
acA2000-50gc | BCON for MIPI features not supported |
acA2000-50gm | BCON for MIPI features not supported |
acA2000-50gmNIR | BCON for MIPI features not supported |
acA2000-165uc | BCON for MIPI features not supported |
acA2000-165um | BCON for MIPI features not supported |
acA2000-165umNIR | BCON for MIPI features not supported |
acA2040-25gc | BCON for MIPI features not supported |
acA2040-25gm | BCON for MIPI features not supported |
acA2040-25gmNIR | BCON for MIPI features not supported |
acA2040-35gc | BCON for MIPI features not supported |
acA2040-35gm | BCON for MIPI features not supported |
acA2040-55uc | BCON for MIPI features not supported |
acA2040-55um | BCON for MIPI features not supported |
acA2040-90uc | BCON for MIPI features not supported |
acA2040-90um | BCON for MIPI features not supported |
acA2040-90umNIR | BCON for MIPI features not supported |
acA2040-120uc | BCON for MIPI features not supported |
acA2040-120um | BCON for MIPI features not supported |
acA2440-20gc | BCON for MIPI features not supported |
acA2440-20gm | BCON for MIPI features not supported |
acA2440-35uc | BCON for MIPI features not supported |
acA2440-35ucMED | BCON for MIPI features not supported |
acA2440-35um | BCON for MIPI features not supported |
acA2440-35umMED | BCON for MIPI features not supported |
acA2440-75uc | BCON for MIPI features not supported |
acA2440-75ucMED | BCON for MIPI features not supported |
acA2440-75um | BCON for MIPI features not supported |
acA2440-75umMED | BCON for MIPI features not supported |
acA2500-14gc | BCON for MIPI features not supported |
acA2500-14gm | BCON for MIPI features not supported |
acA2500-14uc | BCON for MIPI features not supported |
acA2500-14um | BCON for MIPI features not supported |
acA2500-20gc | BCON for MIPI features not supported |
acA2500-20gcMED | BCON for MIPI features not supported |
acA2500-20gm | BCON for MIPI features not supported |
acA2500-20gmMED | BCON for MIPI features not supported |
acA2500-60uc | BCON for MIPI features not supported |
acA2500-60um | BCON for MIPI features not supported |
acA3088-16gc | BCON for MIPI features not supported |
acA3088-16gm | BCON for MIPI features not supported |
acA3088-57uc | BCON for MIPI features not supported |
acA3088-57um | BCON for MIPI features not supported |
acA3800-10gc | BCON for MIPI features not supported |
acA3800-10gm | BCON for MIPI features not supported |
acA3800-14uc | BCON for MIPI features not supported |
acA3800-14um | BCON for MIPI features not supported |
acA4024-8gc | BCON for MIPI features not supported |
acA4024-8gm | BCON for MIPI features not supported |
acA4024-29uc | BCON for MIPI features not supported |
acA4024-29um | BCON for MIPI features not supported |
acA4096-11gc | BCON for MIPI features not supported |
acA4096-11gm | BCON for MIPI features not supported |
acA4096-30uc | BCON for MIPI features not supported |
acA4096-30ucMED | BCON for MIPI features not supported |
acA4096-30um | BCON for MIPI features not supported |
acA4096-30umMED | BCON for MIPI features not supported |
acA4096-40uc | BCON for MIPI features not supported |
acA4096-40ucMED | BCON for MIPI features not supported |
acA4096-40um | BCON for MIPI features not supported |
acA4096-40umMED | BCON for MIPI features not supported |
acA4112-8gc | BCON for MIPI features not supported |
acA4112-8gm | BCON for MIPI features not supported |
acA4112-20uc | BCON for MIPI features not supported |
acA4112-20ucMED | BCON for MIPI features not supported |
acA4112-20um | BCON for MIPI features not supported |
acA4112-20umMED | BCON for MIPI features not supported |
acA4112-30uc | BCON for MIPI features not supported |
acA4112-30ucMED | BCON for MIPI features not supported |
acA4112-30um | BCON for MIPI features not supported |
acA4112-30umMED | BCON for MIPI features not supported |
acA4600-7gc | BCON for MIPI features not supported |
acA4600-10uc | BCON for MIPI features not supported |
acA5472-5gc | BCON for MIPI features not supported |
acA5472-5gm | BCON for MIPI features not supported |
acA5472-17uc | BCON for MIPI features not supported |
acA5472-17ucMED | BCON for MIPI features not supported |
acA5472-17um | BCON for MIPI features not supported |
blaze-101 | BCON for MIPI feature not supported |
boA4096-93cc | BCON for MIPI features not supported |
boA4096-93cm | BCON for MIPI features not supported |
boA4112-68cc | BCON for MIPI features not supported |
boA4112-68cm | BCON for MIPI features not supported |
daA1280-54lc | BCON for MIPI features not supported |
daA1280-54lm | BCON for MIPI features not supported |
daA1280-54uc | BCON for MIPI features not supported |
daA1280-54um | BCON for MIPI features not supported |
daA1600-60lc | BCON for MIPI features not supported |
daA1600-60lm | BCON for MIPI features not supported |
daA1600-60uc | BCON for MIPI features not supported |
daA1600-60um | BCON for MIPI features not supported |
daA1920-15um | BCON for MIPI features not supported |
daA1920-30uc | BCON for MIPI Features not supported |
daA1920-30um | BCON for MIPI features not supported |
daA1920-160uc | BCON for MIPI features not supported |
daA1920-160um | BCON for MIPI features not supported |
daA2500-14lc | BCON for MIPI features not supported |
daA2500-14lm | BCON for MIPI features not supported |
daA2500-14uc | BCON for MIPI features not supported |
daA2500-14um | BCON for MIPI features not supported |
daA2500-60mc | Gain/Exposure Auto |
daA2500-60mci | Auto Function Profile Scaling Sharpness Enhancement |
daA4200-30mci | Auto Function Profile Scaling Sharpness Enhancement |
puA1280-54uc | BCON for MIPI features not supported |
puA1280-54um | BCON for MIPI features not supported |
puA1600-60uc | BCON for MIPI features not supported |
puA1600-60um | BCON for MIPI features not supported |
puA1920-30uc | BCON for MIPI features not supported |
puA1920-30um | BCON for MIPI features not supported |
puA2500-14uc | BCON for MIPI features not supported |
puA2500-14um | BCON for MIPI features not supported |
Sample Code#
// ** Gain/Exposure Auto **
// Enable Gain/Exposure Auto
camera.GainAuto.SetValue(GainAuto_Continuous);
// This also enables Gain/Exposure Auto
camera.ExposureAuto.SetValue(ExposureAuto_Continuous);
// ** Scaling **
camera.BslScalingEnable.SetValue(true);
// ** Sharpness Enhancement **
camera.BslSharpnessEnhancement.SetValue(0.5);
INodeMap& nodemap = camera.GetNodeMap();
// ** Gain/Exposure Auto **
// Enable Gain/Exposure Auto
CEnumerationPtr(nodemap.GetNode("GainAuto"))->FromString("Continuous");
// This also enables Gain/Exposure Auto
CEnumerationPtr(nodemap.GetNode("ExposureAuto"))->FromString("Continuous");
// ** Scaling **
CBooleanPtr(nodemap.GetNode("BslScalingEnable"))->SetValue(true);
// ** Sharpness Enhancement **
CFloatPtr(nodemap.GetNode("BslSharpnessEnhancement"))->SetValue(0.5);
INodeMap& nodemap = camera.GetNodeMap();
// ** Gain/Exposure Auto **
// Enable Gain/Exposure Auto
CEnumParameter(nodemap, "GainAuto").SetValue("Continuous");
// This also enables Gain/Exposure Auto
CEnumParameter(nodemap, "ExposureAuto").SetValue("Continuous");
// ** Scaling **
CBooleanParameter(nodemap, "BslScalingEnable").SetValue(true);
// ** Sharpness Enhancement **
CFloatParameter(nodemap, "BslSharpnessEnhancement").SetValue(0.5);
// ** Gain/Exposure Auto **
// Enable Gain/Exposure Auto
camera.Parameters[PLCamera.GainAuto].SetValue(PLCamera.GainAuto.Continuous);
// This also enables Gain/Exposure Auto
camera.Parameters[PLCamera.ExposureAuto].SetValue(PLCamera.ExposureAuto.Continuous);
// ** Scaling **
camera.Parameters[PLCamera.BslScalingEnable].SetValue(true);
// ** Sharpness Enhancement **
camera.Parameters[PLCamera.BslSharpnessEnhancement].SetValue(0.5);
// ** Gain/Exposure Auto **
// Enable Gain/Exposure Auto
Pylon.DeviceFeatureFromString(hdev, "GainAuto", "Continuous");
// This also enables Gain/Exposure Auto
Pylon.DeviceFeatureFromString(hdev, "ExposureAuto", "Continuous");
// ** Scaling **
Pylon.DeviceSetBooleanFeature(hdev, "BslScalingEnable", true);
// ** Sharpness Enhancement **
Pylon.DeviceSetFloatFeature(hdev, "BslSharpnessEnhancement", 0.5);
/* 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 */
/* ** Gain/Exposure Auto ** */
/* Enable Gain/Exposure Auto */
errRes = PylonDeviceFeatureFromString(hdev, "GainAuto", "Continuous");
CHECK(errRes);
/* This also enables Gain/Exposure Auto */
errRes = PylonDeviceFeatureFromString(hdev, "ExposureAuto", "Continuous");
CHECK(errRes);
/* ** Scaling ** */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslScalingEnable", 1);
CHECK(errRes);
/* ** Sharpness Enhancement ** */
errRes = PylonDeviceSetFloatFeature(hdev, "BslSharpnessEnhancement", 0.5);
CHECK(errRes);