Decodes compressed RGBA texture images.
Syntax
IppStatus ippiTextureDecodeBlockToRGBA_DXT1_8u_C1C4R(const Ipp8u* pSrc, Ipp8u* pDst, Ipp32u dstStep, IppiSize roiSize);
IppStatus ippiTextureDecodeBlockToRGBA_DXT3_8u_C1C4R(const Ipp8u* pSrc, Ipp8u* pDst, Ipp32u dstStep, IppiSize roiSize);
IppStatus ippiTextureDecodeBlockToRGBA_DXT5_8u_C1C4R(const Ipp8u* pSrc, Ipp8u* pDst, Ipp32u dstStep, IppiSize roiSize);
IppStatus ippiTextureDecodeBlockToRGBA_BC7_8u_C1C4R(const Ipp8u* pSrc, Ipp8u* pDst, Ipp32u dstStep, IppiSize roiSize);
Parameters
pSrc |
Pointer to the source array of the encoded blocks. |
pDst |
Pointer to the destination image ROI. |
dstStep |
Distance in bytes between starts of consecutive lines in the destonation image. |
roiSize |
Size of the destination image ROI in pixels. |
Description
The function ippiTextureDecodeBlockToRGBA is declared in the ippj.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function decodes the source data pSrc and restores the RGBA texture image pDst. Source data are the encoded blocks in DXT1, DXT3, DXT5, or BC7 formats in accordance with the descriptor DXT1, DXT3, DXT5 and BC7 respectively. You must ensure that the pSrc buffer contains enough 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, for BC7 (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. |