From 4b63197c8ca3c721b08b7c58d27ee3f147270dc8 Mon Sep 17 00:00:00 2001
From: Andrey Astafiev
Date: Fri, 7 Jun 2002 10:01:36 +0000
Subject: [PATCH] near 1.0.3
---
doc/ru/documentation.html | 27 ++++++++++++++++-----------
doc/ru/format.html | 23 ++++++++++++++++++++---
doc/ru/index.html | 16 ----------------
doc/ru/links.html | 15 ++++++++-------
4 files changed, 44 insertions(+), 37 deletions(-)
diff --git a/doc/ru/documentation.html b/doc/ru/documentation.html
index 95091d0..0e552a6 100644
--- a/doc/ru/documentation.html
+++ b/doc/ru/documentation.html
@@ -171,7 +171,7 @@
- Êîäèðîâàíèå:
flac [-s] [--skip #] [<íàñòðîéêè_ôîðìàòà>] [<îïöèè_êîäèðîâàíèÿ>] [âõîäíîé_ôàéë [...]]
- - Äåêîäèðîâàíèå:
flac -d [-s] [--skip #] [<íàñòðîéêè_ôîðìàòà>] [<îïöèè_êîäèðîâàíèÿ>] [âõîäíîé_ôàéë [...]]
+ - Äåêîäèðîâàíèå:
flac -d [-s] [--skip #] [-F] [<íàñòðîéêè_ôîðìàòà>] [<îïöèè_êîäèðîâàíèÿ>] [âõîäíîé_ôàéë [...]]
- Òåñòèðîâàíèå:
flac -t [-s] [âõîäíîé_ôàéë [...]]
@@ -251,6 +251,15 @@
Ñîçäàåò ôàéëû-äèàãðàììû äëÿ êàæäîãî ïîäôðåéìà.  êàæäîì ôàéëå áóäåò îñòàòî÷íîå ðàñïðåäåëåíèå äëÿ ïîäôðåéìà. Áóäåò ñîçäàíî î÷åíü ìíîãî ôàéëîâ. |
+
+-F |
+Ïî óìîë÷àíèþ flac ïðåêðàùàåò äåêîäèðîâàíèå
+â ñëó÷àå îøèáêè â ïîòîêå è óäàëÿåò ÷àñòè÷íî äåêîäèðîâàííûé ôàéë.
+Èñïîëüçîâàíèå êëþ÷à -F âåäåò ê òîìó, ÷òî ñîîáùåíèÿ îá îøèáêàõ
+âûâîäÿòñÿ, íî flac ïðîäîëæàåò ðàáîòó äî êîíöà.
+Îáðàòèòå âíèìàíèå, ÷òî â ðåçóëüòàòå òàêîãî äåêîäèðîâàíèÿ â âûõîäíîì ôàéëå
+ìîãóò áûòü ïðîïóùåíû ñýìïëû èëè ïîÿâèòñÿ áëîêè òèøèíû. |
+
@@ -290,7 +299,7 @@
-P # |
-Eíêîäåð çàïèøåò áëîê ìåòàäàííûõ PADDING, óêàçàííîãî ðàçìåðà (â áàéòàõ), ïîñëå áëîêà STREAMINFO. -P 0 óêàçûâàåò, ÷òî áëîê PADDING íå íóæåí (çíà÷åíèå ïî óìîë÷àíèþ). Ýòîò áëîê ïîëåçåí, åñëè âû ñîáèðàåòåñü äîáàâèòü òýã â ôàéë ïîçæå. Âìåñòî òîãî, ÷òîáû ïåðåïèñûâàòü ôàéë ïîëíîñòüþ, ìîæíî áóäåò çàïèñàòü èíôîðìàöèþ âìåñòî áëîêà PADDING. |
+Eíêîäåð çàïèøåò áëîê ìåòàäàííûõ PADDING, óêàçàííîãî ðàçìåðà (â áàéòàõ), ïîñëå áëîêà STREAMINFO. Êëþ÷è -P 0 èëè -P- óêàçûâàþò, ÷òî áëîê PADDING íå íóæåí (çíà÷åíèå ïî óìîë÷àíèþ). Ýòîò áëîê ïîëåçåí, åñëè âû ñîáèðàåòåñü äîáàâèòü òýã â ôàéë ïîçæå. Âìåñòî òîãî, ÷òîáû ïåðåïèñûâàòü ôàéë ïîëíîñòüþ, ìîæíî áóäåò çàïèñàòü èíôîðìàöèþ âìåñòî áëîêà PADDING. Îáðàòèòå âíèìàíèå íà òî, ÷òî îáùèé ðàçìåð áëîêà PADDING áóäåò íà 4 áàéòà áîëüøå, òàê êàê 4 áàéòà çàíèìàåò çàãîëîâîê. |
-b # |
Óñòàíàâëèâàåò ðàçìåð áëîêà â ñýìïëàõ. Ïî óìîë÷àíèþ 1152 äëÿ -l 0, èíà÷å 4608. Ñòàíäàðòíûå ïîòîêè äîëæíû èñïîëüçîâàòü îäíî èç óêàçàíûõ çíà÷åíèé: 192/576/1152/2304/4608/256/512/1024/2048/4096/8192/16384/32768. Ñåé÷àñ åíêîäåð èñïîëüçóåò ïîñòîÿííûé ðàçìåð áëîêà äëÿ âñåãî ôàéëà. |
@@ -355,14 +364,11 @@
-r [#,]# |
Óñòàíîâèòü [min,]max ïîðÿäîê ðàçäåëà. Åñëè ìèíèìàëüíîå çíà÷åíèå íå óêàçàíî, òî îíî óñòàíàâëèâàåòñÿ ðàâíûì 0. Ïî óìîë÷àíèþ åíêîäåð îäèí ïàðàìåòð Ðàéñà äëÿ âñåãî îñòàòêà ïîäôðåéìà. Åñëè èñïîëüçîâàòü ýòó îïöèþ, îñòàòîê áóäåò ðàçäåëÿòüñÿ íà 2^min# ... 2^max ÷àñòåé, äëÿ êàæäîé èç êîòîðûõ áóäåò îïðåäåëåí ñîáñòâåííûé ïàðàìåòð Ðàéñà. Ñ óâåëè÷åíèåì ïàðàìåòðà max âûèãðûø áóäåò âñå ìåíüøå. Íàèáîëåå îïòèìàëüíûé âàðèàíò äîñòèãàåòñÿ ïðè èñïîëüçîâàíèè -r 2,2 (è áîëüøèõ çíà÷åíèé äëÿ áîëüøèõ ðàçìåðîâ áëîêîâ). Ïðè ýòîì ñæàòèå îáû÷íî óâåëè÷èâàåòñÿ íà 1.5%. Âûáîð îïòèìàëüíîãî çíà÷åíèÿ ìîæíî ïðîèçâåñòè ïî ôîðìóëå ðàçìåð_áëîêà/(2^n)=128. Ìàêñèìàëüíûé óðîâåíü ñæàòèÿ äîñòèãàåòñÿ ïðè èñïîëüçîâàíèè -r 0,16. |
--R # |
-Óñòàíîâèòü ïðåäåëû ïîèñêà ïàðàìåòðà Ðàéñà. Ïî óìîë÷àíèþ 0. Êîäåð îñòàòêîâ áóäåò èñêàòü íàèëó÷øèé ïàðàìåòð Ðàéñà â óêàçàííîì ïðåäåëå äëÿ êàæäîãî ðàçäåëà îñòàòêîâ. Èñïîëüçîâàíèå ýòîé îïöèè íå äàåò áîëüøîãî âûèãðûøà, íî ñèëüíî çàìåäëÿåò ðàáîòó.  ðåçóëüòàòå, îïöèè -0 ... -8 íå èñïîëüçóþò åå. |
-
-V |
Ïðîâåðÿòü ïðîöåññ ñæàòèÿ.  äàííîì ñëó÷àå flac ñîçäàåò ïàðàëëåëüíûé äåêîäåð, ðàñêîäèðóþùèé âûõîä åíêîäåðà è ñðàâíèâàåò ðåçóëüòàò ñ îðèãèíàëîì. Åñëè áóäåò íàéäåíî íåñîîòâåòñòâèå, êîäèðîâàíèå ïðåêðàòèòñÿ. Âðåìÿ ðàáîòû ñ ýòîé îïöèåé óâåëè÷èâàåòñÿ, îäíàêî, ïðè ýòîì ãàðàíòèðóåòñÿ, ÷òî ôàéë áóäåò ïðàâèëüíî äåêîäèðîâàí. |
|
--S-, -m-, -V-, -e-, -E-, -p-, --lax-, --delete-input-file-, --sector-align èñïîëüçóþòñÿ äëÿ îòêëþ÷åíèÿ ñîîòâåòñòâóþùèõ îïöèé. |
+-F-, -S-, -P-, -m-, -e-, -E-, -p-, -V-, --lax-, --delete-input-file-, --sector-align- èñïîëüçóþòñÿ äëÿ îòêëþ÷åíèÿ ñîîòâåòñòâóþùèõ îïöèé. |
@@ -460,8 +466,8 @@
- Îáðàòíûé âûçîâ äëÿ çàïèñè. Ýòà ôóíêöèÿ âûçûâàåòñÿ ïîñëå äåêîäèðîâàíèÿ îäíîãî ôðåéìà äàííûõ. Äåêîäåð ïåðåäàñò ìåòàäàííûå ôðåéìà, à òàêæå ìàññèâ óêàçàòåëåé (ïî îäíîìó íà êàæäûé êàíàë) íà äåêîäèðîâàííûå äàííûå.
- - Îáðàòíûé âûçîâ äëÿ ðàáîòû ñ ìåòàäàííûìè. Ôóíêöèÿ âûçûâàåòñÿ ïîñëå ðàçáîðà áëîêà ìåòàäàííûõ. Äëÿ ïîòîêà âñåãäà äîëæåí ñóùåñòâîâàòü áëîê ìåòàäàííûõ STREAMINFO, çà êîòîðûì ìîæåò ñëåäîâàòü ïðîèçâîëüíîå êîëè÷åñòâî äðóãèõ áëîêîâ. Îíè áóäóò âîçâðàùåíû äåêîäåðîì â òîì æå ïîðÿäêå, â êàêîì îíè ðàñïîëîæåíû â ïîòîêå è âñåãäà ïåðåä ïåðâûì àóäèî ôðåéìîì.
-
+ - Îáðàòíûé âûçîâ äëÿ ðàáîòû ñ ìåòàäàííûìè. Ôóíêöèÿ âûçûâàåòñÿ ïîñëå ðàçáîðà áëîêà ìåòàäàííûõ. Äëÿ ïîòîêà âñåãäà äîëæåí ñóùåñòâîâàòü áëîê ìåòàäàííûõ STREAMINFO, çà êîòîðûì ìîæåò ñëåäîâàòü ïðîèçâîëüíîå êîëè÷åñòâî äðóãèõ áëîêîâ. Îíè áóäóò âîçâðàùåíû äåêîäåðîì â òîì æå ïîðÿäêå, â êàêîì îíè ðàñïîëîæåíû â ïîòîêå è âñåãäà ïåðåä ïåðâûì àóäèî ôðåéìîì. Ïåðåäàííûé áëîê ìåòàäàííûõ íå äîëæåí èçìåíÿòüñÿ è íå ñîõðàíÿåòñÿ ïîñëå îáðàòíîãî âûçîâà, ïîýòîìó, åñëè îí áóäåò íóæåí â äàëüíåéøåì ñäåëàéòå åãî êîïèþ ñ ïîìîùüþ ôóíêöèè FLAC__metadata_object_copy().
+
- Îáðàòíûé âûçîâ äëÿ ñîîáùåíèÿ îá îøèáêå. Ýòà ôóíêöèÿ âûçûâàåòñÿ, åñëè ïðè äåêîäèðîâàíèè ïðîèñõîäèò îøèáêà.
@@ -543,7 +549,7 @@
seek_table (òàáëèöà äëÿ ïîèñêà) - ñîçäàòü íåîáÿçàòåëüíóþ òàáëèöó äëÿ ïîèñêà â ôàéëå. NULL óêàçûâàåò, ÷òî òàáëèöà íå íóæíà.
- padding (ðåçåðâèðîâàíèå ìåñòà) - ðàçìåð áëîêà PADDING (ñëåäóåò çà òàáëèöåé äëÿ ïîèñêà); 0 îçíà÷àåò, ÷òî áëîê PADDING äîáàâëÿòü íå íóæíî.
+ padding (ðåçåðâèðîâàíèå ìåñòà) - ðàçìåð áëîêà PADDING (ñëåäóåò çà òàáëèöåé äëÿ ïîèñêà); -1 îçíà÷àåò, ÷òî áëîê PADDING äîáàâëÿòü íå íóæíî. Ïîìíèòå, ÷òî óêàçûâàåòñÿ ðàçìåð äëÿ äàííûõ; îáùèé ðàçìåð áëîêà PADDING áóäåò íà 4 áàéòà áîëüøå èç-çà çàãîëîâêà.
Ïðîãðàììà äîëæíà ïðåäîñòàâèòü FLAC__stream_encoder_init() àäðåñà äëÿ ñëåäóþùèõ îáðàòíûõ âûçîâîâ:
@@ -585,8 +591,7 @@
Èçâåñòíûå îøèáêè
Îòñëåæèâàíèå îøèáîê âåäåòñÿ íà ýòîé ñòðàíèöå ïðîåêòà, íàõîäÿùåéñÿ íà SourceForge. Åñëè Âû áóäåòå ñîîáùàòü îá îøèáêå, ïîæàëóéñòà, îñòàâüòå e-mail äëÿ êîíòàêòà.
-
-
+
monkey
diff --git a/doc/ru/format.html b/doc/ru/format.html
index 95dc785..b517779 100644
--- a/doc/ru/format.html
+++ b/doc/ru/format.html
@@ -314,7 +314,8 @@
1 : PADDING
2 : APPLICATION
3 : SEEKTABLE
- 4-127 : çàðåçåðâèðîâàíû
+ 4 : VORBIS_COMMENT
+ 5-127 : çàðåçåðâèðîâàíû
@@ -334,13 +335,12 @@
- ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_STREAMINFO || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_PADDING || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_APPLICATION || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_SEEKTABLE |
+ ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_STREAMINFO || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_PADDING || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_APPLICATION || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_SEEKTABLE || ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_VORBIS_COMMENT |
Ñîäåðæèìîå áëîêà äîëæíî ñîîòâåòñòâîâàòü òèïó áëîêà, óêàçàííîìó â çàãîëîâêå |
-
@@ -492,8 +492,25 @@
+
+
+
+
+
+
+
+
+ ÁËÎÊ_ÌÅÒÀÄÀÍÍÛÕ_VORBIS_COMMENT |
+
+
+
+ <n> |
+ Ñîäåðæèìîå êîììåòàðèÿ â ôîðìàòå Vorbis, êàê îíî îïèñàíî çäåñü. Îáðàòèòå âíèìàíèå íà òî, ÷òî ñïåöèôèêàöèÿ Vorbis îãðàíè÷èâàåò ðàçìåð ýòîãî áëîêà 2 ^ 64 áàéòàìè, â òî âðåìÿ êàê áëîê ìåòàäàííûõ FLAC ìîæåò èìåòü ðàçìåð íå áîëüøå 2 ^ 24 áàéòîâ.  ñîîòâåòñòâèè ñî ñïåöèôèêàöèåé Vorbis 32-áèòíûå äàííûå little-endian coded, â îòëè÷èå îò big-endian coding öåëûõ, èñïîëüçóåìûõ â îñòàëüíûõ ìåñòàõ FLAC. |
+
+
+
diff --git a/doc/ru/index.html b/doc/ru/index.html
index f4b3f66..4504a69 100644
--- a/doc/ru/index.html
+++ b/doc/ru/index.html
@@ -113,22 +113,6 @@
Åñëè ó âàñ åñòü ïðèëîæåíèå, èñïîëüçóþùåå FLAC, è âû õîòèòå, ÷òîáû îíî ðàáîòàëî ñ äîáàâëÿåìûìè â ôàéë ìåòàäàííûìè, çàéäèòå íà ñòðàíèöó ðåãèñòðàöèè è çàðåçåðâèðóéòå äëÿ íåãî èäåíòèôèêàòîð.
-
-Îò àâòîðà
-
-ß ðàçðàáîòàë FLAC, ïîòîìó ÷òî íå ñìîã íàéòè íè îäíîãî ôîðìàòà ñæàòèÿ àóäèî, êîòîðûé ïîäõîäèë áû äëÿ ìåíÿ. Ïîðàáîòàâ ñ íèìè, ÿ âûðàáîòàë îñíîâíûå òðåáîâàíèÿ (ñòàâøèå öåëüþ ïðîåêòà) è íàïèñàë ïåðâóþ ðåàëèçàöèþ. ß ñðàçó æå ðåøèë ñäåëàòü ôîðìàò îòêðûòûì ïî äâóì ïðè÷èíàì: 1) ëþäè, çíàþùèå áîëüøå î ñæàòèè çâóêà áåç ïîòåðü, ñìîãóò ïîìî÷ü ìíå â ðàáîòå è 2) õîòåëîñü äàòü ÷òî-íèáóäü êîìïüþòåðíîìó ñîîáùåñòâó, ÷üèìè ðàçðàáîòêàìè ÿ ïîëüçóþñü.
-
-ß ïåðåíåñ ïðîåêò FLAC íà SourceForge, êàê òîëüêî ñäåëàë ïåðâóþ îòíîñèòåëüíî ïîëíóþ ðåàëèçàöèþ. ß ÿâëÿþñü ãëàâíûì ëèöîì â ïðîåêòå. Âû ìîæåòå ñâÿçàòüñÿ ñî ìíîé ÷åðåç ôîðóì èëè îòïðàâèâ ïèñüìî ìíå ëè÷íî.
-
---Josh Coalson
-
-
-Îò ïåðåâîä÷èêà
-
-Ïî ìåðå ñèë ÿ áóäó ñòàðàòüñÿ ïîääåðæèâàòü ïåðåâîä äîêóìåíòàöèè ïðîåêòà. Ñîîáùàéòå, ïîæàëóéñòà, îáî âñåõ îøèáêàõ, íåòî÷íîñòÿõ, çàìå÷àíèÿõ ïî ñòèëèñòèêå, òåðìèíîëîãèè.
-
-Àñòàôüåâ Àíäðåé
-
Copyright (c) 2000,2001,2002 Josh Coalson