.\" Man page for tvtime.xml
.\" Copyright (c) 2003, 2004  Billy Biggs
.\" German translation (c) 2004  Ingo van Lil
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH tvtime.xml 5 "Oktober 2004" "tvtime 1.0RC1"

.SH "نام (NAME)"
tvtime.xml \- پرونده پیکربندی برنامه tvtime

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

.I ~/.tvtime/tvtime.xml
.br
.I /etc/tvtime/tvtime.xml
.br

.SH "توضیحات (DESCRIPTION)"

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

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

.nf
    <?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>
.fi

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

.SH "گزینه‌ها (OPTIONS)"

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

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

.TP
<option name="Verbose" value="0"/>
اگر این گزینه روی
.IR 1
تنظیم شود،
.B tvtime
در حالت پرجزئیات اجرا می‌شود که در آن پیام‌های اطلاعاتی و هشدار در خروجی خطای استاندارد چاپ می‌شوند. در غیر این صورت فقط پیام‌های خطای بحرانی نمایش داده می‌شوند.

.TP
<option name="V4LDevice" value="/dev/video0"/>
دستگاه video4linux مورد استفاده را تعیین می‌کند. مقدار پیش‌فرض
.IR /dev/video0
است.

.TP
<option name="V4LInput" value="0"/>
شماره ورودی video4linux را تعیین می‌کند. مقدار پیش‌فرض
.IR 0
است. اکثر کارت‌ها مجموعه‌ای از ورودی‌ها را دارند؛ برای مثال در یک کارت WinTV،
.I ورودی ۰
گیرنده تلویزیون و
.I ورودی ۱
ورودی Composite Video است.

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

.TP
<option name="Norm" value="NTSC"/>
گیرنده تلویزیون را روی استاندارد تلویزیونی مشخص‌شده تنظیم می‌کند (مقدار پیش‌فرض
.IR NTSC
است).
مقادیر معتبر عبارتند از:
.TS
nokeep tab (@);
l l.
\(bu@NTSC
\(bu@NTSC\-JP
\(bu@SECAM
\(bu@PAL
\(bu@PAL\-Nc
\(bu@PAL\-M
\(bu@PAL\-N
\(bu@PAL\-60
.TE

.TP
<option name="SaveAndRestorePictureSettings" value="1"/>
این گزینه مشخص می‌کند که آیا
.B tvtime
تنظیمات تصویر را به‌طور خودکار هنگام تعویض کانال یا هنگام خروج از برنامه ذخیره کند یا خیر.

.TP
<option name="AudioMode" value="stereo"/>
این گزینه آخرین حالت صوتی استفاده‌شده را ذخیره می‌کند تا در اجرای بعدی برنامه آن را بازیابی کند. مقادیر ممکن عبارتند از "mono"، "stereo"، "lang1"، "lang2" یا "sap".

.TP
<option name="AudioBoost" value="-1"/>
این گزینه میزان بلندی صدای کارت تلویزیون را بر حسب درصد ذخیره می‌کند. به طور معمول
.B tvtime
بلندی صدای کارت تلویزیون را اصلاً تغییر نمی‌دهد، اما در برخی موارد تنظیمات کارخانه قابل استفاده نیست یا توسط برنامه‌های دیگر تغییر می‌کند و می‌توان با این گزینه آن را روی یک مقدار مناسب تنظیم کرد.
از
.IR -1
استفاده کنید تا صدا توسط
.B tvtime
تنظیم نشود.

.TP
<option name="ShowCC" value="0"/>
این گزینه رمزگشایی زیرنویس‌های ناشنوایان (Closed Caption) را در مناطق NTSC فعال یا غیرفعال می‌کند.

.TP
<option name="ColourInvert" value="0"/>
این گزینه وضعیت فیلتر معکوس‌سازی رنگ را تا اجرای بعدی برنامه ذخیره می‌کند.

.TP
<option name="MirrorInput" value="0"/>
این گزینه وضعیت فیلتر آینه‌ای را تا اجرای بعدی برنامه ذخیره می‌کند.

.TP
<option name="Frequencies" value="US-Cable"/>
جدول فرکانس مورد استفاده را انتخاب می‌کند. مقادیر ممکن:
.TS
nokeep tab (@);
l l.
\(bu@us-cable
\(bu@us-broadcast
\(bu@japan-cable
\(bu@japan-broadcast
\(bu@europe
\(bu@australia
\(bu@australia-optus
\(bu@newzealand
\(bu@france
\(bu@russia
.TE

.TP
<option name="NTSCCableMode" value="Standard"/>
در ایالات متحده دو استاندارد کابل NTSC انحرافی وجود دارد: IRC و HRC. در IRC، کانال‌های ۵ و ۶ در فرکانس‌های متفاوتی نسبت به حالت معمول قرار دارند؛ در HRC، علاوه بر آن تمام فرکانس‌ها ۱٫۲۵ مگاهرتز به بالا منتقل شده‌اند.
مقادیر ممکن:
.IR Standard ,
.IR IRC " یا "
.IR HRC .
استانداردهای IRC و HRC به ندرت استفاده می‌شوند.

.TP
<option name="CheckForSignal" value="1"/>
بررسی سیگنال را فعال یا غیرفعال می‌کند. مگر اینکه کارت تلویزیون بسیار بی‌کیفیتی داشته باشید، دلیلی برای غیرفعال کردن این ویژگی وجود ندارد. بررسی سیگنال یک پیش‌نیاز ضروری برای جستجوی خودکار کانال‌ها است.

.TP
<option name="InputWidth" value="720"/>
وضوح افقی سیگنال ورودی V4L را تعیین می‌کند. مقدار بالاتر تصویر بهتری ارائه می‌دهد و مقدار پایین‌تر میزان پردازش محاسباتی مورد نیاز را کاهش می‌دهد. اگر پردازنده کندی دارید (حدود ۵۰۰ مگاهرتز یا کمتر)، باید از مقدار
.IR 480 " یا " 400
استفاده کنید. برای بالاترین کیفیت تصویر از
.IR 720 " یا " 768
پیکسل استفاده کنید. اکثر کارت‌های تلویزیون نمی‌توانند سیگنال ورودی را با بیش از
.I 768
پیکسل در هر خط تصویر نمونه‌برداری کنند.

.TP
<option name="XMLTVFile" value="none"/>
نام پرونده‌ای را در اینجا وارد کنید که اطلاعات برنامه در قالب XMLTV برای نمایش در OSD از آن خوانده شود. در صورتی که نمی‌خواهید از XMLTV استفاده کنید، مقدار "none" را وارد کنید.

.TP
<option name="XMLTVLanguage" value="none"/>
زبان ترجیحی برای داده‌های XMLTV را انتخاب می‌کند. این گزینه را روی کد زبان دوحرفی بر اساس ISO 639 (مثلاً "fa" برای فارسی یا "en" برای انگلیسی) تنظیم کنید تا در صورت وجود، داده‌های XMLTV به زبان انتخابی نمایش داده شوند.

.TP
<option name="UseXDS" value="0"/>
این گزینه را روی
.IR 1
تنظیم کنید تا رمزگشایی اطلاعات برنامه XDS فعال شود. این ویژگی فقط در مناطق NTSC در دسترس است. از XDS برای انتقال اطلاعات درباره برنامه جاری (نام ایستگاه و شبکه‌ای که به آن تعلق دارد، شناسه ایستگاه و گاهی اطلاعاتی درباره برنامه در حال پخش) استفاده می‌شود.

.TP
<option name="VBIDevice" value="/dev/vbi0"/>
دستگاه VBI مورد استفاده را تعیین می‌کند.

.TP
<option name="MixerDevice" value="/dev/mixer:line"/>
دستگاه و کانال میکسر را تعیین می‌کند. قالب این تنظیمات به صورت name:channel است. کانال‌های معتبر عبارتند از:

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

.TP
<option name="Widescreen" value="0"/>
این گزینه را تنظیم کنید تا
.B tvtime
در حالت عریض ۱۶:۹ راه‌اندازی شود.

.TP
<option name="WindowGeometry" value="0x576"/>
اندازه پنجره خروجی را تعیین می‌کند. اگر عرض با ۰ مشخص شود، عرض مناسب بر اساس ارتفاع پنجره محاسبه می‌شود. برای نسبت تصویر ۴:۳ و پیکسل‌های مربعی، به طور پیش‌فرض اندازه پنجره
.I 768\[mu]576
پیکسل استفاده می‌شود.

.TP
<option name="Overscan" value="0.0"/>
میزان برش کادر تصویر (overscan) را بر حسب درصد مشخص می‌کند. تلویزیون‌های آنالوگ معمولاً حدود ۱۰٪ استفاده می‌کنند که باعث می‌شود بخش بزرگی از تصویر دیده نشود. اگر می‌خواهید
.B tvtime
مانند یک تلویزیون عادی به نظر برسد، مقداری بین ۶٪ و ۸٪ انتخاب کنید. برای استفاده از ۸٪، این گزینه را روی
.IR 8.0
تنظیم کنید.

.TP
<option name="Fullscreen" value="0"/>
این گزینه را روی
.IR 1
تنظیم کنید تا
.B tvtime
در حالت تمام‌صفحه راه‌اندازی شود. این تنظیم هنگام خروج ذخیره شده و در اجرای بعدی بازیابی می‌شود.

.TP
<option name="AlwaysOnTop" value="0"/>
این گزینه را روی
.IR 1
تنظیم کنید تا
.B tvtime
در حالت "همیشه در بالا" اجرا شود، مشروط بر اینکه مدیر پنجره مورد استفاده از این ویژگی پشتیبانی کند. این تنظیم هنگام خروج ذخیره شده و در اجرای بعدی بازیابی می‌شود.

.TP
<option name="FullscreenPosition" value="Centre"/>
موقعیت تصویر را در حالت تمام‌صفحه تنظیم می‌کند. مقادیر ممکن:
.IR "top (لبه بالای تصویر)" ,
.I "bottom (لبه پایین تصویر)"
یا
.I "centre (وسط)".

.TP
<option name="FramerateMode" value="0"/>
نرخ فریمی که
.B tvtime
با آن شروع به کار می‌کند را تنظیم می‌کند. مقادیر ممکن:
.RS
.TP 4
.I 0
نرخ فریم کامل، هر دو نیم‌فریم پردازش می‌شوند. نرخ فریم در NTSC برابر ۵۹٫۹۴ فریم بر ثانیه و در PAL برابر ۵۰ فریم بر ثانیه است.

.TP
.I 1
نیم‌نرخ فریم، فقط نیم‌فریم بالایی پردازش می‌شود (TFF, Top Field First). در NTSC برابر ۲۹٫۹۷ فریم بر ثانیه و در PAL برابر ۲۵ فریم بر ثانیه.

.TP
.I 2
نیم‌نرخ فریم، فقط نیم‌فریم پایینی پردازش می‌شود (BFF, Bottom Field First). در NTSC برابر ۲۹٫۹۷ فریم بر ثانیه و در PAL برابر ۲۵ فریم بر ثانیه.
.RE
.IP
هر دو حالت نیم‌نرخ فریم زمانی مفید هستند که بخواهید
.B tvtime
را با یک کنسول بازی اجرا کنید. از دی‌اینترلیسر "Weave" استفاده کنید و بسته به اینکه کدام تنظیم اثرات خطوط متداخل را از بین می‌برد، TFF یا BFF را انتخاب کنید.

.TP
<option name="ApplyLumaCorrection" value="0"/>
مشخص می‌کند که آیا فیلتر تصحیح روشنایی (luma) در شروع برنامه فعال باشد یا خیر. می‌توانید این تنظیم را در زمان اجرا با کلید "c" تغییر دهید.

.TP
<option name="LumaCorrection" value="1.0"/>
شدت تصحیح روشنایی را تعیین می‌کند. با مقدار
.I 1.0
تنها تصحیح bt8x8 فعال می‌شود در صورتی که کارت مبتنی بر bt8x8 داشته باشید. در مقادیر پایین‌تر تصویر تاریک‌تر و در مقادیر بالاتر روشن‌تر می‌شود. محدوده مجاز
.IR 0.1 " تا " 10.0
با گام‌های ۰٫۱ است.

.TP
<option name="QuietScreenshots" value="0"/>
بازخورد بصری هنگام گرفتن عکس از صفحه را روشن یا خاموش می‌کند. به طور معمول، هنگام ایجاد عکس از صفحه پیامی در OSD نمایش داده می‌شود. اگر می‌خواهید چندین عکس پشت سر هم بگیرید بدون اینکه اعلان قبلی در تصویر بعدی دیده شود، می‌توانید اعلان را با این ویژگی خاموش کنید.

.TP
<option name="ProcessPriority" value="-10"/>
اولویت اجرای فرآیند
.BR tvtime
را تنظیم می‌کند. در حالت عادی
.B tvtime
تلاش می‌کند تا اولویت بالاتری نسبت به سایر برنامه‌ها
.RI ( \[en]10 )
دریافت کند. مقادیر مجاز از
.IR \[en]20 " تا " 20
هستند که مقادیر پایین‌تر به معنای اولویت بالاتر است.

.TP
<option name="TimeFormat" value="%X"/>
قالب زمان را در OSD تعیین می‌کند. این مقدار رشته‌ای با همان قالب تابع
.BR strftime (3)
است. مقدار پیش‌فرض از قالب زمان تنظیمات محلی‌سازی سیستم شما استفاده می‌کند.

.TP
<option name="ScreenShotDir" value="~"/>
پوشه‌ای را تعیین می‌کند که تصاویر ضبط‌شده از صفحه در آن ذخیره می‌شوند. به طور پیش‌فرض از پوشه خانگی کاربر
.BR tvtime
استفاده می‌شود.

.TP
.PD 0
<option name="ChannelTextFG" value="0xFFFFFF00"/>
.TP
.PD
<option name="OtherTextFG" value="0xFFF5DEB3"/>
این گزینه‌ها رنگ‌های OSD را در قالب ARGB (آلفا، قرمز، سبز، آبی) تنظیم می‌کنند. مقادیر پیش‌فرض به این معنا هستند که شماره و نام کانال با رنگ زرد نمایش داده می‌شوند در حالی که سایر متون به رنگ بژ هستند.
رنگ می‌تواند هم در قالب شانزده‌شانزدهی و هم در قالب ده‌دهی مشخص شود. در صورت عدم وجود مقدار برای کانال آلفا، متن کاملاً کدر
.RI ( 255 )
نمایش داده می‌شود.

.RS
.TP 10
مثال‌ها:
.IR 0xffaadd ,
.IR 0xff0000ff ,
.IR 0xff ,
.IR 0xffff ,
.IR "255 255 0" ,
.IR 0 ,
.IR 16777215 .
.RE

.TP
<option name="UnmuteVolume" value="-1"/>
این تنظیم میزان صدای میکسر پیش از بی‌صدا شدن را تا اجرای بعدی برنامه ذخیره می‌کند. شما نباید این مقدار را به صورت دستی تغییر دهید.

.TP
<option name="Muted" value="0"/>
این تنظیم وضعیت بی‌صدا بودن را تا اجرای بعدی برنامه ذخیره می‌کند.

.TP
<option name="MuteOnExit" value="1"/>
مشخص می‌کند که آیا
.B tvtime
میزان صدای میکسر را هنگام خروج بی‌صدا کند یا خیر. به طور معمول، میزان صدای میکسر روی ۰ تنظیم می‌شود زیرا صدای برخی از کارت‌های تلویزیون را نمی‌توان قطع کرد. اگر این امر باعث ایجاد مشکل در سایر برنامه‌های تلویزیونی می‌شود، این تنظیم را غیرفعال کنید.

.TP
<option name="ShowTaglines" value="1"/>
مشخص می‌کند که آیا
.B tvtime
یک شعار تصادفی را در عنوان پنجره نمایش دهد یا خیر. اگر ترجیح می‌دهید از آن صرف‌نظر کنید، مقدار را روی ۰ تنظیم کنید.

.TP
<option name="PrevChannel" value="2"/>
این گزینه در زمان اجرا تنظیم می‌شود تا کانال قبلی را ذخیره کند.

.TP
<option name="Channel" value="2"/>
این گزینه در زمان اجرا تنظیم می‌شود تا کانال فعلی را ذخیره کند.

.TP
<option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>
الگوریتم دی‌اینترلیس مورد استفاده را تعیین می‌کند. مقادیر مجاز:

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

.SH "اتصال کلیدها (BINDINGS)"

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

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

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

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

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

.SH "نویسندگان (AUTHORS)"

Billy Biggs.

.SH "همچنین ببینید (SEE ALSO)"

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