CameraSettingsVirtualDevice Class Reference

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

Inheritance diagram for CameraSettingsVirtualDevice:

Public Member Functions
	CameraSettingsVirtualDevice (Device pDev)
	Constructs a new mvIMPACT.acquire.CameraSettingsVirtualDevice object.
	CameraSettingsVirtualDevice (Device pDev, String settingName)
	Constructs a new mvIMPACT.acquire.CameraSettingsVirtualDevice object.
synchronized void	delete ()
PropertyI	getAoiHeight ()
	An integer property defining the number of lines to capture.
PropertyI	getAoiMode ()
	An enumerated integer property defining the used AOI mode for the image capture.
PropertyI	getAoiStartX ()
	An integer property defining the X-offset for each capture line.
PropertyI	getAoiStartY ()
	An integer property defining the Y-offset.
PropertyI	getAoiWidth ()
	An integer property defining the number of pixels to capture per line.
PropertyS	getBasedOn ()
	A string property (read-only) containing the name of the setting this setting is based on.
PropertyI	getBayerMosaicParity ()
	An enumerated integer property defining the Bayer attribute assigned to the generated test image.
PropertyI	getBufferPartCount ()
	An integer property defining the number of buffer part to transmit in each request.
PropertyI	getChannelBitDepth ()
	An integer property defining the channel bit depth for certain test image generation modes.
PropertyI	getFrameDelay_us ()
	An integer property defining a delay in us before the 'captured' image is returned to the user.
PropertyF	getGain_dB ()
	A float property defining the gain in dB to be applied to the test image.
PropertyS	getImageDirectory ()
	A string property defining the directory to capture images from.
PropertyI	getImageRequestTimeout_ms ()
	An integer property defining the maximum time to wait for an image in ms.
PropertyI	getImageType ()
	An enumerated integer property defining what images shall be captured from hard disk.
PropertyI	getPaddingX ()
	An integer property defining the padding(in bytes) in X-direction for certain test image generation modes.
PropertyI	getPixelFormat ()
	An enumerated integer property defining the pixel format used to transfer the image data into the target systems host memory.
PropertyI	getTapsXGeometry ()
	An enumerated integer property defining the way this camera transmits the pixel data in X direction.
PropertyI	getTapsYGeometry ()
	An enumerated integer property defining the way this camera transmits the pixel data in Y direction.
PropertyI	getTestImageBarWidth ()
	An integer property defining the width (in pixels) of the different bars in certain test modes.
PropertyI	getTestMode ()
	An enumerated integer property defining the test mode use to generate the dummy images.
PropertyS	getUserData ()
	A string property that will be copied into the user data property of each request.
int	hObj ()
	Returns a unique identifier for the component collection referenced by this object.
ComponentCollection	restoreDefault ()
	Restores the default for every component of this collection.

Protected Member Functions
	CameraSettingsVirtualDevice (long cPtr, boolean cMemoryOwn)
void	finalize ()

Static Protected Member Functions
static long	swigRelease (BasicDeviceSettings obj)
static long	swigRelease (BasicDeviceSettingsWithAOI obj)
static long	swigRelease (CameraSettingsBase obj)
static long	swigRelease (CameraSettingsVirtualDevice obj)
static long	swigRelease (ComponentCollection obj)

Protected Attributes
transient boolean	swigCMemOwn

Detailed Description

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

Note

As this is a device driver meant for testing the interface an allowing to start the integration of Impact Acquire into an application, this class might change at ANY time! Changes in the virtual device driver might not be backward compatible!

This class will only be available if mvIMPACT.acquire.Device.getInterfaceLayout() is set to mvIMPACT.acquire.TDeviceInterfaceLayout.dilDeviceSpecific before the device is opened.

Constructor & Destructor Documentation

CameraSettingsVirtualDevice() [1/3]

CameraSettingsVirtualDevice ( long cPtr, boolean cMemoryOwn )

protected

CameraSettingsVirtualDevice() [2/3]

CameraSettingsVirtualDevice	(	Device	pDev,
		String	settingName )

Constructs a new mvIMPACT.acquire.CameraSettingsVirtualDevice object.

Parameters

pDev	[in] A pointer to a mvIMPACT.acquire.Device object obtained from a mvIMPACT.acquire.DeviceManager object.
settingName	[in] 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

CameraSettingsVirtualDevice() [3/3]

CameraSettingsVirtualDevice

(

Device

pDev

)

Constructs a new mvIMPACT.acquire.CameraSettingsVirtualDevice object.

Parameters

pDev

[in] A pointer to a mvIMPACT.acquire.Device object obtained from a mvIMPACT.acquire.DeviceManager object. 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

Member Function Documentation

delete()

synchronized void delete

(

)

Reimplemented from CameraSettingsBase.

finalize()

void finalize ( )

protected

Reimplemented from CameraSettingsBase.

getAoiHeight()

PropertyI getAoiHeight ( )

inherited

An integer property defining the number of lines to capture.

getAoiMode()

PropertyI getAoiMode

(

)

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

This feature will only be visible, when the property mvIMPACT.acquire.CameraSettingsVirtualDevice.getTestMode() is set to mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmImageDirectory. Then this property will allow to enforce a certain image dimension ( mvIMPACT.acquire.TCameraAoiMode.camUser ) or to capture every image file in its original dimensions ( mvIMPACT.acquire.TCameraAoiMode.camFull ). Valid values for this property are defined by the enumeration mvIMPACT.acquire.TCameraAoiMode.

Since

2.11.9

getAoiStartX()

PropertyI getAoiStartX ( )

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.

getAoiStartY()

PropertyI getAoiStartY ( )

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.

getAoiWidth()

PropertyI getAoiWidth ( )

inherited

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

getBasedOn()

PropertyS getBasedOn ( )

inherited

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

Since

1.12.67

getBayerMosaicParity()

PropertyI getBayerMosaicParity

(

)

An enumerated integer property defining the Bayer attribute assigned to the generated test image.

When images are acquired via a directory, or a Bayer test pattern is generated this can be used to specify the Bayer parity. mvIMPACT.acquire.TBayerMosaicParity.bmpUndefined will set the buffers Bayer attribute thus will result in a grey(mono) buffer being returned.

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

getBufferPartCount()

PropertyI getBufferPartCount

(

)

An integer property defining the number of buffer part to transmit in each request.

This property is meant to test the multi-part buffer feature of Impact Acquire mainly. When set to 0 multi-part buffer handling is switched off. When set to a value greater than 0 the virtual device will transmit data in multi-part mode, meaning that mvIMPACT.acquire.Request.getBufferPartCount() will return a value larger than zero. Only when this is the case the properties belonging to the individual buffer parts are guaranteed to contain up to date data while then all properties whose name starts with image within that request might not.

Since

2.20.0

getChannelBitDepth()

PropertyI getChannelBitDepth

(

)

An integer property defining the channel bit depth for certain test image generation modes.

When mvIMPACT.acquire.CameraSettingsBase.getPixelFormat() is NOT set to mvIMPACT.acquire.TImageBufferPixelFormat.ibpfAuto, this this property will become invisible.

When mvIMPACT.acquire.CameraSettingsVirtualDevice.getTestMode() is set to mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmMovingMonoRamp, mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmMovingBayerDataRamp or mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmBayerWhiteBalanceTestImage this property will allow to define the pixel format for the test image.

getFrameDelay_us()

PropertyI getFrameDelay_us

(

)

An integer property defining a delay in us before the 'captured' image is returned to the user.

getGain_dB()

PropertyF getGain_dB

(

)

A float property defining the gain in dB to be applied to the test image.

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

getImageDirectory()

PropertyS getImageDirectory

(

)

A string property defining the directory to capture images from.

This feature will only be visible, when the property mvIMPACT.acquire.CameraSettingsVirtualDevice.getTestMode() is set to mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmImageDirectory.

See mvIMPACT.acquire.CameraSettingsVirtualDevice.getImageType() to find out how to configure what kind of images shall be captured from disk.

getImageRequestTimeout_ms()

PropertyI getImageRequestTimeout_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.

getImageType()

PropertyI getImageType

(

)

An enumerated integer property defining what images shall be captured from hard disk.

This feature will only be visible, when the property mvIMPACT.acquire.CameraSettingsVirtualDevice.getTestMode() is set to mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmImageDirectory.

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

getPaddingX()

PropertyI getPaddingX

(

)

An integer property defining the padding(in bytes) in X-direction for certain test image generation modes.

When mvIMPACT.acquire.CameraSettingsVirtualDevice.getTestMode() is set to a mono format(not the weird packed ones!), mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmMovingBayerDataRamp or mvIMPACT.acquire.TVirtualDeviceTestMode.vdtmBayerWhiteBalanceTestImage this property will allow to define the padding in bytes for each line. This will result in images where the line pitch differs from the width multiplied by the bytes per pixel value. E.g. a padding of 1 in X-direction and a width of 5 for a 16 bit mono format will result in a line pitch of 11 bytes(5*2 + 1).

getPixelFormat()

PropertyI getPixelFormat ( )

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.TImageBufferPixelFormat.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.getPixelFormat() to mvIMPACT.acquire.TImageBufferPixelFormat.ibpfYUV422Packed and mvIMPACT.acquire.ImageDestination.getPixelFormat() to mvIMPACT.acquire.TImageBufferPixelFormat.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.

getTapsXGeometry()

PropertyI getTapsXGeometry

(

)

An enumerated integer property defining the way this camera transmits the pixel data in X direction.

Within the virtual device driver, modifying this property internally will only attach the corresponding attribute to the request buffer, thus might result in the tap sort filter to process the data. This is mainly meant for testing purposes.

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

Since

2.5.2

getTapsYGeometry()

PropertyI getTapsYGeometry

(

)

An enumerated integer property defining the way this camera transmits the pixel data in Y direction.

Within the virtual device driver, modifying this property internally will only attach the corresponding attribute to the request buffer, thus might result in the tap sort filter to process the data. This is mainly meant for testing purposes.

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

Since

2.5.2

getTestImageBarWidth()

PropertyI getTestImageBarWidth

(

)

An integer property defining the width (in pixels) of the different bars in certain test modes.

getTestMode()

PropertyI getTestMode

(

)

An enumerated integer property defining the test mode use to generate the dummy images.

When mvIMPACT.acquire.CameraSettingsBase.getPixelFormat() is NOT set to mvIMPACT.acquire.TImageBufferPixelFormat.ibpfAuto, this this property will become invisible.

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

getUserData()

PropertyS getUserData

(

)

A string property that will be copied into the user data property of each request.

This e.g. can be used to assign a certain identifier to each image request.

hObj()

int hObj ( )

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

ComponentCollection restoreDefault ( )

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.

swigRelease() [1/5]

static long swigRelease ( BasicDeviceSettings obj )

staticprotectedinherited

swigRelease() [2/5]

static long swigRelease ( BasicDeviceSettingsWithAOI obj )

staticprotectedinherited

swigRelease() [3/5]

static long swigRelease ( CameraSettingsBase obj )

staticprotectedinherited

swigRelease() [4/5]

static long swigRelease ( CameraSettingsVirtualDevice obj )

staticprotected

swigRelease() [5/5]

static long swigRelease ( ComponentCollection obj )

staticprotectedinherited

Member Data Documentation

swigCMemOwn

transient boolean swigCMemOwn

protectedinherited