| | начало | | | новости | | | файлы | | | характеристики | | | цели | | | формат | |
| | id | | | сравнение | | | разработка | | | документация | | | ссылки | | | авторы | |

| | english | | | русский | |

## FLAC: документация

### Документация

Эта страница разбита на следующие разделы:

- формат - описание формата FLAC для пользователя (более детальное описание для разработчика приведено на этой странице).
- `flac` - иcпользование кодека `flac`, работающего из командной строки.
- `metaflac` - использование редактора метаданных `metaflac`, работающего из командной строки.
- плагины - документация для различных плагинов.
- API для `libFLAC` и `libFLAC++` - для разработчиков, желающих использовать поддержку FLAC в своих продуктах.
- ошибки - известные ошибки.
- как добавить поддержку FLAC в Monkey's Audio GUI

Помните, что онлайновая версия этого документа (на английском языке) включается в последний релиз.

### Формат

Опции по умолчанию для `flac` настроены на получение оптимального соотношения скорость/уровень сжатия для большинства типов входных файлов. Здесь описывается как можно попытаться увеличить уровень или скорость сжатия или с наибольшим эффектом использовать систему метаданных.

Основными частями потока являются:

> - Строка из четырех байтов "fLaC".
> - Блок метаданных STREAMINFO.
> - Другие необязательные блоки метаданных.
> - Один или более аудио фреймов.

Первые четыре байта идетифицируют поток FLAC. Следующие за ними метаданные содержат информацию о потоке, затем идут сжатые аудиоданные.

#### Метаданные

FLAC определяет несколько типов блоков метаданных (все они перечислены на странице формат). Блоки метаданных могут быть любого размера, новые блоки могут быть легко добавлены. Декодер имеет возможность пропускать неизветные ему блоки метаданных. Обязателен только блок STREAMINFO. В нем содержится частота дискретизация, количество каналов и т.п., а также данные позволяющие декодеру настроить буфферы. Сюда также записывается подпись MD5 несжатых аудиоданных. Это полезно для проверки всего потока после его передачи.

Другие блоки предназначены для резервирования места, хранения таблиц точек поиска, тегов, список разметки аудиодисков а также данных для конкретных приложений. Опции для добавления блоков PADDING или точек поиска приведены ниже. FLAC не нуждается в точках поиска, однако они позволяют значительно увеличить скорость доступа, а также могут быть использования для расстановки меток в аудио редакторах.

Если Вам нужен собственный блок метаданных, Вы можете определить его и запросить идентификатор здесь. Вы можете зарезервировать блок PADDING необходимого размера и записать на его место свои данные после кодирования. Полученнный поток будет отвечать формату FLAC, декодеры распознающие эти блоки смогут их использовать, остальные будут их пропускать.

#### Аудиоданные

За метаданным следуют сжатые аудиоданные. Метаданные и аудиоданные не чередуются. Как и большинство кодеков FLAC делит входной поток на блоки и кодирует их независимо друг от друга. Блок упаковыватся во фрейм и добавляется к потоку. Базовый кодер использует блоки постоянного размера для всего потока, однако формат предусматривает наличие блоков разной длины в потоке.

#### Разбиение на блоки

Размер блока - очень важный параметр для кодирования. Если он очень мал, то в потоке будет слишком заголовков фреймов, что уменьшит уровень сжатия. Если размер большой, то кодер не сможет подобрать эффективную модель сжатия. Понимание процесса моделирования поможет Вам увеличить уровень сжатия для некоторых типов входных данных. Обычно при использовании линейного прогнозирования на аудиоданных с частотой дискретизации 44.1 кГц оптимальный размер блока лежит в диапазоне 2-6 тысяч сэмплов. В этом случае значение по умолчанию - 4608. Если использовать быстрые постоянные предикторы, предпочтительнее меньшие размеры блоков, так как в этом случае размеры заголовков фреймов меньше.

#### Межканальная декорреляция

Если на вход поступают стерео аудиоданные, они могут пройти через стадию межканальной декорреляции. Правый и левый канал преобразуются к среднему и разностному по формулам: `средний = (левый + правый)/2`, `разностный = левый - правый`. В отличие от joint stereo этот процесс не приводит к потерям. Для данных с аудио компакт-дисков это обычно приводит к значительному увеличению уровня сжатия. Для включения использования этого метода кодирования `flac` имеет две опции: `-m` всегда делает разностную и независимую версию блока и выбирает наименьший фрейм и `-M`, которая адаптивно выбирает схему сжатия.

#### Моделирование

На следующем этапе кодер пытается аппроксимировать сигнал такой функцией, чтобы полученный после ее вычитания из оригинала результат (называемый разностью, остатком, ошибкой) можно было закодировать минимальным количеством битов. Параметры функций тоже должны записываться, поэтому они не должны занимать много места. FLAC использует два метода формирования аппроксимаций: 1) подгонка простого полинома к сигналу и 2) общее кодирование с линейными предикторами (LPC).

Во-первых, постоянное полиномиальное предсказание (`-l 0`) работает значительно быстрее, но менее точно, чем LPC. Чем выше порядок LPC, тем медленнее, но лучше будет модель. Однако с увеличением порядка выигрыш будет все менее значительным. В некоторой точке (обычно около 9) процедура кодера, определяющая наилучший порядок, начинает ошибаться и размер получаемых фреймов возрастает. Чтобы преодолеть это, можно использовать полный перебор (опция `-e`), что приведет к значительному увеличению времени кодирования.

Во-вторых, параметры для постоянных предикторов могут быть описаны тремя битами, а параметры для модели LPC зависят от количества бит на сэмпл и порядка LPC. Это значит, что размер заголовка фрейма зависит от выбранного метода и порядка и может повлиять на оптимальный размер блока.

#### Остаточное кодирование

Когда модель подобрана, кодер вычитает приближение из оригинала, чтобы получить остаточный (ошибочный) сигнал, который затем кодируется без потерь. Для этого используется то обстоятельство, что разностный сигнал обычно имеет распределение Лапласа и есть набор специальный кодов Хаффмана, называемые кодами Райса, позволяющие эффективно и быстро кодировать эти сигналы без использования словаря.

Кодирование Райса состоит из нахождения одного параметра, отвечающего распределению сигнала, а затем использования его для составления кодов. При изменении распределения меняется и оптимальный параметр, поэтому имеется метод позволяющий пересчитывать его по необходимости. Остаток может быть разбит на контексты или разделы, у каждого из которых будет свой параметр Райса. `flac` позволяет указать, как нужно производить разбиение, с помощью опции `-r`. Остаток может быть разбит на 2^n раздела, если использовать `-r n,n`. Параметр n называется порядком раздела. Также кодер может искать в пределах от m до n порядка, выбирая лучший вариант, если указать `-r m,n`. Обычно выбор n не влияет на скорость кодирования. От разницы между m и n сильно зависит время работы, чем она больше, тем больше времени будет затрачиваться на поиск лучшего порядка. Выбор размера блока также влияет на оптимальный порядок раздела.

#### Составление фреймов

Аудиофрейму предшествует заголовок, который начинается с кода синхронизации и содержит минимум информации, необходимой декодеру для воспроизведения потока. Сюда также записывается номер блока или сэмпла и восьмибитная контрольная сумма самого заголовка. Код синхронизации, CRC заголовка фрейма и номер блока/сэмпла позволяют осуществлять пересинхронизацию и поиск даже в отсутствие точек поиска. В конце фрейма записывается его шестнадцатибитная контрольная сумма. Если базовый декодер обнаружит ошибку, будет сгенерирован блок тишины.

#### Разное

Чтобы поддерживать основные типы метаданных, базовый декодер умеет пропускать теги ID3V1 и ID3V2, поэтому их можно свободно добавлять. Теги ID3V2 должны располагаться перед маркером "fLaC", а теги ID3V1 - в конце файла.

У `flac` есть опция (`-V`) для проверки выходных данных при кодировании. В этом случае декодер работает одновременно с кодером и его выход сравнивается с оригинальным вводом. Если будет найдено отличие, `flac` закончит работу с сообщением об ошибке.

### `flac`

`flac` - это кодек, работающий из командной строки. Входом для кодера и выходом для декодера должны быть данные в формате RIFF WAVE, AIFF или в виде потока сэмплов без заголовка. `flac` использует только линейные PCM сэмплы (другими словами, A-LAW, uLAW, и т.п. не поддерживаются). Следующим ограничением является то, что во кодируемом файле сэмплы должны быть 8, 16 или 24-битными. Это не ограничение формата, просто так работают базовый кодер и декодер.

`flac` предполагает, что файлы RIFF WAVE имеют суффикс ".wav", а файлы формата AIFF имеют суффиксы ".aif", ".aiff" или встречен заголовок AIFF; это умолчание может быть переопределено специальным ключом. Также предполагается, что файлы с суффиком ".ogg" имеют формат Ogg-FLAC. В остальных случаях `flac` не делает предположений о суффиксах, хотя по соглашению файлы FLAC имеют суффикс ".flac" (или ".fla" на старых файловых системах таких как FAT-16).

Перед полным описанием ключей, используемых `flac`, обратим внимание на то что: 1) по умолчанию `flac` сжимает файлы (для декодирования используйте ключ `-d`); 2) ключи `-0..-8`, а также `--fast` и `--best`, управляющие уровнем сжатия, являются синонимами для различных групп настроек кодирования. Того же эффекта можно добиться, используя наборы соответствующих ключей; 3) модель обработки входных и выходных файлов у `flac` аналогична `gzip`.

`flac` вызывается одним из четырех способов:

> - Кодирование:
>   `flac [<основные_ключи>] [<настройки_формата>] [<опции_кодирования>] [входной_файл [...]]`
> - Декодирование:
>   `flac -d [<основные_ключи>] [<настройки_формата>] [<опции_кодирования>] [файл_FLAC [...]]`
> - Тестирование:
>   `flac -t [<основные_ключи>] [файл_FLAC [...]]`
> - Анализ:
>   `flac -a [<основные_ключи>] [<опции_анализа>] [файл_FLAC [...]]`

В любом случае, если входной файл не указан, подразумевается стандартный ввод. Если указан только один входной файл, то это может быть "-" для стандартного ввода (stdin). Когда используется стандартный ввод, `flac` пишет в стандартный вывод (stdout). В остальных случаях `flac` выполнит указанные действия для каждого входного файла и запишет результаты в файлы с аналогичными именами (при кодировании суффикс будет заменен на ".flac" или, если его не было, будет добавлен; при декодировании суффиксы также изменяются в соответствии с типом выходных данных.) Оригинал удаляется, только если указан ключ `--delete-input-file`.

Существуют особые формы вызова процедур кодирования/декодирования из стандандартного ввода в файл.

> - `flac [опции] - выходной_файл`
> - `flac -d [опции] - выходной_файл`

> которые лучше чем

> - `flac [опции] > выходной_файл`
> - `flac -d [опции] > выходной_файл`

так как в первом случае сохраняется возможность произвести при необходимости последующую обработку файла, например для записи заголовков `RIFF WAVE` или `STREAMINFO`.

Данные в стандартный вывод можно перенаправить с помощью ключа `-c`.

Опции кодирования влияют на скорость работы и уровень сжатия. Настройки формата определяют расположение сэмплов, если на вход поступает файл без заголовка. Если у файла есть заголовок RIFF WAVE или AIFF, то настойки формата не нужны, так как они берутся из файла.

В режиме тестирования `flac` работает как и при декодировании, только выходной файл не записывается. Режимы декодирования и тестирования проверяют поток на наличие ошибок, а также сравнивают подпись MD5 декодированного потока с сохраненной подписью, даже если формат потока правильный.

#### Основные ключи

`-v`, `--version` | Номер версии `flac`.
`-h`, `--help` | Вывести основные методы использования и список всех опций. При запуске `flac` без аргументов отображается краткая справка.
`-H`, `--explain` | Вывести справку полностью. При запуске `flac` без аргументов отображается краткая справка.
`-d`, `--decode` | Декодирование (по умолчанию `flac` кодирует). `flac` завершит работу с кодом выхода `1`, если будет встречена ошибка или контрольная сумма MD5 декодированного потока не совпадет с сохраненной. Если ошибок не будет, код возврата будет равен `0`.
`-t`, `--test` | Тестирование (то же самое, что и декодирование, только выход не записывается в файл). Коды возврата те же.
`-a`, `--analyze` | Анализ (то же самое, что и декодирование, только выходом является файл статистики). Коды возврата те же. Режим предназначен в основном для разработчиков. В выходной текстовый файл записывается информация о каждом фрейме и подфрейме.
`-c`, `--stdout` | Направить результат в стандартный вывод (stdout).
`-s`, `--silent` | Не показывать статистику при кодировании/декодировании.
`-o файл` `--output-name=файл` | Явно указать имя выходного файла, по умолчанию `flac` просто заменяет суффикс.
`--output-prefix=строка` | Добавляет префикс к каждому имени выходному файлу. Может имспользоваться для кодирования/декодирования файлов в другой каталог. Если указанная строка является частью пути, убедитесь, что она заканчивается слэшем '/'.
`--delete-input-file` | После успешного окончания кодирования/декодирования входной файл будет удален. Если произойдет ошибка, исходный файл останется.
`--skip={#|mm:ss.ss}` | Пропустить первые `#` сэмплов входного файла. Работает для кодирования и декодирования, но не для тестирования. Альтернативную форму mm:ss.ss можно использовать, чтобы указать минуты, секунды и сотые секунды. Например: `--skip=123` : пропустить первые 123 сэмпла входного файла `--skip=1:23.45` : пропустить 1 минуту 23.45 секунд

`--until={#|[+|-]mm:ss.ss}`

Остановиться на данном сэмпле входного файла. Работает для кодирования и декодирования, но не для тестирования. Сэмпл с указанным номером не включается в вывод. Альтернативную форму mm:ss.ss можно использовать, чтобы указать минуты, секунды и сотые секунды. Если впереди стоит знак `+`, то последний сэмпл берется от начальной точки воспроизведения, если - `-`, то последний сэмпл вычисляется от конца потока аудио.
Например:
`--until=123` : декодировать первые 123 сэмпла входного файла (сэмплы 0-122)
`--until=1:23.45` : декодировать 1 минуту 23.45 секунд
`--skip=1:00 --until=+1:23.45` : декодировать от 1:00.00 до 2:23.45
`--until=-1:23.45` : декодировать все, кроме последней 1 минуты и 23.45 секунд
`--until=-0:00` : декодировать весь ввод

`--ogg`

При кодировании генерируется вывод в формате Ogg-FLAC вместо "родного" FLAC. Потоки Ogg-FLAC представляют собой потоки FLAC обернутые в транспортный уровень Ogg. Полученный файл будет иметь суффикс '.ogg' и будет декодироваться утилитой `flac`.

При декодировании формат ввода однозначно определяется как Ogg-FLAC. Это полезно при получении данных со стандартного ввода или если у файла суффикс не '.ogg'.

`--serial-number=#` | При использовании с ключом `--ogg` определяет серийный номер для потока FLAC. При кодировании без явно указанного серийного номера `flac` использует '0'. При декодировании по умолчанию используется серийный номер определенный на первой странице.

#### Опции анализа

`--residual-text` | Добавляет в файл остаточный сигнал. Результирующий файл получается очень большим.
`--residual-gnuplot` | Создает файлы-диаграммы для каждого подфрейма. В каждом файле будет остаточное распределение для подфрейма. Будет создано очень много файлов.

#### Опции декодирования

`-F`, `--decode-through-errors` | По умолчанию `flac` прекращает декодирование в случае ошибки в потоке и удаляет частично декодированный файл. Использование ключа `-F` ведет к тому, что сообщения об ошибках выводятся, но `flac` продолжает работу до конца. Обратите внимание, что в результате такого декодирования в выходном файле могут быть пропущены сэмплы или появится блоки тишины.

#### Опции кодирования

`-V` | Проверять процесс сжатия. В данном случае `flac` создает параллельный декодер, раскодирующий выход кодера и сравнивает результат с оригиналом. Если будет найдено несоответствие, кодирование прекратится. Время работы с этой опцией увеличивается, однако, при этом гарантируется, что файл будет правильно декодирован.
`--lax` | Позволяет кодеру создавать файлы, отвечающие подмножеству формата FLAC. В результате работы будет получаться непотоковый файл, поэтому этот ключ следует использовать только для архивирования. Декодер будет поддерживать воспроизведение и поиск в таких файлах.

`--replay-gain`

Вычислить значения ReplayGain и сохранить из в комментариях Vorbis, аналогично тому, как это делает VorbisGain. Уровень записи и максимальные значения амплитуды будут вычислены для каждого входного файла. Кроме того будет рассчитаны значения для всего альбома (всех входных файлов). Для этого все файлы должны иметь одинакоыую частоту дискретизации, разрешение и число каналов. Допустимы только моно и стерео файлы, а частота дискретизации должна быть 8, 11.025, 12, 16, 22.05, 24, 32, 44.1 или 48 кГц. Обратите внимание на то, что для этой опции может понадобиться несколько дополнительных байтов в блоке PADDING, так как точный размер блока нельзя вычислить, пока не будут обработаны все файлы.
Обратите внимание на то, что эту возможность нельзя использовать при кодировании в стандартный вывод.

`--cuesheet=ИМЯ_ФАЙЛА`

Импортировать указанный список разбиения аудиодиска и сохранить его в блоке метаданных CUESHEET. Эту опцию можно использовать только при кодировании одного файла. Точки поиска будут добавлены для каждого трека из списка в блок SEEKTABLE, если не будет указана опция `--no-cued-seekpoints`.
Файл списка разбиения аудиодиска должен иметь такой же вид, в каком его создают программы CDRwin, CDRcue, EAC и т.д

`--sector-align`

При кодировании нескольких WAVE файлов, полученных с аудиодиска, выравнивать их на границу сектора. Эта опция применима только для кодирования нескольких WAVE файлов, каждый из которых должен иметь частоту дискретизации 44.1 кГц и два канала. Если будет указана эта опция кодер выровняет потоки .flac так, что их длины будут кратны размеру сектора CD-Audio (равны 1/75 секундам или 588 сэмплам). Это осуществляется переносом части сектора в конце каждого WAVE файла в начало следующего. Последний поток будет дополнен до границы выравнивания нулями.

Использование этой опции не приведет ни к чему, если файлы уже выровнены (например, если правильно скопированы с аудиодиска). `flac` может выровнять только несколько файлов за один вызов.

ВНИМАНИЕ: Порядок файлов имеет значение! Если вы сделаете следующий вызов '`flac --sector-align *.wav`', командный процессор может обработать шаблон не в том порядке, в каком вы рассчитываете. Поэтому лучше всего вызывать программу, явно указав список файлов, например, '`flac --sector-align 8.wav 9.wav 10.wav`'.

`-S {#|X|#x|#s}`,
`--seekpoint={#|X|#x|#s}`

Добавляет точки для поиска в таблицу `SEEKTABLE`.

- `#` : создается точка поиска для сэмпла с определенным номером.
- `X` : резервируемые точки (всегда помещаются в конце `SEEKTABLE`).
- `#x` : # равномерно распределенных точек поиска, первая соответствует 0 сэмплу.
- `#s` : точки поиски расставляются для каждых # секунд; номер не обязательно должен быть целым числом, например, `-S 9.5s` ознчает, что точки будут проставлены с промежутком 9.5 секунд

Опцию `-S` можно использовать несколько раз. В результате получится объединенная таблица, в которой будут присутствовать только уникальные значения.
По умолчанию `flac` использует `-S 10s`. Если таблица поиска не нужна, укажите `-S-`.
ПРИМЕЧАНИЕ: `-S #x` и `-S #s` не будут работать, если кодер не сможет определить размер входного файла в начале работы.
ПРИМЕЧАНИЕ: если # больше или равен количеству сэмплов во входном файле, то точки добавлены не будут, если размер можно определить до кодирования, в противном случае будут записаны резервируемые точки.

`-P #`, `--padding`

Кодер запишет блок метаданных `PADDING`, указанного размера (в байтах), после блока `STREAMINFO`. Ключ `--no-padding` указывает, что блок `PADDING` не нужен (значение по умолчанию). Этот блок полезен, если вы собираетесь добавить тэг в файл позже. Вместо того, чтобы переписывать файл полностью, можно будет записать информацию вместо блока `PADDING`. Обратите внимание на то, что общий размер блока `PADDING` будет на 4 байта больше, так как 4 байта занимает заголовок.

`-T ПОЛЕ=ЗНАЧЕНИЕ`, `--tag=ПОЛЕ=ЗНАЧЕНИЕ`

Добавляет комментарии Vorbis, который должен соответствовать спецификации, т.е. ПОЛЕ должно содержать только определенные символы, завершающиеся знаком равенства. При необходимости не забывайте заключать комментарий в кавычки. Эту опцию можно использовать неоднократно для заполнения разных полей комментария. Все указанные значения будут применены ко всем кодируемым файлам.

`-b #`, `--blocksize` | Устанавливает размер блока в сэмплах. По умолчанию `1152` для `-l 0`, иначе `4608`. Стандартные потоки должны использовать одно из указаных значений: `192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768`. Сейчас кодер использует постоянный размер блока для всего файла.
`-m`, `--mid-side` | Включает разностное кодирование (только для стерео потоков). Обычно увеличивает уровень сжатия на несколько процентов. Для каждого блока создается усредненная и стерео версия блока, сохраняется блок меньшего размера. Сейчас разностное кодирование доступно для файлов, где сэмпл имеет размер не больше 16 бит.
`-M`, `--adaptive-mid-side` | Включает адаптивное разностное кодирование (только для стерео потоков). Работает аналогично `-m`, однако кодер переключается между независимым и усредняющим кодированием адаптивно. Метод работает быстрее, но уровень сжатия меньше, так как `-m` производит полный перебор вариантов.
`-0..-8` | Быстрейшее сжатие ... максимальное сжатие. По умолчанию `-5`.
`-0`, `--compression-level-0` | Аналогично `-l 0 -b 1152 -r 2,2`.
`-1`, `--compression-level-1` | Аналогично `-l 0 -b 1152 -r 2,2 -M`.
`-2`, `--compression-level-2` | Аналогично `-l 0 -b 1152 -r 3 -m`.
`-3`, `--compression-level-3` | Аналогично `-l 6 -b 4608 -r 3,3`
`-4`, `--compression-level-4` | Аналогично `-l 8 -b 4608 -r 3,3 -M`.
`-5`, `--compression-level-5` | Аналогично `-l 8 -b 4608 -r 3,3 -m`.
`-6`, `--compression-level-6` | Аналогично `-l 8 -b 4608 -r 4 -m`.
`-7`, `--compression-level-7` | Аналогично `-l 8 -b 4608 -r 6 -m -e`.
`-8`, `--compression-level-8` | Аналогично `-l 12 -b 4608 -r 6 -m -e`.
`--fast` | Быстрейшее сжатие. Аналогично `-0`.
`--best` | Максимальное сжатие. Аналогично `-8`.
`-e`, `--exhaustive-model-search` | Полный поиск модели (работает медленно!). Обычно кодер определяет лучшую модель и кодирует далее опираясь на нее. В данном режиме кодер будет создавать подфреймы всех порядков и использовать наименьший. Если максимальное значение порядка LPC велико, время кодирования существенно возрастет. Выигрыш обычно составляет около 0.5%.
`-E`, `--escape-coding` | Использовать управляющие коды в кодере энтропии. Эта опция позволяет записывать незакодированное представление остатка в разделе, если его размер меньше. При этом время работы увеличивается, а уровень сжатия обычно улучшается примерно на 1%.
`-l #`, `--max-lpc-order=#` | Определяет максимальный порядок LPC (коэффициентов линейного прогнозирования). Число должно быть меньше или равно `32`. Если значение равно `0`, кодер будет использовать вместо общего линейного прогнозирования постоянные коэффициенты. Этот метод увеличивает скорость работы, но файлы получаются на 5-10% больше.
`-q #`, `--qlp-coeff-precision=#` | Определяет точность дискретных коэффициентов линейного прогнозирования в битах. По умолчанию `-q 0`, что позволяет кодеру принимать решение в зависимости от сигнала. Лучше оставлять значение по умолчанию.
`-p`, `--qlp-coeff-precision-search` | Производить оптимизацию LPC. Переопределяет любую опцию `-q`. Сильно замедляет работу, и уменьшает размер файла на долю процента. `-q` не работает, когда используется `-l 0`.

`-r [#,]#`,
`--rice-partition-order=[#,]#`

Установить [min,]max порядок раздела. Если минимальное значение не указано, то оно устанавливается равным 0. По умолчанию кодер один параметр Райса для всего остатка подфрейма. Если использовать эту опцию, остаток будет разделяться на 2^min# ... 2^max частей, для каждой из которых будет определен собственный параметр Райса. С увеличением параметра max выигрыш будет все меньше. Наиболее оптимальный вариант достигается при использовании `-r 2,2` (и больших значений для больших размеров блоков). При этом сжатие обычно увеличивается на 1.5%. Выбор оптимального значения можно произвести по формуле `размер_блока/(2^n)=128`. Максимальный уровень сжатия достигается при использовании `-r 0,16`.

#### Настройки формата

`--endian={big|little}` | Определяет порядок байтов в файле без заголовка big-endian | little-endian.
`--channels=#` | Определяет количество каналов в файле без заголовка.
`--bps=#` | Определяет количество бит на сэмпл в файле без заголовка.
`--sample-rate=#` | Определяет количество сэмплов в секунду в файле без заголовка.
`--sign={signed|unsigned}` | Определяет, должны ли быть сэмплы в файле без заголовка беззнаковые или знаковые (по умолчанию знаковые).
`--force-aiff-format` | Декодер будет записывать в формат AIFF. Эта опция не нужна, если имя выходного файла (указанное с помощью ключа `-o`) заканчиватся на .aiff.
`--force-raw-format` | Воспринимать входной (или выходной при декодировании) файл как поток сэмплов без заголовка вне зависимости от суффикса.

#### Отмена действия опций

`--no-adaptive-mid-side` `--no-decode-through-errors` `--no-delete-input-file` `--no-escape-coding` `--no-exhaustive-model-search` `--no-lax` `--no-mid-side` `--no-ogg` `--no-padding` `--no-qlp-coeff-precision-search` `--no-residual-gnuplot` `--no-residual-text` `--no-sector-align` `--no-seektable` `--no-silent` `--no-verify` | Можно использовать для отключения действия конкретной опции.

### `metaflac`

`metaflac` - это редактор метаданных, работающий из командной строки. Его можно использовать для удаления, вставки и вывода содержимого блоков во .flac файле, а также управления блоком`PADDING`, резервирующим место.

Документация для `metaflac` в формате HTML сейчас переписывается, поэтому сейчас о возможностях можно узнать, дав команду `metaflac --help` или ознакомиться со man-страницей.

### Плагин для XMMS

Для его установки необходимо скопировать `libxmms-flac.so` в каталог, где находятся плагины ввода XMMS (обычно `/usr/lib/xmms/Input`). Больше ничего настраивать не надо. Для воспроизведения .flac файлов перезапустите XMMS.

### Плагин для Winamp

Есть два плагина для Winamp: один для версий 2.x, а второй для 3.x. Если вы используете Winamp 2.x, то для установки плагина необходимо скопировать `in_flac.dll` в каталог, где находятся плагины ввода Winamp (обычно `/Plugins`). Больше ничего настраивать не надо. Для воспроизведения .flac файлов перезапустите Winamp.

### Плагин для Winamp

Есть два плагина для Winamp: один для версий 2.x, а второй для 3.x. Если вы используете Winamp 3.x, то для установки плагина необходимо скопировать `cnv_flacpcm.wac` в каталог, где находятся плагины ввода Winamp (обычно `/Wacs`). Больше ничего настраивать не надо. Для воспроизведения .flac файлов перезапустите Winamp.

### Известные ошибки

Отслеживание ошибок ведется на этой странице проекта, находящейся на SourceForge. Если Вы будете сообщать об ошибке, пожалуйста, оставьте e-mail для контакта.

Ниже перечислены известные ошибки в текущей версии (1.1.0):

> - Нет известных ошибок.

В версии 1.0.4 были следующие значимые ошибки:

> - Во всех декодерах до этой версии включительно была ошибка не позволяющая правильно пропускать неизвестные блоки метаданных. Файл FLAC, созданный кодером flac 1.1.0 и содержащий блок метаданных CUESHEET, не будет воспроизводиться более ранними версиями декодеров.
> - В `metaflac` была ошибка, возникающая при импортировании комметария в формате Vorbis, которая могла привести к повреждению файла FLAC.

### monkey

Monkey's Audio поставляется с удобным пользовательским интерфейсом. Он поддерживает несколько внешних кодеров, в число которых не входит FLAC. Однако дистрибутив FLAC для Windows поставляется с утилитой, позволяющей заменить один из поддерживаемых внешних кодеков на FLAC. Это можно сделать так:

- Скопируйте `flac.exe` и `flac_ren.exe` в каталог `External/` установки Monkey's Audio.
- Выберите, какой поддерживаемый кодер заменить:
  - Shorten - скопируйте `flac_mac.exe` поверх `External/shortn32.exe`
  - WavPack - скопируйте `flac_mac.exe` поверх `External/wavpack.exe` и `External/wvunpack.exe`
  - RKAU - скопируйте `flac_mac.exe` поверх `External/rkau.exe`
  Если выбрать WavPack, то для изменения опций FLAC будет доступно меню настройки WavPack Configuration.
- Теперь можно кодировать в формат FLAC. Переименованный файл `flac_mac.exe` вызывает `flac.exe`, а затем `flac_ren.exe` для присвоения получаемому файлу расширения .flac.

Другие оболочки можно использовать примерно таким же способом.

Copyright (c) 2000,2001,2002,2003 Josh Coalson