Once the uncompressed audio data has been divided into blocks, this
Chris@1: function is called on each block. It looks up the encoding mode and
Chris@1: dispatches the block to the forward transform provided by that mode.
Chris@1:
Chris@1:
When using a basic encoding mode, with no bitrate management,
Chris@1: an ogg_packet pointer can be given, and the coded block is returned
Chris@1: directly through that structure and can be placed in the output stream.
Chris@1:
Chris@1:
Otherwise, NULL should be passed for the ogg_packet pointer. In
Chris@1: that case, after the transform has been applied, the block must passed
Chris@1: to vorbis_bitrate_addblock() for further coding. This method works with
Chris@1: both basic and managed encoding modes, so it's recommended for new code.
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Chris@1: extern int vorbis_analysis(vorbis_block *vb,ogg_packet *op);
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Parameters
Chris@1:
Chris@1:
vb
Chris@1:
Pointer to the vorbis_block to be encoded.
Chris@1:
op
Chris@1:
Optional pointer to an ogg_packet. This is normally NULL,
Chris@1: and the final output is obtained by passing vb though the
Chris@1: vorbis_bitrate_*() interface to perform further refinement.
Chris@1: However, when not using a bitrate managed encoding mode, it
Chris@1: is possible to skip that step by providing an ogg_packet pointer
Chris@1: here, obtaining the compressed data directly.
Chris@1:
Chris@1:
Chris@1:
Chris@1:
Return Values
Chris@1:
Chris@1:
0 for success
Chris@1:
negative values for failure:
Chris@1:
Chris@1:
OV_EINVAL - Invalid request; a non-NULL value was passed for op when the encoder is using a bitrate managed mode.
Chris@1:
OV_EFAULT - Internal fault; indicates a bug or memory corruption.
Chris@1:
OV_EIMPL - Unimplemented; not supported by this version of the library.