AV module

AudioContext

Base context for audio encoding and decoding via FFmpeg.

#include <icy/av/audiocontext.h>

struct AudioContext

Defined in src/av/include/icy/av/audiocontext.h:39

Public Attributes

ReturnNameDescription
PacketSignalemitter
AudioCodeciparamsinput parameters
AudioCodecoparamsoutput parameters
AVStream *streamencoder or decoder stream
AVCodecContext *ctxencoder or decoder context
const AVCodec *codecencoder or decoder codec
AVFrame *framelast encoded or decoded frame
std::unique_ptr< AudioResampler >resampleraudio resampler
intoutputFrameSizeencoder or decoder output frame size
int64_ttimestream time in codec time base
int64_tptslast packet pts value
doublesecondsaudio time in seconds
std::stringerrorerror message

emitter

PacketSignal emitter

Type: PacketSignal

Defined in src/av/include/icy/av/audiocontext.h:92


iparams

AudioCodec iparams

Type: AudioCodec

Defined in src/av/include/icy/av/audiocontext.h:94

input parameters


oparams

AudioCodec oparams

Type: AudioCodec

Defined in src/av/include/icy/av/audiocontext.h:95

output parameters


stream

AVStream * stream

Defined in src/av/include/icy/av/audiocontext.h:96

encoder or decoder stream


ctx

AVCodecContext * ctx

Defined in src/av/include/icy/av/audiocontext.h:97

encoder or decoder context


codec

const AVCodec * codec

Defined in src/av/include/icy/av/audiocontext.h:98

encoder or decoder codec


frame

AVFrame * frame

Defined in src/av/include/icy/av/audiocontext.h:99

last encoded or decoded frame


resampler

std::unique_ptr< AudioResampler > resampler

Type: std::unique_ptr< AudioResampler >

Defined in src/av/include/icy/av/audiocontext.h:100

audio resampler


outputFrameSize

int outputFrameSize

Defined in src/av/include/icy/av/audiocontext.h:101

encoder or decoder output frame size


time

int64_t time

Defined in src/av/include/icy/av/audiocontext.h:102

stream time in codec time base


pts

int64_t pts

Defined in src/av/include/icy/av/audiocontext.h:103

last packet pts value


seconds

double seconds

Defined in src/av/include/icy/av/audiocontext.h:104

audio time in seconds


error

std::string error

Defined in src/av/include/icy/av/audiocontext.h:105

error message

Public Methods

ReturnNameDescription
AudioContext
~AudioContext virtual noexcept
AudioContextDeleted constructor.
AudioContext &operator=Deleted assignment operator.
AudioContextDeleted constructor.
AudioContext &operator=Deleted assignment operator.
voidcreate virtualInitialise the AVCodecContext with codec-specific defaults. Implemented by AudioEncoder and AudioDecoder.
voidopen virtualOpen the codec and create the resampler if input/output parameters differ. Throws std::runtime_error if the codec context has not been created.
voidclose virtualClose the codec context, free the frame, and reset timestamps.
booldecode virtualDecode a compressed audio packet and emit the resulting samples.
boolencode virtualEncode a buffer of interleaved audio samples.
boolencode virtualEncode a buffer of planar audio samples.
boolencode virtualEncode a single AVFrame.
voidflush virtualFlush any frames buffered inside the codec and emit remaining output.
boolrecreateResampler virtualRecreate the AudioResampler using the current iparams and oparams. Called automatically by open() when format conversion is required.

AudioContext

AudioContext()

Defined in src/av/include/icy/av/audiocontext.h:41


~AudioContext

virtual noexcept

virtual ~AudioContext() noexcept

Defined in src/av/include/icy/av/audiocontext.h:42


AudioContext

AudioContext(const AudioContext &) = delete

Defined in src/av/include/icy/av/audiocontext.h:44

Deleted constructor.


operator=

AudioContext & operator=(const AudioContext &) = delete

Defined in src/av/include/icy/av/audiocontext.h:45

Deleted assignment operator.


AudioContext

AudioContext(AudioContext &&) = delete

Defined in src/av/include/icy/av/audiocontext.h:46

Deleted constructor.


operator=

AudioContext & operator=(AudioContext &&) = delete

Defined in src/av/include/icy/av/audiocontext.h:47

Deleted assignment operator.


create

virtual

virtual void create()

Defined in src/av/include/icy/av/audiocontext.h:51

Initialise the AVCodecContext with codec-specific defaults. Implemented by AudioEncoder and AudioDecoder.

Reimplemented by


open

virtual

virtual void open()

Defined in src/av/include/icy/av/audiocontext.h:55

Open the codec and create the resampler if input/output parameters differ. Throws std::runtime_error if the codec context has not been created.


close

virtual

virtual void close()

Defined in src/av/include/icy/av/audiocontext.h:58

Close the codec context, free the frame, and reset timestamps.

Reimplemented by


decode

virtual

virtual bool decode(AVPacket & ipacket)

Defined in src/av/include/icy/av/audiocontext.h:63

Decode a compressed audio packet and emit the resulting samples.

Returns

True if one or more decoded frames were emitted, false otherwise.

Reimplemented by

Parameters

ParameterTypeDescription
ipacketAVPacket &The compressed audio packet to decode.

encode

virtual

virtual bool encode(uint8_t * samples, int numSamples, int64_t pts)

Defined in src/av/include/icy/av/audiocontext.h:70

Encode a buffer of interleaved audio samples.

Returns

True if an encoded packet was produced and emitted.

Reimplemented by

Parameters

ParameterTypeDescription
samplesuint8_t *Pointer to the interleaved sample buffer.
numSamplesintNumber of samples per channel.
ptsint64_tPresentation timestamp in stream time base units.

encode

virtual

virtual bool encode(uint8_t * samples, int numSamples, int64_t pts)

Defined in src/av/include/icy/av/audiocontext.h:77

Encode a buffer of planar audio samples.

Returns

True if an encoded packet was produced and emitted.

Reimplemented by

Parameters

ParameterTypeDescription
samplesuint8_t *Array of per-channel sample buffers (up to 4 planes).
numSamplesintNumber of samples per channel.
ptsint64_tPresentation timestamp in stream time base units.

encode

virtual

virtual bool encode(AVFrame * iframe)

Defined in src/av/include/icy/av/audiocontext.h:82

Encode a single AVFrame.

Returns

True if an encoded packet was produced and emitted.

Reimplemented by

Parameters

ParameterTypeDescription
iframeAVFrame *The source audio frame; must have all fields set correctly.

flush

virtual

virtual void flush()

Defined in src/av/include/icy/av/audiocontext.h:85

Flush any frames buffered inside the codec and emit remaining output.

Reimplemented by


recreateResampler

virtual

virtual bool recreateResampler()

Defined in src/av/include/icy/av/audiocontext.h:90

Recreate the AudioResampler using the current iparams and oparams. Called automatically by open() when format conversion is required.

Returns

True if the resampler was successfully created.