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.
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 |
a2A3840-13gcBAS | BCON for MIPI features not supported |
a2A3840-13gmBAS | BCON for MIPI features not supported |
a2A3840-45ucBAS | BCON for MIPI features not supported |
a2A3840-45umBAS | 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-17um | BCON for MIPI features 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 |
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 | Scaling Sharpness Enhancement |
daA4200-30mci | 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);