Encodes a frame of audio.
@param st Encoder state
@param pcm PCM audio in float format, with a normal range of ±1.0.
Samples with a range beyond ±1.0 are supported but will
be clipped by decoders using the integer API and should
only be used if it is known that the far end supports
extended dynmaic range. There must be exactly
frame_size samples per channel.
@param optional_resynthesis If not NULL, the encoder copies the audio signal that
the decoder would decode. It is the same as calling the
decoder on the compressed data, just faster.
This may alias pcm.
@param compressed The compressed data is written here. This may not alias pcm or
optional_synthesis.
@param nbCompressedBytes Maximum number of bytes to use for compressing the frame
(can change from one frame to another)
@return Number of bytes written to "compressed". Will be the same as
"nbCompressedBytes" unless the stream is VBR and will never be larger.
If negative, an error has occurred (see error codes). It is IMPORTANT that
the length returned be somehow transmitted to the decoder. Otherwise, no
decoding is possible.
Encodes a frame of audio. @param st Encoder state @param pcm PCM audio in float format, with a normal range of ±1.0. Samples with a range beyond ±1.0 are supported but will be clipped by decoders using the integer API and should only be used if it is known that the far end supports extended dynmaic range. There must be exactly frame_size samples per channel. @param optional_resynthesis If not NULL, the encoder copies the audio signal that the decoder would decode. It is the same as calling the decoder on the compressed data, just faster. This may alias pcm. @param compressed The compressed data is written here. This may not alias pcm or optional_synthesis. @param nbCompressedBytes Maximum number of bytes to use for compressing the frame (can change from one frame to another) @return Number of bytes written to "compressed". Will be the same as "nbCompressedBytes" unless the stream is VBR and will never be larger. If negative, an error has occurred (see error codes). It is IMPORTANT that the length returned be somehow transmitted to the decoder. Otherwise, no decoding is possible.