مثال‌های کدگذاری (Encoding examples)

flac abc.wav

کدگذاری abc.wav به abc.flac با استفاده از تنظیم فشرده‌سازی پیش‌فرض. فایل abc.wav حذف نمی‌شود.

flac --delete-input-file abc.wav

مانند بالا، با این تفاوت که در صورت نبود هیچ خطایی، abc.wav حذف می‌شود.

flac --delete-input-file -w abc.wav

مانند بالا، با این تفاوت که در صورت نبود هیچ خطا یا هشداری، abc.wav حذف می‌شود.

flac --best abc.wav یا flac -8 abc.wav

کدگذاری abc.wav به abc.flac با استفاده از بالاترین پیش‌تنظیم فشرده‌سازی.

flac --verify abc.wav یا flac -V abc.wav

کدگذاری abc.wav به abc.flac و رمزگشایی درونی abc.flac جهت اطمینان از تطابق آن با abc.wav.

flac -o my.flac abc.wav

کدگذاری abc.wav به my.flac.

flac abc.aiff foo.rf64 bar.w64

کدگذاری abc.aiff به abc.flac، foo.rf64 به foo.flac و bar.w64 به bar.flac.

flac *.wav *.aif?

نویسه‌های عام (wildcards) پشتیبانی می‌شوند. این دستور تمام فایل‌های .wav و تمام فایل‌های .aif/.aiff/.aifc (و همچنین سایر فایل‌های پشتیبانی‌شده که نامشان به .aif به‌علاوه یک نویسه ختم می‌شود) را در دایرکتوری جاری کدگذاری می‌کند.

flac abc.flac --force یا flac abc.flac -f

فشرده‌سازی مجدد، با حفظ فراداده‌ها مانند برچسب‌ها. ساختار دستوری کمی فریبنده است: این یک دستور کدگذاری است (که حالت پیش‌فرض است: برای خروجی رمزگشایی‌شده باید -d را مشخص کنید)، و بنابراین مایل است فایل خروجی abc.flac را تولید کند - که از پیش وجود دارد. برنامه flac برای رونویسی روی یک فایل موجود به گزینه --force یا شکل کوتاه -f نیاز دارد. فشرده‌سازی مجدد ابتدا یک فایل موقت می‌نویسد، که پس از آن جایگزین abc.flac قدیمی می‌شود (به شرطی که flac دسترسی نوشتن به آن فایل را داشته باشد). مثال بالا از تنظیمات پیش‌فرض استفاده می‌کند. در بیشتر موارد، فشرده‌سازی مجدد با یک گزینه فشرده‌سازی متفاوت - معمولاً بالاتر - ترکیب می‌شود. نکته: اگر نام فایل FLAC به .flac ختم نشود - برای مثال abc.fla باشد - گزینه -f لازم نیست: یک فایل جدید abc.flac ایجاد می‌شود و فایل قدیمی حفظ خواهد شد، درست مانند یک فایل ورودی فشرده‌نشده.

flac --tag-from-file="ALBUM=albumtitle.txt" -T "ARTIST=Queen" *.wav

کدگذاری تمامی فایل‌های .wav در دایرکتوری و افزودن تعدادی برچسب. همه فایل‌ها مجموعه برچسب‌های یکسانی دریافت خواهند کرد. هشدار: هنگامی که فایل ورودی (Ogg) FLAC باشد، تمام برچسب‌های موجود پاک خواهند شد - نه فقط برچسب‌هایی که در گزینه فهرست شده‌اند. برای برچسب‌گذاری فایل‌های FLAC از ابزار metaflac استفاده کنید.

flac --keep-foreign-metadata-if-present abc.wav

فایل‌های FLAC می‌توانند قطعه‌های غیرصوتی (non-audio chunks) فایل‌های ورودی WAVE/AIFF/RF64/W64 را ذخیره کنند. گزینه مرتبط --keep-foreign-metadata نیز به همان شکل کار می‌کند، اما در صورتی که ورودی فاقد چنین قطعه‌های غیرصوتی باشد با یک خطا خارج خواهد شد. کدگذار تنها قطعه‌ها را همان‌طور که هستند ذخیره می‌کند و نمی‌تواند محتوای آن‌ها را در برچسب‌های خود (vorbis comments) وارد کند. جهت انتقال چنین برچسب‌هایی از یک فایل مبدأ، از نرم‌افزار برچسب‌گذاری که از آن‌ها پشتیبانی کند استفاده نمایید.

flac -Vj2 -m3fo Track07.flac -- -7.wav

برنامه flac از این قاعده مرسوم پیروی می‌کند که گزینه‌ها در حالت کوتاه - که با یک خط تیره فراخوانی می‌شوند - می‌توانند با یکدیگر ادغام شوند تا زمانی که به گزینه‌ای برسند که آرگومان می‌پذیرد. در اینجا گزینه‌های -j و -o آرگومان می‌پذیرند، و پس از “2” به یک فاصله خالی نیاز است تا گزینه‌های جدید با خط تیره تکی/دوگانه آغاز شوند. گزینه -m آرگومان نمی‌پذیرد، و “3” پس از آن، تنظیم فشرده‌سازی -3 است. این گزینه‌ها به همان ترتیب می‌توانستند به صورت -V -j 2 -m -3 -f -o Track04.flac یا به صورت -fo Track04.flac -3mVj2 نوشته شوند. همچنین flac از این قاعده پیروی می‌کند که -- (همراه با فاصله خالی!) بیانگر پایان گزینه‌ها است، و با هر آنچه پس از آن بیاید مانند نام فایل رفتار می‌کند. این مورد زمانی لازم است که نام فایل ورودی ممکن است به عنوان یک گزینه خوانده شود، و “-7” یکی از همین موارد است. در مجموع، این خط، فایل ورودی -7.wav را به عنوان ورودی دریافت می‌کند؛ گزینه -o نام فایل خروجی را Track07.flac قرار می‌دهد، و گزینه -f در صورتی که فایل Track04.flac از قبل موجود باشد آن را بازنویسی خواهد کرد. کدگذار پیش‌تنظیم کدگذاری -3 اصلاح‌شده با سوییچ -m را انتخاب می‌کند و از دو ریسه پردازنده (CPU threads) استفاده می‌نماید. پس از آن، -V باعث رمزگشایی فایل flac و مقایسه صدای آن با ورودی می‌شود تا اطمینان حاصل شود که واقعاً یکسان هستند..SS "مثال‌های رمزگشایی (Decoding examples)"

flac --decode abc.flac یا flac -d abc.flac

رمزگشایی abc.flac به abc.wav. فایل abc.flac حذف نمی‌شود. اگر abc.wav از قبل وجود داشته باشد، فرایند به جای رونویسی کردن، با یک خطا خارج خواهد شد؛ برای اجبار به رونویسی از –force / -f استفاده کنید. نکته: اجرای سادهٔ flac abc.flac بدون –decode یا شکل کوتاه آن -d، به معنای بازکدگذاری abc.flac به abc.flac خواهد بود (بالا را ببینید)، و این دستور با خطا خاتمه می‌یابد زیرا abc.flac از قبل وجود دارد.

flac -d --force-aiff-format abc.flac یا flac -d -o abc.aiff abc.flac

دو روش مختلف برای رمزگشایی abc.flac به abc.aiff (قالب AIFF). فایل abc.flac حذف نمی‌شود. می‌توان -d -o را به صورت -do کوتاه کرد. رمزگشا می‌تواند قالب‌های خروجی دیگر یا نسخه‌های متفاوتی از قالب‌های WAVE/AIFF را اجبار کند؛ گزینه‌های زیر را ببینید.

flac -d --keep-foreign-metadata-if-present abc.flac

اگر فایل FLAC دارای تکه‌های (chunks) غیرصوتی ذخیره‌شده از فایل ورودی اصلی باشد، این گزینه هم داده‌های صوتی و هم داده‌های غیرصوتی را بازیابی خواهد کرد. این تکه‌ها نوع فایل اصلی را مشخص می‌کنند، و رمزگشا قالب خروجی و پسوند فایل خروجی را بر همین اساس انتخاب خواهد کرد - توجه داشته باشید که این با اجبار یک قالب خروجی خاص سازگار نیست مگر اینکه با قالب اصلی مطابقت داشته باشد، چرا که رمزگشا نمی‌تواند داده‌های غیرصوتی را میان قالب‌ها تبدیل کد (transcode) کند. اگر چنین تکه‌هایی ذخیره نشده باشند، به abc.wav رمزگشایی خواهد شد. گزینهٔ مرتبط --keep-foreign-metadata در صورت پیدا نشدن چنین تکه‌های غیرصوتی، در عوض با خطا خارج خواهد شد.

flac -d -F abc.flac

رمزگشایی abc.flac به abc.wav بدون لغو عملیات در صورت یافتن خطاها. این گزینه بالقوه برای بازیابی بیشترین مقدار ممکن از یک فایل آسیب‌دیده مفید است. نکته: در تلاش برای “تعمیر” فایل‌ها به این روش محتاط باشید. اغلب اوقات این کار تنها خطا را پنهان می‌کند و پخش آن از نظر شنیداری هیچ کیفیتی “بهتر” از فایل آسیب‌دیده نخواهد داشت. ایدهٔ خوبی است که حداقل آن را نگه دارید و در صورت امکان چندین رمزگشا، از جمله رمزگشایی که فایل را تولید کرده است، امتحان کنید و بشنوید که آیا یکی خطاهای شنیداری مخرب کمتری نسبت به دیگری دارد یا خیر. اطمینان حاصل کنید که بلندی صدای خروجی محدود است، زیرا صدای آسیب‌دیده می‌تواند نویزهای بسیار بلندی تولید کند.

گزینه‌های عمومی (GENERAL OPTIONS)

-v, --version

نمایش شماره نسخه flac و خروج.

-h, --help

نمایش نحوه استفاده پایه و فهرستی از تمامی گزینه‌ها، و خروج.

-d, --decode

رمزگشایی (رفتار پیش‌فرض، کدگذاری است)

-t, --test

آزمایش یک فایل کدگذاری‌شدهٔ flac. عملکرد این گزینه همانند -d است به جز اینکه هیچ فایل رمزگشایی‌شده‌ای نوشته نمی‌شود، و بررسی‌های اضافی مانند تجزیهٔ تمام بلوک‌های فراداده (metadata) را انجام می‌دهد.

-a, --analyze

تحلیل یک فایل کدگذاری‌شدهٔ FLAC. عملکرد این گزینه همانند -d است به جز اینکه خروجی یک فایل تحلیل است، نه یک فایل رمزگشایی‌شده.

-c, --stdout

نوشتن خروجی در stdout

-f, --force

اجبار به رونویسی فایل‌های خروجی. به‌طور پیش‌فرض، flac هشدار می‌دهد که فایل خروجی از قبل وجود دارد و به سراغ فایل بعدی می‌رود.

--delete-input-file

حذف خودکار فایل ورودی پس از یک کدگذاری یا رمزگشایی موفقیت‌آمیز. اگر خطایی رخ دهد (شامل خطای بررسی صحت verify)، فایل ورودی دست‌نخورده باقی می‌ماند.

-o FILENAME, --output-name=FILENAME

اجبار نام فایل خروجی (معمولاً flac فقط پسوند را تغییر می‌دهد). فقط هنگام کدگذاری یک تک‌فایل قابل استفاده است. نباید همراه با --output-prefix استفاده شود.

--output-prefix=STRING

افزودن رشتهٔ داده‌شده به ابتدای نام هر فایل خروجی (پیشوند). این گزینه می‌تواند برای کدگذاری یا رمزگشایی فایل‌ها در یک دایرکتوری دیگر مفید باشد. اگر رشتهٔ شما یک نام مسیر است، اطمینان حاصل کنید که با یک `/’ (اسلش) پایانی خاتمه یابد.

--preserve-modtime

(به‌طور پیش‌فرض فعال است.) برچسب‌های زمانی و مجوزهای فایل‌های خروجی مطابق با ورودی‌های آن‌ها تنظیم می‌شود. از --no-preserve-modtime استفاده کنید تا فایل‌های خروجی دارای زمان کنونی و مجوزهای پیش‌فرض باشند.

--keep-foreign-metadata

هنگام کدگذاری، تکه‌های غیرصوتی WAVE، RF64 یا AIFF را در فراداده‌های FLAC ذخیره می‌کند. هنگام رمزگشایی، هرگونه تکهٔ غیرصوتی ذخیره‌شده را موقع نوشتن فایل رمزگشایی‌شده از فراداده‌های FLAC بازیابی می‌کند. فراداده‌های خارجی (Foreign metadata) قابل تبدیل کد نیستند، برای مثال تکه‌های WAVE ذخیره‌شده در یک فایل FLAC هنگام رمزگشایی به AIFF قابل بازیابی نیستند. ورودی و خروجی باید فایل‌های معمولی باشند (نه stdin یا stdout). با این گزینه، FLAC در هنگام رمزگشایی قالب خروجی صحیح را انتخاب خواهد کرد. اگر چنین تکه‌هایی یافت نشوند، با خطا خارج خواهد شد.

--keep-foreign-metadata-if-present

مانند --keep-foreign-metadata، اما بدون ایجاد خطا در صورتی که فراداده‌های خارجی پیدا یا بازیابی نشوند. در عوض، یک هشدار چاپ می‌کند.

--skip={#|MM:SS}

رد کردن تعداد مشخصی از نمونه‌های اولیه (samples) در ورودی. برای رد کردن یک مدت‌زمان اولیهٔ مشخص، به جای آن دقیقه و ثانیه را تعیین کنید: در این حالت باید حداقل یک رقم در هر طرف علامت دونقطه وجود داشته باشد. کسرهایی از ثانیه را نیز می‌توان مشخص کرد که ممیز اعشاری آن وابسته به locale است؛ برای مثال اگر ممیز شما ویرگول باشد: --skip=123:9,867. اگر چندین فایل ورودی داده شده باشد، گزینهٔ --skip روی تک‌تک آن‌ها اعمال می‌شود. این گزینه نمی‌تواند همراه با -t استفاده شود. هنگام استفاده همراه با -a، فایل تحلیل فریم‌ها را از نقطهٔ شروع شماره‌گذاری خواهد کرد.

--until={#|[+|]MM:SS}

توقف در شماره نمونهٔ داده‌شده (که خود نمونه شامل آن نمی‌شود). یک عدد منفی، نسبت به انتهای صوت محاسبه می‌شود؛ علامت `+’ (به‌علاوه) بدین معناست که نقطهٔ --until نسبت به نقطهٔ --skip سنجیده می‌شود. برای سایر نکات، --skip را ببینید.

--no-utf8-convert

برچسب‌ها را از مجموعه نویسه‌های محلی به UTF-8 تبدیل نکن. این گزینه برای اسکریپت‌ها و تنظیم برچسب‌ها در شرایطی که locale نادرست است مفید است. این گزینه باید حتماً قبل از هر گزینهٔ برچسبی قرار گیرد!

-s, --silent

حالت بی‌صدا (آمارهای کدگذاری/رمزگشایی زمان اجرا را در stderr نمی‌نویسد)

--totally-silent

هیچ پیامی از هیچ نوعی، شامل هشدارها یا خطاها، چاپ نشود. کد خروج تنها راه برای تعیین تکمیل موفقیت‌آمیز عملیات خواهد بود.

-w, --warnings-as-errors

در نظر گرفتن تمام هشدارها به عنوان خطا (که باعث می‌شود flac با یک کد خروج غیرصفر خاتمه یابد)..SS "گزینه‌های رمزگشایی (DECODING OPTIONS)"

-F, --decode-through-errors

به‌طور پیش‌فرض، اگر flac با خطای جریان بیت (bitstream) مواجه شود، رمزگشایی را با یک پیام خطا متوقف کرده و فایلِ تا حدی رمزگشایی‌شده را حذف می‌کند. با -F، خطاها همچنان چاپ می‌شوند اما flac رمزگشایی را تا تکمیل نهایی ادامه خواهد داد. توجه داشته باشید که خطاها ممکن است باعث شوند صوت رمزگشایی‌شده برخی از نمونه‌ها را نداشته باشد یا بخش‌های بی‌صدا در آن به وجود آید.

--cue=[#.#][-[#.#]]

تنظیم نقاط نشانه‌گذاری (cuepoint) آغازین و پایانی برای رمزگشایی. ممیزهای اعشاری وابسته به محلی‌سازی (locale) هستند (نقطه یا ویرگول). اولین #.# اختیاری، قطعه (track) و نقطه شاخصی است که رمزگشایی از آنجا آغاز می‌شود؛ پیش‌فرض، ابتدای جریان است. دومین #.# اختیاری، قطعه و نقطه شاخصی است که رمزگشایی در آنجا به پایان می‌رسد؛ پیش‌فرض، انتهای جریان است. اگر نقطه نشانه‌گذاری وجود نداشته باشد، نزدیک‌ترین مورد قبل از آن (برای نقطه آغاز) یا بعد از آن (برای نقطه پایان) استفاده خواهد شد. اگر آن‌ها نیز وجود نداشته باشند، آغاز جریان (برای نقطه آغاز) یا انتهای جریان (برای نقطه پایان) استفاده می‌شود. نقاط نشانه‌گذاری صرفاً به شماره‌های نمونه تبدیل شده و سپس به عنوان --skip و --until به کار می‌روند. یک قطعه CD را همواره می‌توان نشانه گذاری کرد؛ برای مثال، با --cue=9.1-10.1 برای قطعه ۹، حتی اگر CD قطعه دهمی نداشته باشد.

–decode-chained-stream

رمزگشایی همه پیوندهای موجود در یک جریان زنجیره‌ای Ogg، نه تنها پیوند نخست.

--apply-replaygain-which-is-not-lossless[=SPECIFICATION]

اعمال مقادیر ReplayGain در هنگام رمزگشایی. هشدار: این کار بدون اتلاف (lossless) نیست. با استفاده از این گزینه، صوت رمزگشایی‌شده همسان با نسخه اصلی نخواهد بود. این گزینه برای مثال در سرورهای رسانه‌ای تبدیل کد (transcoding) که کلاینت در آن‌ها از ReplayGain پشتیبانی نمی‌کند، مفید است. برای جزئیات بیشتر درباره کاربرد این گزینه، بخش مشخصات کاربرد ReplayGain را ببینید.

گزینه‌های کدگذاری (ENCODING OPTIONS)

کدگذاری به‌طور پیش‌فرض بر روی -5، -A “tukey(5e-1)” و یک ریسه (thread) پردازنده تنظیم است.

-V, --verify

وارسی درستی کدگذاری از طریق رمزگشایی هم‌زمان خروجی و مقایسه آن با نسخه اصلی.

-0, --compression-level-0, --fast

سریع‌ترین پیش‌تنظیم فشرده‌سازی. در حال حاضر مترادف است با: -l 0 -b 1152 -r 3 --no-mid-side

-1, --compression-level-1

در حال حاضر مترادف با -l 0 -b 1152 -M -r 3

-2, --compression-level-2

در حال حاضر مترادف با -l 0 -b 1152 -m -r 3

-3, --compression-level-3

در حال حاضر مترادف است با: -l 6 -b 4096 -r 4 --no-mid-side

-4, --compression-level-4

در حال حاضر مترادف با -l 8 -b 4096 -M -r 4

-5, --compression-level-5

در حال حاضر مترادف با -l 8 -b 4096 -m -r 5

-6, --compression-level-6

در حال حاضر مترادف است با: -l 8 -b 4096 -m -r 6 -A "subdivide_tukey(2)"

-7, --compression-level-7

در حال حاضر مترادف است با: -l 12 -b 4096 -m -r 6 -A "subdivide_tukey(2)"

-8, --compression-level-8, --best

در حال حاضر مترادف است با: -l 12 -b 4096 -m -r 6 -A "subdivide_tukey(3)"

-l #, --max-lpc-order=#

حداکثر مرتبه LPC را تعیین می‌کند. این عدد باید <= 32 باشد. برای جریان‌های زیرمجموعه (subset streams)، اگر نرخ نمونه‌برداری <=48kHz باشد، این مقدار باید <=12 باشد. اگر 0 باشد، کدگذار تلاشی برای پیش‌بینی خطی عام نخواهد کرد و فقط از میان مجموعه‌ای از پیش‌بین‌های ثابت (hard-coded) انتخاب می‌کند. محدود کردن تنها به پیش‌بین‌های ثابت سریع‌تر است، اما فشرده‌سازی ضعیف‌تری دارد - معمولاً ۵ واحد درصد / ۱۰ درصد اندازه فایل بزرگ‌تر.

-b #, --blocksize=#

تعیین اندازه بلوک بر حسب نمونه. پیش‌فرض فعلی برای -l 0 مقدار ۱۱۵۲، و در غیر این صورت ۴۰۹۶ است. اندازه بلوک باید بین ۱۶ و ۶۵۵۳۵ (شامل هر دو) باشد. برای جریان‌های زیرمجموعه، اگر نرخ نمونه‌برداری <= 48kHz باشد باید <= 4608 باشد، و برای جریان‌های زیرمجموعه با نرخ نمونه‌برداری بالاتر باید <= 16384 باشد.

-m, --mid-side

آزمودن کدگذاری میانی-کناری (mid-side) برای هر فریم (تنها برای استریو، در غیر این صورت نادیده گرفته می‌شود).

-M, --adaptive-mid-side

کدگذاری میانی-کناری تطبیقی برای همه فریم‌ها (تنها برای استریو، در غیر این صورت نادیده گرفته می‌شود).

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

تنظیم مرتبه افراز باقی‌مانده به صورت [min,]max در بازه (0..15). برای جریان‌های زیرمجموعه، مقدار max باید <=8 باشد. مقدار پیش‌فرض min برابر با 0 است. پیش‌فرض کلی -r 5 است. افراز واقعی توسط اندازه بلوک و مرتبه پیش‌بینی محدود خواهد شد، و کدگذار مقادیر بیش از حد بالا را بدون هشدار کاهش می‌دهد.

-A FUNCTION(S), --apodization=FUNCTION(S)

پنجره‌بندی داده‌های صوتی با تابع پَروَردگی (apodization) مشخص‌شده. می‌توان موارد بیشتری را که با کاما جدا شده‌اند، مشخص کرد. برای جزئیات بیشتر بخش توابع آپودایزیشن (Apodization functions) را ببینید.

-e, --exhaustive-model-search

انجام جستجوی جامع مدل (پرهزینه از نظر محاسباتی!).

-q #, --qlp-coeff-precision=#

دقت ضرایب کوانتیزه‌شده پیش‌بین خطی (QLP). این عدد باید بین ۵ و ۱۶ باشد، یا 0 (پیش‌فرض) تا تصمیم‌گیری به عهده کدگذار گذاشته شود. در صورت استفاده از -l 0 هیچ اثری ندارد.

-p, --qlp-coeff-precision-search

انجام جستجوی جامع در کوانتیزاسیون ضرایب پیش‌بین خطی (پرهزینه از نظر محاسباتی!). بر -q تقدم دارد؛ در صورت استفاده از -l 0 هیچ اثری ندارد.

--lax

اجازه دادن به کدگذار برای تولید فایل‌های غیر زیرمجموعه (non-Subset). فایل FLAC حاصل ممکن است قابل پخش زنده (streamable) نباشد یا در بازپخش در همه پخش‌کننده‌ها (به‌ویژه دستگاه‌های سخت‌افزاری) با مشکل مواجه شود؛ بنابراین این گزینه را فقط باید همراه با گزینه‌های سفارشی کدگذاری که برای آرشیو و بایگانی در نظر گرفته شده‌اند استفاده کنید.

--limit-min-bitrate

محدود کردن حداقل نرخ بیت با مجاز ندانستن فریم‌هایی که صرفاً از زیرفریم‌های ثابت تشکیل شده‌اند. این کار حداقل نرخ بیتی معادل ۱ بیت به ازای هر نمونه را تضمین می‌کند؛ برای مثال 48kbit/s برای ورودی 48kHz. این ویژگی عمدتاً برای پخش زنده اینترنتی (streaming) مفید است.

-j #, --threads=#

تلاش برای تنظیم حداکثر تعداد ریسه‌ها جهت استفاده در کدگذاری. اگر چندریسمانی در زمان کامپایل فعال نشده باشد یا هنگامی که تعداد ریسه‌ها بیش از حد بالا تعیین شود، این دستور با یک هشدار با شکست مواجه می‌شود. مقدار 0 به معنای مقدار پیش‌فرضی است که توسط کدگذار تعیین می‌شود؛ در حال حاضر این مقدار ۱ ریسه است (یعنی بدون چندریسمانی)، اما ممکن است در آینده تغییر کند. در حال حاضر تا ۱۲۸ ریسه پشتیبانی می‌شود. استفاده از مقداری بیشتر از تعداد ریسه‌های در دسترس پردازنده به کارایی آسیب می‌زند.

--ignore-chunk-sizes

هنگام کدگذاری به flac، سرایندهای اندازه فایل در فایل‌های WAV و AIFF را نادیده می‌گیرد تا مشکلات مربوط به فایل‌های بیش از اندازه بزرگ یا با ساختار نامعتبر را برطرف کند. هر دو فرمت WAV و AIFF طول داده‌های صوتی را با یک عدد ۳۲ بیتی بدون علامت مشخص می‌کنند که صدا را به کمی بیش از ۴ گیگابایت محدود می‌کند. فایل‌های بزرگ‌تر از این مقدار دارای ساختار نامعتبر هستند، اما با استفاده از این گزینه باید به درستی خوانده شوند. با این حال مراقب باشید، زیرا ممکن است هر داده‌ای را که پس از تکه (chunk) صوتی می‌آید، به اشتباه به عنوان صوت تفسیر کند.

--replay-gain

محاسبه مقادیر ReplayGain و ذخیره آن‌ها به عنوان برچسب‌های FLAC، مشابه با vorbisgain. بهره‌ها/اوج‌ها (gain/peak) برای عنوانِ هر فایل ورودی، و یک بهره/اوج آلبوم برای تمام فایل‌ها محاسبه خواهد شد. تمام فایل‌های ورودی باید وضوح، نرخ نمونه‌برداری و تعداد کانال‌های یکسانی داشته باشند. فقط فایل‌های مونو و استریو مجاز هستند، و نرخ نمونه‌برداری باید یکی از مقادیر 8، 11.025، 12، 16، 18.9، 22.05، 24، 28، 32، 36، 37.8، 44.1، 48، 56، 64، 72، 75.6، 88.2، 96، 112، 128، 144، 151.2، 176.4، 192، 224، 256، 288، 302.4، 352.8، 384، 448، 512، 576 یا 604.8 کیلوهرتز باشد. همچنین توجه داشته باشید که این گزینه ممکن است چند بایت اضافی در یک بلوک PADDING باقی بگذارد زیرا اندازه دقیق برچسب‌ها تا زمانی که تمام فایل‌ها پردازش نشوند مشخص نیست. توجه داشته باشید که این گزینه هنگام کدگذاری به خروجی استاندارد (stdout) قابل استفاده نیست.

--cuesheet=FILENAME

وارد کردن فایل cuesheet داده‌شده و ذخیره آن در یک بلوک فراداده CUESHEET. این گزینه فقط هنگام کدگذاری یک تک‌فایل قابل استفاده است. یک نقطه جستجو (seekpoint) به ازای هر نقطه شاخص در cuesheet به جدول SEEKTABLE اضافه خواهد شد، مگر اینکه --no-cued-seekpoints مشخص شده باشد..TP --picture={FILENAME|SPECIFICATION} وارد کردن یک تصویر و ذخیره آن در یک بلوک متاداده‌ی PICTURE. می‌توان بیش از یک گزینه‌ی --picture را مشخص کرد. می‌توان از نام فایل تصویر یا از قالب مشخصات کامل‌تری استفاده کرد. SPECIFICATION رشته‌ای است که بخش‌های آن با نویسه | (pipe) از هم جدا می‌شوند. برخی بخش‌ها می‌توانند خالی رها شوند تا مقادیر پیش‌فرض اعمال گردند. مشخص کردن تنها FILENAME صرفاً خلاصه‌نویسی برای “||||FILENAME” است. برای ساختار SPECIFICATION بخش Picture specification را ببینید.

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

نقطه(های) پرش را برای گنجاندن در جدول SEEKTABLE مشخص می‌کند، تا انتخاب پیش‌فرض کدگذار که هر ده ثانیه یک‌بار است (`-s 10s´) نادیده گرفته شود. با استفاده از #، یک نقطه پرش در آن شماره نمونه اضافه می‌شود. با استفاده از X، یک نقطه نگه‌دارنده مکان (placeholder) در انتهای جدول اضافه می‌شود. با استفاده از #x، تعداد # نقطه پرش با فاصله‌های یکنواخت اضافه خواهد شد که اولین نقطه در نمونه ۰ قرار دارد. با استفاده از #s، در هر # ثانیه یک نقطه پرش اضافه می‌شود، که ممیز اعشاری به محلی‌سازی (locale) بستگی دارد؛ مانند `-s 9.5s´ یا `-s 9,5s´. می‌توان چندین گزینه -S داد؛ جدول SEEKTABLE حاصل شامل تمام نقاط پرش مشخص‌شده خواهد بود (موارد تکراری حذف می‌شوند). نکته: در صورتی که کدگذار نتواند قبل از شروع، اندازه ورودی را تعیین کند، `-S #x´ و `-S #s´ کار نخواهند کرد. نکته: اگر از `-S #´ استفاده کنید و # بزرگ‌تر یا مساوی با تعداد نمونه‌های ورودی باشد، یا هیچ نقطه پرشی وارد نخواهد شد (اگر اندازه ورودی قبل از شروع کدگذاری قابل تعیین باشد) یا یک نقطه نگه‌دارنده مکان وارد می‌شود (اگر اندازه ورودی قابل تعیین نباشد). برای نداشتن جدول پرش از --no-seektable استفاده کنید.

-P #, --padding=#

(پیش‌فرض: ۸۱۹۲ بایت، هرچند برای ورودی بیش از ۲۰ دقیقه، ۶۵۵۳۶ بایت است.) به کدگذار دستور می‌دهد تا یک بلوک متاداده‌ی PADDING با طول مشخص‌شده (به بایت) پس از بلوک STREAMINFO بنویسد. این گزینه برای برچسب‌گذاری‌های بعدی مفید است، جایی که می‌توان به جای بازنویسی کل فایل، روی بلوک PADDING بازنویسی انجام داد. توجه داشته باشید که سرآیند بلوک با اندازه ۴ بایت به طول مشخص‌شده اضافه خواهد شد.

-T “FIELD=VALUE”, --tag=“FIELD=VALUE”

افزودن یک برچسب FLAC. توضیح (comment) باید از مشخصات Vorbis comment پیروی کند؛ یعنی FIELD باید تنها شامل نویسه‌های مجاز بوده و به علامت مساوی ختم شود. مطمئن شوید در صورت نیاز محتوا را در علامت نقل‌قول قرار دهید. این گزینه می‌تواند بیش از یک‌بار برای افزودن چندین توضیح Vorbis تکرار شود. نکته: تمام برچسب‌ها به همه فایل‌های کدگذاری‌شده اضافه خواهند شد.

--tag-from-file=“FIELD=FILENAME”

مانند --tag است، با این تفاوت که FILENAME فایلی است که محتویات آن عیناً خوانده شده تا به عنوان مقدار برچسب تنظیم شود. محتویات از مجموعه نویسه محلی به UTF-8 تبدیل خواهند شد. از این گزینه می‌توان برای ذخیره یک cuesheet در یک برچسب استفاده کرد (برای مثال --tag-from-file=“CUESHEET=image.cue”). سعی نکنید داده‌های باینری را در فیلدهای برچسب ذخیره کنید! برای این کار از بلوک‌های APPLICATION استفاده نمایید.

گزینه‌های قالب‌بندی (FORMAT OPTIONS)

کدگذاری به صورت پیش‌فرض روی FLAC است و نه OGG. رمزگشایی به صورت پیش‌فرض روی WAVE است (به طور مشخص‌تر، WAVE_FORMAT_PCM برای مونو/استریو با ۸/۱۶ بیت، و در غیر این صورت WAVE_FORMAT_EXTENSIBLE)، به جز مواردی که با تکه‌های یافت‌شده توسط --keep-foreign-metadata-if-present یا --keep-foreign-metadata نادیده گرفته و بازنویسی شود.

--ogg

هنگام کدگذاری، تولید خروجی Ogg FLAC به جای FLAC بومی. جریان‌های Ogg FLAC همان جریان‌های FLAC هستند که در یک لایه انتقال Ogg بسته‌بندی شده‌اند. فایل حاصل باید پسوند `.oga´ داشته باشد و همچنان توسط flac قابل رمزگشایی خواهد بود. هنگام رمزگشایی، ورودی را وادار می‌کند تا به عنوان Ogg FLAC در نظر گرفته شود. این ویژگی هنگام هدایت (pipe) ورودی از stdin یا زمانی که نام فایل به `.oga´ یا `.ogg´ ختم نمی‌شود مفید است.

--serial-number=#

هنگام استفاده با --ogg، شماره سریالی را برای استفاده در اولین جریان Ogg FLAC مشخص می‌کند که سپس برای هر جریان اضافی یکی به آن افزوده می‌شود. هنگام کدگذاری اگر شماره سریالی مشخص نشده باشد، flac یک شماره تصادفی برای اولین جریان استفاده کرده و سپس برای هر جریان بعدی یکی به آن می‌افزاید. هنگام رمزگشایی اگر شماره‌ای داده نشود، flac از شماره سریال اولین صفحه استفاده می‌کند.

--force-aiff-format

--force-rf64-format

--force-wave64-format : برای رمزگشایی: نادیده‌گرفتن قالب خروجی پیش‌فرض و اجبار خروجی به ترتیب به AIFF/RF64/WAVE64. اگر نام فایل خروجی (تنظیم‌شده توسط -o) به ترتیب با پسوندهای .aif یا .aiff، .rf64 و .w64 ختم شود، به این گزینه نیازی نیست. کدگذار قالب را به صورت خودکار تشخیص داده و این گزینه را نادیده می‌گیرد.

--force-legacy-wave-format

--force-extensible-wave-format : دستور به رمزگشا برای تولید خروجی فایل WAVE به ترتیب با WAVE_FORMAT_PCM و WAVE_FORMAT_EXTENSIBLE، که انتخاب پیش‌فرض را لغو می‌کند.

--force-aiff-c-none-format

--force-aiff-c-sowt-format : دستور به رمزگشا برای تولید خروجی فایل AIFF-C به ترتیب با قالب‌های NONE و sowt.

--force-raw-format

اجبار ورودی (هنگام کدگذاری) یا خروجی (هنگام رمزگشایی) به اینکه به عنوان نمونه‌های خام (raw samples) در نظر گرفته شود (حتی اگر نام فایل خلاف آن را نشان دهد)..SS گزینه‌های قالب خام (raw format options) هنگام کدگذاری از یا رمزگشایی به PCM خام، قالب باید مشخص شود.

--sign={signed|unsigned}

علامت نمونه‌ها را مشخص می‌کند.

--endian={big|little}

ترتیب بایت‌ها را برای نمونه‌ها مشخص می‌کند.

--channels=#

(فقط ورودی) تعداد کانال‌ها را مشخص می‌کند. کانال‌ها باید درهم‌تنیده (interleaved) و به ترتیبی باشند که در مشخصات قالب FLAC آمده است (مشخصات قالب را ببینید)؛ کدگذار (/رمزگشا) نمی‌تواند کانال‌ها را مجدداً مرتب کند.

--bps=#

(فقط ورودی) تعداد بیت‌ها بر نمونه را مشخص می‌کند (برای هر کانال: ۱۶ برای CDDA.)

--sample-rate=#

(فقط ورودی) نرخ نمونه‌برداری را مشخص می‌کند (به هرتز. تنها اعداد صحیح پشتیبانی می‌شوند.)

--input-size=#

(فقط ورودی) اندازه ورودی خام را بر حسب بایت مشخص می‌کند. این گزینه تنها زمانی اجباری است که کدگذاری از stdin انجام شود و از گزینه‌هایی استفاده شود که باید از قبل اندازه ورودی را بدانند (مانند --skip، --until، --cuesheet). اگر جریان ورودی بزرگ‌تر باشد، کدگذار آن را در اندازه مشخص‌شده قطع می‌کند. اگر جریان ورودی کوچک‌تر باشد، خطای پایان غیرمنتظره فایل (end-of-file) صادر می‌شود.

گزینه‌های تحلیل (ANALYSIS OPTIONS)

--residual-text

سیگنال باقی‌مانده (residual) را در فایل تحلیل می‌گنجاند. این کار باعث می‌شود فایل بسیار بزرگ شود، حتی بسیار بزرگ‌تر از فایل رمزگشایی‌شده.

--residual-gnuplot

برای هر زیرفریم یک فایل gnuplot تولید می‌کند؛ هر فایل شامل توزیع باقی‌مانده زیرفریم خواهد بود. این کار فایل‌های بسیار زیادی ایجاد خواهد کرد. برنامه gnuplot باید به‌صورت جداگانه نصب شود.

گزینه‌های نقیض (NEGATIVE OPTIONS)

موارد زیر گزینه‌ای را که قبلاً مشخص شده است لغو (نفی) می‌کنند:

--no-adaptive-mid-side

--no-cued-seekpoints

--no-decode-through-errors

--no-delete-input-file

--no-preserve-modtime

--no-keep-foreign-metadata

--no-exhaustive-model-search

--no-force

--no-lax

--no-mid-side

--no-ogg

--no-padding

--no-qlp-coeff-prec-search

--no-replay-gain

--no-residual-gnuplot

--no-residual-text

--no-seektable

--no-silent

--no-verify

--no-warnings-as-errors.SS "مشخصات اِعمال ReplayGain (ReplayGain application specification)" گزینهٔ --apply-replaygain-which-is-not-lossless[=<specification>] مقادیر ReplayGain را هنگام رمزگشایی اِعمال می‌کند. هشدار: این کار بدون اتلاف (Lossless) نیست. با این گزینه، صوت رمزگشایی‌شده با نسخهٔ اصلی یکسان نخواهد بود. این گزینه برای مثال در سرورهای رسانه‌ای تبدیل کُد (transcoding) که کلاینت از ReplayGain پشتیبانی نمی‌کند، مفید است.

عبارت <specification> یک نشانه‌گذاری کوتاه برای توصیف نحوهٔ اِعمال ReplayGain است. تمام عناصر اختیاری هستند - با مقدار پیش‌فرض 0aLn1 - اما ترتیب آن‌ها مهم است. قالب آن بدین صورت است:

[<preamp>][a|t][l|L][n{0|1|2|3}]

که در آن پارامترهای زیر استفاده می‌شوند:

•

preamp: یک عدد ممیز شناور بر حسب dB. این مقدار به مقدار گین (gain) فعلی افزوده می‌شود.

•

a|t: مقدار 'a' را برای استفاده از گین آلبوم (album gain)، یا 't' را برای استفاده از گین قطعه (track gain) مشخص کنید. اگر برچسب‌های نوع ترجیحی (آلبوم/قطعه) وجود نداشته باشند اما برچسب‌های نوع دیگر (قطعه/آلبوم) موجود باشند، از آن‌ها استفاده خواهد شد.

•

l|L: مقدار 'l' را برای محدود کردن سقف خروجی (peak-limit) مشخص کنید تا مقدار اوج ReplayGain در مقیاس کامل (full-scale) باشد. برای استفاده از یک محدودکنندهٔ سخت (hard limiter) با 6dB که هنگام نزدیک شدن سیگنال به مقیاس کامل وارد عمل می‌شود، مقدار 'L' را مشخص کنید.

•

n{0|1|2|3}: میزان شکل‌دهی نوفه (noise shaping) را تعیین می‌کند. سنتز ReplayGain در حالت ممیز شناور انجام می‌شود؛ نتیجه پیش از تبدیل مجدد به عدد صحیح دیتر (dither) می‌شود. این کوانتیزه‌سازی نوفه اضافه می‌کند. شکل‌دهی نوفه تلاش می‌کند تا نوفه را به جایی منتقل کند که کمتر شنیده شود. مقدار 0 یعنی بدون شکل‌دهی نوفه، 1 یعنی «کم» ('low')، 2 یعنی «متوسط» ('medium') و 3 یعنی «زیاد» ('high').

برای نمونه، مقدار پیش‌فرض 0aLn1 به معنای 0dB preamp، استفاده از گین آلبوم، محدودکنندهٔ سخت 6dB، و شکل‌دهی کمِ نوفه است. --apply-replaygain-which-is-not-lossless=3 به معنای 3dB preamp، استفاده از گین آلبوم، بدون محدودکننده و بدون شکل‌دهی نوفه است.

ابزار flac برای محاسبات از برچسب‌های ReplayGain استفاده می‌کند. اگر یک جریان فاقد برچسب‌های لازم باشد یا نتوان آن‌ها را تجزیه کرد، رمزگشایی با یک هشدار ادامه می‌یابد و هیچ ReplayGain ای بر آن جریان اِعمال نمی‌شود.

مشخصات تصویر (Picture specification)

این بخش مشخصات استفاده‌شده برای گزینهٔ --picture را توصیف می‌کند. [TYPE]|[MIME-TYPE]|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE

پارامتر TYPE اختیاری است؛ عددی از میان موارد زیر است:

0.

سایر (Other)

1.

«آیکون فایل» 32x32 پیکسل (فقط PNG)

2.

سایر آیکون‌های فایل

3.

کاور (روی جلد)

4.

کاور (پشت جلد)

5.

صفحهٔ بروشور/دفترچه (Leaflet)

6.

رسانه (مانند طرف برچسب‌دار CD)

7.

هنرمند اصلی/مجری اصلی/تک‌نواز

8.

هنرمند/مجری

9.

رهبر ارکستر

10.

گروه/ارکستر

11.

آهنگساز

12.

ترانه‌سرا/نویسندهٔ متن

13.

محل ضبط

14.

حین ضبط

15.

حین اجرا

16.

تصویر ضبط‌شده از صفحهٔ فیلم/ویدیو

17.

ماهی با رنگ‌های روشن (A bright coloured fish)

18.

تصویرسازی (Illustration)

19.

نشان‌واره/لوگوی گروه یا هنرمند

20.

نشان‌واره/لوگوی ناشر یا استودیو

مقدار پیش‌فرض 3 (کاور روی جلد) است. در یک فایل تنها می‌تواند یک تصویر از هر یک از انواع 1 و 2 وجود داشته باشد.

پارامتر MIME-TYPE اختیاری است؛ اگر خالی رها شود، از روی فایل تشخیص داده خواهد شد. برای بهترین سازگاری با پخش‌کننده‌ها، از تصاویری با نوع MIME از نوع image/jpeg یا image/png استفاده کنید. همچنین نوع MIME می‌تواند --> باشد که به این معنی است که FILE در واقع یک URL به یک تصویر است، هرچند این شیوه توصیه نمی‌شود.

پارامتر DESCRIPTION اختیاری است؛ پیش‌فرض آن یک رشتهٔ خالی است.

بخش بعدی اطلاعات تفکیک‌پذیری و رنگ را مشخص می‌کند. اگر MIME-TYPE برابر image/jpeg، image/png یا image/gif باشد، معمولاً می‌توانید این بخش را خالی بگذارید تا از روی فایل تشخیص داده شوند. در غیر این صورت، باید پهنا بر حسب پیکسل، بلندی بر حسب پیکسل، و عمق رنگ بر حسب بیت-بر-پیکسل را مشخص کنید. اگر تصویر دارای رنگ‌های نمایه‌دار (indexed colors) باشد، باید تعداد رنگ‌های استفاده‌شده را نیز مشخص کنید. در صورت تعیین دستی، صحت اطلاعات با فایل بررسی نخواهد شد.

پارامتر FILE مسیر فایل تصویری برای وارد کردن است، یا اگر نوع MIME برابر با --> باشد، URL مربوطه خواهد بود.

مثال‌های مشخصات: عبارت “|image/jpeg|||../cover.jpg” فایل JPEG در مسیر ../cover.jpg را با پیش‌فرض نوع 3 (روی جلد) و توضیح خالی جاسازی می‌کند. اطلاعات تفکیک‌پذیری و رنگ از خود فایل خوانده می‌شود. عبارت “4|-->|CD|320x300x24/173|http://blah.blah/backcover.tiff” نشانی اینترنتی (URL) داده‌شده را با نوع 4 (پشت جلد)، توضیحات “CD”، و تفکیک‌پذیری دستی مشخص‌شدهٔ 320x300، عمق رنگ ۲۴ بیت-بر-پیکسل، و ۱۷۳ رنگ جاسازی خواهد کرد. فایل موجود در URL بارگیری نخواهد شد؛ بلکه خود URL در بلوک متادیتای PICTURE ذخیره می‌شود..SS "توابع پنجره‌بندی (Apodization functions)" برای بهبود تحلیل LPC، داده‌های صوتی پنجره‌بندی (windowed) می‌شوند. گزینه -A تابع یا توابع پنجره‌بندی (apodization) مشخص‌شده را به جای مقدار پیش‌فرض (که “tukey(5e-1)” است، اگرچه در پیش‌تنظیم‌های -6 تا -8 تفاوت دارد) اعمال می‌کند. مشخص کردن یک تابع بیشتر عملاً به این معناست که برای هر زیرفریم (subframe)، وزن‌دهی دیگری روی داده‌ها آزمایش شود تا مشخص گردد آیا به تولید زیرفریم کدگذاری‌شده کوچک‌تری منجر می‌شود یا خیر. مشخص کردن چندین تابع زمان‌بر است و معمولاً با بازدهی رو به کاهش در بهبود فشرده‌سازی همراه خواهد بود.

توابع subdivide_tukey(N) (در ادامه ببینید) که در پیش‌تنظیم‌های -6 تا -8 استفاده می‌شوند، به منظور استفاده مجدد از محاسبات برای افزایش سرعت در مقایسه با چندین تابع مستقل توسعه داده شده‌اند. حتی در این حالت نیز مقادیر بالا مانند N>4 یا 5، اغلب کارایی کمتری نسبت به گزینه‌های دیگری که پرهزینه محسوب می‌شوند (مانند گزینه کندتر -p) خواهند داشت؛ هرچند نتایج بسته به نوع سیگنال متفاوت است.

حداکثر ۳۲ تابع را می‌توان به صورت فهرستی جداشده با کاما و/یا گزینه‌های -A مجزا مشخص کرد. هر تابعی که به نادرستی مشخص شده باشد، بدون هیچ هشداری نادیده گرفته می‌شود. بسته به شل (shell) مورد استفاده، ممکن است قرار دادن تابعی که آرگومان می‌گیرد (و دارای پرانتز است) درون نقل‌قول ضروری باشد. در حال حاضر توابع زیر پیاده‌سازی شده‌اند: bartlett، bartlett_hann، blackman، blackman_harris_4term_92db، connes، flattop، gauss(STDDEV)، hamming، hann، kaiser_bessel، nuttall، rectangle، triangle، tukey(P)، partial_tukey(N[/OV[/P]])، punchout_tukey(N[/OV[/P]])، subdivide_tukey(N[/P])، welch.

برای پارامترهای P، STDDEV و OV نماد علمی پشتیبانی می‌شود؛ مانند  tukey(5e-1). در غیر این صورت، ممیز اعشاری باید با لوکال (locale) سیستم سازگار باشد؛ برای مثال بسته به سیستم شما tukey(0.5) یا tukey(0,5).

•

برای gauss(STDDEV)، مقدار STDDEV انحراف معیار است (0<STDDEV<=5e-1).

•

برای tukey(P)، مقدار P (بین 0 و 1) کسری از پنجره را مشخص می‌کند که دارای شیب کسینوسی (cosine-tapered) است؛ P=0 معادل “rectangle” و P=1 معادل “hann” است.

•

توابع partial_tukey(N) و punchout_tukey(N) تا حد زیادی با تابع باصرفه‌تر subdivide_tukey(N) از نظر زمان، منسوخ شده‌اند (مورد بعدی را ببینید). آن‌ها N تابع تولید می‌کنند که هر یک بخشی از هر بلوک را در بر می‌گیرد. آرگومان‌های اختیاری شامل هم‌پوشانی OV (<1، می‌تواند منفی باشد)، برای مثال partial_tukey(