Balluff - mvVirtualDevice Technical Documentation
Appendix A. Device Feature And Property List

Device Feature And Property List

ProductFeatures
Feature Name Min Max Inc Valid Values Documentation
ProductFeatures This list has been created with Impact Acquire version '3.4.0' and firmware version '666'. This does NOT imply that all these features will only be available since these versions. They might be available in previous ones as well.
Feature Name Min Max Inc Valid Values Documentation
Camera This list contains features to control the device
BufferPartCount 0 3 - - This property defines the number of buffer parts that will be transmitted. Part 1 always contains the actual image, part 2 will contain a static JPEG image! Setting this parameter to 0 will disable the multi-part transmission.
AoiMode - - - Full,
User
When 'TestMode' is set to 'ImageDirectory' this will allow to enforce a certain image dimension ('User') or to capture every image file in its original dimensions ('Full')
PixelFormat - - - Auto,
Raw,
Mono8,
Mono10,
Mono12,
Mono12Packed_V1,
Mono12Packed_V2,
Mono14,
Mono16,
BGR888Packed,
BGR101010Packed_V2,
RGB888Packed,
RGB101010Packed,
RGB121212Packed,
RGB141414Packed,
RGB161616Packed,
RGBx888Packed,
RGB888Planar,
RGBx888Planar,
YUV411_UYYVYY_Packed,
YUV422Packed,
YUV422_UYVYPacked,
YUV422_10Packed,
YUV422_UYVY_10Packed,
YUV444_UYVPacked,
YUV444_UYV_10Packed,
YUV444Packed,
YUV444_10Packed,
YUV422Planar
Defines the transfer pixel format from the capture device into the host systems memory. This can differ from the pixel format delivered to the user application if needed.
Gain_dB -12.000 dB 12.000 dB 0.250 dB - A floating point property to define the gain in dB
TestMode - - - MovingBGR888PackedImage,
MovingBGRPacked_V2Ramp,
MovingRGB888PackedImage,
MovingRGBx888PackedImage,
MovingRGB101010PackedImage,
MovingRGB121212PackedImage,
MovingRGB141414PackedImage,
MovingRGB161616PackedImage,
MovingRGB888PlanarImage,
MovingRGBx888PlanarImage,
HorizontalMonoRamp,
HorizontalMono12Packed_V1Ramp,
HorizontalMono12Packed_V2Ramp,
HorizontalBayer12Packed_V1Ramp,
HorizontalBayer12Packed_V2Ramp,
VerticalMonoRamp,
MovingMonoRamp,
MovingVerticalMonoRamp,
EmptyMonoBuffer,
MovingYUV422PackedRamp,
MovingYUV422_UYVYPackedRamp,
MovingYUV444PackedRamp,
MovingYUV444_UYVPackedRamp,
MovingYUV422PlanarRamp,
MovingBayerDataRamp,
BayerWhiteBalanceTestImage,
ImageDirectory,
LeakyPixelTestImageMono8Bayer,
HotAndColdPixelTestImageBayer,
HotAndColdPixelTestImageRGB888Packed
Defines the pixel format delivered by the device function node
ChannelBitDepth 8 16 2 - -
PaddingX 0 63 1 - Defines the horizontal padding per line(this has impact on the pitch)
TapsXGeometry - - - 1X,
1X2,
2X,
2XE,
2XM,
1X3,
3X,
1X4,
4X,
2X2,
2X2E,
2X2M,
4XE,
1X8,
8X,
4X2,
4X2E
This will attach an X tap configuration attribute to the image. This can be used to test the tap sort filter. The filter can handle mono buffer formats only
TapsYGeometry - - - 1Y,
1Y2,
2YE
This will attach an Y tap configuration attribute to the image. This can be used to test the tap sort filter. The filter can handle mono buffer formats only
FrameDelay_us 0 INT_MAX - - -
ImageDirectory - - - - -
ImageType - 31 - None,
BMP,
PGM,
PNG,
JPG,
TIFF
Currently for BMP only 8-bit grey-scale and 24-bit RGB images and for PGM only 8, 10, 12, 14 and 16-bit grey-scale PGM images are supported
BayerMosaicParity - - - Undefined,
Green-red,
Red-green,
Blue-green,
Green-blue
When images are acquired via a directory, or a Bayer test pattern is generated this can be used to specify the Bayer parity. 'Undefined' will unset the buffers Bayer attribute thus will result in a grey(mono) buffer being returned
TestImageBarWidth 1 100 - - -
UserData - - - - This string will be copied into the UserData property of the request
ImageRequestTimeout_ms 0 ms INT_MAX 1 ms - Defines the timeout for the request in ms. Once the timeout has elapsed the request object is returned to the user even if no data has been captured into it. 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 will cause the last buffer to time out 3000*4 = 12000 ms AFTER the buffer has been queued and the acquisition has been started. A timeout of 0 never elapses.
Feature Name Min Max Inc Valid Values Documentation
Aoi This list contains features to describe an Area Of Interest(AOI)
X 0 8191 1 - -
Y 0 8191 1 - -
W 2 8192 1 - -
H 2 8192 1 - -
Feature Name Min Max Inc Valid Values Documentation
PseudoFeatures This list contains a lot of pretty useless features that are meant to check GUI behaviour etc.
PseudoCombinableProperty - 15 - Nothing,
Apple,
Orange,
Peach,
Kiwi
-
PseudoFileNameProperty - - - - -
Pseudo64BitIntProp -10000 2251799813685248 - - -
Pseudo64BitIntHexProp 0x0 0x8000000000000 - - -
Pseudo64BitIPProp INT64_MIN INT64_MAX - - -
PseudoBinaryProp - - - - This property can be used to store binary data(up to 512 bytes)
PseudoIntVectorProp 0 INT_MAX - - -
PseudoIntEnumVectorProp - - - First,
Second,
Third
-
PseudoInt64VectorProp INT64_MIN INT64_MAX - - -
PseudoFloatVectorProp 0.00000 DBL_MAX - - -
PseudoFloatEnumProp - - - Pi,
SquareRootOfTwo,
SquareRootOfThree
-
PseudoStringVectorProp - - - - This is a string vector property of variable size
PseudoPointerVectorProp - - - - -
PseudoMethod@iiIfs - - - - Calling this function will write the parameters passed to the function converted into their actual type and then back into a string to 'PseudoMethodStringBuffer'
PseudoMethodStringBuffer - - - - -
PseudoSleepMethod@i - - - - Calling this function will simply block the calling thread for 2000 ms