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 
73  /* Audio */
85 
86  /* Video */
87  GAVL_CODEC_ID_JPEG = 0x10000,
100 
101  /* Subtitle (some video codecs can handle subtitles also */
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;
123 
124  uint8_t * global_header;
125  uint32_t global_header_len;
126 
127  int32_t bitrate;
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;
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 
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
Complete DIRAC frames, sequence end code appended to last packet.
Definition: compression.h:96
const char * gavl_compression_get_mimetype(const gavl_compression_info_t *ci)
Get the mimetype for the corresponding elementary format.
GAVL_PUBLIC gavl_codec_id_t gavl_get_compression(int index)
Get a compression format for a specified index.
DTS.
Definition: compression.h:84
MPEG-1 video.
Definition: compression.h:91
uint32_t max_ref_frames
Maximum reference frames (if &gt; 2)
Definition: compression.h:135
GAVL_PUBLIC void gavl_compression_info_dump(const gavl_compression_info_t *info)
Dump a compression info to stderr.
AAC as stored in quicktime/mp4.
Definition: compression.h:79
MPEG-1 audio layer II.
Definition: compression.h:76
Old style Divx (aka MSMPEG4V3)
Definition: compression.h:99
GAVL_PUBLIC const char * gavl_compression_get_long_name(gavl_codec_id_t id)
Return the long name of the compression.
GAVL_PUBLIC void gavl_packet_free(gavl_packet_t *p)
Free memory of a packet.
gavl_interlace_mode_t
Interlace mode.
Definition: gavl.h:2175
int64_t pts
Presentation time.
Definition: compression.h:347
uint32_t max_packet_size
Maximum packet size or 0 if unknown.
Definition: compression.h:133
void gavl_compression_info_init(gavl_compression_info_t *info)
Initialize a compression info.
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.
int32_t dst_y
Y-coordinate in the destination frame (for overlays)
Definition: compression.h:359
GAVL_PUBLIC const char * gavl_compression_get_short_name(gavl_codec_id_t id)
Return the short name of the compression.
GAVL_PUBLIC void gavl_compression_info_dumpi(const gavl_compression_info_t *info, int num)
Dump a compression info to stderr.
int32_t dst_x
X-coordinate in the destination frame (for overlays)
Definition: compression.h:358
uint64_t gavl_timecode_t
Typedef for timecodes.
Definition: timecode.h:43
MPEG-4 ASP (a.k.a. Divx4)
Definition: compression.h:93
int64_t duration
Duration of the contained frame.
Definition: compression.h:348
GAVL_PUBLIC void gavl_compression_info_free(gavl_compression_info_t *info)
Free all dynamically allocated memory of a compression info.
Compression format.
Definition: compression.h:119
GAVL_PUBLIC void gavl_compression_info_copy(gavl_compression_info_t *dst, const gavl_compression_info_t *src)
Copy a compression info.
int data_alloc
How many bytes got allocated.
Definition: compression.h:343
Integer rectangle.
Definition: gavl.h:1365
GAVL_PUBLIC void gavl_packet_save(const gavl_packet_t *p, const char *filename)
Save a packet to a file.
gavl_timecode_t timecode
Timecode.
Definition: compression.h:355
H.264 (Annex B)
Definition: compression.h:94
GAVL_PUBLIC void gavl_packet_dump(const gavl_packet_t *p)
Dump a packet to stderr.
GAVL_PUBLIC void gavl_packet_reset(gavl_packet_t *p)
Reset a packet.
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.
Flac (extradata contain a file header without comment and seektable)
Definition: compression.h:81
Vorbis (segmented extradata and packets)
Definition: compression.h:80
uint32_t header_size
Size of a repeated global header (or 0)
Definition: compression.h:351
uint32_t video_buffer_size
VBV buffer size for video (in BYTES)
Definition: compression.h:131
TIFF image.
Definition: compression.h:89
alaw 2:1
Definition: compression.h:74
JPEG image.
Definition: compression.h:87
uint32_t flags
ORed combination of GAVL_COMPRESSION_* flags.
Definition: compression.h:121
int palette_size
Size of the embedded palette for image codecs.
Definition: compression.h:128
uint32_t field2_offset
Offset of field 2 for field pictures.
Definition: compression.h:350
gavl_rectangle_i_t src_rect
Rectangle to take from a video frame.
Definition: compression.h:357
uint8_t * data
Data.
Definition: compression.h:341
GAVL_PUBLIC int gavl_compression_get_sample_size(gavl_codec_id_t id)
Check if an audio compression size for each samples.
GAVL_PUBLIC const char * gavl_compression_get_extension(gavl_codec_id_t id, int *separate)
Get the file extension of the corresponding raw format.
Unknown/unsupported compression format. In gavf files this signals that the stream consists of uncomp...
Definition: compression.h:72
gavl_codec_id_t id
Codec ID.
Definition: compression.h:122
uint8_t * global_header
Global header.
Definition: compression.h:124
uint32_t flags
ORed combination of GAVL_PACKET_* flags.
Definition: compression.h:345
MPEG-1/2 audio layer 3 CBR/VBR.
Definition: compression.h:77
MPEG-2 video.
Definition: compression.h:92
VP8 (as used in webm)
Definition: compression.h:98
TGA image.
Definition: compression.h:90
GAVL_PUBLIC void gavl_packet_copy(gavl_packet_t *dst, const gavl_packet_t *src)
Copy a packet.
gavl_codec_id_t
Codec ID.
Definition: compression.h:66
int32_t bitrate
Needed by some codecs, negative values mean VBR.
Definition: compression.h:127
DV (several variants)
Definition: compression.h:97
uint32_t sequence_end_pos
Position of sequence end code if any.
Definition: compression.h:352
int data_len
Length of data.
Definition: compression.h:342
Speex.
Definition: compression.h:83
DVD subtitles, palette is in header.
Definition: compression.h:102
Theora (segmented extradata)
Definition: compression.h:95
GAVL_PUBLIC int gavl_compression_constant_frame_samples(gavl_codec_id_t id)
Check if an audio compression constant frame samples.
PNG image.
Definition: compression.h:88
GAVL_PUBLIC int gavl_compression_need_pixelformat(gavl_codec_id_t id)
Check if the compression supports multiple pixelformats.
mu-law 2:1
Definition: compression.h:75
uint32_t pre_skip
Samples to skip at the start.
Definition: compression.h:129
GAVL_PUBLIC void gavl_packet_alloc(gavl_packet_t *p, int len)
Allocate memory for a packet.
Packet structure.
Definition: compression.h:339
AC3.
Definition: compression.h:78
GAVL_PUBLIC gavl_codec_id_t gavl_compression_from_short_name(const char *name)
Get a compression from the short name.
uint32_t global_header_len
Length of global header.
Definition: compression.h:125
uint32_t id
ID of the gavf stream where this packet belongs.
Definition: compression.h:361
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_init(gavl_packet_t *p)
Initialize a packet.
gavl_interlace_mode_t interlace_mode
Interlace mode for mixed interlacing.
Definition: compression.h:354
GAVL_PUBLIC int gavl_num_compressions()
Get the number of compression formats.
Opus.
Definition: compression.h:82