RGB/RGBA to RGBP Color Conversion#

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


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

This function performs conversion from RGB or RGBA image to 3-plane RGB image leaving pixel values unchanged, only changing memory layout from channels3/channels4 depending on source image to plane3 (1 channel per plane) layout. In case of channel4 layout (RGBA format), alpha channel is ignored and its values are lost.




template<typename SrcImageT, typename DstImageT>
sycl::event oneapi::ipl::rgb_to_rgbp(sycl::queue &queue, SrcImageT &src, DstImageT &dst, const color_conversion_spec<typename DstImageT::data_t> &spec = {}, const std::vector<sycl::event> &dependencies = {})#

Function for RGB or RGBA to RGBP color conversion.

Template Parameters
  • SrcImageT – Source image type

  • DstImageT – Destination image 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 source layout:




See Parameters of Color Conversion (spec).


compile-time memory layout check

Indicates an error when image memory layout 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 shall be called oneapi::ipl::rgb_to_rgbp for RGBA to RGBP conversion:

using namespace oneapi;

sycl::queue                 queue;
ipl::shared_usm_allocator_t allocator{ queue };
const sycl::range<2>        image_size{ height, width };

// Source image for RGBA data
ipl::image<ipl::layouts::channel4, std::uint8_t> src_image{ queue, p_image_data, image_size, allocator };
// Destination image for RGBP data
ipl::image<ipl::layouts::plane3, std::uint8_t> dst_image{ image_size, allocator };

// Convert RGB to RGBP
auto event = ipl::rgb_to_rgbp(queue, src_image, dst_image);