CameraSettingsFrameGrabber Class Reference

A class to access frame grabber related camera settings(Device specific interface layout only) (deprecated. More...

Inheritance diagram for CameraSettingsFrameGrabber:

Public Member Functions
	__init__ (self, *args, **kwargs)
	getTriggerControlCount (self)
	Returns the number of mvIMPACT.acquire.TriggerControls available for this device.
	hObj (self)
	Returns a unique identifier for the component collection referenced by this object.
	restoreDefault (self)
	Restores the default for every component of this collection.
	triggerControl (self, *args)
	Returns a const pointer to a mvIMPACT.acquire.TriggerControl object.

Properties
	acquisitionField = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_acquisitionField_get, doc=)
	An enumerated integer property defining which frame(s) of an interlaced video signal will be digitised or triggers the start of the acquisition.
	aoiHeight = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiHeight_get, doc=)
	An integer property defining the number of lines to capture.
	aoiMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_aoiMode_get, doc=)
	An enumerated integer property defining the used AOI mode for the image capture.
	aoiStartX = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiStartX_get, doc=)
	An integer property defining the X-offset for each capture line.
	aoiStartY = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiStartY_get, doc=)
	An integer property defining the Y-offset.
	aoiWidth = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiWidth_get, doc=)
	An integer property defining the number of pixels to capture per line.
	basedOn = property(lib_mvIMPACT_acquire.BasicDeviceSettings_basedOn_get, doc=)
	A string property (read-only) containing the name of the setting this setting is based on.
	contrast_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_contrast_pc_get, doc=)
	An integer property defining the contrast value to be applied to the image data by the frame grabber in per cent.
	gain_dB = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_gain_dB_get, doc=)
	A float property defining the gain in dB.
	hue_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_hue_pc_get, doc=)
	An integer property defining the hue value to be applied to the image data by the frame grabber in per cent.
	imageRequestTimeout_ms = property(lib_mvIMPACT_acquire.BasicDeviceSettings_imageRequestTimeout_ms_get, doc=)
	An integer property defining the maximum time to wait for an image in ms.
	interlacedMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_interlacedMode_get, doc=)
	An enumerated integer property defining how the image from the camera shall be captured.
	lineCounter = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_lineCounter_get, doc=)
	An enumerated integer property defining the way line counter information is handled by the device.
	luminance_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_luminance_pc_get, doc=)
	An integer property defining the luminance value to be applied to the image data by the frame grabber in per cent.
	offset_mV = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_offset_mV_get, doc=)
	An integer property defining the offset in milli-Volt.
	pixelFormat = property(lib_mvIMPACT_acquire.CameraSettingsBase_pixelFormat_get, doc=)
	An enumerated integer property defining the pixel format used to transfer the image data into the target systems host memory.
	saturation_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_saturation_pc_get, doc=)
	An integer property defining the saturation value to be applied to the image data by the frame grabber in per cent.
	scanClock = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_scanClock_get, doc=)
	An enumerated integer property defining the scan clock mode used for the current acquisition.
	scanRate_kHz = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_scanRate_kHz_get, doc=)
	An integer property defining the current scan frequency of the capture device.
	scanRateMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_scanRateMode_get, doc=)
	An enumerated integer property defining the scan rate mode for this setting.
	serialPortBaudrate = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_serialPortBaudrate_get, doc=)
	An enumerated integer property defining the baud rate of the serial communication port between frame grabber and camera.
	softwareTriggerPeriod_ms = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_softwareTriggerPeriod_ms_get, doc=)
	An integer property defining the software simulated trigger period.
	thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
	triggerControlCount = property (getTriggerControlCount, None, None, None)
	An integer property (read-only) which holds the number of mvIMPACT.acquire.TriggerControls available for this device.
	triggerMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_triggerMode_get, doc=)
	An enumerated integer property defining the behaviour of the frame grabbers trigger input.
	type = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_type_get, doc=)
	An enumerated integer property defining the camera description used for the image acquisition.

Detailed Description

A class to access frame grabber related camera settings(Device specific interface layout only) (deprecated.

Deprecated

Beginning with the release of 3.0.0 of Impact Acquire everything specifically related to frame grabber boards will be considered as deprecated and might be removed without further notice!

This class contains properties to control the way the a frame grabber behaves in connection with the connected camera.

Note

Not every frame grabber will support every property defined in this class. Please refer to the description of the individual properties and make heavy use of the function mvIMPACT.acquire.Component.isValid in order to check whether a property is available for the device.

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

Constructor & Destructor Documentation

__init__()

__init__	(		self,
		*	args,
		**	kwargs )

Member Function Documentation

getTriggerControlCount()

getTriggerControlCount

(

self

)

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 ( self )

inherited

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()

restoreDefault ( self )

inherited

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()

triggerControl	(		self,
		*	args )

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

OVERLOAD 1:

Parameters

nr	[in] The number of the trigger control

OVERLOAD 2: 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

name	[in] The name of the trigger control

Property Documentation

acquisitionField

acquisitionField = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_acquisitionField_get, doc=)

static

An enumerated integer property defining which frame(s) of an interlaced video signal will be digitised or triggers the start of the acquisition.

Valid values for this property may be: mvIMPACT.acquire.afAuto, mvIMPACT.acquire.afOdd, mvIMPACT.acquire.afEven, mvIMPACT.acquire.afAny.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

aoiHeight

aoiHeight = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiHeight_get, doc=)

staticinherited

An integer property defining the number of lines to capture.

aoiMode

aoiMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_aoiMode_get, doc=)

static

An enumerated integer property defining the used AOI mode for the image capture.

Valid values for this property may be: mvIMPACT.acquire.camFull, mvIMPACT.acquire.camUser.

aoiStartX

aoiStartX = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiStartX_get, doc=)

staticinherited

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

aoiStartY = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiStartY_get, doc=)

staticinherited

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

aoiWidth = property(lib_mvIMPACT_acquire.BasicDeviceSettingsWithAOI_aoiWidth_get, doc=)

staticinherited

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

basedOn

basedOn = property(lib_mvIMPACT_acquire.BasicDeviceSettings_basedOn_get, doc=)

staticinherited

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

Since

1.12.67

contrast_pc

contrast_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_contrast_pc_get, doc=)

static

An integer property defining the contrast value to be applied to the image data by the frame grabber in per cent.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

gain_dB

gain_dB = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_gain_dB_get, doc=)

static

A float property defining the gain in dB.

This is the gain applied during the analogue to digital conversion inside the frame grabber, not applied inside the camera.

• The formula for given gain_dB is

  gain_x= 10 ^ (gain_dB/20)

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

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

hue_pc

hue_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_hue_pc_get, doc=)

static

An integer property defining the hue value to be applied to the image data by the frame grabber in per cent.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

imageRequestTimeout_ms

imageRequestTimeout_ms = property(lib_mvIMPACT_acquire.BasicDeviceSettings_imageRequestTimeout_ms_get, doc=)

staticinherited

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.

interlacedMode

interlacedMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_interlacedMode_get, doc=)

static

An enumerated integer property defining how the image from the camera shall be captured.

If a video signal is transmitted to the capture device in an interlaced format, the device can either capture each individual frame, or merge two frames together into a complete image.

This property will be invisible when the camera description selected by the property mvIMPACT.acquire.CameraSettingsFrameGrabber.type does define it property mvIMPACT.acquire.CameraDescriptionBase.interlacedType to be mvIMPACT.acquire.citNone as the decision whether an interlaced image shall be reconstructed from frames or left as individual frame is redundant if the video source transmits full frames only.

The visibility of a property can be checked by calling mvIMPACT.acquire.Component.isVisible

Valid values for this property may be: mvIMPACT.acquire.imOn, mvIMPACT.acquire.imOff.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

lineCounter

lineCounter = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_lineCounter_get, doc=)

static

An enumerated integer property defining the way line counter information is handled by the device.

This is interesting for line scan camera applications. Valid values for this property may be: mvIMPACT.acquire.lcOff, mvIMPACT.acquire.lcOn.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

luminance_pc

luminance_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_luminance_pc_get, doc=)

static

An integer property defining the luminance value to be applied to the image data by the frame grabber in per cent.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

offset_mV

offset_mV = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_offset_mV_get, doc=)

static

An integer property defining the offset in milli-Volt.

This is the analogue offset applied during the analogue to digital conversion inside the frame grabber, not applied inside the camera.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

pixelFormat

pixelFormat = property(lib_mvIMPACT_acquire.CameraSettingsBase_pixelFormat_get, doc=)

staticinherited

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 may be: mvIMPACT.acquire.ibpfRaw, mvIMPACT.acquire.ibpfMono8, mvIMPACT.acquire.ibpfMono16, mvIMPACT.acquire.ibpfRGBx888Packed, mvIMPACT.acquire.ibpfYUV422Packed, mvIMPACT.acquire.ibpfRGBx888Planar, mvIMPACT.acquire.ibpfMono10, mvIMPACT.acquire.ibpfMono12, mvIMPACT.acquire.ibpfMono14, mvIMPACT.acquire.ibpfRGB888Packed, mvIMPACT.acquire.ibpfYUV444Planar, mvIMPACT.acquire.ibpfMono32, mvIMPACT.acquire.ibpfYUV422Planar, mvIMPACT.acquire.ibpfRGB101010Packed, mvIMPACT.acquire.ibpfRGB121212Packed, mvIMPACT.acquire.ibpfRGB141414Packed, mvIMPACT.acquire.ibpfRGB161616Packed, mvIMPACT.acquire.ibpfYUV422_UYVYPacked, mvIMPACT.acquire.ibpfMono12Packed_V2, mvIMPACT.acquire.ibpfYUV422_10Packed, mvIMPACT.acquire.ibpfYUV422_UYVY_10Packed, mvIMPACT.acquire.ibpfBGR888Packed, mvIMPACT.acquire.ibpfBGR101010Packed_V2, mvIMPACT.acquire.ibpfYUV444_UYVPacked, mvIMPACT.acquire.ibpfYUV444_UYV_10Packed, mvIMPACT.acquire.ibpfYUV444Packed, mvIMPACT.acquire.ibpfYUV444_10Packed, mvIMPACT.acquire.ibpfMono12Packed_V1, mvIMPACT.acquire.ibpfYUV411_UYYVYY_Packed, mvIMPACT.acquire.ibpfRGB888Planar, mvIMPACT.acquire.ibpfAuto.

saturation_pc

saturation_pc = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_saturation_pc_get, doc=)

static

An integer property defining the saturation value to be applied to the image data by the frame grabber in per cent.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

scanClock

scanClock = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_scanClock_get, doc=)

static

An enumerated integer property defining the scan clock mode used for the current acquisition.

Valid values for this property may be: mvIMPACT.acquire.scAuto, mvIMPACT.acquire.scAnalogue, mvIMPACT.acquire.scDigital.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception! Digital frame grabbers will however NOT support this property.

scanRate_kHz

scanRate_kHz = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_scanRate_kHz_get, doc=)

static

An integer property defining the current scan frequency of the capture device.

This property is only visible if the mvIMPACT.acquire.CameraSettingsFrameGrabber.scanRateMode property is NOT in an auto mode.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

scanRateMode

scanRateMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_scanRateMode_get, doc=)

static

An enumerated integer property defining the scan rate mode for this setting.

Valid values for this property may be: mvIMPACT.acquire.dsrmAuto, mvIMPACT.acquire.dsrmUser.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

serialPortBaudrate

serialPortBaudrate = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_serialPortBaudrate_get, doc=)

static

An enumerated integer property defining the baud rate of the serial communication port between frame grabber and camera.

Currently this property is only available for CameraLink® frame grabbers.

Valid values for this property may be: mvIMPACT.acquire.cspbr9600, mvIMPACT.acquire.cspbr19200, mvIMPACT.acquire.cspbr38400, mvIMPACT.acquire.cspbr57600, mvIMPACT.acquire.cspbr115200, mvIMPACT.acquire.cspbr230400, mvIMPACT.acquire.cspbr460800, mvIMPACT.acquire.cspbr921600.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

softwareTriggerPeriod_ms

softwareTriggerPeriod_ms = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_softwareTriggerPeriod_ms_get, doc=)

static

An integer property defining the software simulated trigger period.

When mvIMPACT.acquire.CameraSettingsFrameGrabber.triggerMode is set to mvIMPACT.acquire.dtmPeriodically this property defines the interval between two consecutive external trigger events simulated by the driver.

Currently this property is only available for mvTITAN and mvGAMMA frame grabbers.

Note

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

thisown

thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")

static

triggerControlCount

triggerControlCount = property (getTriggerControlCount, None, None, None)

static

An integer property (read-only) which holds the number of mvIMPACT.acquire.TriggerControls available for this device.

See mvIMPACT.acquire.CameraSettingsFrameGrabber.getTriggerControlCount()

triggerMode

triggerMode = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_triggerMode_get, doc=)

static

An enumerated integer property defining the behaviour of the frame grabbers trigger input.

Note

Valid values for this property may be: mvIMPACT.acquire.dtmOff, mvIMPACT.acquire.dtmOn, mvIMPACT.acquire.dtmFallingEdge, mvIMPACT.acquire.dtmRisingEdge, mvIMPACT.acquire.dtmPeriodically, mvIMPACT.acquire.dtmOnDemand, mvIMPACT.acquire.dtmStartRisingStopFalling, mvIMPACT.acquire.dtmStartFallingStopRising, mvIMPACT.acquire.dtmLevelHigh, mvIMPACT.acquire.dtmLevelLow. However not every device will offer all these trigger modes but a subset of them. Valid trigger modes therefore can be found by reading the properties translation dictionary.

This property will not be available for every frame grabber, so before using it, check if the property is available at all by calling mvIMPACT.acquire.Component.isValid. Accessing an invalid property will raise an exception!

type

type = property(lib_mvIMPACT_acquire.CameraSettingsFrameGrabber_type_get, doc=)

static

An enumerated integer property defining the camera description used for the image acquisition.

This property ALWAYS defines a translation dictionary containing a string representation and a numerical value for the camera descriptions available for the device. The string representation of the camera description will be built from the property name of the class this camera description belongs to (e.g. 'Standard', 'NonStandard' or 'CameraLink') and the name of the camera description itself. Assuming a the device can handle standard video cameras and a description for a camera named 'MyCCIRCamera' will therefore add 'Standard_MyCCIRCamera' and a unique numerical representation to the properties translation dictionary.