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
28 extern "C" {
29 #endif
30 
47 #define GAVL_COMPRESSION_HAS_P_FRAMES (1<<0)
48 
50 #define GAVL_COMPRESSION_HAS_B_FRAMES (1<<1)
51 
52 
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 
66 typedef enum
67  {
68 
72  GAVL_CODEC_ID_NONE = 0,
73  /* Audio */
85 
86  /* Video */
87  GAVL_CODEC_ID_JPEG = 0x10000,
100 
101  /* Subtitle (some video codecs can handle subtitles also */
102  GAVL_CODEC_ID_DVDSUB = 0x20000,
103 
104  } gavl_codec_id_t;
105 
106 #define GAVL_BITRATE_VBR -1
107 #define GAVL_BITRATE_LOSSLESS -2
108 
109 
119 typedef struct
120  {
121  uint32_t flags;
122  gavl_codec_id_t id;
123 
124  uint8_t * global_header;
125  uint32_t global_header_len;
126 
127  int32_t bitrate;
128  int palette_size;
129  uint32_t pre_skip;
130 
131  uint32_t video_buffer_size;
132 
133  uint32_t max_packet_size;
134 
135  uint32_t max_ref_frames;
136 
138 
147 
152 GAVL_PUBLIC
154 
161 GAVL_PUBLIC
163 
172 GAVL_PUBLIC
173 void gavl_compression_info_dumpi(const gavl_compression_info_t * info, int num);
174 
181 GAVL_PUBLIC
183  const gavl_compression_info_t * src);
184 
192 GAVL_PUBLIC
193 void gavl_append_xiph_header(uint8_t ** global_header,
194  int * global_header_len,
195  uint8_t * header,
196  int header_len);
197 
206 GAVL_PUBLIC
207 uint8_t * gavl_extract_xiph_header(uint8_t * global_header,
208  int global_header_len,
209  int idx,
210  int * header_len);
211 
212 
228 GAVL_PUBLIC
229 const char * gavl_compression_get_extension(gavl_codec_id_t id, int * separate);
230 
240 GAVL_PUBLIC
242 
249 
256 GAVL_PUBLIC
258 
264 GAVL_PUBLIC
266 
272 GAVL_PUBLIC const char *
274 
280 GAVL_PUBLIC const char *
282 
288 GAVL_PUBLIC gavl_codec_id_t
289 gavl_compression_from_short_name(const char * name);
290 
298 GAVL_PUBLIC
300 
309 GAVL_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 
326 
339 typedef struct
340  {
341  uint8_t * data;
342  int data_len;
343  int data_alloc;
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;
352  uint32_t sequence_end_pos;
353 
354  gavl_interlace_mode_t interlace_mode;
355  gavl_timecode_t timecode;
356 
358  int32_t dst_x;
359  int32_t dst_y;
360 
361  uint32_t id;
362 
363  } gavl_packet_t;
364 
370 GAVL_PUBLIC
372 
373 
382 GAVL_PUBLIC
383 void gavl_packet_alloc(gavl_packet_t * p, int len);
384 
389 GAVL_PUBLIC
391 
397 GAVL_PUBLIC
399  const gavl_packet_t * src);
400 
411 GAVL_PUBLIC
413  const gavl_packet_t * src);
414 
415 
422 GAVL_PUBLIC
424 
425 
432 GAVL_PUBLIC
433 void gavl_packet_dump(const gavl_packet_t * p);
434 
442 GAVL_PUBLIC
443 void gavl_packet_save(const gavl_packet_t * p,
444  const char * filename);
445 
450 #ifdef __cplusplus
451 }
452 #endif
453 
454 
455 #endif // GAVL_COMPRESSION_H_INCLUDED
gavl_compression_info_copy
GAVL_PUBLIC void gavl_compression_info_copy(gavl_compression_info_t *dst, const gavl_compression_info_t *src)
Copy a compression info.
GAVL_CODEC_ID_H264
H.264 (Annex B)
Definition: compression.h:93
GAVL_CODEC_ID_AAC
AAC as stored in quicktime/mp4.
Definition: compression.h:78
GAVL_CODEC_ID_THEORA
Theora (segmented extradata)
Definition: compression.h:94
gavl_packet_reset
GAVL_PUBLIC void gavl_packet_reset(gavl_packet_t *p)
Reset a packet.
gavl_compression_get_sample_size
GAVL_PUBLIC int gavl_compression_get_sample_size(gavl_codec_id_t id)
Check if an audio compression size for each samples.
GAVL_CODEC_ID_OPUS
Opus.
Definition: compression.h:81
gavl_interlace_mode_t
gavl_interlace_mode_t
Interlace mode.
Definition: gavl.h:2174
gavl_compression_info_init
void gavl_compression_info_init(gavl_compression_info_t *info)
Initialize a compression info.
gavl_rectangle_i_t
Integer rectangle.
Definition: gavl.h:1364
gavl_append_xiph_header
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_FLAC
Flac (extradata contain a file header without comment and seektable)
Definition: compression.h:80
GAVL_CODEC_ID_VP8
VP8 (as used in webm)
Definition: compression.h:97
gavl_compression_get_long_name
const GAVL_PUBLIC char * gavl_compression_get_long_name(gavl_codec_id_t id)
Return the long name of the compression.
GAVL_CODEC_ID_TGA
TGA image.
Definition: compression.h:89
gavl_compression_need_pixelformat
GAVL_PUBLIC int gavl_compression_need_pixelformat(gavl_codec_id_t id)
Check if the compression supports multiple pixelformats.
GAVL_CODEC_ID_NONE
Unknown/unsupported compression format. In gavf files this signals that the stream consists of uncomp...
Definition: compression.h:71
GAVL_CODEC_ID_DVDSUB
DVD subtitles, palette is in header.
Definition: compression.h:101
gavl_compression_get_short_name
const GAVL_PUBLIC char * gavl_compression_get_short_name(gavl_codec_id_t id)
Return the short name of the compression.
gavl_codec_id_t
gavl_codec_id_t
Codec ID.
Definition: compression.h:65
gavl_compression_get_extension
const GAVL_PUBLIC char * gavl_compression_get_extension(gavl_codec_id_t id, int *separate)
Get the file extension of the corresponding raw format.
gavl_timecode_t
uint64_t gavl_timecode_t
Typedef for timecodes.
Definition: timecode.h:42
GAVL_CODEC_ID_DIV3
Old style Divx (aka MSMPEG4V3)
Definition: compression.h:98
GAVL_CODEC_ID_MPEG2
MPEG-2 video.
Definition: compression.h:91
GAVL_CODEC_ID_VORBIS
Vorbis (segmented extradata and packets)
Definition: compression.h:79
GAVL_CODEC_ID_JPEG
JPEG image.
Definition: compression.h:86
gavl_compression_get_mimetype
const char * gavl_compression_get_mimetype(const gavl_compression_info_t *ci)
Get the mimetype for the corresponding elementary format.
gavl_compression_info_dumpi
GAVL_PUBLIC void gavl_compression_info_dumpi(const gavl_compression_info_t *info, int num)
Dump a compression info to stderr.
gavl_num_compressions
GAVL_PUBLIC int gavl_num_compressions()
Get the number of compression formats.
gavl_compression_info_t
Compression format.
Definition: compression.h:118
GAVL_CODEC_ID_MP2
MPEG-1 audio layer II.
Definition: compression.h:75
gavl_packet_dump
GAVL_PUBLIC void gavl_packet_dump(const gavl_packet_t *p)
Dump a packet to stderr.
GAVL_CODEC_ID_MPEG4_ASP
MPEG-4 ASP (a.k.a. Divx4)
Definition: compression.h:92
GAVL_CODEC_ID_DTS
DTS.
Definition: compression.h:83
gavl_compression_info_free
GAVL_PUBLIC void gavl_compression_info_free(gavl_compression_info_t *info)
Free all dynamically allocated memory of a compression info.
GAVL_CODEC_ID_ULAW
mu-law 2:1
Definition: compression.h:74
gavl_packet_free
GAVL_PUBLIC void gavl_packet_free(gavl_packet_t *p)
Free memory of a packet.
gavl_packet_copy_metadata
GAVL_PUBLIC void gavl_packet_copy_metadata(gavl_packet_t *dst, const gavl_packet_t *src)
Copy metadata of a packet.
GAVL_CODEC_ID_ALAW
alaw 2:1
Definition: compression.h:73
GAVL_CODEC_ID_MPEG1
MPEG-1 video.
Definition: compression.h:90
gavl_packet_init
GAVL_PUBLIC void gavl_packet_init(gavl_packet_t *p)
Initialize a packet.
gavl_compression_from_short_name
GAVL_PUBLIC gavl_codec_id_t gavl_compression_from_short_name(const char *name)
Get a compression from the short name.
GAVL_CODEC_ID_AC3
AC3.
Definition: compression.h:77
GAVL_CODEC_ID_MP3
MPEG-1/2 audio layer 3 CBR/VBR.
Definition: compression.h:76
gavl_packet_copy
GAVL_PUBLIC void gavl_packet_copy(gavl_packet_t *dst, const gavl_packet_t *src)
Copy a packet.
gavl_packet_alloc
GAVL_PUBLIC void gavl_packet_alloc(gavl_packet_t *p, int len)
Allocate memory for a packet.
gavl_compression_info_dump
GAVL_PUBLIC void gavl_compression_info_dump(const gavl_compression_info_t *info)
Dump a compression info to stderr.
GAVL_CODEC_ID_DIRAC
Complete DIRAC frames, sequence end code appended to last packet.
Definition: compression.h:95
gavl_compression_constant_frame_samples
GAVL_PUBLIC int gavl_compression_constant_frame_samples(gavl_codec_id_t id)
Check if an audio compression constant frame samples.
GAVL_CODEC_ID_DV
DV (several variants)
Definition: compression.h:96
GAVL_CODEC_ID_PNG
PNG image.
Definition: compression.h:87
gavl_get_compression
GAVL_PUBLIC gavl_codec_id_t gavl_get_compression(int index)
Get a compression format for a specified index.
GAVL_CODEC_ID_SPEEX
Speex.
Definition: compression.h:82
GAVL_CODEC_ID_TIFF
TIFF image.
Definition: compression.h:88
gavl_packet_t
Packet structure.
Definition: compression.h:338
gavl_extract_xiph_header
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_packet_save
GAVL_PUBLIC void gavl_packet_save(const gavl_packet_t *p, const char *filename)
Save a packet to a file.