- Generated on Thu Jun 27 2024 18:46:33
|
Impact Acquire SDK Python
|
A base class for accessing settings that control the overall behaviour of a device driver. More...
Public Member Functions | |
| __init__ (self, pDev) | |
| Constructs a new mvIMPACT.acquire.SystemSettings object. | |
Properties | |
| acquisitionIdleTimeMax_ms = property(lib_mvIMPACT_acquire.SystemSettings_acquisitionIdleTimeMax_ms_get, doc=) | |
| An integer property defining the maximum time in ms the driver waits for new requests being queued until streaming by the device will automatically be stopped. | |
| acquisitionMode = property(lib_mvIMPACT_acquire.SystemSettings_acquisitionMode_get, doc=) | |
| An enumerated integer property defining the acquisition mode of the device. | |
| featurePollingEnable = property(lib_mvIMPACT_acquire.SystemSettings_featurePollingEnable_get, doc=) | |
| An enumerated integer property defining whether features defining a polling time shall be updated automatically or not. | |
| featurePollingInterval_ms = property(lib_mvIMPACT_acquire.SystemSettings_featurePollingInterval_ms_get, doc=) | |
| An integer property defining the polling interval in ms the driver waits for each iteration before running through update loop again. | |
| genDCParserEnable = property(lib_mvIMPACT_acquire.SystemSettings_genDCParserEnable_get, doc=) | |
| An enumerated integer property which can be used to enable/disable automatic GenICam™ GenDC Container parsing. | |
| imageProcessingMaximumThreadCount = property(lib_mvIMPACT_acquire.SystemSettings_imageProcessingMaximumThreadCount_get, doc=) | |
| An integer property influencing the number of parallel threads used by the internal image processing pipeline. | |
| imageProcessingMode = property(lib_mvIMPACT_acquire.SystemSettings_imageProcessingMode_get, doc=) | |
| An enumerated integer property influencing the behaviour of the internal image processing pipeline. | |
| imageProcessingOptimization = property(lib_mvIMPACT_acquire.SystemSettings_imageProcessingOptimization_get, doc=) | |
| An enumerated integer property influencing the behaviour of the internal image processing algorithms. | |
| methodPollingInterval_ms = property(lib_mvIMPACT_acquire.SystemSettings_methodPollingInterval_ms_get, doc=) | |
| An integer property defining the polling interval in ms the driver waits during each iteration before checking a methods execution state again. | |
| methodPollingMaxRetryCount = property(lib_mvIMPACT_acquire.SystemSettings_methodPollingMaxRetryCount_get, doc=) | |
| An integer property defining the polling interval in ms the driver waits during each iteration before checking a methods execution state again. | |
| requestCount = property(lib_mvIMPACT_acquire.SystemSettings_requestCount_get, doc=) | |
| An integer property defining the number of requests allocated by the driver. | |
| thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag") | |
A base class for accessing settings that control the overall behaviour of a device driver.
Instances of this class can't be constructed directly. Use one of the derived types.
| __init__ | ( | self, | |
| pDev ) |
Constructs a new mvIMPACT.acquire.SystemSettings object.
| pDev | [in] A pointer to a mvIMPACT.acquire.Device object obtained from a mvIMPACT.acquire.DeviceManager object. |
Reimplemented from ComponentCollection.
Reimplemented in SystemBlueFOX, and SystemV4L2.
|
static |
An integer property defining the maximum time in ms the driver waits for new requests being queued until streaming by the device will automatically be stopped.
This property defines the maximum time in milliseconds the driver waits for new mvIMPACT.acquire.Request objects being queued by calling mvIMPACT.acquire.FunctionInterface.imageRequestSingle once the driver will automatically send an acquisition stop command to a streaming device (such as a GigE Vision or USB3 Vision device) when the driver's request queue has run empty (thus the driver has no more buffers to capture data into).
This property will only be taken into account when mvIMPACT.acquire.Device.acquisitionStartStopBehaviour has been set to mvIMPACT.acquire.assbDefault.
|
static |
An enumerated integer property defining the acquisition mode of the device.
Valid values for this property may be: mvIMPACT.acquire.amContinuous, mvIMPACT.acquire.amMultiFrame, mvIMPACT.acquire.amSingleFrame.
|
static |
An enumerated integer property defining whether features defining a polling time shall be updated automatically or not.
Valid values for this property may be: mvIMPACT.acquire.bFalse, mvIMPACT.acquire.bTrue.
|
static |
An integer property defining the polling interval in ms the driver waits for each iteration before running through update loop again.
Some features define a so called polling time. This is a recommendation by the device/driver stating that this property might change its value without user interaction act a certain rate (e.g. the device temperature could be one example for a feature with such a behaviour). When mvIMPACT.acquire.SystemSettings.featurePollingEnable is set to mvIMPACT.acquire.bTrue a thread will check every featurePollingInterval_ms if features need to be updated. This will only cause communication with a device for each feature whose polling time has elapsed.
|
static |
An enumerated integer property which can be used to enable/disable automatic GenICam™ GenDC Container parsing.
When working with a GenICam™ compliant device, that transmits data using the GenDC format this property can be used to switch on/off the automatic parsing of the received containers. The default value of this property will be mvIMPACT.acquire.bTrue, so a GenDC container will be parsed upon reception and will be reported as the individual components like described here. This results in slightly more CPU time being consumed which sometimes might not be desirable since the GenDC Containers shall be processed later by another entity of the application or shall just be written to some storage location for off-line processing at a later moment in time. When this property is set to mvIMPACT.acquire.bFalse the data buffer will reported as a raw GenDC Container. mvIMPACT.acquire.Request.payloadType will return mvIMPACT.acquire.ptGenDC then and mvIMPACT.acquire.Request.imagePixelFormat will be mvIMPACT.acquire.ibpfRaw then. mvIMPACT.acquire.Request.imageData and mvIMPACT.acquire.Request.imageSize however can directly be fed into any GenDC capable algorithm.
Valid values for this property may be: mvIMPACT.acquire.bFalse, mvIMPACT.acquire.bTrue.
|
static |
An integer property influencing the number of parallel threads used by the internal image processing pipeline.
This property can be used to control the size of the internal thread pool used for image processing tasks. Using a value higher than the number of physical CPU cores usually has a negative impact on the performance. Use with care!
|
static |
An enumerated integer property influencing the behaviour of the internal image processing pipeline.
Valid values for this property may be: mvIMPACT.acquire.ipmDefault, mvIMPACT.acquire.ipmProcessLatestOnly.
|
static |
An enumerated integer property influencing the behaviour of the internal image processing algorithms.
Valid values for this property may be: mvIMPACT.acquire.ipoMaximizeSpeed, mvIMPACT.acquire.ipoMinimizeMemoryUsage.
|
static |
An integer property defining the polling interval in ms the driver waits during each iteration before checking a methods execution state again.
When working with a GenICam™ compliant device, GenICam™ method objects need to be checked for their completion status every now and then. This parameter defines how often this shall be done.
|
static |
An integer property defining the polling interval in ms the driver waits during each iteration before checking a methods execution state again.
When working with a GenICam™ compliant device, GenICam™ method objects need to be checked for their completion status every now and then. This parameter defines how often this shall be done at all. A method is checked for completion methodPollingMaxRetryCount * methodPollingInterval_ms at max. Until then either the device starts to inform the driver that it needs more time OR the execution of the method has completed successfully or an error will be generated.
|
static |
An integer property defining the number of requests allocated by the driver.
Each request object can be used to capture data into. Multiple requests can be processed by a device driver as background tasks.
Setting this property to a value at least allowing a driver to capture data for up to 500ms without user interaction (thus 0.5 times the expected frame rate) is highly recommended. Increasing this value will NOT introduce additional latency to your application. The only drawback will be additional RAM consumption by the driver but applications that do not need to copy the request buffers can even benefit from that as the overall memory fragmentation is likely to go down then. Values smaller than 3 most likely result in undesired behaviour and should be avoided unless absolutely needed.
There are not too many reasons to modify the default request count suggested by the device driver. Good reasons include:
|
static |