FFmpeg 7.1.1
Loading...
Searching...
No Matches
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 <stddef.h>
35#include <stdint.h>
36
37#include "libavutil/pixfmt.h"
38#include "libavutil/rational.h"
39
40/**
41 * The spec limits the number of wavelet decompositions to 4 for both
42 * level 1 (VC-2) and 128 (long-gop default).
43 * 5 decompositions is the maximum before >16-bit buffers are needed.
44 * Schroedinger allows this for DD 9,7 and 13,7 wavelets only, limiting
45 * the others to 4 decompositions (or 3 for the fidelity filter).
46 *
47 * We use this instead of MAX_DECOMPOSITIONS to save some memory.
48 */
49#define MAX_DWT_LEVELS 5
50
51/**
52 * Parse code values:
53 *
54 * Dirac Specification ->
55 * 9.6.1 Table 9.1
56 *
57 * VC-2 Specification ->
58 * 10.4.1 Table 10.1
59 */
60
79
80typedef struct DiracVersionInfo {
81 int major;
82 int minor;
84
85typedef struct AVDiracSeqHeader {
86 unsigned width;
87 unsigned height;
88 uint8_t chroma_format; ///< 0: 444 1: 422 2: 420
89
90 uint8_t interlaced;
92
93 uint8_t frame_rate_index; ///< index into dirac_frame_rate[]
94 uint8_t aspect_ratio_index; ///< index into dirac_aspect_ratio[]
95
96 uint16_t clean_width;
97 uint16_t clean_height;
100
101 uint8_t pixel_range_index; ///< index into dirac_pixel_range_presets[]
102 uint8_t color_spec_index; ///< index into dirac_color_spec_presets[]
103
105 int level;
106
109
115
119
120/**
121 * Parse a Dirac sequence header.
122 *
123 * @param dsh this function will allocate and fill an AVDiracSeqHeader struct
124 * and write it into this pointer. The caller must free it with
125 * av_free().
126 * @param buf the data buffer
127 * @param buf_size the size of the data buffer in bytes
128 * @param log_ctx if non-NULL, this function will log errors here
129 * @return 0 on success, a negative AVERROR code on failure
130 */
132 const uint8_t *buf, size_t buf_size,
133 void *log_ctx);
134
135#endif /* AVCODEC_DIRAC_H */
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:61
@ DIRAC_PCODE_PICTURE_CODED
Definition dirac.h:66
@ DIRAC_PCODE_AUX
Definition dirac.h:64
@ DIRAC_PCODE_INTER_NOREF_CO2
Definition dirac.h:71
@ DIRAC_PCODE_INTER_REF_CO1
Definition dirac.h:72
@ DIRAC_PCODE_INTRA_REF_PICT
Definition dirac.h:76
@ DIRAC_PCODE_INTER_NOREF_CO1
Definition dirac.h:70
@ DIRAC_PCODE_PICTURE_LOW_DEL
Definition dirac.h:68
@ DIRAC_PCODE_END_SEQ
Definition dirac.h:63
@ DIRAC_PCODE_MAGIC
Definition dirac.h:77
@ DIRAC_PCODE_PICTURE_RAW
Definition dirac.h:67
@ DIRAC_PCODE_INTER_REF_CO2
Definition dirac.h:73
@ DIRAC_PCODE_INTRA_REF_CO
Definition dirac.h:74
@ DIRAC_PCODE_SEQ_HEADER
Definition dirac.h:62
@ DIRAC_PCODE_INTRA_REF_RAW
Definition dirac.h:75
@ DIRAC_PCODE_PAD
Definition dirac.h:65
@ DIRAC_PCODE_PICTURE_HQ
Definition dirac.h:69
pixel format definitions
AVColorRange
Visual content value range.
Definition pixfmt.h:651
AVPixelFormat
Pixel format.
Definition pixfmt.h:71
AVColorPrimaries
Chromaticity coordinates of the source primaries.
Definition pixfmt.h:555
AVColorTransferCharacteristic
Color Transfer Characteristic.
Definition pixfmt.h:580
AVColorSpace
YUV colorspace type.
Definition pixfmt.h:609
Utilties for rational number calculation.
DiracVersionInfo version
Definition dirac.h:116
uint16_t clean_right_offset
Definition dirac.h:99
uint8_t top_field_first
Definition dirac.h:91
uint8_t chroma_format
0: 444 1: 422 2: 420
Definition dirac.h:88
enum AVColorPrimaries color_primaries
Definition dirac.h:112
uint8_t pixel_range_index
index into dirac_pixel_range_presets[]
Definition dirac.h:101
unsigned height
Definition dirac.h:87
enum AVColorRange color_range
Definition dirac.h:111
AVRational sample_aspect_ratio
Definition dirac.h:108
uint8_t color_spec_index
index into dirac_color_spec_presets[]
Definition dirac.h:102
unsigned width
Definition dirac.h:86
enum AVColorSpace colorspace
Definition dirac.h:114
uint16_t clean_height
Definition dirac.h:97
enum AVColorTransferCharacteristic color_trc
Definition dirac.h:113
enum AVPixelFormat pix_fmt
Definition dirac.h:110
uint8_t frame_rate_index
index into dirac_frame_rate[]
Definition dirac.h:93
uint8_t aspect_ratio_index
index into dirac_aspect_ratio[]
Definition dirac.h:94
uint8_t interlaced
Definition dirac.h:90
uint16_t clean_left_offset
Definition dirac.h:98
uint16_t clean_width
Definition dirac.h:96
AVRational framerate
Definition dirac.h:107
Rational number (pair of numerator and denominator).
Definition rational.h:58