گزینه‌های دستگاه (Device options)

-a number

--adapter-num number

انتخاب یک دستگاه DVB دیگر برای ضبط سیگنال (/dev/dvb/adapterN). پیش‌فرض adapter 0 است.

-i number

--frontend-id number

انتخاب یک frontend دیگر بر روی دستگاه DVB (/dev/dvb/adapterN/frontendM). بیشتر دستگاه‌ها تنها یک frontend دارند. پیش‌فرض frontend 0 است.

-d number

--demux-id number

انتخاب یک demultiplexer دیگر بر روی دستگاه DVB (/dev/dvb/adapterN/demuxM). بیشتر دستگاه‌ها تنها یک demultiplexer دارند. پیش‌فرض demultiplexer 0 است.

-r number

--dvr-id number

انتخاب یک رابط DVR دیگر بر روی دستگاه DVB (/dev/dvb/adapterN/dvrM). بیشتر دستگاه‌ها تنها یک رابط DVR دارند. پیش‌فرض رابط DVR 0 است.

-T

--ts

رمزگشایی یک MPEG-2 Transport Stream از ورودی استاندارد به جای باز کردن یک دستگاه DVB. این گزینه عمدتاً برای اشکال‌زدایی در نظر گرفته شده است.

از آنجا که Transport Streamها می‌توانند شامل چندین برنامه باشند، شما همچنان باید یک یا چند نام ایستگاه را مشخص کنید، تا zvbi-atsc-cc آن‌ها را در یک فایل پیکربندی کانال جستجو کند و Program ID جریان یا جریان‌های ابتدایی ویدیویی (video elementary streams) که باید استخراج کند را تعیین نماید. همچنین باید گزینه --atsc را اضافه کنید تا مشخص شود این یک ATSC TS است و برنامه باید انتظار یک فایل پیکربندی کانال azap را داشته باشد، که در غیر این صورت از قابلیت‌های دستگاه DVB استنباط می‌شود.

گزینه‌های تنظیم فرکانس (Tuning options)

-e file name

--channel-conf file name

برای تنظیم روی یک ایستگاه تلویزیونی، zvbi-atsc-cc به یک فایل پیکربندی کانال نیاز دارد. ما از فایل پیکربندی ابزار تنظیم azap از بسته linuxtv-dvb-apps استفاده می‌کنیم. می‌توانید آن را با استفاده از ابزار scan از همان بسته ایجاد کنید.

فایل پیکربندی کانال azap یک فایل متنی است که در هر سطر یک ایستگاه را فهرست می‌کند. هر سطر شامل شش فیلد است که با دونقطه (:) از هم جدا شده‌اند: نام ایستگاه، فرکانس ترانسپوندر بر حسب هرتز (Hz)، مدولاسیون مورد استفاده (8VSB، 16VSB، QAM_64، QAM_256)، شناسه PID جریان ویدیو، شناسه PID جریان صوتی، و شناسه سرویس (service ID). خطوط خالی و خطوطی که با علامت پوند (#) آغاز می‌شوند، نادیده گرفته خواهند شد.

این گزینه یک فایل پیکربندی کانال دیگر را انتخاب می‌کند. پیش‌فرض عبارت است از:

$HOME/.azap/channels.conf

-L --list

فهرست کردن تمام ایستگاه‌های موجود در فایل پیکربندی کانال و فرکانس ترانسپوندر آن‌ها.

-n station name

--station station name

ایستگاهی که باید روی آن تنظیم شود. معمولاً می‌توان از -n صرف‌نظر کرد.

دستور zvbi-atsc-cc می‌تواند زیرنویس چند ایستگاه را به طور همزمان ضبط کند، به شرطی که فرکانس ترانسپوندر مشترکی داشته باشند. برای فعال‌سازی این قابلیت، کافی است چند نام ایستگاه را در خط فرمان مشخص کنید.

گزینه‌های زیرنویس (Caption options)

با استفاده از گزینه‌های caption و XDS مشخص می‌کنید که zvbi-atsc-cc کدام داده‌ها را باید استخراج کند. اگر چندین نام ایستگاه مشخص شده باشد، این گزینه‌ها بر روی نام ایستگاه بعدی اعمال می‌شوند. باید برای هر ایستگاه حداقل یکی از این گزینه‌ها را مشخص کنید.

-c --cc

چاپ هرگونه زیرنویس دریافتی در خروجی استاندارد.

-C file name

--cc-file file name

الحاق هرگونه زیرنویس دریافتی به فایل مشخص‌شده.

-l number

--channel number

چاپ کانال 1، 2، 3 یا 4 زیرنویس NTSC Closed Caption در خروجی استاندارد.

-1 ... -4 file name

--cc1-file ... --cc4-file file name

فیلتر کردن کانال‌های NTSC Closed Caption از CC1 تا CC4 و الحاق متن به فایل مشخص‌شده. سرویس CC1 سرویس اصلی و CC3 سرویس فرعی زیرنویس است. اگر هر دو سرویس مخابره شوند، معمولاً CC1 حاوی زیرنویس انگلیسی و CC3 حاوی زیرنویس اسپانیایی است.

-5 ... -8 file name

--t1-file ... --t4-file file name

فیلتر کردن سرویس متنی NTSC از T1 تا T4 و الحاق متن به فایل مشخص‌شده.

-9 ... -0 file name

--s1-file ... --s2-file file name

فیلتر کردن سرویس DTVCC شماره 1 یا 2 و الحاق متن به فایل مشخص‌شده. سرویس 1 سرویس اصلی و سرویس 2 سرویس فرعی زیرنویس است. اگر هر دو سرویس مخابره شوند، معمولاً سرویس 1 حاوی زیرنویس انگلیسی و سرویس 2 حاوی زیرنویس اسپانیایی خواهد بود.

ایستگاه‌های تلویزیون دیجیتال موظف هستند کدهای زبان و سایر اطلاعات مربوط به سرویس‌های زیرنویس موجود را مخابره کنند، اما این موارد در حال حاضر ارزیابی نمی‌شوند. zvbi-atsc-cc متونی را که به نظر نمی‌رسد زیرنویس باشند، مانند نوار اعلان‌های خبری (tickers) یا متون چاپ‌شده به صورت عمودی را فیلتر می‌کند.

-b --no-webtv

عدم چاپ پیوندهای WebTV.

-m --timestamps

افزودن برچسب‌های زمانی YYYYMMDDHHMMSS به ابتدای سطرهای زیرنویس. این زمان بر اساس زمان سیستم در منطقه زمانی UTC هنگام دریافت متن است؛ به طور خاص، کد Carriage Return یا Pop-On که مسئول چاپ سطر بوده است.

-S --stream-time

-Sdate --stream-time=date

افزودن برچسب‌های زمانی YYYYMMDDHHMMSS به ابتدای سطرهای زیرنویس که از روی برچسب‌های زمانی ارسالی در جریان ویدیو تولید شده‌اند. اگر date مشخص شده باشد (که آن هم در قالب YYYYMMDDHHMMSS است)، به برچسب‌های زمانی افزوده می‌شود؛ در غیر این صورت شمارنده از 0001-01-01 00:00:00 آغاز می‌شود.

-s --sentences

چاپ زیرنویس به صورت جمله به جمله.

-j type

--format type

هنگامی که type برابر "plain" باشد، zvbi-atsc-cc متن زیرنویس و XDS را بدون هیچ نشانه‌گذاری چاپ می‌کند. هنگامی که type برابر "vt100" باشد، با درج کدهای کنترلی پایانه VT.100، رنگ پیش‌زمینه و پس‌زمینه و مشخصه‌های ایتالیک و زیرخط‌دار زیرنویس را با دقت بازتولید می‌کند. با مقدار "ntsc-cc"، خروجی ابزارهای ntsc-cc و zvbi-ntsc-cc را شبیه‌سازی می‌کند. مقدار پیش‌فرض "ntsc-cc" است.

دستور zvbi-atsc-cc از تمامی مجموعه‌های نویسه Closed Caption پشتیبانی می‌کند و آن‌ها را به کدگذاری محلی (locale) فعلی، معمولاً UTF-8، تبدیل می‌نماید.

-p --plain

مشابه با -j plain

گزینه‌های XDS (XDS options)

-x --xds

چاپ تمامی داده‌های XDS دریافت‌شده در خروجی استاندارد.

-X file name

--xds-file file name

فیلتر کردن داده‌های eXtended Data Service (نام ایستگاه، نام برنامه، رده‌بندی برنامه و غیره) و الحاق آن به صورت متن به فایل مشخص‌شده.

-f type[,type]*

--filter type[,type]*

فیلتر کردن اطلاعات خاص XDS: all، call (شناسه فراخوانی ایستگاه)، desc (خلاصه برنامه)، length، network، rating، time، timecode، timezone، title. استفاده چندباره از گزینه -f اثر تجمعی دارد. مقدار پیش‌فرض "all" است.