gavl
compression.h
1/*****************************************************************
2 * gavl - a general purpose audio/video processing library
3 *
4 * Copyright (c) 2001 - 2012 Members of the Gmerlin project
5 * gmerlin-general@lists.sourceforge.net
6 * http://gmerlin.sourceforge.net
7 *
8 * This program is free software: you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 * *****************************************************************/
21
22#ifndef GAVL_COMPRESSION_H_INCLUDED
23#define GAVL_COMPRESSION_H_INCLUDED
24
25#include <gavl/gavldefs.h>
26
27#ifdef __cplusplus
28extern "C" {
29#endif
30
47#define GAVL_COMPRESSION_HAS_P_FRAMES (1<<0)
48
50#define GAVL_COMPRESSION_HAS_B_FRAMES (1<<1)
51
53#define GAVL_COMPRESSION_HAS_FIELD_PICTURES (1<<2)
54
56#define GAVL_COMPRESSION_SBR (1<<3)
57
59#define GAVL_COMPRESSION_BIG_ENDIAN (1<<4)
60
66typedef enum
67 {
68
73 /* Audio */
85
86 /* Video */
100
101 /* Subtitle (some video codecs can handle subtitles also */
103
105
106#define GAVL_BITRATE_VBR -1
107#define GAVL_BITRATE_LOSSLESS -2
108
119typedef struct
120 {
121 uint32_t flags;
123
124 uint8_t * global_header;
126
127 int32_t bitrate;
129 uint32_t pre_skip;
130
132
134
135 uint32_t max_ref_frames;
136
138
147
152GAVL_PUBLIC
154
161GAVL_PUBLIC
163
172GAVL_PUBLIC
174
181GAVL_PUBLIC
183 const gavl_compression_info_t * src);
184
192GAVL_PUBLIC
193void gavl_append_xiph_header(uint8_t ** global_header,
194 int * global_header_len,
195 uint8_t * header,
196 int header_len);
197
206GAVL_PUBLIC
207uint8_t * gavl_extract_xiph_header(uint8_t * global_header,
208 int global_header_len,
209 int idx,
210 int * header_len);
211
212
228GAVL_PUBLIC
229const char * gavl_compression_get_extension(gavl_codec_id_t id, int * separate);
230
240GAVL_PUBLIC
242
249
256GAVL_PUBLIC
258
264GAVL_PUBLIC
266
272GAVL_PUBLIC const char *
274
280GAVL_PUBLIC const char *
282
288GAVL_PUBLIC gavl_codec_id_t
290
298GAVL_PUBLIC
300
309GAVL_PUBLIC
311
312
313#define GAVL_PACKET_TYPE_I 0x01
314#define GAVL_PACKET_TYPE_P 0x02
315#define GAVL_PACKET_TYPE_B 0x03
316#define GAVL_PACKET_TYPE_MASK 0x03
317
318#define GAVL_PACKET_KEYFRAME (1<<2)
319#define GAVL_PACKET_LAST (1<<3)
320#define GAVL_PACKET_EXT (1<<4)
321#define GAVL_PACKET_REF (1<<5)
322#define GAVL_PACKET_NOOUTPUT (1<<6)
323
324#define GAVL_PACKET_PADDING 32
325
339typedef struct
340 {
341 uint8_t * data;
344
345 uint32_t flags;
346
347 int64_t pts;
348 int64_t duration;
349
350 uint32_t field2_offset;
351 uint32_t header_size;
353
356
358 int32_t dst_x;
359 int32_t dst_y;
360
361 uint32_t id;
362
364
370GAVL_PUBLIC
372
373
382GAVL_PUBLIC
384
389GAVL_PUBLIC
391
397GAVL_PUBLIC
399 const gavl_packet_t * src);
400
411GAVL_PUBLIC
413 const gavl_packet_t * src);
414
415
422GAVL_PUBLIC
424
425
432GAVL_PUBLIC
434
442GAVL_PUBLIC
444 const char * filename);
445
450#ifdef __cplusplus
451}
452#endif
453
454
455#endif // GAVL_COMPRESSION_H_INCLUDED
GAVL_PUBLIC void gavl_compression_info_dump(const gavl_compression_info_t *info)
Dump a compression info to stderr.
GAVL_PUBLIC void gavl_packet_dump(const gavl_packet_t *p)
Dump a packet to stderr.
GAVL_PUBLIC int gavl_compression_need_pixelformat(gavl_codec_id_t id)
Check if the compression supports multiple pixelformats.
GAVL_PUBLIC void gavl_compression_info_dumpi(const gavl_compression_info_t *info, int num)
Dump a compression info to stderr.
GAVL_PUBLIC gavl_codec_id_t gavl_get_compression(int index)
Get a compression format for a specified index.
GAVL_PUBLIC void gavl_packet_copy_metadata(gavl_packet_t *dst, const gavl_packet_t *src)
Copy metadata of a packet.
GAVL_PUBLIC void gavl_packet_reset(gavl_packet_t *p)
Reset a packet.
GAVL_PUBLIC const char * gavl_compression_get_extension(gavl_codec_id_t id, int *separate)
Get the file extension of the corresponding raw format.
gavl_codec_id_t
Codec ID.
Definition: compression.h:67
GAVL_PUBLIC int gavl_compression_get_sample_size(gavl_codec_id_t id)
Check if an audio compression size for each samples.
GAVL_PUBLIC void gavl_packet_free(gavl_packet_t *p)
Free memory of a packet.
GAVL_PUBLIC int gavl_num_compressions()
Get the number of compression formats.
GAVL_PUBLIC void gavl_packet_alloc(gavl_packet_t *p, int len)
Allocate memory for a packet.
GAVL_PUBLIC void gavl_packet_copy(gavl_packet_t *dst, const gavl_packet_t *src)
Copy a packet.
GAVL_PUBLIC gavl_codec_id_t gavl_compression_from_short_name(const char *name)
Get a compression from the short name.
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.
GAVL_PUBLIC void gavl_compression_info_copy(gavl_compression_info_t *dst, const gavl_compression_info_t *src)
Copy a compression info.
GAVL_PUBLIC void gavl_packet_save(const gavl_packet_t *p, const char *filename)
Save a packet to a file.
void gavl_compression_info_init(gavl_compression_info_t *info)
Initialize a compression info.
GAVL_PUBLIC const char * gavl_compression_get_long_name(gavl_codec_id_t id)
Return the long name of the compression.
GAVL_PUBLIC int gavl_compression_constant_frame_samples(gavl_codec_id_t id)
Check if an audio compression constant frame samples.
GAVL_PUBLIC void gavl_packet_init(gavl_packet_t *p)
Initialize a packet.
GAVL_PUBLIC void gavl_compression_info_free(gavl_compression_info_t *info)
Free all dynamically allocated memory of a compression info.
GAVL_PUBLIC const char * gavl_compression_get_short_name(gavl_codec_id_t id)
Return the short name of the compression.
const char * gavl_compression_get_mimetype(const gavl_compression_info_t *ci)
Get the mimetype for the corresponding elementary format.
GAVL_PUBLIC void gavl_append_xiph_header(uint8_t **global_header, int *global_header_len, uint8_t *header, int header_len)
Append a Xiph packet to a global header.
@ GAVL_CODEC_ID_VORBIS
Vorbis (segmented extradata and packets)
Definition: compression.h:80
@ GAVL_CODEC_ID_SPEEX
Speex.
Definition: compression.h:83
@ GAVL_CODEC_ID_DTS
DTS.
Definition: compression.h:84
@ GAVL_CODEC_ID_MPEG1
MPEG-1 video.
Definition: compression.h:91
@ GAVL_CODEC_ID_DV
DV (several variants)
Definition: compression.h:97
@ GAVL_CODEC_ID_AC3
AC3.
Definition: compression.h:78
@ GAVL_CODEC_ID_DIRAC
Complete DIRAC frames, sequence end code appended to last packet.
Definition: compression.h:96
@ GAVL_CODEC_ID_TGA
TGA image.
Definition: compression.h:90
@ GAVL_CODEC_ID_MPEG2
MPEG-2 video.
Definition: compression.h:92
@ GAVL_CODEC_ID_AAC
AAC as stored in quicktime/mp4.
Definition: compression.h:79
@ GAVL_CODEC_ID_VP8
VP8 (as used in webm)
Definition: compression.h:98
@ GAVL_CODEC_ID_MPEG4_ASP
MPEG-4 ASP (a.k.a. Divx4)
Definition: compression.h:93
@ GAVL_CODEC_ID_JPEG
JPEG image.
Definition: compression.h:87
@ GAVL_CODEC_ID_H264
H.264 (Annex B)
Definition: compression.h:94
@ GAVL_CODEC_ID_MP2
MPEG-1 audio layer II.
Definition: compression.h:76
@ GAVL_CODEC_ID_TIFF
TIFF image.
Definition: compression.h:89
@ GAVL_CODEC_ID_FLAC
Flac (extradata contain a file header without comment and seektable)
Definition: compression.h:81
@ GAVL_CODEC_ID_THEORA
Theora (segmented extradata)
Definition: compression.h:95
@ GAVL_CODEC_ID_DIV3
Old style Divx (aka MSMPEG4V3)
Definition: compression.h:99
@ GAVL_CODEC_ID_MP3
MPEG-1/2 audio layer 3 CBR/VBR.
Definition: compression.h:77
@ GAVL_CODEC_ID_DVDSUB
DVD subtitles, palette is in header.
Definition: compression.h:102
@ GAVL_CODEC_ID_PNG
PNG image.
Definition: compression.h:88
@ GAVL_CODEC_ID_ALAW
alaw 2:1
Definition: compression.h:74
@ GAVL_CODEC_ID_NONE
Unknown/unsupported compression format. In gavf files this signals that the stream consists of uncomp...
Definition: compression.h:72
@ GAVL_CODEC_ID_OPUS
Opus.
Definition: compression.h:82
@ GAVL_CODEC_ID_ULAW
mu-law 2:1
Definition: compression.h:75
uint64_t gavl_timecode_t
Typedef for timecodes.
Definition: timecode.h:43
gavl_interlace_mode_t
Interlace mode.
Definition: gavl.h:2176
Compression format.
Definition: compression.h:120
uint32_t max_ref_frames
Maximum reference frames (if > 2)
Definition: compression.h:135
int32_t bitrate
Needed by some codecs, negative values mean VBR.
Definition: compression.h:127
uint32_t global_header_len
Length of global header.
Definition: compression.h:125
gavl_codec_id_t id
Codec ID.
Definition: compression.h:122
uint32_t flags
ORed combination of GAVL_COMPRESSION_* flags.
Definition: compression.h:121
uint8_t * global_header
Global header.
Definition: compression.h:124
uint32_t max_packet_size
Maximum packet size or 0 if unknown.
Definition: compression.h:133
uint32_t video_buffer_size
VBV buffer size for video (in BYTES)
Definition: compression.h:131
int palette_size
Size of the embedded palette for image codecs.
Definition: compression.h:128
uint32_t pre_skip
Samples to skip at the start.
Definition: compression.h:129
Packet structure.
Definition: compression.h:340
int data_len
Length of data.
Definition: compression.h:342
uint32_t id
ID of the gavf stream where this packet belongs.
Definition: compression.h:361
gavl_rectangle_i_t src_rect
Rectangle to take from a video frame.
Definition: compression.h:357
gavl_timecode_t timecode
Timecode.
Definition: compression.h:355
uint8_t * data
Data.
Definition: compression.h:341
int64_t pts
Presentation time.
Definition: compression.h:347
uint32_t field2_offset
Offset of field 2 for field pictures.
Definition: compression.h:350
gavl_interlace_mode_t interlace_mode
Interlace mode for mixed interlacing.
Definition: compression.h:354
uint32_t sequence_end_pos
Position of sequence end code if any.
Definition: compression.h:352
uint32_t header_size
Size of a repeated global header (or 0)
Definition: compression.h:351
int32_t dst_y
Y-coordinate in the destination frame (for overlays)
Definition: compression.h:359
int64_t duration
Duration of the contained frame.
Definition: compression.h:348
int32_t dst_x
X-coordinate in the destination frame (for overlays)
Definition: compression.h:358
uint32_t flags
ORed combination of GAVL_PACKET_* flags.
Definition: compression.h:345
int data_alloc
How many bytes got allocated.
Definition: compression.h:343
Integer rectangle.
Definition: gavl.h:1366