RGB/BGR to HLS - 2024.1 English

Vitis Libraries

Release Date
2024-05-30
Version
2024.1 English
The (rgb/bgr)2hls function converts a 3-channel RGB image to HLS color space.
5.542499999999997 V m a x = max ( R , G , B )
5.542499999999997 V m i n = min ( R , G , B )
11.722499999999997 L = V m a x + V m i n 2
32.2725 S =   V m a x - V m i n V m a x + V m i n         i f   l < 0.5 V m a x - V m i n 2 - ( V m a x + V m i n ? )   i f   L 0.5  
47.167500000000004 H =     60 ( G - B ) S                                         i f     V m a x = R 120 + 60 ( B - R ) S         i f   V m a x = G   240 + 60 ( R - G ) S           i f   V m a x = B

API Syntax

template<int SRC_T,int DST_T,int ROWS,int COLS,int NPC=1, int XFCVDEPTH_IN = _XFCVDEPTH_DEFAULT, int XFCVDEPTH_OUT = _XFCVDEPTH_DEFAULT>void rgb2hls(xf::cv::Mat<SRC_T, ROWS, COLS, NPC, XFCVDEPTH_IN> & _src,xf::cv::Mat<DST_T, ROWS, COLS, NPC, XFCVDEPTH_OUT> & _dst)
template<int SRC_T,int DST_T,int ROWS,int COLS,int NPC=1, int XFCVDEPTH_IN = _XFCVDEPTH_DEFAULT, int XFCVDEPTH_OUT = _XFCVDEPTH_DEFAULT>void bgr2hls(xf::cv::Mat<SRC_T, ROWS, COLS, NPC, XFCVDEPTH_IN> & _src,xf::cv::Mat<DST_T, ROWS, COLS, NPC, XFCVDEPTH_OUT> & _dst)

Parameter Descriptions

The following table describes the template and the function parameters.

Table 444 Table RGB/BGR2HLS Parameter Description
Parameter Description
SRC_T Input pixel type. Only 8-bit, unsigned, 3-channel is supported (XF_8UC3).
DST_T Output pixel type. Only 8-bit, unsigned, 3-channel is supported (XF_8UC3).
ROWS Maximum height of input and output image. Must be multiple of 8.
COLS Maximum width of input and output image. Must be multiple of 8.
NPC Number of pixels to be processed per cycle.
XFCVDEPTH_IN Depth of input image
XFCVDEPTH_OUT Depth of output image
_src RGB/BGR input image.
_dst HLS output image.

Resource Utilization

The following table summarizes the resource utilization of RGB/BGR2HLS for different configurations, as generated in the Vivado HLS 2019.1 version tool for the Xczu9eg-ffvb1156-1-i-es1 FPGA, to process a HD (1080x1920) image.

Table 445 Table RGB/BGR2HLS Function Resource Utilization Summary
Operating Mode Operating Frequency (MHz) Utilization Estimate
BRAM_18K DSP_48Es FF LUT
1 Pixel 300 0 3 4366 3096

Performance Estimate

The following table summarizes the performance of RGB/BGR2HLS for different configurations, as generated using the Vivado HLS 2019.1 version tool for the Xczu9eg-ffvb1156-1-i-es1, to process a HD (1080x1920) image.

Table 446 Table RGB/BGR2HLS Function Performance Estimate Summary
Operating Mode Latency Estimate
Max Latency (ms)
1 pixel operation (300 MHz) 6.9