.TH gpac 1 2019 gpac GPAC . .SH "نام (NAME)" .LP gpac \- مدیر نشست فیلتر خط فرمان GPAC .SH "خلاصه دستور (SYNOPSIS)" .LP .B gpac .RI [options] FILTER [LINK] FILTER [...] .br . .SH "توضیحات (DESCRIPTION)" .LP این صفحه تمام فیلترهایی را که معمولاً در GPAC وجود دارند، توصیف می‌کند. برای بررسی راهنمای فیلتری که در اینجا فهرست نشده است، از gpac -h myfilter استفاده کنید. .SH inspect .LP .br شرح: بازرس بسته (Packet inspector) .br .br فیلتر inspect می‌تواند برای استخراج (dump) PID و بسته‌ها استفاده شود. همچنین می‌تواند برای بررسی بخش‌هایی از بار مفید (payload) بسته‌ها به کار رود. .br .br گزینه‌های پیش‌فرض تنها تغییرات PID را بازرسی می‌کنند. .br اگر .I full تنظیم نشده باشد، .I mode به frame اجبار می‌شود و مشخصه‌های PID به صورت خوانا برای انسان، یک PID در هر خط قالب‌بندی می‌شوند. .br در غیر این صورت، تمام مشخصه‌ها استخراج می‌شوند. .br نکته: تعیین .I xml، .I analyze، .I fmt یا استفاده از -for-test مقدار .I full را به true اجبار خواهد کرد. .br .br .SH "استخراج سفارشی مشخصه‌ها (Custom property dumping)" .LP .br بازرس بسته می‌تواند برای استخراج مشخصه‌های معینی از بسته‌ها با استفاده از .I fmt پیکربندی شود. .br هنگامی که این گزینه ارائه نشده باشد، تمام مشخصه‌ها استخراج می‌شوند. در غیر این صورت، تنها مشخصه‌های تعیین‌شده با $TOKEN$ چاپ می‌شوند. می‌توانید از '$'، '@' یا '%' به عنوان جداکننده TOKEN استفاده کنید. مقدار TOKEN می‌تواند یکی از موارد زیر باشد: .br * pn: شماره بسته (فریم در حالت framed) .br * dts: برچسب زمانی رمزگشایی در مقیاس زمانی جریان، در صورت عدم دسترسی N/A .br * ddts: اختلاف بین برچسب زمانی رمزگشایی بسته‌های فعلی و قبلی در مقیاس زمانی جریان، در صورت عدم دسترسی N/A .br * cts: برچسب زمانی ترکیب در مقیاس زمانی جریان، در صورت عدم دسترسی N/A .br * dcts: اختلاف بین برچسب زمانی ترکیب بسته‌های فعلی و قبلی در مقیاس زمانی جریان، در صورت عدم دسترسی N/A .br * ctso: اختلاف بین برچسب زمانی ترکیب و برچسب زمانی رمزگشایی در مقیاس زمانی جریان، در صورت عدم دسترسی N/A .br * tmcd: کد زمان به صورت ارائه‌شده در SEI، در صورت عدم دسترسی N/A (نیازمند reframer) .br * dur: مدت‌زمان در مقیاس زمانی جریان .br * frame: وضعیت فریم‌بندی .br * interface: واحد دسترسی (AU) کامل، شیء واسط (بدون اطلاعات اندازه). معمولاً یک بافت GL .br * frame_full: واحد دسترسی (AU) کامل .br * frame_start: آغاز فریم .br * frame_end: پایان فریم .br * frame_cont: ادامه فریم (نه آغاز و نه پایان) .br * sap یا rap: نوع SAP فریم .br * ilace: پرچم درهم‌بافی (0: progressive، 1: top field، 2: bottom field) .br * corr: پرچم بسته معیوب .br * seek: پرچم جستجو (seek) .br * bo: آفست بایتی در منبع، در صورت عدم دسترسی N/A .br * roll: اطلاعات roll .br * crypt: پرچم رمزگذاری (crypt) .br * vers: شماره نسخه carousel .br * size: اندازه بسته .br * csize: اندازه کل بسته‌های دریافت شده تاکنون .br * crc: مقدار ۳۲ بیتی CRC بسته .br * lf یا n: درج خط جدید .br * t: درج تب .br * data: استخراج هگزادسیمال بسته (خروجی بسیار بزرگ!) یا به صورت رشته در صورت معتبر بودن UTF-8 .br * lp: پرچم تصویر پیشرو (leading picture) .br * depo: پرچم وابستگی به بسته‌ای دیگر .br * depf: پرچم مورد وابستگی قرار داشتن توسط بسته‌ای دیگر .br * red: پرچم کدگذاری اضافی (redundant coding) .br * start: زمان ترکیب بسته در قالب HH:MM:SS.ms .br * startc: زمان ترکیب بسته در قالب HH:MM:SS,ms .br * end: زمان پایان بسته در قالب HH:MM:SS.ms .br * endc: زمان پایان بسته در قالب HH:MM:SS,ms .br * ck: نوع ساعت مورداستفاده برای ناپیوستگی‌های PCR .br * pcr: آخرین مقدار PCR در MPEG-2 TS، در صورت عدم دسترسی n/a .br * pcrd: اختلاف بین آخرین PCR و زمان رمزگشایی، در صورت عدم وجود PCR برابر n/a .br * pcrc: اختلاف بین آخرین PCR و زمان ترکیب، در صورت عدم وجود PCR برابر n/a .br * P4CC: شناسه 4CC مشخصه بسته .br * PropName: نام مشخصه بسته .br * pid.P4CC: شناسه 4CC مشخصه PID .br * pid.PropName: نام مشخصه PID .br * fn: نام فیلتر .br .br مثال .br fmt="PID $pid.ID$ packet $pn$ DTS $dts$ CTS $cts$ $lf$" .br .br این دستور شماره بسته، cts و dts را به این صورت استخراج می‌کند: PID 1 packet 10 DTS 100 CTS 108 \en .br .br یک کلیدواژه ناشناخته یا مشخصه ناموجود به یک رشته خالی تبدیل می‌شود. .br .br نکته: هنگام استخراج در حالت درهم‌تنیده (interleaved)، هیچ تضمینی وجود ندارد که بسته‌ها با ترتیب توالی اصلی خود استخراج شوند؛ زیرا بازرس در هر بار یک بسته را از هر PID واکشی می‌کند. .br .br.SH "نکته درباره پخش (Note on playback)" .LP .br بافرسازی (Buffering) را می‌توان برای بررسی رفتار زنجیره فیلتر ورودی فعال کرد؛ به عنوان مثال، بررسی منطق تطبیق‌پذیری HAS. .br گزینه‌های مختلف بافرسازی زمان مصرف بسته‌ها را کنترل می‌کنند. رویدادهای بافرسازی با استفاده از media@info برای تغییرات وضعیت و media@debug برای رویدادهای پر شدن رسانه ثبت می‌شوند. .br گزینه .I speed تنها برای پیکربندی زنجیره فیلتر به کار می‌رود، اما هنگام مصرف بسته‌ها توسط فیلتر نادیده گرفته می‌شود. .br اگر به مصرف بی‌درنگ (real-time) نیاز باشد، باید یک فیلتر reframer پیش از فیلتر inspect راه‌اندازی شود. .br مثال .br gpac -i SRC reframer:rt=on inspect:buffer=10000:rbuffer=1000:mbuffer=30000:speed=2 .br .br این دستور نشست را با سرعت 2x پخش خواهد کرد، از حداکثر ۳۰ ثانیه بافرسازی استفاده می‌کند، بسته‌ها را پس از آماده شدن ۱۰ ثانیه از رسانه به مصرف می‌رساند و در صورت وجود کمتر از ۱ ثانیه از رسانه، بافرسازی مجدد انجام می‌دهد. .br .br .SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br log (str، پیش‌فرض: stdout، شمارشی: _any|stderr|stdout|GLOG|TL|null): تنظیم نام فایل گزارش probe .br * _any: مسیر و نام فایل مقصد .br * stderr: تخلیه به stderr .br * stdout: تخلیه به stdout .br * GLOG: استفاده از لاگ‌های GPAC در سطح app@info .br * TL: استفاده از ابزار لاگ GPAC به نام TL در سطح info .br * null: حالت بی‌صدا (silent) .br .br mode (enum، پیش‌فرض: pck): حالت تخلیه (dump) .br * pck: تخلیه کامل بسته .br * blk: تخلیه بسته‌ها پیش از بازسازی .br * frame: اجبار به استفاده از reframer .br * raw: تخلیه بسته‌های منبع بدون تفکیک‌سازی (demultiplexing) .br .br interleave (bool، پیش‌فرض: true): تخلیه بسته‌ها به محض دریافت در هر PID. در صورت false بودن، گزارش‌ها برای هر PID در انتهای نشست ثبت می‌شوند .br deep (bool، پیش‌فرض: false، قابل به‌روزرسانی): تخلیه بسته‌ها همراه با تغییر وضعیت PID؛ در صورت تنظیم .I fmt به طور ضمنی فعال می‌شود .br props (bool، پیش‌فرض: true، قابل به‌روزرسانی): تخلیه ویژگی‌های بسته؛ در صورت تنظیم .I fmt نادیده گرفته می‌شود .br dump_data (bool، پیش‌فرض: false، قابل به‌روزرسانی): فعال‌سازی تخلیه کامل داده‌ها (خروجی بسیار حجیم)؛ در صورت تنظیم .I fmt نادیده گرفته می‌شود .br fmt (str، قابل به‌روزرسانی): تنظیم قالب تخلیه بسته .br hdr (bool، پیش‌فرض: true): چاپ سرآیند متناظر با رشته fmt بدون '$' یا "pid" .br allp (bool، پیش‌فرض: false): تحلیل در کل مدت زمان، به جای متوقف شدن پس از یافتن تمامی PIDها .br info (bool، پیش‌فرض: false، قابل به‌روزرسانی): پایش تغییرات اطلاعات PID .br full (bool، پیش‌فرض: false، قابل به‌روزرسانی): تخلیه کامل ویژگی‌های PID (در صورت استفاده از XML همواره فعال است) .br pcr (bool، پیش‌فرض: false، قابل به‌روزرسانی): تخلیه اطلاعات PCR در M2TS .br speed (dbl، پیش‌فرض: 1.0): تنظیم سرعت دستور پخش. اگر منفی باشد و start برابر با 0 باشد، مقدار start روی \-1 تنظیم می‌شود .br start (dbl، پیش‌فرض: 0.0): تنظیم آفست آغاز پخش. مقدار منفی به معنای درصدی از مدت زمان رسانه است که در آن \-1 برابر با کل مدت زمان خواهد بود .br dur (frac، پیش‌فرض: 0/0): تنظیم مدت زمان بازرسی (inspect) .br analyze (enum، پیش‌فرض: off، قابل به‌روزرسانی): تحلیل محتوای نمونه (NALU، OBU)، مشابه گزینه \-bsdbg در فیلترهای reframer .br * off: بدون تحلیل .br * on: تحلیل ساده .br * bs: ثبت نحو جریان بیتی (تمامی عناصر خوانده‌شده از bitstream) .br * full: ثبت نحو جریان بیتی و اندازه‌های بیت که پس از مقدار فیلد با (N) مشخص می‌شوند، به جز فیلدهای تک‌بیتی (صرف‌نظر می‌شوند) .br .br xml (bool، پیش‌فرض: false، قابل به‌روزرسانی): استفاده از قالب‌بندی xml (در صورت تنظیم (-analyze]() به طور ضمنی فعال می‌شود) و غیرفعال‌سازی .I fmt .br crc (bool، پیش‌فرض: false، قابل به‌روزرسانی): تخلیه crc نمونه‌ها یا زیرنمونه‌ها (NALU یا OBU) هنگام تحلیل .br fftmcd (bool، پیش‌فرض: false، قابل به‌روزرسانی): در نظر گرفتن کد زمانی با استفاده از نشانه‌گذاری سازگار با ffmpeg به جای سیگنال‌دهی منطبق با QT .br dtype (bool، پیش‌فرض: false، قابل به‌روزرسانی): تخلیه نوع ویژگی .br buffer (uint، پیش‌فرض: 0): تنظیم بافر پخش بر حسب میلی‌ثانیه .br mbuffer (uint، پیش‌فرض: 0): تنظیم حداکثر اشغال بافر بر حسب میلی‌ثانیه. اگر کمتر از buffer باشد، از مقدار buffer استفاده می‌شود .br rbuffer (uint، پیش‌فرض: 0، قابل به‌روزرسانی): محرک بافرسازی مجدد بر حسب میلی‌ثانیه. اگر 0 یا بیشتر از buffer باشد، بافرسازی مجدد غیرفعال می‌شود .br stats (bool، پیش‌فرض: false): محاسبه آمار برای PIDها .br timeout (uint، پیش‌فرض: 5000): مهلت زمانی (timeout) بر حسب میلی‌ثانیه هنگام بازرسی ساده در صورتی که هیچ بسته‌ای روی برخی PIDها دریافت نشود .br test (enum، پیش‌فرض: no، قابل به‌روزرسانی): نادیده گرفتن مجموعه‌ای پیش‌تعریف‌شده از ویژگی‌ها، برای حالت آزمایشی استفاده می‌شود .br * no: هیچ ویژگی نادیده گرفته نمی‌شود .br * noprop: تمامی ویژگی‌ها/تغییرات اطلاعات روی PID نادیده گرفته شده و تنها بسته‌ها تخلیه می‌شوند .br * network: تخلیه URL/مسیر، وضعیت حافظه پنهان (cache) و ویژگی‌های اندازه فایل نادیده گرفته می‌شوند (برای درهم‌سازی نتایج شبکه استفاده می‌شود) .br * netx: مشابه network اما مدت زمان قطعه (track duration) و الگوها (templates) نادیده گرفته می‌شوند (برای درهم‌سازی بارگذاری تدریجی fmp4 استفاده می‌شود) .br * encode: مشابه network به همراه نادیده گرفتن پیکربندی رمزگشا (برای درهم‌سازی نتایج رمزگذاری استفاده می‌شود) .br * encx: مشابه encode به همراه نادیده گرفتن نرخ‌های بیت، اندازه داده‌های رسانه و موارد مشابه .br * nocrc: غیرفعال کردن تخلیه CRC بسته .br * nobr: نادیده گرفتن نرخ بیت (bitrate) .br .br .br.SH probe .LP .br شرح: کاوشگر منبع .br .br فیلتر Probe توسط برنامه‌ها (به‌ویژه MP4Box) برای پرس‌وجوی PIDهای چندگانه‌زدایی‌شده (صدا، ویدیو، ...) موجود در یک زنجیره منبع استفاده می‌شود. .br .br این فیلتر تعداد PIDهای ورودی را در فایل مشخص‌شده توسط .I log خروجی می‌دهد. .br پرس‌وجوی PIDهای ورودی کاوشگر و اتخاذ تصمیم‌های مناسب بر عهده توسعه‌دهنده برنامه است. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (expert)):" .LP .br log (str, پیش‌فرض: stdout, Enum: _any|stderr|stdout|GLOG|null): تنظیم نام فایل گزارش probe برای چاپ تعداد جریان‌ها .br * _any: مسیر و نام فایل مقصد .br * stderr: ارسال به stderr .br * stdout: ارسال به stdout .br * GLOG: استفاده از گزارش‌های GPAC در سطح app@info .br * null: حالت بی‌صدا .br .br .br .SH compositor .LP .br شرح: ترکیب‌کننده (Compositor) .br .br ترکیب‌کننده GPAC امکان ترکیب صدا، ویدیو، متن و گرافیک را به صورت زمان‌بندی‌شده فراهم می‌کند. .br ترکیب‌کننده در یکی از دو حالت media-client یا فقط فیلتر (filter-only) عمل می‌کند. .br .br .SH "حالت کلاینت چندرسانه‌ای (Media-client mode)" .LP .br در این حالت، ترکیب‌کننده به عنوان یک شبه‌مقصد (pseudo-sink) برای بخش ویدیو عمل کرده و پنجره خروجی اختصاصی خود را ایجاد می‌کند. .br فریم‌های ویدیویی در قالب اشاره‌گرهای فریم به PID ویدیوی خروجی ارسال می‌شوند که در صورت استفاده، بعداً نیازمند خوانده‌شدن توسط GPU خواهند بود. .br بخش صوتی مانند یک فیلتر معمولی عمل کرده و برای تولید خروجی خود، احتمالاً ورودی‌های صوتی را ترکیب و بازنمونه‌برداری می‌کند. .br در این حالت، رویدادهای کاربر مستقیماً توسط فیلتر پردازش می‌شوند. .br .br .SH "حالت فیلتر (Filter mode)" .LP .br در این حالت، ترکیب‌کننده به عنوان یک فیلتر معمولی عمل کرده و فریم‌ها را بر اساس صحنه بارگذاری‌شده تولید می‌کند. .br این فیلتر خروجی‌های خود را بر اساس فریم‌های ویدیویی ورودی تولید کرده و رویدادهای کاربر ارسال‌شده توسط فیلتر(های) مصرف‌کننده را پردازش خواهد کرد. .br در صورت نبود فریم‌های ویدیویی ورودی (مثلاً BIFS / SVG / VRML خالص)، فیلتر فریم‌ها را بر اساس .I fps با نرخ فریم ثابت یا متغیر تولید خواهد کرد. .br تولید فریم‌ها به محض پایان یافتن تمام جریان‌های ورودی متوقف خواهد شد، مگر اینکه توسط .I dur افزایش یا کاهش یافته باشد. .br در صورت بارگذاری جریان‌های صوتی، یک PID خروجی صوتی ایجاد می‌شود. .br .br قالب پیش‌فرض پیکسل خروجی در حالت فیلتر عبارت است از: .br \- rgb هنگامی که فیلتر صراحتاً توسط برنامه بارگذاری شده باشد .br \- rgba هنگامی که فیلتر در حین تفکیک پیوند بارگذاری شود .br این مقدار را می‌توان با مقداردهی به گزینه .I opfmt تغییر داد. .br اگر .I opfmt کانال آلفا را مشخص کند یا .I bc برابر ۰ نبوده ولی دارای alpha=0 باشد، از ایجاد پس‌زمینه در صحنه پیش‌فرض صرف‌نظر خواهد شد. .br .br در حالت filter-only، نشانی اینترنتی ویژه gpid:// برای تعیین موقعیت PIDها در توصیف صحنه استفاده می‌شود تا امکان طراحی صحنه‌ها مستقل از رسانه مبدا فراهم گردد. .br هنگامی که چنین PIDای به یک گره Background2D در BIFS مرتبط شود (هنوز نگاشت SVG وجود ندارد)، ترکیب‌کننده در حالت pass-through عمل می‌کند. .br در این حالت، تنها فریم‌های ورودی جدید روی PID عبوری (pass-through) فریم‌های جدید تولید می‌کنند و ساعت صحنه با زمان بسته ورودی مطابقت دارد. .br اندازه و قالب پیکسل خروجی برابر با اندازه و قالب پیکسل ورودی تنظیم خواهد شد، مگر اینکه در گزینه‌های فیلتر خلاف آن مشخص شده باشد. .br .br اگر فقط از گرافیک دوبعدی استفاده شود و درایور نمایشگر اجبار نشده باشد، شطرنجی‌سازی دوبعدی (2D rasterizer) در قالب پیکسل خروجی (شامل قالب‌های پیکسل YUV) انجام خواهد شد. .br در این حالت، تا زمانی که داده‌های ورودی اجازه دهند، پردازش درجا (شطرنجی‌سازی روی داده‌های فریم ورودی) استفاده خواهد شد. .br .br اگر گرافیک سه‌بعدی استفاده شود یا درایور نمایشگر اجبار شده باشد، OpenGL روی یک سطح بیرون از صفحه (offscreen surface) استفاده خواهد شد و بسته خروجی یک بافت OpenGL خواهد بود. .br .br .SH "نحوهای خاص نشانی اینترنتی (Specific URL syntaxes)" .LP .br ترکیب‌کننده هر نوع URL پشتیبانی‌شده توسط GPAC را می‌پذیرد. همچنین طرحواره‌های زیر را برای URLها قبول می‌کند: .br * views:// : یک صحنه خودکار-استریو (auto-stereo) از N نما از views://v1::.::vN ایجاد می‌کند .br * mosaic:// : یک موزاییک از N نما از mosaic://v1::.::vN ایجاد می‌کند .br .br برای هر دو نحو، vN می‌تواند هر نوع URL پشتیبانی‌شده توسط GPAC باشد. .br برای نحو views://، تعداد نماهای رندرشده توسط .I nbviews تعیین می‌شود: .br \- اگر URL نماهای کمتری نسبت به نماهای رندرشده ارائه دهد، نماها تکرار خواهند شد .br \- اگر URL نماهای بیشتری نسبت به نماهای رندرشده ارائه دهد، نماهای اضافی نادیده گرفته خواهند شد .br .br ترکیب‌کننده می‌تواند زمانی که گزینه .I src صراحتاً تنظیم شده باشد، مستقل از حالت عملیاتی به عنوان یک فیلتر منبع عمل کند: .br .br gpac compositor:src=source.mp4 vout .br .br .br ترکیب‌کننده می‌تواند زمانی که URL منبع از یکی از طرحواره‌های پروتکل داخلی ترکیب‌کننده استفاده می‌کند، به عنوان یک فیلتر منبع عمل کند: .br .br gpac -i mosaic://URL1:URL2 vout .br .br .br.SH "گزینه‌ها (پیشرفته) (OPTIONS (EXPERT))" .LP .br aa (enum، پیش‌فرض: all، قابل به‌روزرسانی): تنظیم حالت ضدپلگی (anti-aliasing) برای گرافیک‌های شطرنجی؛ اعمال شدن یا نشدن این تنظیم به ماژول گرافیکی یا کارت گرافیک بستگی دارد .br * none: بدون ضدپلگی .br * text: ضدپلگی فقط برای متن .br * all: ضدپلگی کامل .br .br hlfill (uint، پیش‌فرض: 0x0، قابل به‌روزرسانی): تنظیم رنگ پر کردن برجسته‌سازی (ARGB) .br hlline (uint، پیش‌فرض: 0xFF000000، قابل به‌روزرسانی): تنظیم رنگ خط دور برجسته‌سازی (ARGB) .br hllinew (flt، پیش‌فرض: 1.0، قابل به‌روزرسانی): تنظیم پهنای خط دور برجسته‌سازی .br sz (bool، پیش‌فرض: true، قابل به‌روزرسانی): فعال‌سازی بزرگ‌نمایی مقیاس‌پذیر. هنگامی که بزرگ‌نمایی مقیاس‌پذیر فعال باشد، تغییر اندازه پنجره خروجی موجب محاسبه مجدد همه اشیاء برداری نیز می‌شود. در غیر این صورت تنها بافر نهایی کشیده می‌شود .br bc (uint، پیش‌فرض: 0، قابل به‌روزرسانی): رنگ پس‌زمینه پیش‌فرض برای نمایش تصاویر شفاف یا ویدیوهای بدون دستورالعمل‌های ترکیب صحنه .br yuvhw (bool، پیش‌فرض: true، قابل به‌روزرسانی): فعال‌سازی سخت‌افزار YUV برای blit دوبعدی .br blitp (bool، پیش‌فرض: true، قابل به‌روزرسانی): انتقال جزئی سخت‌افزاری (hardware blit جزئی). در صورت عدم تنظیم، بازترسیم بیشتری را تحمیل می‌کند .br softblt (bool، پیش‌فرض: true): فعال‌سازی blit/کشش نرم‌افزاری در 2D. در صورت غیرفعال بودن، همواره از شطرنجی‌ساز گرافیک برداری استفاده خواهد شد .br stress (bool، پیش‌فرض: false، قابل به‌روزرسانی): فعال‌سازی حالت آزمون فشار (stress) ترکیب‌کننده (بازسازی تمام گرافیک‌های برداری و وضعیت‌های بافت در هر فریم) .br fast (bool، پیش‌فرض: false، قابل به‌روزرسانی): فعال‌سازی بهینه‌سازی سرعت - اعمال شدن یا نشدن این تنظیم به ماژول گرافیکی / کارت گرافیک بستگی دارد .br bvol (enum، پیش‌فرض: no، قابل به‌روزرسانی): رسم حجم محصورکننده (bounding volume) اشیاء .br * no: غیرفعال‌سازی جعبه محصورکننده .br * box: رسم یک مستطیل (2D) یا مکعب (3D) .br * aabb: رسم درخت جعبه محصورکننده هم‌راستا با محور (3D) یا مستطیل (2D) .br .br textxt (enum، پیش‌فرض: default، قابل به‌روزرسانی): تعیین اینکه آیا متن باید روی یک بافت (texture) رسم و سپس رندر شود یا مستقیماً رندر گردد. استفاده از متن بافت‌دار می‌تواند رندر متن در 3D و نیز محتواهای مشابه متن روی ویدیو را بهبود بخشد .br * default: استفاده از بافت‌دهی برای رندر OpenGL، بدون بافت برای شطرنجی‌ساز 2D .br * never: هرگز از بافت‌های متنی استفاده نمی‌کند .br * always: همواره پیش از رسم، متن را روی بافت رندر می‌کند .br .br out8b (bool، پیش‌فرض: false، قابل به‌روزرسانی): تبدیل ویدیوی ۱۰ بیتی به بافت ۸ بیتی قبل از بارگذاری روی GPU .br drop (bool، پیش‌فرض: false، قابل به‌روزرسانی): انداختن فریم‌های با تاخیر هنگام رسم. در صورت عدم تنظیم، فریم‌ها تا زمانی که ناهمگامی ۱ ثانیه یا بیشتر مشاهده نشود، نادیده گرفته نمی‌شوند .br sclock (bool، پیش‌فرض: false، قابل به‌روزرسانی): اجبار به همگام‌سازی همه جریان‌ها بر اساس یک ساعت واحد .br sgaze (bool، پیش‌فرض: false، قابل به‌روزرسانی): شبیه‌سازی رویدادهای نگاه (gaze) با استفاده از ماوس .br ckey (uint، پیش‌فرض: 0، قابل به‌روزرسانی): کلید رنگ (color key) برای استفاده در حالت بدون پنجره (0xFFRRGGBB). در حال حاضر GPAC به دلیل محدودیت‌های موجود در بیشتر تولکیت‌های پنجره‌بندی از blitting آلفای واقعی روی میزکار پشتیبانی نمی‌کند، بنابراین از سازوکار کلیدگذاری رنگی استفاده می‌کند. بخش آلفای کلید در صورت پشتیبانی، برای شفافیت کلی خروجی استفاده می‌شود .br timeout (uint، پیش‌فرض: 10000، قابل به‌روزرسانی): زمان انقضا بر حسب میلی‌ثانیه که پس از آن یک منبع از دست رفته تلقی می‌شود (۰ زمان انقضا را غیرفعال می‌کند) .br fps (frac، پیش‌فرض: 30/1، قابل به‌روزرسانی): نرخ فریم شبیه‌سازی در هنگام پخش منابع صرفاً انیمیشنی (در صورت وجود ویدیو نادیده گرفته می‌شود) .br timescale (uint، پیش‌فرض: 0، قابل به‌روزرسانی): مقیاس زمانی مورد استفاده برای بسته‌های خروجی در صورت عدم وجود PID ویدیوی ورودی. مقدار ۰ به معنای صورت کسر fps است .br autofps (bool، پیش‌فرض: true): استفاده از fps ورودی ویدیو برای خروجی، در حالت player نادیده گرفته می‌شود. در صورت نبود ویدیو یا تنظیم نشدن، از .I fps استفاده می‌کند .br vfr (bool، پیش‌فرض: false): انتشار فریم‌ها تنها در صورت تشخیص تغییرات. (در حالت پخش‌کننده و زمانی که فیلتر به صورت پویا بارگذاری می‌شود همواره true است) .br dur (dbl، پیش‌فرض: 0، قابل به‌روزرسانی): مدت زمان تولید. بیشتر زمانی که هیچ ویدیوی ورودی وجود ندارد استفاده می‌شود. مقادیر منفی به معنای تعداد فریم‌ها، مقادیر مثبت مدت زمان به ثانیه و ۰ به معنای توقف به محض پایان همه جریان‌ها است .br fsize (bool، پیش‌فرض: false، قابل به‌روزرسانی): اجبار صحنه به تغییر اندازه به بزرگ‌ترین بیت‌مپ (bitmap) موجود در صورتی که اطلاعات اندازه‌ای در پیکربندی BIFS ارائه نشده باشد .br mode2d (enum، پیش‌فرض: defer، قابل به‌روزرسانی): مشخص کردن اینکه آیا باید از رسم فوری (immediate) استفاده شود یا خیر .br * immediate: صفحه در هر فریم کاملاً بازترسیم می‌شود (اگر حالت pass-through شناسایی شود همواره روشن است) .br * defer: موقعیت اشیاء فریم به فریم دنبال می‌شود و اطلاعات مستطیل‌های تغییریافته (dirty rectangles) جمع‌آوری می‌گردد تا حداقل مقدار ممکن از بافر صفحه بازترسیم شود .br * debug: فقط نواحی تغییریافته را رندر می‌کند و سایر نواحی را بازنشانی می‌نماید .br اعمال شدن یا نشدن این تنظیم به ماژول گرافیکی و حالت پخش‌کننده بستگی دارد .br .br amc (bool، پیش‌فرض: true): پشتیبانی از صدای چندکاناله؛ در صورت غیرفعال بودن همیشه به استریو ترکیب رو به پایین (down-mix) می‌شود. زمانی مفید است که خروجی چندکاناله به درستی کار نکند .br asr (uint، پیش‌فرض: 0): اجبار نرخ نمونه‌برداری خروجی (۰ برای خودکار) .br ach (uint، پیش‌فرض: 0): اجبار کانال‌های خروجی (۰ برای خودکار) .br alayout (uint، پیش‌فرض: 0): اجبار چینش کانال‌های خروجی (۰ برای خودکار) .br afmt (afmt، پیش‌فرض: s16، Enum: none|u8|s16|s16b|s24|s24b|s32|s32b|flt|fltb|dbl|dblb|u8p|s16p|s24p|s32p|fltp|dblp): اجبار قالب کانال خروجی (۰ برای خودکار) .br .br asize (uint، پیش‌فرض: 1024): اندازه بسته خروجی صوتی بر حسب نمونه .br abuf (uint، پیش‌فرض: 100): مدت‌زمان بافر خروجی صوتی بر حسب میلی‌ثانیه - رندرکننده صوتی PID خروجی را تا این مقدار پر می‌کند. مقدار بیش از حد کم تأخیر را کاهش می‌دهد اما ممکن است مشکلاتی در پخش بی‌درنگ (real-time) داشته باشد .br avol (uint، پیش‌فرض: 100، قابل به‌روزرسانی): بلندی صدا به درصد .br apan (uint، پیش‌فرض: 50، قابل به‌روزرسانی): تراز صدای صوتی (pan) به درصد، ۵۰ به معنای بدون تراز است .br async (bool، پیش‌فرض: true، قابل به‌روزرسانی): همگام‌سازی مجدد صوت؛ در صورت غیرفعال بودن، داده‌های صوتی هرگز حذف نمی‌شوند اما ممکن است از همگام‌سازی خارج گردند .br max_aspeed (dbl، پیش‌فرض: 2.0، قابل به‌روزرسانی): بی‌صدا کردن صوت در صورتی که سرعت پخش از مقدار تعیین‌شده بیشتر باشد .br max_vspeed (dbl، پیش‌فرض: 4.0، قابل به‌روزرسانی): جابجایی به رمزگشایی صرفاً فریم‌های I در صورتی که سرعت پخش از مقدار تعیین‌شده بیشتر باشد .br buffer (uint، پیش‌فرض: 3000، قابل به‌روزرسانی): بافر پخش بر حسب میلی‌ثانیه (توسط ویژگی BufferLength در PID ورودی بازنویسی می‌شود) .br rbuffer (uint، پیش‌فرض: 1000، قابل به‌روزرسانی): راه‌انداز بافر مجدد بر حسب میلی‌ثانیه (توسط ویژگی RebufferLength در PID ورودی بازنویسی می‌شود) .br mbuffer (uint، پیش‌فرض: 3000، قابل به‌روزرسانی): حداکثر بافر بر حسب میلی‌ثانیه، باید بیشتر از بافر پخش باشد (توسط ویژگی BufferMaxOccupancy در PID ورودی بازنویسی می‌شود) .br ntpsync (uint، پیش‌فرض: 0، قابل به‌روزرسانی): آستانه همگام‌سازی مجدد NTP بر حسب میلی‌ثانیه (فریم‌ها را در صورتی که NTP آن‌ها بیش از آستانه تعیین‌شده بالاتر از NTP محلی باشد حذف می‌کند)، ۰ حذف بر اساس NTP را غیرفعال می‌سازد .br nojs (bool، پیش‌فرض: false): غیرفعال‌سازی javascript .br noback (bool، پیش‌فرض: false): نادیده گرفتن گره‌های پس‌زمینه و پر کردن درگاه نمایش (viewport) (هنگام ذخیره در PNG مفید است) .br ogl (enum، پیش‌فرض: auto، قابل به‌روزرسانی): تعیین حالت رندر 2D .br * auto: بر اساس محتوا به طور خودکار بین on، off و hybrid تصمیم می‌گیرد .br * off: OpenGL را غیرفعال می‌کند؛ محتوای 3D رندر نخواهد شد .br * on: استفاده از OpenGL برای همه گرافیک‌ها؛ این کار شامل موزاییک‌کاری چندضلعی‌ها (polygon tesselation) خواهد بود و گرافیک‌های 2D به زیبایی حالت 2D به نظر نخواهند رسید .br * hybrid: ترکیب‌کننده، رسم نرم‌افزاری گرافیک‌های 2D بدون بافت را انجام می‌دهد (کیفیت بهتر) و از OpenGL برای همه اشیاء 2D دارای بافت و اشیاء 3D استفاده می‌کند .br .br pbo (bool، پیش‌فرض: false، قابل به‌روزرسانی): فعال‌سازی PixelBufferObjects برای ارسال بافت‌های YUV به GPU در حالت OpenGL. این کار ممکن است کارایی پخش را اندکی بهبود بخشد .br nav (enum، پیش‌فرض: none، قابل به‌روزرسانی): بازنویسی حالت ناوبری پیش‌فرض در MPEG-4/VRML (Walk) و X3D (Examine) .br * none: ناوبری را غیرفعال می‌کند .br * walk: راه رفتن در دنیای سه‌بعدی .br * fly: پرواز در دنیای سه‌بعدی (بدون تشخیص سطح زمین) .br * pan: بزرگ‌نمایی/پیمایش (zoom/pan) در دنیای 2D/3D .br * game: حالت بازی در دنیای سه‌بعدی (ماوس جهت راه رفتن را تعیین می‌کند) .br * slide: لغزش در دنیای 2D/3D .br * exam: بررسی شیء 2D/3D .br * orbit: چرخش مداری به دور شیء 3D .br * vr: واقعیت مجازی در دنیای سه‌بعدی (yaw/pitch/roll) .br .br linegl (bool، پیش‌فرض: false، قابل به‌روزرسانی): مشخص می‌کند که خط‌کشی پیرامونی به جای خط‌کشی برداری باید از طریق پهنای قلم OpenGL انجام گیرد .br epow2 (bool، پیش‌فرض: true، قابل به‌روزرسانی): شبیه‌سازی بافت‌های با ابعاد توان دو برای OpenGL (سخت‌افزارهای قدیمی). در صورت فعال بودن افزونه بافت مستطیلی OpenGL نادیده گرفته می‌شود .br * true: اندازه بافت ویدیو تغییر نمی‌کند اما با فاصله‌گذاری (padding) شبیه‌سازی می‌شود. این کار معمولاً نگاشت ویدیو روی اشکال را تسریع می‌کند اما تبدیلات بافت را غیرفعال می‌سازد .br * false: هنگام نگاشت روی یک شکل، اندازه ویدیو به بافتی با بعد توان ۲ تغییر می‌یابد .br .br paa (bool، پیش‌فرض: false، قابل به‌روزرسانی): مشخص می‌کند که آیا ضدپلگی چندضلعی باید در حالت ضدپلگی کامل استفاده شود یا خیر. در صورت عدم تنظیم، تنها ضدپلگی خطوط و نقاط به کار می‌رود .br bcull (enum، پیش‌فرض: on، قابل به‌روزرسانی): مشخص می‌کند که آیا حذف سطوح پشتی (backface culling) باید غیرفعال شود یا خیر .br * on: حذف سطوح پشتی را فعال می‌کند .br * off: حذف سطوح پشتی را غیرفعال می‌کند .br * alpha: تنها حذف سطوح پشتی را برای مش‌های شفاف فعال می‌سازد .br .br wire (enum، پیش‌فرض: none، قابل به‌روزرسانی): حالت اسکلت‌سیمی (wireframe) .br * none: اشیاء به صورت توپر کشیده می‌شوند .br * only: اشیاء تنها به صورت اسکلت‌سیمی کشیده می‌شوند .br * solid: اشیاء ابتدا به صورت توپر کشیده شده و سپس اسکلت‌سیمی رسم می‌شود .br .br norms (enum، پیش‌فرض: none، قابل به‌روزرسانی): رسم بردار عمود (نرمال) برای اشکال‌زدایی .br * none: هیچ بردار نرمالی رسم نمی‌شود .br * face: یک بردار نرمال به ازای هر وجه رسم می‌شود .br * vertex: یک بردار نرمال به ازای هر رأس رسم می‌شود .br .br rext (bool، پیش‌فرض: true، قابل به‌روزرسانی): استفاده از افزونه GL بافت‌های غیر توان دو (مستطیلی) .br cull (bool، پیش‌فرض: true، قابل به‌روزرسانی): استفاده از جداسازی aabb: اشیاء بزرگ در صورتی که کاملاً درون درگاه نمایش نباشند، در چند فراخوانی رندر می‌شوند .br depth_gl_scale (flt، پیش‌فرض: 100، قابل به‌روزرسانی): تعیین مقیاس‌بند عمق .br depth_gl_type (enum، پیش‌فرض: none، قابل به‌روزرسانی): تعیین نوع هندسه مورد استفاده برای رسم ویدیوی عمق .br * none: بدون تبدیل هندسی .br * point: محاسبه ابر نقاط از پیکسل+عمق .br * strip: مشابه point اما مجموعه نقاط را خلوت‌تر می‌کند .br .br nbviews (uint، پیش‌فرض: 0، قابل به‌روزرسانی): تعداد نماها برای استفاده در حالت برجسته‌بینی (stereo) .br stereo (enum، پیش‌فرض: none، قابل به‌روزرسانی): نوع خروجی استریو (برجسته‌بین). اگر کارت گرافیک شما از شیدرهای OpenGL پشتیبانی نکند، تنها حالت‌های top و side در دسترس خواهند بود .br * none: بدون استریو .br * side: تصاویر در کنار هم از چپ به راست نمایش داده می‌شوند .br * top: تصاویر از بالا (نمای چپ) تا پایین (نمای راست) نمایش داده می‌شوند .br * hmd: مشابه side، جز اینکه نسبت تصویر نما تغییر نمی‌کند .br * ana: از آناگلیف رنگی استاندارد (قرمز برای نمای چپ، سبز و آبی برای نمای راست) استفاده می‌شود (اجبار views=2) .br * cols: تصاویر بر اساس ستون‌ها در هم آمیخته می‌شوند؛ نمای چپ در ستون‌های زوج و نمای راست در ستون‌های فرد (اجبار views=2) .br * rows: تصاویر بر اساس سطرها در هم آمیخته می‌شوند؛ نمای چپ در سطرهای زوج و نمای راست در سطرهای فرد (اجبار views=2) .br * spv5: تصاویر برای نمایشگر ۵ نمایی SpatialView در حالت تمام‌صفحه در هم آمیخته می‌شوند (اجبار views=5) .br * alio8: تصاویر برای نمایشگرهای ۸ نمایی Alioscopy در حالت تمام‌صفحه در هم آمیخته می‌شوند (اجبار views=8) .br * custom: تصاویر بر اساس فایل شیدر مشخص‌شده در .I mvshader در هم آمیخته می‌شوند. شیدر هر نما را به عنوان uniform sampler2D gfViewX در معرض دسترسی قرار می‌دهد، که در آن X شماره نما از سمت چپ است .br .br mvshader (str، قابل به‌روزرسانی): مسیر فایل به شیدر سفارشی درهم‌آمیزی چندنمایی .br fpack (enum، پیش‌فرض: none، قابل به‌روزرسانی): بسته‌بندی فریم پیش‌فرض ویدیوی ورودی .br * none: بدون بسته‌بندی فریم .br * top: بسته‌بندی فریم بالا و پایین .br * side: بسته‌بندی در کنار هم .br .br camlay (enum، پیش‌فرض: offaxis، قابل به‌روزرسانی): چینش دوربین در حالت‌های چندنمایی .br * straight: دوربین در امتداد یک خط مستقیم و بدون چرخش حرکت می‌کند .br * offaxis: از پروجکشن خارج از محور (off-axis) استفاده می‌شود .br * linear: دوربین در امتداد یک خط مستقیم همراه با چرخش حرکت می‌کند .br * circular: دوربین در امتداد یک دایره همراه با چرخش حرکت می‌کند .br .br iod (flt، پیش‌فرض: 6.4، قابل به‌روزرسانی): فاصله میان‌چشمی (فاصله بین چشم‌ها) بر حسب سانتی‌متر (فاصله بین دوربین‌ها). .br rview (bool، پیش‌فرض: false، قابل به‌روزرسانی): معکوس کردن ترتیب نماها .br dbgpack (bool، پیش‌فرض: false، قابل به‌روزرسانی): مشاهده ویدیوی استریوی بسته‌بندی‌شده به صورت یک تصویر منفرد (نمایش همه) .br tvtn (uint، پیش‌فرض: 30، قابل به‌روزرسانی): تعداد نمونه‌برداری نقطه برای الگوریتم دیدپذیری کاشی‌ها .br tvtt (uint، پیش‌فرض: 8، قابل به‌روزرسانی): تعداد نقاطی که اگر بالاتر از آن باشد، کاشی دیدپذیر در نظر گرفته می‌شود .br tvtd (enum، پیش‌فرض: off، قابل به‌روزرسانی): اشکال‌زدایی کاشی‌ها و SRD پوشش کامل .br * off: رسم عادی .br * partial: فقط کاشی‌های جزئی نمایش داده می‌شوند، نه ویدیوی کروی کامل .br * full: فقط نمایش ویدیوی کروی کامل .br .br tvtf (bool، پیش‌فرض: false، قابل به‌روزرسانی): اجبار به دیدپذیر تلقی شدن تمام کاشی‌ها، صرف‌نظر از دیدگاه (viewpoint) .br fov (flt، پیش‌فرض: 1.570796326794897، قابل به‌روزرسانی): میدان دید پیش‌فرض برای VR .br vertshader (str): مسیر فایل شیدر رأس (vertex shader) .br fragshader (str): مسیر فایل شیدر قطعه (fragment shader) .br autocal (bool، پیش‌فرض: false، قابل به‌روزرسانی): کالیبراسیون خودکار znear/zfar در حالت رندر عمق .br dispdepth (sint، پیش‌فرض: -1، قابل به‌روزرسانی): عمق نمایش، مقدار منفی از ارتفاع پیش‌فرض صفحه استفاده می‌کند .br dispdist (flt، پیش‌فرض: 50، قابل به‌روزرسانی): فاصله بر حسب سانتی‌متر بین دوربین و صفحه با عدم‌انطباق صفر (zero-disparity plane). در حال حاضر هیچ کالیبراسیون خودکاری برای عمق در GPAC وجود ندارد .br focdist (flt، پیش‌فرض: 0، قابل به‌روزرسانی): فاصله نقطه کانونی .br osize (v2di، پیش‌فرض: 0x0، قابل به‌روزرسانی): اجبار اندازه خروجی. در صورت عدم تنظیم، اندازه از ورودی‌ها به دست می‌آید .br dpi (v2di، پیش‌فرض: 96x96، قابل به‌روزرسانی): مقدار dpi پیش‌فرض در صورتی که توسط خروجی ویدیو مشخص نشده باشد .br dbgpvr (flt، پیش‌فرض: 0، قابل به‌روزرسانی): صحنه اشکال‌زدایی مورد استفاده توسط افزونه PVR .br player (enum، پیش‌فرض: no): قرار دادن ترکیب‌کننده در حالت پخش‌کننده (player) .br * no: حالت عادی .br * base: حالت پخش‌کننده .br * gui: حالت پخش‌کننده با شروع خودکار رابط گرافیکی (GUI) .br .br noaudio (bool، پیش‌فرض: false): غیرفعال‌سازی خروجی صوتی .br opfmt (pfmt، پیش‌فرض: none، Enum: none|yuv420|yvu420|yuv420_10|yuv422|yuv422_10|yuv444|yuv444_10|uyvy|vyuy|yuyv|yvyu|uyvl|vyul|yuyl|yvyl|nv12|nv21|nv1l|nv2l|yuva|yuvd|yuv444a|yuv444p|v308|yuv444ap|v408|v410|v210|grey|algr|gral|rgb8|rgb4|rgb5|rgb6|rgba|argb|bgra|abgr|rgb|bgr|xrgb|rgbx|xbgr|bgrx|rgbd|rgbds|uncv): قالب پیکسلی مورد استفاده برای خروجی. در حالت .I player نادیده گرفته می‌شود .br .br drv (enum، پیش‌فرض: auto): مشخص می‌کند که آیا درایور گرافیک باید استفاده شود یا خیر .br * no: هرگز درایور گرافیک بارگذاری نمی‌شود، از blit نرم‌افزاری استفاده می‌شود، 3D ممکن نیست (در حالت پخش‌کننده، OpenGL را غیرفعال می‌کند) .br * yes: همواره درایور گرافیک بارگذاری می‌شود، قالب پیکسلی خروجی RGB خواهد بود (در حالت پخش‌کننده، مشابه auto) .br * auto: بر اساس محتوای بارگذاری‌شده تصمیم می‌گیرد .br .br src (cstr): نشانی (URL) محتوای منبع .br gaze_x (sint، پیش‌فرض: 0، قابل به‌روزرسانی): مختصات افقی نگاه (0=چپ، width=راست) .br gaze_y (sint، پیش‌فرض: 0، قابل به‌روزرسانی): مختصات عمودی نگاه (0=بالا، height=پایین) .br gazer_enabled (bool، پیش‌فرض: false، قابل به‌روزرسانی): فعال‌سازی ارسال رویدادهای نگاه .br subtx (sint، پیش‌فرض: 0، قابل به‌روزرسانی): انتقال افقی بر حسب پیکسل به سمت راست برای رندرکننده‌های زیرنویس .br subty (sint، پیش‌فرض: 0، قابل به‌روزرسانی): انتقال عمودی بر حسب پیکسل به سمت بالا برای رندرکننده‌های زیرنویس .br subfs (uint، پیش‌فرض: 0، قابل به‌روزرسانی): اندازه قلم برای رندرکننده‌های زیرنویس (۰ به معنای خودکار است) .br subd (sint، پیش‌فرض: 0، قابل به‌روزرسانی): تاخیر زیرنویس بر حسب میلی‌ثانیه برای رندرکننده‌های زیرنویس .br audd (sint، پیش‌فرض: 0، قابل به‌روزرسانی): تاخیر صدا بر حسب میلی‌ثانیه .br clipframe (bool، پیش‌فرض: false): خروجی دیداری به مستطیل محصورکننده برش می‌خورد .br .br.SH mp4dmx .LP .br توضیحات: تفکیک‌کننده (demultiplexer) برای ISOBMFF/QT .br .br این فیلتر فایل‌های ISOBMF و QT را دیمولتی‌پلکس می‌کند. .br ورودی ISOBMFF/QT می‌تواند عادی یا تکه‌تکه (fragmented) بوده و به صورت فایل یا به عنوان جریان بایت خام (raw bytestream) در دسترس باشد. .br .SH "انتخاب ترک (Track Selection)" .LP .br فیلتر می‌تواند از شناسه‌های قطعه (fragment identifiers) منبع برای انتخاب یک ترک واحد جهت پخش استفاده کند. قطعه‌های مجاز عبارتند از: .br * #audio: فقط از نخستین ترک صوتی استفاده می‌کند .br * #video: فقط از نخستین ترک ویدیویی استفاده می‌کند .br * #auxv: فقط از نخستین ترک ویدیویی کمکی (auxiliary) استفاده می‌کند .br * #pict: فقط از نخستین ترک تصویر استفاده می‌کند .br * #text: فقط از نخستین ترک متنی استفاده می‌کند .br * #trackID=VAL: فقط از ترک با شناسه (ID) داده‌شده استفاده می‌کند .br * #itemID=VAL: فقط از آیتم با شناسه داده‌شده استفاده می‌کند .br * #ID=VAL: فقط از ترک/آیتم با شناسه داده‌شده استفاده می‌کند .br * #VAL: فقط از ترک/آیتم با شناسه داده‌شده استفاده می‌کند .br .br .SH "ترک‌های مقیاس‌پذیر (Scalable Tracks)" .LP .br هنگامی که ترک‌های مقیاس‌پذیر در یک فایل وجود دارند، خواننده می‌تواند با استفاده از گزینه .I smode در ۳ حالت عمل کند: .br * smode=single: تمام استخراج‌کننده‌ها (extractors) را برای استخراج یک جریان بیتی واحد از یک مجموعه مقیاس‌پذیر حل می‌کند. بالاترین سطح استفاده می‌شود .br در این حالت، هیچ پیکربندی رمزگشای بهبوددهنده‌ای وجود ندارد، بلکه تنها یک پیکربندی پایه حاصل از ادغام پیکربندی‌های لایه‌ها وجود دارد .br * smode=split: تمام استخراج‌کننده‌ها حذف شده و تمام ترک‌های مجموعه مقیاس‌پذیر اعلان می‌شوند. در این حالت، هر ترک بهبوددهنده فاقد پیکربندی رمزگشای پایه .br و دارای یک پیکربندی رمزگشای بهبوددهنده است. .br * smode=splitx: استخراج‌کننده‌ها در جریان بیتی نگه داشته می‌شوند و تمام ترک‌های مجموعه مقیاس‌پذیر اعلان می‌شوند. در این حالت، هر ترک بهبوددهنده دارای یک پیکربندی رمزگشای پایه .br (کپی‌شده از پایه) و یک پیکربندی رمزگشای بهبوددهنده است. این حالت بیشتر برای تولید محتوای DASH استفاده می‌شود. .br هشدار: smode=splitx منجر به باقی ماندن واحدهای NAL استخراج‌کننده در جریان بیتی خروجی می‌شود، که این تنها در صورتی مجاز است که خروجی مبتنی بر ISOBMFF باشد .br .br .SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br src (cstr): نام فایل محلی محتوای منبع (تنها هنگام بارگذاری صریح فیلتر استفاده می‌شود) .br allt (bool, default: false): بارگذاری تمام ترک‌ها حتی در صورت ناشناخته بودن نوع رسانه .br edits (enum, default: auto): عدم استفاده از edit listها (فهرست‌های ویرایش) .br * auto: تأخیر ترک و در صورت امکان عدم استفاده از edit list .br * no: نادیده گرفتن edit list .br * strict: استفاده از edit list حتی اگر تنها نشان‌دهنده یک تأخیر باشد .br .br itt (bool, default: false): تبدیل تمام آیتم‌های root meta به یک PID واحد .br itemid (bool, default: true): حفظ شناسه‌های آیتم در مشخصه‌های PID .br smode (enum, default: split): حالت بارگذاری برای ترک‌های مقیاس‌پذیر/کاشی (scalable/tile) .br * split: هر ترک اعلان می‌شود، استخراج‌کننده‌ها حذف می‌شوند .br * splitx: هر ترک اعلان می‌شود، استخراج‌کننده‌ها حفظ می‌شوند .br * single: یک ترک واحد اعلان می‌شود (بالاترین سطح برای مقیاس‌پذیر، پایه کاشی برای کاشی‌کاری) .br .br alltk (bool, default: false): اعلان ترک‌های غیرفعال‌شده .br frame_size (uint, default: 1024): اندازه فریم برای نمونه‌های صوتی خام (ارسال frame_size نمونه در هر بسته) .br expart (bool, default: false): نمایش تصویر روی جلد (cover art) به عنوان یک PID ویدیویی اختصاصی .br sigfrag (bool, default: false): مشخص کردن مرزهای قطعه (fragment) و سگمنت منبع روی بسته‌های خروجی؛ در صورت تکه‌تکه نبودن منبع با شکست مواجه می‌شود .br tkid (str): اعلان تنها ترک بر اساس پارامتر داده‌شده .br * integer value: ترک با شناسه داده‌شده را اعلان می‌کند .br * audio: نخستین ترک صوتی را اعلان می‌کند .br * video: نخستین ترک ویدیویی را اعلان می‌کند .br * 4CC: نخستین ترک با 4CC منطبق برای نوع گرداننده (handler type) را اعلان می‌کند .br .br stsd (uint, default: 0): تنها نمونه‌های نگاشت‌شده به نمایه توصیف نمونه (sample description index) داده‌شده را استخراج می‌کند (۰ به معنای استخراج همه است) .br nocrypt (bool): اعلام ترک‌های رمزنگاری‌شده به عنوان رمزنگاری‌نشده (بیشتر برای صادرات/export استفاده می‌شود) .br mstore_size (uint, default: 10000000): اندازه بافر هدف بر حسب بایت هنگام خواندن از جریان حافظه (pipe و غیره) .br mstore_purge (uint, default: 50000): حداقل اندازه بر حسب بایت میان پاکسازی‌های حافظه هنگام خواندن از جریان حافظه؛ ۰ به معنای پاکسازی در سریع‌ترین زمان ممکن است .br mstore_samples (uint, default: 50): حداقل تعداد نمونه‌های موجود پیش از پاکسازی جدول‌های نمونه هنگام خواندن از جریان حافظه (pipe و غیره)؛ ۰ به معنای پاکسازی در سریع‌ترین زمان ممکن است .br strtxt (bool, default: false): بارگذاری ترک‌های متنی (apple/tx3g) به عنوان ترک‌های متنی جریانی MPEG-4 .br xps_check (enum, default: auto): حالت استخراج مجموعه‌های پارامتر (parameter sets) از نمونه‌های AVC/HEVC/VVC .br * keep: عدم بررسی نمونه (هنگام تولید DASH/HLS/CMAF فرض را بر سازگار بودن فایل ورودی می‌گذارد) .br * rem: حذف تمام xPSهای درون‌باندی (inband) و اطلاع‌رسانی تغییرات پیکربندی بر این اساس .br * auto: برای smode=splitx (حالت dasher) روی keep و در غیر این صورت روی rem تنظیم می‌شود .br .br nodata (enum, default: no): کنترل بارگذاری داده‌های نمونه .br * no: بارگذاری عادی .br * yes: صرف‌نظر از بارگذاری داده‌ها .br * fake: تخصیص نمونه بدون کپی داده‌ها .br .br lightp (bool, default: false): بارگذاری حداقل مجموعه‌ای از مشخصه‌ها .br initseg (str): نام قطعه مقداردهی اولیه (init segment) محلی هنگامی که ورودی یک تک‌سگمنت ISOBMFF است .br extk (bool, default: true): اجازه بارگذاری ترک خارجی .br ctso (sint): مقداری که باید به افست CTS برای ترک‌هایی با ctts منفی اضافه شود .br - تنظیم روی -1 برای استفاده از اطلاعات جعبه cslg یا حداقل افست cts موجود در ترک .br - تنظیم روی -2 برای استفاده از حداقل افست cts موجود در ترک (cslg نادیده گرفته می‌شود) .br .br norw (bool, default: false): صرف‌نظر از قالب‌بندی مجدد نمونه‌ها - فقط هنگام بازنویسی قطعه‌ها (fragments) باید استفاده شود .br keepc (bool, default: true): نگه‌داشتن نمونه‌های خراب (تنها برای منابع چندپخشی/multicast) .br sigfo (bool, default: false): مشخص کردن مرزهای سگمنت روی بسته‌های خروجی برای منابع DASH یا HLS (مشابه sigfrag اما مستقل از گزینه‌های dasher) .br drefu (str): جایگزینی نشانی اینترنتی (URL) جعبه dref در فایل منبع با مقدار داده‌شده .br .br.SH bifsdec .LP .br توضیحات: رمزگشای MPEG-4 BIFS .br .br این فیلتر فریم‌های دودویی MPEG-4 BIFS را مستقیماً در گراف صحنه (scene graph) ترکیب‌کننده (compositor) رمزگشایی می‌کند. .br نکته: از این فیلتر نمی‌توان برای استخراج محتوای BIFS به متن یا xml استفاده کرد؛ برای این منظور از MP4Box استفاده کنید. .br .br بدون گزینه .br .br .SH odfdec .LP .br توضیحات: رمزگشای MPEG-4 OD .br .br این فیلتر فریم‌های دودویی MPEG-4 OD را مستقیماً در مدیر صحنه (scene manager) ترکیب‌کننده (compositor) رمزگشایی می‌کند. .br نکته: از این فیلتر نمی‌توان برای استخراج محتوای OD به متن یا xml استفاده کرد؛ برای این منظور از MP4Box استفاده کنید. .br .br بدون گزینه .br .br .SH fin .LP .br توضیحات: ورودی فایل .br .br این فیلتر بلوک‌های خام را از فایل ورودی به درون یک زنجیره فیلتر توزیع می‌کند. .br اندازه بلوک با استفاده از .I block_size قابل تنظیم است. .br قالب محتوا می‌تواند از طریق .I mime اجباری شود و پسوند فایل می‌تواند از طریق .I ext تغییر یابد. .br نکته: مگر اینکه در سطح نشست غیرفعال شده باشد (به .I \-no\-probe مراجعه کنید)، پسوندهای فایل معمولاً نادیده گرفته می‌شوند و کاوش قالب روی اولین بلوک داده انجام می‌گیرد. .br نام فایل ویژه null برای ایجاد فایلی بدون داده استفاده می‌شود، که توسط برخی فیلترها مانند dasher مورد نیاز است. .br نام فایل ویژه rand برای تولید داده‌های تصادفی به کار می‌رود. .br نام فایل ویژه randsc برای تولید داده‌های تصادفی با پیشوند کد آغازین 0x000001 استفاده می‌شود. .br .br این فیلتر هم از فایل‌ها و هم از اشیاء GF_FileIO به عنوان URL ورودی پشتیبانی می‌کند. .br .br .SS "تزریق بسته (Packet Injecting)" .br این فیلتر می‌تواند برای تزریق یک بسته منفرد به جای یک فایل با استفاده از گزینه .I pck استفاده شود. .br هیچ ویژگی خاصی ضمیمه نمی‌شود، مگر یک مقیاس زمانی (timescale) در صورتی که .I ptime تنظیم شده باشد. .br مثال .br gpac fin:pck=str@"My Sample Text":ptime=2500/100:#CodecID=stxt:#StreamType=text .br .br این دستور PID را به عنوان WebVTT اعلام کرده و یک بسته منفرد با بار داده (payload) «My Sample Text» و مقدار برچسب زمانی (timestamp) ۲۵ ثانیه ارسال می‌کند. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT))" .LP .br src (cstr): مکان فایل منبع .br block_size (uint, default: 0): اندازه بلوک مورد استفاده برای خواندن فایل. 0 به معنای 5000 در صورت کمتر بودن فایل از 500m است، و در غیر این صورت 1M .br range (lfrac, default: 0-0): محدوده بایتی .br ext (cstr): بازنویسی و نادیده‌گرفتن پسوند فایل .br mime (cstr): تنظیم نوع mime فایل .br pck (mem): داده برای استفاده به جای فایل .br ptime (frac, default: 0/0): زمان‌بندی برای بسته داده؛ اگر den برابر 0 باشد نادیده گرفته می‌شود .br .br .SH btplay .LP .br توضیحات: رمزگشای BT/XMT/X3D .br .br این فیلتر فایل‌های MPEG-4 BIFS (شامل BT و XMT)، VRML97 و X3D (شامل wrl و XML) را مستقیماً در گراف صحنه ترکیب‌کننده تجزیه می‌کند. .br .br هنگامی که .I sax_dur روی N تنظیم شده باشد، فیلتر بارگیری تدریجی منبع را انجام می‌دهد و در صورتی که زمان پردازش بیشتر از N باشد، بارگیری فعلی را لغو می‌کند. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT))" .LP .br sax_dur (uint, default: 0): مدت زمان برای تجزیه SAX (در XMT)؛ مقدار 0 تجزیه SAX را غیرفعال می‌کند .br .br .SH httpin .LP .br توضیحات: ورودی HTTP .br .br این فیلتر بلوک‌های خام را از یک منبع دوردست HTTP به درون یک زنجیره فیلتر توزیع می‌کند. .br اندازه بلوک با استفاده از .I block_size قابل تنظیم است و همچنین سیاست‌های ذخیره‌سازی موقت (caching) دیسک می‌توانند تنظیم شوند. .br قالب محتوا می‌تواند از طریق .I mime اجباری شود و پسوند فایل می‌تواند از طریق .I ext تغییر یابد. .br .br این فیلتر از هر دو طرحواره http و https پشتیبانی می‌کند و در صورت شکست اتصال TCP، تلاش می‌کند تا مجدداً به عنوان TLS متصل شود. .br .br نکته: مگر اینکه در سطح نشست غیرفعال شده باشد (به .I \-no\-probe مراجعه کنید)، پسوندهای فایل معمولاً نادیده گرفته می‌شوند و کاوش قالب روی اولین بلوک داده انجام می‌گیرد. .br .br.SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br src (cstr): نشانی (URL) محتوای منبع .br block_size (uint, default: 100000): اندازه بلوک مورد استفاده برای خواندن فایل .br cache (enum, default: none): تنظیم حالت حافظه موقت (کَش) .br * auto: ذخیره موقت روی دیسک در صورت مشخص بودن طول محتوا، در غیر این صورت بدون کَش .br * disk: ذخیره موقت روی دیسک، حذف پس از پایان استفاده از نشست .br * keep: ذخیره موقت روی دیسک و نگه‌داری آن .br * mem: ذخیره در حافظه، حذف پس از پایان استفاده از نشست .br * mem_keep: ذخیره در حافظه، نگه‌داری پس از تخصیص مجدد نشست اما انتقال به mem پس از اولین بارگیری .br * none: بدون کَش .br * none_keep: ذخیره در حافظه، نگه‌داری پس از تخصیص مجدد نشست اما انتقال به none پس از اولین بارگیری .br .br range (lfrac, default: 0-0): تنظیم محدوده بایتی، به‌صورت کسر .br ext (cstr): جایگزینی پسوند فایل .br mime (cstr): تنظیم نوع mime فایل .br blockio (bool, default: false): استفاده از ورودی/خروجی مسدودکننده (blocking IO) .br idelay (uint, default: 0): به تأخیر انداختن اولین درخواست به میزان میلی‌ثانیه داده‌شده .br .br .SH svgplay .LP .br توضیحات: رمزگشای SVG .br .br این فیلتر فایل‌های SVG را مستقیماً در نمودار صحنه صفحه‌بند (compositor) تجزیه می‌کند. .br .br هنگامی که .I sax_dur بر روی N تنظیم شود، فیلتر بارگیری تدریجی منبع را انجام می‌دهد و در صورتی که زمان پردازش بیشتر از N باشد، بارگیری فعلی را لغو می‌کند. .br .br .SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br sax_dur (uint, default: 0): مدت‌زمان بارگیری برای تجزیه SAX، مقدار 0 تجزیه SAX را غیرفعال می‌کند .br .br .SH rfimg .LP .br توضیحات: بازقاب‌بند (reframer) پرونده‌های JPG/J2K/PNG/BMP .br .br این فیلتر فایل‌ها/داده‌های JPG/J2K/PNG/BMP را تجزیه کرده و PID تصویری و فریم‌های متناظر را در خروجی تولید می‌کند. .br .br پسوندهای زیر برای PNG قالب پیکسلی را برای تصاویر RGBA تغییر می‌دهند: .br * pngd: استفاده از قالب پیکسلی RGB+depth map .br * pngds: استفاده از قالب پیکسلی RGB+depth(7bits)+shape(MSB of alpha channel) .br .br بدون گزینه .br .br .SH imgdec .LP .br توضیحات: رمزگشای PNG/JPG .br .br این فیلتر تصاویر JPEG و PNG را رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH rfadts .LP .br توضیحات: بازقاب‌بند (reframer) ADTS .br .br این فیلتر فایل‌ها/داده‌های AAC را تجزیه کرده و PID صوتی و فریم‌های متناظر را در خروجی تولید می‌کند. .br .br .SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br frame_size (uint, default: 1024): اندازه فریم AAC بر حسب نمونه‌های صوتی .br index (dbl, default: 1.0): طول پنجره نمایه‌گذاری .br ovsbr (bool, default: false): اجبار به بیش‌نمونه‌برداری SBR (مقیاس‌های زمانی را در ۲ ضرب نمی‌کند) .br sbr (enum, default: no): تنظیم سیگنال‌دهی SBR .br * no: بدون هیچ‌گونه سیگنال‌دهی SBR .br * imp: سیگنال‌دهی SBR سازگار با گذشته (صدا به‌صورت AAC-LC اعلام می‌شود) .br * exp: سیگنال‌دهی صریح SBR (صدا به‌صورت AAC-SBR اعلام می‌شود) .br .br ps (enum, default: no): تنظیم سیگنال‌دهی PS .br * no: بدون هیچ‌گونه سیگنال‌دهی PS .br * imp: سیگنال‌دهی PS سازگار با گذشته (صدا به‌صورت AAC-LC اعلام می‌شود) .br * exp: سیگنال‌دهی صریح PS (صدا به‌صورت AAC-PS اعلام می‌شود) .br .br expart (bool, default: false): ارائه تصاویر به‌صورت یک PID ویدیویی اختصاصی .br aacchcfg (sint, default: 0): تنظیم پیکربندی کانال AAC به این مقدار در صورت مفقود بودن در سرایند ADTS؛ از مقدار منفی برای جایگزینی همیشگی استفاده کنید .br .br.SH rflatm .LP .br توضیحات: بازفریم‌ساز LATM .br .br این فیلتر AAC را در فایل‌ها/داده‌های LATM تجزیه کرده و PID و فریم‌های صوتی متناظر را در خروجی ارائه می‌دهد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (expert)):" .LP .br frame_size (uint, default: 1024): اندازه فریم AAC بر حسب نمونه‌های صوتی .br index (dbl, default: 1.0): طول پنجره نمایه‌سازی .br .br .SH rfmp3 .LP .br توضیحات: بازفریم‌ساز MP3 .br .br این فیلتر فایل‌ها/داده‌های صوتی MPEG-1/2 را تجزیه کرده و PID و فریم‌های صوتی متناظر را در خروجی ارائه می‌دهد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (expert)):" .LP .br index (dbl, default: 1.0): طول پنجره نمایه‌سازی .br expart (bool, default: false): ارائه تصاویر به عنوان یک PID ویدیویی اختصاصی .br forcemp3 (bool, default: true): اجبار سیگنال‌دهی mp3 برای MPEG-2 Audio layer 3 .br .br .SH faad .LP .br توضیحات: رمزگشای FAAD .br .br این فیلتر جریان‌های AAC را از طریق کتابخانه faad رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH maddec .LP .br توضیحات: رمزگشای MAD .br .br این فیلتر جریان‌های صوتی MPEG 1/2 را از طریق کتابخانه libmad رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH j2kdec .LP .br توضیحات: رمزگشای OpenJPEG2000 .br نسخه: 2.x .br .br این فیلتر جریان‌های JPEG2000 را از طریق کتابخانه OpenJPEG2000 رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH rfac3 .LP .br توضیحات: بازفریم‌ساز AC3 .br .br این فیلتر فایل‌ها/داده‌های AC3 و E-AC3 را تجزیه کرده و PID و فریم‌های صوتی متناظر را در خروجی ارائه می‌دهد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (expert)):" .LP .br index (dbl, default: 1.0): طول پنجره نمایه‌سازی .br .br .SH rfac4 .LP .br توضیحات: بازفریم‌ساز AC4 .br .br این فیلتر فایل‌ها/داده‌های AC4 را تجزیه کرده و PID و فریم‌های صوتی متناظر را در خروجی ارائه می‌دهد. .br .br بدون گزینه .br .br.SH ufac4 .LP .br توضیحات: نویسندهٔ AC4 .br .br این فیلتر جریان‌های MPEG-H Audio را به داده‌های کپسوله‌شدهٔ AC4 تبدیل می‌کند. .br .br .SH "گزینه‌های تخصصی (OPTIONS (EXPERT))" .LP .br rcfg (bool، پیش‌فرض: true): اجبار به تکرار پیکربندی رمزگشا در هر I-frame .br .br .SH rfamr .LP .br توضیحات: بازفریم‌بند AMR/EVRC .br .br این فیلتر فایل‌ها/داده‌های AMR، AMR Wideband، EVRC و SMV را تجزیه کرده و فریم‌ها و PID صوتی متناظر را در خروجی تولید می‌کند. .br .br .SH "گزینه‌های تخصصی (OPTIONS (EXPERT))" .LP .br index (dbl، پیش‌فرض: 1.0): طول پنجرهٔ نمایه‌سازی .br .br .SH oggdmx .LP .br توضیحات: تفکیک‌کنندهٔ OGG .br .br این فیلتر فایل‌ها/داده‌های OGG را به مجموعه‌ای از فریم‌ها و PIDهای رسانه‌ای تفکیک می‌کند. .br .br .SH "گزینه‌های تخصصی (OPTIONS (EXPERT))" .LP .br index (dbl، پیش‌فرض: 1.0): طول پنجرهٔ نمایه‌سازی (پیاده‌سازی نشده است؛ برای غیرفعال کردن بررسی جریان جهت تعیین مدت‌زمان از 0 استفاده کنید)، .br expart (bool، پیش‌فرض: false): ارائهٔ تصاویر به‌عنوان یک PID ویدیویی اختصاصی .br .br .SH vorbisdec .LP .br توضیحات: رمزگشای Vorbis .br .br این فیلتر جریان‌های Vorbis را از طریق کتابخانهٔ libvorbis رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH theoradec .LP .br توضیحات: رمزگشای Theora .br .br این فیلتر جریان‌های Theora را از طریق کتابخانهٔ libtheora رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH m2tsdmx .LP .br توضیحات: تفکیک‌کنندهٔ MPEG-2 TS .br .br این فیلتر فایل‌ها/داده‌های MPEG-2 Transport Stream را به مجموعه‌ای از فریم‌ها و PIDهای رسانه‌ای تفکیک می‌کند. .br .br .SH "گزینه‌های تخصصی (OPTIONS (EXPERT))" .LP .br temi_url (cstr): تحمیل نشانی اینترنتی (URL) مربوط به TEMI .br dsmcc (bool، پیش‌فرض: no): فعال‌سازی گیرندهٔ DSMCC .br seeksrc (bool، پیش‌فرض: true): پرش مجدد فایل منبع محلی به مبدا پس از راه‌اندازی تمام برنامه‌ها .br sigfrag (bool، پیش‌فرض: false): اعلان مرزهای بخش (segment) در بسته‌های خروجی برای منابع DASH یا HLS .br dvbtxt (bool، پیش‌فرض: false): صادر کردن جریان‌های تله‌تکست DVB .br upes (enum، پیش‌فرض: no): نگه‌داشتن جریان‌های ناشناختهٔ PES .br * no: نادیده گرفتن جریان‌ها .br * info: اعلان جریان به‌صورت صوری (عدم ارسال داده‌ها به جلو)، dvbtxt را فعال می‌کند .br * full: اعلان جریان و ارسال داده‌ها .br .br mappcr (bool، پیش‌فرض: true): نگاشت مجدد PCR و برچسب‌های زمانی به یک خط زمانی پیوسته .br sigfo (bool، پیش‌فرض: false): اعلان مرزهای بخش در بسته‌های خروجی برای منابع DASH یا HLS (مشابه sigfrag، اما مستقل از گزینه‌های dasher) .br .br.SH sockin .LP .br توضیحات: ورودی UDP/TCP .br .br این فیلتر سوکت‌های ورودی عمومی TCP و UDP را مدیریت می‌کند. همچنین می‌تواند ورودی MPEG-2 TS بر روی RTP را شناسایی کند. شناسایی خودکار MPEG-2 TS بر روی UDP/RTP به‌طور پیش‌فرض فعال است، اما می‌توان آن را غیرفعال کرد. .br .br قالب داده را می‌توان با تنظیم گزینه‌های .I ext یا .I mime مشخص کرد. در صورت عدم تنظیم، قالب با بررسی نخستین بستهٔ داده حدس زده خواهد شد. .br .br \- سوکت‌های UDP برای URLهای مبدأ با قالب udp://NAME استفاده می‌شوند .br \- سوکت‌های TCP برای URLهای مبدأ با قالب tcp://NAME استفاده می‌شوند .br \- سوکت‌های دامنه یونیکس UDP برای URLهای مبدأ با قالب udpu://NAME استفاده می‌شوند .br \- سوکت‌های دامنه یونیکس TCP برای URLهای مبدأ با قالب tcpu://NAME استفاده می‌شوند .br .br هنگامی که درگاه‌ها در URL مشخص شده باشند و از جداکننده‌های پیش‌فرض گزینه‌ها استفاده شود (رجوع کنید به gpac -h doc)، URL باید یکی از موارد زیر را رعایت کند: .br \- یک '/' در انتها داشته باشد، مانند udp://localhost:1234/[:opts] .br \- از جداکنندهٔ gpac استفاده کند، مانند udp://localhost:1234[:gpac:opts] .br .br هنگامی که سوکت در حالت نگه‌داشت اتصال (keep-alive) .I ka گوش می‌دهد: .br \- تنها یک اتصال مجاز است و یک PID خروجی واحد تولید خواهد شد .br \- هر رویداد بسته‌شدن اتصال باعث تخلیهٔ خط‌لوله (pipeline flush) خواهد شد .br .br در OSX با بازپخش بسته در ماشین مجازی (VM packet replay)، باید مسیریابی چندپخشی را اجبار کنید، برای نمونه: route add -net 239.255.1.4/32 -interface vboxnet0 .br .SH "تنظیم زمان (TIME REGULATION)" .LP .br این فیلتر از زمان میان دو بستهٔ آخر دریافت‌شده برای برآورد این‌که هر چند وقت یک‌بار باید ورودی‌ها را بررسی کند، استفاده می‌کند. حداقل و حداکثر زمان انتظار میان دو فراخوانی با گزینهٔ .I mwait تعیین می‌شود. ممکن است لازم باشد حداکثر زمان برای منابع با نرخ بیت بسیار بالا کاهش یابد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS)" .LP .br src (cstr): نشانی محتوای مبدأ .br block_size (uint، پیش‌فرض: 0x60000): اندازهٔ بلوک مورد استفاده برای خواندن سوکت .br port (uint، پیش‌فرض: 1234): درگاه پیش‌فرض در صورت مشخص نشدن .br ifce (cstr): رابط چندپخشی پیش‌فرض .br listen (bool، پیش‌فرض: false): مشخص می‌کند که سوکت ورودی در حالت سرور کار کند .br ka (bool، پیش‌فرض: false): زنده نگه‌داشتن سوکت در صورت نبود اتصال‌های بیشتر .br maxc (uint، پیش‌فرض: +I): حداکثر تعداد اتصال‌های هم‌زمان .br tsprobe (bool، پیش‌فرض: true): پویش برای داده‌های MPEG-2 TS، به‌صورت RTP یا UDP خام. در صورت مشخص شدن mime یا ext و عدم تطابق آن‌ها با mimeها/پسوندهای MPEG-2 TS غیرفعال می‌شود .br ext (str): مشخص کردن پسوند فایل داده‌های udp .br mime (str): مشخص کردن نوع mime داده‌های udp .br block (bool، پیش‌فرض: false): تنظیم حالت مسدودکننده (blocking) برای سوکت(ها) .br timeout (uint، پیش‌فرض: 10000): تنظیم مهلت زمانی بر حسب میلی‌ثانیه برای سوکت(های) UDP؛ مقدار 0 برای غیرفعال کردن مهلت زمانی .br mwait (v2di، پیش‌فرض: 1x30): تنظیم حداقل و حداکثر زمان انتظار بر حسب میلی‌ثانیه برای جلوگیری از سرکشی بیش از حد (polling) .br reorder_pck (uint، پیش‌فرض: 100): تأخیر بر حسب تعداد بسته برای بازآرایی RTP (داده‌های M2TS بر روی RTP) .br reorder_delay (uint، پیش‌فرض: 10): میزان تأخیر بر حسب میلی‌ثانیه برای بازآرایی RTP (داده‌های M2TS بر روی RTP) .br ssm (strl): فهرست IPها جهت گنجاندن در چندپخشی مبدأ-خاص (SSM) .br ssmx (strl): فهرست IPها جهت مستثنی کردن از چندپخشی مبدأ-خاص (SSM) .br .br .SH dvbin .LP .br توضیحات: DVB برای لینوکس .br .br این فیلتر داده‌های خام MPEG-2 TS را از کارت‌های DVB-T/T2 و DVB-S/S2 در لینوکس می‌خواند. .br .br طرح‌وارهٔ URL مورد استفاده dvb:// است که نحوهای زیر را دارد: .br * `dvb://CHAN`: روی کانال CHAN در فایل پیکربندی کانال‌ها تنظیم می‌شود (tune می‌کند). .br * `dvb://+CHAN`: روی مالتی‌پلکس حاوی کانال CHAN تنظیم می‌شود و همهٔ برنامه‌ها را ارائه می‌دهد. .br * `dvb://=N`: روی کانال N-اُم در فایل پیکربندی کانال‌ها تنظیم می‌شود. .br * `dvb://@FREQ`: روی فرکانس FREQ تنظیم می‌شود و تمام کانال‌های موجود در مالتی‌پلکس را ارائه می‌دهد. .br * `dvb://@=N`: روی فرکانس N-اُم تنظیم می‌شود و تمام کانال‌های موجود در مالتی‌پلکس را ارائه می‌دهد. .br * `dvb://@chlist`: گزینهٔ .I chans را با کانال‌های موجود در فایل پیکربندی مقداردهی می‌کند و کار دیگری انجام نمی‌دهد. .br .br هنگام تنظیم بر پایهٔ نام کانال CHAN، نخستین مدخل در فایل پیکربندی کانال‌ها که با CHAN آغاز شود استفاده خواهد شد. .br .br فایل پیکربندی کانال‌ها از طریق .I chcfg تعیین می‌شود. قالب مورد انتظار VDR به همان صورت تولیدشده توسط w_scan است، با نحوی گسترش‌یافته برای خطوط توضیح که با # آغاز می‌شوند. .br در یک خط توضیح، کلیدواژه‌های زیر می‌توانند برای بازنویسی مقادیر پیش‌فرض استفاده شوند: .br * `dev=N`: تنظیم نمایهٔ آداپتور (N عدد صحیح) یا مسیر کامل (N رشته). .br * `idx=K`: تنظیم نمایهٔ فرانت‌اند K. .br * `csidx=S`: تنظیم نمایهٔ سوییچ تثبیت‌شده (committed switch) برای DiSEqC. .br .br برای مشاهدهٔ کانال‌های پیش‌فرض، از دستور gpac -hx dvbin استفاده کنید. .br .br.SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br src (cstr): نشانی اینترنتی (URL) محتوای منبع .br block_size (uint، پیش‌فرض: 65536): اندازه بلوک مورد استفاده برای خواندن دستگاه .br chcfg (cstr، پیش‌فرض: $GCFG/channels.conf): مسیر فایل پیکربندی کانال‌ها .br dev (str، پیش‌فرض: 0): مسیر آداپتور DVB - اگر نویسه نخست یک عدد باشد، این اندیس دستگاه است .br idx (uint، پیش‌فرض: 0): اندیس frontend .br timeout (uint، پیش‌فرض: 5000): زمان انتظار (timeout) به میلی‌ثانیه پیش از شکست تنظیم فرکانس (tune) .br csleep (uint، پیش‌فرض: 15): زمان خواب پیکربندی به میلی‌ثانیه میان دستورهای DiSEqC .br csidx (uint، پیش‌فرض: 0): اندیس سوئیچ اختصاصی (committed switch index) برای DiSEqC .br chans (strl): فهرست همه کانال‌ها؛ تنها برای نشانی dvb://@chlist مقداردهی می‌شود .br .br .SH osvcdec .LP .br توضیحات: رمزگشای OpenSVC .br .br این فیلتر جریان‌های مقیاس‌پذیر AVC|H264 را از طریق کتابخانه OpenSVC رمزگشایی می‌کند. .br .br بدون گزینه .br .br .SH vtbdec .LP .br توضیحات: رمزگشای VideoToolBox .br .br این فیلتر جریان‌های ویدیویی را از طریق VideoToolBox در OSX/iOS (فرمت‌های MPEG-2، H263، AVC|H264، HEVC، ProRes) رمزگشایی می‌کند. این فیلتر امکان ارسال فریم به GPU یا کپی مستقیم فریم را فراهم می‌کند. .br .br .SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br reorder (uint، پیش‌فرض: 6): تعداد فریم‌ها برای انتظار جهت بازآرایی زمانی (temporal re-ordering) .br no_copy (bool، پیش‌فرض: true): ارسال فریم‌های رمزگشایی‌شده به‌صورت بافت‌های OpenGL (مقدار true) یا بسته‌های کپی‌شده (مقدار false) .br ofmt (pfmt، پیش‌فرض: nv12): تنظیم فرمت پیش‌فرض پیکسل برای ویدیوی رمزگشایی‌شده؛ در صورت یافت نشدن، به nv12 برگردانده می‌شود .br disable_hw (bool، پیش‌فرض: false): غیرفعال‌سازی رمزگشایی سخت‌افزاری .br wait_sync (bool، پیش‌فرض: false، قابل به‌روزرسانی): انتظار برای فریم همگام‌سازی (sync frame) پیش از رمزگشایی .br .br .SH mcdec .LP .br توضیحات: رمزگشای MediaCodec .br .br این فیلتر جریان‌های ویدیویی را با استفاده از رمزگشای سخت‌افزاری در دستگاه‌های android رمزگشایی می‌کند. .br .br .SH "گزینه‌ها (پیشرفته) (Options (expert)):" .LP .br disable_gl (bool، پیش‌فرض: false): غیرفعال‌سازی انتقال بافت OpenGL .br .br .SH lsrdec .LP .br توضیحات: رمزگشای MPEG-4 LASeR .br .br این فیلتر فریم‌های باینری MPEG-4 LASeR را مستقیماً درون گراف صحنه (scene graph) ترکیب‌کننده (compositor) رمزگشایی می‌کند. .br نکته: از این فیلتر نمی‌توان برای استخراج (dump) محتوای LASeR به متن یا xml استفاده کرد؛ برای این منظور از MP4Box استفاده کنید. .br .br بدون گزینه .br .br .SH safdmx .LP .br توضیحات: دی‌مالتی‌پلکسر SAF .br .br این فیلتر فایل‌ها/داده‌های SAF (قالب MPEG-4 Simple Aggregation Format for LASeR) را به مجموعه‌ای از PIDها و فریم‌های رسانه‌ای دی‌مالتی‌پلکس می‌کند. .br .br بدون گزینه .br .br .SH dashin .LP .br توضیحات: کلاینت DASH و HLS .br .br این فیلتر مانیفست‌های MPEG-DASH، HLS و MS Smooth را می‌خواند. .br .br.SH "حالت عادی (Regular mode)" .LP .br این حالت پیش‌فرض است که در آن، فیلتر شناسه‌های رسانه (PIDها) و فریم‌ها را از منابع مشخص‌شده در manifest تولید می‌کند. .br رفتار پیش‌فرض، انجام انطباق بر اساس .I algo است، اما فیلتر می‌تواند: .br \- بدون انطباق اجرا شود تا بیشترین کیفیت را دریافت کند. .br مثال .br gpac -i MANIFEST_URL:algo=none:start_with=max_bw -o dest.mp4 .br .br \- بدون انطباق اجرا شود و تمام کیفیت‌ها را دریافت کند. .br مثال .br gpac -i MANIFEST_URL:split_as -o dst=$File$.mp4 .br .br .br .SH "حالت فایل (File mode)" .LP .br هنگامی که .I forward روی file تنظیم شود، کلاینت فایل‌های رسانه را بدون demultiplex کردن فوروارد می‌کند. .br این حالت بیشتر برای ارائهٔ نشست DASH به یک کارساز فایل مانند ROUTE یا HTTP استفاده می‌شود. .br در این حالت، manifest به‌صورت یک PID خروجی فوروارد می‌شود. .br هشدار: این حالت نمی‌تواند از طریق ارث‌بری تنظیم شود، زیرا قابلیت‌های پیوند فیلتر را تغییر می‌دهد. فیلتر حتماً باید به‌صورت صریح تعریف شود. .br .br برای ارائهٔ یک نشست زندهٔ DASH به route: .br .br gpac -i MANIFEST_URL dashin:forward=file -o route://225.0.0.1:8000/ .br .br .br اگر منبع دارای جریان‌های رسانه‌ای وابسته (scalability) باشد و نیاز به ارسال تمام کیفیت‌ها و سگمنت‌های مقداردهی اولیه باشد، .I split_as را اضافه کنید. .br .br .SH "حالت‌های مرز سگمنت (Segment bound modes)" .LP .br هنگامی که .I forward روی segb یا mani تنظیم شود، کلاینت فریم‌های رسانه را (پس از demultiplex کردن) به همراه مرزهای سگمنت و فرگمنت فایل‌های منبع فوروارد می‌کند. .br .br این حالت می‌تواند برای پردازش داده‌های رسانه و تولید مجدد همان manifest یا قطعه‌بندی (segmentation) به کار رود. .br .br مثال .br gpac -i MANIFEST_URL:forward=mani cecrypt:cfile=DRM.xml -o encrypted/live.mpd:pssh=mv .br .br این دستور یک نشست DASH موجود را رمزنگاری کرده و PSSH را به درون manifest و سگمنت‌ها تزریق می‌کند. .br .br مثال .br gpac -i MANIFEST_URL:forward=segb cecrypt:cfile=DRM.xml -o encrypted/live.m3u8 .br .br این دستور یک نشست DASH موجود را رمزنگاری کرده و با استفاده از همان نام‌ها و مرزهای سگمنت، آن را مجدداً به‌صورت HLS منتشر می‌کند. .br .br این حالت برای اطمینان از کامل بودن اولین سگمنت دریافت‌شده، مقدار .I noseek=true و برای دریافت تمام کیفیت‌ها، مقدار .I split_as=true را تحمیل می‌کند. .br .br به هر بستهٔ نخست از یک سگمنت، ویژگی‌های زیر پیوست خواهد شد: .br * `CueStart`: نشان‌دهندهٔ شروع یک سگمنت است .br * `FileNumber`: شمارهٔ سگمنت فعلی .br * `FileName`: نام فایل سگمنت فعلی بدون نشانی پایهٔ (base URL) manifest (شامل MPD یا مستر HLS) .br * `DFPStart`: اگر این نخستین بسته در دوره (period) باشد با مقدار 0 تنظیم می‌شود؛ در غیر این صورت وجود ندارد .br .br اگر .I forward روی mani تنظیم شده باشد، نخستین بسته از سگمنتی که پس از به‌روزرسانی manifest ارسال می‌شود نیز بار دادهٔ (payload) manifest را به‌عنوان یک ویژگی به همراه خواهد داشت: .br * `DFManifest`: شامل manifest اصلی (MPD، مستر M3U8) است .br * `DFVariant`: شامل فهرستی از لیست‌های پخش فرزند HLS به‌صورت رشته برای کیفیت داده‌شده است .br * `DFVariantName`: شامل فهرستی از نام‌های لیست‌های پخش فرزند مرتبط HLS، با همان ترتیب manifestها در DFVariant است .br .br به هر PID خروجی، ویژگی‌های زیر اختصاص داده خواهد شد: .br * `DFMode`: برای segb روی 1 و برای mani روی 2 تنظیم می‌شود .br * `DCue`: روی inband تنظیم می‌شود .br * `DFPStart`: روی مقدار شروع دورهٔ (period) فعلی تنظیم می‌شود .br * `FileName`: روی سگمنت مقداردهی اولیهٔ (init segment) مرتبط، در صورت وجود، تنظیم می‌شود .br * `Representation`: روی شناسهٔ representation مرتبط در manifest تنظیم می‌شود .br * `DashDur`: روی میانگین مدت‌زمان سگمنت طبق آنچه در manifest آمده است تنظیم می‌شود .br * `source_template`: روی true تنظیم می‌شود تا نشان دهد الگوی منبع شناخته‌شده است .br * `stl_timescale`: مقیاس زمانی استفاده‌شده توسط SegmentTimeline، یا 0 در صورت نبود SegmentTimeline .br * `init_url`: نشانی اینترنتی مقداردهی اولیهٔ حل‌نشده (همان‌طور که در MPD یا در لیست پخش variant آمده است) .br * `manifest_url`: نشانی URL فایل manifest .br * `hls_variant_name`: نام لیست پخش variant در HLS (همان‌طور که در لیست پخش مستر HLS آمده است) .br .br هنگامی که dasher به همراه این حالت استفاده شود، تمام سگمنت‌های تولیدشده مجبور خواهند بود دقیقاً همان نام، مدت‌زمان و ویژگی‌های قطعه‌بندی (fragmentation) سگمنت‌های ورودی را داشته باشند. بنابراین برای نشست‌هایی که روی فضای ذخیره‌سازی محلی ذخیره یا تولید می‌شوند، توصیه نمی‌شود که خروجی در همان دایرکتوری ایجاد شود. .br .br.SH "گزینه‌ها (پیشرفته) (OPTIONS (EXPERT)):" .LP .br auto_switch (sint، پیش‌فرض: 0): تعویض کیفیت در هر N قطعه .br * positive: رفتن به کیفیت بالاتر یا چرخش به پایین‌ترین کیفیت .br * negative: رفتن به کیفیت پایین‌تر یا چرخش به بالاترین کیفیت .br * 0: غیرفعال .br .br segstore (enum، پیش‌فرض: mem): فعال‌سازی حافظهٔ پنهان فایل .br * mem: تمام فایل‌ها در حافظه ذخیره می‌شوند، بدون ورودی/خروجی دیسک .br * disk: فایل‌ها روی دیسک ذخیره می‌شوند اما پس از پخش دور ریخته می‌شوند .br * cache: تمام فایل‌ها روی دیسک ذخیره و نگهداری می‌شوند .br .br algo (str، پیش‌فرض: gbuf، Enum: none|grate|gbuf|bba0|bolaf|bolab|bolau|bolao|JS): الگوریتم انطباق مورد استفاده .br * none: بدون منطق انطباق .br * grate: الگوریتم قدیمی GPAC بر اساس نرخ در دسترس .br * gbuf: الگوریتم قدیمی GPAC بر اساس میزان پر بودن بافر .br * bba0: BBA-0 .br * bolaf: BOLA Finite .br * bolab: BOLA Basic .br * bolau: BOLA-U .br * bolao: BOLA-O .br * JS: استفاده از فایل JS (با مسیر مشخص‌شده یا در $GSHARE/scripts/) برای الگوریتم (پسوند ‎.js می‌تواند حذف شود) .br .br start_with (enum، پیش‌فرض: max_bw): معیارهای انتخاب اولیه .br * min_q: شروع با پایین‌ترین کیفیت .br * max_q: شروع با بالاترین کیفیت .br * min_bw: شروع با پایین‌ترین نرخ بیت .br * max_bw: شروع با بالاترین نرخ بیت؛ اگر از تایل‌ها استفاده شود، برای تمام تایل‌های با اولویت پایین پهنای باند کمتر (زیر حداکثر) انتخاب می‌شود .br * max_bw_tiles: شروع با بالاترین نرخ بیت؛ اگر از تایل‌ها استفاده شود، برای تمام تایل‌های با اولویت پایین کمترین پهنای باند انتخاب خواهد شد .br .br max_res (bool، پیش‌فرض: true): استفاده از بیشترین تفکیک‌پذیری رسانه برای پیکربندی نمایشگر .br abort (bool، پیش‌فرض: false): اجازهٔ لغو در حین بارگیری قطعه .br use_bmin (enum، پیش‌فرض: auto): مدیریت بافر پخش .br * no: استفاده از تنظیمات پیش‌فرض پخش‌کننده .br * auto: اطلاع‌رسانی مدت‌زمان قطعه به پخش‌کننده در صورتی که حالت تأخیر کم نباشد .br * mpd: استفاده از کمترین زمان بافر مشخص‌شده در MPD .br .br shift_utc (sint، پیش‌فرض: 0): جابه‌جایی ساعت UTC در DASH به میلی‌ثانیه .br spd (sint، پیش‌فرض: \-I): تأخیر نمایش پیشنهادی به میلی‌ثانیه .br mcast_shift (sint، پیش‌فرض: 0): جابه‌جایی زمان درخواست‌ها به میلی‌ثانیه داده‌شده برای منابع چندپخشی .br server_utc (bool، پیش‌فرض: yes): استفاده از سرآیندهای HTTP با نام ServerUTC یا Date به‌جای UTC محلی .br screen_res (bool، پیش‌فرض: yes): استفاده از تفکیک‌پذیری صفحه در مرحلهٔ انتخاب .br init_timeshift (sint، پیش‌فرض: 0): تنظیم timeshift اولیه به میلی‌ثانیه (اگر >0) یا بر حسب درصد بافر timeshift (اگر <0) .br tile_mode (enum، پیش‌فرض: none): حالت انطباق تایل .br * none: نرخ بیت به‌طور برابر میان تمام تایل‌ها تقسیم می‌شود .br * rows: نرخ بیت برای هر سطر از تایل‌ها با شروع از بالا کاهش می‌یابد؛ نرخ یکسان برای هر تایل در آن سطر .br * rrows: نرخ بیت برای هر سطر از تایل‌ها با شروع از پایین کاهش می‌یابد؛ نرخ یکسان برای هر تایل در آن سطر .br * mrows: نرخ بیت فقط برای سطرهای بالا و پایین کاهش می‌یابد؛ نرخ یکسان برای هر تایل در آن سطر .br * cols: نرخ بیت برای هر ستون از تایل‌ها با شروع از چپ کاهش می‌یابد؛ نرخ یکسان برای هر تایل در آن ستون .br * rcols: نرخ بیت برای هر ستون از تایل‌ها با شروع از راست کاهش می‌یابد؛ نرخ یکسان برای هر تایل در آن ستون .br * mcols: نرخ بیت فقط برای ستون‌های چپ و راست کاهش می‌یابد؛ نرخ یکسان برای هر تایل در آن ستون .br * center: کاهش نرخ بیت برای تمام تایل‌های واقع در لبهٔ تصویر .br * edges: کاهش نرخ بیت برای تمام تایل‌های واقع در مرکز تصویر .br .br tiles_rate (uint، پیش‌فرض: 100): مقدار پهنای باند برای استفاده در هر سطح کیفیت را مشخص می‌کند. نرخ به‌صورت بازگشتی در هر سطح اعمال می‌شود، مثلاً اگر 50% باشد، سطح ۱ مقدار 50%، سطح ۲ مقدار 25% و... دریافت می‌کند. اگر 100 باشد، تخصیص خودکار نرخ با بیشینه‌سازی کیفیت به ترتیب اولویت انجام خواهد شد. اگر 0 باشد، جریان بیت میان تایل‌ها/کیفیت‌ها هموارسازی نمی‌شود و ممکن است هم‌زمانی میان رسانه‌های مختلف رخ دهد .br delay40X (uint، پیش‌فرض: 500): تأخیر بر حسب میلی‌ثانیه برای انتظار میان دو خطای 40X روی همان قطعه .br exp_threshold (uint، پیش‌فرض: 100): تأخیر بر حسب میلی‌ثانیه برای انتظار پس از AvailabilityEndDate قطعه پیش از آنکه قطعه مفقود تلقی شود .br switch_count (uint، پیش‌فرض: 1): مشخص می‌کند که کلاینت پیش از افزایش پهنای باند باید چند قطعه منتظر بماند. اگر 0 باشد، تعویض به محض کافی بودن پهنای باند رخ می‌دهد، اما این حالت در برابر تغییرات شبکه آسیب‌پذیرتر است .br aggressive (bool، پیش‌فرض: no): در صورت فعال بودن، الگوریتم تعویض نزدیک‌ترین پهنای باند متناسب با نرخ بارگیری موجود را هدف قرار می‌دهد. در صورت no، الگوریتم تعویض بازنمایی با کمترین نرخ بیتی را که بالاتر از مورد در حال پخش فعلی است هدف قرار می‌دهد (مثلاً تلاش نمی‌کند به حداکثر پهنای باند جهش کند) .br debug_as (uintl): تنها مجموعه‌های انطباق مشخص‌شده با نمایه‌هایشان (مبتنی بر 0) در MPD را پخش می‌کند .br speedadapt (bool، پیش‌فرض: no): فعال‌سازی انطباق بر اساس سرعت پخش .br noxlink (bool، پیش‌فرض: no): غیرفعال‌سازی xlink در صورتی که period هم دارای xlink و هم مجموعه‌های انطباق باشد .br query (str): تنظیم رشتهٔ پرس‌وجو (بدون علامت '?' ابتدایی) جهت الحاق به xlink دوره‌ها (periods) .br split_as (bool، پیش‌فرض: no): جداسازی تمام کیفیت‌ها در مجموعه‌های انطباق مختلف و جاری‌سازی تمام کیفیت‌ها. بازنمایی‌های وابسته (مقیاس‌پذیر) به‌صورت مستقل در نظر گرفته می‌شوند .br noseek (bool، پیش‌فرض: no): غیرفعال‌سازی پرش (seeking) به قطعه(های) اولیه در حالت پویا (کاربردی در زمان عدم تطابق ساعت‌های UTC) .br bwcheck (uint، پیش‌فرض: 5): حداقل زمان بر حسب میلی‌ثانیه بین دو بررسی پهنای باند هنگام مجاز بودن لغو بارگیری قطعه .br lowlat (enum، پیش‌فرض: early): سیاست زمان‌بندی قطعه در حالت تأخیر کم .br * no: غیرفعال‌سازی تأخیر کم .br * strict: رعایت دقیق آفست AST در حالت تأخیر کم .br * early: اجازهٔ واکشی قطعات زودتر از AST آن‌ها در حالت تأخیر کم هنگامی که PID ورودی خالی است .br .br forward (enum، پیش‌فرض: none): حالت بازفرستادن قطعه .br * none: خواندن عادی DASH .br * file: فایل‌ها تفکیک (demultiplex) نمی‌شوند و به‌صورت PIDهای فایل بازفرستاده می‌شوند (مستلزم segstore=mem) .br * segb: فعال‌سازی .I split_as، سیگنال‌دهی مرزهای قطعه و فرگمنت (sigfrag) در منابع و درج نشانه‌های DASH .br * mani: مشابه segb و همچنین بازفرستادن مانیفست‌ها .br .br fmodefwd (bool، پیش‌فرض: yes): بازفرستادن بسته‌ها به‌جای رونوشت گرفتن از آن‌ها در حالت بازفرستادن فایل. رونوشت بسته ممکن است عملکرد را در حالت تأخیر کم بهبود بخشد .br skip_lqt (bool، پیش‌فرض: no): غیرفعال‌سازی رمزگشایی تایل‌های با بیشترین نشانه‌های افت کیفیت (غیرقابل‌مشاهده، خارج از میدان دید) برای اهداف اشکال‌زدایی .br llhls_merge (bool، پیش‌فرض: yes): ادغام بخش‌های محدودهٔ بایتی LL-HLS در یک درخواست محدودهٔ بایتی بازِ واحد .br groupsel (bool، پیش‌فرض: no): انتخاب گروه‌ها بر اساس زبان (به‌طور پیش‌فرض تمام گروه‌های قابل پخش نشان داده می‌شوند) .br xas (enum، پیش‌فرض: codec): فعال‌سازی تعویض بین مجموعه‌های انطباق (در صورت تنظیم .I split_as غیرفعال است) .br * no: غیرفعال .br * codec: تعویض بین مجموعه‌ها تنها برای همان codec مجاز است .br * all: تعویض بین مجموعه‌ها برای انواع مختلف بازنمایی مجاز است .br .br chain_mode (enum، پیش‌فرض: on): حالت زنجیره‌سازی MPD .br * off: عدم استفاده از زنجیره‌سازی MPD .br * on: استفاده از زنجیره‌سازی MPD پس از پایان، بازگشت به حالت قبلی در صورت شکست در بارگیری MPD .br * error: استفاده از زنجیره‌سازی MPD پس از پایان یا در صورت بروز خطا (در بارگیری MPD یا قطعه) .br .br asloop (bool، پیش‌فرض: false): هنگامی که تعویض خودکار فعال است، به‌صورت رفت و برگشتی بین بالاترین و پایین‌ترین کیفیت‌ها پیمایش می‌کند .br bsmerge (bool، پیش‌فرض: true): مجاز بودن ادغام جریان‌های بیت ویدیو (در حال حاضر تنها HEVC) .br keep_burl (enum، پیش‌فرض: strip): واپایش BaseURL در مانیفست .br * strip: حذف BaseURL (پیش‌فرض) .br * keep: نگه‌داشتن BaseURL .br * inject: تزریق URL نسبی محلی پیش از مقدار BaseURL مشخص‌شده با گزینهٔ relative_url .br .br relative_url (str، پیش‌فرض: ./): رشتهٔ نسبی برای تزریق پیش از BaseURL وقتی که keep_base_url روی inject تنظیم شده است .br .br.SH cdcrypt .LP .br توضیحات: رمزگشای CENC .br .br رمزگشای CENC از رمزگشایی جریان‌های CENC، ISMA، HLS Sample-AES (MPEG2 ts) و Adobe پشتیبانی می‌کند. .br .br برای HLS، کلید بر اساس URI کلید در مانیفست بازیابی می‌شود. .br در غیر این صورت، فیلتر از یک فایل پیکربندی استفاده می‌کند. .br نحو نگارش در https://wiki.gpac.io/xmlformats/Common-Encryption در دسترس است. .br فایل پیکربندی DRM می‌تواند به ازای هر PID با استفاده از ویژگی DecryptInfo (بالاترین اولویت)، CryptInfo (اولویت پایین‌تر) یا در سطح فیلتر با استفاده از .I cfile (پایین‌ترین اولویت) تنظیم شود. .br هنگامی که فایل به ازای هر PID تنظیم شود، نخستین CryptInfo با همان شناسه (ID) استفاده می‌شود، در غیر این صورت نخستین CryptInfo به کار می‌رود. هنگامی که فایل به‌طور سراسری (نه به ازای هر PID) تنظیم شود، نخستین CrypTrack در فایل پیکربندی DRM با همان شناسه به کار می‌رود، در غیر این صورت نخستین CrypTrack با شناسه 0 یا مشخص‌نشده استفاده می‌شود. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT))" .LP .br cfile (str): مکان فایل crypt .br decrypt (enum، پیش‌فرض: full): حالت رمزگشایی (تنها CENC) .br * full: رمزگشایی همه‌چیز، با صدور خطا در صورت پیدا نشدن کلیدها .br * nokey: رمزگشایی هر آنچه که کلید برایش پیدا شود، در غیر این صورت صرف‌نظر از رمزگشایی .br * skip: عدم رمزگشایی هیچ‌چیز .br * pad0: عدم رمزگشایی هیچ‌چیز و جایگزینی تمام بیت‌های رمزگذاری‌شده با 0 .br * pad1: عدم رمزگشایی هیچ‌چیز و جایگزینی تمام بیت‌های رمزگذاری‌شده با 1 .br * padsc: عدم رمزگشایی هیچ‌چیز و جایگزینی تمام بایت‌های رمزگذاری‌شده با کدهای شروع (start codes) .br .br drop_keys (uintl): کلیدهای دارای اندیس‌های مبتنی بر ۱ (1-based) مشخص‌شده ناموجود در نظر گرفته شوند (اشکال‌زدایی چندکلیدی) .br kids (strl): تعریف KIDها. اگر keys خالی باشد، کلیدهای دارای KID مشخص‌شده (به صورت رشته هگز) ناموجود در نظر گرفته شوند (اشکال‌زدایی) .br keys (strl): تعریف مقادیر کلید برای هر یک از KIDهای مشخص‌شده .br hls_cenc_patch_iv (bool، پیش‌فرض: false): نادیده گرفتن به‌روزرسانی‌های IV در برخی جریان‌های خراب HLS+CENC .br .br .SH cecrypt .LP .br توضیحات: رمزنگار CENC .br .br رمزنگار CENC از رمزنگاری CENC، ISMA و Adobe پشتیبانی می‌کند. این فیلتر از یک فایل پیکربندی DRM برای اعلان کلیدها استفاده می‌کند. .br نحو نگارش در https://wiki.gpac.io/xmlformats/Common-Encryption در دسترس است. .br فایل پیکربندی DRM می‌تواند به ازای هر PID با استفاده از ویژگی CryptInfo، یا در سطح فیلتر با استفاده از .I cfile تنظیم شود. .br هنگامی که فایل پیکربندی DRM به ازای هر PID تنظیم شود، نخستین CrypTrack در فایل پیکربندی DRM با همان شناسه (ID) استفاده می‌شود، در غیر این صورت نخستین CrypTrack استفاده می‌شود (بدون در نظر گرفتن شناسه CrypTrack). .br هنگامی که فایل پیکربندی DRM به‌طور سراسری (نه به ازای هر PID) تنظیم شود، نخستین CrypTrack در فایل پیکربندی DRM با همان شناسه به کار می‌رود، در غیر این صورت نخستین CrypTrack با شناسه 0 یا مشخص‌نشده استفاده می‌شود. .br اگر هیچ فایل پیکربندی DRM برای یک PID مشخص تعریف نشده باشد، این PID رمزنگاری نخواهد شد، یا در صورت مشخص شدن .I allc یک خطا صادر می‌شود. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT))" .LP .br cfile (str): مکان فایل crypt .br allc (bool): صدور خطا در صورتی که هیچ فایل پیکربندی DRM برای یک PID پیدا نشود .br bk_stats (bool): چاپ تعداد بلوک‌های رمزنگاری‌شده در stdout هنگام خروج .br bk_skip (bool): صرف‌نظر از رمزنگاری اما انجام تمام وظایف دیگر (حالت آزمایشی) .br .br .SH mp4mx .LP .br توضیحات: مالتی‌پلکسر ISOBMFF/QT .br .br این فیلتر جریان‌ها را به ISOBMFF (استاندارد 14496-12 و مشخصات مشتق‌شده) یا QuickTime مالتی‌پلکس می‌کند .br .br .SH "تراک‌ها و آیتم‌ها (TRACKS AND ITEMS)" .LP .br به‌طور پیش‌فرض تمام PIDهای ورودی که ویژگی ItemID برای آن‌ها تنظیم شده باشد، به عنوان آیتم مالتی‌پلکس می‌شوند، در غیر این صورت به عنوان تراک مالتی‌پلکس می‌شوند. .br برای جلوگیری از مالتی‌پلکس شدن آیتم‌های منبع به عنوان آیتم، از گزینه .I -itemid در دی‌مالتی‌پلکسر ISOBMFF استفاده کنید. .br مثال .br gpac -i source.mp4:itemid=false -o file.mp4 .br .br .br برای اجبار جریان‌های غیرآیتمی به مالتی‌پلکس شدن به عنوان آیتم، از گزینه #ItemID روی آن PID استفاده کنید: .br .br gpac -i source.jpg:#ItemID=1 -o file.mp4 .br .br .br.SH "ذخیره‌سازی (Storage)" .LP .br گزینه .I store امکان کنترل قطعه‌بندی بودن فایل (frag) یا نبودن آن، و در صورت عدم قطعه‌بندی، نحوه انجام درهم‌بافی (inter) را فراهم می‌کند. .br برای مواردی که محدودیت‌های فضای دیسک شدید است و امکان استفاده از قطعه‌بندی وجود ندارد، توصیه می‌شود از حالت‌های flat یا fstart (شروع سریع یا fast-start) استفاده شود. .br حالت sfrag مشابه حالت frag است اما قطعه‌ها را با نمونه‌های SAP تراز می‌کند. این حالت هنگام استفاده از sfrag_tolerance به‌طور ضمنی فعال می‌شود. .br مقدار sfrag_tolerance به‌صورت درصدی از مدت‌زمان قطعه (cdur) بیان می‌شود. این پارامتر امکان تعدیل مدت‌زمان قطعه‌ها را ضمن حفظ تعداد یکسان قطعه‌ها در هر سگمنت فراهم می‌کند. این ویژگی برای تراز کردن قطعه‌ها با نمونه‌های SAP که در نقاط تصادفی قرار دارند (معمولاً برش‌های صحنه یا رویدادها) مفید است. .br .br گزینه .I vodcache امکان کنترل نحوه تولید سگمنت‌های DASH onDemand را فراهم می‌کند: .br \- اگر روی on تنظیم شود، داده‌های فایل در یک فایل موقت روی دیسک ذخیره شده و پس از تکمیل تخلیه (flush) می‌شوند؛ هیچ پدینگی (padding) وجود نخواهد داشت. .br \- اگر روی insert تنظیم شود، SIDX/SSIX پس از تکمیل فایل از طریق جابه‌جایی بایت‌ها در فایل تزریق می‌شود. در این حالت نیازی به پدینگ نیست اما ممکن است با تمام مقصدهای خروجی (output sinks) سازگار نباشد و نوشتن فایل زمان بیشتری ببرد. .br \- اگر روی replace تنظیم شود، اندازه SIDX/SSIX بر اساس مدت‌زمان و طول سگمنت DASH تخمین زده می‌شود و پیش از SIDX نهایی، از پدینگ در فایل استفاده خواهد شد. اگر PIDهای ورودی ویژگی DSegs را تنظیم کرده باشند، این مقدار به‌عنوان تعداد سگمنت‌ها استفاده خواهد شد. .br حالت‌های on و insert دقیقاً فایل یکسانی تولید می‌کنند، در حالی که حالت replace ممکن است یک باکس free پیش از sidx تزریق کند. .br .br .SH "باکس‌های سفارشی (Custom boxes)" .LP .br باکس‌های سفارشی را می‌توان به‌صورت وصله‌های باکس (box patches) تعیین کرد: .br برای وصله در سطح movie، باید از گزینه .I boxpatch فیلتر استفاده شود. .br وصله باکس به ازای هر PID را می‌توان از طریق ویژگی boxpatch مربوط به PID تعیین کرد. .br مثال .br gpac \-i source:#boxpatch=myfile.xml \-o mux.mp4 .br .br وصله باکس به ازای هر Item را می‌توان از طریق ویژگی boxpatch مربوط به PID تعیین کرد. .br مثال .br gpac \-i source:1ItemID=1:#boxpatch=myfile.xml \-o mux.mp4 .br .br .br وصله باکس در حالت قطعه‌بندی‌شده پیش از نوشتن باکس آغازین moov، یا در غیر این صورت هنگام نوشتن کامل فایل اعمال می‌شود. .br وصله باکس می‌تواند نام یک فایل یا یک رشته کامل XML باشد. .br .br .SH "برچسب‌گذاری (Tagging)" .LP .br هنگامی که برچسب‌گذاری فعال باشد، فیلتر ویژگی CoverArt و تمام ویژگی‌های سفارشی روی PID ورودی را زیر نظر می‌گیرد. .br نام برچسب‌های توکار با دستور MP4Box \-h tags مشخص شده‌اند. .br برچسب‌های QT را می‌توان با استفاده از نام‌های ویژگی qtt_NAME مشخص کرد، و با قالب‌بندی تعیین‌شده در MP4Box \-h tags اضافه خواهند شد. .br سایر کلاس‌های برچسب را می‌توان با استفاده از نام‌های ویژگی tag_NAME مشخص کرد، و در صورتی که .I itags روی all تنظیم شده باشد بر اساس قواعد زیر اضافه خواهند شد: .br \- مقدار NAME به‌عنوان یک 4CC باکس، در صورتی که طول NAME چهار نویسه باشد .br \- مقدار NAME به‌عنوان یک 4CC باکس، در صورتی که طول NAME ۳ نویسه باشد، و پیشوند 0xA9 به آن اضافه خواهد شد .br \- مقدار CRC32 مربوط به NAME به‌عنوان یک 4CC باکس، در صورتی که طول NAME چهار نویسه نباشد .br .br نام‌های ویژگی با قالب cust_NAME@MEAN به‌عنوان یک برچسب سفارشی با نام NAME و مفهوم MEAN اضافه می‌شوند. هر دوی NAME و MEAN می‌توانند خالی باشند. .br .SH "داده‌های کاربر (User data)" .LP .br فیلتر برای ایجاد مدخل‌های داده کاربر (user data)، ویژگی‌های PID زیر را بررسی می‌کند: .br * `udtab`: تنظیم باکس user-data ترک روی مقدار ویژگی که باید یک blob آرایه باکس سریال‌شده باشد .br * `mudtab`: تنظیم باکس user-data مربوط به movie روی مقدار ویژگی که باید یک blob آرایه باکس سریال‌شده باشد .br * `udta_U4CC`: تنظیم مدخل باکس user-data ترک از نوع U4CC روی مقدار ویژگی .br * `mudta_U4CC`: تنظیم مدخل باکس user-data مربوط به movie از نوع U4CC روی مقدار ویژگی .br * `tkgp_T4CC`: تنظیم/حذف عضویت در گروه ترک با نوع T4CC و شناسه مشخص‌شده با مقدار ویژگی. مقدار منفی N عضویت را از گروه ترک با شناسه \-N حذف می‌کند .br .br مثال .br gpac \-i src.mp4:#udta_tagc=\(aqMy Awesome Tag\(aq \-o tag.mp4 .br gpac \-i src.mp4:#mudtab=data@box.bin \-o tag.mp4 .br .br .br .SH "شرح‌های سفارشی گروه نمونه و اطلاعات کمکی نمونه (Custom sample group descriptions and sample auxiliary info)" .LP .br فیلتر ویژگی‌های داده سفارشی زیر را روی بسته‌های ورودی زیر نظر می‌گیرد: .br * `grp_A4CC`: نگاشت بسته به شرح گروه نمونه از نوع A4CC و تنظیم مدخل روی بار داده (payload) ویژگی .br * `grp_A4CC_param`: همانند بالا و تنظیم grouping_type_parameter نمونه به گروه روی param .br * `sai_A4CC`: اضافه کردن بار داده (payload) ویژگی به‌عنوان اطلاعات کمکی نمونه از نوع A4CC .br * `sai_A4CC_param`: همانند بالا و تنظیم aux_info_type_parameter روی param .br .br ویژگی grp_EMSG شامل یک یا چند EventMessageBox است، همان‌طور که در MPEG-DASH تعریف شده است. .br \- در حالت قطعه‌بندی‌شده، وجود این ویژگی در یک بسته باعث شروع یک قطعه جدید می‌شود که در آن، باکس‌ها پیش از moof نوشته می‌شوند .br \- در حالت عادی، در حال حاضر از یک گروه نمونه داخلی از نوع EMSG برای ذخیره‌سازی باکس emsg استفاده می‌شود .br .br.SH "نکات (NOTES)" .LP .br فیلتر ویژگی FileNumber را روی بسته‌های ورودی زیر نظر می‌گیرد تا فایل‌های جدید (حالت عادی) یا بخش‌های جدید (حالت DASH) ایجاد کند. .br .br فیلتر ویژگی DSIWrap (به‌صورت 4CC در قالب int یا string) را روی PID ورودی زیر نظر می‌گیرد تا پیکربندی رمزگشا را در باکسی از نوع داده‌شده قرار دهد (بسته‌بندی ناشناخته). .br مثال .br \-i unkn.mkv:#ISOMSubtype=VIUK:#DSIWrap=cfgv \-o t.mp4 .br .br این کار جریان ناشناخته را با استفاده از نقطه کد VIUK در stsd بسته‌بندی کرده و تمام داده‌های پیکربندی رمزگشا را در یک باکس cfgv قرار می‌دهد. .br .br اگر .I pad_sparse تنظیم شده باشد، فیلتر ویژگی Sparse را روی PID ورودی زیر نظر می‌گیرد تا تصمیم بگیرد آیا بسته‌های خالی برای حفظ اطلاعات مدت‌زمان بسته تزریق شوند یا خیر. .br چنین بسته‌هایی تنها زمانی تزریق می‌شوند که وقفه‌ای در خط زمانی شناسایی شود. .br \- اگر Sparse وجود نداشته باشد، بسته خالی برای جریان‌های متنی و فراداده ناشناخته درج می‌شود .br \- اگر Sparse برابر true باشد، بسته خالی برای تمام انواع جریان درج می‌شود .br \- اگر Sparse برابر false باشد، بسته خالی هرگز تزریق نمی‌شود .br .br نوع رسانه پیش‌فرض استفاده‌شده برای یک PID را می‌توان با استفاده از ویژگی StreamSubtype بازنویسی کرد. .br مثال .br \-i src.srt:#StreamSubtype=sbtl [\-i ...] \-o test.mp4 .br .br این کار جریان متنی را وادار می‌کند تا به‌جای نوع پیش‌فرض text، از نوع گرداننده sbtl استفاده کند. .br جریان‌های زیرنویس می‌توانند با تنظیم ویژگی IsChap روی PID دلخواه، به‌عنوان فصل‌ها استفاده شوند. .br مثال .br \-i src.srt:#IsChap [\-i ...] \-o test.mp4 .br .br این کار جریان متنی را وادار می‌کند تا به‌عنوان یک قطعه فصل QT استفاده شود. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT))" .LP .br m4sys (bool، پیش‌فرض: false): اجبار قطعه‌ها به سیگنال‌دهی MPEG-4 Systems .br dref (bool، پیش‌فرض: false): تنها ارجاع داده‌ها از فایل منبع \- با تمام منابع رسانه‌ای سازگار نیست .br ctmode (enum، پیش‌فرض: auto): تنظیم حالت آفست ترکیب (composition offset) برای قطعه‌های ویدیویی .br * auto: در صورت تکه‌تکه کردن یک منبع ISOBMFF، از تنظیمات منبع استفاده می‌کند در غیر این صورت به edit تبدیل می‌شود .br * edit: استفاده از فهرست‌های ویرایش (edit lists) برای انتقال فریم اول به زمان ارائه 0 .br * noedit: نادیده‌گرفتن فهرست‌های ویرایش و عدم انتقال خط زمانی .br * negctts: استفاده از ctts نسخه 1 با آفست‌های احتمالاً منفی و بدون فهرست‌های ویرایش .br .br dur (frac، پیش‌فرض: 0): تنها مدت‌زمان مشخص‌شده را وارد می‌کند. در صورت منفی بودن، تعداد فریم‌های کدگذاری‌شده برای وارد کردن را مشخص می‌کند .br pack3gp (uint، پیش‌فرض: 1): بسته‌بندی تعداد مشخصی از فریم‌های صوتی 3GPP در یک نمونه (sample) .br importer (bool، پیش‌فرض: false): سازگاری با واردکننده قدیمی، پیشرفت وارد کردن را نمایش می‌دهد .br pack_nal (bool، پیش‌فرض: false): بسته‌بندی مجدد طول اندازه NALU به حداقل اندازه ممکن برای ویدیوهای مبتنی بر NALU (مانند AVC/HEVC/...) .br xps_inband (enum، پیش‌فرض: no): استفاده از مجموعه پارامترهای درون‌باندی (درون داده‌های نمونه) برای ویدیوهای مبتنی بر NALU (مانند AVC/HEVC/...) .br * no: مجموعه‌های پارامتر درون‌باندی نیستند، ممکن است چندین شرح نمونه ایجاد شود .br * pps: مجموعه‌های پارامتر تصویر به‌صورت درون‌باندی هستند، سایر مجموعه‌های پارامتر در شرح نمونه قرار دارند .br * all: مجموعه‌های پارامتر درون‌باندی هستند، هیچ مجموعه پارامتری در شرح نمونه وجود ندارد .br * both: مجموعه‌های پارامتر درون‌باندی هستند، به‌عنوان درون‌باندی اعلام شده‌اند و همچنین اولین مجموعه در شرح نمونه نگه داشته می‌شود .br * mix: ایجاد فایل‌های غیر استاندارد با استفاده از یک مدخل نمونه تکی با اولین PSهای یافت‌شده، و انتقال سایر PSها به‌صورت درون‌باندی .br * auto: حفظ پیکربندی منبع، یا پیش‌فرض no اگر منبع ISOBMFF نباشد .br .br store (enum، پیش‌فرض: inter): حالت ذخیره‌سازی فایل .br * inter: انجام درهم‌بافی (interleave) دقیق فایل با استفاده از .I cdur (نیازمند ذخیره‌سازی موقت همه رسانه‌ها) .br * flat: نوشتن نمونه‌ها به‌محض رسیدن و قرار دادن moov در انتها (سریع‌ترین حالت) .br * fstart: نوشتن نمونه‌ها به‌محض رسیدن و قرار دادن moov قبل از mdat .br * tight: استفاده از درهم‌بافی نمونه‌به‌نمونه برای همه قطعه‌ها (نیازمند ذخیره‌سازی موقت همه رسانه‌ها) .br * frag: تکه‌تکه کردن فایل با استفاده از مدت‌زمان cdur .br * sfrag: تکه‌تکه کردن فایل با استفاده از مدت‌زمان cdur اما با تنظیم برای شروع با SAP1/3 .br .br cdur (frac، پیش‌فرض: \-1/1): مدت‌زمان قطعه داده (chunk) برای حالت‌های flat و درهم‌بافی یا مدت‌زمان قطعه (fragment) برای حالت‌های تکه‌تکه‌سازی .br * 0: بدون درهم‌بافی خاص اما moov در ابتدا .br * negative: پیش‌فرض 1.0 مگر اینکه توسط نمایه ذخیره‌سازی بازنویسی شود .br .br moovts (sint، پیش‌فرض: 600): مقیاس زمانی (timescale) برای فیلم. مقدار منفی مقیاس زمانی رسانه اولین قطعه اضافه‌شده را انتخاب می‌کند .br moof_first (bool، پیش‌فرض: true): تولید قطعات با شروع از moof و سپس mdat .br abs_offset (bool، پیش‌فرض: false): استفاده از آفست مطلق فایل در قطعات به‌جای آفست‌ها از moof .br fsap (bool، پیش‌فرض: true): تقسیم trunها در قطعات ویدیویی در SAPها جهت کاهش اندازه فایل .br subs_sidx (sint، پیش‌فرض: \-1): تعداد زیربخش‌ها در هر sidx .br * 0: یک sidx تکی .br * >0: به‌صورت sidx سلسله‌مراتبی یا زنجیره‌ای (daisy-chained) .br * <0: غیرفعال‌سازی sidx .br * \-2: حذف sidx در صورت وجود در PID منبع .br .br m4cc (str): کد ۴ نویسه‌ای (4CC) از باکس خالی برای الحاق به انتهای یک بخش (حالت DASH) یا یک قطعه (حالت غیر DASH) .br chain_sidx (bool، پیش‌فرض: false): استفاده از اتصال زنجیره‌ای SIDX .br msn (uint، پیش‌فرض: 1): شماره توالی اولین moof به N .br msninc (uint، پیش‌فرض: 1): افزایش شماره توالی بین باکس‌های moof .br tfdt (lfrac، پیش‌فرض: 0): تنظیم زمان اولیه رمزگشایی (tfdt) برای اولین traf .br tfdt_traf (bool، پیش‌فرض: false): اجبار به وجود باکس tfdt در هر traf .br nofragdef (bool، پیش‌فرض: false): غیرفعال‌سازی پرچم‌های پیش‌فرض قطعه در moov اولیه .br straf (bool، پیش‌فرض: false): استفاده از یک traf تکی در هر moof (برای Smooth Streaming و موارد مشابه) .br strun (bool، پیش‌فرض: false): استفاده از یک trun تکی در هر traf (برای Smooth Streaming و موارد مشابه) .br prft (enum، پیش‌فرض: sender): تنظیم حالت باکس prft، در حالت غیر تکه‌تکه غیرفعال است .br * off: غیرفعال‌سازی باکس prft .br * sender: قرار دادن زمان ntp پیش از رمزگذار .br * both: قرار دادن زمان فرستنده (در صورت وجود) و زمان ntp هنگام نوشتن moof .br .br psshs (enum، پیش‌فرض: moov): تنظیم حالت ذخیره‌سازی باکس‌های pssh .br * moof: در اولین moof از هر بخش .br * moov: در باکس movie .br * both: در باکس movie و در اولین moof از هر بخش .br * none: باکس pssh نادیده گرفته می‌شود .br .br force_seig (bool، پیش‌فرض: false): اجبار به نوشتن گروه نمونه seig برای نمونه‌های رمزگذاری‌شده، حتی زمانی که همه نمونه‌ها از پیکربندی تک‌کلیدی پیش‌فرض CENC استفاده می‌کنند .br sgpd_traf (bool، پیش‌فرض: false): ذخیره شرح‌های گروه نمونه در traf (تکرارشده برای هر traf). در صورت عدم استفاده، شرح‌های گروه نمونه در باکس movie ذخیره می‌شوند .br vodcache (enum، پیش‌فرض: replace): فعال‌سازی حافظه موقت برای حالت‌های VoD DASH .br * on: استفاده از حافظه موقت کل فایل برای تزریق sidx و ssix .br * insert: درج sidx و ssix با جابه‌جا کردن بایت‌ها در فایل خروجی .br * replace: محاسبه پیش‌دستانه الزامات فضا برای sidx و ssix و بازنویسی محدوده فایل در انتها .br .br noinit (bool، پیش‌فرض: false): عدم تولید moov اولیه، برای حالت سوئیچینگ جریان بیت DASH استفاده می‌شود .br tktpl (enum، پیش‌فرض: yes): استفاده از باکس track از ورودی در صورت وجود به‌عنوان الگو برای ایجاد قطعه جدید .br * no: غیرفعال‌سازی الگو .br * yes: همتاسازی قطعه (به‌جز ویرایش‌ها و پیکربندی رمزگشا) .br * udta: فقط بارگذاری udta .br .br mudta (enum، پیش‌فرض: yes): استفاده از udta و سایر باکس‌های افزونه moov از ورودی در صورت وجود .br * no: غیرفعال‌سازی وارد کردن .br * yes: همتاسازی تمام باکس‌های افزونه .br * udta: فقط بارگذاری udta .br .br mvex (bool، پیش‌فرض: false): قرار دادن باکس‌های mvex پس از باکس‌های trak .br sdtp_traf (enum، پیش‌فرض: no): استفاده از باکس sdtp در باکس traf به‌جای استفاده از پرچم‌ها در مدخل‌های نمونه trun .br * no: از sdtp استفاده نشود .br * sdtp: استفاده از باکس sdtp برای نشان دادن وابستگی‌های نمونه و عدم نوشتن اطلاعات در پرچم‌های نمونه trun .br * both: استفاده از باکس sdtp برای نشان دادن وابستگی‌های نمونه و همچنین نوشتن اطلاعات در پرچم‌های نمونه trun .br .br trackid (uint، پیش‌فرض: 0): شناسه قطعه (track ID) ایجادشده برای تک‌قطعه. مقدار پیش‌فرض 0 از شناسه در دسترس بعدی استفاده می‌کند .br fragdur (bool، پیش‌فرض: false): تکه‌تکه‌سازی بر اساس مدت‌زمان قطعه به‌جای CTS. بیشتر برای گزینه \-frag در MP4Box استفاده می‌شود .br btrt (bool، پیش‌فرض: true): تنظیم باکس btrt در شرح نمونه .br styp (str): تنظیم برند اصلی styp بخش (و اختیاری نسخه) به 4CC[.version] داده‌شده .br lmsg (bool، پیش‌فرض: false): تنظیم برند lmsg برای آخرین بخش یا قطعه .br mediats (sint، پیش‌فرض: 0): تنظیم مقیاس زمانی رسانه. مقدار 0 به معنای ارث‌بری از PID است، مقدار \-1 به معنای استخراج از نرخ نمونه‌برداری یا نرخ فریم است .br ase (enum، پیش‌فرض: v0): تنظیم حالت مدخل نمونه صوتی برای چیدمان‌های فراتر از استریو .br * v0: استفاده از سیگنال‌دهی v0 با تعداد کانال از جریان (به‌جز (e)AC3/4)، برای سازگاری عقب‌رو توصیه می‌شود .br * v0s: استفاده از سیگنال‌دهی v0 و اجبار تعداد کانال به 2 (استریو) در صورت وجود بیش از 2 کانال .br * v0bs: استفاده از سیگنال‌دهی v0 فقط از طریق جریان بیت .br * v1: استفاده از سیگنال‌دهی v1، به سبک ISOBMFF (میکس PCM خام به سبک ISOBMFF) .br * v1qt: استفاده از سیگنال‌دهی v1، به سبک QTFF .br * v2qt: استفاده از سیگنال‌دهی v2، به سبک QTFF (نوع مدخل lpcm) .br .br ssix (bool، پیش‌فرض: false): ایجاد باکس ssix در صورت حضور باکس sidx؛ سطح 1 محدوده‌های بایتی فریم‌های I و سطح 0xFF بقیه را نگاشت می‌کند .br ccst (bool، پیش‌فرض: false): درج باکس محدودیت کدگذاری برای قطعه‌های ویدیویی .br maxchunk (uint، پیش‌فرض: 0): تنظیم حداکثر اندازه چانک به بایت برای runها (فقط در حالت غیر تکه‌تکه‌شده استفاده می‌شود). 0 یعنی بدون محدودیت .br noroll (bool، پیش‌فرض: false): غیرفعال‌سازی گروه‌بندی نمونه roll .br norap (bool، پیش‌فرض: false): غیرفعال‌سازی گروه‌بندی نمونه rap .br saio32 (bool، پیش‌فرض: false): استفاده از آفست ۳۲ بیتی برای مکان داده‌های جانبی (side data) به‌جای آفست ۶۴ بیتی .br tfdt64 (bool، پیش‌فرض: false): استفاده از tfdt و sidx ۶۴ بیتی حتی برای برچسب‌های زمانی ۳۲ بیتی .br compress (enum، پیش‌فرض: no): تنظیم حالت فشرده‌سازی باکس سطح بالا .br * no: غیرفعال‌سازی فشرده‌سازی باکس .br * moov: فقط فشرده‌سازی باکس moov (استفاده از cmov برای QT) .br * moof: فقط فشرده‌سازی باکس‌های moof .br * sidx: فشرده‌سازی باکس‌های moof و sidx .br * ssix: فشرده‌سازی باکس‌های moof، sidx و ssix .br * all: فشرده‌سازی باکس‌های moov، moof، sidx و ssix .br .br fcomp (bool، پیش‌فرض: false): اجبار به استفاده از باکس فشرده حتی زمانی که اندازه فشرده بزرگ‌تر از غیرفشرده باشد .br otyp (bool، پیش‌فرض: false): تزریق نوع فایل اصلی هنگام استفاده از باکس‌های فشرده .br trun_inter (bool، پیش‌فرض: false): درهم‌بافی نمونه‌ها در trun بر اساس سطح زمانی، پایین‌ترین سطوح ابتدا ذخیره می‌شوند (این کار به تعداد مورد نیاز باکس trun ایجاد می‌کند) .br truns_first (bool، پیش‌فرض: false): ذخیره track runها قبل از شرح گروه نمونه و اطلاعات رمزگذاری نمونه .br block_size (uint، پیش‌فرض: 10000): اندازه بلوک خروجی هدف، 0 برای مقدار پیش‌فرض داخلی (10k) .br boxpatch (str): اعمال وصله باکس پیش از نوشتن .br deps (bool، پیش‌فرض: true): افزودن اطلاعات وابستگی‌های نمونه‌ها .br mfra (bool، پیش‌فرض: false): فعال‌سازی دسترسی تصادفی قطعه فیلم (MFRA) هنگام تکه‌تکه‌سازی (هنگام DASH نادیده گرفته می‌شود) .br forcesync (bool، پیش‌فرض: false): اجبار به همگام در نظر گرفتن تمام انواع SAP به‌عنوان نمونه‌های همگام (ممکن است فایل‌های ناسازگار با استاندارد تولید کند) .br refrag (bool، پیش‌فرض: false): استفاده از پیش‌فرض‌های قطعه قطعه از فایل اولیه در صورت وجود به‌جای محاسبه آن‌ها از ویژگی‌های PID (هنگام پردازش بخش‌ها/قطعات مستقل استفاده می‌شود) .br itags (enum، پیش‌فرض: strict): حالت تزریق برچسب .br * none: هیچ برچسبی تزریق نشود .br * strict: فقط تزریق برچسب‌های شناخته‌شده itunes .br * all: تزریق تمام برچسب‌های ممکن .br .br keep_utc (bool، پیش‌فرض: false): اجبار تمام فایل‌ها و قطعه‌های جدید به نگه‌داشتن زمان‌های ایجاد و تغییر UTC منبع .br pps_inband (bool، پیش‌فرض: no): هنگامی که .I xps_inband تنظیم شده باشد، تزریق PPS در هر نمونه غیر از SAP 1/2/3 .br moovpad (uint، پیش‌فرض: 0): درج باکس free با اندازه مشخص پس از moov برای ویرایش درجا در آینده .br cmaf (enum، پیش‌فرض: no): استفاده از رهنمودهای CMAF (فعال کردن mvex،‏ truns_first،‏ strun،‏ straf،‏ tfdt_traf،‏ chain_sidx و محدود کردن subs_sidx به \-1 یا 0) .br * no: عدم اعمال CMAF .br * cmfc: استفاده از دستورالعمل‌های CMAF cmfc .br * cmf2: استفاده از دستورالعمل‌های CMAF cmf2 (فعال‌سازی nofragdef) .br .br pad_sparse (bool، پیش‌فرض: true): تزریق نمونه بدون داده (اندازه 0) جهت حفظ مدت‌زمان در قطعه‌های متنی پراکنده و فراداده نامشخص .br force_dv (bool، پیش‌فرض: false): اجبار به انواع مدخل نمونه DV حتی زمانی که سازگاری با AVC/HEVC سیگنال‌دهی شده باشد .br dvsingle (bool، پیش‌فرض: false): نادیده‌گرفتن نمایه 8 مربوط به DolbyVision در حالت xps inband اگر نمایه 5 از پیش تنظیم شده باشد .br tsalign (bool، پیش‌فرض: true): فعال‌سازی تراز مجدد خط زمانی به 0 برای نمونه اول \- در صورت false، زمان‌بندی اصلی با یک ویرایش خالی (احتمالاً طولانی) در ابتدا حفظ می‌شود .br chapm (enum، پیش‌فرض: both): حالت ذخیره‌سازی فصل .br * off: غیرفعال‌سازی فصل‌ها .br * tk: استفاده از قطعه فصل (به سبک QT) .br * udta: استفاده از فصل‌های باکس داده‌های کاربر (user-data) .br * both: استفاده از هر دو قطعه فصل و udta .br .br patch_dts (bool، پیش‌فرض: false): اصلاح مدت‌زمان نمونه‌های قبلی زمانی که dts به‌صورت یکنواخت افزایش نمی‌یابد .br uncv (enum، پیش‌فرض: prof): استفاده از uncv (استاندارد ISO 23001-17) برای ویدیوی خام .br * off: غیرفعال (همواره در هنگام میکس به QT چنین است) .br * gen: فعال، عدم نوشتن نمایه .br * prof: فعال و نوشتن نمایه در صورت مشخص بودن .br * tiny: فعال و نوشتن نسخه کاهش‌یافته در صورت مشخص بودن و سازگار بودن نمایه .br .br trunv1 (bool، پیش‌فرض: false): اجبار به استفاده از نسخه 1 در trun بدون در نظر گرفتن نوع رسانه یا برند CMAF .br rsot (bool، پیش‌فرض: false): تزریق اطلاعات مازاد زمان‌بندی نمونه در صورت وجود .br sfrag_tolerance (uint، پیش‌فرض: 0): شروع قطعه روی SAP در صورتی که قطعه قبلی کوتاه‌تر از درصد تعیین‌شده از cdur نباشد .br scte35 (enum، پیش‌فرض: auto): سیگنال‌دهی SCTE-35 .br * auto: مقدار \(aqxmlbin\(aq یا \(aqevte\(aq بسته به ورودی .br * xmlbin: جریان رویداد برون‌باندی (MPD) به همراه xml+bin (توصیه‌شده) .br * inband: باکس‌های درون‌باندی emsg .br * all: سیگنال‌دهی در تمام مکان‌های شناسایی‌شده .br * none: بدون EventStream یا باکس‌های emsg .br .br auto_reorder (bool، پیش‌فرض: false): مرتب‌سازی مجدد قطعه‌ها در moov (ابتدا ویدیو، سپس صدا، سپس متن و در نهایت سایر موارد) .br .br.SH rfqcp .LP .br توضیحات: بازفریم‌ساز QCP .br .br این فیلتر فایل‌ها/داده‌های QCP را تجزیه کرده و فریم‌ها و PID صوتی متناظر را خروجی می‌دهد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT)):" .LP .br index (dbl، پیش‌فرض: 1.0): طول پنجره نمایه‌سازی .br .br .SH rfh263 .LP .br توضیحات: بازفریم‌ساز H263 .br .br این فیلتر فایل‌ها/داده‌های H263 را تجزیه کرده و فریم‌ها و PID تصویری متناظر را خروجی می‌دهد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT)):" .LP .br fps (frac، پیش‌فرض: 15000/1000): نرخ فریم واردسازی .br index (dbl، پیش‌فرض: 1.0): طول پنجره نمایه‌سازی .br notime (bool، پیش‌فرض: false): نادیده گرفتن برچسب‌های زمان ورودی، بازسازی از 0 .br .br .SH rfmpgvid .LP .br توضیحات: بازفریم‌ساز M1V/M2V/M4V .br .br این فیلتر فایل‌ها/داده‌های ویدیویی MPEG-1/2 و MPEG-4 part 2 را تجزیه کرده و فریم‌ها و PID ویدیویی متناظر را خروجی می‌دهد. .br نکته: این فیلتر از آفست‌های منفی CTS استفاده می‌کند: CTS صحیح است، اما ممکن است DTS در برخی فریم‌ها بزرگ‌تر از CTS باشد. .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT)):" .LP .br fps (frac، پیش‌فرض: 0/1000): نرخ فریم واردسازی (مقدار 0 به‌طور پیش‌فرض از FPS جریان بیت یا 25 هرتز استفاده می‌کند) .br index (dbl، پیش‌فرض: -1.0): طول پنجره نمایه‌سازی. اگر 0 باشد، جریان بیت برای مدت‌زمان بررسی (probe) نمی‌شود. یک مقدار منفی در صورتی که فایل منبع بزرگ‌تر از 20M باشد از نمایه‌سازی صرف‌نظر می‌کند (سرعت واردکننده‌ها را کاهش می‌دهد)، مگر اینکه دستوری برای پخش با محدوده شروع > 0 صادر شود .br vfr (bool، پیش‌فرض: false): تنظیم واردسازی با نرخ فریم متغیر .br importer (bool، پیش‌فرض: false): سازگاری با واردکننده قدیمی، نمایش نتایج واردسازی .br notime (bool، پیش‌فرض: false): نادیده گرفتن برچسب‌های زمان ورودی، بازسازی از 0 .br .br .SH nhntr .LP .br توضیحات: خواننده NHNT .br .br این فیلتر فایل‌ها/داده‌های NHNT را می‌خواند تا فریم‌ها و PID رسانه تولید کند. .br مستندات NHNT در نشانی https://wiki.gpac.io/xmlformats/NHNT-Format در دسترس است .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT)):" .LP .br reframe (bool، پیش‌فرض: false): اجبار به تجزیه مجدد محتوای ارجاع‌شده .br index (dbl، پیش‌فرض: 1.0): طول پنجره نمایه‌سازی .br .br .SH nhmlr .LP .br توضیحات: خواننده NHML .br .br این فیلتر فایل‌ها/داده‌های NHML را می‌خواند تا فریم‌ها و PID رسانه تولید کند. .br مستندات NHML در نشانی https://wiki.gpac.io/xmlformats/NHML-Format در دسترس است .br .br .SH "گزینه‌ها (تخصصی) (OPTIONS (EXPERT)):" .LP .br reframe (bool، پیش‌فرض: false): اجبار به تجزیه مجدد محتوای ارجاع‌شده .br index (dbl، پیش‌فرض: 1.0): طول پنجره نمایه‌سازی .br .br .SH rfnalu .LP .br توضیحات: بازفریم‌ساز AVC/HEVC .br .br این فیلتر فایل‌ها/داده‌های AVC|H264 و HEVC را تجزیه کرده و فریم‌ها و PID ویدیویی متناظر را خروجی می‌دهد. .br این فیلتر خروجی سازگار با ISOBMFF تولید می‌کند: کدهای شروع (start codes) حذف می‌شوند، فیلد طول NALU اضافه شده و پیکربندی avcC/hvcC ایجاد می‌شود. .br نکته: این فیلتر از آفست‌های منفی CTS استفاده می‌کند: CTS صحیح است، اما ممکن است DTS در برخی فریم‌ها بزرگ‌تر از CTS باشد. .br .br.SH "گزینه‌ها (تخصصی) (Options (expert)):" .LP .br fps (frac، پیش‌فرض: 0/1000): نرخ فریم واردسازی (0 پیش‌فرض نرخ فریم برگرفته از bitstream یا 25 Hz است) .br index (dbl، پیش‌فرض: -1.0): طول پنجره نمایه‌سازی (indexing). اگر 0 باشد، bitstream برای بررسی مدت‌زمان کاوش نمی‌شود. مقادیر منفی در صورتی که فایل مبدأ بزرگ‌تر از 20M باشد از نمایه‌سازی صرف‌نظر می‌کنند (سرعت واردکننده‌ها را کاهش می‌دهد)، مگر اینکه پخش با محدوده شروع > 0 صادر شود .br explicit (bool، پیش‌فرض: false): استفاده از واردسازی لایه‌ای صریح (SVC/LHVC) .br force_sync (bool، پیش‌فرض: false): اجبار به ایجاد نقاط همگام‌سازی روی نمونه‌های غیر IDR با برش‌های I (غیرمنطبق با استاندارد) .br strict_poc (enum، پیش‌فرض: off): به تاخیر انداختن خروجی فریم یک GOP کامل به منظور اطمینان از صحت اطلاعات CTS هنگام تغییر ناگهانی POC .br * off: غیرفعال‌سازی بافرینگ GOP .br * on: فعال‌سازی بافرینگ GOP، با فرض عدم وجود خطا در POC .br * error: فعال‌سازی بافرینگ GOP و تلاش برای شناسایی فریم‌های مفقودشده .br .br nosei (bool، پیش‌فرض: false): حذف تمام پیام‌های sei .br nosvc (bool، پیش‌فرض: false): حذف تمام داده‌های SVC/MVC/LHVC .br novpsext (bool، پیش‌فرض: false): حذف تمام افزونه‌های VPS .br importer (bool، پیش‌فرض: false): سازگاری با واردکننده قدیمی، نمایش نتایج واردسازی .br nal_length (uint، پیش‌فرض: 4): تنظیم تعداد بایت‌های مورد استفاده برای کدگذاری فیلد طول: 1، 2 یا 4 .br subsamples (bool، پیش‌فرض: false): واردسازی اطلاعات زیرنمونه‌ها (subsamples) .br deps (bool، پیش‌فرض: false): واردسازی اطلاعات وابستگی نمونه‌ها .br refs (bool، پیش‌فرض: false): واردسازی فهرست تصویر مرجع نمونه (در حال حاضر تنها برای HEVC و VVC) .br seirw (bool، پیش‌فرض: true): بازنویسی پیام‌های sei در AVC برای محدودیت‌های ISOBMFF .br audelim (bool، پیش‌فرض: false): نگه‌داشتن جداکننده Access Unit در بار مفید (payload) .br keepfiller (bool، پیش‌فرض: false): نگه‌داشتن واحدهای پُرکننده NAL در خروجی .br notime (bool، پیش‌فرض: false): نادیده‌گرفتن برچسب‌های زمانی ورودی، بازسازی از 0 .br dv_mode (enum، پیش‌فرض: auto): سیگنال‌دهی برای DolbyVision .br * none: هرگز پروفایل DV سیگنال‌دهی نشود .br * auto: سیگنال‌دهی پروفایل DV در صورت یافتن RPU یا EL .br * clean: عدم سیگنال‌دهی و حذف واحدهای NAL مربوط به RPU و EL .br * single: سیگنال‌دهی پروفایل DV در صورت یافتن RPU و حذف واحدهای NAL مربوط به EL .br .br dv_profile (uint، پیش‌فرض: 0): پروفایل برای DolbyVision (پروفایل‌های تعریف‌شده در حال حاضر 4، 5، 7، 8، 9 هستند)، مقدار 0 برای تشخیص خودکار .br dv_compatid (enum، پیش‌فرض: auto): شناسه سازگاری متقابل برای DolbyVision .br * auto: تشخیص خودکار .br * none: بدون سازگاری متقابل .br * hdr10: استاندارد CTA HDR10، مطابق با مشخصات EBU TR 03 .br * bt709: استاندارد SDR BT.709 .br * hlg709: گاموت رنگی HLG BT.709 در ITU-R BT.2020 .br * hlg2100: گاموت رنگی HLG BT.2100 در ITU-R BT.2020 .br * bt2020: استاندارد SDR BT.2020 .br * brd: دیسک بلوری اولترا اچ‌دی HDR (Ultra HD Blu-ray Disc HDR) .br .br bsdbg (enum، پیش‌فرض: off): اشکال‌زدایی تحلیل NAL در لاگ‌های media@debug .br * off: غیرفعال .br * on: فعال .br * full: فعال به همراه تخلیه تعداد بیت‌ها .br .br .br .SH m2psdmx .LP .br توضیحات: تفکیک‌کننده (demultiplexer) MPEG PS .br .br این فیلتر جریان‌های برنامه MPEG-2 را برای تولید PIDها و فریم‌های رسانه‌ای تفکیک می‌کند. .br .br بدون گزینه .br .br .SH avidmx .LP .br توضیحات: تفکیک‌کننده (demultiplexer) AVI .br .br این فیلتر فایل‌های AVI را برای تولید PIDها و فریم‌های رسانه‌ای تفکیک می‌کند. .br .br .SH "گزینه‌ها (تخصصی) (Options (expert)):" .LP .br fps (frac، پیش‌فرض: 1/0): نرخ فریم واردسازی، مقدار پیش‌فرض همان نرخ فریم AVI است .br importer (bool، پیش‌فرض: false): سازگاری با واردکننده قدیمی، نمایش نتایج واردسازی .br noreframe (bool، پیش‌فرض: false): نادیده‌گرفتن بازقاب‌بندی‌کننده رسانه (media reframer) .br .br.SH txtin .LP .br توضیحات: بارگذار زیرنویس .br .br این فیلتر داده‌های زیرنویس را از PID ورودی خوانده تا فریم‌های زیرنویس را روی یک PID واحد تولید کند. .br این فیلتر از قالب‌های زیر پشتیبانی می‌کند: .br * SRT: https://en.wikipedia.org/wiki/SubRip .br * WebVTT: https://www.w3.org/TR/webvtt1 .br * TTXT: https://wiki.gpac.io/xmlformats/TTXT-Format-Documentation .br * QT 3GPP Text XML (TexML): برای Apple QT6، احتمالاً منسوخ‌شده .br * TTML: https://www.w3.org/TR/ttml2 .br * SUB: یک زیرنویس در هر خط با قالب‌بندی {start_frame}{end_frame}text .br * SSA (Substation Alpha): پشتیبانی اولیه از تجزیه برای فایل‌های رایج .br .br فایل‌های ورودی باید در قالب UTF-8 یا UTF-16، همراه با یا بدون BOM باشند. قالب فریم داخلی عبارت است از: .br * WebVTT (و srt در صورت تمایل): ISO/IEC 14496-30 VTT cues .br * TTML: زیرنویس‌های ISO/IEC 14496-30 XML .br * stxt و sbtt: جریان متنی و زیرنویس‌های متنی ISO/IEC 14496-30 .br * سایر موارد: 3GPP/QT Timed Text .br .br .SH "پشتیبانی از TTML (TTML Support)" .LP .br اگر گزینهٔ .I ttml_split تنظیم شده باشد، سند TTML با بررسی تمام زیرنویس‌های دارای همپوشانی در body، به بخش‌های زمانی مستقل تقسیم می‌شود. .br دوره‌های خالی در TTML منجر به اسناد TTML خالی می‌شوند، یا اگر گزینهٔ .I no_empty تنظیم شده باشد، نادیده گرفته خواهند شد. .br .br اولین نمونه دارای یک CTS تخصیص‌یافته است که توسط .I ttml_cts مشخص می‌شود: .br - صورت کسر برابر با \-2 نشان می‌دهد که نخستین CTS برابر با 0 است .br - صورت کسر برابر با \-1 نشان می‌دهد که نخستین CTS برابر با اولین زمان فعال در سند است .br - صورت کسر >= 0 نشان‌دهندهٔ CTS مورد استفاده برای نمونهٔ نخست است .br .br هنگامی که تقسیم‌بندی TTML غیرفعال باشد، مدت‌زمان نمونهٔ TTML توسط .I ttml_dur (در صورتی که 0 نباشد) مشخص می‌شود، یا برابر با مدت‌زمان سند تنظیم می‌گردد .br .br به‌طور پیش‌فرض، منابع رسانه‌ای همان‌گونه که در اسناد TTML2 تعریف شده‌اند حفظ می‌شوند. .br .br می‌توان از .I ttml_embed برای جاسازی منابع موجود در یا درون نمونهٔ TTML استفاده کرد: .br - برای ، ،