.TH MP4Box 1 2019 MP4Box GPAC
.
.SH "نام (NAME)"
.LP
MP4Box \- بسته‌بند چندرسانه‌ای خط فرمان GPAC
.SH "خلاصه دستور (SYNOPSIS)"
.LP
.B MP4Box
.RI [options] \ [file] \ [options]
.br
.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.LP
.br
ابزار MP4Box یک بسته‌بند چندرسانه‌ای با قابلیت‌های فراوان است: تبدیل، تکه‌تکه کردن (splitting)، هینت‌گذاری (hinting)، استخراج اطلاعات (dumping)، آماده‌سازی برای DASH، رمزنگاری، تبدیل کد (transcoding) و موارد دیگر.
.br
ابزار MP4Box مجموعهٔ گسترده‌ای از گزینه‌ها را ارائه می‌دهد که بر پایه دسته‌بندی تفکیک شده‌اند (گزینهٔ .I \-h را ببینید). این گزینه‌ها از ترتیب خاصی پیروی نمی‌کنند.
.br
  
.br
به‌طور پیش‌فرض، MP4Box فایل ورودی را بازنویسی می‌کند. می‌توانید این رفتار را با استفاده از گزینهٔ .I out تغییر دهید.
.br
ابزار MP4Box به‌طور پیش‌فرض فایل را با درهم‌آمیزی (interleaving) ۰٫۵ ثانیه‌ای و فراداده‌ها (مانند moov و...) در ابتدا ذخیره می‌کند، که آن را برای دانلود و پخش هم‌زمان از طریق HTTP مناسب می‌سازد. با این حال، ممکن است ذخیرهٔ فایل بیشتر زمان ببرد؛ برای تغییر این رفتار از گزینهٔ .I flat استفاده کنید.
.br
  
.br
ابزار MP4Box معمولاً هنگام ایجاد یک فایل جدید IsoMedia، یک فایل موقت می‌سازد. مکان این فایل موقت وابسته به سیستم‌عامل است، و ممکن است درایو یا پارتیشنی که فایل موقت در آن ایجاد می‌شود فضای کافی یا دسترسی نوشتن نداشته باشد. در چنین حالتی، می‌توانید مکان فایل موقت را با .I \-tmp تعیین کنید.
.br
  
.br
شناسهٔ ترک برای عملیات‌های مبتنی بر قطعه (که معمولاً در راهنما با tkID نشان داده می‌شود) از ساختار نگارشی زیر پیروی می‌کند:
.br
* INT: هدف ترکی با شناسهٔ INT است
.br
* n`INT`: هدف ترک شمارهٔ INT است
.br
* `audio`، `video`، `text`: هدف اولین ترک صوتی، تصویری یا متنی است
.br
* `audioN`، `videoN`، `textN`: هدف Nاُمین ترک صوتی، تصویری یا متنی است، که N=1 اولین ترک از نوع مورد نظر است
.br
  
.br
مقادیر گزینه‌ها:
.br
مگر در مواردی که مشخص شده باشد، یک گزینهٔ عملیات روی ترک از نوع عدد صحیح، در ادامه نیازمند یک مقدار شناسهٔ ترک است.
.br
یک گزینه از نوع دودویی (boolean) نیازمند مقداری در ادامهٔ خود نیست.
.br
  
.br
.TP
.B \-mem-track
.br
فعال‌سازی ردگیر حافظه (memory tracker)
.br
.TP
.B \-mem-track-stack
.br
فعال‌سازی ردگیر حافظه به همراه تخلیهٔ پشته (stack dumping)
.br
.TP
.B \-p (string)
.br
استفاده از نمایهٔ (profile) مشخص‌شده برای پیکربندی سراسری GPAC. اگر پیدا نشود، فایل پیکربندی ایجاد می‌شود. اگر مسیر یک فایل مشخص شده باشد، نمایه از آن فایل بارگذاری خواهد شد. در غیر این صورت، دایرکتوری با نام مشخص‌شده ایجاد و پیکربندی جدید در آن ذخیره می‌شود. نام رزرو‌شدهٔ 0 به معنای یک نمایهٔ جدید است که روی دیسک ذخیره نمی‌شود. با ساختار -p=NAME یا -p NAME کار می‌کند.
.br
.TP
.B \-inter (number, default: 0.5)
.br
درهم‌آمیزی (interleave) فایل و تولید قطعات ترک (chunks) با مدت‌زمان مشخص‌شده به میلی‌ثانیه. مقدار 0 درهم‌آمیزی را غیرفعال می‌کند
.br
.TP
.B \-old-inter (number)
.br
مشابه .I inter اما بدون اصلاح انحراف (drift correction)
.br
.TP
.B \-tight
.br
درهم‌آمیزی فشردهٔ فایل (مبتنی بر نمونه). این کار عملیات جستجوی دیسک (seek) را کاهش اما اندازهٔ فایل را افزایش می‌دهد
.br
.TP
.B \-flat
.br
ذخیرهٔ فایل با قرار دادن تمام داده‌های رسانه‌ای در ابتدا و بدون درهم‌آمیزی. این کار سرعت نوشتن را هنگام ایجاد فایل‌های جدید افزایش می‌دهد
.br
.TP
.B \-frag (number)
.br
تکه‌تکه کردن (fragment) فایل و تولید بخش‌های ترک با مدت‌زمان مشخص‌شده به میلی‌ثانیه. این کار درهم‌آمیزی را غیرفعال می‌کند
.br
.TP
.B \-out (string)
.br
مشخص کردن نام فایل خروجی ISOBMFF. به‌طور پیش‌فرض فایل ورودی بازنویسی می‌شود
.br
.TP
.B \-co64
.br
اجبار به استفاده از آفست‌های قطعهٔ ۶۴ بیتی برای فایل‌های ISOBMFF
.br
.TP
.B \-new
.br
اجبار به ایجاد یک فایل مقصد جدید
.br
.TP
.B \-newfs
.br
اجبار به ایجاد یک فایل مقصد جدید بدون فایل موقت اما با پشتیبانی از درهم‌آمیزی
.br
.TP
.B \-no-sys,-nosys
.br
حذف تمام اطلاعات MPEG-4 Systems به جز IOD که برای نمایه‌ها نگه داشته می‌شود. این حالت پیش‌فرض هنگام ایجاد محتوای معمولی صوتی/تصویری است
.br
.TP
.B \-no-iod
.br
حذف MPEG-4 InitialObjectDescriptor از فایل
.br
.TP
.B \-mfra
.br
درج آفست تصادفی قطعهٔ فیلم (movie fragment random offset) هنگام قطعه‌قطعه کردن فایل (در حالت dash نادیده گرفته می‌شود)
.br
.TP
.B \-isma
.br
بازنویسی فایل به عنوان یک فایل ISMA 1.0
.br
.TP
.B \-ismax
.br
مشابه .I isma همراه با حذف تمامی ارجاعات ساعت
.br
.TP
.B \-3gp
.br
بازنویسی به عنوان فایل 3GPP(2) (بدون اطلاعات سامانه‌های MPEG-4)؛ اگر پسوند فایل مقصد ‎.3gp‏، ‎.3g2 یا ‎.3gpp باشد همیشه فعال است. ممکن است برخی ترک‌ها در این فرایند حذف شوند
.br
.TP
.B \-ipod
.br
بازنویسی فایل برای iPod یا نسخه‌های قدیمی iTunes
.br
.TP
.B \-psp
.br
بازنویسی فایل برای دستگاه‌های PSP
.br
.TP
.B \-brand (string)
.br
تنظیم نشان اصلی (major brand) فایل (ABCD) یا نشان همراه با نگارش اختیاری (ABCD:v)
.br
.TP
.B \-ab (string)
.br
افزودن نشان (brand) داده‌شده به فهرست نشان‌های جایگزین
.br
.TP
.B \-rb (string)
.br
حذف نشان (brand) داده‌شده از فهرست نشان‌های جایگزین
.br
.TP
.B \-cprt (string)
.br
افزودن رشتهٔ حق نشر (کپی‌رایت) به فایل
.br
.TP
.B \-chap (string)
.br
تنظیم اطلاعات فصل‌بندی از فایل مشخص‌شده. فرمت‌های زیر در فایل متنی فصل پشتیبانی می‌شوند (اما نباید با هم ترکیب شوند):
.br
  * نرم‌افزار ZoomPlayer: شامل AddChapter(nb_frames,chapter name)، AddChapterBySeconds(nb_sec,chapter name) و AddChapterByTime(h,m,s,chapter name) با ۱ فصل در هر خط
.br
  * کدهای زمانی: به‌صورت h:m:s chapter_name و h:m:s:ms chapter_name و h:m:s.ms chapter_name با ۱ فصل در هر خط
.br
  * کدهای SMPTE: به‌صورت h:m:s;nb_f/fps chapter_name و h:m:s;nb_f chapter_name که در آن nb_f تعداد فریم‌ها و fps نرخ فریم است با ۱ فصل در هر خط
.br
  * ساختار معمول: CHAPTERX=h:m:s[:ms or .ms] در خط اول و CHAPTERXNAME=name در خط بعدی (ترتیب معکوس نیز پذیرفته می‌شود)
.br
.TP
.B \-chapqt (string)
.br
تنظیم اطلاعات فصل‌بندی از فایل مشخص‌شده با استفاده از سیگنالینگ سبک QT برای ترک‌های متنی
.br
.TP
.B \-set-track-id tkID:id2
.br
تغییر شناسهٔ ترک به id2
.br
.TP
.B \-swap-track-id tkID1:tkID1
.br
جابه‌جایی شناسه میان ترک‌های دارای شناسهٔ id1 و id2
.br
.TP
.B \-rem (int)
.br
حذف ترک داده‌شده از فایل
.br.TP
.B \-rap (int)
.br
حذف تمام نمونه‌های غیر RAP از قطعهٔ مشخص‌شده
.br
.TP
.B \-refonly (int)
.br
حذف تمام فریم‌های غیرمرجع از قطعهٔ مشخص‌شده
.br
.TP
.B \-enable (int)
.br
فعال‌سازی قطعهٔ مشخص‌شده
.br
.TP
.B \-disable (int)
.br
غیرفعال‌سازی قطعهٔ مشخص‌شده
.br
.TP
.B \-timescale (int, default: 600)
.br
تنظیم مقیاس زمانی (timescale) فیلم به مقدار داده‌شده (تیک بر ثانیه)
.br
.TP
.B \-set-vexu
.br
افزودن جعبهٔ vexu به فایل MV-HEVC MP4
.br
.TP
.B \-hero-eye (int, default: 0)
.br
تنظیم hero_eye_indicator در HeroStereoEyeDescriptionBox (0 = هیچ‌کدام، 1 = چپ، 2 = راست)
.br
.TP
.B \-lang [tkID=]LAN
.br
تنظیم زبان. LAN همان کد BCP-47 است (eng، en-UK، ...). اگر شناسهٔ قطعه‌ای داده نشود، زبان برای تمام قطعه‌ها تنظیم می‌شود
.br
.TP
.B \-delay tkID=TIME
.br
تنظیم تاخیر شروع قطعه (0<) یا پرش آغازین (0>) بر حسب میلی‌ثانیه یا کسری از ثانیه (N/D)
.br
.TP
.B \-par tkID=PAR
.br
تنظیم نسبت ابعاد پیکسل (PAR) قطعهٔ تصویری. PAR یکی از موارد زیر است:
.br
  * N:D: مقدار PAR را در قطعه روی N:D تنظیم می‌کند، بدون تغییر دادن bitstream
.br
  * wN:D: مقدار PAR را در قطعه روی N:D تنظیم کرده و برای تغییر دادن bitstream تلاش می‌کند
.br
  * none: اطلاعات PAR را از قطعه حذف می‌کند، بدون تغییر دادن bitstream
.br
  * auto: اطلاعات PAR را از bitstream استخراج کرده و آن را در قطعه تنظیم می‌کند
.br
  * force: مقدار PAR را در قطعه به 1:1 اجبار می‌کند، بدون تغییر دادن bitstream
.br
.TP
.B \-clap tkID=CLAP
.br
تنظیم روزنهٔ تمیز (clean aperture) قطعهٔ تصویری. CLAP به‌صورت Wn,Wd,Hn,Hd,HOn,HOd,VOn,VOd یا none است
.br
* n, d: صورت، مخرج
.br
* W, H, HO, VO: عرض clap، ارتفاع clap، آفست افقی clap، آفست عمودی clap
.br

.br
.TP
.B \-mx tkID=MX
.br
تنظیم ماتریس قطعه، که در آن MX به‌صورت M1:M2:M3:M4:M5:M6:M7:M8:M9 در قالب اعداد ممیز ثابت ۱۶.۱۶ (16.16 fixed point) یا هگزادسیمال است
.br
.TP
.B \-kind tkID=schemeURI=value
.br
تنظیم نوع (kind) برای قطعه یا برای تمام قطعه‌ها با استفاده از all=schemeURI=value
.br
.TP
.B \-kind-rem tkID=schemeURI=value
.br
حذف نوع (kind) در صورت وجود schemeID داده‌شده برای قطعه یا برای تمام قطعه‌ها با all=schemeURI=value
.br
.TP
.B \-name tkID=NAME
.br
تنظیم نام گردانندهٔ قطعه (track handler name) به NAME (رشتهٔ UTF-8)
.br
.TP
.B \-tags,-itags (string)
.br
تنظیم برچسب‌های iTunes روی فایل، به \-h tags مراجعه کنید
.br
.TP
.B \-group-add (string)
.br
ایجاد اطلاعات گروه‌بندی جدید در فایل. قالب به‌صورت فهرستی از گزینه‌های زیر است که با دو‌نقطه (:) جدا شده‌اند:
.br
* refTrack=ID: قطعه‌ای که به‌عنوان مرجع گروه استفاده می‌شود. اگر تنظیم نشود، قطعه به همان گروه trackID مشخص‌شدهٔ قبلی تعلق خواهد داشت. اگر 0 باشد یا قطعهٔ قبلی مشخص نشده باشد، یک گروه جایگزین (alternate group) جدید ایجاد خواهد شد
.br
* switchID=ID: شناسهٔ switch group برای ایجاد. اگر 0 باشد، یک شناسهٔ جدید محاسبه خواهد شد. اگر کوچکتر از صفر (<0) باشد، SwitchGroup غیرفعال می‌شود
.br
* criteria=string: فهرستی از 4CCها که با فاصله جدا شده‌اند
.br
* trackID=ID: قطعه‌ای که باید به این گروه افزوده شود
.br
  
.br
هشدار: گزینه‌ها هم‌زمان با پردازش، وضعیت را تغییر می‌دهند؛ trackID=1:criteria=lang:trackID=2 با criteria=lang:trackID=1:trackID=2 متفاوت است
.br

.br
.TP
.B \-group-rem-track (int)
.br
حذف قطعهٔ مشخص‌شده از گروه خود
.br
.TP
.B \-group-rem (int)
.br
حذف گروه مربوط به قطعه
.br
.TP
.B \-group-clean
.br
حذف تمام اطلاعات گروه‌بندی از تمام قطعه‌ها
.br
.TP
.B \-ref tkID:R4CC:refID
.br
افزودن مرجعی از نوع R4CC از قطعهٔ ID به قطعهٔ refID (اگر refID برابر 0 باشد مرجع قطعه حذف می‌شود)
.br
.TP
.B \-keep-utc
.br
حفظ زمان‌بندی UTC در فایل پس از ویرایش
.br
.TP
.B \-udta tkID:[OPTS]
.br
تنظیم udta برای قطعهٔ مشخص‌شده یا کل فیلم در صورتی که tkID برابر 0 باشد. OPTS فهرستی جداشده با دو‌نقطه (:) از موارد زیر است:
.br
* type=CODE: کد 4CC مربوط به UDTA (برای گزینهٔ box= لازم نیست)
.br
* box=FILE: مکان داده‌های udta، قالب‌بندی‌شده به‌صورت جعبه‌های سریال‌شده (serialized boxes)
.br
* box=base64,DATA: داده‌های udta کدگذاری‌شده با base64، قالب‌بندی‌شده به‌صورت جعبه‌های سریال‌شده
.br
* src=FILE: مکان داده‌های udta (در یک جعبهٔ منفرد از نوع CODE ذخیره خواهد شد)
.br
* src=base64,DATA: داده‌های udta کدگذاری‌شده با base64 (در یک جعبهٔ منفرد از نوع CODE ذخیره خواهد شد)
.br
* str=STRING: استفاده از رشتهٔ مشخص‌شده به‌عنوان بار مفید داده (payload) برای جعبهٔ udta
.br
نکته: اگر هیچ منبعی تعیین نشود، UDTA از نوع CODE حذف خواهد شد
.br

.br
.TP
.B \-patch [tkID=]FILE
.br
اعمال وصلهٔ جعبه (box patch) شرح‌داده‌شده در FILE، در صورت تعیین برای trackID مشخص‌شده
.br
.TP
.B \-bo
.br
تثبیت ترتیب جعبه‌ها (boxes) در فایل ورودی
.br
.TP
.B \-init-seg (string)
.br
استفاده از فایل داده‌شده به‌عنوان یک قطعهٔ راه‌اندازی (init segment) برای استخراج داده یا برای رمزگذاری
.br
.TP
.B \-zmov
.br
فشرده‌سازی جعبهٔ فیلم مطابق با فشرده‌سازی جعبهٔ ISOBMFF، یا در صورت داشتن پسوند mov مطابق با QT
.br
.TP
.B \-xmov
.br
مشابه zmov به همراه قرار دادن ftyp در داخل otyp
.br
.TP
.B \-edits tkID=EDITS
.br
تنظیم فهرست ویرایش (edit list). از نحو زیر استفاده می‌شود (بدون جداکننده بین ورودی‌ها):
.br
 * `r`: حذف تمام ویرایش‌ها
.br
 * `eSTART`: افزودن ویرایش خالی با زمان شروع مشخص‌شده. START می‌تواند یکی از موارد زیر باشد:
.br
   - VAL: زمان شروع بر حسب ثانیه (int، double، کسر)، از مدت‌زمان رسانه به‌عنوان مدت‌زمان ویرایش استفاده می‌شود
.br
   - VAL-DUR: زمان شروع و مدت‌زمان بر حسب ثانیه (int، double، کسر)
.br
 * `eSTART,MEDIA[,RATE]`: افزودن ویرایش عادی با زمان شروع مشخص‌شده، زمان شروع رسانه بر حسب ثانیه (int، double، کسر) و نرخ پخش (کسر یا INT)
.br
 * مثال‌ها: 
.br
   - re0-5e5-3,4: حذف ویرایش‌ها، افزودن ویرایش خالی در 0s به مدت 5s، سپس افزودن ویرایش عادی در 5s به مدت 3s با شروع از 4s در قطعهٔ رسانه
.br
   - re0-4,0,0.5: حذف ویرایش‌ها، افزودن یک ویرایش در 0s به مدت 4s با شروع از 0s در قطعهٔ رسانه و پخش با سرعت 0.5
.br

.br.TP
.B \-moovpad (int)
.br
مشخص کردن میزان لایه پرکننده (padding) برای نگه‌داشتن پس از جعبه moov جهت ویرایش درجا (inplace) بعدی \- در صورت 0 بودن، padding جعبه moov غیرفعال می‌شود
.br
.TP
.B \-no-inplace
.br
غیرفعال کردن بازنویسی درجا (inplace)
.br
.TP
.B \-hdr (string)
.br
به‌روزرسانی اطلاعات HDR بر اساس XML ارائه‌شده، مقدار \(aqnone\(aq اطلاعات HDR را حذف می‌کند
.br
.TP
.B \-time [tkID=]DAY/MONTH/YEAR-H:M:S
.br
تنظیم زمان ایجاد فیلم یا تراک
.br
.TP
.B \-mtime tkID=DAY/MONTH/YEAR-H:M:S
.br
تنظیم زمان ایجاد رسانه
.br
.SH "گزینه‌های استخراج (Extracting Options)"
.LP
.br
از MP4Box می‌توان برای استخراج تراک‌های رسانه‌ای از فایل‌های MP4 استفاده کرد. با این حال، اگر نیاز به تبدیل این تراک‌ها دارید، لطفاً مستندات فیلترها را بررسی کنید.
.br
  
.br
گزینه‌ها:
.br
.TP
.B \-raw (string)
.br
استخراج تراک داده‌شده در قالب خام (raw) در صورت پشتیبانی. برای تعیین نام فایل خروجی از tkID:output=FileName استفاده کنید
.br
.TP
.B \-raws (string)
.br
استخراج هر نمونه از تراک داده‌شده در یک فایل. برای استخراج N\-امین نمونه از tkID:N استفاده کنید
.br
.TP
.B \-nhnt (int)
.br
استخراج تراک داده‌شده به قالب NHNT
.br
.TP
.B \-nhml (string)
.br
استخراج تراک داده‌شده به قالب NHML. برای دامپ کامل NHML به همراه تمام ویژگی‌های بسته از tkID:full استفاده کنید
.br
.TP
.B \-webvtt-raw (string)
.br
استخراج تراک داده‌شده به‌صورت رسانه خام در WebVTT به عنوان متاداده. برای گنجاندن داده‌های رسانه در فایل WebVTT از tkID:embedded استفاده کنید
.br
.TP
.B \-single (int)
.br
استخراج تراک داده‌شده به یک فایل mp4 جدید
.br
.TP
.B \-six (int)
.br
استخراج تراک داده‌شده به‌صورت رسانه خام در دستورالعمل‌های آزمایشی جریان‌سازی XML
.br
.TP
.B \-mux (string)
.br
تسهیم (multiplex) فایل ورودی به مقصد داده‌شده
.br
.TP
.B \-qcp (int)
.br
مشابه .I raw اما به‌طور پیش‌فرض از فایل QCP برای EVRC/SMV استفاده می‌کند
.br
.TP
.B \-saf
.br
تسهیم فایل ورودی به تسهیم SAF
.br
.TP
.B \-dvbhdemux
.br
تفکیک (demultiplex) فایل DVB-H به دیتاگرام‌های IP ارسال‌شده روی شبکه
.br
.TP
.B \-raw-layer (int)
.br
مشابه .I raw اما هنگام استخراج از استخراج‌کننده‌های SVC/MVC/LHVC صرف‌نظر می‌کند
.br
.TP
.B \-diod
.br
استخراج IOD فایل در قالب خام
.br
.TP
.B \-mpd (string)
.br
تبدیل مانیفست HLS یا smooth داده‌شده (محلی یا http دوردست) به MPD \- گزینه‌های \-url\-template و \-segment\-timeline می‌توانند در این حالت استفاده شوند.  
.br
نکته: این گزینه تنها تبدیل پایه‌ای را فراهم می‌کند؛ برای تبدیل‌های پیشرفته‌تر، gpac \-h dasher را ببینید
.br
  
.br
هشدار: این گزینه با سایر گزینه‌های DASH سازگار نیست و سگمنت‌های مرتبط را تبدیل نمی‌کند
.br
.SH "گزینه‌های DASH (DASH Options)"
.LP
.br
همچنین ببینید:
.br
\- مستندات فیلتر dasher در `gpac \-h dasher`
.br
\- [[ویکی DASH|DASH-intro]].
.br

.br.SH "تعیین فایل‌های ورودی (Specifying input files)"
.LP
.br
فایل‌های رسانه‌ای ورودی به dash می‌توانند از تغییردهنده‌های زیر استفاده کنند:
.br
* #trackID=N: تنها استفاده از شناسهٔ ترک N از فایل مبدأ
.br
* #N: تنها استفاده از شناسهٔ ترک N از فایل مبدأ (نگاشت‌شده به .I \-tkid)
.br
* #video: تنها استفاده از نخستین ترک ویدیویی از فایل مبدأ
.br
* #audio: تنها استفاده از نخستین ترک صوتی از فایل مبدأ
.br
* #Prop=Value: افزودن پالایش PID با استفاده از ساختار نحوی مشابه قطعات SID (رجوع کنید به `gpac \-h doc`)
.br
* :id=NAME: تنظیم شناسهٔ Representation روی NAME. مقدار رزروشدهٔ NULL شناسهٔ Representation را برای ورودی‌های تسهیم‌شده (multiplexed) غیرفعال می‌کند. در صورت عدم تنظیم، یک مقدار پیش‌فرض محاسبه می‌شود و تمام ترک‌های انتخاب‌شده از مبدأ در یک خروجی چندپخشی مشترک قرار خواهند گرفت.
.br
* :dur=VALUE: پردازش VALUE ثانیه (کسری) از رسانه. اگر VALUE طولانی‌تر از مدت‌زمان رسانه باشد، مدت‌زمان آخرین نمونه (sample) تمدید می‌شود.
.br
* :period=NAME: تنظیم دورهٔ (Period) مربوط به Representation روی NAME. می‌توان از چندین دوره استفاده کرد. دوره‌ها به همان ترتیبی که با این گزینه مشخص شده‌اند در MPD ظاهر می‌شوند
.br
* :BaseURL=NAME: تنظیم BaseURL. برای چندین BaseURL می‌توان آن را چند بار تنظیم کرد
.br
هشدار: این گزینه مکان فایل‌های تولیدشده را تغییر نمی‌دهد (الگوی قطعه یا segment template را ببینید).
.br
* :bandwidth=VALUE: تنظیم پهنای باند Representation روی مقدار داده‌شده
.br
* :pdur=VALUE: تنظیم مدت‌زمان دورهٔ مرتبط روی VALUE ثانیه (کسری) (نام مستعار برای period_duration:VALUE). این گزینه تنها زمانی استفاده می‌شود که هیچ رسانهٔ ورودی مشخص نشده باشد (درج دوره از راه دور)، مثلاً :period=X:xlink=Z:pdur=Y
.br
* :ddur=VALUE: بازنویسی مدت‌زمان قطعهٔ DASH هدف به VALUE ثانیه (کسری) برای این ورودی (نام مستعار برای duration:VALUE)
.br
* :xlink=VALUE: تنظیم مقدار xlink برای دورهٔ حاوی این عنصر. تنها از xlink اعلان‌شده در نخستین Representation یک دوره استفاده خواهد شد
.br
* :asID=VALUE: تنظیم شناسهٔ AdaptationSet روی VALUE (عدد صحیح بدون علامت یا unsigned int)
.br
* :role=VALUE: تنظیم نقش این Representation (رجوع کنید به مشخصات DASH). رسانه‌ها با نقش‌های متفاوت به مجموعه‌های انطباق (AdaptationSet) متفاوتی تعلق دارند.
.br
* :desc_p=VALUE: افزودن یک توصیف‌گر در سطح Period.
.br
* :desc_as=VALUE: افزودن یک توصیف‌گر در سطح AdaptationSet. دو فایل ورودی با مقادیر مختلف در عناصر AdaptationSet متفاوتی قرار خواهند گرفت.
.br
* :desc_as_c=VALUE: افزودن یک توصیف‌گر در سطح AdaptationSet. این مقدار هنگام ایجاد عناصر AdaptationSet نادیده گرفته می‌شود.
.br
* :desc_rep=VALUE: افزودن یک توصیف‌گر در سطح Representation. این مقدار هنگام ایجاد عناصر AdaptationSet نادیده گرفته می‌شود.
.br
* :sscale: اجبار مقیاس زمانی فیلم (movie timescale) برای مطابقت با مقیاس زمانی رسانه برای نخستین ترک در قطعه.
.br
* :trackID=N: مشابه با تنظیم قطعه با #trackID=
.br
* @f1[:args][@fN:args][@@fK:args]: تنظیم یک زنجیره فیلتر برای درج میان مبدأ و dasher. هر فیلتر در زنجیره مانند یک فیلتر عادی قالب‌بندی می‌شود؛ مستندات فیلتر را در `gpac \-h doc` ببینید. در صورت تنظیم چند فیلتر:
.br
  - در صورت جداسازی با یک @ تکی، به همان ترتیب مشخص‌شده به یکدیگر زنجیر خواهند شد
.br
  - در صورت جداسازی با @@ دوتایی، یک زنجیره فیلتر جدید ایجاد خواهد شد. در این حالت، هیچ شناسهٔ Representation به مبدأ اختصاص داده نمی‌شود.
.br
مثال
.br
source.mp4:@c=avc:b=1M@@c=avc:b=500k
.br

.br
این دستور یک زنجیره فیلتر با دو انکودر متصل به مبدأ و به dasher را بارگذاری می‌کند.
.br
مثال
.br
source.mp4:@c=avc:b=1M@c=avc:b=500k
.br

.br
این دستور یک زنجیره فیلتر را بارگذاری می‌کند که در آن انکودر دوم به خروجی انکودر اول متصل است (!!).
.br

.br
نکته: @f باید پس از تمام گزینه‌های دیگر قرار گیرد.
.br

.br
نکته: مقدار توصیف‌گرها (Descriptors) باید یک یا چند عنصر XML با قالب‌بندی درست باشد؛ مقدار بررسی نمی‌شود. نحو می‌تواند از file@FILENAME برای بارگذاری محتوا از فایل استفاده کند.
.br
.SH "گزینه‌ها (OPTIONS)"
.LP
.br
.TP
.B \-dash (number)
.br
ایجاد DASH از فایل‌های ورودی با مدت‌زمان قطعه (برای نمایهٔ onDemand، زیرقطعه) داده‌شده بر حسب میلی‌ثانیه
.br
.TP
.B \-dash-live (number)
.br
تولید یک نشست زندهٔ DASH با استفاده از مدت‌زمان قطعهٔ داده‌شده بر حسب میلی‌ثانیه؛ استفاده از \-dash\-live=F همچنین بافتار (context) زنده را در F ذخیره می‌کند. MP4Box نشست زنده را تا زمان فشردن کلید q یا رخ دادن خطای مهلک اجرا خواهد کرد
.br
.TP
.B \-ddbg-live (number)
.br
مشابه .I dash-live بدون تنظیم زمان برای مقاصد اشکال‌زدایی
.br
.TP
.B \-frag (number)
.br
مشخص کردن مدت‌زمان فرگمنت (fragment) بر حسب میلی‌ثانیه. در صورت عدم تنظیم، این مقدار همان مدت‌زمان DASH است (یک فرگمنت در هر قطعه)
.br
.TP
.B \-out (string)
.br
مشخص کردن نام فایل خروجی MPD
.br
.TP
.B \-profile,-dash-profile (string)
.br
مشخص کردن نمایهٔ هدف DASH، و تنظیم گزینه‌های پیش‌فرض برای تضمین انطباق با نمایهٔ مورد نظر. نمایهٔ پیش‌فرض در حالت ایستا full و در حالت پویا live است (نحو قدیمی با استفاده از :live به جای .live به عنوان جداکننده همچنان ممکن است). مقادیر تعریف‌شده عبارتند از onDemand، live، main، simple، full، hbbtv1.5.live، dashavc264.live، dashavc264.onDemand و dashif.ll
.br
.TP
.B \-profile-ext (string)
.br
مشخص کردن فهرستی از پسوندهای نمایه (profile extensions)، آن‌گونه که توسط DASH-IF و DVB استفاده می‌شود. این رشته با دونقطه (:) به نمایهٔ استفاده‌شده الحاق خواهد شد
.br
.TP
.B \-rap
.br
اطمینان از اینکه قطعات با نقاط دسترسی تصادفی (RAP) آغاز شوند؛ مدت‌زمان قطعه ممکن است بسته به کدگذاری مبدأ متغیر باشد
.br
.TP
.B \-frag-rap
.br
اطمینان از اینکه تمام فرگمنت‌ها با نقاط دسترسی تصادفی آغاز شوند (مدت‌زمان ممکن است بسته به کدگذاری مبدأ متغیر باشد)
.br
.TP
.B \-segment-name (string)
.br
تنظیم نام قطعه برای قطعات تولیدشده. در صورت عدم تنظیم (پیش‌فرض)، قطعات در فایل خروجی ادغام می‌شوند، به جز در نمایهٔ live که به صورت dash_%%s خواهد بود. رشته‌های جایگزینیِ پشتیبانی‌شده عبارتند از:
.br
\- $Number[%%0Nd]$ با شمارهٔ قطعه، احتمالاً با پیشوند 0، جایگزین می‌شود
.br
\- $RepresentationID$ با نام Representation جایگزین می‌شود
.br
\- $Time$ با زمان شروع قطعه جایگزین می‌شود
.br
\- $Bandwidth$ با پهنای باند Representation جایگزین می‌شود
.br
\- $Init=NAME$ برای قطعهٔ راه‌اندازی (init segment) با NAME جایگزین شده، در غیر این صورت نادیده گرفته می‌شود
.br
\- $Index=NAME$ برای قطعات نمایه (index segments) با NAME جایگزین شده، در غیر این صورت نادیده گرفته می‌شود
.br
\- $Path=PATH$ هنگام ایجاد قطعات با PATH جایگزین شده، در غیر این صورت نادیده گرفته می‌شود
.br
\- $SubNumber[%%0Nd]$ با زیرشمارهٔ قطعه در توالی قطعات، احتمالاً با پیشوند 0، جایگزین می‌شود
.br
\- $Segment=NAME$ برای قطعات رسانه با NAME جایگزین شده، برای قطعات آغازین (init) نادیده گرفته می‌شود
.br
.TP
.B \-segment-ext (string, default: m4s)
.br
تنظیم پسوند قطعه؛ مقدار null به معنای بدون پسوند است
.br
.TP
.B \-init-segment-ext (string, default: mp4)
.br
تنظیم پسوند قطعه برای قطعات init، index و قطعات تغییر جریان بیت (bitstream switching)؛ مقدار null به معنای بدون پسوند است
.br

.br
.TP
.B \-segment-timeline
.br
استفاده از SegmentTimeline هنگام تولید قطعات
.br
.TP
.B \-segment-marker (string)
.br
افزودن یک جعبه (box) از نوع داده‌شده (4CC) در انتهای هر قطعهٔ DASH
.br
.TP
.B \-insert-utc
.br
درج ساعت UTC در ابتدای هر قطعهٔ ISOBMF
.br
.TP
.B \-base-url (string)
.br
تنظیم Base URL در سطح MPD. می‌تواند چندین بار استفاده شود.  
.br
هشدار: این گزینه مکان فایل‌های تولیدشده را تغییر نمی‌دهد
.br
.TP
.B \-mpd-title (string)
.br
تنظیم عنوان MPD
.br
.TP
.B \-mpd-source (string)
.br
تنظیم منبع (source) فایل MPD
.br
.TP
.B \-mpd-info-url (string)
.br
تنظیم نشانی وب اطلاعات (info url) برای MPD
.br
.TP
.B \-cprt (string)
.br
افزودن رشتهٔ حق نشر (کپی‌رایت) به MPD
.br.TP
.B \-dash-ctx (string)
.br
ذخیره/بازیابی زمان‌بندی DASH از فایل مشخص‌شده
.br
.TP
.B \-dynamic
.br
استفاده از نوع MPD پویا (dynamic) به جای ایستا (static)
.br
.TP
.B \-last-dynamic
.br
مشابه .I dynamic اما دوره (period) را می‌بندد (در صورت نیاز نشان lmsg را درج کرده و مدت‌زمان را به‌روزرسانی می‌کند)
.br
.TP
.B \-mpd-duration (number)
.br
تنظیم مدت‌زمان نشست زنده (live) بر حسب ثانیه (اگر 0 باشد، باید از .I mpd-refresh استفاده کنید)
.br
.TP
.B \-mpd-refresh (number)
.br
مشخص کردن زمان به‌روزرسانی MPD بر حسب ثانیه
.br
.TP
.B \-time-shift (int)
.br
مشخص کردن عمق بافر تغییر زمانی (time-shift) در MPD بر حسب ثانیه؛ مقدار \-1 برای نگه‌داشتن تمام فایل‌ها است. پیش‌فرض 0 است
.br
.TP
.B \-subdur (number)
.br
مشخص کردن حداکثر مدت‌زمان فایل ورودی بر حسب میلی‌ثانیه برای قطعه‌بندی DASH در حالت LIVE یا حالت context. این گزینه مدت‌زمان قطعه (segment) را تغییر نمی‌دهد، بلکه به‌محض اینکه قطعات تولیدشده از این مدت‌زمان فراتر رفتند، فرایند قطعه‌بندی را متوقف می‌کند. اگر نمونه‌های کافی برای پایان دادن به یک قطعه وجود نداشته باشد، داده‌ها تکرار (loop) می‌شوند مگر اینکه از .I no-loop استفاده شود که باعث پایان یافتن دوره (period) می‌شود
.br
.TP
.B \-run-for (int)
.br
اجرای نشست dash-live برای مدت میلی‌ثانیهٔ مشخص‌شده و سپس خروج
.br
.TP
.B \-min-buffer (int)
.br
مشخص کردن حداقل زمان بافر MPD بر حسب میلی‌ثانیه
.br
.TP
.B \-ast-offset (int)
.br
مشخص کردن آفست AvailabilityStartTime در MPD بر حسب میلی‌ثانیه در صورت مثبت بودن، یا availabilityTimeOffset مربوط به هر representation در صورت منفی بودن
.br
.TP
.B \-dash-scale (int)
.br
مشخص کردن اینکه زمان‌بندی برای .I dash ، .I dash-live ، .I subdur و .I frag به جای میلی‌ثانیه، در مقیاس زمانی (timescale) ارائه‌شده (واحد بر ثانیه) بیان شوند
.br
.TP
.B \-mem-frags
.br
تکه‌تکه‌سازی (fragmentation) پیش از تخلیه روی دیسک، به جای دیسک در حافظه انجام می‌شود
.br
.TP
.B \-pssh (int)
.br
تنظیم حالت ذخیره‌سازی pssh
.br
* v: فیلم اولیه (initial movie)
.br
* f: تکه‌های فیلم (movie fragments)
.br
* m: در MPD
.br
* mv, vm: در فیلم اولیه و MPD
.br
* mf, fm: در تکه‌های فیلم و MPD
.br
* n: حذف PSSH از MPD، فیلم اولیه و تکه‌های فیلم
.br
.TP
.B \-sample-groups-traf
.br
ذخیره توضیحات گروه نمونه در traf (به صورت تکرارشده برای هر traf). اگر تنظیم نشود، توضیحات گروه نمونه در فیلم اولیه ذخیره می‌شوند
.br
.TP
.B \-mvex-after-traks
.br
ذخیره جعبه mvex پس از جعبه‌های trak درون جعبه moov. اگر تنظیم نشود، mvex پیش از آن‌ها قرار می‌گیرد
.br
.TP
.B \-sdtp-traf (int)
.br
استفاده از جعبه sdtp در traf (مشابه Smooth)
.br
* no: عدم استفاده از sdtp
.br
* sdtp: استفاده از جعبه sdtp برای مشخص کردن وابستگی‌های نمونه و عدم نوشتن اطلاعات در پرچم‌های نمونه trun
.br
* both: استفاده از جعبه sdtp برای مشخص کردن وابستگی‌های نمونه و همچنین نوشتن اطلاعات در پرچم‌های نمونه trun
.br

.br
.TP
.B \-no-cache
.br
غیرفعال کردن حافظه پنهان (cache) فایل برای ورودی‌های dash
.br
.TP
.B \-no-loop
.br
غیرفعال کردن تکرار محتوا در حالت زنده و استفاده از تعویض دوره (period switch) به جای آن
.br
.TP
.B \-hlsc
.br
درج زمان UTC در لیست‌های پخش متغیر (variant playlists) برای HLS زنده
.br
.TP
.B \-bound
.br
قطعه‌بندی همیشه تلاش می‌کند برش را قبل از مرز قطعه یا دقیقاً روی آن انجام دهد، و هرگز بعد از آن تقسیم نمی‌کند
.br
.TP
.B \-closest
.br
قطعه‌بندی از نزدیک‌ترین فریم به مرز قطعه (قبل یا بعد از آن) استفاده خواهد کرد
.br
.TP
.B \-subsegs-per-sidx,-frags-per-sidx (int)
.br
تنظیم تعداد زیرقطعه‌ها (subsegments) برای نوشته شدن در هر جعبه SIDX
.br
* 0: به ازای هر قطعه یک جعبه SIDX واحد استفاده می‌شود
.br
* \-1: هیچ جعبه SIDX استفاده نمی‌شود
.br
.TP
.B \-ssix
.br
فعال‌سازی SubsegmentIndexBox که دو بازه را توصیف می‌کند: اولی از moof تا انتهای نخستین فریم I، و دومی نگاشت‌نشده (unmapped). این گزینه در صورت فعال بودن حالت daisy chaining کار نمی‌کند
.br
.TP
.B \-url-template
.br
استفاده از SegmentTemplate به جای منابع صریح در قطعات. اگر قطعات در فایل خروجی ذخیره شوند نادیده گرفته می‌شود
.br
.TP
.B \-url-template-sim
.br
استفاده از شبیه‌سازی SegmentTemplate هنگام تبدیل HLS به MPD
.br
.TP
.B \-daisy-chain
.br
استفاده از SIDX به صورت زنجیره‌ای (daisy-chain) به جای سلسله‌مراتبی. اگر frags/sidx برابر 0 باشد نادیده گرفته می‌شود
.br
.TP
.B \-single-segment
.br
استفاده از یک قطعه واحد برای کل فایل (نمایه OnDemand)
.br
.TP
.B \-single-file
.br
استفاده از یک فایل واحد برای کل فایل (پیش‌فرض)
.br
.TP
.B \-bs-switching (string, default: inband, values: inband|merge|multi|no|single)
.br
تنظیم حالت تعویض جریان بیتی (bitstream switching)
.br
* inband: استفاده از مجموعه پارامترهای inband و یک قطعه راه‌انداز (init segment) واحد
.br
* merge: تلاش برای ادغام مجموعه‌های پارامتر در یک توصیف نمونه (sample description) واحد، و بازگشت به no در صورت شکست
.br
* multi: استفاده از چندین توصیف نمونه، یکی به ازای هر کیفیت
.br
* no: استفاده از یک قطعه راه‌انداز به ازای هر کیفیت
.br
* pps: استفاده از VPS، SPS و DCI به صورت برون‌باند (out-of-band)، درون‌باند برای PPS و APS و یک قطعه راه‌انداز واحد
.br
* single: برای آزمایش با ورودی تکی
.br
.TP
.B \-moof-sn (int)
.br
تنظیم شماره ترتیب (sequence number) اولین moof به مقدار داده‌شده
.br
.TP
.B \-tfdt (int)
.br
تنظیم TFDT نخستین traf به مقدار داده‌شده بر حسب واحدهای مقیاس (رجوع به \-dash-scale)
.br
.TP
.B \-no-frags-default
.br
غیرفعال کردن پرچم‌های پیش‌فرض قطعات در trex (مورد نیاز در برخی نمایه‌های dash-if و جهت سازگاری با CMAF/smooth streaming)
.br
.TP
.B \-single-traf
.br
استفاده از تنها یک track fragment به ازای هر moof (پخش روان/smooth streaming و مشخصات برگرفته از آن ممکن است به این گزینه نیاز داشته باشند)
.br.TP
.B \-tfdt-traf
.br
استفاده از یک tfdt به ازای هر قطعه تراک (هنگامی که \-single-traf استفاده می‌شود)
.br
.TP
.B \-dash-ts-prog (int)
.br
شماره برنامه (program_number) جهت در نظر گرفتن در صورت وجود فایل ورودی MPTS
.br
.TP
.B \-frag-rt
.br
هنگام استفاده از قطعه‌ها (fragments) در حالت زنده، تخلیه قطعه‌ها بر اساس زمان‌بندی آن‌ها انجام شود
.br
.TP
.B \-cp-location (string)
.br
تعیین محل عنصر ContentProtection
.br
* as: عنصر ContentProtection را در عنصر AdaptationSet قرار می‌دهد
.br
* rep: عنصر ContentProtection را در عنصر Representation قرار می‌دهد
.br
* both: عنصر ContentProtection را در هر دو عنصر قرار می‌دهد
.br
.TP
.B \-start-date (string)
.br
برای حالت زنده، تعیین تاریخ شروع (به صورت xs:date، مانند YYYY-MM-DDTHH:MM:SSZ). پیش‌فرض زمان کنونی UTC است
.br
هشدار: با چندین دوره (periods)، یا هنگامی که مدت زمان DASH مضربی از اندازه GOP نیست استفاده نشود
.br
.TP
.B \-cues (string)
.br
نادیده گرفتن مدت زمان dash و بخش‌بندی بر اساس زمان‌های cue در فایل XML داده‌شده (برای مثال‌ها tests/media/dash_cues را ببینید)
.br
.TP
.B \-strict-cues
.br
ایجاد خطا در صورت بروز مشکل هنگام پردازش cueها یا اعمال قطعه‌بندی مبتنی بر cue
.br
.TP
.B \-merge-last-seg
.br
ادغام آخرین قطعه (segment) در صورتی که کوتاه‌تر از نصف مدت زمان هدف باشد
.br
  
.br
.SH "تقسیم فایل (File splitting)"
.LP
.br
ابزار MP4Box می‌تواند فایل‌های ورودی را بر اساس اندازه یا مدت زمان تقسیم کرده، یا بخش مشخصی از فایل را در فایل(های) جدید IsoMedia استخراج کند.
.br
این کار مستلزم آن است که حداکثر یک تراک در فایل ورودی دارای نقاط دسترسی غیرتصادفی باشد (به طور معمول حداکثر یک تراک ویدیو).
.br
عملیات تقسیم، تمامی تراک‌های MPEG-4 Systems و تراک‌های hint را نادیده می‌گیرد، اما برای تقسیم تراک‌های رسانه‌ای اختصاصی تلاش خواهد کرد.
.br
فایل ورودی باید نقاط دسترسی تصادفی (RAP) کافی برای تقسیم شدن داشته باشد. اگر چنین نباشد، باید محتوا را مجدداً انکود کنید.
.br
می‌توانید در یک مرحله به فایل رسانه اضافه کرده و آن را تقسیم کنید. در این حالت، فایل مقصد (فایلی که بدون تقسیم به دست می‌آمد) ذخیره نخواهد شد.
.br
  
.br
بازه‌های زمانی به شرح زیر مشخص می‌شوند:
.br
* `S-E`: زمان‌های شروع S و پایان E، در قالب HH:MM:SS.ms، MM:SS.ms یا زمان بر حسب ثانیه (int، double، کسر)
.br
* `S:E`: زمان شروع S و زمان پایان E بر حسب ثانیه (int، double، کسر). اگر پیشوند D به E اضافه شود، E = S + time تنظیم می‌شود
.br
* `S:end` یا `S:end-N`: زمان شروع S بر حسب ثانیه (int، double)، مقدار N تعداد ثانیه‌ها (int، double) قبل از پایان
.br
  
.br
عملیات تقسیم در MP4Box یک نشست فیلتر را با استفاده از فیلتر reframer به شرح زیر اجرا می‌کند:
.br
- گزینه splitrange از فیلتر reframer همیشه تنظیم می‌شود
.br
- منبع با فعال بودن گزینه alltk دی‌مالتی‌پلکس می‌شود
.br
- بازه‌های شروع و پایان به گزینه‌های xs و xe فیلتر reframer ارسال می‌شوند
.br
- برای \-splitz، گزینه‌های xadjust و xround=after اعمال می‌شوند
.br
- برای \-splitg، گزینه‌های xadjust و xround=before اعمال می‌شوند
.br
- برای \-splitf، گزینه xround=seek و در صورت عدم تعیین در اعلان خط فرمان، propbe_refset اعمال می‌شود
.br
- برای \-splitx، گزینه xround=closest و در صورت عدم تعیین در اعلان خط فرمان، propbe_ref اعمال می‌شوند
.br
  
.br
حالت پیش‌فرض ذخیره‌سازی خروجی به صورت درهم‌بافی کامل (full interleave) است و برای هر خروجی به یک فایل موقت نیاز دارد. این رفتار با استفاده از \-flat، \-newfs، \-inter و \-frag قابل تغییر است.
.br
نام(های) فایل خروجی را می‌توان با استفاده از \-out و الگوها مشخص کرد (به عنوان مثال \-out split$num%04d$.mp4 فایل‌های split0001.mp4، split0002.mp4 و غیره را تولید می‌کند).
.br
می‌توان چندین بازه زمانی را به عنوان یک فهرست جداشده با کاما برای \-splitx، \-splitz و \-splitg مشخص کرد.
.br
  
.br
.TP
.B \-split (string)
.br
تقسیم به فایل‌هایی با حداکثر مدت زمان مشخص‌شده (عدد ممیز شناور) بر حسب ثانیه. می‌توان یک واحد پسوندی نیز تعیین کرد:
.br
* `M`، `m`: مدت زمان بر حسب دقیقه است
.br
* `H`، `h`: اندازه بر حسب ساعت است
.br
.TP
.B \-split-rap,-splitr
.br
تقسیم به فایل‌های جداگانه در هر RAP جدید
.br
.TP
.B \-split-size,-splits (string)
.br
تقسیم به فایل‌هایی با حداکثر اندازه مشخص‌شده (عدد صحیح) بر حسب کیلوبایت. می‌توان یک واحد پسوندی نیز تعیین کرد:
.br
* `M`، `m`: اندازه بر حسب مگابایت است
.br
* `G`، `g`: اندازه بر حسب گیگابایت است
.br
.TP
.B \-split-chunk,-splitx (string)
.br
استخراج بازه زمانی مشخص‌شده به شرح زیر:
.br
- زمان شروع به نزدیک‌ترین نمونه RAP به زمان شروع مشخص‌شده منتقل می‌شود
.br
- زمان پایان مطابق درخواست نگه داشته می‌شود
.br
.TP
.B \-splitz (string)
.br
استخراج بازه زمانی مشخص‌شده به گونه‌ای که بازه‌های A:B و B:C دقیقاً مرز مشترک B داشته باشند:
.br
- زمان شروع به نمونه RAP در زمان شروع مشخص‌شده یا بعد از آن منتقل می‌شود
- زمان پایان به فریم قبل از نمونه RAP در زمان پایان مشخص‌شده یا پس از آن منتقل می‌شود
.br
.TP
.B \-splitg (string)
.br
استخراج بازه زمانی مشخص‌شده به شرح زیر:
.br
- زمان شروع به نمونه RAP در زمان شروع مشخص‌شده یا قبل از آن منتقل می‌شود
.br
- زمان پایان به فریم قبل از نمونه RAP در زمان پایان مشخص‌شده یا پس از آن منتقل می‌شود
.br
.TP
.B \-splitf (string)
.br
استخراج بازه زمانی مشخص‌شده و درج ویرایش‌ها (edits) به گونه‌ای که خروجی استخراج‌شده دقیقاً مطابق بازه مشخص‌شده باشد
.br

.br.SH "تخلیه فایل (File Dumping)"
.LP
.br
  
.br
ابزار MP4Box دارای عملکردهای متعددی برای تخلیه و استخراج اطلاعات است، از فهرست‌کردن ساده قطعه‌ها گرفته تا گزارش‌دهی کامل‌تر درباره قطعه‌های ویژه.
.br
  
.br
گزینه‌ها:
.br
.TP
.B \-std
.br
تخلیه/نوشتن در stdout و فرض این که stdout در حالت باینری باز شده است
.br
.TP
.B \-stdb
.br
تخلیه/نوشتن در stdout و تلاش برای بازگشایی مجدد stdout در حالت باینری
.br
.TP
.B \-tracks
.br
چاپ تعداد قطعه‌ها در stdout
.br
.TP
.B \-info (string)
.br
چاپ اطلاعات فیلم (بدون پارامتر) یا اطلاعات گسترش‌یافته قطعه با ID مشخص‌شده
.br
.TP
.B \-infon (string)
.br
چاپ اطلاعات قطعه برای شماره قطعه داده‌شده؛ ۱ نشان‌دهنده نخستین قطعه در فایل است
.br
.TP
.B \-infox
.br
چاپ اطلاعات گسترش‌یافته فیلم و قطعه (مشابه \-info N برای هر قطعه)
.br
.TP
.B \-diso,-dmp4
.br
تخلیه باکس‌های فایل IsoMedia در خروجی XML
.br
.TP
.B \-dxml
.br
تخلیه باکس‌های فایل IsoMedia و نمونه‌های شناخته‌شده قطعه در خروجی XML
.br
.TP
.B \-disox
.br
تخلیه باکس‌های فایل IsoMedia به‌جز جدول‌های نمونه در خروجی XML
.br
.TP
.B \-keep-comp
.br
عدم فشرده‌زدایی باکس‌ها هنگام تخلیه
.br
.TP
.B \-keep-ods
.br
برگردان نکردن برچسب‌های ODs و ESDs در ISOM (تنها برای اهداف اشکال‌زدایی)
.br
.TP
.B \-bt
.br
تخلیه صحنه به قالب BT
.br
.TP
.B \-xmt
.br
تخلیه صحنه به قالب XMT
.br
.TP
.B \-wrl
.br
تخلیه صحنه به قالب VRML
.br
.TP
.B \-x3d
.br
تخلیه صحنه به قالب X3D XML
.br
.TP
.B \-x3dv
.br
تخلیه صحنه به قالب X3D VRML
.br
.TP
.B \-lsr
.br
تخلیه صحنه به قالب LASeR XML (XSR)
.br
.TP
.B \-svg
.br
تخلیه صحنه به SVG
.br
.TP
.B \-drtp
.br
تخلیه ساختار نمونه‌های rtp hint در خروجی XML
.br
.TP
.B \-dts
.br
چاپ زمان‌بندی نمونه، اندازه و موقعیت در فایل در خروجی متنی
.br
.TP
.B \-dtsx
.br
مشابه .I dts اما افست را چاپ نمی‌کند
.br
.TP
.B \-dtsc
.br
مشابه .I dts اما هر نمونه را برای dts/cts تکراری تحلیل می‌کند (کند!)
.br
.TP
.B \-dtsxc
.br
مشابه .I dtsc اما افست را چاپ نمی‌کند (کند!)
.br
.TP
.B \-dnal (int)
.br
چاپ اطلاعات نمونه NAL قطعه داده‌شده
.br
.TP
.B \-dnalc (int)
.br
چاپ اطلاعات نمونه NAL قطعه داده‌شده، به‌همراه افزودن CRC برای هر nal
.br
.TP
.B \-dnald (int)
.br
چاپ اطلاعات نمونه NAL قطعه داده‌شده بدون اطلاعات DTS و CTS
.br
.TP
.B \-dnalx (int)
.br
چاپ اطلاعات نمونه NAL قطعه داده‌شده بدون اطلاعات DTS و CTS و به‌همراه افزودن CRC برای هر nal
.br
.TP
.B \-sdp
.br
تخلیه توصیف SDP فایل دارای hint
.br
.TP
.B \-dsap (int)
.br
تخلیه نشانه‌های DASH SAP (گزینه \-cues را ببینید) برای قطعه داده‌شده
.br
.TP
.B \-dsaps (int)
.br
مشابه .I dsap اما تنها شماره نمونه را چاپ می‌کند
.br
.TP
.B \-dsapc (int)
.br
مشابه .I dsap اما تنها CTS را چاپ می‌کند
.br
.TP
.B \-dsapd (int)
.br
مشابه .I dsap اما تنها DTS را چاپ می‌کند
.br
.TP
.B \-dsapp (int)
.br
مشابه .I dsap اما تنها زمان نمایش (presentation time) را چاپ می‌کند
.br
.TP
.B \-dcr
.br
تخلیه ساختار نمونه‌های ISMACryp در خروجی XML
.br
.TP
.B \-dchunk
.br
تخلیه اطلاعات chunk
.br
.TP
.B \-dump-cover
.br
استخراج تصویر جلد (cover art)
.br
.TP
.B \-dump-chap
.br
استخراج فایل فصل‌ها در قالب TTXT
.br
.TP
.B \-dump-chap-ogg
.br
استخراج فایل فصل‌ها در قالب OGG
.br.TP
.B \-dump-chap-zoom
.br
استخراج فایل فصل‌ها به قالب zoom
.br
.TP
.B \-dump-udta [tkID:]4cc
.br
استخراج داده‌های کاربر برای 4CC مشخص‌شده. اگر tkID داده شود، از UDTA مربوط به شناسه قطعه (track ID) مشخص‌شده استخراج می‌شود، در غیر این صورت از moov استفاده می‌شود
.br
.TP
.B \-mergevtt
.br
ادغام نشانه‌های vtt هنگام استخراج
.br
.TP
.B \-ttxt (int)
.br
در صورت نبود پارامتر، تبدیل زیرنویس ورودی به قالب GPAC TTXT. در غیر این صورت، استخراج قطعه متنی داده‌شده به قالب GPAC TTXT
.br
.TP
.B \-srt (int)
.br
در صورت نبود پارامتر، تبدیل زیرنویس ورودی به قالب SRT. در غیر این صورت، استخراج قطعه متنی داده‌شده به قالب SRT
.br
.TP
.B \-nstat
.br
تولید آمار گره/میدان (node/field) برای صحنه
.br
.TP
.B \-nstats
.br
تولید آمار گره/میدان به ازای هر واحد دسترسی (Access Unit)
.br
.TP
.B \-nstatx
.br
تولید آمار گره/میدان برای صحنه پس از هر AU
.br
.TP
.B \-hash
.br
تولید درهم‌ساز (Hash) SHA-1 برای فایل ورودی
.br
.TP
.B \-comp (string)
.br
جایگزینی تمام انواع باکس‌های سطح بالا (top-level boxes) داده‌شده به عنوان پارامتر با نسخه فشرده، در قالب orig_4cc_1=comp_4cc_1[,orig_4cc_2=comp_4cc_2]
.br
.TP
.B \-topcount (string)
.br
چاپ تعداد باکس‌های سطح بالا منطبق بر انواع باکس داده‌شده به عنوان پارامتر در stdout، در قالب 4cc_1,4cc_2N
.br
.TP
.B \-topsize (string)
.br
چاپ اندازه (بر حسب بایت) باکس‌های سطح بالا منطبق بر انواع داده‌شده به عنوان پارامتر در stdout، در قالب 4cc_1,4cc_2N یا all برای تمام باکس‌ها
.br
.TP
.B \-bin
.br
تبدیل فایل XML ورودی با استفاده از نحو جریان بیتی NHML به باینری
.br
.TP
.B \-mpd-rip
.br
دریافت MPD و قطعه‌ها (segments) بر روی دیسک
.br
.TP
.B \-udp-write (string, default: IP[:port])
.br
نوشتن نام ورودی روی UDP (درگاه پیش‌فرض 2345)
.br
.TP
.B \-raw-cat (string)
.br
پیوست خام (raw concatenation) فایل داده‌شده با فایل ورودی
.br
.TP
.B \-wget (string)
.br
دریافت منبع از نشانی اینترنتی http(s)
.br
.TP
.B \-dm2ts
.br
استخراج زمان‌بندی نمونه‌های یک جریان ورودی MPEG-2 TS
.br
.TP
.B \-check-xml
.br
بررسی قالب خروجی XML برای گزینه‌های \-dnal*، \-diso* و \-dxml
.br
.TP
.B \-fuzz-chk
.br
باز کردن فایل بدون وارسی اولیه (probing) و خروج (برای آزمون‌های fuzz)
.br
.SH "گزینه‌های واردسازی (Importing Options)"
.LP
.br
.SH "واردسازی فایل (File importing)"
.LP
.br
نحو دستور به صورت .I add / .I cat URL[#FRAGMENT][:opt1...:optN=val] است.
.br
این فرایند در صورت موجود نبودن فایل مقصد، آن را ایجاد کرده و قطعه(ها) را به آن اضافه می‌کند. اگر می‌خواهید همواره یک فایل مقصد جدید ایجاد شود، .I \-new را اضافه کنید.
.br
انواع رسانه‌های ورودی پشتیبانی‌شده به نوع نصب شما بستگی دارد؛ برای اطلاعات بیشتر مستندات فیلترها (filters) را بررسی کنید.
.br
  
.br
جهت انتخاب یک قطعه رسانه‌ای مورد نظر از یک منبع، می‌توان یک شناسه قطعه '#' را پیش از هر گزینه دیگری مشخص کرد. نحو زیر به کار می‌رود:
.br
* `#video`: اولین قطعه ویدیویی یافت‌شده در منبع را می‌افزاید
.br
* `#audio`: اولین قطعه صوتی یافت‌شده در منبع را می‌افزاید
.br
* `#auxv`: اولین قطعه ویدیویی کمکی یافت‌شده در منبع را می‌افزاید
.br
* `#pict`: اولین قطعه تصویری یافت‌شده در منبع را می‌افزاید
.br
* `#trackID=ID` یا `#ID`: قطعه مشخص‌شده را می‌افزاید. برای فایل‌های IsoMedia، شناسه ID همان track ID است. برای سایر فایل‌های رسانه‌ای، ID مقداری است که توسط MP4Box \-info inputFile مشخص شده است
.br
* `#pid=ID`: شماره PID مورد نظر برای منابع MPEG-2 TS
.br
* `#prog_id=ID`: شماره برنامه مورد نظر برای منابع MPEG-2 TS
.br
* `#program=NAME`: نام برنامه مورد نظر برای منابع MPEG-2 TS
.br
  
.br
به‌طور پیش‌فرض تمام واردسازی‌ها به صورت متوالی انجام می‌شوند و درهم‌بافی (interleaving) نهایی در پایان کار صورت می‌گیرد؛ با این وجود، این امر نیازمند یک فایل موقت برای نگهداری فایل ISOBMF اصلی (در صورت وجود) و فایل‌های اضافه‌شده پیش از ایجاد خروجی نهایی است. از آن‌جا که حجم این فایل موقت می‌تواند بسیار زیاد شود، می‌توان با استفاده از گزینه .I \-flat رسانه را بدون فضای ذخیره‌سازی موقت به فایلی جدید افزود، اما این کار درهم‌بافی رسانه را غیرفعال می‌کند.
.br
  
.br
اگر می‌خواهید فایلی جدید و درهم‌بافته بدون فضای ذخیره‌سازی موقت ایجاد کنید، از گزینه .I \-newfs استفاده کنید. این درهم‌بافی ممکن است به دقت زمان استفاده از .I \-new نباشد، زیرا به زمان‌بندی ورودی مالتی‌پلکسر وابسته است (هر بار اجرا ممکن است به نتیجه‌ای کمی متفاوت منجر شود). علاوه‌بر این در این حالت:
.br
 - برخی از گزینه‌های مالتی‌پلکس (که در زیر با X مشخص شده‌اند) برای همه ورودی‌ها فعال خواهند شد (به عنوان نمونه، وارد کردن یک قطعه AVC با xps_inband و قطعه‌ای دیگر بدون آن ممکن نیست).
.br
 - برخی گزینه‌های مالتی‌پلکس (که در زیر با D مشخص شده‌اند) قابل استفاده نیستند، زیرا برای ویرایش فایل به فضای ذخیره‌سازی موقت نیاز دارند.
.br
 - استفاده از .I cat امکان‌پذیر است، اما منابع متوالی‌شده در خروجی درهم‌بافته نخواهند شد. اگر می‌خواهید عملیات پیچیده‌تری از cat/add را بدون فایل موقت انجام دهید، از یک فهرست پخش (playlist) استفاده کنید.
.br
  
.br
نشانی منبع (Source URL) می‌تواند هر نشانی اینترنتی پشتیبانی‌شده توسط GPAC باشد و محدود به فایل‌های محلی نیست.
.br
  
.br
نکته: هنگام وارد کردن فایل‌های SRT یا SUB، برنامه MP4Box گزینه‌های چیدمان پیش‌فرضی را برمی‌گزیند تا زیرنویس در پایین ویدیو نمایش داده شود. شما نباید پیش از افزودن قطعه ویدیویی به فایل مقصد، چنین فایل‌هایی را وارد کنید؛ در غیر این صورت، نتایج احتمالاً کاربردی نخواهند بود (واردسازی پیش‌فرض SRT/SUB از قلم serif پیش‌فرض، fontSize ۱۸ و اندازه نمایش 400x60 استفاده می‌کند). برای جزئیات بیشتر، مستندات TTXT را بررسی کنید.
.br
  
.br
هنگام واردسازی چندین قطعه/منبع در یک نوبت، تمام گزینه‌ها در صورت مرتبط بودن به هر منبع اعمال خواهند شد. این گزینه‌ها برای همه جریان‌های واردشده تنظیم می‌شوند. اگر می‌خواهید این گزینه‌ها را به ازای هر جریان مشخص کنید، گزینه‌های اختصاصی هر فایل را با استفاده از نحو \-add stream[:opt1:...:optN] تنظیم نمایید.
.br
  
.br
نام فایل واردسازی ممکن است خالی یا self تنظیم شود، که نشان می‌دهد گزینه‌های واردسازی باید بر روی قطعه(های) فایل مقصد اعمال گردند.
.br
مثال
.br
\-add self:moovts=\-1:noedit src.mp4
.br

.br
این دستور گزینه‌های moovts و noedit را بر روی تمام قطعه‌های src.mp4 اعمال می‌کند
.br
مثال
.br
\-add self#2:moovts=\-1:noedit src.mp4
.br

.br
این دستور گزینه‌های moovts و noedit را بر روی قطعه با ID=2 در src.mp4 اعمال می‌کند
.br
در این حالت فقط گزینه‌های اختصاصی هر فایل که با S مشخص شده‌اند مجاز هستند.
.br
  
.br
هنگام واردسازی یک فایل ISOBMFF/QT، فقط گزینه‌های مشخص‌شده با C یا S قابل استفاده هستند.
.br
  
.br
هنگام واردسازی به عنوان یک قطعه خارجی، فقط گزینه‌های مشخص‌شده با E قابل استفاده هستند.
.br
  
.br
گزینه‌های مجاز به ازای هر فایل:
.br

.br
.TP
.B dur (int)
.br
XCE تنها مدت‌زمان مشخص‌شده از رسانه را وارد می‌کند. مقدار می‌تواند موارد زیر باشد:
.br
  * عدد اعشاری مثبت: مشخص‌کننده مدت‌زمان بر حسب ثانیه
.br
  * کسر: مشخص‌کننده مدت‌زمان به صورت کسر NUM/DEN
.br
  * عدد صحیح منفی: مشخص‌کننده مدت‌زمان بر حسب تعداد فریم‌های کدگذاری‌شده
.br.TP
.B start (number)
.br
C زمان شروع هدف در رسانهٔ مبدأ؛ بسته به مبدأ ممکن است پشتیبانی نشود
.br
.TP
.B lang (string)
.br
SE تنظیم کد زبان رسانهٔ واردشده
.br
.TP
.B delay (int)
.br
SE تنظیم تأخیر اولیه (0<) یا پرش اولیه (0>) رسانهٔ واردشده به میلی‌ثانیه یا به‌صورت کسری از ثانیه (N/D)
.br
.TP
.B par (string)
.br
S تنظیم نسبت ابعاد پیکسلی تصویر (ببینید: .I -par )
.br
.TP
.B clap (string)
.br
S تنظیم گشودگی دیافراگم تمیز (clean aperture) تصویر (ببینید: .I -clap )
.br
.TP
.B mx (string)
.br
SE تنظیم ماتریس تِرَک (ببینید: .I -mx )
.br
.TP
.B name (string)
.br
S تنظیم نام گردانندهٔ تِرَک
.br
.TP
.B ext (string)
.br
بازنویسی پسوند فایل هنگام واردسازی
.br
.TP
.B hdlr (string)
.br
S تنظیم نوع گردانندهٔ تِرَک با کد چهارنویسه‌ای (4CC) داده‌شده
.br
.TP
.B stype (string)
.br
S اجبار نوع شرح نمونه (sample description) به کد چهارنویسه‌ای (4CC) داده‌شده؛ به احتمال زیاد باعث خرابی فایل می‌شود
.br
.TP
.B tkhd (int)
.br
SE تنظیم پرچم‌های سرآیند تِرَک به‌صورت عدد صحیح هگزادسیمال یا فهرستی جداشده با کاما از کلیدواژه‌های enable، movie، preview، size_ar (برای افزودن از tkhd+=FLAGS و برای حذف از tkhd-=FLAGS استفاده کنید)
.br
.TP
.B disable
.br
SE غیرفعال‌سازی تِرَک(های) واردشده؛ برای اجبار به فعال‌سازی یک تِرَک غیرفعال از disable=no استفاده کنید
.br
.TP
.B group (int)
.br
SE افزودن تِرَک به‌عنوان بخشی از گروه جایگزین G. اگر G برابر 0 باشد، نخستین GroupID در دسترس انتخاب خواهد شد
.br
.TP
.B fps (string)
.br
S همانند .I fps
.br
.TP
.B rap
.br
DS تنها وارد کردن نمونه‌های RAP
.br
.TP
.B refs
.br
DS تنها وارد کردن تصاویر مرجع
.br
.TP
.B trailing
.br
نگه‌داشتن بایت‌های صفر پایانی در نمونه‌های AVC/HEVC
.br
.TP
.B agg (int)
.br
X همانند .I agg
.br
.TP
.B dref
.br
XC همانند .I dref
.br
.TP
.B keep_refs
.br
C حفظ ارجاع تِرَک هنگام وارد کردن یک تک‌تِرَک
.br
.TP
.B nodrop
.br
همانند .I no-drop
.br
.TP
.B packed
.br
X همانند .I packed
.br
.TP
.B sbr
.br
همانند .I sbr
.br
.TP
.B sbrx
.br
همانند .I sbrx
.br
.TP
.B ovsbr
.br
همانند .I ovsbr
.br
.TP
.B ps
.br
همانند .I ps
.br
.TP
.B psx
.br
همانند .I psx
.br
.TP
.B asemode (string)
.br
XS تنظیم حالت ایجاد AudioSampleEntry. مقدار می‌تواند یکی از موارد زیر باشد:
.br
  * v0-s: استفاده از MPEG AudioSampleEntry v0 و تعداد کانال‌ها از جریان بیت (حتی اگر بیشتر از ۲ باشد، مگر برای Dolby (e)AC3/4) - پیش‌فرض
.br
  * v0-2: استفاده از MPEG AudioSampleEntry v0 و اجبار تعداد کانال‌ها به ۲
.br
  * v0-bs: استفاده از MPEG AudioSampleEntry v0 و تعداد کانال‌ها از جریان بیت
.br
  * v1: استفاده از MPEG AudioSampleEntry v1 و تعداد کانال‌ها از جریان بیت
.br
  * v1-qt: استفاده از QuickTime Sound Sample Description نسخهٔ ۱ و تعداد کانال‌ها از جریان بیت (حتی اگر بیشتر از ۲ باشد). این حالت همچنین استفاده از ارجاعات داده‌ای alis را به‌جای url، حتی برای تِرَک‌های غیرصوتی، فعال می‌کند
.br
.TP
.B audio_roll (int)
.br
S افزودن یک گروه نمونهٔ roll با roll_distance مقدار N برای تِرَک‌های صوتی
.br
.TP
.B roll (int)
.br
S افزودن یک گروه نمونهٔ roll با roll_distance مقدار N
.br
.TP
.B proll (int)
.br
S افزودن یک گروه نمونهٔ preroll با roll_distance مقدار N
.br
.TP
.B mpeg4
.br
X همانند گزینهٔ .I mpeg4
.br
.TP
.B nosei
.br
دور انداختن تمام پیام‌های SEI هنگام واردسازی
.br
.TP
.B svc
.br
وارد کردن SVC/LHVC با سیگنال‌دهی صریح (بدون سازگاری با لایهٔ پایه AVC)
.br
.TP
.B nosvc
.br
دور انداختن داده‌های SVC/LHVC هنگام واردسازی
.br
.TP
.B svcmode (string)
.br
DS تنظیم حالت واردسازی SVC/LHVC. مقدار می‌تواند یکی از موارد زیر باشد:
.br
  * split: هر لایه در تِرَک اختصاصی خود قرار می‌گیرد
.br
  * merge: تمام لایه‌ها در یک تِرَک واحد ادغام می‌شوند
.br
  * splitbase: تمام لایه‌ها در یک تِرَک ادغام می‌شوند و لایهٔ پایه در تِرَکی دیگر
.br
  * splitnox: هر لایه در تِرَک اختصاصی خود قرار می‌گیرد و هیچ استخراج‌کننده‌ای (extractor) نوشته نمی‌شود
.br
  * splitnoxib: هر لایه در تِرَک اختصاصی خود قرار می‌گیرد، هیچ استخراج‌کننده‌ای نوشته نمی‌شود و از سیگنال‌دهی مجموعه پارامترهای درون‌باندی (inband) استفاده می‌شود
.br.TP
.B temporal (string)
.br
DS تنظیم حالت واردسازی زیرلایه زمانی (temporal sublayer) HEVC/LHVC. مقدار می‌تواند موارد زیر باشد:
.br
  * split: هر زیرلایه در تِرَک اختصاصی خود قرار می‌گیرد
.br
  * splitbase: تمام زیرلایه‌ها در یک تِرَک ادغام می‌شوند، و لایه پایه HEVC در تِرَکی دیگر
.br
  * splitnox: هر لایه در تِرَک اختصاصی خود قرار می‌گیرد، و هیچ استخراج‌کننده‌ای (extractor) نوشته نمی‌شود
.br
.TP
.B subsamples
.br
افزودن اطلاعات SubSample برای AVC+SVC
.br
.TP
.B deps
.br
واردسازی اطلاعات وابستگی نمونه‌ها برای AVC و HEVC
.br
.TP
.B ccst
.br
S افزودن جعبه (box) پیش‌فرض ccst مربوط به HEIF به ورودی نمونه تصویری (visual sample entry)
.br
.TP
.B forcesync
.br
SE علامت‌گذاری اجباری نمونه‌های غیر IDR حاوی I-slice (مانند OpenGOP یا GDR) به عنوان نقاط همگام‌سازی (sync points)
.br
هشدار: فایل نهایی با مشخصات استاندارد سازگار نخواهد بود اما پرش زمانی (seeking) را در اکثر پخش‌کننده‌ها تصحیح می‌کند
.br
.TP
.B xps_inband
.br
XC قرار دادن xPS به‌صورت inband برای AVC/H264 و HEVC (برای عملیات معکوس، مجدداً از رسانه خام وارد کنید)
.br
.TP
.B xps_inbandx
.br
XC همانند xps_inband به همراه نگه‌داشتن نخستین xPS در توضیحات نمونه (sample description)
.br
.TP
.B au_delim
.br
نگه‌داشتن واحدهای NAL جداکننده دسترسی (AU delimiter) در فایل واردشده
.br
.TP
.B max_lid (int)
.br
تنظیم شناسه بیشینه لایه (max layer ID) در HEVC برای واردسازی به N (به‌طور پیش‌فرض همه لایه‌ها وارد می‌شوند)
.br
.TP
.B max_tid (int)
.br
تنظیم شناسه بیشینه زیرلایه زمانی (max temporal ID) در HEVC برای واردسازی به N (به‌طور پیش‌فرض همه زیرلایه‌های زمانی وارد می‌شوند)
.br
.TP
.B tiles
.br
S افزودن سیگنال‌دهی تایل‌های HEVC و نگاشت‌های NALU بدون تفکیک تایل‌ها به تِرَک‌های مجزای تایل
.br
.TP
.B split_tiles
.br
DS تفکیک تایل‌های HEVC به تِرَک‌های مجزای تایل، یک تایل (یا تمامی تایل‌های یک برش/اسلایس) در هر تِرَک
.br
.TP
.B negctts
.br
S استفاده از آفست‌های منفی CTS-DTS (برند ISO4). برای اجبار به استفاده از آفست مثبت در یک تِرَک موجود از negctts=no استفاده کنید
.br
.TP
.B chap
.br
SE مشخص کردن این‌که تِرَک مورد نظر یک تِرَک فصل‌بندی (chapter track) است
.br
.TP
.B chapter (string)
.br
SE افزودن یک فصل تکی (قالب قدیمی nero) با نام داده‌شده که در طول کل فایل ادامه دارد
.br
.TP
.B chapfile (string)
.br
SE افزودن یک فایل فصل‌بندی (قالب قدیمی nero)
.br
.TP
.B layout (string)
.br
SE مشخص کردن چیدمان تِرَک به‌صورت WxH[xXxY][xLAYER]. اگر W (یا به ترتیب H) برابر 0 باشد، بیشینه پهنا (یا به ترتیب بیشینه ارتفاع) تِرَک‌های موجود در فایل استفاده می‌شود
.br
.TP
.B rescale (int)
.br
S اجبار مقیاس زمانی رسانه (timescale) به TS (عدد صحیح یا کسری) و تغییر مدت‌زمان رسانه
.br
.TP
.B sampdur (int)
.br
S اجبار مدت‌زمان تمام نمونه‌ها (D) یا مدت‌زمان نمونه‌ها و مقیاس زمانی رسانه (D/TS)؛ برای وصله کردن فایل‌های CFR با زمان‌بندی معیوب استفاده می‌شود
.br
.TP
.B timescale (int)
.br
S تنظیم مقیاس زمانی رسانه واردشده به TS
.br
.TP
.B moovts (int)
.br
SE تنظیم مقیاس زمانی فیلم به TS. مقدار منفی مقیاس زمانی نخستین تِرَک واردشده را انتخاب می‌کند
.br
.TP
.B noedit
.br
XS عدم تنظیم فهرست ویرایش (edit list) هنگام واردسازی تِرَک‌های ویدیویی B-frames
.br
.TP
.B rvc (string)
.br
S تنظیم پیکربندی RVC برای رسانه
.br
.TP
.B fmt (string)
.br
نادیده‌گرفتن تشخیص قالب با قالب داده‌شده \- غیرفعال‌سازی ارزیابی اولیه داده‌ها (data probing) و اجبار گزینه ext روی منبع
.br
.TP
.B profile (int)
.br
S نادیده‌گرفتن و جایگزینی پروفایل AVC. مقدار عددی صحیح، یا high444، high، extended، main، baseline
.br
.TP
.B level (int)
.br
S نادیده‌گرفتن و جایگزینی سطح (level) در AVC؛ اگر مقدار < 6 باشد، به‌صورت عبارت اعشاری تفسیر می‌شود
.br
.TP
.B compat (int)
.br
S اجبار پرچم‌های سازگاری پروفایل برای محتوای H.264
.br
.TP
.B novpsext
.br
حذف اکستنشن‌های VPS از HEVC VPS
.br
.TP
.B keepav1t
.br
نگه‌داشتن OBU جداکننده زمانی AV1 در نمونه‌ها؛ در صورتی که فایل مبدأ دارای افت داده بوده باشد ممکن است مفید باشد
.br
.TP
.B dlba (string)
.br
S اجبار حالت DolbyAtmos برای EAC3. مقدار می‌تواند این موارد باشد:
.br
* no: غیرفعال‌سازی سیگنال‌دهی Atmos
.br
* auto: استفاده از سیگنال‌دهی Atmos از نخستین نمونه
.br
* N: اجبار سیگنال‌دهی Atmos با استفاده از شاخص نوع سازگاری N
.br
.TP
.B font (string)
.br
مشخص کردن نام قلم برای واردسازی متن (پیش‌فرض Serif)
.br
.TP
.B size (int)
.br
مشخص کردن اندازه قلم برای واردسازی متن (پیش‌فرض 18)
.br
.TP
.B text_layout (string)
.br
مشخص کردن چیدمان متنی تِرَک به‌صورت WxHxXxY
.br
  * اگر W (یا به ترتیب H) = 0 باشد: بیشینه پهنا (یا به ترتیب بیشینه ارتفاع) تِرَک‌های موجود در فایل استفاده می‌شود
.br
  * اگر Y=-1 باشد: چیدمان به پایین ناحیه تِرَک منتقل می‌شود
.br
  * مقادیر X و Y را می‌توان حذف کرد: :layout=WxH
.br
.TP
.B swf-global
.br
تمام تعاریف (defines) فایل SWF به جای زمان نیاز، در نخستین جایگزینی صحنه (scene replace) قرار می‌گیرند
.br
.TP
.B swf-no-ctrl
.br
استفاده از یک جریان واحد برای کنترل فیلم و دیکشنری (این کار ActionScript را غیرفعال می‌کند)
.br
.TP
.B swf-no-text
.br
حذف تمام متون SWF
.br.TP
.B swf-no-font
.br
حذف تمام قلم‌های SWF تعبیه‌شده (استفاده از قلم‌های میزبان پخش محلی)
.br
.TP
.B swf-no-line
.br
حذف تمام خطوط از اشکال SWF
.br
.TP
.B swf-no-grad
.br
حذف تمام گرادیان‌ها از اشکال SWF
.br
.TP
.B swf-quad
.br
استفاده از منحنی‌های بزیه درجه‌دوم به‌جای درجه‌سوم
.br
.TP
.B swf-xlp
.br
پشتیبانی از شفافیت خطوط و مقیاس‌پذیری
.br
.TP
.B swf-ic2d
.br
استفاده از پروتوتایپ سخت‌کدشدهٔ منحنی دوبعدی نمایه‌گذاری‌شده (indexed curve 2D hardcoded proto)
.br
.TP
.B swf-same-app
.br
استفادهٔ مجدد از گره‌های ظاهر (appearance nodes)
.br
.TP
.B swf-flatten (number)
.br
زاویهٔ متممی که کمتر از آن ۲ خط ادغام می‌شوند؛ ۰ به معنای عدم مسطح‌سازی (flattening) است
.br
.TP
.B kind (string)
.br
SE تنظیم kind برای قطعه به‌صورت schemeURI=value
.br
.TP
.B txtflags (int)
.br
تنظیم پرچم‌های نمایش (عدد هگزادسیمال) قطعهٔ متنی. برای افزودن پرچم‌ها از txtflags+=FLAGS و برای حذف پرچم‌ها از txtflags-=FLAGS استفاده کنید
.br
.TP
.B rate (int)
.br
تحمیل نرخ میانگین و حداکثر نرخ به VAL (به bps) در جعبهٔ btrt. در صورت ۰ بودن، جعبهٔ btrt حذف می‌شود
.br
.TP
.B stz2
.br
S استفاده از جدول اندازهٔ فشرده (برای نرخ‌بیت‌های پایین)
.br
.TP
.B bitdepth (int)
.br
تنظیم عمق بیت روی VAL برای محتوای ویدیویی واردشده (پیش‌فرض ۲۴ است)
.br
.TP
.B colr (string)
.br
S تنظیم نمایهٔ رنگ برای محتوای ویدیویی واردشده. مقدار به این صورت قالب‌بندی می‌شود:
.br
  * nclc,p,t,m: با رنگ پایهٔ p (عدد صحیح یا رشته)، مشخصات انتقال t (عدد صحیح یا رشته) و ضریب ماتریس m (عدد صحیح یا رشته)، رجوع کنید به \-h cicp
.br
  * nclx,p,t,m,r: مشابه nclx به‌همراه پرچم محدودهٔ کامل r (مقدار yes، on یا no، off)
.br
  * prof,path: با path که مشخص‌کنندهٔ فایل حاوی نمایهٔ رنگ ICC است
.br
  * rICC,path: با path که مشخص‌کنندهٔ فایل حاوی نمایهٔ رنگ محدودشدهٔ ICC است
.br
  * \(aqnone\(aq: حذف اطلاعات رنگ
.br
.TP
.B hdr (string)
.br
S تنظیم اطلاعات HDR روی قطعه (ببینید .I \-hdr )، مقدار \(aqnone\(aq اطلاعات HDR را حذف می‌کند
.br
.TP
.B dvp,-dv-profile (string)
.br
S تنظیم نمایهٔ Dolby Vision روی قطعهٔ واردشده
.br
\- نمایه یک عدد صحیح است، یا none برای حذف سیگنال‌دهی DV
.br
\- نمایه می‌تواند با شناسهٔ سازگاری پسوندگذاری شود، مانند 5.hdr10
.br
\- شناسه‌های سازگاری مجاز عبارتند از none، hdr10، bt709، hlg709، hlg2100، bt2020، brd یا یک مقدار عددی صحیح مطابق با مشخصات DV
.br
\- نمایه می‌تواند با \(aqf\(aq پیشوندگذاری شود تا سیگنال‌دهی نوع کدک DV تحمیل شود، مانند f8.2
.br
.TP
.B dvmdc (int)
.br
S تنظیم فشرده‌سازی فرادادهٔ Dolby Vision (مقادیر معتبر: 0، 1، 3. پیش‌فرض = 0)
.br
.TP
.B fullrange (string)
.br
S تحمیل نوع محدودهٔ کامل (fullrange) ویدیو در VUI برای محتوای AVC|H264 (مقادیر yes، on یا no، off)
.br
.TP
.B videofmt (string)
.br
S تحمیل قالب ویدیو در VUI برای محتوای AVC|H264 و HEVC؛ مقدار می‌تواند component، pal، ntsc، secam، mac یا undef باشد
.br
.TP
.B colorprim (string)
.br
S تحمیل رنگ‌های اصلی در VUI برای AVC|H264 و HEVC (عدد صحیح یا رشته، رجوع کنید به \-h cicp)
.br
.TP
.B colortfc (string)
.br
S تحمیل مشخصات انتقال در VUI برای AVC|H264 و HEVC (عدد صحیح یا رشته، رجوع کنید به \-h cicp)
.br
.TP
.B colormx (string)
.br
S تحمیل ضرایب ماتریس در VUI برای محتوای AVC|H264 و HEVC (عدد صحیح یا رشته، رجوع کنید به \-h cicp)
.br
.TP
.B tc (string)
.br
SE تزریق یک کد زمانی (timecode) منفرد QT. مقدار به این صورت قالب‌بندی می‌شود:
.br
  * [d]FPS[/FPS_den],h,m,s,f[,framespertick]: پرچم اختیاری drop، نرخ فریم (صحیح یا کسری)، ساعت، دقیقه، ثانیه و شمارهٔ فریم
.br
  * : پرچم d اختیاری است و برای نشان دادن این است که شمارنده در قالب drop-frame قرار دارد
.br
  * : آرگومان framespertick اختیاری است و مقدار پیش‌فرض آن round(framerate) است؛ این مقدار نشان‌دهندهٔ تعداد فریم‌ها در هر تیک شمارنده است
.br
.TP
.B edits (string)
.br
SE بازنویسی فهرست ویرایش (edit list)، نحوهٔ نگارش یکسان با .I \-edits
.br
.TP
.B lastsampdur (string)
.br
S تنظیم مدت‌زمان آخرین نمونه. مقدار به این صورت قالب‌بندی می‌شود:
.br
  * بدون مقدار: استفاده از مدت‌زمان نمونهٔ پیشین
.br
  * عدد صحیح: مشخص‌کنندهٔ مدت‌زمان به میلی‌ثانیه
.br
  * N/D: مشخص‌کنندهٔ مدت‌زمان به‌صورت کسری از ثانیه
.br
.TP
.B ID (int)
.br
SE تنظیم شناسهٔ مقصد
.br
  \- مقدار 0 (پیش‌فرض) تلاش می‌کند شناسهٔ قطعهٔ مبدأ را حفظ کند
.br
  \- مقدار \-1 شناسهٔ قطعهٔ مبدأ را نادیده می‌گیرد
.br
  \- مقادیر دیگر تلاش می‌کنند تا در صورت نبود قطعهٔ دیگری با شناسهٔ یکسان، شناسهٔ قطعه را روی این مقدار تنظیم کنند
.br
.TP
.B tkgp (string)
.br
SE انتساب گروه قطعه به قطعه. مقدار به‌صورت TYPE,N قالب‌بندی می‌شود که در آن TYPE نوع گروه قطعه (4CC) و N شناسهٔ گروه قطعه است. شناسهٔ منفی، آن را از شناسهٔ گروه قطعهٔ \-N حذف می‌کند
.br
.TP
.B tkidx (string)
.br
SE تنظیم موقعیت قطعه در فهرست قطعه‌ها، مقدار ۱ نشان‌دهندهٔ نخستین قطعه در فایل است
.br
.TP
.B extk
.br
CE افزودن قطعه به‌عنوان قطعهٔ خارجی (external)
.br
.TP
.B times (string)
.br
SE اصلاح برچسب‌های زمانی با استفاده از فایل برچسب زمانی مشخص‌شده در مقدار. فایل برچسب زمانی به این صورت قالب‌بندی می‌شود:
.br
  \- خطی که با # آغاز شود یک یادداشت (کامنت) است، که در آن می‌توان از timescale=V برای تنظیم مقیاس زمانی استفاده کرد (به‌طور پیش‌فرض ۱۰۰۰)
.br
  \- خطوط خالی نادیده گرفته می‌شوند
.br
  \- یک خط به ازای هر نمونه در ترتیب رمزگشایی، به‌صورت cts یا dts cts
.br
.TP
.B stats,-fstat
.br
C چاپ آمار نشست فیلتر پس از واردسازی
.br
.TP
.B graph,-fgraph
.br
C چاپ گراف نشست فیلتر پس از واردسازی
.br.TP
.B sopt:[OPTS]
.br
تنظیم OPTS به عنوان آرگومان‌های اضافی برای فیلتر مبدأ (source filter). مقدار OPTS می‌تواند هر یک از آرگومان‌های معمول فیلتر باشد، مستندات فیلتر را ببینید: `gpac -h doc`
.br
.TP
.B dopt:[OPTS]
.br
تنظیم OPTS به عنوان آرگومان‌های اضافی برای فیلتر مقصد (destination filter). مقدار OPTS می‌تواند هر یک از آرگومان‌های معمول فیلتر باشد، مستندات فیلتر را ببینید: `gpac -h doc`
.br
.TP
.B @f1[:args][@fN:args]
.br
تعیین یک زنجیره فیلتر برای درج پیش از تسهیم‌کننده (multiplexer). هر فیلتر در زنجیره به صورت یک فیلتر معمولی قالب‌بندی می‌شود، مستندات فیلتر را ببینید: `gpac -h doc`. جداکننده @@ یک زنجیره جدید را آغاز می‌کند (راهنمای DASH را ببینید). آخرین فیلتر در هر زنجیره نباید هیچ شناسه (ID) مشخص‌شده‌ای داشته باشد.
.br

.br
نکته: sopt، dopt و @f باید بعد از تمامی گزینه‌های دیگر قرار گیرند.
.br
.SH "گزینه‌های عمومی واردسازی (GLOBAL IMPORT OPTIONS)"
.LP
.br
.TP
.B \-add (string)
.br
افزودن ترک‌های فایل داده‌شده به فایل. ورودی‌های چندگانه را می‌توان با استفاده از + مشخص کرد، مانند: \-add url1+url2
.br
.TP
.B \-cat (string)
.br
الحاق نمونه‌های (samples) فایل داده‌شده به فایل، همراه با ایجاد ترک‌ها در صورت نیاز. ورودی‌های چندگانه را می‌توان با استفاده از + مشخص کرد، مانند: \-cat url1+url2.
.br
نکته: این عمل برچسب زمانی (timestamp) اولیه فایل مورد الحاق را تراز می‌کند.
.br
.TP
.B \-catx (string)
.br
مشابه
.I cat
است، اما ترک‌های جدید را می‌توان پیش از الحاق با تعیین +ADD_COMMAND وارد کرد که در آن ADD_COMMAND یک دستور نحوی معمول برای
.I add
است.
.br
.TP
.B \-catpl (string)
.br
الحاق فایل‌های فهرست‌شده در فایل لیست‌پخش داده‌شده (یک فایل در هر خط، خطوطی که با # آغاز می‌شوند توضیح هستند).
.br
نکته: هر فایل فهرست‌شده به‌گونه‌ای الحاق می‌شود که گویی با \-cat فراخوانی شده است.
.br
.TP
.B \-unalign-cat
.br
عدم تلاش برای تراز کردن برچسب‌های زمانی نمونه‌ها در میان ترک‌ها.
.br
.TP
.B \-force-cat
.br
صرف‌نظر کردن از بررسی پیکربندی رسانه هنگام الحاق فایل.
.br
هشدار: این کار ممکن است به خراب شدن ترک(های) الحاق‌شده منجر شود (THIS MAY BREAK THE CONCATENATED TRACK(S)).
.br
.TP
.B \-keep-sys
.br
حفظ تمامی اطلاعات سامانه‌های MPEG-4 هنگام استفاده از
.I add
و
.I cat
(تنها هنگام افزودن فایل‌های IsoMedia استفاده می‌شود).
.br
.TP
.B \-dref
.br
نگه‌داشتن داده‌های رسانه در فایل اصلی با استفاده از ارجاع داده (data referencing). فایل نهایی تنها شامل فراداده‌های ارائه (اندازه فریم‌ها، زمان‌بندی و غیره) بوده و به داده‌های رسانه در فایل اصلی ارجاع می‌دهد. این ویژگی هنگام توسعه محتوا بسیار مفید است، زیرا واردسازی و ذخیره‌سازی فایل MP4 بسیار سریع‌تر بوده و فایل خروجی بسیار کوچک‌تر خواهد بود.
.br
نکته: ارجاع داده ممکن است در برخی فایل‌ها با خطا مواجه شود، زیرا مستلزم آن است که داده‌های فریم‌بندی‌شده (مانند یک نمونه IsoMedia) در فایل اصلی پیوسته باشند، که بسته به درهم‌بافی (interleaving) اولیه یا قالب جریان بیت (bitstream) همیشه برقرار نیست (AVC یا HEVC نمی‌توانند از این گزینه استفاده کنند).
.br
.TP
.B \-no-drop,-nodrop
.br
اجبار به نرخ فریم ثابت (constant FPS) هنگام وارد کردن ویدیوی AVI.
.br
.TP
.B \-packed
.br
اجبار به جریان بیت بسته‌بندی‌شده (packed bitstream) هنگام وارد کردن MPEG-4 part 2 Advanced Simple Profile خام.
.br
.TP
.B \-sbr
.br
سیگنال‌دهی سازگار با نسخه‌های پیشین (backward compatible) برای AAC-SBR.
.br
.TP
.B \-sbrx
.br
سیگنال‌دهی غیرسازگار با نسخه‌های پیشین (non-backward compatible) برای AAC-SBR.
.br
.TP
.B \-ps
.br
سیگنال‌دهی سازگار با نسخه‌های پیشین (backward compatible) برای AAC-PS.
.br
.TP
.B \-psx
.br
سیگنال‌دهی غیرسازگار با نسخه‌های پیشین (non-backward compatible) برای AAC-PS.
.br
.TP
.B \-ovsbr
.br
واردسازی SBR با نمونه‌برداری بیش‌ازحد (oversample) (AAC دارای SBR، AAC دارای PS و SBR نمونه‌برداری بیش‌ازحد شده در زمان وارد کردن قابل شناسایی نیستند).
.br
.TP
.B \-fps (string)
.br
اجبار نرخ فریم برای وارد کردن ویدیو و زیرنویس‌های SUB به مقدار مشخص‌شده، بیان‌شده به صورت یک عدد، به شکل TS-inc یا TS/inc.
.br
نکته: برای وارد کردن H263 خام، FPS پیش‌فرض ۱۵ است، در غیر این صورت ۲۵ خواهد بود. این مقدار برای واردسازی ISOBMFF پذیرفته می‌شود، اما استفاده از گزینه rescale: ارجحیت دارد.
.br
.TP
.B \-mpeg4
.br
اجبار به استفاده از توصیف‌های نمونه (sample descriptions) در MPEG-4 در صورت امکان. برای AAC، سیگنال‌دهی MPEG-4 AAC را حتی در صورت MPEG-2 بودن اجبار می‌کند.
.br
.TP
.B \-agg (int)
.br
تجمیع N فریم صوتی در ۱ نمونه (فقط رسانه‌های 3GP، حداکثر مقدار ۱۵ است).
.br.SH "گزینه‌های نشانه‌گذاری (HINTING OPTIONS)"
.LP
.br
نشانه‌گذاری (hinting) در IsoMedia شامل ایجاد ترک‌های ویژه‌ای در فایل است که حاوی اطلاعات مختص پروتکل انتقال و به صورت اختیاری اطلاعات تسهیم‌سازی (multiplexing) هستند. این ترک‌ها سپس توسط سرور برای ایجاد بسته‌های واقعی ارسالی روی شبکه استفاده می‌شوند؛ به عبارت دیگر، آن‌ها راهنمایی‌هایی (hints) درباره نحوه ساخت بسته‌ها به سرور ارائه می‌دهند، و از این رو ترک‌های hint نامیده می‌شوند.
.br
ابزار MP4Box از ایجاد ترک‌های hint برای سرورهای RTSP پشتیبانی‌کننده از این قابلیت مانند QuickTime Streaming Server، DarwinStreaming Server یا سرورهای RTSP سازگار با 3GPP پشتیبانی می‌کند.
.br
نکته: ابزارهای پخش رسانه GPAC شامل خروجی rtp و سرور rtsp از ترک‌های hint استفاده نمی‌کنند؛ آن‌ها از بسته‌بندی درجا و بلادرنگ (on-the-fly) از هر منبع رسانه‌ای، و نه فقط MP4، بهره می‌برند.
.br
  
.br
گزینه‌ها:
.br
.TP
.B \-hint
.br
نشانه‌گذاری (hint) فایل برای RTP/RTSP
.br
.TP
.B \-mtu (int, default: 1450)
.br
تعیین MTU پروتکل RTP (حداکثر اندازه) بر حسب بایت (شامل ۱۲ بایت سرایند RTP)
.br
.TP
.B \-copy
.br
کپی کردن داده‌های رسانه در ترک hint به جای ارجاع (سرعت سرور را افزایش می‌دهد اما فضای بسیار بیشتری می‌گیرد)
.br
.TP
.B \-multi [maxptime]
.br
فعال‌سازی الحاق فریم‌ها در بسته‌های RTP در صورت امکان (با حداکثر مدت‌زمان ۱۰۰ میلی‌ثانیه یا maxptime میلی‌ثانیه در صورت تعیین)
.br
.TP
.B \-rate (int, default: 90000)
.br
تعیین نرخ rtp بر حسب هرتز (Hz) هنگامی که مقدار پیش‌فرضی برای payload وجود ندارد
.br
.TP
.B \-mpeg4
.br
اجبار به استفاده از بار داده (payload) عمومی MPEG-4 در هر زمان ممکن
.br
.TP
.B \-latm
.br
اجبار به استفاده از انتقال MPG4-LATM برای جریان‌های AAC
.br
.TP
.B \-static
.br
فعال‌سازی شناسه‌های ایستا (static) برای payload پروتکل RTP در صورت امکان (به طور پیش‌فرض، همواره از payloadهای پویا استفاده می‌شود)
.br
.TP
.B \-add-sdp (string)
.br
افزودن رشته SDP داده‌شده به فیلم (string) یا ترک (tkID:string)، که tkID شناسه ترک یا شناسه ترک hint است
.br
.TP
.B \-no-offset
.br
اعلام عدم وجود آفست تصادفی برای شماره توالی (sequence number) و برچسب زمانی (پشتیبانی به سرور بستگی دارد)
.br
.TP
.B \-unhint
.br
حذف تمام اطلاعات hinting از فایل
.br
.TP
.B \-group-single
.br
قرار دادن تمام ترک‌ها در یک گروه hint واحد
.br
.TP
.B \-ocr
.br
اجبار به همگام‌سازی تمام جریان‌های MPEG-4 (تنها در MPEG-4 Systems)
.br
.TP
.B \-rap
.br
اعلام نقاط دسترسی تصادفی (RAP) در بسته‌های RTP (مختص MPEG-4 Systems)
.br
.TP
.B \-ts
.br
اعلام برچسب‌های زمانی AU در بسته‌های RTP (مختص MPEG-4 Systems)
.br
.TP
.B \-size
.br
اعلام اندازه AU در بسته‌های RTP (مختص MPEG-4 Systems)
.br
.TP
.B \-idx
.br
اعلام شماره‌های توالی AU در بسته‌های RTP (مختص MPEG-4 Systems)
.br
.TP
.B \-iod
.br
جلوگیری از تعبیه ترک‌های systems در IOD (مختص MPEG-4 Systems)، ناسازگار با .I -isma
.br
.SH "گزینه‌های کدگذاری صحنه MPEG-4 (MPEG-4 SCENE ENCODING OPTIONS)"
.LP
.br
.SS "ملاحظات عمومی"
.br
ابزار MP4Box از کدگذاری و رمزگشایی فرمت‌های BT، XMT، VRML و (تا حدی) X3D به MPEG-4 BIFS، و کدگذاری و رمزگشایی XSR و SVG به MPEG-4 LASeR پشتیبانی می‌کند.
.br
هر ترک رسانه‌ای مشخص‌شده از طریق یک عنصر MuxInfo، به فایل MP4 خروجی وارد خواهد شد.
.br
به https://wiki.gpac.io/Howtos/scenecoding/MPEG-4-BIFS-Textual-Format و صفحات مرتبط مراجعه کنید.
.br
.SS "دسترسی تصادفی به صحنه (Scene Random Access)"
.br
ابزار MP4Box می‌تواند جریان‌های BIFS یا LASeR را کدگذاری کرده و نقاط دسترسی تصادفی را با بسامد مشخصی درج کند. این قابلیت هنگام بسته‌بندی محتوا برای پخش سراسری (broadcast) که کاربران در زمان‌های مختلف وارد صحنه می‌شوند بسیار کاربردی است. در اصطلاحات MPEG-4، به این فرایند گردونه صحنه (scene carousel) گفته می‌شود. ## پردازش تکه‌ای BIFS
.br
حالت کدگذاری تکه‌ای (chunk) در BIFS امکان کدگذاری واحدهای دسترسی (AU) منفرد BIFS را از یک زمینه (context) اولیه و مجموعه‌ای از دستورات فراهم می‌کند.
.br
واحدهای AU تولیدشده به صورت BIFS خام (بدون بسته‌بندی SL) هستند و در فایل‌هایی به نام FILE-ESID-AUIDX.bifs ذخیره می‌شوند که در آن FILE نام پایه فایل ورودی است.
.br
دستوراتی با زمان‌بندی 0 در ورودی، تنها نسخه carousel (یعنی context خروجی) را تغییر خواهند داد.
.br
دستوراتی با زمان‌بندی متفاوت از 0 در ورودی، AUهای جدیدی ایجاد خواهند کرد.
.br
  
.br
گزینه‌ها:
.br
.TP
.B \-mp4
.br
مشخص می‌کند که فایل ورودی برای کدگذاری BIFS/LASeR است
.br
.TP
.B \-def
.br
کدگذاری نام‌های DEF در BIFS
.br
.TP
.B \-sync (int)
.br
اجبار به تولید نمونه همگام‌سازی (sync sample) در BIFS در هر زمان مشخص بر حسب میلی‌ثانیه (نمی‌توان هم‌زمان با .I shadow یا .I carousel استفاده کرد)
.br
.TP
.B \-shadow (int)
.br
اجبار به تولید نمونه BIFS sync shadow در هر زمان مشخص بر حسب میلی‌ثانیه (نمی‌توان هم‌زمان با .I sync یا .I carousel استفاده کرد)
.br
.TP
.B \-carousel (int)
.br
استفاده از BIFS carousel (نمی‌توان هم‌زمان با .I sync یا .I shadow استفاده کرد)
.br
.TP
.B \-sclog
.br
تولید فایل لاگ (log) برای کدک صحنه در صورت امکان
.br
.TP
.B \-ms (string)
.br
وارد کردن ترک‌ها از فایل مشخص‌شده
.br
.TP
.B \-ctx-in (string)
.br
مشخص کردن فایل زمینه اولیه (MP4/BT/XMT) برای پردازش تکه‌ای. فایل ورودی باید تنها حاوی دستورات باشد
.br
.TP
.B \-ctx-out (string)
.br
مشخص کردن محل ذخیره فایل زمینه به‌روزشده (MP4/BT/XMT) برای پردازش تکه‌ای، اختیاری
.br
.TP
.B \-resolution (int)
.br
ضریب تفکیک‌پذیری (۸- تا ۷، پیش‌فرض ۰) برای کدگذاری LASeR، و تمام مختصات قبل از کوتاه شدن (truncation) در 2^res ضرب می‌شوند (کدگذاری LASeR)
.br
.TP
.B \-coord-bits (int)
.br
تعداد بیت‌های مورد استفاده برای کدگذاری مختصات کوتاه‌شده (۰ تا ۳۱، پیش‌فرض ۱۲) (کدگذاری LASeR)
.br
.TP
.B \-scale-bits (int)
.br
بیت‌های اضافی مورد استفاده برای کدگذاری مقیاس‌های کوتاه‌شده (۰ تا ۴، پیش‌فرض ۰) (کدگذاری LASeR)
.br
.TP
.B \-auto-quant (int)
.br
تفکیک‌پذیری مشابه با استفاده از .I resolution مشخص می‌شود اما coord-bits و scale-bits به طور خودکار استنباط می‌شوند (کدگذاری LASeR)
.br
.TP
.B \-global-quant (int)
.br
تفکیک‌پذیری مشابه با استفاده از .I resolution مشخص می‌شود اما مقدار res به طور خودکار استنباط می‌شود (کدگذاری BIFS)
.br.SH "گزینه‌های رمزنگاری/رمزگشایی (ENCRYPTION/DECRYPTION OPTIONS)"
.LP
.br
دستور MP4Box از رمزنگاری و رمزگشایی محتوای ISMA، OMA و CENC پشتیبانی می‌کند؛ فیلتر رمزنگاری `gpac -h cecrypt` را ببینید.
.br
این کار نیازمند یک فایل XML خاص با نام CryptFile است که ساختار نحوی آن در نشانی https://wiki.gpac.io/xmlformats/Common-Encryption در دسترس است.
.br
فایل‌های تصویر (HEIF) نیز می‌توانند فقط با استفاده از CENC رمزنگاری / رمزگشایی شوند.
.br
  
.br
گزینه‌ها:
.br
.TP
.B \-crypt (string)
.br
رمزنگاری فایل ورودی با استفاده از CryptFile داده‌شده
.br
.TP
.B \-decrypt (string)
.br
رمزگشایی فایل ورودی، در صورت امکان با استفاده از CryptFile داده‌شده. اگر CryptFile داده نشود، در صورت پشتیبانی نشدن سامانه مدیریت کلید، ناموفق خواهد بود
.br
.TP
.B \-set-kms tkID=kms_uri
.br
تغییر مکان KMS در ISMA/OMA برای یک تِرَک مشخص یا برای تمام تِرَک‌ها در صورت استفاده از =all
.br
.SH "گزینه‌های فراداده و HEIF (META AND HEIF OPTIONS)"
.LP
.br
فایل‌های IsoMedia می‌توانند به عنوان نگه‌دارنده‌های عمومی فراداده استفاده شوند، برای نمونه جهت ذخیره اطلاعات XML و تصاویر نمونه برای یک فیلم. فایل حاصل ممکن است همیشه حاوی فیلم نباشد، همان‌گونه که در مورد برخی فایل‌های HEIF یا فایل‌های MPEG-21 صادق است.
.br
  
.br
این اطلاعات می‌توانند در سطح ریشه فایل ذخیره شوند، مانند قالب‌های پرونده HEIF/IFF و MPEG-21، یا در سطح فیلم یا تِرَک برای یک فیلم معمولی.
.br
  
.br
.TP
.B \-set-meta ABCD[:tk=tkID]
.br
تنظیم نوع جعبه فراداده (meta box)، که در آن ABCD نوع چهار نویسه‌ای متا است (NULL یا 0 برای حذف متا)
.br
* tk تنظیم نشده باشد: استفاده از متای ریشه (فایل)
.br
* tkID == 0: استفاده از متای moov
.br
* tkID != 0: استفاده از متای تِرَک مشخص‌شده
.br
.TP
.B \-add-item (string)
.br
افزودن منبع به متا، با ساختار نحوی پارامتر file_path[:opt1:optN]
.br
* مقدار file_path برابر با `this` یا `self`: آیتم خود فایل است
.br
* tk=tkID: مکان فراداده (file، moov، track)
.br
* name=str: نام آیتم، در صورت تنظیم نشدن none
.br
* type=itype: نوع 4cc آیتم (در صورت ارائه mime نیازی نیست)
.br
* mime=mtype: نوع mime آیتم، در صورت تنظیم نشدن none
.br
* encoding=enctype: نوع content-encoding آیتم، در صورت تنظیم نشدن none
.br
* id=ID: شناسه آیتم (عدد صحیح اکیداً مثبت)
.br
* ref=4cc,id: ارجاع از نوع 4cc (مانند \(aqdimg\(aq، \(aqauxl\(aq، \(aqcdsc\(aq) به یک آیتم دیگر (می‌تواند چندین بار تنظیم شود)
.br
* group=4cc,id: مشخص‌کننده نوع 4cc (مانند \(aqaltr\(aq) و شناسه گروه موجودیتی که این آیتم به آن تعلق دارد
.br
* replace: جایگزینی آیتم موجود با آیتم جدید
.br
.TP
.B \-add-image (string)
.br
افزودن فایل مشخص‌شده به عنوان آیتم تصویر HEIF، با ساختار نحوی پارامتر file_path[:opt1:optN]. در صورت حذف filepath، منبع همان فایل MP4 ورودی خواهد بود
.br
* name، id، ref، group: به .I add-item مراجعه کنید
.br
* primary: مشخص می‌کند که این آیتم باید آیتم اصلی (primary) باشد
.br
* time=t[-e][/i]: استفاده از نمونه همگام‌سازی (sync sample) بعدی پس از زمان t (عدد اعشاری، بر حسب ثانیه، پیش‌فرض 0). یک مقدار زمان منفی همه فریم‌های intra را به عنوان آیتم وارد می‌کند
.br
 - اگر e تعیین شود (عدد اعشاری، بر حسب ثانیه)، تمام نمونه‌های همگام‌سازی بین t و e وارد می‌شوند
.br
 - اگر i تعیین شود (عدد اعشاری، بر حسب ثانیه)، گام افزایش زمان بین نمونه‌ها را برای وارد کردن تنظیم می‌کند
.br
* split_tiles: برای یک تصویر کاشی‌کاری‌شده (tiled) با HEVC، هر کاشی به عنوان یک آیتم جداگانه ذخیره می‌شود
.br
* image-size=wxh: اجبار در تنظیم اندازه تصویر و نادیده گرفتن اطلاعات bitstream؛ همچنین برای تصاویر مشتق‌شده از نوع grid، overlay و identity استفاده می‌شود
.br
* rotation=a: تنظیم زاویه چرخش این تصویر به اندازه a*90 درجه پادساعت‌گرد (خلاف جهت عقربه‌های ساعت)
.br
* mirror-axis=axis: تنظیم محور آینه‌ای: vertical (عمودی)، horizontal (افقی)
.br
* clap=Wn,Wd,Hn,Hd,HOn,HOd,VOn,VOd: گزینه clap تِرَک را ببینید
.br
* image-pasp=axb: اجبار در نسبت ابعاد تصویر
.br
* image-pixi=(a|a,b,c): اجبار در عمق بیتی (۱ یا ۳ کانال)
.br
* hidden: مشخص می‌کند که این آیتم تصویر باید پنهان شود
.br
* icc_path: مسیر به داده‌های icc جهت افزودن به عنوان اطلاعات رنگ
.br
* alpha: مشخص می‌کند که تصویر از نوع تصویر آلفا (alpha) است (باید از ref=auxl نیز استفاده شود)
.br
* depth: مشخص می‌کند که تصویر از نوع تصویر عمق (depth) است (باید از ref=auxl نیز استفاده شود)
.br
* it=ID: شناسه آیتمِ منبع را برای وارد کردن مشخص می‌کند. در صورت عدم تعیین و نبود هیچ تِرَکی در منبع، تمام آیتم‌ها وارد می‌شوند
.br
* itp=ID: همانند =it، ولی تمام ویژگی‌های آیتم منبع را رونوشت می‌کند
.br
* tk=tkID: شناسه تِرَک نمونه منبع را مشخص می‌کند. در صورت 0 بودن، از اولین تِرَک ویدیویی موجود در فایل استفاده می‌کند
.br
* samp=N: شماره نمونه برای نمونه منبع را مشخص می‌کند
.br
* ref: داده‌ها رونوشت نمی‌شوند بلکه به مکان نهایی نمونه/آیتم ارجاع داده می‌شود؛ در صورت تعیین filepath نادیده گرفته می‌شود
.br
* agrid[=AR]: ایجاد یک شبکه خودکار از آیتم‌های تصویر موجود در فایل، به ترتیب اعلان آن‌ها. در صورت تعیین AR (عدد اعشاری)، شبکه تلاش می‌کند نسبت ابعاد AR را داشته باشد، در غیر این صورت از نسبت ابعاد منبع استفاده می‌شود. شبکه آیتم اصلی خواهد بود و تمام تصاویر دیگر پنهان خواهند شد
.br
* av1_op_index: انتخاب نقطه عملکردی AV1 (operating point) برای استفاده از طریق جعبه a1op
.br
* replace: جایگزینی تصویر موجود با تصویر جدید، با حفظ ویژگی‌های فهرست‌شده در keep_props
.br
* keep_props=4CCs: فهرستی از انواع ویژگی‌های جداشده با کاما جهت حفظ هنگام جایگزینی تصویر، به عنوان مثال keep_props=auxC
.br
* auxt=URN: علامت‌گذاری تصویر به عنوان کمکی با استفاده از URN مشخص‌شده
.br
* auxd=FILE: استفاده از داده‌های FILE به عنوان افزونه‌های کمکی (جعبه auxC را ببینید)
.br
- هر گزینه دیگری به عنوان گزینه به واردکننده رسانه ارسال خواهد شد، .I \-add را ببینید
.br
.TP
.B \-add-derived-image (string)
.br
ایجاد یک آیتم تصویر مشتق‌شده از نوع شبکه (grid)، روکش (overlay) یا همانی (identity)، با ساختار نحوی پارامتر :type=(grid|iovl|iden)[:opt1:optN]
.br
* image-grid-size=rxc: تنظیم تعداد ردیف‌ها و ستون‌های شبکه
.br
* image-overlay-offsets=h,v[,h,v]*: تنظیم آفست‌های افقی و عمودی تصاویر در روکش
.br
* image-overlay-color=r,g,b,a: تنظیم رنگ بوم (canvas) روکش [0-65535]
.br
- هر گزینه دیگری از .I add-image می‌تواند استفاده شود
.br

.br
.TP
.B \-rem-item,-rem-image item_ID[:tk=tkID]
.br
حذف منبع از فراداده (meta)
.br
.TP
.B \-set-primary item_ID[:tk=tkID]
.br
تنظیم آیتم به عنوان آیتم اصلی برای فراداده
.br
.TP
.B \-set-xml xml_file_path[:tk=tkID][:binary]
.br
تنظیم داده‌های XML فراداده
.br
.TP
.B \-rem-xml [tk=tkID]
.br
حذف داده‌های XML فراداده
.br
.TP
.B \-dump-xml file_path[:tk=tkID]
.br
تخلیه (dump) داده‌های XML فراداده در فایل
.br
.TP
.B \-dump-item item_ID[:tk=tkID][:path=fileName]
.br
تخلیه (dump) آیتم در فایل
.br
.TP
.B \-package (string)
.br
بسته‌بندی فایل XML ورودی در یک نگه‌دارنده ISO؛ تمام رسانه‌های ارجاع داده‌شده به جز پیوندهای اینترنتی به فایل افزوده می‌شوند
.br
.TP
.B \-mgt (string)
.br
بسته‌بندی فایل XML ورودی در یک ابزارک MPEG-U با نگه‌دارنده ISO؛ تمام فایل‌های موجود در پوشه جاری به بسته ابزارک افزوده می‌شوند
.br.SH "گزینه‌های واردکننده SWF (SWF Importer Options)"
.LP
.br

.br
برنامه MP4Box می‌تواند فایل‌های ساده‌ی Macromedia Flash‏ («.SWF») را وارد (import) کند
.br
می‌توانید یک فایل ورودی SWF را با گزینه‌های '\-bt'، '\-xmt' و '\-mp4' مشخص کنید
.br
  
.br
گزینه‌ها:
.br
.TP
.B \-global
.br
تمام تعاریف (defines) فایل SWF به جای قرارگیری در زمان نیاز، در نخستین جایگزینی صحنه قرار می‌گیرند
.br
.TP
.B \-no-ctrl
.br
استفاده از یک جریان (stream) تکی برای کنترل پویانمایی و دیکشنری (این گزینه ActionScript را غیرفعال می‌کند)
.br
.TP
.B \-no-text
.br
حذف تمامی متن‌های SWF
.br
.TP
.B \-no-font
.br
حذف تمامی قلم‌های تعبیه‌شده در SWF (استفاده از قلم‌های میزبان پخش محلی)
.br
.TP
.B \-no-line
.br
حذف تمامی خط‌ها از شکل‌های SWF
.br
.TP
.B \-no-grad
.br
حذف تمامی گرادیان‌ها از شکل‌های SWF
.br
.TP
.B \-quad
.br
استفاده از منحنی‌های بزیه درجه دوم (quadratic) به جای درجه سوم (cubic)
.br
.TP
.B \-xlp
.br
پشتیبانی از شفافیت خطوط و مقیاس‌پذیری
.br
.TP
.B \-ic2d
.br
استفاده از پروتوتایپ سخت‌کدشده (hardcoded proto) برای منحنی دوبعدی نمایه‌گذاری‌شده (indexed curve 2D)
.br
.TP
.B \-same-app
.br
گره‌های ظاهر (appearance nodes) مجدداً استفاده می‌شوند
.br
.TP
.B \-flatten (number)
.br
زاویه متمم که کمتر از آن ۲ خط ادغام می‌شوند، مقدار 0 به معنای عدم ادغام (flattening) است
.br
.SH "پشتیبانی از برچسب‌گذاری (Tagging support)"
.LP
.br
برچسب‌ها به صورت فهرستی جداشده با دونقطه به شکل tag_name=tag_value[:tag2=val2] مشخص می‌شوند
.br
تنظیم یک برچسب بدون مقدار یا با مقدار NULL، آن برچسب را حذف می‌کند.
.br
مقدار ویژه برچسب clear (یا reset) تمام برچسب‌ها را حذف می‌کند.
.br
مقدار ویژه برچسب cust نشان‌دهنده یک برچسب دامنه سفارشی است، که در این حالت مقدار برچسب باید با DOMAIN,MEAN, آغاز شود.
.br
مثال
.br
-itags cust='com.apple.iTunes,iTunEXTC,My Tag Value'
.br

.br
رشته‌های DOMAIN و/یا NAME می‌توانند خالی باشند.
.br
برچسب‌های پشتیبانی‌نشده را می‌توان با استفاده از کد چهارنویسه‌ای (4CC) آن‌ها به عنوان نام برچسب اضافه کرد، و نوع مقدار رشته‌ای در نظر گرفته خواهد شد.
.br
اگر طول نام برچسب ۳ نویسه باشد، از پیشوند 0xA9 برای ایجاد کد چهارنویسه‌ای استفاده می‌شود.
.br
  
.br
برچسب‌ها همچنین می‌توانند با استفاده از -itags filename از یک فایل متنی بارگذاری شوند. فایل باید در قالب UTF8 بوده و شرایط زیر را داشته باشد:
.br
- خطوطی که با tag_name=value شروع می‌شوند، ابتدای یک برچسب را مشخص می‌کنند
.br
- خطوط دیگر باقیمانده آخرین برچسب اعلام‌شده را مشخص می‌کنند
.br
  
.br
اگر نام برچسب با WM/ شروع شود، برچسب به جعبه Xtra اضافه می‌شود (برچسب WMA، فقط رشته).
.br
  
.br
.SS "کلید فراداده کیوتایم (QT metadata key)"
.br
برچسب به عنوان یک کلید فراداده QT اضافه می‌شود اگر:
.br
- نام tag_name با QT/ شروع شود
.br
- یا tag_name شناخته‌شده نبوده و بیش از ۴ نویسه باشد
.br
  
.br
می‌توان به صورت اختیاری به tag_name پیشوند HDLR@ را افزود، که نشان‌دهنده کد چهارنویسه‌ای (4CC) فضای نام برچسب است؛ فضای نام پیش‌فرض mdta می‌باشد.
.br
مقدار برچسب (tag_value) می‌تواند پیشوندهای زیر را داشته باشد:
.br
* S: اجبار در کدگذاری رشته‌ای (باید در ابتدا قرار گیرد) به جای تجزیه مقدار برچسب
.br
* b: استفاده از کدگذاری ۸ بیتی برای عدد صحیح علامت‌دار یا بدون علامت
.br
* s: استفاده از کدگذاری ۱۶ بیتی برای عدد صحیح علامت‌دار یا بدون علامت
.br
* l: استفاده از کدگذاری ۳۲ بیتی برای عدد صحیح علامت‌دار یا بدون علامت
.br
* L: استفاده از کدگذاری ۶۴ بیتی برای عدد صحیح علامت‌دار یا بدون علامت
.br
* f: اجبار در کدگذاری ممیز شناور (float) برای اعداد
.br
اعداد به طور پیش‌فرض تبدیل شده و در حالت اندازه متغیر (variable-size) ذخیره می‌شوند.
.br
برای اجبار یک عدد صحیح مثبت به ذخیره‌سازی به عنوان عدد علامت‌دار، علامت + را در جلوی عدد اضافه کنید.
.br
مثال
.br
-tags io.gpac.some_tag=s+32
.br

.br
این کار ذخیره مقدار 32 را در قالب ۱۶ بیتی علامت‌دار اجبار می‌کند.
.br
مقدار برچسب (tag_value) همچنین می‌تواند به اشکال زیر قالب‌بندی شود:
.br
* XxY@WxH: نوع مستطیل (rectangle)
.br
* XxY: نوع نقطه (point)
.br
* W@H: نوع اندازه (size)
.br
* A,B,C,D,E,F,G,H,I: یک ماتریس ۳×۳
.br
* FNAME: داده‌ها از FNAME بارگذاری می‌شوند، نوع داده در صورت نیاز به jpeg یا png تنظیم می‌شود
.br
  
.br.SS نام‌های برچسب پشتیبانی‌شده (نام، مقدار، نوع، نام‌های مستعار)
.br
title (©nam) رشته (نام مستعار name)
.br
artist (©ART) رشته
.br
album_artist (aART) رشته (نام مستعار albumArtist)
.br
album (©alb) رشته
.br
group (©grp) رشته (نام مستعار grouping)
.br
composer (©com) رشته
.br
writer (©wrt) رشته
.br
conductor (©con) رشته
.br
comment (©cmt) رشته (نام مستعار comments)
.br
genre (gnre) رشته (برچسب ژانر ID3)
.br
created (©day) رشته (نام مستعار releaseDate)
.br
track (©trk) رشته
.br
tracknum (trkn) کسر (نحو: A/B یا A، مقدار B برابر 0 خواهد بود)
.br
disk (disk) کسر (نحو: A/B یا A، مقدار B برابر 0 خواهد بود)
.br
tempo (tmpo) عدد صحیح
.br
compilation (cpil) بولی (yes یا no)
.br
show (tvsh) رشته (نام مستعار tvShow)
.br
episode_id (tven) رشته (نام مستعار tvEpisodeID)
.br
season (tvsn) عدد صحیح (نام مستعار tvSeason)
.br
episode (tves) عدد صحیح (نام مستعار tvEPisode)
.br
network (tvnn) رشته (نام مستعار tvNetwork)
.br
sdesc (desc) رشته (نام مستعار description)
.br
ldesc (ldes) رشته (نام مستعار longDescription)
.br
lyrics (©lyr) رشته
.br
sort_name (sonm) رشته (نام مستعار sortName)
.br
sort_artist (soar) رشته (نام مستعار sortArtist)
.br
sort_album_artist (soaa) رشته (نام مستعار sortAlbumArtist)
.br
sort_album (soal) رشته (نام مستعار sortAlbum)
.br
sort_composer (soco) رشته (نام مستعار sortComposer)
.br
sort_show (sosn) رشته (نام مستعار sortShow)
.br
cover (covr) مسیر فایل (نام مستعار artwork)
.br
copyright (cprt) رشته
.br
tool (©too) رشته (نام مستعار encodingTool)
.br
encoder (©enc) رشته (نام مستعار encodedBy)
.br
pdate (purd) رشته (نام مستعار purchaseDate)
.br
podcast (pcst) بولی (yes یا no)
.br
url (purl) رشته (نام مستعار podcastURL)
.br
keywords (kyyw) رشته
.br
category (catg) رشته
.br
hdvideo (hdvd) عدد صحیح
.br
media (stik) عدد صحیح (نام مستعار mediaType)
.br
rating (rtng) عدد صحیح (نام مستعار contentRating)
.br
gapless (pgap) بولی (yes یا no)
.br
art_director (©ard) رشته
.br
arranger (©arg) رشته
.br
lyricist (©aut) رشته
.br
acknowledgement (©cak) رشته
.br
song_description (©des) رشته
.br
director (©dir) رشته
.br
equalizer (©equ) رشته
.br
liner (©lnt) رشته
.br
record_company (©mak) رشته
.br
original_artist (©ope) رشته
.br
phono_rights (©phg) رشته
.br
producer (©prd) رشته
.br
performer (©prf) رشته
.br
publisher (©pub) رشته
.br
sound_engineer (©sne) رشته
.br
soloist (©sol) رشته
.br
credits (©src) رشته
.br
thanks (©thx) رشته
.br
online_info (©url) رشته
.br
exec_producer (©xpd) رشته
.br
genre (©gen) رشته (برچسب ژانر ID3)
.br
location (©xyz) رشته
.br.SH "گزینه‌های رمزگذار زنده صحنه (Live Scene Encoder Options)"
.LP
.br
گزینه‌ها باید به صورت opt_name=opt_val مشخص شوند.
.br
گزینه‌ها:
.br

.br
.TP
.B \-live
.br
فعال‌سازی رمزگذار زنده BIFS/LASeR
.br
.TP
.B \-dst (رشته)
.br
آدرس IP مقصد
.br
.TP
.B \-port (عدد صحیح، پیش‌فرض: 7000)
.br
درگاه (port) مقصد
.br
.TP
.B \-mtu (عدد صحیح، پیش‌فرض: 1450)
.br
مقدار MTU مسیر برای بسته‌های RTP
.br
.TP
.B \-ifce (رشته)
.br
آدرس IP رابط فیزیکی مورد استفاده
.br
.TP
.B \-ttl (عدد صحیح، پیش‌فرض: 1)
.br
طول عمر (TTL) برای بسته‌های چندپخشی (multicast)
.br
.TP
.B \-sdp (رشته، پیش‌فرض: session.sdp)
.br
فایل SDP خروجی
.br
.TP
.B \-dims
.br
فعال‌سازی حالت DIMS برای ورودی SVG
.br
.TP
.B \-no-rap
.br
غیرفعال‌سازی ارسال RAP و ایجاد carousel
.br
.TP
.B \-src (رشته)
.br
منبع به‌روزرسانی‌های صحنه
.br
.TP
.B \-rap (عدد صحیح)
.br
مدت زمان کاروسل (carousel) پایه به میلی‌ثانیه؛ می‌توانید دوره تناوب RAP یک ESID مجزا (غیر از DIMS) را با استفاده از ESID=X:time مشخص کنید
.br
  
.br
گزینه‌های زمان اجرا:
.br
* q: خروج
.br
* u: دریافت دستورها برای ارسال
.br
* U: همانند u، اما به‌روزرسانی‌ها را به عنوان حیاتی (critical) علامت‌گذاری می‌کند
.br
* e: دریافت دستورها برای ارسال بدون تجمیع‌سازی (aggregation)
.br
* E: همانند e، اما به‌روزرسانی‌ها را به عنوان حیاتی (critical) علامت‌گذاری می‌کند
.br
* f: ارسال اجباری RAP
.br
* F: تولید مجدد و ارسال اجباری RAP
.br
* p: خروجی گرفتن از صحنه فعلی (dump)
.br
.SH "مثال‌ها (EXAMPLES)"
.TP
مثال‌های مقدماتی و پیشرفته در https://wiki.gpac.io/MP4Box/MP4Box در دسترس هستند
.SH "اطلاعات بیشتر (MORE)"
.LP
نویسندگان: توسعه‌دهندگان GPAC، تاریخچه مخزن git را بررسی کنید (-log)
.br
برای گزارش باگ‌ها، درخواست ویژگی‌ها، اطلاعات بیشتر و کد منبع، از https://github.com/gpac/gpac دیدن کنید
.br
ساخت: 26.07
.br
کپی‌رایت: (c) 2000-2024 Telecom Paris توزیع‌شده تحت مجوز LGPL v2.1+ - https://gpac.io
.br
.SH "همچنین ببینید (SEE ALSO)"
.LP
gpac(1)