Encodes RGBA texture images.
Syntax
IppStatus ippiTextureEncodeBlockFromRGBA_DXT1_8u_C4C1R(const Ipp8u* pSrc, Ipp32u srcStep, IppiSize roiSize, Ipp8u* pDst);
IppStatus ippiTextureEncodeBlockFromRGBA_DXT3_8u_C4C1R(const Ipp8u* pSrc, Ipp32u srcStep, IppiSize roiSize, Ipp8u* pDst);
IppStatus ippiTextureEncodeBlockFromRGBA_DXT5_8u_C4C1R(const Ipp8u* pSrc, Ipp32u srcStep, IppiSize roiSize, Ipp8u* pDst);
Parameters
pSrc |
Pointer to the source image ROI. |
srcStep |
Distance in bytes between starts of consecutive lines in the source image. |
roiSize |
Size of the source image ROI in pixels. |
pDst |
Pointer to the destination array of the encoded blocks. |
Description
The function ippiTextureEncodeBlockFromRGBA is declared in the ippj.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function encodes the source image ROI pSrc from RGBA to DXT1, DXT3 or DXT5 format in accordance with the descriptor DXT1, DXT3 and DXT5 respectively. You must ensure that the pDst buffer contains enough space for compressed data. For the DXT1 compression (compression ratio 8:1) the size of one compressed block is 8 bytes, for the DXT3 and DXT5 compressions (compression ratio 4:1) the size of one compressed block is 16 bytes.
Note
Negative step values are not supported.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error if pSrc or pDst pointer is NULL. |
ippStsSizeErr |
Indicates an error condition if roiSize has a field with zero or negative value. |