This class provides functions to convert frames with Y10_PACKED pixel format. More...

Inheritance diagram for Ocean::CV::FrameConverterY10_Packed:

Data Structures
class	LookupTableManager
	This class implements the manager for lookup tables. More...

Static Public Member Functions
static void	convertY10_PackedToY8Linear (const uint8_t const source, uint8_t const target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
	Converts a Y10_PACKED frame to a Y8 frame. More...

static void	convertY10_PackedToY8GammaLUT (const uint8_t const source, uint8_t const target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const float gamma, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
	Converts a Y10_PACKED frame to a Y8 frame by applying gamma compression/correction using a lookup table. More...

static void	convertY10_PackedToY8GammaApproximated (const uint8_t const source, uint8_t const target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const float gamma, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
	Converts a Y10_PACKED frame to a Y8 frame by applying gamma compression/correction using a 3-step linear approximation. More...

static void	convertY10_PackedToY10 (const uint8_t const source, uint16_t const target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
	Converts a Y10_PACKED frame to a Y10 frame, so that this function simply unpacks the 10 bits. More...

static void	convertY10_PackedToBGR24 (const uint8_t const source, uint8_t const target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
	Converts a Y10_PACKED frame to a RGB24 frame. More...

static void	convertY10_PackedToRGB24 (const uint8_t const source, uint8_t const target, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, Worker *worker=nullptr)
	Converts a Y10_PACKED frame to a RGB24 frame. More...

Static Public Member Functions inherited from Ocean::CV::FrameConverter
template<typename TSource , typename TTarget >
static void	cast (const TSource __restrict source, TTarget __restrict target, const unsigned int width, const unsigned int height, const unsigned int channels, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements)
	Casts the pixel values from one frame type to another frame type. More...

template<typename TSource , typename TTarget >
static void	normalizedCast (const TSource __restrict source, TTarget __restrict target, const unsigned int width, const unsigned int height, const unsigned int channels, const TTarget multiplicationFactor, const TTarget offset, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements)
	Casts the pixel values from one frame type to another frame type but also normalizes the casted source values before assigning them (by scaling and offsetting). More...

template<typename T >
static bool	subFrame (const T source, T target, const unsigned int sourceWidth, const unsigned int sourceHeight, const unsigned int targetWidth, const unsigned int targetHeight, const unsigned int channels, const unsigned int sourceLeft, const unsigned int sourceTop, const unsigned int targetLeft, const unsigned int targetTop, const unsigned int width, const unsigned int height, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements)
	Copies a sub-frame of a given frame into a second frame while both frames might have an individual number of padding elements at the end of each row. More...

template<typename T >
static bool	subFrameMask (const Frame &sourceFrame, Frame &targetFrame, const Frame &maskFrame, const uint32_t sourceLeft, const uint32_t sourceTop, const uint32_t targetLeft, const uint32_t targetTop, const uint32_t subFrameWidth, const uint32_t subFrameHeight, const uint8_t maskValue=0u)
	Copies pixels from one sub-frame to another if the pixels are part of a mask; input may use padding. More...

template<typename T >
static bool	subFrameMask (const T source, T target, const uint8_t *mask, const unsigned int sourceWidth, const unsigned int sourceHeight, const unsigned int targetWidth, const unsigned int targetHeight, const unsigned int channels, const unsigned int sourceLeft, const unsigned int sourceTop, const unsigned int targetLeft, const unsigned int targetTop, const unsigned int subFrameWidth, const unsigned int subFrameHeight, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements, const unsigned int maskPaddingElements, const uint8_t maskValue=0u)
	Copies pixels from one sub-frame to another if the pixels are part of a mask; input may use padding. More...

template<typename T >
static void	patchFrame (const T source, T buffer, const unsigned int width, const unsigned int channels, const unsigned int x, const unsigned int y, const unsigned int patchSize, const unsigned int sourcePaddingElements, const unsigned int bufferPaddingElements)
	Copies a small patch area of a given frame into a buffer holding only the entire patch. More...

template<typename T , unsigned int tChannels>
static void	patchFrameMirroredBorder (const T source, T buffer, const unsigned int width, const unsigned int height, const unsigned int x, const unsigned int y, const unsigned int patchSize, const unsigned int sourcePaddingElements, const unsigned int bufferPaddingElements)
	Copies a small patch area of a frame into a buffer holding only the entire patch. More...

static MatrixD	transformationMatrix_FullRangeRGB24_To_FullRangeYUV24_BT601 ()
	Returns the 3x4 color space transformation matrix from full range RGB24 to full range YUV24 using BT.601, analog RGB to (analog) YPbPr. More...

static MatrixD	transformationMatrix_FullRangeRGB24_To_FullRangeYVU24_BT601 ()
	Returns the 3x4 color space transformation matrix from full range RGB24 to full range YVU24 using BT.601, analog RGB to (analog) YPbPr. More...

static MatrixD	transformationMatrix_FullRangeRGB24_To_LimitedRangeYUV24_BT601 ()
	Returns the 3x4 color space transformation matrix from full range RGB24 to limited range YUV24 using BT.601, analog RGB to (digital) YCbCr. More...

static MatrixD	transformationMatrix_FullRangeRGB24_To_LimitedRangeYVU24_BT601 ()
	Returns the 3x4 color space transformation matrix from full range RGB24 to limited range YVU24 using BT.601, analog RGB to (digital) YCbCr. More...

static MatrixD	transformationMatrix_FullRangeYUV24_To_FullRangeBGR24_BT601 ()
	Returns the color space transformation matrix from full range YUV24 to full range BGR24 using BT.601, (analog) YPbPr to analog BGR. More...

static MatrixD	transformationMatrix_FullRangeYUV24_To_FullRangeRGB24_BT601 ()
	Returns the color space transformation matrix from full range YUV24 to full range RGB24 using BT.601, (analog) YPbPr to analog RGB. More...

static MatrixD	transformationMatrix_FullRangeYUV24_To_FullRangeBGR24_Android ()
	Returns the color space transformation matrix from full range YUV24 to full range BGR24 similar to BT.601, (analog) YPbPr to analog BGR. More...

static MatrixD	transformationMatrix_FullRangeYUV24_To_FullRangeRGB24_Android ()
	Returns the color space transformation matrix from full range YUV24 to full range RGB24 similar to BT.601, (analog) YPbPr to analog RGB. More...

static MatrixD	transformationMatrix_FullRangeYVU24_To_FullRangeBGR24_Android ()
	Returns the color space transformation matrix from full range YVU24 to full range BGR24 similar to BT.601, (analog) YPbPr to analog BGR. More...

static MatrixD	transformationMatrix_FullRangeYVU24_To_FullRangeRGB24_Android ()
	Returns the color space transformation matrix from full range YVU24 to full range RGB24 similar to BT.601, (analog) YPbPr to analog RGB. More...

static MatrixD	transformationMatrix_LimitedRangeYUV24_To_FullRangeRGB24_BT601 ()
	Returns the color space transformation matrix from limited range YUV24 to full range RGB24 using BT.601, (digital) YCbCr to analog RGB. More...

static MatrixD	transformationMatrix_FullRangeBGR24_To_LimitedRangeYUV24_BT601 ()
	Returns the color space transformation matrix from full range BGR24 to limited range YUV24 using BT.601, analog RGB to (digital) YCbCr. More...

static MatrixD	transformationMatrix_FullRangeBGR24_To_FullRangeYUV24_BT601 ()
	Returns the 3x4 color space transformation matrix from full range BGR24 to full range YUV24 using BT.601, analog BGR to (analog) YPbPr. More...

static MatrixD	transformationMatrix_FullRangeBGR24_To_FullRangeYVU24_BT601 ()
	Returns the 3x4 color space transformation matrix from full range BGR24 to full range YVU24 using BT.601, analog BGR to (analog) YPbPr. More...

static MatrixD	transformationMatrix_LimitedRangeYUV24_To_FullRangeBGR24_BT601 ()
	Returns the color space transformation matrix from limited range YUV24 to full range BGR24 using BT.601, (digital) YCbCr to analog BGR. More...

static MatrixD	transformationMatrix_LimitedRangeYVU24_To_FullRangeBGR24_BT601 ()
	Returns the color space transformation matrix from limited range YVU24 to full range BGR24 using BT.601, (digital) YCrCb to analog BGR. More...

static MatrixD	transformationMatrix_LimitedRangeYVU24_To_FullRangeRGB24_BT601 ()
	Returns the color space transformation matrix from limited range YVU24 to full range RGB24 using BT.601, (digital) YCrCb to analog RGB. More...

static MatrixD	transformationMatrix_FullRangeYVU24_To_FullRangeRGB24_BT601 ()
	Returns the color space transformation matrix from full range YVU24 to full range RGB24 using BT.601, (digital) YCrCb to analog RGB. More...

static MatrixD	transformationMatrix_FullRangeYVU24_To_FullRangeBGR24_BT601 ()
	Returns the color space transformation matrix from full range YVU24 to full range BGR24 using BT.601, (digital) YCrCb to analog BGR. More...

static const ConversionFlags &	conversionFlags ()
	Returns a vector holding all possible conversion flags. More...

static std::string	translateConversionFlag (const ConversionFlag conversionFlag)
	Translates a given conversion flag to a string. More...

Static Protected Member Functions
static void	convertRowY10_PackedToY8Linear (const uint8_t source, uint8_t target, const size_t size, const void *unusedParameters=nullptr)
	Converts a Y10_Packed row to a Y8 row. More...

static void	convertRowY10_PackedToY8GammaLUT (const uint8_t source, uint8_t target, const size_t size, const void *parameters)
	Converts a Y10_Packed row to a Y8 row by applying gamma compression/correction with a lookup table. More...

template<unsigned int tStep01, unsigned int tStep12>
static void	convertRowY10_PackedToY8GammaApproximated (const uint8_t source, uint8_t target, const size_t size, const void *parameters)
	Converts a Y10_Packed row to a Y8 row by applying gamma compression/correction with a 3-step linear interpolation. More...

static void	convertRowY10_PackedToY10 (const uint8_t source, uint16_t target, const size_t size, const void *unusedParameters=nullptr)
	Converts a Y10_Packed row to a Y10 row. More...

static void	convertRowY10_PackedToYYY24Linear (const uint8_t source, uint8_t target, const size_t size, const void *unusedParameters=nullptr)
	Converts a Y10_Packed row to a RGB24 row, or BGR24 row. More...

static OCEAN_FORCE_INLINE void	convert16PixelY10_PackedToY8LinearNEON (const uint8_t const source, uint8_t const target)
	Converts 16 pixels (20 elements) of a Y10_Packed buffer to 16 Y8 pixels by applying a liner conversion. More...

template<unsigned int tStep01, unsigned int tStep12>
static OCEAN_FORCE_INLINE void	convert16PixelY10_PackedToY8ApproximatedNEON (const uint8_t const source, const int16x4_t &m0_256_s_16x4, const int16x4_t &m1_256_s_16x4, const int16x4_t &m2_256_s_16x4, const int16x8_t &c1_s_16x8, const int16x8_t &c2_s_16x8, uint8_t const target)
	Converts 16 pixels (20 elements) of a Y10_Packed buffer to 16 Y8 pixels by applying gamma compression/correction with a 3-step linear interpolation. More...

Static Protected Member Functions inherited from Ocean::CV::FrameConverter
template<typename TSource , typename TTarget >
static void	cast16Elements (const TSource const source, TTarget const target)
	Casts 16 successive elements from one data type to another data type. More...

template<typename TSource , typename TTarget >
static void	convertGenericPixelFormat (const TSource source, TTarget target, const unsigned int width, const unsigned int height, const unsigned int sourceStrideElements, const unsigned int targetStrideElements, const ConversionFlag flag, const RowConversionFunction< TSource, TTarget > rowConversionFunction, const RowReversePixelOrderInPlaceFunction< TTarget > targetReversePixelOrderInPlaceFunction, const bool areContinuous, const void options, Worker worker)
	Converts a frame with generic pixel format (e.g., RGBA32, BGR24, YUV24, ...) to a frame with generic pixel format (e.g., RGB24, Y8). More...

static void	convertArbitraryPixelFormat (const void sources, void targets, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int multipleRowsPerIteration, const MultipleRowsConversionFunction multipleRowsConversionFunction, const void options, Worker worker)
	Converts a frame with arbitrary pixel format (e.g., Y_UV12, Y_VU12, YUYV16, ...) to a frame with arbitrary pixel format. More...

static void	convertGenericPixelFormatSubset (const uint8_t source, uint8_t target, const unsigned int width, const unsigned int height, const unsigned int sourceStrideBytes, const unsigned int targetStrideBytes, const ConversionFlag flag, const RowConversionFunction< uint8_t, uint8_t > rowConversionFunction, const RowReversePixelOrderInPlaceFunction< uint8_t > targetReversePixelOrderInPlaceFunction, const bool areContinuous, const void *options, const unsigned int firstRow, const unsigned int numberRows)
	Converts a subset of a frame with generic pixel format (e.g., RGBA32, BGR24, YUV24, ...) to a frame with generic pixel format (e.g., Y8). More...

static void	convertArbitraryPixelFormatSubset (const void sources, void targets, const unsigned int width, const unsigned int height, const ConversionFlag flag, const unsigned int multipleRowsPerIteration, const MultipleRowsConversionFunction multipleRowsConversionFunction, const void *options, const unsigned int firstMultipleRow, const unsigned int numberMultipleRows)
	Converts a subset of a frame with arbitrary pixel format (e.g., Y_UV12, Y_VU12, YUYV16, ...) to a frame with arbitrary pixel format. More...

static void	convertOneRow_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	This function is not used anymore due to the corresponding 2-row function. More...

static void	convertOneRow_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	This function is not used anymore due to the corresponding 2-row function. More...

static void	convertTwoRows_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a Y_UV12 pixel format to two rows of an image with e.g., an RGB24 pixel format with 6 bit precision. More...

static void	convertTwoRows_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a Y_UV12 pixel format to two rows of an image with e.g., an RGB24 pixel format with 10 bit precision. More...

static void	convertTwoRows_1Plane3Channels_To_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_8BitPerChannel_Precision7Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a RGB pixel format to two rows of an image with e.g., an Y_UV12 pixel format with 7 bit precision. More...

static void	convertTwoRows_1Plane3Channels_To_1Plane1ChannelAnd2Planes1ChannelsDownsampled2x2_8BitPerChannel_Precision7Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a RGB pixel format to two rows of an image with e.g., an Y_U_V12 pixel format with 7 bit precision. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapOneRow_3Plane1Channel_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts (maps) one row of an image with e.g., a Y_U_V24 pixel format to one row of an image with e.g., an YUV24 or YVU24 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapOneRow_1Plane3Channels_To_3Plane1Channel_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts (maps) one row of an image with e.g., a RGB24 pixel format to one row of an image with e.g., a R_G_B24 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapOneRow_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts (matches) one row of an image with e.g., a Y_UV12 pixel format to one row of an image with e.g., an YUV24 or YVU24 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapTwoRows_1Plane1ChannelAnd1Plane2ChannelsDownsampled2x2_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts (matches) two rows of an image with e.g., a Y_UV12 pixel format to two rows of an image with e.g., an YUV24 or YVU24 pixel format. More...

static void	convertOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a Y_U_V12 pixel format to one row of an image with e.g., an RGB24 pixel format with 10 bit precision. More...

static void	convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision10Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a Y_U_V12 pixel format to two rows of an image with e.g., an RGB24 pixel format with 10 bit precision. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a Y_U_V12 pixel format to one row of an image with e.g., an YUV24 or YVU24 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a Y_U_V12 pixel format to two rows of an image with e.g., an YUV24 or YVU24 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapTwoRows_1Plane3Channels_To_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a YUV24 pixel format to two rows of an image with e.g., an Y_U_V12 or Y_V_U12 pixel format. More...

static void	convertOneRow_3Planes1Channel_To_1Plane3Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a Y_U_V24 pixel format to one rows of an image with e.g., an RGB24 pixel format. More...

static void	convertOneRow_3Planes1Channel_To_1Plane4Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a Y_U_V24 pixel format to one rows of an image with e.g., an RGBA32 pixel format. More...

static void	convertOneRow_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane4Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a Y_U_V12 pixel format to one row of an image with e.g., an RGBA32 pixel format. More...

static void	convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane3Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a Y_U_V12 pixel format to two rows of an image with e.g., an RGB24 pixel format. More...

static void	convertTwoRows_1Plane1ChannelAnd2Planes1ChannelDownsampled2x2_To_1Plane4Channels_8BitPerChannel_Precision6Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with e.g., a Y_U_V12 pixel format to two rows of an image with e.g., an RGBA32 pixel format. More...

static void	convertOneRow_1Plane3ChannelsWith2ChannelsDownsampled2x1BackIsDownsampled_To_1Plane3Channels_8BitPerChannel_Precision10Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a YUYV16 pixel format to one row of an image with e.g., an RGB24 or BGR2424 pixel format. More...

static void	convertOneRow_1Plane3ChannelsWith2ChannelsDownsampled2x1FrontIsDownsampled_To_1Plane3Channels_8BitPerChannel_Precision10Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a UYVY16 pixel format to one row of an image with e.g., an RGB24 or BGR2424 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapOneRow_1Plane3ChannelsWith2ChannelsDownsampled2x1BackIsDownsampled_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a YUYV16 pixel format to one row of an image with e.g., an YUV24 or YVU24 pixel format. More...

template<unsigned int tSourceChannelIndex0, unsigned int tSourceChannelIndex1, unsigned int tSourceChannelIndex2>
static void	mapOneRow_1Plane3ChannelsWith2ChannelsDownsampled2x1FrontIsDownsampled_To_1Plane3Channels_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts one row of an image with e.g., a UYVY16 pixel format to one row of an image with e.g., an YUV24 or YVU24 pixel format. More...

template<unsigned int tIndexRed, unsigned int tIndexGreen, unsigned int tIndexBlue>
static void	convertTwoRows_1PlaneMosaicPacked10Bit_To_1PlaneUnpacked3Channels8Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with 3-channel Bayer mosaic pixel format with packed 10-bit pixel values to an image with 3-channel un-packed 8-bit pixel format. More...

template<unsigned int tIndexRed, unsigned int tIndexGreen, unsigned int tIndexBlue>
static void	convertTwoRows_1PlaneMosaicPacked10Bit_To_1PlaneUnpacked3Channels16Bit (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with 3-channel Bayer mosaic pixel format with packed 10-bit pixel values to an image with 3-channel un-packed 16-bit pixel format. More...

template<unsigned int tIndexRed, unsigned int tIndexGreen, unsigned int tIndexBlue>
static void	convertTwoRows_1PlaneMosaicPacked10Bit_To_1PlaneUnpacked3Channels8BitAdvanced (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Converts two rows of an image with 3-channel Bayer mosaic pixel format with packed 10-bit pixel values to an image with 3-channel un-packed 8-bit pixel format and applies black level subtraction, white balance, and gamma encoding The layout of the parameters, `options`, is defined in the struct `RGGB10ToRGB24AdvancedOptions`. More...

static void	mapOneRow_1Plane2Channels_To_2Planes1Channel_8BitPerChannel (const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void *options)
	Maps one row of a 1-plane, 2-channel image to two planes with 1 channels. More...

static OCEAN_FORCE_INLINE void	unpack5ElementsBayerMosaicPacked10Bit (const uint8_t const packed, uint16_t unpacked)
	Unpacks 5 elements from a row in a packed Bayer mosaic to 4 pixels values The required memory layout of the input: `A B C D X ...` Bytes marked as `X` store two bits for each of the previous four elements: `X = AABB CCDD`. More...

template<bool tAllowLastOverlappingElement>
static OCEAN_FORCE_INLINE void	unpack15ElementsBayerMosaicPacked10BitNEON (const uint8_t *const packed, uint16x8_t &unpackedAB_u_16x8, uint16x4_t &unpackedC_u_16x4)
	Unpacks 15 elements from a row in a packed Bayer mosaic to 12 pixels values The required memory layout of the input: `A B C D X A B C D X A B C D X A ...` Bytes marked as `X` store two bits for each of the previous four elements: `X = AABB CCDD`. More...

template<>
OCEAN_FORCE_INLINE void	cast16Elements (const uint8_t const source, float const target)

template<>
OCEAN_FORCE_INLINE void	cast16Elements (const uint8_t const source, uint16_t const target)

template<>
OCEAN_FORCE_INLINE void	cast16Elements (const uint8_t const source, int16_t const target)

template<>
OCEAN_FORCE_INLINE void	cast16Elements (const uint8_t const source, uint32_t const target)

template<>
OCEAN_FORCE_INLINE void	cast16Elements (const uint8_t const source, int32_t const target)

template<>
OCEAN_FORCE_INLINE void	cast16Elements (const float const source, uint8_t const target)

Additional Inherited Members
Public Types inherited from Ocean::CV::FrameConverter
enum	ConversionFlag : uint32_t { CONVERT_NORMAL , CONVERT_FLIPPED , CONVERT_MIRRORED , CONVERT_FLIPPED_AND_MIRRORED }
	Definition of individual conversion flags. More...

enum	CopyPreference : bool { CP_AVOID_COPY_IF_POSSIBLE = false , CP_ALWAYS_COPY = true }
	Definition of a boolean enum for copy preferences (to improve code readability). More...

using	ConversionFlags = std::vector< ConversionFlag >
	Definition of a vector holding conversion flags. More...

Public Member Functions inherited from Ocean::CV::FrameConverter
template<typename TSource , typename TTarget >
OCEAN_RE_ENABLE_DOCUMENTATION_DIAGNOSTIC void	cast (const TSource __restrict source, TTarget __restrict target, const unsigned int width, const unsigned int height, const unsigned int channels, const unsigned int sourcePaddingElements, const unsigned int targetPaddingElements)

template<typename TSource , typename TTarget >
OCEAN_FORCE_INLINE void	cast16Elements (const TSource const source, TTarget const target)

Protected Types inherited from Ocean::CV::FrameConverter
template<typename TSource , typename TTarget >
using	RowConversionFunction = void()(const TSource sourceRow, TTarget targetRow, const size_t width, const void options)
	Definition of a function pointer to a function able to convert one image row from one generic pixel format to another generic pixel format. More...

using	MultipleRowsConversionFunction = void()(const void sources, void targets, const unsigned int multipleRowIndex, const unsigned int width, const unsigned int height, const ConversionFlag conversionFlag, const void options)
	Definition of a function pointer to a function able to convert multiple image row from an arbitrary pixel format to another arbitrary pixel format. More...

template<typename T >
using	RowReversePixelOrderFunction = void()(const T inputRow, T *targetRow, const size_t width)
	Definition of a function pointer to a function able to reverse the order of pixels in an image row with a generic pixel format. More...

template<typename T >
using	RowReversePixelOrderInPlaceFunction = void()(T row, const size_t width)
	Definition of a function pointer to a function able to reverse the order of pixels in an image row with a generic pixel format in-place. More...

Detailed Description

This class provides functions to convert frames with Y10_PACKED pixel format.

Member Function Documentation

◆ convert16PixelY10_PackedToY8ApproximatedNEON()

template<unsigned int tStep01, unsigned int tStep12>

OCEAN_FORCE_INLINE void Ocean::CV::FrameConverterY10_Packed::convert16PixelY10_PackedToY8ApproximatedNEON	(	const uint8_t *const	source,
		const int16x4_t &	m0_256_s_16x4,
		const int16x4_t &	m1_256_s_16x4,
		const int16x4_t &	m2_256_s_16x4,
		const int16x8_t &	c1_s_16x8,
		const int16x8_t &	c2_s_16x8,
		uint8_t *const	target
	)

staticprotected

Converts 16 pixels (20 elements) of a Y10_Packed buffer to 16 Y8 pixels by applying gamma compression/correction with a 3-step linear interpolation.

Parameters

source	The souce buffer with 16 elements, must be valid
m0_256_s_16x4	The slope of the first linear approximation (with multiple of 256), with range (-10 * 256, 10 * 256)
m1_256_s_16x4	The slope of the second linear approximation (with multiple of 256), with range (-10 * 256, 10 * 256)
m2_256_s_16x4	The slope of the third linear approximation (with multiple of 256), with range (-10 * 256, 10 * 256)
c1_s_16x8	The intercept of the second linear approximation, with range (-255, 255)
c2_s_16x8	The intercept of the third linear approximation, with range (-255, 255)
target	The resulting 16 Y8 pixels, must be valid

◆ convert16PixelY10_PackedToY8LinearNEON()

OCEAN_FORCE_INLINE void Ocean::CV::FrameConverterY10_Packed::convert16PixelY10_PackedToY8LinearNEON	(	const uint8_t *const	source,
		uint8_t *const	target
	)

staticprotected

Converts 16 pixels (20 elements) of a Y10_Packed buffer to 16 Y8 pixels by applying a liner conversion.

Parameters

source	The souce buffer with 16 elements, must be valid
target	The resulting 16 Y8 pixels, must be valid

◆ convertRowY10_PackedToY10()

static void Ocean::CV::FrameConverterY10_Packed::convertRowY10_PackedToY10	(	const uint8_t *	source,
		uint16_t *	target,
		const size_t	size,
		const void *	unusedParameters = `nullptr`
	)

staticprotected

Converts a Y10_Packed row to a Y10 row.

This function simply applies an unpacking of the 10 bits.

Parameters

source	The pointer to the source pixels, must be valid
target	The pointer to the target pixels receiving the converted pixel data, must be valid
size	The number of source (and target pixels) to convert, with range [4, infinity), must be a multiple of 4
unusedParameters	Unused parameters, must be nullptr

◆ convertRowY10_PackedToY8GammaApproximated()

template<unsigned int tStep01, unsigned int tStep12>

void Ocean::CV::FrameConverterY10_Packed::convertRowY10_PackedToY8GammaApproximated	(	const uint8_t *	source,
		uint8_t *	target,
		const size_t	size,
		const void *	parameters
	)

staticprotected

Converts a Y10_Packed row to a Y8 row by applying gamma compression/correction with a 3-step linear interpolation.

Parameters

source	The pointer to the source pixels, must be valid
target	The pointer to the target pixels receiving the converted pixel data, must be valid
size	The number of source (and target pixels) to convert, with range [4, infinity), must be a multiple of 4
parameters	Three linear slope parameters and two intercept parameters, must be valid

◆ convertRowY10_PackedToY8GammaLUT()

static void Ocean::CV::FrameConverterY10_Packed::convertRowY10_PackedToY8GammaLUT	(	const uint8_t *	source,
		uint8_t *	target,
		const size_t	size,
		const void *	parameters
	)

staticprotected

Converts a Y10_Packed row to a Y8 row by applying gamma compression/correction with a lookup table.

Parameters

source	The pointer to the source pixels, must be valid
target	The pointer to the target pixels receiving the converted pixel data, must be valid
size	The number of source (and target pixels) to convert, with range [4, infinity), must be a multiple of 4
parameters	The pointer to the `uint8_t` lookup table to be used, must be valid

◆ convertRowY10_PackedToY8Linear()

static void Ocean::CV::FrameConverterY10_Packed::convertRowY10_PackedToY8Linear	(	const uint8_t *	source,
		uint8_t *	target,
		const size_t	size,
		const void *	unusedParameters = `nullptr`
	)

staticprotected

Converts a Y10_Packed row to a Y8 row.

This function simply applies a linear bit reduction from 10 bits to 8 bits.

Parameters

source	The pointer to the source pixels, must be valid
target	The pointer to the target pixels receiving the converted pixel data, must be valid
size	The number of source (and target pixels) to convert, with range [4, infinity), must be a multiple of 4
unusedParameters	Unused parameters, must be nullptr

◆ convertRowY10_PackedToYYY24Linear()

static void Ocean::CV::FrameConverterY10_Packed::convertRowY10_PackedToYYY24Linear	(	const uint8_t *	source,
		uint8_t *	target,
		const size_t	size,
		const void *	unusedParameters = `nullptr`
	)

staticprotected

Converts a Y10_Packed row to a RGB24 row, or BGR24 row.

This function simply applies a linear bit reduction from 10 bits to 8 bits.

Parameters

source	The pointer to the source pixels, must be valid
target	The pointer to the target pixels receiving the converted pixel data, must be valid
size	The number of source (and target pixels) to convert, with range [4, infinity), must be a multiple of 4
unusedParameters	Unused parameters, must be nullptr

◆ convertY10_PackedToBGR24()

void Ocean::CV::FrameConverterY10_Packed::convertY10_PackedToBGR24	(	const uint8_t *const	source,
		uint8_t *const	target,
		const unsigned int	width,
		const unsigned int	height,
		const ConversionFlag	flag,
		const unsigned int	sourcePaddingElements,
		const unsigned int	targetPaddingElements,
		Worker *	worker = `nullptr`
	)

inlinestatic

Converts a Y10_PACKED frame to a RGB24 frame.

Parameters

source	The source frame buffer, must be valid
target	The target frame buffer, must be valid
width	The width of the frame in pixel, with range [4, infinity), must be a multiple of 4
height	The height of the frame in pixel, with range [1, infinity)
flag	Determining the type of conversion
sourcePaddingElements	The number of padding elements at the end of each source row, in elements, with range [0, infinity)
targetPaddingElements	The number of padding elements at the end of each target row, in elements, with range [0, infinity)
worker	Optional worker object to distribute the computational load

◆ convertY10_PackedToRGB24()

void Ocean::CV::FrameConverterY10_Packed::convertY10_PackedToRGB24	(	const uint8_t *const	source,
		uint8_t *const	target,
		const unsigned int	width,
		const unsigned int	height,
		const ConversionFlag	flag,
		const unsigned int	sourcePaddingElements,
		const unsigned int	targetPaddingElements,
		Worker *	worker = `nullptr`
	)

inlinestatic

Converts a Y10_PACKED frame to a RGB24 frame.

Parameters

source	The source frame buffer, must be valid
target	The target frame buffer, must be valid
width	The width of the frame in pixel, with range [4, infinity), must be a multiple of 4
height	The height of the frame in pixel, with range [1, infinity)
flag	Determining the type of conversion
sourcePaddingElements	The number of padding elements at the end of each source row, in elements, with range [0, infinity)
targetPaddingElements	The number of padding elements at the end of each target row, in elements, with range [0, infinity)
worker	Optional worker object to distribute the computational load

◆ convertY10_PackedToY10()

void Ocean::CV::FrameConverterY10_Packed::convertY10_PackedToY10	(	const uint8_t *const	source,
		uint16_t *const	target,
		const unsigned int	width,
		const unsigned int	height,
		const ConversionFlag	flag,
		const unsigned int	sourcePaddingElements,
		const unsigned int	targetPaddingElements,
		Worker *	worker = `nullptr`
	)

inlinestatic

Converts a Y10_PACKED frame to a Y10 frame, so that this function simply unpacks the 10 bits.

Parameters

source	The source frame buffer, must be valid
target	The target frame buffer, must be valid
width	The width of the frame in pixel, with range [4, infinity), must be a multiple of 4
height	The height of the frame in pixel, with range [1, infinity)
flag	Determining the type of conversion
sourcePaddingElements	The number of padding elements at the end of each source row, in elements, with range [0, infinity)
targetPaddingElements	The number of padding elements at the end of each target row, in elements, with range [0, infinity)
worker	Optional worker object to distribute the computational load

◆ convertY10_PackedToY8GammaApproximated()

static void Ocean::CV::FrameConverterY10_Packed::convertY10_PackedToY8GammaApproximated	(	const uint8_t *const	source,
		uint8_t *const	target,
		const unsigned int	width,
		const unsigned int	height,
		const ConversionFlag	flag,
		const float	gamma,
		const unsigned int	sourcePaddingElements,
		const unsigned int	targetPaddingElements,
		Worker *	worker = `nullptr`
	)

static

Converts a Y10_PACKED frame to a Y8 frame by applying gamma compression/correction using a 3-step linear approximation.

The gamma compression/correction is based the following equation

Y8 = 255 * (Y10 / 1023) ^ gamma

Parameters

source	The source frame buffer, must be valid
target	The target frame buffer, must be valid
width	The width of the frame in pixel, with range [4, infinity), must be a multiple of 4
height	The height of the frame in pixel, with range [1, infinity)
flag	Determining the type of conversion
gamma	The gamma value to be applied, with range (0, 2)
sourcePaddingElements	The number of padding elements at the end of each source row, in elements, with range [0, infinity)
targetPaddingElements	The number of padding elements at the end of each target row, in elements, with range [0, infinity)
worker	Optional worker object to distribute the computational load

◆ convertY10_PackedToY8GammaLUT()

void Ocean::CV::FrameConverterY10_Packed::convertY10_PackedToY8GammaLUT	(	const uint8_t *const	source,
		uint8_t *const	target,
		const unsigned int	width,
		const unsigned int	height,
		const ConversionFlag	flag,
		const float	gamma,
		const unsigned int	sourcePaddingElements,
		const unsigned int	targetPaddingElements,
		Worker *	worker = `nullptr`
	)

inlinestatic

Converts a Y10_PACKED frame to a Y8 frame by applying gamma compression/correction using a lookup table.

The gamma compression/correction is based the following equation

Y8 = 255 * (Y10 / 1023) ^ gamma

Parameters

source	The source frame buffer, must be valid
target	The target frame buffer, must be valid
width	The width of the frame in pixel, with range [4, infinity), must be a multiple of 4
height	The height of the frame in pixel, with range [1, infinity)
flag	Determining the type of conversion
gamma	The gamma value to be applied, with range (0, 2)
sourcePaddingElements	The number of padding elements at the end of each source row, in elements, with range [0, infinity)
targetPaddingElements	The number of padding elements at the end of each target row, in elements, with range [0, infinity)
worker	Optional worker object to distribute the computational load

◆ convertY10_PackedToY8Linear()

void Ocean::CV::FrameConverterY10_Packed::convertY10_PackedToY8Linear	(	const uint8_t *const	source,
		uint8_t *const	target,
		const unsigned int	width,
		const unsigned int	height,
		const ConversionFlag	flag,
		const unsigned int	sourcePaddingElements,
		const unsigned int	targetPaddingElements,
		Worker *	worker = `nullptr`
	)

inlinestatic

Converts a Y10_PACKED frame to a Y8 frame.

Parameters

source	The source frame buffer, must be valid
target	The target frame buffer, must be valid
width	The width of the frame in pixel, with range [4, infinity), must be a multiple of 4
height	The height of the frame in pixel, with range [1, infinity)
flag	Determining the type of conversion
sourcePaddingElements	The number of padding elements at the end of each source row, in elements, with range [0, infinity)
targetPaddingElements	The number of padding elements at the end of each target row, in elements, with range [0, infinity)
worker	Optional worker object to distribute the computational load

The documentation for this class was generated from the following file:

FrameConverterY10_Packed.h

Data Structures

Static Public Member Functions

Static Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ convert16PixelY10_PackedToY8ApproximatedNEON()

◆ convert16PixelY10_PackedToY8LinearNEON()

◆ convertRowY10_PackedToY10()

◆ convertRowY10_PackedToY8GammaApproximated()

◆ convertRowY10_PackedToY8GammaLUT()

◆ convertRowY10_PackedToY8Linear()

◆ convertRowY10_PackedToYYY24Linear()

◆ convertY10_PackedToBGR24()

◆ convertY10_PackedToRGB24()

◆ convertY10_PackedToY10()

◆ convertY10_PackedToY8GammaApproximated()

◆ convertY10_PackedToY8GammaLUT()

◆ convertY10_PackedToY8Linear()