نام (NAME)

mp4track - مدیریت و تنظیم ویژگی‌های ترک‌ها (tracks) در فایل‌های ویدیویی MP4

خلاصه دستور (SYNOPSIS)

mp4track [OPTION]... [PARAMETERS]... ACTION file...

توضیحات (DESCRIPTION)

به ازای هر فایل mp4 مشخص‌شده، اقدام (ACTION) تعیین‌شده را انجام می‌دهد. مشخص کردن یک اقدام الزامی است. برخی گزینه‌ها برای برخی اقدامات کاربردی ندارند.

اقدامات (ACTIONS)

--list: فهرست کردن تمام ترک‌های موجود در mp4
--enabled BOOL: تنظیم trak.tkhd.flags (بیت فعال‌سازی)
--inmovie BOOL: تنظیم trak.tkhd.flags (بیت inMovie)
--inpreview BOOL: تنظیم trak.tkhd.flags (بیت inPreview)
--layer NUM: تنظیم trak.tkhd.layer
--altgroup NUM: تنظیم trak.tkhd.alternate_group
--volume FLOAT: تنظیم میزان صدا (trak.tkhd.volume)
--width FLOAT: تنظیم عرض تصویر (trak.tkhd.width)
--height FLOAT: تنظیم ارتفاع تصویر (trak.tkhd.height)
--language CODE: تنظیم زبان ترک (trak.mdia.mdhd.language)
--hdlrname STR: تنظیم trak.mdia.hdlr.name
--udtaname STR: تنظیم trak.udta.name.value
--udtaname-remove: حذف اتم trak.udta.name
--colr-list: فهرست کردن تمام جعبه‌های colr در mp4
--colr-add: افزودن جعبه colr به یک ترک ویدیو
--colr-set: تنظیم پارامترهای جعبه colr
--colr-remove: حذف جعبه colr از ترک
--pasp-list: فهرست کردن تمام جعبه‌های pasp در mp4
--pasp-add: افزودن جعبه pasp به یک ترک ویدیو
--pasp-set: تنظیم پارامترهای جعبه pasp
--pasp-remove: حذف جعبه pasp از ترک

پارامترها (PARAMETERS)

--track-any: اعمال روی هر یا تمام ترک‌ها
--track-index IDX: اعمال روی اندیس ترک با مقدار IDX
--track-id ID: اعمال روی شناسه ترک با مقدار ID
--colr-parms CSV: که در آن CSV به‌صورت IDX1,IDX2,IDX3 مشخص می‌شود
--colr-parm-hd: معادل با --colr-parms=1,1,1
--colr-parm-sd: معادل با --colr-parms=6,1,6
--pasp-parms CSV: که در آن CSV به‌صورت hSPACING,vSPACING مشخص می‌شود

گزینه‌ها (OPTIONS)

-z, --optimize: بهینه‌سازی فایل mp4 پس از اعمال تغییرات
-y, --dryrun: عدم ایجاد یا تغییر واقعی هرگونه فایل (اجرای آزمایشی)
-k, --keepgoing: ادامه پردازش دسته‌ای حتی پس از بروز خطاها
-o, --overwrite: بازنویسی فایل‌های موجود هنگام ایجاد
-f, --force: اجبار به بازنویسی حتی اگر فایل فقط‌خواندنی باشد
-q, --quiet: معادل با --verbose 0
-d, --debug NUM: افزایش سطح اشکال‌زدایی یا استفاده از گزینه طولانی برای تنظیم NUM
-v, --verbose NUM: افزایش میزان پرگویی خروجی یا استفاده از گزینه طولانی برای تنظیم NUM
-h, --help: چاپ راهنمای خلاصه یا استفاده از گزینه طولانی برای راهنمای مبسوط
--version: چاپ اطلاعات نسخه و خروج

سطوح اشکال‌زدایی (DEBUG LEVELS) (برای ورودی/خروجی خام فایل mp4)

0: غیرفعال
1: افزودن هشدارها و خطاها (پیش‌فرض)
2: افزودن جزئیات جدول
3: افزودن مقادیر ضمنی
4: همه موارد

سطوح پرگویی (VERBOSE LEVELS)

0: تنها هشدارها و خطاها
1: پیام‌های اطلاعاتی عادی (پیش‌فرض)
2: پیام‌های اطلاعاتی با جزئیات بیشتر
3: همه موارد