AuroraMiddleware/flac
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

near 1.0.3

Browse Source
This commit is contained in:
Andrey Astafiev 2002-06-07 10:01:36 +00:00
parent b5988941cc
commit 4b63197c8c
4 changed files with 44 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/ru/documentation.html
View File

@ -171,7 +171,7 @@
<BLOCKQUOTE><UL>
<LI>Кодирование:<BR><TT>flac [-s] [--skip #] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [входной_файл [...]]</TT></LI>
<LI>Декодирование:<BR><TT>flac -d [-s] [--skip #] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [входной_файл [...]]</TT></LI>
<LI>Декодирование:<BR><TT>flac -d [-s] [--skip #] [-F] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [входной_файл [...]]</TT></LI>
<LI>Тестирование:<BR><TT>flac -t [-s] [входной_файл [...]]</TT></LI>
@ -251,6 +251,15 @@
<TD width=90%>Создает файлы-диаграммы для каждого подфрейма. В каждом файле будет остаточное распределение для подфрейма. Будет создано <B>очень много</B> файлов.</TD></TR>
</TABLE>
<H4><a name="decoding_options">Опции декодирования</H4>
<TR><TD width=15%><TT>-F</TT></TD>
<TD width=85%>По умолчанию <B><TT>flac</TT></B> прекращает декодирование
в случае ошибки в потоке и удаляет частично декодированный файл.
Использование ключа <TT>-F</TT> ведет к тому, что сообщения об ошибках
выводятся, но <B><TT>flac</TT></B> продолжает работу до конца.
Обратите внимание, что в результате такого декодирования в выходном файле
могут быть пропущены сэмплы или появится блоки тишины.</TD></TR>
</TABLE>
<H4><a name="encoding_options">Опции кодирования</A></H4>
<TABLE border=1>
@ -290,7 +299,7 @@
</TD></TR>
<TR><TD><TT>-P #</TT></TD>
<TD>Eнкодер запишет блок метаданных <TT>PADDING</TT>, указанного размера (в байтах), после блока <TT>STREAMINFO</TT>. <TT>-P 0</TT> указывает, что блок <TT>PADDING</TT> не нужен (значение по умолчанию). Этот блок полезен, если вы собираетесь добавить тэг в файл позже. Вместо того, чтобы переписывать файл полностью, можно будет записать информацию вместо блока <TT>PADDING</TT>.</TD></TR>
<TD>Eнкодер запишет блок метаданных <TT>PADDING</TT>, указанного размера (в байтах), после блока <TT>STREAMINFO</TT>. Ключи <TT>-P 0</TT> или <TT>-P-</TT> указывают, что блок <TT>PADDING</TT> не нужен (значение по умолчанию). Этот блок полезен, если вы собираетесь добавить тэг в файл позже. Вместо того, чтобы переписывать файл полностью, можно будет записать информацию вместо блока <TT>PADDING</TT>. Обратите внимание на то, что общий размер блока <TT>PADDING</TT> будет на 4 байта больше, так как 4 байта занимает заголовок.</TD></TR>
<TR><TD><TT>-b #</TT></TD>
<TD>Устанавливает размер блока в сэмплах. По умолчанию <TT>1152</TT> для <TT>-l 0</TT>, иначе <TT>4608</TT>. Стандартные потоки должны использовать одно из указаных значений: <TT>192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768</TT>. Сейчас енкодер использует постоянный размер блока для всего файла.</TD></TR>
@ -355,14 +364,11 @@
<TR><TD><TT>-r [#,]#</TT></TD>
<TD>Установить <I>[min,]max</I> порядок раздела. Если минимальное значение не указано, то оно устанавливается равным 0. По умолчанию енкодер один параметр Райса для всего остатка подфрейма. Если использовать эту опцию, остаток будет разделяться на <I>2^min#</I> ... <I>2^max</I> частей, для каждой из которых будет определен собственный параметр Райса. С увеличением параметра <I>max</I> выигрыш будет все меньше. Наиболее оптимальный вариант достигается при использовании <TT>-r 2,2</TT> (и больших значений для больших размеров блоков). При этом сжатие обычно увеличивается на 1.5%. Выбор оптимального значения можно произвести по формуле <TT>размер_блока/(2^n)=128</TT>. Максимальный уровень сжатия достигается при использовании <TT>-r 0,16</TT>.</TD></TR>
<TR><TD><TT>-R #</TT></TD>
<TD>Установить пределы поиска параметра Райса. По умолчанию 0. Кодер остатков будет искать наилучший параметр Райса в указанном пределе для каждого раздела остатков. Использование этой опции не дает большого выигрыша, но сильно замедляет работу. В результате, опции <TT>-0</TT> ... <TT>-8</TT> не используют ее.</TD></TR>
<TR><TD><TT>-V</TT></TD>
<TD>Проверять процесс сжатия. В данном случае <B><TT>flac</TT></B> создает параллельный декодер, раскодирующий выход енкодера и сравнивает результат с оригиналом. Если будет найдено несоответствие, кодирование прекратится. Время работы с этой опцией увеличивается, однако, при этом гарантируется, что файл будет правильно декодирован.</TD></TR>
<TR><TD>&nbsp;</TD>
<TD><TT>-S-</TT>, <TT>-m-</TT>, <TT>-V-</TT>, <TT>-e-</TT>, <TT>-E-</TT>, <TT>-p-</TT>, <TT>--lax-</TT>, <TT>--delete-input-file-</TT>, <TT>--sector-align</TT> используются для отключения соответствующих опций.</TD></TR>
<TD><TT>-F-</TT>, <TT>-S-</TT>, <TT>-P-</TT>, <TT>-m-</TT>, <TT>-e-</TT>, <TT>-E-</TT>, <TT>-p-</TT>, <TT>-V-</TT>, <TT>--lax-</TT>, <TT>--delete-input-file-</TT>, <TT>--sector-align-</TT> используются для отключения соответствующих опций.</TD></TR>
</TABLE>
@ -460,8 +466,8 @@
<LI>Обратный вызов для записи. Эта функция вызывается после декодирования одного фрейма данных. Декодер передаст метаданные фрейма, а также массив указателей (по одному на каждый канал) на декодированные данные.</LI>
<LI>Обратный вызов для работы с метаданными. Функция вызывается после разбора блока метаданных. Для потока всегда должен существовать блок метаданных <TT>STREAMINFO</TT>, за которым может следовать произвольное количество других блоков. Они будут возвращены декодером в том же порядке, в каком они расположены в потоке и всегда перед первым аудио фреймом.</LI>
<LI>Обратный вызов для работы с метаданными. Функция вызывается после разбора блока метаданных. Для потока всегда должен существовать блок метаданных <TT>STREAMINFO</TT>, за которым может следовать произвольное количество других блоков. Они будут возвращены декодером в том же порядке, в каком они расположены в потоке и всегда перед первым аудио фреймом. Переданный блок метаданных не должен изменяться и не сохраняется после обратного вызова, поэтому, если он будет нужен в дальнейшем сделайте его копию с помощью функции <TT>FLAC__metadata_object_copy()</TT>.</LI>
<LI>Обратный вызов для сообщения об ошибке. Эта функция вызывается, если при декодировании происходит ошибка.</LI>
</UL>
@ -543,7 +549,7 @@
<LI><B><TT>seek_table</TT></B> (таблица для поиска) - создать необязательную таблицу для поиска в файле. <TT>NULL</TT> указывает, что таблица не нужна.</LI>
<LI><B><TT>padding</TT></B> (резервирование места) - размер блока <TT>PADDING</TT> (следует за таблицей для поиска); <TT>0</TT> означает, что блок <TT>PADDING</TT> добавлять не нужно.</LI>
<LI><B><TT>padding</TT></B> (резервирование места) - размер блока <TT>PADDING</TT> (следует за таблицей для поиска); <TT>-1</TT> означает, что блок <TT>PADDING</TT> добавлять не нужно. Помните, что указывается размер для данных; общий размер блока PADDING будет на 4 байта больше из-за заголовка.</LI>
</UL>
<P>Программа должна предоставить <TT>FLAC__stream_encoder_init()</TT> адреса для следующих обратных вызовов:</TT>
@ -585,8 +591,7 @@
<H3>Известные ошибки</H3>
<P>Отслеживание ошибок ведется на <A HREF="http://sourceforge.net/bugs/?group_id=13478">этой</A> странице проекта, находящейся на SourceForge. Если Вы будете сообщать об ошибке, пожалуйста, оставьте e-mail для контакта.</P>
<A NAME="monkey">
<H3>monkey</H3>

23
doc/ru/format.html
View File

@ -314,7 +314,8 @@
<LI>1 : <TT>PADDING</TT></LI>
<LI>2 : <TT>APPLICATION</TT></LI>
<LI>3 : <TT>SEEKTABLE</TT></LI>
<LI>4-127 : 玎疱珏疴桊钼囗<E992BC></LI>
<LI>4 : <TT>VORBIS_COMMENT</TT></LI>
<LI>5-127 : çàðåçåðâèðîâàíû</LI>
</UL>
</TD>
</TR>
@ -334,13 +335,12 @@
</TR>
<TR>
<TD VALIGN="TOP"><A HREF="format.html#metadata_block_streaminfo"><TT>了问_膛依睦屯壅_STREAMINFO</TT></A> || <A HREF="format.html#metadata_block_padding"><TT>了问_膛依睦屯壅_PADDING</TT></A> || <A HREF="format.html#metadata_block_application"><TT>了问_膛依睦屯壅_APPLICATION</TT></A> || <A HREF="format.html#metadata_block_seektable"><TT>了问_膛依睦屯壅_SEEKTABLE</TT></A></TD>
<TD VALIGN="TOP"><A HREF="format.html#metadata_block_streaminfo"><TT>ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_STREAMINFO</TT></A> || <A HREF="format.html#metadata_block_padding"><TT>ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_PADDING</TT></A> || <A HREF="format.html#metadata_block_application"><TT>ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_APPLICATION</TT></A> || <A HREF="format.html#metadata_block_seektable"><TT>ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_SEEKTABLE</TT></A> || <A HREF="#metadata_block_vorbis_comment"><TT>ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_VORBIS_COMMENT</TT></A></TD>
<TD>Ñîäåðæèìîå áëîêà äîëæíî ñîîòâåòñòâîâàòü òèïó áëîêà, óêàçàííîìó â çàãîëîâêå</TD>
</TR>
</TABLE></P>
<P><TABLE WIDTH="100%" BORDER="1">
<TR>
@ -492,8 +492,25 @@
</UL>
</TD>
</TR>
</TABLE></P>
<P><TABLE WIDTH="100%" BORDER="1">
<TR>
<TD COLSPAN="2" BGCOLOR="#E0E0E0"><A NAME="metadata_block_vorbis_comment"><FONT SIZE="+2"><B><TT>ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_VORBIS_COMMENT</TT></B></FONT></A></TD>
</TR>
<TR>
<TD VALIGN="TOP">&lt;n&gt;</TD>
<TD>Ñîäåðæèìîå êîììåòàðèÿ â ôîðìàòå Vorbis, êàê îíî îïèñàíî <A HREF="http://www.xiph.org/ogg/vorbis/doc/v-comment.html">çäåñü</A>. Îáðàòèòå âíèìàíèå íà òî, ÷òî ñïåöèôèêàöèÿ Vorbis îãðàíè÷èâàåò ðàçìåð ýòîãî áëîêà 2 ^ 64 áàéòàìè, â òî âðåìÿ êàê áëîê ìåòàäàííûõ FLAC ìîæåò èìåòü ðàçìåð íå áîëüøå 2 ^ 24 áàéòîâ.  ñîîòâåòñòâèè ñî ñïåöèôèêàöèåé Vorbis 32-áèòíûå äàííûå little-endian coded, â îòëè÷èå îò big-endian coding öåëûõ, èñïîëüçóåìûõ â îñòàëüíûõ ìåñòàõ FLAC.</TD>
</TR>
</TABLE></P>
<P><TABLE WIDTH="100%" BORDER="1">

16
doc/ru/index.html
View File

@ -113,22 +113,6 @@
<P>Если у вас есть приложение, использующее FLAC, и вы хотите, чтобы оно работало с добавляемыми в файл метаданными, зайдите на <A HREF="id.html">страницу</A> регистрации и зарезервируйте для него идентификатор.</P>
<H3>От автора</H3>
<P>Я разработал FLAC, потому что не смог найти ни одного формата сжатия аудио, который подходил бы для меня. Поработав с ними, я выработал основные требования (ставшие <A HREF="goals.html">целью</A> проекта) и написал первую реализацию. Я сразу же решил сделать формат открытым по двум причинам: 1) люди, знающие больше о сжатии звука без потерь, смогут помочь мне в работе и 2) хотелось дать что-нибудь компьютерному сообществу, чьими разработками я пользуюсь.</P>
<P>Я перенес проект FLAC на SourceForge, как только сделал первую относительно полную реализацию. Я являюсь главным лицом в проекте. Вы можете связаться со мной через <A HREF="http://sourceforge.net/mail/?group_id=13478">форум</A> или отправив письмо <A HREF="mailto:jcoalson@users.sourceforge.net">мне лично</A>.</P>
<P>--Josh Coalson</P>
<H3>От переводчика</H3>
<P>По мере сил я буду стараться поддерживать перевод документации проекта. <A HREF="mailto:andrei@altlinux.ru">Сообщайте</A>, пожалуйста, обо всех ошибках, неточностях, замечаниях по стилистике, терминологии.</P>
<P>Астафьев Андрей</P>
<P>&nbsp;Copyright (c) 2000,2001,2002 Josh Coalson</P>
</BODY>

15
doc/ru/links.html
View File

@ -88,9 +88,10 @@
</UL></BLOCKQUOTE></P>
<P>Ďđîăđŕěěű, čńďîëüçóţůčĺ FLAC:</P>
<P><BLOCKQUOTE><UL>
<LI><A HREF="http://lly.org/~rcw/abcde/misc/abcde-flac.tar.gz">Ďŕň÷</A> äë˙ <A HREF="http://lly.org/~rcw/abcde/page/">abcde</A> (A Better CD Encoder)</LI>
<LI><A HREF="http://www.bagu.dhs.org/flac.html">Ďŕň÷</A> äë˙ <A
HREF="http://lly.org/~rcw/abcde/page/">abcde</A> (A Better CD Encoder)</LI>
<LI>Đĺäŕęňîđ ňĺăîâ <A HREF="http://easytag.sourceforge.net/">EasyTAG</A></LI>
<LI><A HREF="http://home.wanadoo.nl/~w.speek/flac.htm">FLAC frontend</A> (Windows GUI)</LI>
@ -103,15 +104,15 @@
<LI><A HREF="http://mediaxw.sourceforge.net/">MediaXW</A> âęëţ÷ŕĺň ôčëüňđ FLAC DirectShow</LI>
<LI><A HREF="http://rawrec.sourceforge.net/">rawrec/rawplay</A> óňčëčňű äë˙ çŕďčńč č âîńďđîčçâĺäĺíč˙</LI>
<LI><A HREF="http://www.lammerts.org/software/soepkiptng/">Soepkip TNG</A> ďëĺéĺđ, óďđŕâë˙ĺěűé ÷ĺđĺç web-číňĺđôĺéń</LI>
<LI><A HREF="http://rip.sourceforge.net/">rip</A> ęîíńîëüíűé ĺíęîäĺđ</LI>
<LI><A HREF="http://rip.sourceforge.net/">rip</A> ęîíńîëüíŕ˙ óňčëčňŕ äë˙ ęîďčđîâŕíč˙ CD Audio č ńćŕňč˙ ôŕéëîâ</LI>
<LI><A HREF="http://www.icculus.org/SDL_sound/">SDL_sound</A> ŕóäčî ěîäóëü äë˙ SDL</LI>
<LI><A HREF="http://shnutils.etree.org/shntool/">shntool</A><BR></FONT></SMALL></TD></TR>
<LI><A HREF="http://www.lammerts.org/software/soepkiptng/">Soepkip TNG</A> ďëĺéĺđ, óďđŕâë˙ĺěűé ÷ĺđĺç web-číňĺđôĺéń</LI>
<LI><A HREF="http://www.cyclooctane.com/sonice/">sonice</A>: ďđĺîáđŕçîâŕíčĺ FLAC â Vorbis</LI>
</UL></BLOCKQUOTE></P>