Initializes the VLC decoder structure.
Syntax
ippsVLCDecodeInit_32s (const IppsVLCTable_32s* pInputTable, int inputTableSize, Ipp32s* pSubTablesSizes, int numSubTables, IppsVLCDecodeSpec_32s* pVLCSpec);
Parameters
pInputTable |
Pointer to the VLC table. |
inputTableSize |
Size of the VLC table. |
pSubTablesSizes |
Pointer to the sizes of the subtables. |
numSubTables |
Number of the subtables. |
pVLCSpec |
Pointer to the VLC decoder specification structure. |
Description
The function ippsVLCDecodeInit is declared in the ippdc.h file. This function initializes in the external buffer the VLC decoder structure pVLCSpec that is specified by the following parameters: the VLC table pInputTable of size inputTableSize, the number of internal subtables numSubTables and their sizes pSubTablesSizes. Size values for the subtables must be greater than 0. The sum of these values must be greater than or preferably equal to the maximum code length in the VLC table. The size of the external buffer must be computed previously by calling the function ippsVLCDecodeGetSize. Alternatively, the VLC decoder structure can be initialized by the function ippsVLCDecodeInitAlloc.
The VLC decoder specification structure is used by the functions ippsVLCDecodeBlock and ippsVLCDecodeOne.
Note
The parameters pInputTable and inputTableSize of the ippsVLCDecodeInit and ippsVLCDecodeGetSize functions must have equal respective values to avoid an error in subsequent decoding fu
nctions.Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error if one of the specified pointers is NULL. |
ippStsVLCUsrTblCodeLengthErr |
Indicates an error if the maximum code length in the input table exceeds 32; or if any size value for the subtables in pSubTablesSizes is less than 1; or if the sum of these values is less than the maximum code length in the input table. |