FFmpeg 5.1.6
dirac.h
Go to the documentation of this file.
1/*
2 * Copyright (C) 2007 Marco Gerards <marco@gnu.org>
3 * Copyright (C) 2009 David Conrad
4 * Copyright (C) 2011 Jordi Ortiz
5 *
6 * This file is part of FFmpeg.
7 *
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
12 *
13 * FFmpeg 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 GNU
16 * Lesser General Public License for more details.
17 *
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 */
22
23#ifndef AVCODEC_DIRAC_H
24#define AVCODEC_DIRAC_H
25
26/**
27 * @file
28 * Interface to Dirac Decoder/Encoder
29 * @author Marco Gerards <marco@gnu.org>
30 * @author David Conrad
31 * @author Jordi Ortiz
32 */
33
34#include "avcodec.h"
35
36/**
37 * The spec limits the number of wavelet decompositions to 4 for both
38 * level 1 (VC-2) and 128 (long-gop default).
39 * 5 decompositions is the maximum before >16-bit buffers are needed.
40 * Schroedinger allows this for DD 9,7 and 13,7 wavelets only, limiting
41 * the others to 4 decompositions (or 3 for the fidelity filter).
42 *
43 * We use this instead of MAX_DECOMPOSITIONS to save some memory.
44 */
45#define MAX_DWT_LEVELS 5
46
47/**
48 * Parse code values:
49 *
50 * Dirac Specification ->
51 * 9.6.1 Table 9.1
52 *
53 * VC-2 Specification ->
54 * 10.4.1 Table 10.1
55 */
56
73 DIRAC_PCODE_MAGIC = 0x42424344,
74};
75
76typedef struct DiracVersionInfo {
77 int major;
78 int minor;
80
81typedef struct AVDiracSeqHeader {
82 unsigned width;
83 unsigned height;
84 uint8_t chroma_format; ///< 0: 444 1: 422 2: 420
85
86 uint8_t interlaced;
88
89 uint8_t frame_rate_index; ///< index into dirac_frame_rate[]
90 uint8_t aspect_ratio_index; ///< index into dirac_aspect_ratio[]
91
92 uint16_t clean_width;
93 uint16_t clean_height;
96
97 uint8_t pixel_range_index; ///< index into dirac_pixel_range_presets[]
98 uint8_t color_spec_index; ///< index into dirac_color_spec_presets[]
99
101 int level;
102
105
111
115
116/**
117 * Parse a Dirac sequence header.
118 *
119 * @param dsh this function will allocate and fill an AVDiracSeqHeader struct
120 * and write it into this pointer. The caller must free it with
121 * av_free().
122 * @param buf the data buffer
123 * @param buf_size the size of the data buffer in bytes
124 * @param log_ctx if non-NULL, this function will log errors here
125 * @return 0 on success, a negative AVERROR code on failure
126 */
128 const uint8_t *buf, size_t buf_size,
129 void *log_ctx);
130
131#endif /* AVCODEC_DIRAC_H */
Libavcodec external API header.
int av_dirac_parse_sequence_header(AVDiracSeqHeader **dsh, const uint8_t *buf, size_t buf_size, void *log_ctx)
Parse a Dirac sequence header.
DiracParseCodes
Parse code values:
Definition: dirac.h:57
@ DIRAC_PCODE_PICTURE_CODED
Definition: dirac.h:62
@ DIRAC_PCODE_AUX
Definition: dirac.h:60
@ DIRAC_PCODE_INTER_NOREF_CO2
Definition: dirac.h:67
@ DIRAC_PCODE_INTER_REF_CO1
Definition: dirac.h:68
@ DIRAC_PCODE_INTRA_REF_PICT
Definition: dirac.h:72
@ DIRAC_PCODE_INTER_NOREF_CO1
Definition: dirac.h:66
@ DIRAC_PCODE_PICTURE_LOW_DEL
Definition: dirac.h:64
@ DIRAC_PCODE_END_SEQ
Definition: dirac.h:59
@ DIRAC_PCODE_MAGIC
Definition: dirac.h:73
@ DIRAC_PCODE_PICTURE_RAW
Definition: dirac.h:63
@ DIRAC_PCODE_INTER_REF_CO2
Definition: dirac.h:69
@ DIRAC_PCODE_INTRA_REF_CO
Definition: dirac.h:70
@ DIRAC_PCODE_SEQ_HEADER
Definition: dirac.h:58
@ DIRAC_PCODE_INTRA_REF_RAW
Definition: dirac.h:71
@ DIRAC_PCODE_PAD
Definition: dirac.h:61
@ DIRAC_PCODE_PICTURE_HQ
Definition: dirac.h:65
AVColorRange
Visual content value range.
Definition: pixfmt.h:564
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
AVColorPrimaries
Chromaticity coordinates of the source primaries.
Definition: pixfmt.h:471
AVColorTransferCharacteristic
Color Transfer Characteristic.
Definition: pixfmt.h:496
AVColorSpace
YUV colorspace type.
Definition: pixfmt.h:525
DiracVersionInfo version
Definition: dirac.h:112
uint16_t clean_right_offset
Definition: dirac.h:95
uint8_t top_field_first
Definition: dirac.h:87
uint8_t chroma_format
0: 444 1: 422 2: 420
Definition: dirac.h:84
enum AVColorPrimaries color_primaries
Definition: dirac.h:108
uint8_t pixel_range_index
index into dirac_pixel_range_presets[]
Definition: dirac.h:97
unsigned height
Definition: dirac.h:83
enum AVColorRange color_range
Definition: dirac.h:107
AVRational sample_aspect_ratio
Definition: dirac.h:104
uint8_t color_spec_index
index into dirac_color_spec_presets[]
Definition: dirac.h:98
unsigned width
Definition: dirac.h:82
enum AVColorSpace colorspace
Definition: dirac.h:110
uint16_t clean_height
Definition: dirac.h:93
enum AVColorTransferCharacteristic color_trc
Definition: dirac.h:109
enum AVPixelFormat pix_fmt
Definition: dirac.h:106
uint8_t frame_rate_index
index into dirac_frame_rate[]
Definition: dirac.h:89
uint8_t aspect_ratio_index
index into dirac_aspect_ratio[]
Definition: dirac.h:90
uint8_t interlaced
Definition: dirac.h:86
uint16_t clean_left_offset
Definition: dirac.h:94
uint16_t clean_width
Definition: dirac.h:92
AVRational framerate
Definition: dirac.h:103
Rational number (pair of numerator and denominator).
Definition: rational.h:58