gavl
|
Compressed stream support. More...
Data Structures | |
struct | gavl_compression_info_t |
Compression format. More... | |
struct | gavl_packet_t |
Packet structure. More... | |
struct | gavl_stream_stats_t |
Macros | |
#define | GAVL_COMPRESSION_HAS_P_FRAMES (1<<0) |
Set if not all frames are keyframes. More... | |
#define | GAVL_COMPRESSION_HAS_B_FRAMES (1<<1) |
Set if frames don't appear in presentation order. More... | |
#define | GAVL_COMPRESSION_HAS_FIELD_PICTURES (1<<2) |
Packets can consist of 2 consecutive fields. More... | |
#define | GAVL_COMPRESSION_SBR (1<<3) |
Samplerate got doubled by decoder, format and sample counts are for the upsampled rate. More... | |
#define | GAVL_COMPRESSION_BIG_ENDIAN (1<<4) |
Only in uncompressed gavf streams: Specifies that multibyte numbers are big endian. More... | |
#define | GAVL_BITRATE_VBR -1 |
Use this to specify a VBR stream. More... | |
#define | GAVL_BITRATE_LOSSLESS -2 |
Use this to specify a losslessly compressed stream. More... | |
#define | GAVL_PACKET_TYPE_I 0x01 |
Packet is an I-frame. More... | |
#define | GAVL_PACKET_TYPE_P 0x02 |
Packet is a P-frame. More... | |
#define | GAVL_PACKET_TYPE_B 0x03 |
Packet is a B-frame. More... | |
#define | GAVL_PACKET_TYPE_MASK 0x03 |
Mask for frame type. More... | |
#define | GAVL_PACKET_KEYFRAME (1<<2) |
Packet is a keyframe. More... | |
#define | GAVL_PACKET_LAST (1<<3) |
Packet is the last in the stream (only Xiph codecs need this flag) More... | |
#define | GAVL_PACKET_EXT (1<<4) |
Packet has extensions (used only in gavf files) More... | |
#define | GAVL_PACKET_REF (1<<5) |
B-frame used as reference (can't savely be skipped) More... | |
#define | GAVL_PACKET_NOOUTPUT (1<<6) |
Packet will produce no decoder output (e.g. VP8 alternate reference) More... | |
#define | GAVL_PACKET_FLAG_PRIV (1<<16) |
Private flag (defined outside of gavl) More... | |
#define | GAVL_PACKET_PADDING 32 |
Packets are padded in memory with this many zero bytes. More... | |
Typedefs | |
typedef struct gavl_packet_pts_cache_s | gavl_packet_pts_cache_t |
Enumerations | |
enum | gavl_codec_id_t { GAVL_CODEC_ID_NONE = 0 , GAVL_CODEC_ID_ALAW = 1 , GAVL_CODEC_ID_ULAW , GAVL_CODEC_ID_MP2 , GAVL_CODEC_ID_MP3 , GAVL_CODEC_ID_AC3 , GAVL_CODEC_ID_AAC , GAVL_CODEC_ID_VORBIS , GAVL_CODEC_ID_FLAC , GAVL_CODEC_ID_OPUS , GAVL_CODEC_ID_SPEEX , GAVL_CODEC_ID_DTS , GAVL_CODEC_ID_JPEG = 0x10000 , GAVL_CODEC_ID_PNG , GAVL_CODEC_ID_TIFF , GAVL_CODEC_ID_TGA , GAVL_CODEC_ID_MPEG1 , GAVL_CODEC_ID_MPEG2 , GAVL_CODEC_ID_MPEG4_ASP , GAVL_CODEC_ID_H264 , GAVL_CODEC_ID_THEORA , GAVL_CODEC_ID_DIRAC , GAVL_CODEC_ID_DV , GAVL_CODEC_ID_VP8 , GAVL_CODEC_ID_DIV3 , GAVL_CODEC_ID_DVDSUB = 0x20000 } |
Codec ID. More... | |
Functions | |
GAVL_PUBLIC void | gavl_compression_info_init (gavl_compression_info_t *info) |
Initialize a compression info. More... | |
GAVL_PUBLIC void | gavl_compression_info_free (gavl_compression_info_t *info) |
Free all dynamically allocated memory of a compression info. More... | |
GAVL_PUBLIC void | gavl_compression_info_dump (const gavl_compression_info_t *info) |
Dump a compression info to stderr. More... | |
GAVL_PUBLIC void | gavl_compression_info_dumpi (const gavl_compression_info_t *info, int num) |
Dump a compression info to stderr. More... | |
GAVL_PUBLIC void | gavl_compression_info_copy (gavl_compression_info_t *dst, const gavl_compression_info_t *src) |
Copy a compression info. More... | |
GAVL_PUBLIC void | gavl_append_xiph_header (uint8_t **global_header, uint32_t *global_header_len, uint8_t *header, int header_len) |
Append a Xiph packet to a global header. More... | |
GAVL_PUBLIC uint8_t * | gavl_extract_xiph_header (uint8_t *global_header, int global_header_len, int idx, int *header_len) |
Extract a Xiph packet to a global header. More... | |
GAVL_PUBLIC const char * | gavl_compression_get_extension (gavl_codec_id_t id, int *separate) |
Get the file extension of the corresponding raw format. More... | |
GAVL_PUBLIC int | gavl_compression_need_pixelformat (gavl_codec_id_t id) |
Check if the compression supports multiple pixelformats. More... | |
const char * | gavl_compression_get_mimetype (const gavl_compression_info_t *ci) |
Get the mimetype for the corresponding elementary format. More... | |
GAVL_PUBLIC int | gavl_compression_constant_frame_samples (gavl_codec_id_t id) |
Check if an audio compression constant frame samples. More... | |
GAVL_PUBLIC int | gavl_compression_get_sample_size (gavl_codec_id_t id) |
Check if an audio compression size for each samples. More... | |
GAVL_PUBLIC const char * | gavl_compression_get_long_name (gavl_codec_id_t id) |
Return the long name of the compression. More... | |
GAVL_PUBLIC const char * | gavl_compression_get_short_name (gavl_codec_id_t id) |
Return the short name of the compression. More... | |
GAVL_PUBLIC gavl_codec_id_t | gavl_compression_from_short_name (const char *name) |
Get a compression from the short name. More... | |
GAVL_PUBLIC int | gavl_num_compressions () |
Get the number of compression formats. More... | |
GAVL_PUBLIC gavl_codec_id_t | gavl_get_compression (int index) |
Get a compression format for a specified index. More... | |
GAVL_PUBLIC void | gavl_packet_init (gavl_packet_t *p) |
Initialize a packet. More... | |
GAVL_PUBLIC void | gavl_packet_alloc (gavl_packet_t *p, int len) |
Allocate memory for a packet. More... | |
GAVL_PUBLIC void | gavl_packet_free (gavl_packet_t *p) |
Free memory of a packet. More... | |
GAVL_PUBLIC void | gavl_packet_copy (gavl_packet_t *dst, const gavl_packet_t *src) |
Copy a packet. More... | |
GAVL_PUBLIC void | gavl_packet_copy_metadata (gavl_packet_t *dst, const gavl_packet_t *src) |
Copy metadata of a packet. More... | |
GAVL_PUBLIC void | gavl_packet_reset (gavl_packet_t *p) |
Reset a packet. More... | |
GAVL_PUBLIC void | gavl_packet_dump (const gavl_packet_t *p) |
Dump a packet to stderr. More... | |
GAVL_PUBLIC void | gavl_packet_save (const gavl_packet_t *p, const char *filename) |
Save a packet to a file. More... | |
GAVL_PUBLIC void | gavl_packet_to_videoframe (const gavl_packet_t *p, gavl_video_frame_t *f) |
GAVL_PUBLIC void | gavl_stream_stats_init (gavl_stream_stats_t *) |
GAVL_PUBLIC void | gavl_stream_stats_dump (const gavl_stream_stats_t *, int indent) |
GAVL_PUBLIC void | gavl_stream_stats_update (gavl_stream_stats_t *, const gavl_packet_t *p) |
GAVL_PUBLIC void | gavl_stream_stats_update_params (gavl_stream_stats_t *f, int64_t pts, int64_t duration, int data_len, int flags) |
GAVL_PUBLIC void | gavl_stream_stats_apply_audio (gavl_stream_stats_t *f, const gavl_audio_format_t *fmt, gavl_compression_info_t *ci, gavl_dictionary_t *m) |
GAVL_PUBLIC void | gavl_stream_stats_apply_video (gavl_stream_stats_t *f, gavl_video_format_t *fmt, gavl_compression_info_t *ci, gavl_dictionary_t *m) |
GAVL_PUBLIC void | gavl_stream_stats_apply_subtitle (gavl_stream_stats_t *f, gavl_dictionary_t *m) |
GAVL_PUBLIC void | gavl_stream_stats_apply_generic (gavl_stream_stats_t *f, gavl_compression_info_t *ci, gavl_dictionary_t *m) |
GAVL_PUBLIC int | gavl_stream_get_stats (const gavl_dictionary_t *s, gavl_stream_stats_t *stats) |
GAVL_PUBLIC void | gavl_stream_set_stats (gavl_dictionary_t *s, const gavl_stream_stats_t *stats) |
GAVL_PUBLIC gavl_packet_pts_cache_t * | gavl_packet_pts_cache_create (int size) |
GAVL_PUBLIC void | gavl_packet_pts_cache_destroy (gavl_packet_pts_cache_t *) |
GAVL_PUBLIC void | gavl_packet_pts_cache_push (gavl_packet_pts_cache_t *m, const gavl_packet_t *pkt) |
GAVL_PUBLIC int | gavl_packet_pts_cache_get_first (gavl_packet_pts_cache_t *m, gavl_packet_t *pkt) |
GAVL_PUBLIC int | gavl_packet_pts_cache_get_by_pts (gavl_packet_pts_cache_t *m, gavl_packet_t *pkt, int64_t pts) |
GAVL_PUBLIC void | gavl_packet_pts_cache_clear (gavl_packet_pts_cache_t *m) |
Compressed stream support.
gavl provides some structures and functions for handling compressed data packets. It is a completely independent API layer and has nothing to do with the uncompressed video and audio API. In particular the conversion between compressed and uncompressed data (i.e. codecs) are outside the scope of gavl. These are implemented in gmerlin-avdecoder and gmerlin encoding plugins.
#define GAVL_COMPRESSION_HAS_P_FRAMES (1<<0) |
Set if not all frames are keyframes.
#define GAVL_COMPRESSION_HAS_B_FRAMES (1<<1) |
Set if frames don't appear in presentation order.
#define GAVL_COMPRESSION_HAS_FIELD_PICTURES (1<<2) |
Packets can consist of 2 consecutive fields.
#define GAVL_COMPRESSION_SBR (1<<3) |
Samplerate got doubled by decoder, format and sample counts are for the upsampled rate.
#define GAVL_COMPRESSION_BIG_ENDIAN (1<<4) |
Only in uncompressed gavf streams: Specifies that multibyte numbers are big endian.
#define GAVL_BITRATE_VBR -1 |
Use this to specify a VBR stream.
#define GAVL_BITRATE_LOSSLESS -2 |
Use this to specify a losslessly compressed stream.
#define GAVL_PACKET_TYPE_I 0x01 |
Packet is an I-frame.
#define GAVL_PACKET_TYPE_P 0x02 |
Packet is a P-frame.
#define GAVL_PACKET_TYPE_B 0x03 |
Packet is a B-frame.
#define GAVL_PACKET_TYPE_MASK 0x03 |
Mask for frame type.
#define GAVL_PACKET_KEYFRAME (1<<2) |
Packet is a keyframe.
#define GAVL_PACKET_LAST (1<<3) |
Packet is the last in the stream (only Xiph codecs need this flag)
#define GAVL_PACKET_EXT (1<<4) |
Packet has extensions (used only in gavf files)
#define GAVL_PACKET_REF (1<<5) |
B-frame used as reference (can't savely be skipped)
#define GAVL_PACKET_NOOUTPUT (1<<6) |
Packet will produce no decoder output (e.g. VP8 alternate reference)
#define GAVL_PACKET_FLAG_PRIV (1<<16) |
Private flag (defined outside of gavl)
#define GAVL_PACKET_PADDING 32 |
Packets are padded in memory with this many zero bytes.
enum gavl_codec_id_t |
Codec ID.
These are used as identifiers for the type of compression
GAVL_PUBLIC void gavl_compression_info_init | ( | gavl_compression_info_t * | info | ) |
Initialize a compression info.
info | A compression info |
Use this for compression infos which are on the stack before using them.
GAVL_PUBLIC void gavl_compression_info_free | ( | gavl_compression_info_t * | info | ) |
Free all dynamically allocated memory of a compression info.
info | A compression info |
GAVL_PUBLIC void gavl_compression_info_dump | ( | const gavl_compression_info_t * | info | ) |
Dump a compression info to stderr.
info | A compression info |
Use this for debugging
GAVL_PUBLIC void gavl_compression_info_dumpi | ( | const gavl_compression_info_t * | info, |
int | num | ||
) |
Dump a compression info to stderr.
info | A compression info |
indent | Indentation |
Same as gavl_compression_info_dump but it puts indent whitespaces in front of each line.
GAVL_PUBLIC void gavl_compression_info_copy | ( | gavl_compression_info_t * | dst, |
const gavl_compression_info_t * | src | ||
) |
Copy a compression info.
dst | Destination |
src | Source |
GAVL_PUBLIC void gavl_append_xiph_header | ( | uint8_t ** | global_header, |
uint32_t * | global_header_len, | ||
uint8_t * | header, | ||
int | header_len | ||
) |
Append a Xiph packet to a global header.
global_header | Global header (will be changed) |
global_header_len | Global header length (will be changed) |
header | header to append |
header_len | length of header to append |
GAVL_PUBLIC uint8_t* gavl_extract_xiph_header | ( | uint8_t * | global_header, |
int | global_header_len, | ||
int | idx, | ||
int * | header_len | ||
) |
Extract a Xiph packet to a global header.
global_header | Global header |
global_header_len | Global header length |
idx | Index of the packet (starting with 0) |
header_len | Returns the length of the header |
GAVL_PUBLIC const char* gavl_compression_get_extension | ( | gavl_codec_id_t | id, |
int * | separate | ||
) |
Get the file extension of the corresponding raw format.
id | A codec ID |
separate | If non-null returns 1 if each packet should be in a separate file |
This function can be used for writing elementary streams to files. It returns a suitable file extension. If separate is 1, each packet should be written to a separate file. This basically means, that the codec corresponds to an image format.
Not all compression formats have a suitable elementary stream format, in this case NULL is returned for the extension. Most prominent examples are Vorbis and Theora, which can hardly exist outside an OGG container.
GAVL_PUBLIC int gavl_compression_need_pixelformat | ( | gavl_codec_id_t | id | ) |
Check if the compression supports multiple pixelformats.
id | A codec ID |
This function can be used by decoding libraries to check if the compresison ID is sufficient or if the pixelformat must be valid in the associated video format.
const char* gavl_compression_get_mimetype | ( | const gavl_compression_info_t * | ci | ) |
Get the mimetype for the corresponding elementary format.
ci | A compression info |
GAVL_PUBLIC int gavl_compression_constant_frame_samples | ( | gavl_codec_id_t | id | ) |
Check if an audio compression constant frame samples.
id | A codec ID |
GAVL_PUBLIC int gavl_compression_get_sample_size | ( | gavl_codec_id_t | id | ) |
Check if an audio compression size for each samples.
id | A codec ID |
GAVL_PUBLIC const char* gavl_compression_get_long_name | ( | gavl_codec_id_t | id | ) |
Return the long name of the compression.
id | A codec ID |
GAVL_PUBLIC const char* gavl_compression_get_short_name | ( | gavl_codec_id_t | id | ) |
Return the short name of the compression.
id | A codec ID |
GAVL_PUBLIC gavl_codec_id_t gavl_compression_from_short_name | ( | const char * | name | ) |
Get a compression from the short name.
A | short name |
GAVL_PUBLIC int gavl_num_compressions | ( | ) |
Get the number of compression formats.
Use this with gavl_get_compression to enumerate all compression formats
GAVL_PUBLIC gavl_codec_id_t gavl_get_compression | ( | int | index | ) |
Get a compression format for a specified index.
index | Index (starting with 0) |
Use this with gavl_num_compressions to enumerate all compression formats
GAVL_PUBLIC void gavl_packet_init | ( | gavl_packet_t * | p | ) |
Initialize a packet.
p | A packet |
GAVL_PUBLIC void gavl_packet_alloc | ( | gavl_packet_t * | p, |
int | len | ||
) |
Allocate memory for a packet.
p | A packet |
len | Number of bytes you want to store in the packet |
This function uses realloc(), which means that it preserves the data already contained in the packet.
GAVL_PUBLIC void gavl_packet_free | ( | gavl_packet_t * | p | ) |
Free memory of a packet.
p | A packet |
GAVL_PUBLIC void gavl_packet_copy | ( | gavl_packet_t * | dst, |
const gavl_packet_t * | src | ||
) |
Copy a packet.
dst | Destination |
src | Source |
GAVL_PUBLIC void gavl_packet_copy_metadata | ( | gavl_packet_t * | dst, |
const gavl_packet_t * | src | ||
) |
Copy metadata of a packet.
dst | Destination |
src | Source |
Like gavl_packet_copy but leaves the payload of dst untouched.
Since 1.5.0
GAVL_PUBLIC void gavl_packet_reset | ( | gavl_packet_t * | p | ) |
Reset a packet.
p | Destination |
Set fields to their default values
GAVL_PUBLIC void gavl_packet_dump | ( | const gavl_packet_t * | p | ) |
Dump a packet to stderr.
p | A packet |
Use this for debugging
GAVL_PUBLIC void gavl_packet_save | ( | const gavl_packet_t * | p, |
const char * | filename | ||
) |
Save a packet to a file.
p | A packet |
file | Filename |
Use this for debugging