RGBP to RGB/RGBA Color Conversion

Converts an image from RGBP (3 plane RGB) format to RGB or RGBA format.


This function can operate with ROI (see Image Regions of Interest).

This function performs conversion from 3-plane RGB image to RGB or RGBA image leaving pixel values unchanged, only changing memory layout from 3 plane 1 channel per plane to 1 plane 3 or 4 channels depending on destination image format. If destination format is RGBA, alpha_value from spec must be used to fill alpha channel.



template<typename SrcDataT, typename SrcAllocatorT, formats DstFormat, typename DstDataT, typename DstAllocatorT>
sycl::event oneapi::ipl::convert(sycl::queue &queue, image<formats::rgbp, SrcDataT, SrcAllocatorT> &src, image<DstFormat, DstDataT, DstAllocatorT> &dst, const convert_spec<DstDataT> &spec = {}, const std::vector<sycl::event> &dependencies = {})

Function for RGBP (plane rgb) to RGB or RGBA color conversion.

Template Parameters
  • SrcDataT – Source image data type

  • SrcAllocatorT – Source image allocator type

  • DstFormat – Destination image color format

  • DstDataT – Destination image data type

  • DstAllocatorT – Destination image allocator type

  • queue – SYCL queue object

  • src – Source image object

  • dst – Destination image object

  • spec – Specification for convert function

  • dependencies – SYCL event dependencies


SYCL event

Supported values for DstFormat:




See Parameters of Color Conversion (spec).


compile-time format check

Indicates an error when image format is not supported.

compile-time data type check

Indicates an error when image data type is not supported.

invalid_argument exception

Indicates an error when ROI sizes of the source image and the destination image are not equal.

invalid_argument exception

Indicates an error when one of the pitch values is not divisible by size of component data type in bytes.

The code example below demonstrates how to use the oneapi::ipl::convert for RGBP to RGBA conversion:

#include <vector>

// std::vector with data for source image
std::vector<std::uint8_t> src_image_data{
    255, 255,
    255, 255,
    128, 128,
    128, 128,
    0,   0,
    0,   0

// Create queue
sycl::queue queue{};

shared_usm_allocator_t usm_allocator{ queue };

// Source rgbp image data (usm_image)
image<formats::rgbp, std::uint8_t> src_image{ queue, src_image_data.data(), src_size, usm_allocator };
// Destination rgba image data (image_image)
image<formats::rgba, std::uint8_t> dst_image{ src_size };

(void)convert(queue, src_image, dst_image);