RGBP to RGB/RGBA Color Conversion¶

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

Description

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.

Headers

oneapi/ipl/convert.hpp

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

Parameters

queue – SYCL queue object
src – Source image object
dst – Destination image object
spec – Specification for convert function
dependencies – SYCL event dependencies

Returns

SYCL event

Supported values for DstFormat:

rgb

rgba

Parameters

See Parameters of Color Conversion (spec).

Errors

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);

oneIPL Specification documentation

RGBP to RGB/RGBA Color Conversion¶