MbufControlContainer

Specifies that the buffer stores right-handed cartesian coordinates.

If the buffer is a 1-band buffer, its values will be interpreted as Z-coordinates (equivalent to the pixels of a depth map).

If the buffer is a 3-band buffer, the bands store the following:

This is the default value.

Specifies that the buffer stores cylindrical coordinates (theta-Y-rho).

In a cylindrical coordinate system, points are defined relative to a reference axis and reference angle perpendicular to that axis. The Y-coordinate is the distance from the origin along the reference axis, theta (θ) is the polar angle of the point relative to a reference angle, and rho is the distance from that axis along the line described by theta and perpendicular to the reference axis (the radius).

If the buffer is a 1-band buffer, its values store rho, the distance from a chosen reference axis.

If the buffer is a 3-band buffer, the bands store the following:

Specifies that the buffer stores spherical coordinates (theta-phi-rho).

In a spherical coordinate system, points are defined relative to a reference axis and a reference angle perpendicular to that axis. Rho is the distance from the origin (the radius), theta (θ) is the elevation angle of the point relative to reference axis, and phi is the azimuthal angle relative to the reference angle.

If the buffer is a 1-band buffer, its values store rho, the distance from a chosen reference axis.

If the buffer is a 3-band buffer, the bands store the following:

Specifies the stereo baseline value, expressed in meters.

The default value is 1.0.

Specifies the focal length of the lenses of the stereoscopic camera used to generate the data in the buffer if it stores a disparity map, expressed in pixels. For example, if the disparity map has 1000 pixels per millimeter of a single image sensor (after calibration), and the focal length of the lenses in millimeters is 35, the focal length in pixels is 35000.

The default value is 1.0.

Specifies X-position of the principal point, expressed in pixels.

The default value is 0.0.

Specifies Y-position of the principal point, expressed in pixels.

The default value is 0.0.

Specifies that the distance data is provided in pixels. This setting is only useful for buffers that have the component type M_COMPONENT_DISPARITY and store a disparity map.

Specifies that the distance unit is unknown.

This is the default value.

Specifies that the buffer does not use a special value to indicate invalid data.

This is the default value.

Specifies the value used to indicate missing data.

The default value is 0.0.

Specifies by how much the X-coordinates stored in the buffer will be offset.

The default value is 0.0.

Specifies by how much the Y-coordinates stored in the buffer will be offset.

The default value is 0.0.

Specifies by how much the Z-coordinates stored in the buffer will be offset.

The default value is 0.0.

Specifies that the component stores organized and natively calibrated X, Y, and Z-coordinates.

This is the default value for 3-band buffers with M_SIZE_Y greater than 1.

This corresponds to the GenICam Scan3dOutputMode feature set to CalibratedABC_Grid.

Specifies that the component stores unorganized and natively calibrated X, Y, and Z-coordinates.

This is the default value for 3-band buffers with M_SIZE_Y of 1.

This corresponds to the GenICam Scan3dOutputMode feature set to CalibratedABC_PointCloud.

Specifies that the component stores organized and natively calibrated X and Z-coordinates, with Y-coordinates stored in a separate array buffer.

This corresponds to the GenICam Scan3dOutputMode feature set to CalibratedAC_Linescan.

Specifies that the component stores organized and natively calibrated X and Z-coordinates, with Y-coordinates identified by the row index.

This corresponds to the GenICam Scan3dOutputMode feature set to CalibratedAC.

Specifies that the component stores organized and natively calibrated Z-coordinates, without X and Y-coordinates.

This corresponds to the GenICam Scan3dOutputMode feature set to CalibratedC.

Specifies that the component stores organized and natively calibrated Z-coordinates without X-coordinates; Y-coordinates are stored in a separate buffer that has an M_ARRAY attribute and is not part of the container.

This corresponds to the GenICam Scan3dOutputMode feature set to CalibratedC_Linescan.

Specifies that the component stores organized and natively calibrated Z-coordinates, with the X-coordinates identified by column index; Y-coordinates are stored in a separate buffer that has an M_ARRAY attribute and is not part of the container.

This corresponds to the GenICam Scan3dOutputMode feature set to RectifiedC_Linescan.

Specifies that the component stores organized and natively calibrated Z-coordinates, with X and Y-coordinates identified by column and row index respectively. The manufacturer of your camera might refer to a range component with this setting as a depth map.

This is the default value for 1-band buffers.

This corresponds to the GenICam Scan3dOutputMode feature set to RectifiedC.

Specifies that the component stores a disparity map with perspective distortion along the Y-axis. When used with MbufConvert3d(), the Y-coordinate of each point in the resulting point cloud will be generated using the row index of the corresponding pixel and compensating for perspective.

This corresponds to the GenICam Scan3dOutputMode feature set to DisparityC.

Typically, this setting should only be used with disparity components that have been generated using areascan cameras.

Specifies that the component stores a disparity map; Y-coordinates are stored in a separate buffer that has an M_ARRAY attribute and is not part of the container. When used with MbufConvert3d(), the Y-coordinate of each point in the resulting point cloud will be taken from the specified buffer.

This corresponds to the GenICam Scan3dOutputMode feature set to DisparityC_Linescan.

Typically, this setting should only be used with disparity components that have been generated using linescan cameras.

Specifies that the component stores a disparity map, with Y-values identified by row index. When used with MbufConvert3d(), the Y-coordinates of each point in the resulting point cloud will be generated using the row index of the corresponding pixel. Since the Y-values are uniform, no perspective correction is applied.

This partially corresponds to the GenICam Scan3dOutputMode feature set to DisparityC_Linescan, except that the Y-values are not stored in a separate buffer.

Typically, this setting should only be used with disparity components that have been generated using linescan cameras.

Specifies that the component stores organized and uncalibrated Z-coordinates, without X and Y-coordinates.

This corresponds to the GenICam Scan3dOutputMode feature set to UncalibratedC.

Specifies by how much the X-coordinates stored in the buffer will be scaled.

The default value is 1.0.

Specifies how much the Y-coordinates stored in the buffer will be scaled.

The default value is 1.0.

Specifies how much the Z-coordinates stored in the buffer will be scaled.

The default value is 1.0.

Specifies by how much the X-coordinates stored in the buffer will be offset in the destination point cloud from the X-coordinates in the previous row.

The default value is 0.0.

Specifies by how much the Z-coordinates stored in the buffer will be offset in the destination point cloud from the Z-coordinates in the previous row.

The default value is 0.0.