Contains information about a captured buffer. More...

Inheritance diagram for Request:

Public Member Functions
	__disown__ (self)

	__init__ (self, *args)
	Constructs a new mvIMPACT.acquire.Request from an existing one.

	attachUserBuffer (self, pBuf)
	Convenience function to attach a user supplied buffer to a mvIMPACT.acquire.Request object.

	configure (self)
	Sets a request into configuration mode.

	detachUserBuffer (self)
	Convenience function to detach a user supplied buffer from a mvIMPACT.acquire.Request object.

	getBufferPart (self, index)
	Returns a reference to a buffer part descriptor of this request.

	getBufferPartCount (self)
	Returns the number of buffer parts currently associated with this request.

	getChunkCounterCount (self)
	Returns the number of counter values that can be returned as part of the additional data of the buffer containing the request data.

	getChunkCounterValue (self, index)
	Returns a 64 bit integer property (read-only) defining the selected counter value at the time of the internal frame start event for this request.

	getChunkGain (self, *args)
	Returns a floating point property (read-only) defining the selected gain value at the time of the internal frame start event for this request.

	getChunkGainCount (self)
	Returns the number of gain values that can be returned as part of the additional data of the buffer containing the request data.

	getChunkTimerCount (self)
	Returns the number of timer values that can be returned as part of the additional data of the buffer containing the request data.

	getChunkTimerValue (self, index)
	Returns a floating point property (read-only) defining the selected timer value at the time of the internal frame start event for this request.

	getComponentLocator (self)
	Returns a component locator for this request.

	getHasProcessingBeenSkipped (self)
	Checks if image processing that was set up for this request has been skipped for performance reasons.

	getImageBufferDesc (self)
	Returns a const reference to the image buffer descriptor of this request.

	getImageProcessingResultsIterator (self)
	Returns an iterator for iterating inside the info/imageProcessingResults list of the request.

	getInfoIterator (self)
	Returns an iterator for iterating inside the info list of the request.

	getIsOK (self)
	Convenience function to check if a request has been processed successfully.

	getName (self)
	Returns the name associated with this request.

	getNumber (self)
	Returns the number associated with this request.

	save (self, *args)
	Stores the image described by this request into a file.

	unlock (self)
	Unlocks the request for the driver again.

Properties
	bufferSizeFilled = property(lib_mvIMPACT_acquire.Request_bufferSizeFilled_get, doc=)
	A 64bit integer property (read-only) containing the total amount of data (in bytes) that has been captured during the last capture operation.

	chunkDynamicRangeMax = property(lib_mvIMPACT_acquire.Request_chunkDynamicRangeMax_get, doc=)
	A 64 bit integer property (read-only) containing the maximum value of dynamic range of the image as returned in the chunk data attached to the image.

	chunkDynamicRangeMin = property(lib_mvIMPACT_acquire.Request_chunkDynamicRangeMin_get, doc=)
	A 64 bit integer property (read-only) containing the minimum value of dynamic range of the image as returned in the chunk data attached to the image.

	chunkExposureTime = property(lib_mvIMPACT_acquire.Request_chunkExposureTime_get, doc=)
	A floating point property (read-only) containing the exposure time used to capture the image as returned in the chunk data attached to the image.

	chunkHeight = property(lib_mvIMPACT_acquire.Request_chunkHeight_get, doc=)
	A 64 bit integer property (read-only) containing the height of the image in pixels as returned in the chunk data attached to the image.

	chunkLineStatusAll = property(lib_mvIMPACT_acquire.Request_chunkLineStatusAll_get, doc=)
	A 64 bit integer property (read-only) containing the status of all I/O lines at the time of the internal frame start signal of the image as returned in the chunk data attached to the image.

	chunkmvCustomIdentifier = property(lib_mvIMPACT_acquire.Request_chunkmvCustomIdentifier_get, doc=)
	A 64 bit integer property (read-only) containing the previously configured user defined identifier attached to the image.

	chunkOffsetX = property(lib_mvIMPACT_acquire.Request_chunkOffsetX_get, doc=)
	A 64 bit integer property (read-only) containing the X-offset of the image in pixels as returned in the chunk data attached to the image.

	chunkOffsetY = property(lib_mvIMPACT_acquire.Request_chunkOffsetY_get, doc=)
	A 64 bit integer property (read-only) containing the Y-offset of the image in pixels as returned in the chunk data attached to the image.

	chunkPixelFormat = property(lib_mvIMPACT_acquire.Request_chunkPixelFormat_get, doc=)
	A 64 bit integer property (read-only) containing the pixel format of the image as returned in the chunk data attached to the image.

	chunkSequencerSetActive = property(lib_mvIMPACT_acquire.Request_chunkSequencerSetActive_get, doc=)
	A 64-bit integer property (read-only) containing the index of the active set of the running sequencer use during the creation of this block of data.

	chunkTimestamp = property(lib_mvIMPACT_acquire.Request_chunkTimestamp_get, doc=)
	A 64 bit integer property (read-only) containing the timestamp value of the internal frame start signal of the image as returned in the chunk data attached to the image.

	chunkWidth = property(lib_mvIMPACT_acquire.Request_chunkWidth_get, doc=)
	A 64 bit integer property (read-only) containing the width of the image in pixels as returned in the chunk data attached to the image.

	hasProcessingBeenSkipped = property (getHasProcessingBeenSkipped, None, None, None)
	A bool property (read-only) which checks if image processing that was set up for this request has been skipped for performance reasons.

	imageBayerMosaicParity = property(lib_mvIMPACT_acquire.Request_imageBayerMosaicParity_get, doc=)
	An enumerated integer property (read-only) containing the Bayer parity of this image.

	imageBufferDesc = property (getImageBufferDesc, None, None, None)
	A property (read-only) which holds a const reference to the image buffer descriptor of this request.

	imageBytesPerPixel = property(lib_mvIMPACT_acquire.Request_imageBytesPerPixel_get, doc=)
	An integer property (read-only) containing the number of bytes per pixel in this image.

	imageChannelBitDepth = property(lib_mvIMPACT_acquire.Request_imageChannelBitDepth_get, doc=)
	An integer property (read-only) containing the number of effective bits stored in each channel belonging to the current image.

	imageChannelCount = property(lib_mvIMPACT_acquire.Request_imageChannelCount_get, doc=)
	An integer property (read-only) containing the number of channels this image consists of.

	imageChannelDesc = property(lib_mvIMPACT_acquire.Request_imageChannelDesc_get, doc=)
	A string property (read-only) containing the string descriptors of each channel belonging to the current image.

	imageChannelOffset = property(lib_mvIMPACT_acquire.Request_imageChannelOffset_get, doc=)
	An integer property (read-only) containing the offset (in bytes) to each channel belonging to the current image relative to the address contained in mvIMPACT.acquire.Request.imageData.

	imageData = property(lib_mvIMPACT_acquire.Request_imageData_get, doc=)
	A pointer property (read-only) containing the start address of the image data.

	imageFooter = property(lib_mvIMPACT_acquire.Request_imageFooter_get, doc=)
	A pointer property (read-only) containing the start address of the footer associated with this image.

	imageFooterSize = property(lib_mvIMPACT_acquire.Request_imageFooterSize_get, doc=)
	An integer property (read-only) containing the size (in bytes) of the footer associated with this image.

	imageHeight = property(lib_mvIMPACT_acquire.Request_imageHeight_get, doc=)
	An integer property (read-only) containing the height of the image in pixels.

	imageHeightTotal = property(lib_mvIMPACT_acquire.Request_imageHeightTotal_get, doc=)
	An integer property (read-only) containing the total height of the image in pixels if this buffer is part of a larger image.

	imageLinePitch = property(lib_mvIMPACT_acquire.Request_imageLinePitch_get, doc=)
	An integer property (read-only) containing the offset (in bytes) to the next line of each channel belonging to the current image.

	imageMemoryMode = property(lib_mvIMPACT_acquire.Request_imageMemoryMode_get, doc=)
	An enumerated integer property (read-only) containing the memory mode used for this request.

	imageOffsetX = property(lib_mvIMPACT_acquire.Request_imageOffsetX_get, doc=)
	An integer property (read-only) containing the X-offset of the image in pixels.

	imageOffsetY = property(lib_mvIMPACT_acquire.Request_imageOffsetY_get, doc=)
	An integer property (read-only) containing the Y-offset of the image in pixels.

	imagePixelFormat = property(lib_mvIMPACT_acquire.Request_imagePixelFormat_get, doc=)
	An enumerated integer property (read-only) containing the pixel format of this image.

	imagePixelPitch = property(lib_mvIMPACT_acquire.Request_imagePixelPitch_get, doc=)
	An integer property (read-only) containing the offset (in bytes) to the next pixel of the specified channel of this image.

	imageSize = property(lib_mvIMPACT_acquire.Request_imageSize_get, doc=)
	An integer property (read-only) containing the size (in bytes) of the whole image.

	imageWidth = property(lib_mvIMPACT_acquire.Request_imageWidth_get, doc=)
	An integer property (read-only) containing the width of the image in pixels.

	imageWidthTotal = property(lib_mvIMPACT_acquire.Request_imageWidthTotal_get, doc=)
	An integer property (read-only) containing the total width of the image in pixels if this buffer is part of a larger image.

	infoCameraOutputUsed = property(lib_mvIMPACT_acquire.Request_infoCameraOutputUsed_get, doc=)
	An enumerated integer property (read-only) containing the camera output used to transmit the image to the capture device.

	infoExposeStart_us = property(lib_mvIMPACT_acquire.Request_infoExposeStart_us_get, doc=)
	An integer property (read-only) containing a timestamp (in us) defining the time the device started the exposure of the image associated with this mvIMPACT.acquire.Request object.

	infoExposeTime_us = property(lib_mvIMPACT_acquire.Request_infoExposeTime_us_get, doc=)
	An integer property (read-only) containing the 'real' expose time (in us) used to generate this image.

	infoFrameID = property(lib_mvIMPACT_acquire.Request_infoFrameID_get, doc=)
	A 64 bit integer property (read-only) containing a frame identifier.

	infoFrameNr = property(lib_mvIMPACT_acquire.Request_infoFrameNr_get, doc=)
	A 64 bit integer property (read-only, zero-based) containing the number of image requests processed since this driver instance has been opened.

	infoGain_dB = property(lib_mvIMPACT_acquire.Request_infoGain_dB_get, doc=)
	A float property (read-only) containing the gain(in dB) this image has been taken with.

	infoImageAverage = property(lib_mvIMPACT_acquire.Request_infoImageAverage_get, doc=)
	Currently unsupported.

	infoIOStatesAtExposureEnd = property(lib_mvIMPACT_acquire.Request_infoIOStatesAtExposureEnd_get, doc=)
	An integer property (read-only) containing the state of all the IO lines at the end of the frame exposure as a device specific bit field.

	infoIOStatesAtExposureStart = property(lib_mvIMPACT_acquire.Request_infoIOStatesAtExposureStart_get, doc=)
	An integer property (read-only) containing the state of all the IO lines at the beginning of the frame exposure as a device specific bit field.

	infoIterator = property (getInfoIterator, None, None, None)
	A property (read-only) which holds an iterator for iterating inside the info list of the request.

	infoLineCounter = property(lib_mvIMPACT_acquire.Request_infoLineCounter_get, doc=)
	An integer property (read-only) containing the number of lines since the last trigger event.

	infoMissingData_pc = property(lib_mvIMPACT_acquire.Request_infoMissingData_pc_get, doc=)
	A float property (read-only) containing the amount of data missing in the current image.

	infoSettingUsed = property(lib_mvIMPACT_acquire.Request_infoSettingUsed_get, doc=)
	A enumerated integer property (read-only) containing the setting that was used for processing this request.

	infoTimeStamp_us = property(lib_mvIMPACT_acquire.Request_infoTimeStamp_us_get, doc=)
	A 64 bit integer property (read-only) containing a timestamp to define the exact time this image has been captured (usually either at exposure start or exposure end, depending on the device).

	infoTransferDelay_us = property(lib_mvIMPACT_acquire.Request_infoTransferDelay_us_get, doc=)
	An integer property (read-only) containing the time the transaction of this image has been delayed (in us) because either the bus was blocked or the CPU was busy.

	infoVideoChannel = property(lib_mvIMPACT_acquire.Request_infoVideoChannel_get, doc=)
	An integer property (read-only) containing the video input channel of the device this image has been acquired from.

	isOK = property (getIsOK, None, None, None)
	A bool property (read-only) which checks if a request has been processed successfully.

	number = property (getNumber, None, None, None)
	An integer property (read-only) which holds the number associated with this request.

	payloadType = property(lib_mvIMPACT_acquire.Request_payloadType_get, doc=)
	An enumerated integer property (read-only) defining the payload type of this request.

	requestResult = property(lib_mvIMPACT_acquire.Request_requestResult_get, doc=)
	An enumerated integer property (read-only) defining the result of this request.

	requestState = property(lib_mvIMPACT_acquire.Request_requestState_get, doc=)
	An enumerated integer property (read-only) defining the current state of this request.

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

Detailed Description

Contains information about a captured buffer.

This class provides access to all sorts of information about the captured buffer. Only Instances of mvIMPACT.acquire.FunctionInterface are allowed to create objects of mvIMPACT.acquire.Request. Consequently the only way to get access to a mvIMPACT.acquire.Request object is via a call to mvIMPACT.acquire.FunctionInterface.getRequest.

A mvIMPACT.acquire.Request represents an object used by the driver to fill its internal job queues. Whenever a buffer shall be captured a mvIMPACT.acquire.Request is sent to the driver and the hardware then tries to capture the desired buffer as fast as possible.

Requests are managed by the driver. The only thing the user needs to configure is the maximum number of requests he wants the driver to work with. To make sure a certain number of requests are available, the property mvIMPACT.acquire.SystemSettings.requestCount can be used. This can be useful for time critical applications where the hardware can capture images in the background while the PC performs other tasks. In that case it's necessary to make sure that the request queue never runs low to ensure lossless data acquisition.

Constructor & Destructor Documentation

◆ init()

__init__	(		self,
		*	args )

Constructs a new mvIMPACT.acquire.Request from an existing one.

Parameters

src	[in] A constant reference to the mvIMPACT.acquire.Request object, this object shall be created from

Member Function Documentation

◆ disown()

__disown__ ( self )

◆ attachUserBuffer()

attachUserBuffer	(		self,
			pBuf )

Convenience function to attach a user supplied buffer to a mvIMPACT.acquire.Request object.

This function just provides a nicer way to attach a user supplied buffer to a mvIMPACT.acquire.Request.

To find out more about capturing to user supplied buffers please have a look at the documentation of the function mvIMPACT.acquire.Request.configure.

See also: mvIMPACT.acquire.Request.detachUserBuffer,
mvIMPACT.acquire.FunctionInterface.imageRequestUnlock,
mvIMPACT.acquire.Request.unlock,
mvIMPACT.acquire.FunctionInterface.imageRequestConfigure,
mvIMPACT.acquire.Request.configure

Since: 1.12.68

Returns

mvIMPACT.acquire.DMR_NO_ERROR if successful.
A negative error code as listed here: Error code list .

Parameters

pBuf	[in] A pointer to a user supplied buffer
bufSize	[in] The size of the user supplied buffer

◆ configure()

configure ( self )

Sets a request into configuration mode.

In configuration mode certain properties like mvIMPACT.acquire.Request.imageData, mvIMPACT.acquire.Request.imageSize, mvIMPACT.acquire.Request.imageMemoryMode of a request object can be modified. This can be used to configure one or more requests to use a user supplied memory. To use only a subset of the mvIMPACT.acquire.Request objects available the mvIMPACT.acquire.ImageRequestControl.requestToUse feature can be used.

Only requests that are currently not used by the driver and are not locked because they contain image data that hasn't been processed can be set into configuration mode.

Note: Instead of calling this function directly for most cases it is much more convenient to use the functions mvIMPACT.acquire.Request.attachUserBuffer and mvIMPACT.acquire.Request.detachUserBuffer instead.

User supplied buffers must follow the alignment and size requirements reported by versions of the function mvIMPACT.acquire.FunctionInterface.getCurrentCaptureBufferLayout. Calling a version of this function will return all the information required to allocate buffers that can be used to capture data for the specified settings.

When allocating memory on the heap, the complete buffer size is needed which is calculated like this:

size + alignment

Note: The address passed to the request object must be aligned already!; A request that is in configuration mode can't be sent to the driver for acquisition until mvIMPACT.acquire.Request.unlock or mvIMPACT.acquire.FunctionInterface.imageRequestUnlock has been called again. By using mvIMPACT.acquire.Request.attachUserBuffer and mvIMPACT.acquire.Request.detachUserBuffer this locking and unlocking is done internally thus the application does not need to worry about this.

See also: mvIMPACT.acquire.FunctionInterface.imageRequestSingle,
mvIMPACT.acquire.Request.attachUserBuffer,
mvIMPACT.acquire.Request.detachUserBuffer,
mvIMPACT.acquire.Request.unlock,
mvIMPACT.acquire.FunctionInterface.imageRequestUnlock,
mvIMPACT.acquire.FunctionInterface.imageRequestWaitFor,
mvIMPACT.acquire.FunctionInterface.imageRequestReset

Since: 1.12.68

Returns

mvIMPACT.acquire.DMR_NO_ERROR if successful.
A negative error code as listed here: Error code list .

◆ detachUserBuffer()

detachUserBuffer ( self )

Convenience function to detach a user supplied buffer from a mvIMPACT.acquire.Request object.

This function just provides a nicer way to detach a user supplied buffer from a mvIMPACT.acquire.Request. It e.g. allows to write code like this:

# 'fi' is assumed to be a valid instance of acquire.FunctionInterface
pRequest = fi.getRequest(0) # get access to request 0
pRequest.detachUserBuffer()

Instead if this:

# 'fi' is assumed to be a valid instance of acquire.FunctionInterface
pRequest = fi.getRequest(0) # get access to request 0
if pRequest.configure() == acquire.DMR_NO_ERROR:
  pRequest.imageMemoryMode.write(acquire.rimmAuto)
  pRequest.unlock()

To find out more about capturing to user supplied buffers please have a look at the documentation of the function mvIMPACT.acquire.Request.configure.

See also: mvIMPACT.acquire.Request.attachUserBuffer,
mvIMPACT.acquire.FunctionInterface.imageRequestUnlock,
mvIMPACT.acquire.Request.unlock,
mvIMPACT.acquire.FunctionInterface.imageRequestConfigure,
mvIMPACT.acquire.Request.configure

Since: 1.12.68

Returns

mvIMPACT.acquire.DMR_NO_ERROR if successful.
A negative error code as listed here: Error code list .

◆ getBufferPart()

getBufferPart	(		self,
			index )

Returns a reference to a buffer part descriptor of this request.

This function returns a reference to a mvIMPACT.acquire.BufferPart at index index associated with this mvIMPACT.acquire.Request.

Attention: Please do NEVER work with old references to this class. So do NOT store this reference in some variable to use it for the evaluation of the next mvIMPACT.acquire.Request object as well, as this might not work because the buffer layout might have changed. Whenever mvIMPACT.acquire.Request.getBufferPart is called the function will make sure that the data in the returned structure is up to date while when working with an old reference to the mvIMPACT.acquire.BufferPart structure the containing data might refer to a previous result or worse an invalid memory location. This reference will remain valid until an application calls mvIMPACT.acquire.Request.unlock for the corresponding request.

See also: mvIMPACT.acquire.Request.getBufferPartCount
Multi-Part Format

Since: 2.20.0

Returns: A reference to the buffer part defined by index

Parameters

index [in] The index of the buffer part to return

◆ getBufferPartCount()

getBufferPartCount ( self )

Returns the number of buffer parts currently associated with this request.

Certain device drivers are able to deliver multiple buffer part within a single request object.

See also: Multi-Part Format

Since: 2.20.0

Returns: The number of buffer parts currently associated with this request. This might be zero in case the device driver delivers a standard data stream. It might also be 1 for special data formats such as JPEG, which must be handled differently from an image describing properties perspective.

◆ getChunkCounterCount()

getChunkCounterCount ( self )

Returns the number of counter values that can be returned as part of the additional data of the buffer containing the request data.

A device may support a large number of counters even though just a few of them or none is configured for counting. In such a case situation when switching on the transmission of the counter values at the time of the internal frame start event will allow to access the number of counters returned by this function but then the data in these counters of course will be meaningless.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.0.15

Returns: The number of counter values that can be returned as part of the additional data of the buffer containing the request data.

◆ getChunkCounterValue()

getChunkCounterValue	(		self,
			index )

Returns a 64 bit integer property (read-only) defining the selected counter value at the time of the internal frame start event for this request.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.0.15

Parameters

index [in] The index of the counter to return

◆ getChunkGain()

getChunkGain	(		self,
		*	args )

Returns a floating point property (read-only) defining the selected gain value at the time of the internal frame start event for this request.

OVERLOAD 1:

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.17.3

Parameters

index [in] The index of the gain to return

OVERLOAD 2: Returns a floating point property (read-only) defining the selected gain value at the time of the internal frame start event for this request.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.17.3

Parameters

name	[in] The name of the gain to return (as selected by mvIMPACT.acquire.AnalogControl.gainSelector)

◆ getChunkGainCount()

getChunkGainCount ( self )

Returns the number of gain values that can be returned as part of the additional data of the buffer containing the request data.

A device may support a large number of gains even though just a few of them or none is configured to run. In such a case situation when switching on the transmission of the gain values at the time of the internal frame start event will allow to access the number of gains returned by this function but then the data in these gains of course will be meaningless.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.17.3

◆ getChunkTimerCount()

getChunkTimerCount ( self )

Returns the number of timer values that can be returned as part of the additional data of the buffer containing the request data.

A device may support a large number of timers even though just a few of them or none is configured to run. In such a case situation when switching on the transmission of the timer values at the time of the internal frame start event will allow to access the number of timers returned by this function but then the data in these timers of course will be meaningless.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.0.15

◆ getChunkTimerValue()

getChunkTimerValue	(		self,
			index )

Returns a floating point property (read-only) defining the selected timer value at the time of the internal frame start event for this request.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.0.15

Parameters

index [in] The index of the timer to return

◆ getComponentLocator()

getComponentLocator ( self )

Returns a component locator for this request.

This will allow to write custom feature bind operations.

Since: 1.12.68

Returns: A component locator for this request.

◆ getHasProcessingBeenSkipped()

getHasProcessingBeenSkipped ( self )

Checks if image processing that was set up for this request has been skipped for performance reasons.

If mvIMPACT.acquire.Device.userControlledImageProcessingEnable is set to mvIMPACT.acquire.bTrue and mvIMPACT.acquire.SystemSettings.imageProcessingMode is set to mvIMPACT.acquire.ipmProcessLatestOnly this function can be used to check if at least one algorithm has been skipped because of a lack of processing time.

See also: mvIMPACT.acquire.Device.userControlledImageProcessingEnable,
mvIMPACT.acquire.SystemSettings.imageProcessingMode

Since: 2.14.0

Returns

true if at least one internal algorithm has been skipped.
false otherwise.

◆ getImageBufferDesc()

getImageBufferDesc ( self )

Returns a const reference to the image buffer descriptor of this request.

This function returns a const reference to the mvIMPACT.acquire.ImageBufferDesc associated with this mvIMPACT.acquire.Request.

Attention: Please do NEVER work with old references to this structure. So do NOT store this reference in some variable to use it for the evaluation of the next mvIMPACT.acquire.Request object as well, as this will not work. Whenever mvIMPACT.acquire.Request.getImageBufferDesc is called the function will make sure that the data in the returned structure is up to date while when working with an old reference to the mvIMPACT.acquire.ImageBufferDesc structure the containing data might refer to a previous result.

◆ getImageProcessingResultsIterator()

getImageProcessingResultsIterator ( self )

Returns an iterator for iterating inside the info/imageProcessingResults list of the request.

This can be useful when custom or device specific algorithms have been applied to the request object that weren't known at compile time.

For a code example please refer to the documentation of mvIMPACT.acquire.Request.getInfoIterator

See also: mvIMPACT.acquire.Request.getInfoIterator

Since: 2.14.0

Returns: An iterator for iterating inside the info/imageProcessingResults list of the request.

◆ getInfoIterator()

getInfoIterator ( self )

Returns an iterator for iterating inside the info list of the request.

This can be useful when custom or device specific information has been attached to the request object that wasn't known at compile time.

It allows to write code like this:

# 'fi' is assumed to be a valid instance of acquire.FunctionInterface,
# 'nr' is assumed to be a valid request number returned from a previous call to
# acquire.FunctionInterface.imageRequestWaitFor()
pRequest = fi.getRequest(requestNr)
if pRequest:
    it = pRequest.getInfoIterator()
    props = {None:None}
    while it.isValid:
        if it.isProp and it.isVisible:
            prop = acquire.Property(it.hObj())
            props[prop.name()] = prop.readS()
        it = it.nextSibling()
    # Here you can work with the information you just obtained

Returns: An iterator for iterating inside the info list of the request.

◆ getIsOK()

getIsOK ( self )

Convenience function to check if a request has been processed successfully.

This is just a nicer way of checking the value of the requestResult property. It allows to write code like this:

# 'fi' is assumed to be a valid instance of acquire.FunctionInterface,
# 'nr' is assumed to be a valid request number returned from a previous call to
# acquire.FunctionInterface.imageRequestWaitFor()
pRequest = fi.getRequest(nr)
if pRequest.isOK:
  # do something

Instead if this:

# 'fi' is assumed to be a valid instance of acquire.FunctionInterface,
# 'nr' is assumed to be a valid request number returned from a previous call to
# acquire.FunctionInterface.imageRequestWaitFor()
pRequest = fi.getRequest(nr)
if(pRequest.requestResult.read() == acquire.rrOK):
  # do something

Since: 1.12.63

Returns

true if the request has been processed successfully.
false otherwise.

◆ getName()

getName ( self )

Returns the name associated with this request.

Since: 2.32.0

◆ getNumber()

getNumber ( self )

Returns the number associated with this request.

◆ save()

save	(		self,
		*	args )

Stores the image described by this request into a file.

This function stores the image described by this request into a file.

Note: Internally The FreeImage library (see 'legal notice' section) is used for this operation. If the library cannot be located in version 3.18.0 or 3.16.0 on the host system calling this function will fail.

Since: 2.23.0

Returns

mvIMPACT.acquire.DMR_NO_ERROR if successful.
mvIMPACT.acquire.DMR_LIBRARY_NOT_FOUND if the required version of the FreeImage library could not be located on the host system.
mvIMPACT.acquire.DEV_UNSUPPORTED_PARAMETER if a pixel format has been passed to the function that is not supported by the internal algorithms.
mvIMPACT.acquire.DEV_INPUT_PARAM_INVALID if a pixel format has been passed to the function that is not supported by the FreeImage library.
A negative error code as listed here: Error code list .

Parameters

fileName	[in] The full path of the file to create.
format	[in] The format of the file to be created. If this parameter is set to mvIMPACT.acquire.iffAuto make sure to specify a proper file extension.

◆ unlock()

unlock ( self )

Unlocks the request for the driver again.

To ensure that no image data is overwritten by another image request while the user still deals with the image from a previous acquisition each image buffer will be locked by the driver when it is returned to the user by a call to mvIMPACT.acquire.FunctionInterface.imageRequestWaitFor. No new image will be captured into the same buffer until the user unlocks the buffer again by calling mvIMPACT.acquire.Request.unlock or mvIMPACT.acquire.FunctionInterface.imageRequestUnlock.

Note: After unlocking a request it is no longer guaranteed that the memory once referenced by the request and the image buffer belonging to it stays valid, so do NEVER try to access memory belonging to an unlocked request object. If you need to copy the image buffer or modify it in any other way, do everything you have to do BEFORE calling this function!

See also: mvIMPACT.acquire.FunctionInterface.imageRequestReset,
mvIMPACT.acquire.FunctionInterface.imageRequestSingle,
mvIMPACT.acquire.FunctionInterface.imageRequestWaitFor
mvIMPACT.acquire.FunctionInterface.imageRequestConfigure,
mvIMPACT.acquire.Request.configure

Since: 1.12.68

Returns

mvIMPACT.acquire.DMR_NO_ERROR if successful.
A negative error code as listed here: Error code list .

Property Documentation

◆ bufferSizeFilled

bufferSizeFilled = property(lib_mvIMPACT_acquire.Request_bufferSizeFilled_get, doc=)

static

A 64bit integer property (read-only) containing the total amount of data (in bytes) that has been captured during the last capture operation.

In contrast to mvIMPACT.acquire.Request.imageSize, this value might be smaller than the original amount of memory, that has been allocated upfront. This e.g. might be true for a JPEG transmission of a triggered linescan application where mvIMPACT.acquire.Request.imageSize would contain the maximum amount of data that could be captured while this value holds the number of bytes actually captured.

This value in connection with mvIMPACT.acquire.Request.imageData is sufficient to copy the complete image without having any additional information about it.

See also: mvIMPACT.acquire.Request.imageData,
mvIMPACT.acquire.Request.imageSize,
mvIMPACT.acquire.Request.imageFooter,
mvIMPACT.acquire.Request.imageFooterSize

Since: 3.3.0

◆ chunkDynamicRangeMax

chunkDynamicRangeMax = property(lib_mvIMPACT_acquire.Request_chunkDynamicRangeMax_get, doc=)

static

A 64 bit integer property (read-only) containing the maximum value of dynamic range of the image as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkDynamicRangeMin

chunkDynamicRangeMin = property(lib_mvIMPACT_acquire.Request_chunkDynamicRangeMin_get, doc=)

static

A 64 bit integer property (read-only) containing the minimum value of dynamic range of the image as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkExposureTime

chunkExposureTime = property(lib_mvIMPACT_acquire.Request_chunkExposureTime_get, doc=)

static

A floating point property (read-only) containing the exposure time used to capture the image as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.5.16

◆ chunkHeight

chunkHeight = property(lib_mvIMPACT_acquire.Request_chunkHeight_get, doc=)

static

A 64 bit integer property (read-only) containing the height of the image in pixels as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkLineStatusAll

chunkLineStatusAll = property(lib_mvIMPACT_acquire.Request_chunkLineStatusAll_get, doc=)

static

A 64 bit integer property (read-only) containing the status of all I/O lines at the time of the internal frame start signal of the image as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkmvCustomIdentifier

chunkmvCustomIdentifier = property(lib_mvIMPACT_acquire.Request_chunkmvCustomIdentifier_get, doc=)

static

A 64 bit integer property (read-only) containing the previously configured user defined identifier attached to the image.

This identifier can be specified by some other functions belonging to this SDK. If not specified this value will be 0.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.17.3

◆ chunkOffsetX

chunkOffsetX = property(lib_mvIMPACT_acquire.Request_chunkOffsetX_get, doc=)

static

A 64 bit integer property (read-only) containing the X-offset of the image in pixels as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkOffsetY

chunkOffsetY = property(lib_mvIMPACT_acquire.Request_chunkOffsetY_get, doc=)

static

A 64 bit integer property (read-only) containing the Y-offset of the image in pixels as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkPixelFormat

chunkPixelFormat = property(lib_mvIMPACT_acquire.Request_chunkPixelFormat_get, doc=)

static

A 64 bit integer property (read-only) containing the pixel format of the image as returned in the chunk data attached to the image.

This will NOT be a valid Impact Acquire pixel format but e.g. a GigE Vision, USB3 Vision of PFNC compliant pixel format or something else.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkSequencerSetActive

chunkSequencerSetActive = property(lib_mvIMPACT_acquire.Request_chunkSequencerSetActive_get, doc=)

static

A 64-bit integer property (read-only) containing the index of the active set of the running sequencer use during the creation of this block of data.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

Since: 2.12.3

◆ chunkTimestamp

chunkTimestamp = property(lib_mvIMPACT_acquire.Request_chunkTimestamp_get, doc=)

static

A 64 bit integer property (read-only) containing the timestamp value of the internal frame start signal of the image as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ chunkWidth

chunkWidth = property(lib_mvIMPACT_acquire.Request_chunkWidth_get, doc=)

static

A 64 bit integer property (read-only) containing the width of the image in pixels as returned in the chunk data attached to the image.

Note: For additional information about the chunk data format please refer to Chunk Data Format.

◆ hasProcessingBeenSkipped

hasProcessingBeenSkipped = property (getHasProcessingBeenSkipped, None, None, None)

static

A bool property (read-only) which checks if image processing that was set up for this request has been skipped for performance reasons.

See mvIMPACT.acquire.Request.getHasProcessingBeenSkipped()

◆ imageBayerMosaicParity

imageBayerMosaicParity = property(lib_mvIMPACT_acquire.Request_imageBayerMosaicParity_get, doc=)

static

An enumerated integer property (read-only) containing the Bayer parity of this image.

If the current image does not contain Bayer data, this value will be mvIMPACT.acquire.bmpUndefined.

Valid values for this property may be: mvIMPACT.acquire.bmpUndefined, mvIMPACT.acquire.bmpGR, mvIMPACT.acquire.bmpRG, mvIMPACT.acquire.bmpBG, mvIMPACT.acquire.bmpGB.

◆ imageBufferDesc

imageBufferDesc = property (getImageBufferDesc, None, None, None)

static

A property (read-only) which holds a const reference to the image buffer descriptor of this request.

See mvIMPACT.acquire.Request.getImageBufferDesc()

◆ imageBytesPerPixel

imageBytesPerPixel = property(lib_mvIMPACT_acquire.Request_imageBytesPerPixel_get, doc=)

static

An integer property (read-only) containing the number of bytes per pixel in this image.

◆ imageChannelBitDepth

imageChannelBitDepth = property(lib_mvIMPACT_acquire.Request_imageChannelBitDepth_get, doc=)

static

An integer property (read-only) containing the number of effective bits stored in each channel belonging to the current image.

Note: This property will store imageChannelCount values. These can be queried one by one using the index parameter of the function mvIMPACT.acquire.PropertyI.read() or in a single call by using the overloaded read function accepting a reference to a vector.

◆ imageChannelCount

imageChannelCount = property(lib_mvIMPACT_acquire.Request_imageChannelCount_get, doc=)

static

An integer property (read-only) containing the number of channels this image consists of.

For an RGB image this value e.g. would be 3. This value also defines how many parameters are stored by the properties mvIMPACT.acquire.Request.imagePixelPitch,
mvIMPACT.acquire.Request.imageLinePitch,
mvIMPACT.acquire.Request.imageChannelBitDepth,
mvIMPACT.acquire.Request.imageChannelDesc and
mvIMPACT.acquire.Request.imageChannelOffset.

If e.g. the channel count is 3 a call like pRequest->imageChannelOffset.read( 2 ) would return the channel offset of channel 3 (as calls to the read functions of properties are '0' based).

◆ imageChannelDesc

imageChannelDesc = property(lib_mvIMPACT_acquire.Request_imageChannelDesc_get, doc=)

static

A string property (read-only) containing the string descriptors of each channel belonging to the current image.

Note: This property will store imageChannelCount values. These can be queried one by one using the index parameter of the function mvIMPACT.acquire.PropertyS.read() or in a single call by using the overloaded read function accepting a reference to a vector.

For an RGB image this property e.g. might contain three values "R", "G" and "B".

fi = getFunctionInterfaceFromSomewhere()
currentRequestNr = getCurrentRequestNumberFromSomewhere()
pRequest = fi.getRequest(currentRequestNr)
channelCount = pRequest.imageChannelCount.read()
for i in range(channelCount):
  print("channel[", i, "]: ", pRequest.imageChannelDesc.read(i))

◆ imageChannelOffset

imageChannelOffset = property(lib_mvIMPACT_acquire.Request_imageChannelOffset_get, doc=)

static

An integer property (read-only) containing the offset (in bytes) to each channel belonging to the current image relative to the address contained in mvIMPACT.acquire.Request.imageData.

Note: This property will store imageChannelCount values. These can be queried one by one using the index parameter of the function mvIMPACT.acquire.PropertyI.read() or in a single call by using the overloaded read function accepting a reference to a vector.

◆ imageData

imageData = property(lib_mvIMPACT_acquire.Request_imageData_get, doc=)

static

A pointer property (read-only) containing the start address of the image data.

This address in connection with mvIMPACT.acquire.Request.imageSize is sufficient to copy the complete image without having any additional information about it. Sometimes however mvIMPACT.acquire.Request.bufferSizeFilled might be more suitable for this.

currentRequestNr = getCurrentRequestNumberFromSomewhere()
pRequest = fi.getRequest(currentRequestNr)
cbuf = (ctypes.c_char * pRequest.imageSize.read()).from_address(int(pRequest.imageData.read()))

Note: It's not always necessary to copy the image data! Each image buffer is an integral part of the mvIMPACT.acquire.Request object returned to the user by a call to the corresponding 'waitFor' function offered by the interface. The data in this buffer remains valid until the user either unlocks the request buffer or closes the mvIMPACT.acquire.Device again.; By unlocking the mvIMPACT.acquire.Request, the user informs the driver that this mvIMPACT.acquire.Request and the image buffer belonging to that mvIMPACT.acquire.Request is no longer needed by the user. The driver then queues this mvIMPACT.acquire.Request for capturing image data into it once again. However, once a mvIMPACT.acquire.Request has been returned to the user, its image buffer can't be overwritten by the driver! Therefore the user can work with, modify, store or copy the data safely until he unlocks the mvIMPACT.acquire.Request again.; This property will become writeable if this request is in configuration mode.

See also: mvIMPACT.acquire.FunctionInterface.imageRequestConfigure,
mvIMPACT.acquire.Request.configure,
mvIMPACT.acquire.Request.imageSize,
mvIMPACT.acquire.Request.bufferSizeFilled,
mvIMPACT.acquire.Request.imageFooterSize

◆ imageFooter

imageFooter = property(lib_mvIMPACT_acquire.Request_imageFooter_get, doc=)

static

A pointer property (read-only) containing the start address of the footer associated with this image.

A footer may contain additional data like e.g. information about the image (e.g. the exposure time used for this image). If this property contains the value '0' no footer is attached to this image.

Note: In general it is not necessary to access footer data. Sometime e.g. when the hardware already does some image pre-processing a footer containing additional information about the image data might be attached to the image. In this case some additional information about the structure of the footer might be needed as well.

◆ imageFooterSize

imageFooterSize = property(lib_mvIMPACT_acquire.Request_imageFooterSize_get, doc=)

static

An integer property (read-only) containing the size (in bytes) of the footer associated with this image.

If this property contains the value '0' no footer is attached to this image.

◆ imageHeight

imageHeight = property(lib_mvIMPACT_acquire.Request_imageHeight_get, doc=)

static

An integer property (read-only) containing the height of the image in pixels.

◆ imageHeightTotal

imageHeightTotal = property(lib_mvIMPACT_acquire.Request_imageHeightTotal_get, doc=)

static

An integer property (read-only) containing the total height of the image in pixels if this buffer is part of a larger image.

Note: This feature will be supported by devices using an Impact Acquire driver greater or equal version 1.11.50. Not every device driver will be capable of dealing with multiple buffers forming a single image. If a device driver can not deliver parts of a larger image, then this property will always contain the same value as returned by mvIMPACT.acquire.Request.imageHeight.

◆ imageLinePitch

imageLinePitch = property(lib_mvIMPACT_acquire.Request_imageLinePitch_get, doc=)

static

An integer property (read-only) containing the offset (in bytes) to the next line of each channel belonging to the current image.

Note: This property will store imageChannelCount values. These can be queried one by one using the index parameter of the function mvIMPACT.acquire.PropertyI.read() or in a single call by using the overloaded read function accepting a reference to a vector.

◆ imageMemoryMode

imageMemoryMode = property(lib_mvIMPACT_acquire.Request_imageMemoryMode_get, doc=)

static

An enumerated integer property (read-only) containing the memory mode used for this request.

Valid values for this property may be: mvIMPACT.acquire.rimmAuto, mvIMPACT.acquire.rimmUser.

Note: This property will become writeable if this request is in configuration mode.

See also: mvIMPACT.acquire.FunctionInterface.imageRequestConfigure,
mvIMPACT.acquire.Request.configure

◆ imageOffsetX

imageOffsetX = property(lib_mvIMPACT_acquire.Request_imageOffsetX_get, doc=)

static

An integer property (read-only) containing the X-offset of the image in pixels.

Note: This feature will be supported by devices using an Impact Acquire driver greater or equal version 1.10.92.

◆ imageOffsetY

imageOffsetY = property(lib_mvIMPACT_acquire.Request_imageOffsetY_get, doc=)

static

An integer property (read-only) containing the Y-offset of the image in pixels.

Note: This feature will be supported by devices using an Impact Acquire driver greater or equal version 1.10.92.

◆ imagePixelFormat

imagePixelFormat = property(lib_mvIMPACT_acquire.Request_imagePixelFormat_get, doc=)

static

An enumerated integer property (read-only) containing the pixel format of this image.

This might be important, when the image data needs to be processed or stored in a file or maybe even if the image shall be displayed.

◆ imagePixelPitch

imagePixelPitch = property(lib_mvIMPACT_acquire.Request_imagePixelPitch_get, doc=)

static

An integer property (read-only) containing the offset (in bytes) to the next pixel of the specified channel of this image.

Note: This property will store imageChannelCount values. These can be queried one by one using the index parameter of the function mvIMPACT.acquire.PropertyI.read() or in a single call by using the overloaded read function accepting a reference to a vector.

◆ imageSize

imageSize = property(lib_mvIMPACT_acquire.Request_imageSize_get, doc=)

static

An integer property (read-only) containing the size (in bytes) of the whole image.

This value in connection with mvIMPACT.acquire.Request.imageData is sufficient to copy the complete image without having any additional information about it. Sometimes however mvIMPACT.acquire.Request.bufferSizeFilled might be more suitable for this.

Note: This property will become writeable if this request is in configuration mode.

See also: mvIMPACT.acquire.FunctionInterface.imageRequestConfigure,
mvIMPACT.acquire.Request.configure,
mvIMPACT.acquire.Request.imageData,
mvIMPACT.acquire.Request.bufferSizeFilled,
mvIMPACT.acquire.Request.imageFooterSize

◆ imageWidth

imageWidth = property(lib_mvIMPACT_acquire.Request_imageWidth_get, doc=)

static

An integer property (read-only) containing the width of the image in pixels.

◆ imageWidthTotal

imageWidthTotal = property(lib_mvIMPACT_acquire.Request_imageWidthTotal_get, doc=)

static

An integer property (read-only) containing the total width of the image in pixels if this buffer is part of a larger image.

Note: This feature will be supported by devices using an Impact Acquire driver greater or equal version 1.11.50. Not every device driver will be capable of dealing with multiple buffers forming a single image. If a device driver can not deliver parts of a larger image, then this property will always contain the same value as returned by mvIMPACT.acquire.Request.imageWidth.

◆ infoCameraOutputUsed

infoCameraOutputUsed = property(lib_mvIMPACT_acquire.Request_infoCameraOutputUsed_get, doc=)

static

An enumerated integer property (read-only) containing the camera output used to transmit the image to the capture device.

Valid values for this property may be: mvIMPACT.acquire.coUndefined, mvIMPACT.acquire.coAuto, mvIMPACT.acquire.coComposite, mvIMPACT.acquire.coBase, mvIMPACT.acquire.coDigital, mvIMPACT.acquire.coSVideo, mvIMPACT.acquire.coMedium, mvIMPACT.acquire.coRGB, mvIMPACT.acquire.co2xComposite, mvIMPACT.acquire.co3xComposite, mvIMPACT.acquire.co4xComposite, mvIMPACT.acquire.coFull, mvIMPACT.acquire.coSDSDI, mvIMPACT.acquire.coHDSDI, mvIMPACT.acquire.co3GSDI.

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.

◆ infoExposeStart_us

infoExposeStart_us = property(lib_mvIMPACT_acquire.Request_infoExposeStart_us_get, doc=)

static

An integer property (read-only) containing a timestamp (in us) defining the time the device started the exposure of the image associated with this mvIMPACT.acquire.Request object.

This value will stay 0 if nothing is known about the time the exposure did start. In such a case the mvIMPACT.acquire.Request.infoTimeStamp_us property should be used instead.

◆ infoExposeTime_us

infoExposeTime_us = property(lib_mvIMPACT_acquire.Request_infoExposeTime_us_get, doc=)

static

An integer property (read-only) containing the 'real' expose time (in us) used to generate this image.

This might differ slightly from the value selected by the user via the corresponding exposure property depending on the precision available for the device or the connected camera.

Note: When working with the mvIMPACT.acquire.dilGenICam this value will reflect the last value of the corresponding device property when it was written thus is a cached copy of the value that has been set by the application. For various operation modes this might NOT be the value actually used by the device for taking the image described by this request object. For example when AEC (exposureAuto) is active or the device is operated in a special sequencer mode the value of this property might be incorrect. When precise information about this value is needed it is recommended to work in chunk mode and use the exposure provided as chunk information instead.

See also: mvIMPACT.acquire.Device.interfaceLayout,
mvIMPACT.acquire.ChunkDataControl,
mvIMPACT.acquire.AcquisitionControl.exposureAuto,
mvIMPACT.acquire.Request.getChunkExposureTime

◆ infoFrameID

infoFrameID = property(lib_mvIMPACT_acquire.Request_infoFrameID_get, doc=)

static

A 64 bit integer property (read-only) containing a frame identifier.

This parameter is returned as part of the mvIMPACT.acquire.Request. It is used to associate a certain image with a unique identifier.

When an mvIMPACT.acquire.RTCtrProgramStep instruction of the type mvIMPACT.acquire.rtctrlProgTriggerSet is executed, the frameID is set to the value of the property FrameID of a corresponding mvIMPACT.acquire.RTCtrProgramStep if the HRTC is used and any program step executes the setting of the ID.

If a device (e.g. a digital camera) supports the transmission of a unique identifier for an image, this property will reflect the identifier as transmitted by the device.

Note

mvBlueFOX and mvHYPERION specific: This property will only contain meaningful data if the device supports at least one HRTC and a program is running and writing data to the property OR if a device supports the transmission of a unique identifier for an image. Currently HRTC programs are supported by mvBlueFOX and mvHYPERION devices.

GigE Vision and USB3 Vision specific: This is the property where the so called block ID will be stored which is a unique identifier for each frame that will be transferred by the device as part of each frame as defined by the standard.

For GigE Vision 1.x compliant devices, this will be a 16 bit counter that will be incremented with every data block(e.g. an image or chunk data) transmitted by the device where '0' is a reserved value, which will never be used, thus values like this will be transmitted in a round robin scheme: 1, 2, 3, ..., 65535, 1, 2, ...
For devices complying with version 2.0 and greater of the GigE Vision specification, this will be a 64 bit counter that will be incremented with every data block(e.g. an image or chunk data) transmitted by the device where '0' is a reserved value, which will never be used, thus values like this will be transmitted in a round robin scheme: 1, 2, 3, ..., ((2^64)-1), 1, 2, ...
For USB3 Vision compliant devices, this will be a 64 bit counter that will be incremented with every data block(e.g. an image or chunk data) transmitted by the device, thus values like this will be transmitted in a round robin scheme: 0, 1, 2, ..., ((2^64)-1), 0, 1, ...

Please note that due to the nature of mvIMPACT.acquire.amContinuous there might be gaps between the last image of a continuous stream and the first image of the next continuous stream if the device is stopped or re-programmed in between.

◆ infoFrameNr

infoFrameNr = property(lib_mvIMPACT_acquire.Request_infoFrameNr_get, doc=)

static

A 64 bit integer property (read-only, zero-based) containing the number of image requests processed since this driver instance has been opened.

This counter is incremented regardless of the result this request is returned with thus also e.g. if a request did time out, was aborted(e.g. due to a call to mvIMPACT.acquire.FunctionInterface.imageRequestReset or mvIMPACT.acquire.FunctionInterface.acquisitionStop) or the data was not completely captured. So if a mvIMPACT.acquire.Request object contains the value 6 here, 6 requests have been processed before this one(the first request would contain the value 0) This value is reset to 0 only if the current driver instance is closed.

◆ infoGain_dB

infoGain_dB = property(lib_mvIMPACT_acquire.Request_infoGain_dB_get, doc=)

static

A float property (read-only) containing the gain(in dB) this image has been taken with.

Note: When working with the mvIMPACT.acquire.dilGenICam this value will reflect the last value of the corresponding device property when it was written thus is a cached copy of the value that has been set by the application. For various operation modes this might NOT be the value actually used by the device for taking the image described by this request object. For example when AGC (gainAuto) is active or the device is operated in a special sequencer mode the value of this property might be incorrect. When precise information about this value is needed it is recommended to work in chunk mode and use the gain provided as chunk information instead.

See also: mvIMPACT.acquire.Device.interfaceLayout,
mvIMPACT.acquire.ChunkDataControl,
mvIMPACT.acquire.AnalogControl.gainAuto,
mvIMPACT.acquire.Request.getChunkGainCount,
mvIMPACT.acquire.Request.getChunkGain

◆ infoImageAverage

infoImageAverage = property(lib_mvIMPACT_acquire.Request_infoImageAverage_get, doc=)

static

Currently unsupported.

◆ infoIOStatesAtExposureEnd

infoIOStatesAtExposureEnd = property(lib_mvIMPACT_acquire.Request_infoIOStatesAtExposureEnd_get, doc=)

static

An integer property (read-only) containing the state of all the IO lines at the end of the frame exposure as a device specific bit field.

See mvIMPACT.acquire.Request.infoIOStatesAtExposureStart for details on how to interpret the data.

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.

◆ infoIOStatesAtExposureStart

infoIOStatesAtExposureStart = property(lib_mvIMPACT_acquire.Request_infoIOStatesAtExposureStart_get, doc=)

static

An integer property (read-only) containing the state of all the IO lines at the beginning of the frame exposure as a device specific bit field.

The following table documents which bit in this property represents the state of which digital I/O for mvBlueFOX devices:

bit	IO
0	in 0
1	in 1
2	in 2(if available)
3	in 3(if available)
4	out 0
5	out 1
6	out 2(if available)
7	out 3(if available)

Attention: This feature is currently only available for mvBlueFOX-MLC devices!

def printIOStateOfAValidRequest(pRequest):
  if pRequest.infoIOStatesAtExposureStart.isValid:
    print(pRequest.infoIOStatesAtExposureStart.name() + ": " + format(pRequest.infoIOStatesAtExposureStart.read(), '32b'))

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.

◆ infoIterator

infoIterator = property (getInfoIterator, None, None, None)

static

A property (read-only) which holds an iterator for iterating inside the info list of the request.

See mvIMPACT.acquire.Request.getInfoIterator()

◆ infoLineCounter

infoLineCounter = property(lib_mvIMPACT_acquire.Request_infoLineCounter_get, doc=)

static

An integer property (read-only) containing the number of lines since the last trigger event.

Will contain

the number of lines since last trigger event of the first line of the snap if line counting is enabled
-1 otherwise

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.

◆ infoMissingData_pc

infoMissingData_pc = property(lib_mvIMPACT_acquire.Request_infoMissingData_pc_get, doc=)

static

A float property (read-only) containing the amount of data missing in the current image.

The value of this property will be 0 almost always. However if a device can detect blocks of missing data and an image request has returned with mvIMPACT.acquire.rrFrameIncomplete to indicate that not all the data has been captured, this property will contain the amount of data missing in percent.

◆ infoSettingUsed

infoSettingUsed = property(lib_mvIMPACT_acquire.Request_infoSettingUsed_get, doc=)

static

A enumerated integer property (read-only) containing the setting that was used for processing this request.

The string representation will be a valid setting name, the integer representation can be casted into a mvIMPACT.acquire.HOBJ type.

◆ infoTimeStamp_us

infoTimeStamp_us = property(lib_mvIMPACT_acquire.Request_infoTimeStamp_us_get, doc=)

static

A 64 bit integer property (read-only) containing a timestamp to define the exact time this image has been captured (usually either at exposure start or exposure end, depending on the device).

mvBlueFOX specific: The counter of the timestamp starts when the camera gets initialized. It is measured in us.

◆ infoTransferDelay_us

infoTransferDelay_us = property(lib_mvIMPACT_acquire.Request_infoTransferDelay_us_get, doc=)

static

An integer property (read-only) containing the time the transaction of this image has been delayed (in us) because either the bus was blocked or the CPU was busy.

Normally this value will be 0. A value larger than 0 indicates that the system can't manage the current load.

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.

◆ infoVideoChannel

infoVideoChannel = property(lib_mvIMPACT_acquire.Request_infoVideoChannel_get, doc=)

static

An integer property (read-only) containing the video input channel of the device this image has been acquired from.

Note: This property is not supported by every device and will only be available if the device has more than one input channel. Therefore always call the function mvIMPACT.acquire.Component.isValid to check if this property is available or not.

◆ isOK

isOK = property (getIsOK, None, None, None)

static

A bool property (read-only) which checks if a request has been processed successfully.

See mvIMPACT.acquire.Request.getIsOK()

◆ number

number = property (getNumber, None, None, None)

static

An integer property (read-only) which holds the number associated with this request.

See mvIMPACT.acquire.Request.getNumber()

◆ payloadType

payloadType = property(lib_mvIMPACT_acquire.Request_payloadType_get, doc=)

static

An enumerated integer property (read-only) defining the payload type of this request.

This parameter indicates the current payload type of this request.

Valid values for this property may be: mvIMPACT.acquire.ptUnknown, mvIMPACT.acquire.pt2DImage, mvIMPACT.acquire.ptJPEG, mvIMPACT.acquire.ptJPEG2000, mvIMPACT.acquire.ptH264, mvIMPACT.acquire.ptChunkOnly, mvIMPACT.acquire.ptMultiPart, mvIMPACT.acquire.ptGenDC.

Since: 3.2.0

◆ requestResult

requestResult = property(lib_mvIMPACT_acquire.Request_requestResult_get, doc=)

static

An enumerated integer property (read-only) defining the result of this request.

This parameter indicates whether a previous image acquisition has been successful or not.

◆ requestState

requestState = property(lib_mvIMPACT_acquire.Request_requestState_get, doc=)

static

An enumerated integer property (read-only) defining the current state of this request.

This parameter indicates the current state of this request. A mvIMPACT.acquire.Request e.g. can currently be idle. This would mean that it is currently not used for image acquisition. Also a mvIMPACT.acquire.Request can be in 'Capturing' state, which means it is currently processed by the driver.

Valid values for this property may be: mvIMPACT.acquire.rsIdle, mvIMPACT.acquire.rsWaiting, mvIMPACT.acquire.rsCapturing, mvIMPACT.acquire.rsReady, mvIMPACT.acquire.rsBeingConfigured.

◆ thisown

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

static

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

Member Function Documentation

◆ __disown__()

◆ attachUserBuffer()

◆ configure()

◆ detachUserBuffer()

◆ getBufferPart()

◆ getBufferPartCount()

◆ getChunkCounterCount()

◆ getChunkCounterValue()

◆ getChunkGain()

◆ getChunkGainCount()

◆ getChunkTimerCount()

◆ getChunkTimerValue()

◆ getComponentLocator()

◆ getHasProcessingBeenSkipped()

◆ getImageBufferDesc()

◆ getImageProcessingResultsIterator()

◆ getInfoIterator()

◆ getIsOK()

◆ getName()

◆ getNumber()

◆ save()

◆ unlock()

Property Documentation

◆ bufferSizeFilled

◆ chunkDynamicRangeMax

◆ chunkDynamicRangeMin

◆ chunkExposureTime

◆ chunkHeight

◆ chunkLineStatusAll

◆ chunkmvCustomIdentifier

◆ chunkOffsetX

◆ chunkOffsetY

◆ chunkPixelFormat

◆ chunkSequencerSetActive

◆ chunkTimestamp

◆ chunkWidth

◆ hasProcessingBeenSkipped

◆ imageBayerMosaicParity

◆ imageBufferDesc

◆ imageBytesPerPixel

◆ imageChannelBitDepth

◆ imageChannelCount

◆ imageChannelDesc

◆ imageChannelOffset

◆ imageData

◆ imageFooter

◆ imageFooterSize

◆ imageHeight

◆ imageHeightTotal

◆ imageLinePitch

◆ imageMemoryMode

◆ imageOffsetX

◆ imageOffsetY

◆ imagePixelFormat

◆ imagePixelPitch

◆ imageSize

◆ imageWidth

◆ imageWidthTotal

◆ infoCameraOutputUsed

◆ infoExposeStart_us

◆ infoExposeTime_us

◆ infoFrameID

◆ infoFrameNr

◆ infoGain_dB

◆ infoImageAverage

◆ infoIOStatesAtExposureEnd

◆ infoIOStatesAtExposureStart

◆ infoIterator

◆ infoLineCounter

◆ infoMissingData_pc

◆ infoSettingUsed

◆ infoTimeStamp_us

◆ infoTransferDelay_us

◆ infoVideoChannel

◆ init()

◆ disown()