AV module

VideoContext

Base video context from which all video encoders and decoders derive.

#include <icy/av/videocontext.h>

struct VideoContext

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

Public Attributes

ReturnNameDescription
PacketSignalemitter
VideoCodeciparamsinput parameters
VideoCodecoparamsoutput parameters
AVStream *streamencoder or decoder stream
AVCodecContext *ctxencoder or decoder context
const AVCodec *codecencoder or decoder codec
AVFrame *frameencoder or decoder frame
std::unique_ptr< VideoConverter >convvideo conversion context
int64_ttimestream time in codec time base
int64_tptslast packet pts value
doublesecondsvideo time in seconds
std::stringerrorerror message

emitter

PacketSignal emitter

Type: PacketSignal

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


iparams

VideoCodec iparams

Type: VideoCodec

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

input parameters


oparams

VideoCodec oparams

Type: VideoCodec

Defined in src/av/include/icy/av/videocontext.h:106

output parameters


stream

AVStream * stream

Defined in src/av/include/icy/av/videocontext.h:107

encoder or decoder stream


ctx

AVCodecContext * ctx

Defined in src/av/include/icy/av/videocontext.h:108

encoder or decoder context


codec

const AVCodec * codec

Defined in src/av/include/icy/av/videocontext.h:109

encoder or decoder codec


frame

AVFrame * frame

Defined in src/av/include/icy/av/videocontext.h:110

encoder or decoder frame


conv

std::unique_ptr< VideoConverter > conv

Type: std::unique_ptr< VideoConverter >

Defined in src/av/include/icy/av/videocontext.h:111

video conversion context


time

int64_t time

Defined in src/av/include/icy/av/videocontext.h:112

stream time in codec time base


pts

int64_t pts

Defined in src/av/include/icy/av/videocontext.h:113

last packet pts value


seconds

double seconds

Defined in src/av/include/icy/av/videocontext.h:114

video time in seconds


error

std::string error

Defined in src/av/include/icy/av/videocontext.h:115

error message

Public Methods

ReturnNameDescription
VideoContext
~VideoContext virtual noexcept
VideoContextDeleted constructor.
VideoContext &operator=Deleted assignment operator.
VideoContextDeleted constructor.
VideoContext &operator=Deleted assignment operator.
voidcreate virtualInitialise the AVCodecContext with codec-specific defaults. Overridden by VideoEncoder and VideoDecoder.
voidopen virtualOpen the codec and create the pixel format conversion context if required. 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 video packet and emit the resulting frame.
boolencode virtualEncode a buffer of interleaved video data.
boolencode virtualEncode a planar video frame.
boolencode virtualEncode a single AVFrame.
voidflush virtualFlush any frames buffered inside the codec and emit remaining output.
AVFrame *convert virtualConvert the video frame and return the result.
boolrecreateConverter virtualRecreate the VideoConverter if the input or output parameters have changed. Called automatically by open() and convert().

VideoContext

VideoContext()

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


~VideoContext

virtual noexcept

virtual ~VideoContext() noexcept

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


VideoContext

VideoContext(const VideoContext &) = delete

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

Deleted constructor.


operator=

VideoContext & operator=(const VideoContext &) = delete

Defined in src/av/include/icy/av/videocontext.h:48

Deleted assignment operator.


VideoContext

VideoContext(VideoContext &&) = delete

Defined in src/av/include/icy/av/videocontext.h:49

Deleted constructor.


operator=

VideoContext & operator=(VideoContext &&) = delete

Defined in src/av/include/icy/av/videocontext.h:50

Deleted assignment operator.


create

virtual

virtual void create()

Defined in src/av/include/icy/av/videocontext.h:54

Initialise the AVCodecContext with codec-specific defaults. Overridden by VideoEncoder and VideoDecoder.

Reimplemented by


open

virtual

virtual void open()

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

Open the codec and create the pixel format conversion context if required. Throws std::runtime_error if the codec context has not been created.

Reimplemented by


close

virtual

virtual void close()

Defined in src/av/include/icy/av/videocontext.h:61

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/videocontext.h:66

Decode a compressed video packet and emit the resulting frame.

Returns

True if an output frame was decoded and emitted, false otherwise.

Reimplemented by

Parameters

ParameterTypeDescription
ipacketAVPacket &The compressed video packet to decode.

encode

virtual

virtual bool encode(uint8_t * data, int size, int64_t pts)

Defined in src/av/include/icy/av/videocontext.h:73

Encode a buffer of interleaved video data.

Returns

True if an encoded packet was produced and emitted.

Reimplemented by

Parameters

ParameterTypeDescription
datauint8_t *Pointer to the interleaved frame buffer.
sizeintSize of the buffer in bytes.
ptsint64_tPresentation timestamp in stream time base units.

encode

virtual

virtual bool encode(uint8_t * data, int linesize, int64_t pts)

Defined in src/av/include/icy/av/videocontext.h:80

Encode a planar video frame.

Returns

True if an encoded packet was produced and emitted.

Reimplemented by

Parameters

ParameterTypeDescription
datauint8_t *Array of per-plane data pointers (up to 4 planes).
linesizeintArray of per-plane byte strides.
ptsint64_tPresentation timestamp in stream time base units.

encode

virtual

virtual bool encode(AVFrame * iframe)

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

Encode a single AVFrame.

Returns

True if an encoded packet was produced and emitted.

Reimplemented by

Parameters

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

flush

virtual

virtual void flush()

Defined in src/av/include/icy/av/videocontext.h:88

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

Reimplemented by


convert

virtual

virtual AVFrame * convert(AVFrame * iframe)

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

Convert the video frame and return the result.

The input frame will only be converted if it doesn't match the output format. If the frame is not converted the input frame will be returned. If the input frame format does not match the VideoConverter context then the VideoConverter will be recreated with the input frame params.


recreateConverter

virtual

virtual bool recreateConverter()

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

Recreate the VideoConverter if the input or output parameters have changed. Called automatically by open() and convert().

Returns

True if the converter was (re)created, false if it is already up to date.