mvBlueCOUGAR related camera settings (Device specific interface layout only). More...

#include <mvIMPACT_acquire.h>

Inheritance diagram for CameraSettingsBlueCOUGAR:

Public Member Functions
	CameraSettingsBlueCOUGAR (Device *pDev, const std::string &settingName="Base")
	Constructs a new mvIMPACT::acquire::CameraSettingsBlueCOUGAR object.

AutoControlParameters &	getAutoControlParameters (void)
	Provides access to the control parameters for AGC and AEC.

HDRControl &	getHDRControl (void)
	Returns the mvIMPACT::acquire::HDRControl object associated with this setting.

unsigned int	getTriggerControlCount (void) const
	Returns the number of mvIMPACT::acquire::TriggerControls available for this device.

HOBJ	hObj (void) const
	Returns a unique identifier for the component collection referenced by this object.

const ComponentCollection &	restoreDefault (void) const
	Restores the default for every component of this collection.

const TriggerControl *	triggerControl (const std::string &name) const
	Returns a const pointer to a mvIMPACT::acquire::TriggerControl object or NULL if the name passed to the function does not specify a valid trigger control.

const TriggerControl *	triggerControl (unsigned int nr) const
	Returns a const pointer to a mvIMPACT::acquire::TriggerControl object.

virtual	~CameraSettingsBlueCOUGAR ()

Public Attributes
PropertyI64	acquisitionBurstFrameCount
	A 64-bit integer property defining the number of frames to acquire for each FrameBurstStart trigger.

PropertyI	aoiHeight
	An integer property defining the number of lines to capture.

PropertyI	aoiStartX
	An integer property defining the X-offset for each capture line.

PropertyI	aoiStartY
	An integer property defining the Y-offset.

PropertyI	aoiWidth
	An integer property defining the number of pixels to capture per line.

PropertyIAutoControlMode	autoControlMode
	An enumerated integer property defining the auto control mode the device is operated in.

AutoControlParameters	autoControlParameters
	Provides access to the control parameters for AGC and AEC.

PropertyIAutoExposureControl	autoExposeControl
	An enumerated integer property, which represents the current mode the AEC (A utomatic E xpose C ontrol) is operated in.

PropertyIAutoGainControl	autoGainControl
	An enumerated integer property, which represents the current mode the AGC (A utomatic G ain C ontrol) is operated in.

PropertyS	basedOn
	A string property (read-only) containing the name of the setting this setting is based on.

PropertyICameraBinningMode	binningMode
	An enumerated integer property defining the binning mode the camera is operated in.

PropertyI	expose_us
	An integer property which defines the exposure time for an image in us.

PropertyICameraExposeMode	exposeMode
	An enumerated integer property defining the exposure mode the camera sensor is operated in.

PropertyI	frameDelay_us
	An integer property defining the delay in us between an external trigger event an the begin of the sensor exposure.

PropertyF	frameRate_Hz
	A float property defining the frame rate (in Hz) this device shall use to transfer images.

PropertyF	gain_dB
	A float property defining the gain in dB.

PropertyI	imageRequestTimeout_ms
	An integer property defining the maximum time to wait for an image in ms.

PropertyF	offset_pc
	A float property defining the analogue sensor offset in percent of the allowed range (sensor specific).

PropertyIBoolean	partialScanMode
	An enumerated integer property defining whether partial scan mode shall be used or not.

PropertyICameraPixelClock	pixelClock_KHz
	An enumerated integer property defining the pixel clock of the camera sensor in KHz.

PropertyIImageBufferPixelFormat	pixelFormat
	An enumerated integer property defining the pixel format used to transfer the image data into the target systems host memory.

PropertyICameraTestMode	testMode
	An enumerated integer property defining the image transmission mode of the camera.

PropertyIDeviceTriggerInterface	triggerInterface
	An enumerated integer property defining which view of the trigger interface to use.

PropertyICameraTriggerMode	triggerMode
	An enumerated integer property which defines what kind of trigger mode shall be used for an image acquisition.

PropertyICameraTriggerSource	triggerSource
	An enumerated integer property defining where the trigger signal is expected to occur.

Protected Attributes
HOBJ	m_hRoot

Detailed Description

mvBlueCOUGAR related camera settings (Device specific interface layout only).

This class contains properties to control the way the image sensor(s) of the mvBlueCOUGAR behaves.

Note: This class will only be available if mvIMPACT::acquire::Device::interfaceLayout is set to mvIMPACT::acquire::dilDeviceSpecific before the device is opened.

Examples: SingleCaptureMasterSlave.cpp, and SingleCaptureMasterSlave.legacy.cpp.

Constructor & Destructor Documentation

◆ CameraSettingsBlueCOUGAR()

CameraSettingsBlueCOUGAR	(	Device *	pDev,
		const std::string &	settingName = "Base" )

inlineexplicit

Constructs a new mvIMPACT::acquire::CameraSettingsBlueCOUGAR object.

Parameters

[in]	pDev	A pointer to a mvIMPACT::acquire::Device object obtained from a mvIMPACT::acquire::DeviceManager object.
[in]	settingName	The name of the driver internal setting to access with this instance. A list of valid setting names can be obtained by a call to mvIMPACT::acquire::FunctionInterface::getAvailableSettings, new settings can be created with the function mvIMPACT::acquire::FunctionInterface::createSetting

◆ ~CameraSettingsBlueCOUGAR()

virtual ~CameraSettingsBlueCOUGAR ( )

inlinevirtual

Member Function Documentation

◆ getAutoControlParameters()

AutoControlParameters & getAutoControlParameters ( void )

inlineinherited

Provides access to the control parameters for AGC and AEC.

Note: These settings will only affect the image if mvIMPACT::acquire::CameraSettingsBlueDevice::autoGainControl, mvIMPACT::acquire::CameraSettingsBlueDevice::autoExposeControl or both are set to active.

◆ getHDRControl()

HDRControl & getHDRControl ( void )

inline

Returns the mvIMPACT::acquire::HDRControl object associated with this setting.

◆ getTriggerControlCount()

unsigned int getTriggerControlCount ( void ) const

inline

Returns the number of mvIMPACT::acquire::TriggerControls available for this device.

This might be 0 if the device either does not support this feature.

◆ hObj()

HOBJ hObj ( void ) const

inlineinherited

Returns a unique identifier for the component collection referenced by this object.

This handle will always reference an object of type mvIMPACT::acquire::ComponentList.

Returns: A unique identifier for the component referenced by this object.

◆ restoreDefault()

const ComponentCollection & restoreDefault ( void ) const

inlineinherited

Restores the default for every component of this collection.

Calling this function will restore the default value for every component belonging to this collection.

Note: The caller must have the right to modify the component. Otherwise an exception will be thrown.

Returns: A const reference to the component.

◆ triggerControl() [1/2]

const TriggerControl * triggerControl ( const std::string & name ) const

inline

Returns a const pointer to a mvIMPACT::acquire::TriggerControl object or NULL if the name passed to the function does not specify a valid trigger control.

Parameters

[in] name The name of the trigger control

◆ triggerControl() [2/2]

const TriggerControl * triggerControl ( unsigned int nr ) const

inline

Returns a const pointer to a mvIMPACT::acquire::TriggerControl object.

If nr references an invalid pin an STL out_of_range exception will be thrown.

Note: The features of each mvIMPACT::acquire::TriggerControl will only be visible and thus available, when mvIMPACT::acquire::CameraSettingsBlueCOUGAR::triggerInterface is set to mvIMPACT::acquire::dtiAdvanced.

Parameters

[in] nr The number of the trigger control

Member Data Documentation

◆ acquisitionBurstFrameCount

PropertyI64 acquisitionBurstFrameCount

A 64-bit integer property defining the number of frames to acquire for each FrameBurstStart trigger.

Note: This feature will only be taken into account if the FrameBurstStart trigger is active when mvIMPACT::acquire::CameraSettingsBlueCOUGAR::triggerInterface is set to mvIMPACT::acquire::dtiAdvanced.

◆ aoiHeight

PropertyI aoiHeight

inherited

An integer property defining the number of lines to capture.

◆ aoiStartX

PropertyI aoiStartX

inherited

An integer property defining the X-offset for each capture line.

Example: When setting this property to 5 the first pixel in each line of the resulting image will be pixel number 5 of each line transmitted by the camera.

◆ aoiStartY

PropertyI aoiStartY

inherited

An integer property defining the Y-offset.

Example: When setting this property to 5 the first line of the resulting image will be line number 5 of the image transmitted by the camera.

◆ aoiWidth

PropertyI aoiWidth

inherited

An integer property defining the number of pixels to capture per line.

◆ autoControlMode

PropertyIAutoControlMode autoControlMode

inherited

An enumerated integer property defining the auto control mode the device is operated in.

This property can be used to control the overall behaviour of the algorithms used for performing AEC (A utomatic E xpose C ontrol) or AGC (A utomatic G ain C ontrol). This could be done by the device itself thus e.g. even in the analog domain or e.g. by a software process in the driver. Each method will offer certain advantages and disadvantages and depending on the application the correct method can be selected.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TAutoControlMode.

Every device or even different models belonging to the same device family may support different auto control modes, thus it's crucial to query the valid modes for each device by reading the properties translation dictionary BEFORE trying to assign a certain value to this property.

◆ autoControlParameters

AutoControlParameters autoControlParameters

inherited

Provides access to the control parameters for AGC and AEC.

Note: These settings will only affect the image if mvIMPACT::acquire::CameraSettingsBlueDevice::autoGainControl, mvIMPACT::acquire::CameraSettingsBlueDevice::autoExposeControl or both are set to active.

◆ autoExposeControl

PropertyIAutoExposureControl autoExposeControl

inherited

An enumerated integer property, which represents the current mode the AEC (A utomatic E xpose C ontrol) is operated in.

The values used to capture the image, which are directly influenced by an activated AGC or AEC (e.g. the gain or the exposure time) will be returned as part of the result of the image request.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TAutoExposureControl.

Note: This property might not be supported by every device. Therefore always call the function mvIMPACT::acquire::Component::isValid to check if this property is available or not.

◆ autoGainControl

PropertyIAutoGainControl autoGainControl

inherited

An enumerated integer property, which represents the current mode the AGC (A utomatic G ain C ontrol) is operated in.

The values used to capture the image, which are directly influenced by an activated AGC or AEC (e.g. the gain or the exposure time) will be returned as part of the result of the image request.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TAutoGainControl.

Note: This property is not supported by every device. Therefore always call the function mvIMPACT::acquire::Component::isValid to check if this property is available or not.

◆ basedOn

PropertyS basedOn

inherited

A string property (read-only) containing the name of the setting this setting is based on.

Since: 1.12.67

◆ binningMode

PropertyICameraBinningMode binningMode

inherited

An enumerated integer property defining the binning mode the camera is operated in.

By default the no binning will be performed.

Note: Not every camera will support every binning mode. To find out which binning modes are supported by your camera you can query the properties translation table with the functions mvIMPACT::acquire::PropertyICameraBinningMode::getTranslationDictString and mvIMPACT::acquire::PropertyICameraBinningMode::getTranslationDictValue C++ offers the more efficient function mvIMPACT::acquire::PropertyICameraBinningMode::getTranslationDict in addition to the functions mentioned above.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TCameraBinningMode.

◆ expose_us

PropertyI expose_us

inherited

An integer property which defines the exposure time for an image in us.

◆ exposeMode

PropertyICameraExposeMode exposeMode

inherited

An enumerated integer property defining the exposure mode the camera sensor is operated in.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TCameraExposeMode.

Note: Not every device will offer the same options. Check for valid modes by reading the properties translation dictionary with the functions mvIMPACT::acquire::PropertyICameraExposeMode::getTranslationDictString and mvIMPACT::acquire::PropertyICameraExposeMode::getTranslationDictValue. C++ offers the more efficient function mvIMPACT::acquire::PropertyICameraExposeMode::getTranslationDict in addition to the functions mentioned above.

◆ frameDelay_us

PropertyI frameDelay_us

inherited

An integer property defining the delay in us between an external trigger event an the begin of the sensor exposure.

Note: This property is not supported by every device. Therefore always call the function mvIMPACT::acquire::Component::isValid to check if this property is available or not.

◆ frameRate_Hz

PropertyF frameRate_Hz

A float property defining the frame rate (in Hz) this device shall use to transfer images.

Depending on other parameters the desired frame rate might not be achievable (e.g. if the exposure time is higher than the frame period. In that case the device will automatically reduce the frame rate.

Note: This property is not supported by every device. Therefore always call the function mvIMPACT::acquire::Component::isValid to check if this property is available or not.

◆ gain_dB

PropertyF gain_dB

inherited

A float property defining the gain in dB.

The formula for given gain_dB is

gain_x= 10 ^ (gain_dB/20)

mvIMPACT::acquire::CameraSettingsBlueDevice::gain_dB

PropertyF gain_dB

A float property defining the gain in dB.

Definition mvIMPACT_acquire.h:19665

Example:

gain_x = 10 ^ (6/20) = 1.995

I.e. increasing the gain setting by 6dB corresponds to factor of 2.

The formula for given gain_x is

gain_dB = 20*log(gain_x) dB

Where:
gain_dB: Balluff gain value (logarithmic)
gain_x: multiplicative gain
^: power function

◆ imageRequestTimeout_ms

PropertyI imageRequestTimeout_ms

inherited

An integer property defining the maximum time to wait for an image in ms.

Attention: Since Impact Acquire 2.32.0 the default value for this property has been changed! See Calling 'imageRequestWaitFor' Never Returns / An Application No Longer Terminates After Upgrading To Impact Acquire 2.32.0 Or Greater for details.

When this property is set to 0 the timeout never elapses. If the timeout this property defines elapses the currently processed request will be returned to the user even if no data has been captured so far. The result structure of the request object should be examined in that case. Also this should be considered as an error from the users point of view in which case he should clean up the acquisition queue by calling mvIMPACT::acquire::FunctionInterface::imageRequestReset. Afterwards the capture loop can be restarted.

Note: It is crucial to understand that this is a timeout PER REQUEST! The timespan taken into account for the measurement starts when the driver begins to capture data into this particular buffer! So when queuing 4 buffers with a timeout of 3000 ms each and no data being transmitted by the device for any reason will cause the last buffer to time out 3000*4 = 12000 ms AFTER the buffer has been queued and the acquisition has been started as the driver will wait for up to 3 seconds for each buffer that is being processed. When the device sends data this timeout does not affect the runtime behaviour at all. No additional delay is introduced by it when everything runs as planned.

◆ m_hRoot

HOBJ m_hRoot

protectedinherited

◆ offset_pc

PropertyF offset_pc

inherited

A float property defining the analogue sensor offset in percent of the allowed range (sensor specific).

This property influences the average grey level when no light reaches the sensor. mvBlueFOX specific: Changing its value will have no effect if mvIMPACT::acquire::CameraSettingsBlueFOX::offsetAutoCalibration is set to mvIMPACT::acquire::aocOn.

By default this value will be around 10 (if mvIMPACT::acquire::CameraSettingsBlueFOX::offsetAutoCalibration if set to mvIMPACT::acquire::aocOn). This means the average grey value for an image taken in a completely dark environment will be around 10. When setting mvIMPACT::acquire::CameraSettingsBlueFOX::offsetAutoCalibration to mvIMPACT::acquire::aocOff mvIMPACT::acquire::CameraSettingsBlueFOX::offset_pc can be used to modify this value.

The valid range for this property lies between -100% and +100%, whereas negative values will shifts the black level towards 0 and positive values to 255.

Note: This property might not be supported by every device. Therefore always call the function mvIMPACT::acquire::Component::isValid to check if this property is available or not.

◆ partialScanMode

PropertyIBoolean partialScanMode

An enumerated integer property defining whether partial scan mode shall be used or not.

This property currently is only available for mvBlueCOUGAR-S devices. When partial scan mode is active, the frame rate can no longer be controlled be the property mvIMPACT::acquire::CameraSettingsBlueCOUGAR::frameRate_Hz. The device will always transmit frames as fast as possible instead.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TBoolean.

◆ pixelClock_KHz

PropertyICameraPixelClock pixelClock_KHz

inherited

An enumerated integer property defining the pixel clock of the camera sensor in KHz.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TCameraPixelClock.

Note: Changing the pixel clock at runtime will have major impact on the overall behaviour of the camera. The pixel clock should therefore not be modified constantly during the execution of the application code. Whenever this property is changed, the next images captured should be skipped if a device works with an active auto offset calibration controller circuit as then the control circuits on the camera might need one to three images until all control loops are locked again.

Every device or even different models belonging to the same device family may support different pixel clocks, thus it's crucial to query the valid clock modes for each sensor by reading the properties translation dictionary.

◆ pixelFormat

PropertyIImageBufferPixelFormat pixelFormat

inherited

An enumerated integer property defining the pixel format used to transfer the image data into the target systems host memory.

Support for this property has been added in version 1.11.0 of Impact Acquire thus old driver versions will raise an exception if an application accesses the property without checking if the property is present.

By default this property will be set to mvIMPACT::acquire::ibpfAuto. This will result in the previous driver behaviour where depending on the various post processing steps that are enabled or disabled the driver will decide which transfer format will be used. However sometimes this could result in a transfer format, which is not ideal for the application (e.g. when a post processing step of the application needs RGBx888Packed but the systems bandwidth is limited the application might want to transfer the data in YUV422 packed and then use the fast format conversion algorithm in the driver). This can be achieved by explicitly setting mvIMPACT::acquire::CameraSettingsBase::pixelFormat to mvIMPACT::acquire::ibpfYUV422Packed and mvIMPACT::acquire::ImageDestination::pixelFormat to mvIMPACT::acquire::ibpfRGBx888Packed.

Note: Selecting a defined transfer format can in some cases result in certain filters (e.g. dark current, ...) to be switched of as then the filters themselves can no longer influence the transfer format, which is sometimes necessary as not every filter does support every input format. Also this property will contain only pixel formats, which are actually supported by the capture device, thus in most of the cases this will be a subset of the pixel formats defined by the enumeration defining this property.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TImageBufferPixelFormat.

◆ testMode

PropertyICameraTestMode testMode

inherited

An enumerated integer property defining the image transmission mode of the camera.

If this property is set to mvIMPACT::acquire::ctmOff the 'normal' image captured by the cameras sensor will be transmitted. This is the default. To ensure correct operation the camera might define several test modes where some kind of well defined pattern will be transmitted.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TCameraTestMode. No every test mode will be supported by every device.

◆ triggerInterface

PropertyIDeviceTriggerInterface triggerInterface

An enumerated integer property defining which view of the trigger interface to use.

This property mainly switches the visibility of trigger the different trigger interfaces. After applying changes to this property all trigger related features might have a different visibility. However the documentation will state what features are available in which mode.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TDeviceTriggerInterface.

◆ triggerMode

PropertyICameraTriggerMode triggerMode

inherited

An enumerated integer property which defines what kind of trigger mode shall be used for an image acquisition.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TCameraTriggerMode.

Note: Not every device will support every trigger mode. To find out which trigger modes are supported by a specific device at runtime the properties translation dictionary should be queried.; Also the sensor specific part of this manual will contain a list of trigger modes that are available for this specific image sensor.

◆ triggerSource

PropertyICameraTriggerSource triggerSource

An enumerated integer property defining where the trigger signal is expected to occur.

When working with hardware generated signals via mvIMPACT::acquire::RTCtrProgram objects this property should be set to mvIMPACT::acquire::ctsRTCtrl as otherwise the program will not affect the behaviour of the camera.

Valid values for this property are defined by the enumeration mvIMPACT::acquire::TCameraTriggerSource.

Note: This feature will only be visible and thus available, when mvIMPACT::acquire::CameraSettingsBlueCOUGAR::triggerInterface is set to mvIMPACT::acquire::dtiStandard.

Public Member Functions

Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CameraSettingsBlueCOUGAR()

◆ ~CameraSettingsBlueCOUGAR()

Member Function Documentation

◆ getAutoControlParameters()

◆ getHDRControl()

◆ getTriggerControlCount()

◆ hObj()

◆ restoreDefault()

◆ triggerControl() [1/2]

◆ triggerControl() [2/2]

Member Data Documentation

◆ acquisitionBurstFrameCount

◆ aoiHeight

◆ aoiStartX

◆ aoiStartY

◆ aoiWidth

◆ autoControlMode

◆ autoControlParameters

◆ autoExposeControl

◆ autoGainControl

◆ basedOn

◆ binningMode

◆ expose_us

◆ exposeMode

◆ frameDelay_us

◆ frameRate_Hz

◆ gain_dB

◆ imageRequestTimeout_ms

◆ m_hRoot

◆ offset_pc

◆ partialScanMode

◆ pixelClock_KHz

◆ pixelFormat

◆ testMode

◆ triggerInterface

◆ triggerMode

◆ triggerSource