2 * FLAC (Free Lossless Audio Codec) decoder/demuxer common functions
3 * Copyright (c) 2008 Justin Ruggles
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 * @file libavcodec/flac.h
24 * FLAC (Free Lossless Audio Codec) decoder/demuxer common functions
27 #ifndef AVCODEC_FLAC_H
28 #define AVCODEC_FLAC_H
32 #define FLAC_STREAMINFO_SIZE 34
35 FLAC_METADATA_TYPE_STREAMINFO = 0,
36 FLAC_METADATA_TYPE_PADDING,
37 FLAC_METADATA_TYPE_APPLICATION,
38 FLAC_METADATA_TYPE_SEEKTABLE,
39 FLAC_METADATA_TYPE_VORBIS_COMMENT,
40 FLAC_METADATA_TYPE_CUESHEET,
41 FLAC_METADATA_TYPE_PICTURE,
42 FLAC_METADATA_TYPE_INVALID = 127
45 enum FLACExtradataFormat {
46 FLAC_EXTRADATA_FORMAT_STREAMINFO = 0,
47 FLAC_EXTRADATA_FORMAT_FULL_HEADER = 1
51 * Data needed from the Streaminfo header for use by the raw FLAC demuxer
52 * and/or the FLAC decoder.
54 #define FLACSTREAMINFO \
55 int max_blocksize; /**< maximum block size, in samples */\
56 int max_framesize; /**< maximum frame size, in bytes */\
57 int samplerate; /**< sample rate */\
58 int channels; /**< number of channels */\
59 int bps; /**< bits-per-sample */\
60 int64_t samples; /**< total number of samples */\
62 typedef struct FLACStreaminfo {
67 * Parse the Streaminfo metadata block
68 * @param[out] avctx codec context to set basic stream parameters
69 * @param[out] s where parsed information is stored
70 * @param[in] buffer pointer to start of 34-byte streaminfo data
72 void ff_flac_parse_streaminfo(AVCodecContext *avctx, struct FLACStreaminfo *s,
73 const uint8_t *buffer);
76 * Validate the FLAC extradata.
77 * @param[in] avctx codec context containing the extradata.
78 * @param[out] format extradata format.
79 * @param[out] streaminfo_start pointer to start of 34-byte STREAMINFO data.
80 * @return 1 if valid, 0 if not valid.
82 int ff_flac_is_extradata_valid(AVCodecContext *avctx,
83 enum FLACExtradataFormat *format,
84 uint8_t **streaminfo_start);
87 * Parse the metadata block parameters from the header.
88 * @param[in] block_header header data, at least 4 bytes
89 * @param[out] last indicator for last metadata block
90 * @param[out] type metadata block type
91 * @param[out] size metadata block size
93 void ff_flac_parse_block_header(const uint8_t *block_header,
94 int *last, int *type, int *size);
96 #endif /* AVCODEC_FLAC_H */