Color Convert

OpenVX Function Description

• Implementes the Color Conversion Kernel.

OpenVX Function Reference Page

• https://www.khronos.org/registry/vx/specs/1.1/html/d1/dc2/group__group__vision__function__colorconvert.html

VXLIB API

• VXLIB_colorConvert_IYUVtoNV12_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_IYUVtoRGB_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_IYUVtoRGBX_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_IYUVtoYUV4_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_NVXXtoIYUV_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_NVXXtoRGB_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_NVXXtoRGBX_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_NVXXtoYUV4_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBtoIYUV_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBtoNV12_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBtoRGBX_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBtoYUV4_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBXtoIYUV_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBXtoNV12_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBXtoRGB_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_RGBXtoYUV4_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_YUVXtoIYUV_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_YUVXtoNV12_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_YUVXtoRGB_i8u_o8u : Input and output images are U8 format
• VXLIB_colorConvert_YUVXtoRGBX_i8u_o8u : Input and output images are U8 format

VXLIB Color Convert API General Conventions

• Some color formats contain only a single plane for the full image: (e.g. RGB, RGBX, and YUVX). Others require 2 (NVXX, NV12) or 3 planes (YUV4, IYUV).
• The way each color format interprets the dimensional information in these addressing structures follows the convention below. In the description below, 'sizeof(dataType)' refers to the size in bytes of the pointer type for each function (e.g. sizeof(u8) = 1; sizeof(s16) = 2).
  • RGB (1 plane)
    • 'dim_x' refers to the number of RGB pixel units per line
    • 'dim_y' refers to the number of lines in the image
    • 'stride_y' should be at least ('dim_x' * 3 * sizeof(dataType)) bytes
  • RGBX (1 plane)
    • 'dim_x' refers to the number of RGBX pixel units per line
    • 'dim_y' refers to the number of lines in the image
    • 'stride_y' should be at least ('dim_x' * 4 * sizeof(dataType)) bytes
  • YUVX (1 plane)
    • 'dim_x' refers to the number of luma pixel units per line
    • 'dim_y' refers to the number of lines in the image
    • 'stride_y' should be at least ('dim_x' * 2 * sizeof(dataType)) bytes
  • NVXX & NV12 (2 planes)
    • plane0
      • 'dim_x' refers to the number of luma pixel units per line
      • 'dim_y' refers to the number of lines in the luma plane
      • 'stride_y' refers to the stride of the luma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
    • plane1
      • 'dim_x' refers to the number of bytes per line (should be equal to plane0.dim_x)
      • 'dim_y' refers to the number of lines in the interleaved chroma plane (should be equal to plane0.dim_y / 2)
      • 'stride_y' refers to the stride of the interleaved chroma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
  • YUV4 (3 planes)
    • plane0
      • 'dim_x' refers to the number of luma pixel units per line
      • 'dim_y' refers to the number of lines in the luma plane
      • 'stride_y' refers to the stride of the luma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
    • plane1
      • 'dim_x' refers to the number of chroma pixel units per line (should be equal to plane0.dim_x)
      • 'dim_y' refers to the number of lines in the chroma plane (should be equal to plane0.dim_y)
      • 'stride_y' refers to the stride of the chroma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
    • plane2
      • 'dim_x' refers to the number of chroma pixel units per line (should be equal to plane0.dim_x)
      • 'dim_y' refers to the number of lines in the chroma plane (should be equal to plane0.dim_y)
      • 'stride_y' refers to the stride of the chroma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
  • IYUV (3 planes)
    • plane0
      • 'dim_x' refers to the number of luma pixel units per line
      • 'dim_y' refers to the number of lines in the luma plane
      • 'stride_y' refers to the stride of the luma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
    • plane1
      • 'dim_x' refers to the number of chroma pixel units per line (should be equal to plane0.dim_x / 2)
      • 'dim_y' refers to the number of lines in the chroma plane (should be equal to plane0.dim_y / 2)
      • 'stride_y' refers to the stride of the chroma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes
    • plane2
      • 'dim_x' refers to the number of chroma pixel units per line (should be equal to plane0.dim_x / 2)
      • 'dim_y' refers to the number of lines in the chroma plane (should be equal to plane0.dim_y / 2)
      • 'stride_y' refers to the stride of the chroma plane, and should be at least ('dim_x' * 1 * sizeof(dataType)) bytes