Skip to content

Pixel Format (blaze)#

The Pixel Format feature available on blaze-101 cameras allows you to choose the format of the image data transmitted.

There are different pixel formats depending on the image component selected.

Using the Feature#

Available Pixel Formats#

Range Map#

  • Coord3D_C16
    A monochrome image using unsigned 16-bit integer values (little-endian). Darker areas represent objects close to the camera while lighter areas represent objects farther away.
    Note that objects outside of the camera's selected measurement range (in front or at the back of the ROI) will also appear black in the image.
    This is the recommended pixel format for the range map when programming with the blaze SDK.
  • Mono16
    A monochrome image using unsigned 16-bit integer values (little-endian). This is equivalent to the Coord3D_C16 pixel format. It should be used if your software can't handle Coord3D_C16.
  • Coord3D_ABC32f (point cloud)
    This is the point cloud representation using 32-bit floating point values (single plane). Each point in the cloud holds three values representing the XYZ coordinates of the surface from which the light pulse has been reflected in a Cartesian coordinate system (in mm) in little-endian format. The image ordering is line by line and pixel by pixel.
    The origin of the coordinate system is defined by the following positions:

    • The x and y coordinates are 0 (zero) at the pixel at the center of the sensor.
    • the Z coordinate is 0 (zero) at a device-specific distance from the front of the camera. For more information about this, see Coordinate System of the Camera.

    For pixels with unreliable distance data (i.e., a low confidence value) or pixels that represent objects in the areas outside the ROI, the coordinates are set to the value specified by the Scan3dInvalidDataValue parameter.
    For more information about the camera's coordinate system, see the camera specification.

Intensity Image#

  • Mono8
    A monochrome image using unsigned 8-bit integer values (little-endian).
  • Mono16
    A monochrome image using unsigned 16-bit integer values (little-endian).

Confidence Map#

  • Confidence8
    A monochrome image using unsigned 8-bit integer values (little-endian). This is the recommended pixel format for the confidence map when programming with the blaze SDK.
  • Mono8
    A monochrome image using unsigned 8-bit integer values (little-endian). This is equivalent to the Confidence8 pixel format. It should be used if your software can't handle Confidence8.
  • Confidence16
    A monochrome image using unsigned 16-bit integer values (little-endian). This is the recommended pixel format for the confidence map when programming with the blaze SDK.
  • Mono16
    A monochrome image using unsigned 16-bit integer values (little-endian). This is equivalent to the Confidence16 pixel format. It should be used if your software can't handle Confidence16.

Selecting a Pixel Format#

To select an pixel format for an image component:

  1. Set the ComponentSelector parameter to the component for which you want to specify a pixel format.
  2. Set the ComponentEnable parameter to true if it isn't enabled already.
  3. Set the PixelFormat parameter to the desired pixel format for the component.
  4. Repeat for other components if required.