نام (NAME)

tvtime.xml - پرونده پیکربندی برنامه tvtime

خلاصه پرونده (SYNOPSIS)

~/.tvtime/tvtime.xml
/etc/tvtime/tvtime.xml

توضیحات (DESCRIPTION)

پرونده tvtime.xml پرونده اصلی پیکربندی برای tvtime است. این پرونده شامل تمام تنظیمات پیش‌فرض و کلیدهای میانبر است. این پرونده در زمان اجرا توسط tvtime به‌روزرسانی می‌شود تا تنظیمات را برای اجرای بعدی برنامه حفظ کند. بنابراین، نباید در حالی که tvtime در حال اجراست این پرونده را ویرایش کنید، در غیر این صورت تغییرات شما ممکن است رونویسی و پاک شوند.

ساختار کلی پرونده به صورت زیر است:

<?xml version="1.0"?>
<!DOCTYPE tvtime PUBLIC "-//tvtime//DTD tvtime 1.0//EN"
  "http://tvtime.sourceforge.net/DTD/tvtime1.dtd">
<tvtime xmlns="http://tvtime.sourceforge.net/DTD/">
</tvtime>

برای DTD و اطلاعات بیشتر درباره پرونده‌های پیکربندی XML به نشانی زیر مراجعه کنید: http://tvtime.sourceforge.net/DTD

گزینه‌ها (OPTIONS)

برنامه tvtime تعداد بسیار زیادی گزینه ارائه می‌دهد. برچسب‌های <option> باید در برچسب <tvtime> محصور شوند.

فهرست زیر شامل تمام گزینه‌ها، مقادیر پیش‌فرض آن‌ها و شرح عملکردشان است:

<option name="Verbose" value="0"/>

اگر این گزینه روی 1 تنظیم شود، tvtime در حالت پرجزئیات اجرا می‌شود که در آن پیام‌های اطلاعاتی و هشدار در خروجی خطای استاندارد چاپ می‌شوند. در غیر این صورت فقط پیام‌های خطای بحرانی نمایش داده می‌شوند.

<option name="V4LDevice" value="/dev/video0"/>

دستگاه video4linux مورد استفاده را تعیین می‌کند. مقدار پیش‌فرض /dev/video0 است.

<option name="V4LInput" value="0"/>

شماره ورودی video4linux را تعیین می‌کند. مقدار پیش‌فرض 0 است. اکثر کارت‌ها مجموعه‌ای از ورودی‌ها را دارند؛ برای مثال در یک کارت WinTV، ورودی ۰ گیرنده تلویزیون و ورودی ۱ ورودی Composite Video است.

ورودی ویدیو را می‌توان در زمان اجرا با دستور toggle_input که معمولاً با کلید "i" فعال می‌شود نیز تغییر داد.

<option name="Norm" value="NTSC"/>

گیرنده تلویزیون را روی استاندارد تلویزیونی مشخص‌شده تنظیم می‌کند (مقدار پیش‌فرض NTSC است). مقادیر معتبر عبارتند از:

•	NTSC
•	NTSC-JP
•	SECAM
•	PAL
•	PAL-Nc
•	PAL-M
•	PAL-N
•	PAL-60

<option name="SaveAndRestorePictureSettings" value="1"/>

این گزینه مشخص می‌کند که آیا tvtime تنظیمات تصویر را به‌طور خودکار هنگام تعویض کانال یا هنگام خروج از برنامه ذخیره کند یا خیر.

<option name="AudioMode" value="stereo"/>

این گزینه آخرین حالت صوتی استفاده‌شده را ذخیره می‌کند تا در اجرای بعدی برنامه آن را بازیابی کند. مقادیر ممکن عبارتند از "mono"، "stereo"، "lang1"، "lang2" یا "sap".

<option name="AudioBoost" value="-1"/>

این گزینه میزان بلندی صدای کارت تلویزیون را بر حسب درصد ذخیره می‌کند. به طور معمول tvtime بلندی صدای کارت تلویزیون را اصلاً تغییر نمی‌دهد، اما در برخی موارد تنظیمات کارخانه قابل استفاده نیست یا توسط برنامه‌های دیگر تغییر می‌کند و می‌توان با این گزینه آن را روی یک مقدار مناسب تنظیم کرد. از -1 استفاده کنید تا صدا توسط tvtime تنظیم نشود.

<option name="ShowCC" value="0"/>

این گزینه رمزگشایی زیرنویس‌های ناشنوایان (Closed Caption) را در مناطق NTSC فعال یا غیرفعال می‌کند.

<option name="ColourInvert" value="0"/>

این گزینه وضعیت فیلتر معکوس‌سازی رنگ را تا اجرای بعدی برنامه ذخیره می‌کند.

<option name="MirrorInput" value="0"/>

این گزینه وضعیت فیلتر آینه‌ای را تا اجرای بعدی برنامه ذخیره می‌کند.

<option name="Frequencies" value="US-Cable"/>

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

•	us-cable
•	us-broadcast
•	japan-cable
•	japan-broadcast
•	europe
•	australia
•	australia-optus
•	newzealand
•	france
•	russia

<option name="NTSCCableMode" value="Standard"/>

در ایالات متحده دو استاندارد کابل NTSC انحرافی وجود دارد: IRC و HRC. در IRC، کانال‌های ۵ و ۶ در فرکانس‌های متفاوتی نسبت به حالت معمول قرار دارند؛ در HRC، علاوه بر آن تمام فرکانس‌ها ۱٫۲۵ مگاهرتز به بالا منتقل شده‌اند. مقادیر ممکن: Standard, IRC یا HRC. استانداردهای IRC و HRC به ندرت استفاده می‌شوند.

<option name="CheckForSignal" value="1"/>

بررسی سیگنال را فعال یا غیرفعال می‌کند. مگر اینکه کارت تلویزیون بسیار بی‌کیفیتی داشته باشید، دلیلی برای غیرفعال کردن این ویژگی وجود ندارد. بررسی سیگنال یک پیش‌نیاز ضروری برای جستجوی خودکار کانال‌ها است.

<option name="InputWidth" value="720"/>

وضوح افقی سیگنال ورودی V4L را تعیین می‌کند. مقدار بالاتر تصویر بهتری ارائه می‌دهد و مقدار پایین‌تر میزان پردازش محاسباتی مورد نیاز را کاهش می‌دهد. اگر پردازنده کندی دارید (حدود ۵۰۰ مگاهرتز یا کمتر)، باید از مقدار 480 یا 400 استفاده کنید. برای بالاترین کیفیت تصویر از 720 یا 768 پیکسل استفاده کنید. اکثر کارت‌های تلویزیون نمی‌توانند سیگنال ورودی را با بیش از 768 پیکسل در هر خط تصویر نمونه‌برداری کنند.

<option name="XMLTVFile" value="none"/>

نام پرونده‌ای را در اینجا وارد کنید که اطلاعات برنامه در قالب XMLTV برای نمایش در OSD از آن خوانده شود. در صورتی که نمی‌خواهید از XMLTV استفاده کنید، مقدار "none" را وارد کنید.

<option name="XMLTVLanguage" value="none"/>

زبان ترجیحی برای داده‌های XMLTV را انتخاب می‌کند. این گزینه را روی کد زبان دوحرفی بر اساس ISO 639 (مثلاً "fa" برای فارسی یا "en" برای انگلیسی) تنظیم کنید تا در صورت وجود، داده‌های XMLTV به زبان انتخابی نمایش داده شوند.

<option name="UseXDS" value="0"/>

این گزینه را روی 1 تنظیم کنید تا رمزگشایی اطلاعات برنامه XDS فعال شود. این ویژگی فقط در مناطق NTSC در دسترس است. از XDS برای انتقال اطلاعات درباره برنامه جاری (نام ایستگاه و شبکه‌ای که به آن تعلق دارد، شناسه ایستگاه و گاهی اطلاعاتی درباره برنامه در حال پخش) استفاده می‌شود.

<option name="VBIDevice" value="/dev/vbi0"/>

دستگاه VBI مورد استفاده را تعیین می‌کند.

<option name="MixerDevice" value="/dev/mixer:line"/>

دستگاه و کانال میکسر را تعیین می‌کند. قالب این تنظیمات به صورت name:channel است. کانال‌های معتبر عبارتند از:

vol, bass, treble, synth, pcm, speaker, line, mic, cd, mix, pcm2, rec, igain, ogain, line1, line2, line3, dig1, dig2, dig3, phin, phout, video, radio, monitor

<option name="Widescreen" value="0"/>

این گزینه را تنظیم کنید تا tvtime در حالت عریض ۱۶:۹ راه‌اندازی شود.

<option name="WindowGeometry" value="0x576"/>

اندازه پنجره خروجی را تعیین می‌کند. اگر عرض با ۰ مشخص شود، عرض مناسب بر اساس ارتفاع پنجره محاسبه می‌شود. برای نسبت تصویر ۴:۳ و پیکسل‌های مربعی، به طور پیش‌فرض اندازه پنجره 768×576 پیکسل استفاده می‌شود.

<option name="Overscan" value="0.0"/>

میزان برش کادر تصویر (overscan) را بر حسب درصد مشخص می‌کند. تلویزیون‌های آنالوگ معمولاً حدود ۱۰٪ استفاده می‌کنند که باعث می‌شود بخش بزرگی از تصویر دیده نشود. اگر می‌خواهید tvtime مانند یک تلویزیون عادی به نظر برسد، مقداری بین ۶٪ و ۸٪ انتخاب کنید. برای استفاده از ۸٪، این گزینه را روی 8.0 تنظیم کنید.

<option name="Fullscreen" value="0"/>

این گزینه را روی 1 تنظیم کنید تا tvtime در حالت تمام‌صفحه راه‌اندازی شود. این تنظیم هنگام خروج ذخیره شده و در اجرای بعدی بازیابی می‌شود.

<option name="AlwaysOnTop" value="0"/>

این گزینه را روی 1 تنظیم کنید تا tvtime در حالت "همیشه در بالا" اجرا شود، مشروط بر اینکه مدیر پنجره مورد استفاده از این ویژگی پشتیبانی کند. این تنظیم هنگام خروج ذخیره شده و در اجرای بعدی بازیابی می‌شود.

<option name="FullscreenPosition" value="Centre"/>

موقعیت تصویر را در حالت تمام‌صفحه تنظیم می‌کند. مقادیر ممکن: top (لبه بالای تصویر), bottom (لبه پایین تصویر) یا centre (وسط) .

<option name="FramerateMode" value="0"/>

نرخ فریمی که tvtime با آن شروع به کار می‌کند را تنظیم می‌کند. مقادیر ممکن:

0: نرخ فریم کامل، هر دو نیم‌فریم پردازش می‌شوند. نرخ فریم در NTSC برابر ۵۹٫۹۴ فریم بر ثانیه و در PAL برابر ۵۰ فریم بر ثانیه است.
1: نیم‌نرخ فریم، فقط نیم‌فریم بالایی پردازش می‌شود (TFF, Top Field First). در NTSC برابر ۲۹٫۹۷ فریم بر ثانیه و در PAL برابر ۲۵ فریم بر ثانیه.
2: نیم‌نرخ فریم، فقط نیم‌فریم پایینی پردازش می‌شود (BFF, Bottom Field First). در NTSC برابر ۲۹٫۹۷ فریم بر ثانیه و در PAL برابر ۲۵ فریم بر ثانیه.

: هر دو حالت نیم‌نرخ فریم زمانی مفید هستند که بخواهید tvtime را با یک کنسول بازی اجرا کنید. از دی‌اینترلیسر "Weave" استفاده کنید و بسته به اینکه کدام تنظیم اثرات خطوط متداخل را از بین می‌برد، TFF یا BFF را انتخاب کنید.

<option name="ApplyLumaCorrection" value="0"/>: مشخص می‌کند که آیا فیلتر تصحیح روشنایی (luma) در شروع برنامه فعال باشد یا خیر. می‌توانید این تنظیم را در زمان اجرا با کلید "c" تغییر دهید.
<option name="LumaCorrection" value="1.0"/>: شدت تصحیح روشنایی را تعیین می‌کند. با مقدار 1.0 تنها تصحیح bt8x8 فعال می‌شود در صورتی که کارت مبتنی بر bt8x8 داشته باشید. در مقادیر پایین‌تر تصویر تاریک‌تر و در مقادیر بالاتر روشن‌تر می‌شود. محدوده مجاز 0.1 تا 10.0 با گام‌های ۰٫۱ است.
<option name="QuietScreenshots" value="0"/>: بازخورد بصری هنگام گرفتن عکس از صفحه را روشن یا خاموش می‌کند. به طور معمول، هنگام ایجاد عکس از صفحه پیامی در OSD نمایش داده می‌شود. اگر می‌خواهید چندین عکس پشت سر هم بگیرید بدون اینکه اعلان قبلی در تصویر بعدی دیده شود، می‌توانید اعلان را با این ویژگی خاموش کنید.
<option name="ProcessPriority" value="-10"/>: اولویت اجرای فرآیند tvtime را تنظیم می‌کند. در حالت عادی tvtime تلاش می‌کند تا اولویت بالاتری نسبت به سایر برنامه‌ها (–10) دریافت کند. مقادیر مجاز از –20 تا 20 هستند که مقادیر پایین‌تر به معنای اولویت بالاتر است.
<option name="TimeFormat" value="%X"/>: قالب زمان را در OSD تعیین می‌کند. این مقدار رشته‌ای با همان قالب تابع strftime(3) است. مقدار پیش‌فرض از قالب زمان تنظیمات محلی‌سازی سیستم شما استفاده می‌کند.
<option name="ScreenShotDir" value="~"/>: پوشه‌ای را تعیین می‌کند که تصاویر ضبط‌شده از صفحه در آن ذخیره می‌شوند. به طور پیش‌فرض از پوشه خانگی کاربر tvtime استفاده می‌شود.
<option name="ChannelTextFG" value="0xFFFFFF00"/>
<option name="OtherTextFG" value="0xFFF5DEB3"/>: این گزینه‌ها رنگ‌های OSD را در قالب ARGB (آلفا، قرمز، سبز، آبی) تنظیم می‌کنند. مقادیر پیش‌فرض به این معنا هستند که شماره و نام کانال با رنگ زرد نمایش داده می‌شوند در حالی که سایر متون به رنگ بژ هستند. رنگ می‌تواند هم در قالب شانزده‌شانزدهی و هم در قالب ده‌دهی مشخص شود. در صورت عدم وجود مقدار برای کانال آلفا، متن کاملاً کدر (255) نمایش داده می‌شود.

مثال‌ها:: 0xffaadd, 0xff0000ff, 0xff, 0xffff, 255 255 0, 0, 16777215.

<option name="UnmuteVolume" value="-1"/>: این تنظیم میزان صدای میکسر پیش از بی‌صدا شدن را تا اجرای بعدی برنامه ذخیره می‌کند. شما نباید این مقدار را به صورت دستی تغییر دهید.
<option name="Muted" value="0"/>: این تنظیم وضعیت بی‌صدا بودن را تا اجرای بعدی برنامه ذخیره می‌کند.
<option name="MuteOnExit" value="1"/>: مشخص می‌کند که آیا tvtime میزان صدای میکسر را هنگام خروج بی‌صدا کند یا خیر. به طور معمول، میزان صدای میکسر روی ۰ تنظیم می‌شود زیرا صدای برخی از کارت‌های تلویزیون را نمی‌توان قطع کرد. اگر این امر باعث ایجاد مشکل در سایر برنامه‌های تلویزیونی می‌شود، این تنظیم را غیرفعال کنید.
<option name="ShowTaglines" value="1"/>: مشخص می‌کند که آیا tvtime یک شعار تصادفی را در عنوان پنجره نمایش دهد یا خیر. اگر ترجیح می‌دهید از آن صرف‌نظر کنید، مقدار را روی ۰ تنظیم کنید.
<option name="PrevChannel" value="2"/>: این گزینه در زمان اجرا تنظیم می‌شود تا کانال قبلی را ذخیره کند.
<option name="Channel" value="2"/>: این گزینه در زمان اجرا تنظیم می‌شود تا کانال فعلی را ذخیره کند.
<option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>: الگوریتم دی‌اینترلیس مورد استفاده را تعیین می‌کند. مقادیر مجاز:

TelevisionFull: تلویزیون: وضوح کامل
TelevisionHalf: تلویزیون: نیم‌وضوح
BlurVertical: محو کردن عمودی
BlurTemporal: محو کردن زمانی
AdaptiveSearch: جستجوی حرکتی تطبیقی
AdaptiveAdvanced: جستجوی حرکتی تطبیقی پیشرفته
AdaptiveSimple: جستجوی حرکتی تطبیقی ساده
ProgressiveTFF: پیش‌رونده: نیم‌فریم بالا ابتدا
ProgressiveBFF: پیش‌رونده: نیم‌فریم پایین ابتدا

اتصال کلیدها (BINDINGS)

فشردن کلیدها و کلیک‌های ماوس را می‌توان به دستورات tvtime اختصاص داد. توضیحات کامل همه دستورات را در tvtime-command(1) خواهید یافت.

می‌توان چندین کلید یا دکمه ماوس را به یک دستور مشترک اختصاص داد. tvtime نام‌های مستعار زیر را برای کلیدهای ویژه ارائه می‌دهد:

Up, Down, Left, Right, Insert, Home, End, PageUp, PageDown, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, Backspace, Escape, Enter, Print, Menu

در این مثال، به دستور CHANNEL_INC کلیدهای Up و k و همچنین دکمه 4 ماوس اختصاص داده شده‌اند:

<bind command="channel_inc">
  <keyboard key="up"/>
  <keyboard key="k"/>
  <mouse button="4"/>
</bind>

نویسندگان (AUTHORS)

Billy Biggs.

همچنین ببینید (SEE ALSO)

tvtime(1), tvtime-configure(1), tvtime-command(1), tvtime-scanner(1), stationlist.xml(5).