Scan3dControl Class Reference

Category for control of 3D camera specific features. More...

Inheritance diagram for Scan3dControl:

Public Member Functions
	__init__ (self, *args)
	Constructs a new mvIMPACT.acquire.Scan3dControl object.

Properties
	scan3dAxisMax = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dAxisMax_get, doc=)
	A floating point property.
	scan3dAxisMin = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dAxisMin_get, doc=)
	A floating point property.
	scan3dBaseline = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dBaseline_get, doc=)
	A floating point property.
	scan3dCoordinateOffset = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateOffset_get, doc=)
	A floating point property.
	scan3dCoordinateReferenceSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateReferenceSelector_get, doc=)
	An enumerated integer property.
	scan3dCoordinateReferenceValue = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateReferenceValue_get, doc=)
	A floating point property.
	scan3dCoordinateScale = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateScale_get, doc=)
	A floating point property.
	scan3dCoordinateSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateSelector_get, doc=)
	An enumerated integer property.
	scan3dCoordinateSystem = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateSystem_get, doc=)
	An enumerated integer property.
	scan3dCoordinateSystemReference = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateSystemReference_get, doc=)
	An enumerated integer property.
	scan3dCoordinateTransformSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateTransformSelector_get, doc=)
	An enumerated integer property.
	scan3dDistanceUnit = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dDistanceUnit_get, doc=)
	An enumerated integer property.
	scan3dExtractionMethod = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dExtractionMethod_get, doc=)
	An enumerated integer property.
	scan3dExtractionSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dExtractionSelector_get, doc=)
	An enumerated integer property.
	scan3dExtractionSource = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dExtractionSource_get, doc=)
	An enumerated integer property.
	scan3dFocalLength = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dFocalLength_get, doc=)
	A floating point property.
	scan3dInvalidDataFlag = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dInvalidDataFlag_get, doc=)
	A boolean property.
	scan3dInvalidDataValue = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dInvalidDataValue_get, doc=)
	A floating point property.
	scan3dOutputMode = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dOutputMode_get, doc=)
	An enumerated integer property.
	scan3dPrincipalPointU = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dPrincipalPointU_get, doc=)
	A floating point property.
	scan3dPrincipalPointV = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dPrincipalPointV_get, doc=)
	A floating point property.
	scan3dTransformValue = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dTransformValue_get, doc=)
	A floating point property.
	thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")

Detailed Description

Category for control of 3D camera specific features.

A category for control of 3D camera specific features.

Constructor & Destructor Documentation

__init__()

__init__	(		self,
		*	args )

Constructs a new mvIMPACT.acquire.Scan3dControl object.

Parameters

pDev	[in] A pointer to a mvIMPACT.acquire.Device object obtained from a mvIMPACT.acquire.DeviceManager object.
settingName	[in] The name of the driver internal setting to access with this instance. A list of valid setting names can be obtained by a call to mvIMPACT.acquire.FunctionInterface.getAvailableSettings, new settings can be created with the function mvIMPACT.acquire.FunctionInterface.createSetting

Property Documentation

scan3dAxisMax

scan3dAxisMax = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dAxisMax_get, doc=)

static

A floating point property.

Maximum valid transmitted coordinate value of the selected Axis.

Maximum valid transmitted coordinate value of the selected Axis.

scan3dAxisMin

scan3dAxisMin = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dAxisMin_get, doc=)

static

A floating point property.

Minimum valid transmitted coordinate value of the selected Axis.

Minimum valid transmitted coordinate value of the selected Axis.

scan3dBaseline

scan3dBaseline = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dBaseline_get, doc=)

static

A floating point property.

Returns the baseline as the physical distance of two cameras in a stereo camera setup.

Returns the baseline as the physical distance of two cameras in a stereo camera setup. The value of this feature can be used for 3D reconstruction from disparity images. In this case, the unit of the 3D coordinates corresponds to the unit of the baseline.

scan3dCoordinateOffset

scan3dCoordinateOffset = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateOffset_get, doc=)

static

A floating point property.

Offset when transforming a pixel from relative coordinates to world coordinates.

Offset when transforming a pixel from relative coordinates to world coordinates.

scan3dCoordinateReferenceSelector

scan3dCoordinateReferenceSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateReferenceSelector_get, doc=)

static

An enumerated integer property.

Sets the index to read a coordinate system reference value defining the transform of a point from the current (Anchor or Transformed) system to the reference system.

Sets the index to read a coordinate system reference value defining the transform of a point from the current (Anchor or Transformed) system to the reference system.

The following string values might be valid for this feature:

• RotationX (Display string: 'Rotation X'): Rotation around X axis.
• RotationY (Display string: 'Rotation Y'): Rotation around Y axis.
• RotationZ (Display string: 'Rotation Z'): Rotation around Z axis.
• TranslationX (Display string: 'Translation X'): X axis translation.
• TranslationY (Display string: 'Translation Y'): Y axis translation.
• TranslationZ (Display string: 'Translation Z'): Z axis translation.

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dCoordinateReferenceValue

scan3dCoordinateReferenceValue = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateReferenceValue_get, doc=)

static

A floating point property.

Returns the reference value selected.

Returns the reference value selected. Reads the value of a rotation or translation value for the current (Anchor or Transformed) coordinate system transformation to the Reference system.

scan3dCoordinateScale

scan3dCoordinateScale = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateScale_get, doc=)

static

A floating point property.

Scale factor when transforming a pixel from relative coordinates to world coordinates.

Scale factor when transforming a pixel from relative coordinates to world coordinates.

scan3dCoordinateSelector

scan3dCoordinateSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateSelector_get, doc=)

static

An enumerated integer property.

Selects the individual coordinates in the vectors for 3D information/transformation.

Selects the individual coordinates in the vectors for 3D information/transformation.

The following string values might be valid for this feature:

• CoordinateA (Display string: 'Coordinate A'): The first (X or Theta) coordinate
• CoordinateB (Display string: 'Coordinate B'): The second (Y or Phi) coordinate
• CoordinateC (Display string: 'Coordinate C'): The third (Z or Rho) coordinate.

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dCoordinateSystem

scan3dCoordinateSystem = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateSystem_get, doc=)

static

An enumerated integer property.

Specifies the Coordinate system to use for the device.

Specifies the Coordinate system to use for the device.

The following string values might be valid for this feature:

• Cartesian (Display string: 'Cartesian'): Default value. 3-axis orthogonal, right-hand X-Y-Z.
• Spherical (Display string: 'Spherical'): A Theta-Phi-Rho coordinate system.
• Cylindrical (Display string: 'Cylindrical'): A Theta-Y-Rho coordinate system.
• Default-specific (Display string: 'Default-specific')

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dCoordinateSystemReference

scan3dCoordinateSystemReference = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateSystemReference_get, doc=)

static

An enumerated integer property.

Defines coordinate system reference location.

Defines coordinate system reference location.

The following string values might be valid for this feature:

• Anchor (Display string: 'Anchor'): Default value. Original fixed reference. The coordinate system fixed relative the camera reference point marker is used.
• Transformed (Display string: 'Transformed'): Transformed reference system. The transformed coordinate system is used according to the definition in the rotation and translation matrices.

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dCoordinateTransformSelector

scan3dCoordinateTransformSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dCoordinateTransformSelector_get, doc=)

static

An enumerated integer property.

Sets the index to read/write a coordinate transform value.

Sets the index to read/write a coordinate transform value.

The following string values might be valid for this feature:

• RotationX (Display string: 'Rotation X'): Rotation around X axis.
• RotationY (Display string: 'Rotation Y'): Rotation around Y axis.
• RotationZ (Display string: 'Rotation Z'): Rotation around Z axis.
• TranslationX (Display string: 'Translation X'): Translation along X axis.
• TranslationY (Display string: 'Translation Y'): Translation along Y axis.
• TranslationZ (Display string: 'Translation Z'): Translation along Z axis.

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dDistanceUnit

scan3dDistanceUnit = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dDistanceUnit_get, doc=)

static

An enumerated integer property.

Specifies the unit used when delivering (calibrated) distance data.

Specifies the unit used when delivering (calibrated) distance data.

The following string values might be valid for this feature:

• Millimeter (Display string: 'Millimeter'): Distance values are in millimeter units (default).
• Meter (Display string: 'Meter'): Distance values are in meter units.
• Inch (Display string: 'Inch'): Distance values are in inch units.
• Pixel (Display string: 'Pixel'): Distance values are given as a multiple of the size of a pixel.
• Default-specific (Display string: 'Default-specific')

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dExtractionMethod

scan3dExtractionMethod = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dExtractionMethod_get, doc=)

static

An enumerated integer property.

Selects the method for extracting 3D from the input sensor data.

Selects the method for extracting 3D from the input sensor data.

The following string values might be valid for this feature:

• Default (Display string: 'Default'): Default range extraction method for the device.
• Default-specific (Display string: 'Default-specific')

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dExtractionSelector

scan3dExtractionSelector = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dExtractionSelector_get, doc=)

static

An enumerated integer property.

Selects the 3D Extraction processing module to control (if multiple ones are present).

Selects the 3D Extraction processing module to control (if multiple ones are present).

The following string values might be valid for this feature:

• Scan3dExtraction0 (Display string: 'Scan 3d Extraction 0'): Selects Scan3d Extraction module 0.
• Scan3dExtraction1 (Display string: 'Scan 3d Extraction 1'): Selects Scan3d Extraction module 1.
• Scan3dExtraction2 (Display string: 'Scan 3d Extraction 2'): Selects Scan3d Extraction module 2.

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dExtractionSource

scan3dExtractionSource = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dExtractionSource_get, doc=)

static

An enumerated integer property.

Selects the sensor's data source region for 3D Extraction module.

Selects the sensor's data source region for 3D Extraction module.

The following string values might be valid for this feature:

• Region0 (Display string: 'Region 0'): Data come from Sensor's Region0.
• Region1 (Display string: 'Region 1'): Data come from Sensor's Region1.
• Region2 (Display string: 'Region 2'): Data come from Sensor's Region2.

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dFocalLength

scan3dFocalLength = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dFocalLength_get, doc=)

static

A floating point property.

Returns the focal length of the camera in pixel.

Returns the focal length of the camera in pixel. The focal length depends on the selected region. The value of this feature takes into account horizontal binning, decimation, or any other function changing the image resolution.

scan3dInvalidDataFlag

scan3dInvalidDataFlag = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dInvalidDataFlag_get, doc=)

static

A boolean property.

Enables the definition of a non-valid flag value in the data stream.

Enables the definition of a non-valid flag value in the data stream. Note that the confidence output is an alternate recommended way to identify non-valid pixels. Using a Scan3dInvalidDataValue may give processing penalties due to special handling.

scan3dInvalidDataValue

scan3dInvalidDataValue = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dInvalidDataValue_get, doc=)

static

A floating point property.

Value which identifies a non-valid pixel if Scan3dInvalidDataFlag is enabled.

Value which identifies a non-valid pixel if Scan3dInvalidDataFlag is enabled.

scan3dOutputMode

scan3dOutputMode = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dOutputMode_get, doc=)

static

An enumerated integer property.

Controls the Calibration and data organization of the device and the coordinates transmitted.

Controls the Calibration and data organization of the device and the coordinates transmitted.

The following string values might be valid for this feature:

• UncalibratedC (Display string: 'Uncalibrated C'): Uncalibrated 2.5D Depth map. The distance data does not represent a physical unit and may be non-linear. The data is a 2.5D range map only.
• CalibratedABC_Grid (Display string: 'Calibrated ABC Grid'): 3 Coordinates in grid organization. The full 3 coordinate data with the grid array organization from the sensor kept.
• CalibratedABC_PointCloud (Display string: 'Calibrated ABC Point Cloud'): 3 Coordinates without organization. The full 3 coordinate data without any organization of data points. Typically only valid points transmitted giving varying image size.
• CalibratedAC (Display string: 'Calibrated AC'): 2 Coordinates with fixed B sampling. The data is sent as a A and C coordinates (X,Z or Theta,Rho). The B (Y) axis uses the scale and offset parameters for the B axis.
• CalibratedAC_Linescan (Display string: 'Calibrated AC Linescan'): 2 Coordinates with varying sampling. The data is sent as a A and C coordinates (X,Z or Theta,Rho). The B (Y) axis comes from the encoder chunk value.
• CalibratedC (Display string: 'Calibrated C'): Calibrated 2.5D Depth map. The distance data is expressed in the chosen distance unit. The data is a 2.5D range map. No information on X-Y axes available.
• CalibratedC_Linescan (Display string: 'Calibrated C Linescan'): Depth Map with varying B sampling. The distance data is expressed in the chosen distance unit. The data is a 2.5D range map. The B (Y) axis comes from the encoder chunk value.
• RectifiedC (Display string: 'Rectified C'): Rectified 2.5D Depth map. The distance data has been rectified to a uniform sampling pattern in the X and Y direction. The data is a 2.5D range map only. If a complete 3D point cloud is rectified but transmitted as explicit coordinates it should be transmitted as one of the 'CalibratedABC' formats.
• RectifiedC_Linescan (Display string: 'Rectified C Linescan'): Rectified 2.5D Depth map with varying B sampling. The data is sent as rectified 1D profiles using Coord3D_C pixels. The B (Y) axis comes from the encoder chunk value.
• DisparityC (Display string: 'Disparity C'): Disparity 2.5D Depth map. The distance is inversely proportional to the pixel (disparity) value.
• DisparityC_Linescan (Display string: 'Disparity C Linescan'): Disparity 2.5D Depth map with varying B sampling. The distance is inversely proportional to the pixel (disparity) value. The B (Y) axis comes from the encoder chunk value.
• CalibratedAC (Display string: 'Calibrated A C ')

Note

Depending on the device some of these values might not be supported and especially when working with third party devices there might be custom values which are not listed here. To get a complete and reliable list of supported values at runtime an application should therefore call mvIMPACT.acquire.PropertyI.getTranslationDictStrings() or one of the other functions dealing with translation dictionaries for enumerated properties.

scan3dPrincipalPointU

scan3dPrincipalPointU = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dPrincipalPointU_get, doc=)

static

A floating point property.

Returns the value of the horizontal position of the principal point, relative to the region origin, i.e.

Returns the value of the horizontal position of the principal point, relative to the region origin, i.e. OffsetX. The value of this feature takes into account horizontal binning, decimation, or any other function changing the image resolution.

scan3dPrincipalPointV

scan3dPrincipalPointV = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dPrincipalPointV_get, doc=)

static

A floating point property.

Returns the value of the vertical position of the principal point, relative to the region origin, i.e.

Returns the value of the vertical position of the principal point, relative to the region origin, i.e. OffsetY. The value of this feature takes into account vertical binning, decimation, or any other function changing the image resolution.

scan3dTransformValue

scan3dTransformValue = property(lib_mvIMPACT_acquire.Scan3dControl_scan3dTransformValue_get, doc=)

static

A floating point property.

Specifies the transform value selected.

Specifies the transform value selected. For translations (Scan3dCoordinateTransformSelector = TranslationX/Y/Z) it is expressed in the distance unit of the system, for rotations (Scan3dCoordinateTransformSelector =RotationX/Y/Z) in degrees.

thisown

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

static