1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
4 <TITLE>FLAC - format</TITLE>
7 <BODY MARGINWIDTH="0" MARGINHEIGHT="0" LEFTMARGIN="0" RIGHTMARGIN="0" TOPMARGIN="0" BGCOLOR="#99CC99" TEXT="#000000" LINK="#336699" VLINK="#336699" ALINK="#336699">
9 <TABLE BORDER=0 WIDTH="100%" CELLPADDING=1 CELLSPACING=0>
11 <TD ALIGN="CENTER" BGCOLOR="#000000"><A HREF="http://flac.sourceforge.net/"><IMG SRC="images/logo.jpg" ALIGN=CENTER ALT="FLAC Logo" BORDER=0 HSPACE=0></a></TD>
15 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#99CC99"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="25" ALT=""></TD></TR></TABLE>
17 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="2" ALT=""></TD></TR></TABLE>
19 <TABLE WIDTH="100%" CELLPADDING=0 CELLSPACING=0 BORDER=0>
21 <TD ALIGN="CENTER" BGCOLOR="#D3D4C5">
22 <TABLE CELLPADDING=0 CELLSPACING=0 BORDER=0>
24 <TD HEIGHT=22 BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="index.html">home</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
25 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="news.html">news</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
26 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="download.html">download</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
27 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="features.html">features</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
28 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="goals.html">goals</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
29 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> format </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
30 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="comparison.html">comparison</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
31 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="documentation.html">documentation</A> </TD><TD BGCOLOR="#D3D4C5" ALIGN=CENTER>|</TD>
32 <TD BGCOLOR="#D3D4C5" ALIGN=CENTER NOWRAP> <A CLASS="topnav" HREF="developers.html">developers</A> </TD>
39 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="2" ALT=""></TD></TR></TABLE>
43 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#99CC99"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="15" ALT=""></TD></TR></TABLE>
46 <TABLE WIDTH="100%" CELLPADDING="5" CELLSPACING="5" BORDER="0">
48 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="1" ALT=""></TD></TR></TABLE>
49 <TABLE CELLSPACING="0" CELLPADDING="3" WIDTH="100%" BORDER="0" BGCOLOR="#D3D4C5">
50 <TR><TD><FONT FACE="Lucida,Verdana,Helvetica,Arial">
51 <B><FONT SIZE="+2">format</FONT></B>
54 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="1" ALT=""></TD></TR></TABLE>
55 <TABLE CELLSPACING="0" CELLPADDING="3" WIDTH="100%" BORDER="0" BGCOLOR="#EEEED4">
56 <TR><TD><FONT FACE="Lucida,Verdana,Helvetica,Arial">
58 This is a detailed description of the FLAC format. The format is still in an alpha stage, which means it can change (even breaking old streams) until the first beta, so if you are a developer, <A HREF="http://sourceforge.net/mail/?group_id=13478">join the mailing list</A> or check back regularly.
61 First, as the original developer I have to say that I am not a compression expert and I feel obligated to give credit where it is due. FLAC owes a lot to the many people who have advanced the audio compression field so freely. For instance:
66 <A HREF="http://svr-www.eng.cam.ac.uk/~ajr/">A. J. Robinson</A> for his work on <A HREF="http://svr-www.eng.cam.ac.uk/~ajr/GroupPubs/Robinson94-tr156/index.html">Shorten</A>; his code and paper are a good starting point on some of the basic methods used by FLAC. FLAC expands on the fixed predictors used in shorten.
69 <A HREF="http://commsci.usc.edu/faculty/golomb.html">S. W. Golomb</A> and Robert F. Rice; their universal codes are used by FLAC's entropy coder.
72 N. Levinson and J. Durbin; the reference encoder uses an algorithm developed and refined by them for determining the LPC coefficients from the autocorrelation coefficients.
75 And of course, the main guy, <A HREF="http://www.digitalcentury.com/encyclo/update/shannon.html">Claude Shannon</A>
80 <A NAME="scope"><FONT SIZE="+1"><B><U>Scope</U></B></FONT></A>
83 It is a known fact that no algorithm can losslessly compress all possible input, so most compressors restrict themselves to a useful domain and try to work as well as possible within that domain. FLAC's domain is audio data. Though it can losslessly code any input, only certain kinds of input will get smaller. FLAC exploits the fact that audio data typically has a high degree of sample-to-sample correlation.
86 Within the audio domain, there are many possible subdomains. For example: low bitrate speech, high-bitrate multi-channel music, etc. FLAC itself does not target a specific subdomain but many of the default parameters of the reference encoder are tuned to CD-quality music data (i.e. 44.1kHz, 2 channel, 16 bits per sample). The effect of the encoding parameters on different kinds of audio data will be examined later.
89 <A NAME="architecture"><FONT SIZE="+1"><B><U>Architecture</U></B></FONT></A>
92 Similar to many audio coders, a FLAC encoder has the following stages:
96 <A HREF="#blocking">Blocking</A>. The input is broken up into many contiguous blocks. With FLAC, the blocks may vary in size. The optimal size of the block is usually affected by many factors, including the sample rate, spectral characteristics over time, etc. Though FLAC allows the block size to vary within a stream, the reference encoder uses a fixed block size.
99 <A HREF="#interchannel">Interchannel Decorrelation</A>. In the case of stereo streams, the encoder will create mid and side signals based on the average and difference (respectively) of the left and right channels. The encoder will then pass the best form of the signal to the next stage.
102 <A HREF="#prediction">Prediction</A>. The block is passed through a prediction stage where the encoder tries to find a mathematical description (usually an approximate one) of the signal. This description is typically much smaller than the raw signal itself. Since the methods of prediction are known to both the encoder and decoder, only the parameters of the predictor need be included in the compressed stream. FLAC currently uses four different classes of predictors (described in the <A HREF="#prediction">prediction</A> section), but the format has reserved space for additional methods. FLAC allows the class of predictor to change from block to block, or even within the channels of a block.
105 <A HREF="#residualcoding">Residual coding</A>. If the predictor does not describe the signal exactly, the difference between the original signal and the predicted signal (called the error or residual signal) must be coded losslessy. If the predictor is effective, the residual signal will require fewer bits per sample than the original signal. FLAC currently uses only one method for encoding the residual (see the <A HREF="#residualcoding">Residual coding</A> section), but the format has reserved space for additional methods. FLAC allows the residual coding method to change from block to block, or even within the channels of a block.
109 In addition, FLAC specifies a metadata system, which allows arbitrary information about the stream to be included at the beginning of the stream.
112 <A NAME="definitions"><FONT SIZE="+1"><B><U>Definitions</U></B></FONT></A>
115 Many terms like "block" and "frame" are used to mean different things in differenct encoding schemes. For example, a frame in MP3 corresponds to many samples across several channels, whereas an S/PDIF frame represents just one sample for each channel. The definitions we use for FLAC follow. Note that when we talk about blocks and subblocks we are refering to the raw unencoded audio data that is the input to the encoder, and when we talk about frames and subframes, we are refering to the FLAC-encoded data.
119 <B>Block</B>: One or more audio samples that span several channels.
122 <B>Subblock</B>: One or more audio samples within a channel. So a block contains one subblock for each channel, and all subblocks contain the same number of samples.
125 <B>Blocksize</B>: The number of samples in any of a block's subblocks. For example, a one second block sampled at 44.1KHz has a blocksize of 44100, regardless of the number of channels.
128 <B>Frame</B>: A frame header plus one or more subframes.
131 <B>Subframe</B>: A subframe header plus one or more encoded samples from a given channel. All subframes within a frame will contain the same number of samples.
135 <A NAME="blocking"><FONT SIZE="+1"><B><U>Blocking</U></B></FONT></A>
138 The size used for blocking the audio data has a direct effect on the compression ratio. If the block size is too small, the resulting large number of frames mean that excess bits will be wasted on frame headers. If the block size is too large, the characteristics of the signal may vary so much that the encoder will be unable to find a good predictor. In order to simplify encoder/decoder design, FLAC imposes a minimum block size of 16 samples, and a maximum block size of 65535 samples. This range covers the optimal size for all of the audio data FLAC supports.
141 Currently the reference encoder uses a fixed block size, optimized on the sample rate of the input. Future version may vary the block size depending on the characteristics of the signal.
144 Blocked data is passed to the predictor stage one subblock (channel) at a time. Each subblock is independently coded into a subframe, and the subframes are concatenated into a frame. Because each channel is coded separately, it means that one channel of a stereo frame may be encoded as a constant subframe, and the other an LPC subframe.
147 <A NAME="interchannel"><FONT SIZE="+1"><B><U>Interchannel Decorrelation</U></B></FONT></A>
150 In stereo streams, in many cases there is an exploitable amount of correlation between the left and right channels. FLAC allows the frames of stereo streams to have different channel assignments, and an encoder may choose to use the best representation on a frame-by-frame basis.
154 <B>Independent</B>. The left and right channels are coded independently.
157 <B>Mid-side</B>. The left and right channels are transformed into mid and side channels. The mid channel is the midpoint (average) of the left and right signals, and the side is the difference signal (left minus right).
160 <B>Left-side</B>. The left channel and side channel are coded.
163 <B>Right-side</B>. The right channel and side channel are coded
167 Surprisingly, the left-side and right-side forms can be the most efficient in many frames, even though the raw number of bits per sample needed for the original signal is slightly more than that needed for independent or mid-side coding.
170 <A NAME="prediction"><FONT SIZE="+1"><B><U>Prediction</U></B></FONT></A>
173 FLAC uses four methods for modeling the input signal:
177 <B>Verbatim</B>. This is essentially a zero-order predictor of the signal. The predictor of the signal is the signal itself, so the compression is zero. This is the baseline against which the other predictors are measured. If you feed random data to the encoder, the verbatim predictor will probably be used for every subblock. Since the raw signal is not actually passed through the residual coding stage (it is added to the stream 'verbatim'), the encoding results will not be the same as a zero-order linear predictor.
180 <B>Constant</B>. This predictor is used whenever the subblock contains digital silence, i.e. a constant value throughout. The signal is run-length encoded and added to the stream.
183 <B>Fixed linear predictor</B>. FLAC uses a class of computationally-efficient fixed linear predictors (for a good description, see <A HREF="http://www.hpl.hp.com/techreports/1999/HPL-1999-144.pdf">audiopak</A> and <A HREF="http://svr-www.eng.cam.ac.uk/~ajr/GroupPubs/Robinson94-tr156/index.html">shorten</A>). FLAC adds a fourth-order predictor to the zero-to-third-order predictors used by shorten. Since the predictors are fixed, the predictor order is the only parameter that needs to be stored in the compressed stream. The error signal is then passed to the residual coder.
186 <B>FIR Linear prediction</B>. For more accurate modeling (at a cost of slower encoding), FLAC supports up to 32nd order FIR linear prediction (again, for info on linear prediction, see <A HREF="http://www.hpl.hp.com/techreports/1999/HPL-1999-144.pdf">audiopak</A> and <A HREF="http://svr-www.eng.cam.ac.uk/~ajr/GroupPubs/Robinson94-tr156/index.html">shorten</A>). The reference encoder uses the Levinson-Durbin method for calculating the LPC coefficients from the autocorrelation coefficients, and the coefficients are quantized before computing the residual. Whereas encoders such as shorten used a fixed quantization for the entire input, FLAC allows the quantized coefficient precision to vary from subframe to subframe. The FLAC reference encoder estimates the optimal precision to use based on the block size and dynamic range of the original signal.
190 <A NAME="residualcoding"><FONT SIZE="+1"><B><U>Residual Coding</U></B></FONT></A>
193 FLAC currently defines two similar methods for the coding of the error signal from the prediction stage. The error signal is coded using Rice codes in one of two ways: 1) the encoder estimates a single rice parameter based on the variance of the residual, and Rice codes the entire residual using this parameter; 2) the residual is partitioned into several equal-length regions of contiguous samples, and each region is coded with its own Rice parameter based on the region's mean. (Note that the first method is a special case of the second method with one partition, except the Rice parameter is based on the residual variance instead of the mean.)
196 The FLAC format has reserved space for other coding methods. Some possiblities for volunteers would be to explore better context-modeling of the Rice parameter, or Huffman coding. See <A HREF="http://www.hpl.hp.com/techreports/98/HPL-98-193.html">LOCO-I</A> and <A HREF="http://www.cs.tut.fi/~albert/Dev/pucrunch/packing.html">pucrunch</A> for descriptions of several universal codes.
199 <FONT SIZE="+1"><B><U>Format</U></B></FONT>
202 This section specifies the FLAC bitstream format. FLAC has no format version information, but it does contain reserved space in several places. Future versions of the format may use this reserved space safely without breaking the format of older streams. Older decoders may choose to abort decoding or skip data encoded with newer methods. Apart from reserved patterns, in places the format specifies invalid patterns, meaning that the patterns may never appear in any valid bitstream, in any prior, present, or future versions of the format. These invalid patterns are usually used to make the synchronization mechanism more robust.
205 All numbers used in a FLAC bitstream are integers; there are no floating-point representations. All numbers are big-endian coded. All numbers are unsigned unless otherwise specified.
208 <A NAME="overview">A FLAC bitstream may be appended with ID3V1 data or prepended with ID3V2 data. FLAC has no knowledge of such data, but the reference decoder knows how to skip an ID3 tag. The input plugins support ID3V1 tags</A>
211 Before the formal description of the stream, an overview might be helpful.
215 A FLAC bitstream consists of the "fLaC" marker at the beginning of the stream, followed by a mandatory metadata block (called the 'Encoding' block), any number of other metadata blocks, then the audio frames.
218 FLAC supports up to 128 kinds of metadata blocks, but currently only one is defined. This is the 'Encoding' block, which has info about the whole stream like sample rate, number of channels, total number of samples, etc. This block must be present as the first metadata block in the stream. Other metadata blocks may follow, and ones that the decoder doesn't understand, it will skip.
221 The audio data is composed of one or more audio frames. Each frame consists of a frame header, which contains a sync code, info about the frame like the block size, sample rate, number of channels, et cetera, and an 8-bit CRC. The frame header also contains either the sample number of the first sample in the frame (for variable-blocksize streams), or the frame number (for fixed-blocksize streams). This allows for fast, sample-accurate seeking to be performed. Following the frame header are encoded subframes, one for each channel, and finally, the frame is zero-padded to a byte boundary. Each subframe has its own header that specifies how the subframe is encoded.
224 Since a decoder may start decoding in the middle of a stream, there must be a method to determine the start of a frame. A 9-bit sync code begins every frame. The sync code will not appear anywhere else in the frame header. However, since it may appear in the subframes, the decoder has two other ways of ensuring a correct sync. The first is to check that the rest of the frame header contains no invalid data. Even this is not foolproof since valid header patterns can still occur within the subframes. The decoder's final check is to generate an 8-bit CRC of the frame header and compare this to the CRC stored at the end of the frame header.
227 Again, since a decoder may start decoding at an arbitrary frame in the stream, each frame header must contain some basic information about the stream because the decoder may not have access to the ENCODING metadata block at the start of the stream. This information includes sample rate, bits per sample, number of channels, etc. Since the frame header is pure overhead, it has a direct effect on the compression ratio. To keep the frame header as small as possible, FLAC uses lookup tables for the most commonly used values for frame parameters. For instance, the sample rate part of the frame header is specified using 4 bits. Eight of the bit patterns correspond to the commonly used sample rates of 8/16/22.05/24/32/44.1/48/96 kHz. However, odd sample rates can be specified by using one of the 'hint' bit patterns, directing the decoder to find the exact sample rate at the end of the frame header. The same method is used for specifying the block size and bits per sample. In this way, the frame header size stays small for all of the most common forms of audio data.
230 Individual subframes (one for each channel) are coded separately within a frame, and appear serially in the stream. In other words, the encoded audio data is NOT channel-interleaved. This reduces decoder complexity at the cost of requiring larger decode buffers. Each subframe has its own header specifying the attributes of the subframe, like prediction method and order, residual coding parameters, etc. The header is followed by the encoded audio data for that channel.
233 FLAC specifies a subset of itself as the Subset format. The purpose of this is to ensure that any streams encoded according to the Subset are truly "streamable", meaning that a decoder that cannot seek within the stream can still pick up in the middle of the stream and start decoding. It also makes hardware decoder implementations more practical by limiting the blocking such that decoder buffer sizes can be easily determined. "flac" generates Subset streams by default unless the "--lax" command-line option is used. The Subset makes the following limitations on what may be used in the stream:
236 The blocksize bits in the <A HREF="#frame_header">frame header</A> must be 001-101, specifying a fixed-blocksize stream (the exception being the last block as described in the table). This also means that the Encoding metadata block must specify equal mininum and maximum blocksizes.
239 The bits-per-sample bits in the <A HREF="#frame_header">frame header</A> must be 001-110.
242 The sample rate bits in the <A HREF="#frame_header">frame header</A> must be 0001-1011.
249 The following tables constitute a formal description of the FLAC format. Numbers in angle brackets indicate how many bits are used for a given field.
255 <TABLE WIDTH="100%" CELLPADDING="0" CELLSPACING="0" BORDER="0"><TR BGCOLOR="#000000"><TD><IMG SRC="images/1x1.gif" WIDTH="1" HEIGHT="1" ALT=""></TD></TR></TABLE>
258 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
259 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
261 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
262 <A NAME="stream"><FONT SIZE="+1"><B>STREAM</B></FONT></A>
266 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
270 "fLaC", the FLAC stream marker in ASCII, meaning byte 0 of the stream is 0x66, followed by 0x4C 0x61 0x43
274 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
275 <A HREF="#metadata_encoding_block"><I>METADATA_ENCODING_BLOCK</I></A>
278 This is the mandatory metadata block that has the basic properties of the stream
282 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
283 <A HREF="#metadata_block"><I>METADATA_BLOCK</I></A>*
286 Zero or more metadata blocks
290 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
291 <A HREF="#frame"><I>FRAME</I></A>+
294 One or more audio frames
302 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
303 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
305 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
306 <A NAME="metadata_block"><FONT SIZE="+1"><B>METADATA_BLOCK</B></FONT></A>
310 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
311 <A HREF="#metadata_block_header"><I>METADATA_BLOCK_HEADER</I></A>
314 A block header that specifies the type and size of the metadata block data.
318 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
319 <A HREF="#metadata_block_data"><I>METADATA_BLOCK_DATA</I></A>
330 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
331 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
333 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
334 <A NAME="metadata_encoding_block"><FONT SIZE="+1"><B>METADATA_ENCODING_BLOCK</B></FONT></A>
338 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
339 <A HREF="#metadata_block_header"><I>METADATA_BLOCK_HEADER</I></A>
342 A block header that specifies the ENCODING BLOCK
346 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
347 <A HREF="#metadata_block_encoding"><I>METADATA_BLOCK_ENCODING</I></A>
358 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
359 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
361 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
362 <A NAME="metadata_block_header"><FONT SIZE="+1"><B>METADATA_BLOCK_HEADER</B></FONT></A>
366 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
370 Last-metadata-block flag: '1' if this block is the last metadata block before the audio blocks, '0' otherwise.
374 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
381 <TT>0</TT> : ENCODING
384 <TT>1-127</TT> : reserved
390 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
394 Length (in bytes) of metadata to follow (does not include the size of the METADATA_BLOCK_HEADER)
400 <TD BGCOLOR="#F4F4CC">
401 <FONT SIZE="+1">NOTES</FONT><BR>
404 Currently, FLAC specifies only one metadata block, the ENCODING block. Its presence as the first metadata block in the stream is mandatory.
414 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
415 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
417 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
418 <A NAME="metadata_block_data"><FONT SIZE="+1"><B>METADATA_BLOCK_DATA</B></FONT></A>
422 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
423 <A HREF="#metadata_block_encoding"><I>METADATA_BLOCK_ENCODING</I></A>
426 Currently, FLAC specifies only one metadata block, the ENCODING block.
434 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
435 <TABLE WIDTH="100%" BORDER="1">
437 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
438 <A NAME="metadata_block_encoding"><FONT SIZE="+1"><B>METADATA_BLOCK_ENCODING</B></FONT></A>
442 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
446 The minimum block size (in samples) used in the stream.
450 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
454 The maximum block size (in samples) used in the stream. (Minimum blocksize == maximum blocksize) implies a fixed-blocksize stream.
458 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
462 The minimum frame size (in bytes) used in the stream. May be 0 to imply the value is not known.
466 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
470 The maximum frame size (in bytes) used in the stream. May be 0 to imply the value is not known.
474 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
478 Sample rate in Hz. Though 20 bits are available, the maximum sample rate is limited by the structure of frame headers to 1048570Hz. Also, a value of 0 is invalid.
482 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
486 (number of channels)-1. FLAC supports from 1 to 8 channels
490 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
494 (bits per sample)-1. FLAC supports from 1 to 32 bits per sample. Currently the reference encoder and decoders only support up to 24 bits per sample.
498 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
502 Total samples in stream. 'Samples' means channel-wide sample, i.e. one second of 44.1Khz audio will have 44100 samples regardless of the number of channels. A value of zero here means the number of total samples is unknown.
508 <TD BGCOLOR="#F4F4CC">
509 <FONT SIZE="+1">NOTES</FONT><BR>
512 FLAC specifies a minimum block size of 16 and a maximum block size of 65535, meaning the bit patterns corresponding to the numbers 0-15 in the minimum blocksize and maximum blocksize fields are invalid.
522 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
523 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
525 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
526 <A NAME="frame"><FONT SIZE="+1"><B>FRAME</B></FONT></A>
530 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
531 <A HREF="#frame_header"><I>FRAME_HEADER</I></A>
538 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
539 <A HREF="#subframe"><I>SUBFRAME</I></A>+
542 One SUBFRAME per channel.
546 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
550 Zero-padding to byte alignment.
558 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
559 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
561 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
562 <A NAME="frame_header"><FONT SIZE="+1"><B>FRAME_HEADER</B></FONT></A>
566 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
570 sync code '<TT>111111110</TT>'
574 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
578 block size in channel-wide samples:<BR>
581 <TT>000</TT> : get from ENCODING metadata block
584 <TT>001</TT> : 192 samples
587 <TT>010-101</TT> : 576 * (2^(2-n)) samples, i.e. 576/1152/2304/4608
590 <TT>110</TT> : get 8 bit (blocksize-1) from end of header
593 <TT>111</TT> : get 16 bit (blocksize-1) from end of header
599 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
606 <TT>0000</TT> : get from ENCODING metadata block
609 <TT>0001-0011</TT> : reserved
615 <TT>0101</TT> : 16kHz
618 <TT>0110</TT> : 22.05kHz
621 <TT>0111</TT> : 24kHz
624 <TT>1000</TT> : 32kHz
627 <TT>1001</TT> : 44.1kHz
630 <TT>1010</TT> : 48kHz
633 <TT>1011</TT> : 96kHz
636 <TT>1100</TT> : get 8 bit sample rate (in kHz) from end of header
639 <TT>1101</TT> : get 16 bit sample rate (in Hz) from end of header
642 <TT>1110</TT> : get 16 bit sample rate (in tens of Hz) from end of header
645 <TT>1111</TT> : invalid, to prevent sync-fooling string of 1s
651 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
658 <TT>0000-0111</TT> : (number of independent channels)-1. when == 0001, channel 0 is the left channel and channel 1 is the right
661 <TT>1000</TT> : left/side stereo: channel 0 is the left channel, channel 1 is the side(difference) channel
664 <TT>1001</TT> : right/side stereo: channel 0 is the side(difference) channel, channel 1 is the right channel
667 <TT>1010</TT> : mid/side stereo: channel 0 is the mid(average) channel, channel 1 is the side(difference) channel
670 <TT>1011-1111</TT> : reserved
676 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
680 sample size in bits:<BR>
683 <TT>000</TT> : get from ENCODING metadata block
686 <TT>001</TT> : 8 bits per sample
689 <TT>010</TT> : 12 bits per sample
692 <TT>011</TT> : reserved
695 <TT>100</TT> : 16 bits per sample
698 <TT>101</TT> : 20 bits per sample
701 <TT>110</TT> : 24 bits per sample
704 <TT>111</TT> : reserved
710 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
714 zero bit padding, to prevent sync-fooling string of 1s
718 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
722 if(variable blocksize)<BR>
723 <8-56>:"UTF-8" coded sample number (decoded number is 36 bits)<BR>
725 <8-48>:"UTF-8" coded frame number (decoded number is 31 bits)
729 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
733 if(blocksize bits == 11x)<BR>
734 8/16 bit (blocksize-1)
738 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
742 if(sample rate bits == 11xx)<BR>
743 8/16 bit sample rate
747 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
751 CRC-8 (polynomial = x^8 + x^2 + x + 1) of everything before the crc, including the sync code
757 <TD BGCOLOR="#F4F4CC">
758 <FONT SIZE="+1">NOTES</FONT><BR>
761 The blocksize bits 000-101 may only be used if the blocksize is fixed throughout the entire stream. Blocksize bits 110-111 may be used in any case but the decoder will have to pessimistically guess that it is a variable-blocksize stream. There is only one special case: the encoder may use blocksize bits 110-111 on the last frame of a fixed-blocksize stream, as long as the blocksize is not greater than the stream blocksize.
764 The "UTF-8" coding used for the sample/frame number is the same variable length code used to store compressed UCS-2, extended to handle larger input.
774 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
775 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
777 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
778 <A NAME="subframe"><FONT SIZE="+1"><B>SUBFRAME</B></FONT></A>
782 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
783 <A HREF="#subframe_header"><I>SUBFRAME_HEADER</I></A>
790 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
791 <A HREF="#subframe_constant"><I>SUBFRAME_CONSTANT</I></A><BR>|| <A HREF="#subframe_fixed"><I>SUBFRAME_FIXED</I></A><BR>|| <A HREF="#subframe_lpc"><I>SUBFRAME_LPC</I></A><BR>|| <A HREF="#subframe_verbatim"><I>SUBFRAME_VERBATIM</I></A>
794 The SUBFRAME_HEADER specifies which one.
802 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
803 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
805 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
806 <A NAME="subframe_header"><FONT SIZE="+1"><B>SUBFRAME_HEADER</B></FONT></A>
810 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
817 <TT>xxxxxxx1</TT> : invalid, to prevent sync-fooling string of 1s
820 <TT>00000000</TT> : <A HREF="#subframe_constant">SUBFRAME_CONSTANT</A>
823 <TT>00000010</TT> : <A HREF="#subframe_verbatim">SUBFRAME_VERBATIM</A>
826 <TT>000001x0</TT> : reserved
829 <TT>00001xx0</TT> : reserved
832 <TT>0001xxx0</TT> : if(xxx <= 4) <A HREF="#subframe_fixed">SUBFRAME_FIXED</A>, xxx=order ; else reserved
835 <TT>001xxxx0</TT> : reserved
838 <TT>01xxxxx0</TT> : <A HREF="#subframe_lpc">SUBFRAME_LPC</A>, xxxxx=order-1
841 <TT>1xxxxxxx</TT> : invalid, to prevent sync-fooling string of 1s
851 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
852 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
854 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
855 <A NAME="subframe_constant"><FONT SIZE="+1"><B>SUBFRAME_CONSTANT</B></FONT></A>
859 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
863 Unencoded constant value of the subblock, n = frame's bits-per-sample.
871 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
872 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
874 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
875 <A NAME="subframe_fixed"><FONT SIZE="+1"><B>SUBFRAME_FIXED</B></FONT></A>
879 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
883 Unencoded warm-up samples (n = frame's bits-per-sample * predictor order).
887 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
888 <A HREF="#residual"><I>RESIDUAL</I></A>
899 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
900 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
902 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
903 <A NAME="subframe_lpc"><FONT SIZE="+1"><B>SUBFRAME_LPC</B></FONT></A>
907 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
911 Unencoded warm-up samples (n = frame's bits-per-sample * lpc order).
915 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
919 (quantized linear predictor coefficients' precision in bits)-1 (1111 = invalid).
923 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
927 Quantized linear predictor coefficient shift needed in bits (NOTE: this number is signed).
931 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
935 Unencoded predictor coefficients (n = qlp coeff precision * lpc order).
939 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
940 <A HREF="#residual"><I>RESIDUAL</I></A>
951 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
952 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
954 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
955 <A NAME="subframe_verbatim"><FONT SIZE="+1"><B>SUBFRAME_VERBATIM</B></FONT></A>
959 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
963 Unencoded subblock; n = frame's bits-per-sample, i = frame's blocksize.
971 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
972 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
974 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
975 <A NAME="residual"><FONT SIZE="+1"><B>RESIDUAL</B></FONT></A>
979 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
983 Residual coding method:<BR>
986 <TT>00</TT> : partitioned rice coding
989 <TT>01-11</TT> : reserved
995 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
996 <A HREF="#partitioned_rice"><I>RESIDUAL_CODING_METHOD_PARTITIONED_RICE</I></A>
1005 <TD BGCOLOR="#F4F4CC">
1006 <FONT SIZE="+1">NOTES</FONT><BR>
1009 Currently, FLAC specifies only one entropy coding method.
1019 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
1020 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
1022 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
1023 <A NAME="partitioned_rice"><FONT SIZE="+1"><B>RESIDUAL_CODING_METHOD_PARTITIONED_RICE</B></FONT></A>
1027 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
1035 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
1036 <A HREF="#rice_partition"><I>RICE_PARTITION</I></A>+
1039 There will be 2^order partitions.
1047 <TABLE WIDTH="100%" BORDER="0" CELLSPACING="0" CELLPADDING="0" BGCOLOR="#EEEED4"><TR><TD>
1048 <TABLE WIDTH="100%" BORDER="1" BGCOLOR="#EEEED4">
1050 <TD COLSPAN="2" BGCOLOR="#D3D4C5">
1051 <A NAME="rice_partition"><FONT SIZE="+1"><B>RICE_PARTITION</B></FONT></A>
1055 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
1063 <TD ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
1067 Encoded residual. The number of samples (n) in the partition is determined as follows:<BR>
1070 if the partition order is zero, n = frame's blocksize
1073 else if this is not the first partition of the subframe, n = (frame's blocksize / (2^partition order))
1076 else n = (frame's blocksize / (2^partition order)) - predictor order