VLCDecodeUTupleOne

Decodes a single VLC encoded tuple.

Syntax

IppStatus ippsVLCDecodeUTupleOne_1u16s(Ipp8u** ppSrc, int* pSrcBitsOffset, Ipp16s* pDst, const IppsVLCDecodeUTupleSpec_32s* pVLCSpec);

Parameters

ppSrc	Double pointer to the source bitstream.
pSrcBitsOffset	Pointer to the input/output bit position.
pDst	Pointer to the decoded value.
pVLCSpec	Pointer to the VLC decoder specification structure.

Description

The function ippsVLCDecodeUTupleOne is declared in the ippdc.h file. This function decodes a single VLC encoded element (containing numElements samples) in the ppSrc on position pSrcBitsOffset. The decoded element is stored in the destination buffer pDst.

After decoding the function shifts the source pointer by the number of successfully read and processed bytes. The function updates pSrcBitsOffset setting it to the actual bit position in the source buffer.

The function ippVLCDecodeUTupleOne uses the VLC table from the decoder specification structure pVLCSpec that must be initialized by the functions ippsVLCDecodeUTupleInit or ippsVLCDecodeUTupleInitAlloc beforehand.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error if one of the specified pointers is NULL.
ippStsVLCInputDataErr	Indicates an error if incorrect input is used. For decoding functions it can indicate that bitstream contains code that is not specified in the table.
ippStsBitOffsetErr	Indicates an error if value of the pSrcBitsOffset is less than 0 or greater than 7.
ippStsContextMatchErr	Indicates an error if the pVLCSpec structure is not initialized by the function ippsVLCDecodeUTupleInitAlloc or ippsVLCDecodeUTupleInit.