.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "metaflac" "1" "" "Version 1.5.0" "ابزار فراداده کدک صوتی بی‌اتلاف آزاد (FLAC)"
.SH "نام (NAME)"
metaflac \- برنامه‌ای برای فهرست کردن، افزودن، حذف یا ویرایش فراداده در یک یا چند فایل FLAC.
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]metaflac\f[R] [ \f[I]options\f[R] ] [ \f[I]operations\f[R] ]
\f[I]FLACfile \&...\f[R]
.SH "توضیحات (DESCRIPTION)"
از \f[B]metaflac\f[R] برای فهرست کردن، افزودن، حذف یا ویرایش فراداده در یک یا چند فایل FLAC استفاده کنید.
می‌توانید در هر بار یک عملیات اصلی یا چندین عملیات کوتاه‌نویسی را انجام دهید.
.SH "کاربرد کلی (GENERAL USAGE)"
دستور metaflac ویرایشگر خط فرمانی فراداده فایل‌های .flac است.
می‌توانید از آن برای فهرست کردن محتوای بلوک‌های فراداده، ویرایش، حذف یا درج بلوک‌ها و مدیریت پدینگ (padding) استفاده کنید.
.PP
دستور metaflac مجموعه‌ای از \[lq]گزینه‌ها\[rq] (اگرچه برخی از آن‌ها اختیاری نیستند) و مجموعه‌ای از فایل‌های FLAC را برای انجام عملیات دریافت می‌کند.
سه نوع \[lq]گزینه\[rq] وجود دارد:
.IP \[bu] 2
عملیات اصلی (Major operations) که حالت عملیات را مانند فهرست کردن بلوک‌ها، حذف بلوک‌ها و غیره مشخص می‌کنند.
این موارد زیر‌عملیاتی دارند که دقیقاً مشخص می‌کنند چه کاری باید انجام شود.
.IP \[bu] 2
عملیات کوتاه‌نویسی (Shorthand operations) که مترادف‌های راحتی برای عملیات اصلی هستند.
به عنوان مثال، یک عملیات کوتاه‌نویسی به نام \-\-show\-sample\-rate وجود دارد که فقط فیلد نرخ نمونه‌برداری (sample rate) را از بلوک فراداده STREAMINFO نمایش می‌دهد.
.IP \[bu] 2
گزینه‌های عمومی (Global options) که بر تمام عملیات تأثیر می‌گذارند.
.PP
تمام این موارد در بخش‌های زیر شرح داده شده‌اند.
باید حداقل یک عملیات اصلی یا یک عملیات کوتاه‌نویسی ارائه شود.
می‌توانید از چندین عملیات کوتاه‌نویسی برای انجام چند کار روی یک فایل یا مجموعه‌ای از فایل‌ها استفاده کنید.
بیشتر کارهای رایج روی فراداده‌ها دارای عملیات کوتاه‌نویسی هستند.
به عنوان مثال، در اینجا نحوه نمایش امضاهای MD5 برای مجموعه‌ای از سه فایل FLAC آمده است:
.PP
\f[CR]metaflac \-\-show\-md5sum file1.flac file2.flac file3.flac\f[R]
.PP
مثالی دیگر؛ این دستور تمام برچسب‌های DESCRIPTION و COMMENT را در مجموعه‌ای از فایل‌های FLAC حذف کرده و از گزینه عمومی \-\-preserve\-modtime برای حفظ زمان تغییر فایل‌های FLAC استفاده می‌کند (معمولاً هنگام ویرایش فایل‌ها، زمان تغییر آن‌ها به زمان جاری تنظیم می‌شود):
.PP
\f[CR]metaflac \-\-preserve\-modtime \-\-remove\-tag=DESCRIPTION \-\-remove\-tag=COMMENT file1.flac file2.flac file3.flac\f[R]
.SH "گزینه‌ها (OPTIONS)"
.TP
\f[B]\-o\f[R] \f[I]filename\f[R]\f[B], \-\-output\-name=\f[R]\f[I]filename\f[R]
خروجی را به جای تغییر یا بازنویسی فایل ورودی، در یک فایل جدید می‌نویسد.
.TP
\f[B]\-\-preserve\-modtime\f[R]
زمان تغییر اصلی فایل را با وجود ویرایش‌ها حفظ می‌کند.
این گزینه در صورت مشخص شدن \-o یا \[en]output\-name هیچ کاری انجام نمی‌دهد.
.TP
\f[B]\-\-with\-filename\f[R]
نام فایل FLAC را در ابتدای هر خط خروجی قرار می‌دهد (پیش‌فرض در صورتی که بیش از یک فایل FLAC مشخص شده باشد).
این گزینه بر گزینه‌هایی که به یک فایل خروجی صادر می‌کنند، مانند \-\-export\-tags\-to، بی‌تأثیر است.
.TP
\f[B]\-\-no\-filename\f[R]
نام فایل FLAC را در ابتدای خطوط خروجی قرار نمی‌دهد (پیش‌فرض در صورتی که تنها یک فایل FLAC مشخص شده باشد).
.TP
\f[B]\-\-no\-utf8\-convert\f[R]
برچسب‌ها را از UTF\-8 به مجموعه نویسه‌های محلی یا برعکس تبدیل نمی‌کند.
این گزینه برای اسکریپت‌ها و مقداردهی برچسب‌ها در شرایطی که locale نادرست است مفید خواهد بود.
.TP
\f[B]\-\-dont\-use\-padding\f[R]
به‌طور پیش‌فرض metaflac تلاش می‌کند تا در صورت امکان از لایه‌گذاری (padding) استفاده کند تا در صورت تغییر اندازه فراداده، از بازنویسی کل فایل جلوگیری شود.
با استفاده از این گزینه به metaflac دستور داده می‌شود که بدین شیوه از لایه‌گذاری استفاده نکند.
.SH "عملیات کوتاه‌نویسی (SHORTHAND OPERATIONS)"
.TP
\f[B]\-\-show\-md5sum\f[R]
امضای MD5 را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-min\-blocksize\f[R]
حداقل اندازه بلوک را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-max\-blocksize\f[R]
حداکثر اندازه بلوک را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-min\-framesize\f[R]
حداقل اندازه فریم را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-max\-framesize\f[R]
حداکثر اندازه فریم را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-sample\-rate\f[R]
نرخ نمونه‌برداری را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-channels\f[R]
تعداد کانال‌ها را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-bps\f[R]
تعداد بیت در هر نمونه را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-total\-samples\f[R]
تعداد کل نمونه‌ها را از بلوک STREAMINFO نمایش می‌دهد.
.TP
\f[B]\-\-show\-vendor\-tag\f[R]
رشته سازنده (vendor string) را از بلوک VORBIS_COMMENT نمایش می‌دهد.
.TP
\f[B]\-\-show\-tag=name\f[R]
تمام برچسب‌هایی را که نام فیلد آن‌ها با `name' مطابقت دارد نمایش می‌دهد.
.TP
\f[B]\-\-show\-all\-tags\f[R]
تمام برچسب‌ها را نمایش می‌دهد.
این گزینه نام مستعاری برای \-\-export\-tags\-to=\- است.
.TP
\f[B]\-\-remove\-tag=name\f[R]
تمام برچسب‌هایی را که نام فیلد آن‌ها `name' است حذف می‌کند.
.TP
\f[B]\-\-remove\-first\-tag=name\f[R]
اولین برچسبی را که نام فیلد آن `name' است حذف می‌کند.
.TP
\f[B]\-\-remove\-all\-tags\f[R]
تمام برچسب‌ها را حذف کرده و فقط رشته vendor را باقی می‌گذارد.
.TP
\f[B]\-\-remove\-all\-tags\-except=NAME1[=NAME2[=\&...]]\f[R]
تمام برچسب‌ها را به‌جز رشته vendor و نام‌های مشخص‌شده برچسب حذف می‌کند.
نام‌های برچسب باید با نویسه = از یکدیگر جدا شوند.
.TP
\f[B]\-\-set\-tag=field\f[R]
یک برچسب اضافه می‌کند.
فیلد باید با مشخصات کامنت Vorbis، به صورت \[lq]NAME=VALUE\[rq] مطابقت داشته باشد.
اگر در حال حاضر بلوک برچسبی وجود نداشته باشد، یکی ایجاد خواهد شد.
.TP
\f[B]\-\-set\-tag\-from\-file=field\f[R]
مشابه \-\-set\-tag عمل می‌کند، با این تفاوت که VALUE یک نام فایل است که محتوای آن عیناً برای مقدار برچسب خوانده می‌شود.
مگر اینکه \-\-no\-utf8\-convert مشخص شده باشد، محتوا از مجموعه نویسه‌های محلی به UTF\-8 تبدیل خواهد شد.
این مورد می‌تواند برای ذخیره یک cuesheet در برچسب استفاده شود (مثلاً
\-\-set\-tag\-from\-file=\[lq]CUESHEET=image.cue\[rq]).
سعی نکنید داده‌های باینری را در فیلدهای برچسب ذخیره کنید!
برای این منظور از بلوک‌های APPLICATION استفاده کنید.
.TP
\f[B]\-\-import\-tags\-from=file\f[R]
برچسب‌ها را از یک فایل وارد می‌کند.
از `\-' برای stdin استفاده کنید.
هر خط باید به صورت NAME=VALUE باشد.
در حال حاضر کامنت‌های چندخطی پشتیبانی نمی‌شوند.
در صورت لزوم، قبل از \-\-import\-tags\-from گزینه‌های \-\-remove\-all\-tags و/یا \-\-no\-utf8\-convert را مشخص کنید.
اگر FILE مقدار `\-' (ورودی استاندارد) باشد، تنها یک فایل FLAC می‌تواند مشخص شود.
.TP
\f[B]\-\-export\-tags\-to=file\f[R]
برچسب‌ها را به یک فایل صادر می‌کند.
از `\-' برای stdout استفاده کنید.
هر خط به صورت NAME=VALUE خواهد بود.
در صورت لزوم \-\-no\-utf8\-convert را مشخص کنید.
.TP
\f[B]\-\-import\-cuesheet\-from=file\f[R]
یک cuesheet را از یک فایل وارد می‌کند.
از `\-' برای stdin استفاده کنید.
تنها یک فایل FLAC می‌تواند مشخص شود.
به ازای هر نقطه شاخص (index point) در cuesheet یک نقطه جستجو (seekpoint) به SEEKTABLE اضافه می‌شود مگر اینکه \-\-no\-cued\-seekpoints مشخص شده باشد.
.TP
\f[B]\-\-export\-cuesheet\-to=file\f[R]
بلوک CUESHEET را به یک فایل cuesheet صادر می‌کند که برای استفاده در نرم‌افزارهای رایت CD مناسب است.
از `\-' برای stdout استفاده کنید.
تنها یک فایل FLAC می‌تواند در خط فرمان مشخص شود.
.TP
\f[B]\-\-import\-picture\-from={\f[R]\f[I]FILENAME\f[R]\f[B]|\f[R]\f[I]SPECIFICATION\f[R]\f[B]}\f[R]
یک تصویر را وارد کرده و در یک بلوک فراداده PICTURE ذخیره می‌کند.
بیش از یک دستور \-\-import\-picture\-from می‌تواند مشخص شود.
می‌توان از یک نام فایل برای فایل تصویر یا از یک قالب مشخصات کامل‌تر استفاده کرد.
مقدار SPECIFICATION رشته‌ای است که بخش‌های آن با نویسه | (pipe) از هم جدا شده‌اند.
برخی بخش‌ها می‌توانند خالی رها شوند تا از مقادیر پیش‌فرض استفاده شود.
مقدار FILENAME صرفاً حالت کوتاه‌نویسی برای \[lq]||||FILENAME\[rq] است.
برای جزئیات درباره مشخصات، بخش \f[B]Picture specification\f[R] را در صفحه راهنمای \f[B]flac(1)\f[R] ببینید.
.TP
\f[B]\-\-export\-picture\-to=file\f[R]
بلوک PICTURE را به یک فایل صادر می‌کند.
از `\-' برای stdout استفاده کنید.
تنها یک فایل FLAC می‌تواند در خط فرمان مشخص شود.
اولین بلوک PICTURE صادر خواهد شد مگر اینکه پیش از \-\-export\-picture\-to گزینه \-\-block\-number=# مشخص شود تا بلوک فراداده دقیق جهت استخراج تعیین گردد.
توجه داشته باشید که شماره بلوک همان شماره‌ای است که توسط \-\-list نمایش داده می‌شود.
.TP
\f[B]\-\-add\-replay\-gain\f[R]
میزان بهره/اوج (gain/peak) عنوان و آلبوم فایل‌های FLAC داده‌شده را به‌گونه‌ای محاسبه می‌کند که گویی تمام فایل‌ها بخشی از یک آلبوم بوده‌اند، سپس آن‌ها را به عنوان برچسب‌های FLAC ذخیره می‌نماید.
برچسب‌ها مشابه مواردی هستند که توسط vorbisgain استفاده می‌شوند.
برچسب‌های موجود ReplayGain جایگزین خواهند شد.
اگر تنها یک فایل FLAC داده شود، مقادیر بهره آلبوم و عنوان یکسان خواهد بود.
از آنجا که این عملیات به دو گذر (pass) نیاز دارد، همواره در پایان و پس از اتمام تمام عملیات دیگر و نوشتن روی دیسک اجرا می‌شود.
تمام فایل‌های FLAC مشخص‌شده باید دارای تفکیک‌پذیری، نرخ نمونه‌برداری و تعداد کانال‌های یکسان باشند.
تنها فایل‌های مونو و استریو مجاز هستند و نرخ نمونه‌برداری باید یکی از مقادیر 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 کیلوهرتز باشد.
.TP
\f[B]\-\-scan\-replay\-gain\f[R]
مشابه \-\-add\-replay\-gain عمل می‌کند، اما به جای نوشتن در برچسب‌ها، تنها فایل‌ها را تحلیل می‌کند.
.TP
\f[B]\-\-remove\-replay\-gain\f[R]
برچسب‌های ReplayGain را حذف می‌کند.
.TP
\f[B]\-\-add\-seekpoint={\f[R]\f[I]#\f[R]\f[B]|\f[R]\f[I]X\f[R]\f[B]|\f[R]\f[I]#x\f[R]\f[B]|\f[R]\f[I]#s\f[R]\f[B]}\f[R]
نقاط جستجو (seek points) را به یک بلوک SEEKTABLE اضافه می‌کند.
با استفاده از #، یک نقطه جستجو در آن شماره نمونه اضافه می‌شود.
با استفاده از X، یک نقطه نگه‌دارنده مکان (placeholder) در انتهای جدول اضافه می‌شود.
با استفاده از #x، تعداد # نقطه جستجو با فواصل یکسان اضافه خواهد شد که اولین نقطه در نمونه 0 قرار دارد.
با استفاده از #s، یک نقطه جستجو در هر # ثانیه اضافه می‌شود (# نیازی نیست یک عدد صحیح باشد؛ مثلاً می‌تواند 9.5 باشد که به معنی یک نقطه جستجو در هر 9.5 ثانیه است).
اگر هیچ بلوک SEEKTABLE وجود نداشته باشد، یکی ایجاد خواهد شد.
اگر بلوکی وجود داشته باشد، نقاط به جدول موجود اضافه شده و موارد تکراری به نقاط نگه‌دارنده تبدیل می‌شوند.
می‌توانید از چندین گزینه \-\-add\-seekpoint استفاده کنید؛ جدول SEEKTABLE حاصل، اجتماع یکتاشده‌ای از تمام این مقادیر خواهد بود.
مثال: \-\-add\-seekpoint=100x \-\-add\-seekpoint=3.5s تعداد 100 نقطه جستجو با فواصل یکسان و یک نقطه جستجو در هر 3.5 ثانیه اضافه می‌کند.
.TP
\f[B]\-\-add\-padding=length\f[R]
یک بلوک لایه‌گذاری (padding) با طول داده‌شده (به بایت) اضافه می‌کند.
طول کلی بلوک جدید 4 + length خواهد بود؛ ۴ بایت اضافه برای سربرگ بلوک فراداده است.
.SH "عملیات اصلی (MAJOR OPERATIONS)"
.TP
\f[B]\-\-list\f[R]
محتوای یک یا چند بلوک فراداده را در stdout فهرست می‌کند.
به‌طور پیش‌فرض، تمام بلوک‌های فراداده در قالب متنی فهرست می‌شوند.
برای تغییر این رفتار از گزینه‌های \f[B]\-\-block\-number\f[R]، \f[B]\-\-block\-type\f[R] یا \f[B]\-\-except\-block\-type\f[R] استفاده کنید.
.TP
\f[B]\-\-remove\f[R]
یک یا چند بلوک فراداده را از فراداده فایل حذف می‌کند.
از گزینه‌های \f[B]\-\-block\-number\f[R]، \f[B]\-\-block\-type\f[R] یا \f[B]\-\-except\-block\-type\f[R] برای مشخص کردن بلوک‌های مورد نظر جهت حذف استفاده کنید.
توجه داشته باشید که اگر هر دو گزینه \-\-block\-number و \-\-[except\-]block\-type مشخص شوند، نتیجه عملیات AND منطقی هر دو آرگومان خواهد بود.
مگر اینکه \-\-dont\-use\-padding مشخص شده باشد، بلوک‌ها با لایه‌گذاری جایگزین می‌شوند.
نمی‌توانید بلوک STREAMINFO را حذف کنید.
.TP
\f[B]\-\-block\-number=#[,#[\&...]]\f[R]
فهرست اختیاری جداشده با کاما از شماره بلوک‌ها برای نمایش.
اولین بلوک، یعنی بلوک STREAMINFO، بلوک 0 است.
.PP
\f[B]\-\-block\-type=type[,type[\&...]]\f[R]
.TP
\f[B]\-\-except\-block\-type=type[,type[\&...]]\f[R]
فهرست اختیاری جداشده با کاما از انواع بلوک‌ها که با این گزینه گنجانده یا نادیده گرفته می‌شوند.
تنها از یکی از گزینه‌های \-\-block\-type یا \-\-except\-block\-type استفاده کنید.
انواع بلوک‌های معتبر عبارتند از: STREAMINFO، PADDING، APPLICATION، SEEKTABLE، VORBIS_COMMENT، PICTURE.
می‌توانید انواع بلوک‌های APPLICATION انتخاب‌شده را با افزودن دونقطه و شناسه بلوک APPLICATION به صورت نمایش ASCII یا هگزادسیمال محدودتر کنید.
به عنوان مثال:
APPLICATION:abcd برای بلوک(های) APPLICATION که نمایش متنی شناسه ۴ بایتی آن \[lq]abcd\[rq] است، یا
APPLICATION:0xXXXXXXXX برای بلوک(های) APPLICATION که نمایش هگزادسیمال big\-endian شناسه ۴ بایتی آن \[lq]0xXXXXXXXX\[rq] است.
برای مثال \[lq]abcd\[rq] بالا، معادل هگزادسیمال آن 0x61626364 است.
.TP
\f[B]\-\-application\-data\-format=hexdump|text\f[R]
اگر بلوک کاربردی (application) مورد نمایش حاوی داده‌های باینری باشد اما گزینه \-\-data\-format=text تنظیم شده باشد، می‌توانید با استفاده از \-\-application\-data\-format=hexdump به جای آن یک تخلیه هگز (hex dump) از محتوای داده‌های بلوک را نمایش دهید.
.TP
\f[B]\-\-data\-format=binary|binary\-headerless|text\f[R]
جهت استفاده همراه با \-\-list.
به‌طور پیش‌فرض یک نمایش متنی انسان‌خوانا از داده‌ها نمایش داده می‌شود.
می‌توانید \-\-data\-format=binary را مشخص کنید تا فرم باینری خام هر بلوک فراداده تخلیه شود.
برای حذف سربرگ بلوک‌های فراداده از خروجی، از جمله شناسه بلوک‌های فراداده APPLICATION، گزینه \-\-data\-format=binary\-headerless را مشخص کنید.
.TP
\f[B]\-\-append\f[R]
یک بلوک فراداده را از یک فایل درج می‌کند.
این بلوک باید یک بلوک باینری صادرشده توسط \-\-list \-\-data\-format=binary باشد.
نقطه درج با \-\-block\-number=# مشخص می‌شود.
بلوک جدید پس از شماره بلوک داده‌شده اضافه خواهد شد.
این امر از درج غیرقانونی یک بلوک قبل از نخستین بلوک STREAMINFO جلوگیری می‌کند.
نمی‌توانید یک بلوک STREAMINFO دیگر را با \-\-append اضافه کنید.
با استفاده از این گزینه امکان کپی کردن یک بلوک فراداده از فایلی به فایل دیگر وجود دارد.
به عنوان مثال، از دستور زیر برای استخراج بلوک:
\f[CR]metaflac \-\-list \-\-data\-format=binary \-\-block\-number=6 file.flac > block\f[R]
و سپس برای وارد کردن آن از دستور زیر استفاده کنید:
\f[CR]metaflac \-\-append anotherfile.flac < block\f[R]
.TP
\f[B]\-\-remove\-all\f[R]
تمام بلوک‌های فراداده (به‌جز بلوک STREAMINFO) را از فراداده حذف می‌کند.
مگر اینکه \-\-dont\-use\-padding مشخص شده باشد، بلوک‌ها با لایه‌گذاری جایگزین خواهند شد.
.TP
\f[B]\-\-merge\-padding\f[R]
بلوک‌های مجاور PADDING را در یک بلوک ادغام می‌کند.
.TP
\f[B]\-\-sort\-padding\f[R]
تمام بلوک‌های PADDING را به انتهای فراداده منتقل کرده و آن‌ها را در یک بلوک واحد ادغام می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
\f[B]flac(1)\f[R]