نام (NAME)

dvb-format-convert - ابزار DVBv5 برای تبدیل قالب‌های فایل

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

dvb-format-convert [OPTION]... input-file output-file

توضیحات (DESCRIPTION)

دستور dvb-format-convert ابزاری است که برای تبدیل میان قالب‌های مختلف فایل در نظر گرفته شده است. این ابزار با نسخهٔ ۵ رابط برنامه‌نویسی DVB سازگار بوده و قادر است تمامی مشخصه‌ها را در هر استانداردی که توسط درایورهای تلویزیون دیجیتال لینوکس پشتیبانی می‌شود بازنمایی کند.

در حال حاضر ۳ قالب مختلف برای ورودی پشتیبانی می‌شوند:

dvbv5 - قالب استاندارد در libdvbv5، با قابلیت نمایش تمام استانداردهای مختلف تلویزیونی؛
channel - قالب قدیمی کانال در dvb-apps، که فقط از استانداردهای ATSC، DVB-C، DVB-S و DVB-T پشتیبانی می‌کند و برای پشتیبانی از قالب s2-scan برای فایل‌های DVB-S2 و همچنین پشتیبانی از DVB-T2 گسترش یافته است.
zap - قالب قدیمی dvb-apps برای تنظیم موج (tuning)، که فقط از استانداردهای ATSC، DVB-C، DVB-S و DVB-T پشتیبانی می‌کند.

یک قالب خروجی اضافی نیز وجود دارد:

•: vdr - قالبی که توسط برنامهٔ vdr استفاده می‌شود. این قالب از تمام ویژگی‌های موجود تا نسخهٔ 2.1.6 برنامهٔ vdr پشتیبانی می‌کند.

متأسفانه قالب قدیمی zap در dvb-apps استاندارد DVB را ذخیره نمی‌کند؛ بنابراین، هرگونه تبدیل به و/یا از این قالب به یک پارامتر اضافی برای مشخص کردن سیستم تحویل (delivery system) نیاز دارد.

گزینه‌ها (OPTIONS)

گزینه‌های زیر معتبر هستند:
-I, --input-format=format: قالب فایل ورودی. قالب‌های ورودی پشتیبانی‌شده: channel، zap و dvbv5.
-O, --output-format=format: قالب فایل خروجی. قالب‌های خروجی پشتیبانی‌شده: vdr، channel، zap و dvbv5.
-s, --delsys=system: نوع سیستم تحویل (delivery system). در صورتی که قالب ورودی یا خروجی ZAP باشد الزامی است.
-?, --help: راهنمای استفاده را نمایش می‌دهد.
--usage: پیام کوتاهی دربارهٔ نحوهٔ استفاده ارائه می‌دهد.
-V, --version: نسخهٔ برنامه را چاپ می‌کند.

مثال‌ها (EXAMPLES)

تبدیل یک فایل کانال از قالب قدیمی dvb-apps

فایلی با قالب کانال dvb-apps را می‌خواند و آن را در قالب dvbv5 می‌نویسد.

$ dvb-format-convert -I channel -O dvbv5 dvbc-channel-legacy dvbc-channel
Reading file dvbc-channel-legacy
Writing file dvbc-channel

تبدیل یک فایل dvbv5 شامل برنامه‌ها به قالب قدیمی zap در dvb-apps

فایل تولیدشده توسط dvbv5-scan در قالب dvbv5 را می‌خواند و فایل جدیدی در قالب zap مربوط به dvb-apps می‌نویسد.

$ dvb-format-convert -I dvbv5 -O zap -s dvbc/annex_a dvb_channel.conf legacy.conf
Reading file dvb_channel.conf
Writing file legacy.conf
WARNING: missing video PID while parsing entry 6 of legacy.conf
WARNING: missing video PID while parsing entry 7 of legacy.conf
WARNING: missing video PID while parsing entry 8 of legacy.conf
WARNING: missing audio PID while parsing entry 8 of legacy.conf

لطفاً توجه داشته باشید که قالب قدیمی dvb-apps فرض می‌کند هر کانال یک (و فقط یک) PID صوتی و یک (و فقط یک) PID تصویری دارد، در حالی که قالب dvbv5 از چندین PID برای هر نوع سرویس پشتیبانی می‌کند.

هشدارهای بالا برای کانال‌های صرفاً صوتی و کانال‌های صرفاً داده رخ داده‌اند:

فایل اصلی dvb_channel.conf:

[the]
        SERVICE_ID = 4
        VIDEO_PID = 42
        AUDIO_PID = 257
        PID_f1 = 768
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[quick]
        SERVICE_ID = 5
        VIDEO_PID = 288
        AUDIO_PID = 289
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[brown]
        SERVICE_ID = 7
        VIDEO_PID = 36
        AUDIO_PID = 305
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[fox]
        SERVICE_ID = 13
        VIDEO_PID = 272
        AUDIO_PID = 273
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[jumps]
        SERVICE_ID = 18
        VIDEO_PID = 368
        AUDIO_PID = 369
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[over]
        SERVICE_ID = 48
        VIDEO_PID = 336
        AUDIO_PID = 337 338 849
        PID_86 = 816
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[the]
        SERVICE_ID = 57
        AUDIO_PID = 353
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[lazy]
        SERVICE_ID = 104
        AUDIO_PID = 321
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A
[dog]
        SERVICE_ID = 252
        PID_05 = 3047 3046 3045 3044 3042
        FREQUENCY = 573000000
        MODULATION = QAM/256
        INVERSION = AUTO
        SYMBOL_RATE = 5217000
        INNER_FEC = NONE
        DELIVERY_SYSTEM = DVBC/ANNEX_A

بنابراین، برای کانال‌های دارای چندین PID، فایل تبدیل‌شدهٔ legacy.conf تنها اولین مورد را در بر خواهد داشت.

برای کانال‌های فاقد PID صوتی یا تصویری، مقدار PID=0 ذخیره خواهد شد.

این فایل خروجی برای فهرست کانال‌های بالاست:

the:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:42:257:4
quick:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:288:289:5
brown:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:36:305:7
fox:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:272:273:13
jumps:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:368:369:18
over:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:336:337:48
the:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:353:57
lazy:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:321:104
dog:573000000:INVERSION_AUTO:5217000:FEC_NONE:QAM_256:0:0:252

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها را به Linux Media Mailing List <linux-media@vger.kernel.org> ارسال کنید.

کپی‌رایت و تکثیر (COPYRIGHT)

اجازه‌نامه GPLv2: گنو GPL نسخه ۲ http://gnu.org/licenses/gpl.html.
این یک نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.