mvIMPACT Acquire SDK C++
SystemBlueFOX Class Reference

A class containing mvBlueFOX specific settings to control the overall behaviour of the driver(Device specific interface layout only). More...

Inheritance diagram for SystemBlueFOX:
SystemSettings ComponentCollection

Public Member Functions

HOBJ hObj (void) const
 Returns a unique identifier for the component collection referenced by this object. More...
 
const ComponentCollectionrestoreDefault (void) const
 Restores the default for every component of this collection. More...
 
 SystemBlueFOX (Device *pDev)
 Constructs a new mvIMPACT::acquire::SystemBlueFOX object. More...
 

Public Attributes

PropertyI acquisitionIdleTimeMax_ms
 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. More...
 
PropertyIAcquisitionMode acquisitionMode
 An enumerated integer property defining the acquisition mode of the device. More...
 
PropertyIBoolean featurePollingEnable
 An enumerated integer property defining whether features defining a polling time shall be updated automatically or not. More...
 
PropertyI featurePollingInterval_ms
 An integer property defining the polling interval in ms the driver waits for each iteration before running through update loop again. More...
 
PropertyIBoolean footerCheckEnable
 An enumerated integer property allowing to switch on/off the check of the image footer. More...
 
PropertyIBlueFOXFooterMode footerMode
 An enumerated integer property defining the footer mode of the device. More...
 
PropertyI imageProcessingMaximumThreadCount
 An integer property influencing the number of parallel threads used by the internal image processing pipeline. More...
 
PropertyIImageProcessingMode imageProcessingMode
 An enumerated integer property influencing the behaviour of the internal image processing pipeline. More...
 
PropertyIImageProcessingOptimization imageProcessingOptimization
 An enumerated integer property influencing the behaviour of the internal image processing algorithms. More...
 
PropertyI methodPollingInterval_ms
 An integer property defining the polling interval in ms the driver waits during each iteration before checking a methods execution state again. More...
 
PropertyI methodPollingMaxRetryCount
 An integer property defining the polling interval in ms the driver waits during each iteration before checking a methods execution state again. More...
 
PropertyIDevicePowerMode powerMode
 An enumerated integer property defining the power mode of the device. More...
 
PropertyI requestCount
 An integer property defining the number of requests allocated by the driver. More...
 
PropertyIBoolean statusLEDEnable
 An enumerated integer property allowing to switch on/off the status LED of the device. More...
 
PropertyIBlueFOXTransferSize transferSize
 An enumerated integer property defining the block size of the image data blocks transferred from the device. More...
 

Protected Attributes

HOBJ m_hRoot
 

Detailed Description

A class containing mvBlueFOX specific settings to control the overall behaviour of the driver(Device specific interface layout only).

Note
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

◆ SystemBlueFOX()

SystemBlueFOX ( Device pDev)
inlineexplicit

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

Parameters
[in]pDevA pointer to a mvIMPACT::acquire::Device object obtained from a mvIMPACT::acquire::DeviceManager object.

Member Function Documentation

◆ hObj()

HOBJ hObj ( void  ) const
inlineinherited

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

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

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

◆ restoreDefault()

const ComponentCollection& restoreDefault ( void  ) const
inlineinherited

Restores the default for every component of this collection.

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

Note
The caller must have the right to modify the component. Otherwise an exception will be thrown.
Returns
A const reference to the component.

Member Data Documentation

◆ acquisitionIdleTimeMax_ms

PropertyI acquisitionIdleTimeMax_ms
inherited

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.

Note
This property will not be available for every device. Right now only devices operated through the GenTL driver package will support this feature.
Since
2.4.1

◆ acquisitionMode

PropertyIAcquisitionMode acquisitionMode
inherited

An enumerated integer property defining the acquisition mode of the device.

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

◆ featurePollingEnable

PropertyIBoolean featurePollingEnable
inherited

An enumerated integer property defining whether features defining a polling time shall be updated automatically or not.

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

See also
mvIMPACT::acquire::SystemSettings::featurePollingInterval_ms

◆ featurePollingInterval_ms

PropertyI featurePollingInterval_ms
inherited

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 it's 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 who's polling time has elapsed.

Note
This property will not be available for every device. Right now only devices operated through the GenTL driver package will support this feature.
Since
2.18.3

◆ footerCheckEnable

PropertyIBoolean footerCheckEnable

An enumerated integer property allowing to switch on/off the check of the image footer.

The image footer contains certain additional data as e.g. the exposure time as used by the image sensor. To debug transfer related problems it sometimes can be useful to disable all internal data consistency checks by the driver.

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

◆ footerMode

An enumerated integer property defining the footer mode of the device.

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

◆ imageProcessingMaximumThreadCount

PropertyI imageProcessingMaximumThreadCount
inherited

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!

Note
This property will only be available on some platforms. Always check if this property is available before using it!
See also
mvIMPACT::acquire::SystemSettings::imageProcessingOptimization
mvIMPACT::acquire::SystemSettings::imageProcessingMode
Multithreading
Since
2.41.0

◆ imageProcessingMode

PropertyIImageProcessingMode imageProcessingMode
inherited

An enumerated integer property influencing the behaviour of the internal image processing pipeline.

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

Note
This property will only be available if mvIMPACT::acquire::Device::userControlledImageProcessingEnable has been set to mvIMPACT::acquire::bTrue before the device is opened.
See also
mvIMPACT::acquire::Device::userControlledImageProcessingEnable
mvIMPACT::acquire::Request::hasProcessingBeenSkipped
Since
2.14.0

◆ imageProcessingOptimization

PropertyIImageProcessingOptimization imageProcessingOptimization
inherited

An enumerated integer property influencing the behaviour of the internal image processing algorithms.

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

Since
2.12.2

◆ m_hRoot

HOBJ m_hRoot
protectedinherited

◆ methodPollingInterval_ms

PropertyI methodPollingInterval_ms
inherited

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.

Note
This property will not be available for every device. Right now only devices operated through the GenTL driver package will support this feature.
Since
2.18.3

◆ methodPollingMaxRetryCount

PropertyI methodPollingMaxRetryCount
inherited

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.

Note
This property will not be available for every device. Right now only devices operated through the GenTL driver package will support this feature.
Since
2.18.3

◆ powerMode

An enumerated integer property defining the power mode of the device.

Note
This property requires at least firmware version 39! See mvIMPACT::acquire::Device::firmwareVersion to find out which firmware is currently running on the device or use mvIMPACT::acquire::Device::updateFirmware() to update the firmware to the state compiled into the driver.
Do NOT modify this property when images are acquired in parallel. Switching off or on the power for a device that is capturing images at the same time will result in incorrect images! Therefore always make sure to stop image acquisition and clean up BEFORE modifying this property.

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

◆ requestCount

PropertyI requestCount
inherited

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.

Note
For performance reasons this value can be increased at any time(only exception: Working with the interface layout mvIMPACT::acquire::dilGenICam while streaming is active) but can only be decreased when no request object is currently locked by the application and no requests has been queued for acquisition. So modifying this value might require the application to call mvIMPACT::acquire::FunctionInterface::imageRequestReset and several calls to mvIMPACT::acquire::Request::unlock before.

There are not too many reasons to modify the default request count suggested by the device driver. Good reasons include:

  • a single image is huge compared to the overall system memory(e.g. a single image has 200MB while the system itself only has about 2GB of RAM. Here it might make sense to reduce the number of capture buffers to 1 or 2. Please note that in such a scenario double buffering or live display when one buffer is constantly blocked by the display engine can become a challenge!
  • the frame rate is high(larger than 100 frames per second) and no frames shall be lost. Here it might make sense to set the number of capture buffers to something like frame rate divided by 2 to 5 as a rule of thumb.
See also
mvIMPACT::acquire::FunctionInterface::requestCount

◆ statusLEDEnable

PropertyIBoolean statusLEDEnable

An enumerated integer property allowing to switch on/off the status LED of the device.

Note
This feature is currently available for mvBlueFOX-MLC devices only.

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

Since
2.17.0

◆ transferSize

An enumerated integer property defining the block size of the image data blocks transferred from the device.

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


The documentation for this class was generated from the following file: