2 * Copyright (C) 2007 Marco Gerards <marco@gnu.org>
3 * Copyright (C) 2009 David Conrad
4 * Copyright (C) 2011 Jordi Ortiz
6 * This file is part of FFmpeg.
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.
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.
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
23 #ifndef AVCODEC_DIRAC_H
24 #define AVCODEC_DIRAC_H
28 * Interface to Dirac Decoder/Encoder
29 * @author Marco Gerards <marco@gnu.org>
30 * @author David Conrad
39 * Dirac Specification ->
42 * VC-2 Specification ->
46 enum DiracParseCodes {
47 DIRAC_PCODE_SEQ_HEADER = 0x00,
48 DIRAC_PCODE_END_SEQ = 0x10,
49 DIRAC_PCODE_AUX = 0x20,
50 DIRAC_PCODE_PAD = 0x30,
51 DIRAC_PCODE_PICTURE_CODED = 0x08,
52 DIRAC_PCODE_PICTURE_RAW = 0x48,
53 DIRAC_PCODE_PICTURE_LOW_DEL = 0xC8,
54 DIRAC_PCODE_PICTURE_HQ = 0xE8,
55 DIRAC_PCODE_MAGIC = 0x42424344,
58 typedef struct DiracVersionInfo {
63 typedef struct AVDiracSeqHeader {
66 uint8_t chroma_format; ///< 0: 444 1: 422 2: 420
69 uint8_t top_field_first;
71 uint8_t frame_rate_index; ///< index into dirac_frame_rate[]
72 uint8_t aspect_ratio_index; ///< index into dirac_aspect_ratio[]
75 uint16_t clean_height;
76 uint16_t clean_left_offset;
77 uint16_t clean_right_offset;
79 uint8_t pixel_range_index; ///< index into dirac_pixel_range_presets[]
80 uint8_t color_spec_index; ///< index into dirac_color_spec_presets[]
86 AVRational sample_aspect_ratio;
88 enum AVPixelFormat pix_fmt;
89 enum AVColorRange color_range;
90 enum AVColorPrimaries color_primaries;
91 enum AVColorTransferCharacteristic color_trc;
92 enum AVColorSpace colorspace;
94 DiracVersionInfo version;
99 * Parse a Dirac sequence header.
101 * @param dsh this function will allocate and fill an AVDiracSeqHeader struct
102 * and write it into this pointer. The caller must free it with
104 * @param buf the data buffer
105 * @param buf_size the size of the data buffer in bytes
106 * @param log_ctx if non-NULL, this function will log errors here
107 * @return 0 on success, a negative AVERROR code on failure
109 int av_dirac_parse_sequence_header(AVDiracSeqHeader **dsh,
110 const uint8_t *buf, size_t buf_size,
113 #endif /* AVCODEC_DIRAC_H */