.\" Man page for tvtime-command .\" Copyright (c) 2003, 2004 Billy Biggs .\" .\" 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-command 1 "October 2004" "tvtime 1.0RC1" .SH "نام (NAME)" tvtime\-command \- کنترل یک فرآیند در حال اجرای tvtime .SH "خلاصه دستور (SYNOPSIS)" .B tvtime\-command .RI [\| COMMAND "\|] ..." .SH "توضیحات (DESCRIPTION)" دستور .B tvtime\-command به کاربر اجازه می‌دهد تا یک فرآیند در حال اجرای .B tvtime را با ارسال دستورها به آن کنترل کند. این ابزار از طریق یک FIFO که به عنوان یک لوله نام‌گذاری‌شده (named pipe) نیز شناخته می‌شود، با .B tvtime ارتباط برقرار می‌کند. دستورها به حروف بزرگ و کوچک حساس نیستند (case\-insensitive) و به ترتیب اجرا می‌شوند. .SH "دستورها (COMMANDS)" .TP .B AUTO_ADJUST_PICT تنظیمات تصویر (روشنایی، کنتراست، فام رنگ، غلظت رنگ) را به مقادیر پیش‌فرض آن‌ها بازمی‌گرداند. .TP .B AUTO_ADJUST_WINDOW اندازه پنجره را به‌طور خودکار متناسب با محتوای درون آن تغییر می‌دهد. این گزینه برای زمانی است که اندازه tvtime را مثلاً به یک مستطیل کشیده تغییر داده‌اید و می‌خواهید دوباره به یک کادر ۴:۳ کامل و دقیق دور محتوا برگردد. .TP .B BRIGHTNESS_DOWN میزان روشنایی (brightness) ورودی را کاهش می‌دهد. .TP .B BRIGHTNESS_UP میزان روشنایی (brightness) ورودی را افزایش می‌دهد. .TP .B CHANNEL_[0\-9] فشرده شدن یک کلید عددی روی صفحه کلید را شبیه‌سازی می‌کند. .TP .B CHANNEL_ACTIVATE_ALL تمام کانال‌های موجود در فهرست را دوباره فعال می‌کند. اگر فکر می‌کنید برخی از کانال‌ها جا افتاده‌اند، یا کانال‌های جدیدی در دسترس قرار گرفته‌اند، از این دستور برای مقداردهی اولیه مجدد فهرست کانال‌ها پیش از اجرای پویشگر (scanner) استفاده کنید. .TP .B CHANNEL_DEC / CHANNEL_DOWN یک کانال در فهرست کانال‌ها به پایین حرکت می‌کند. .TP .B CHANNEL_INC / CHANNEL_UP یک کانال در فهرست کانال‌ها به بالا حرکت می‌کند. .TP .B CHANNEL_JUMP / CHANNEL_PREV به آخرین کانالی که قبلاً مشاهده می‌کردید تغییر می‌دهد. برای جابه‌جایی سریع میان دو برنامه روی کانال‌های دور از هم مفید است. .TP .B CHANNEL_RENUMBER شماره کانال فعلی را تغییر می‌دهد. این دستور شماره کانال فعلی را با شماره‌ای که وارد می‌کنید جابه‌جا می‌کند. از این گزینه برای مرتب‌سازی فهرست شبکه‌ها بر اساس سلیقه شخصی یا موقعیت مکانی استفاده کنید. .TP .B CHANNEL_SAVE_TUNING تنظیمات دقیق فعلی فرکانس (fine tuning) را به عنوان یک کانال سفارشی در فهرست شبکه‌ها ذخیره می‌کند. .TP .B CHANNEL_SCAN از موقعیت فعلی در میان فهرست کانال‌ها پیمایش کرده و هر کانالی را که سیگنالی برای آن تشخیص داده نشود، غیرفعال می‌کند. این دستور تنها در صورتی در دسترس است که بررسی سیگنال فعال باشد. .TP .B CHANNEL_SKIP وضعیت کانال فعلی را بین فعال یا غیرفعال بودن در فهرست شبکه‌ها تغییر می‌دهد (کلید تغییر وضعیت). می‌توانید از این برای بررسی دستی کانال‌ها و فعال کردن موارد دارای سیگنال یا غیرفعال کردن شبکه‌های تکراری استفاده کنید. .TP .B COLOUR_DOWN / COLOR_DOWN تنظیم غلظت رنگ (colour) تصویر ورودی را کاهش می‌دهد. این کار تصویر را کم‌رنگ‌تر می‌کند تا جایی که سیاه و سفید شود. .TP .B COLOUR_UP / COLOR_UP تنظیم غلظت رنگ (colour) تصویر ورودی را افزایش می‌دهد. این کار به تصویر رنگ و لعاب بیشتری می‌بخشد. .TP .B CONTRAST_DOWN تنظیم کنتراست ورودی را کاهش می‌دهد. .TP .B CONTRAST_UP تنظیم کنتراست ورودی را افزایش می‌دهد. .TP .B DISPLAY_INFO منوی اطلاعات روی صفحه (OSD) را برای کانال فعلی بازنمایش می‌دهد؛ اطلاعات کانال، deinterlacer و نرخ فریم فعلی، زمان، و تنظیمات ورودی را نشان می‌دهد. .TP .B DISPLAY_MESSAGE پیامی را در امتداد پایین OSD نمایش می‌دهد. برای کارهای زمان‌بندی‌شده cron یا سایر اسکریپت‌ها جهت ارسال اعلان‌ها به کاربری که در حال اجرای tvtime است مفید است. .TP .B DOWN این دستور بسته به اینکه منو در حال حاضر فعال است یا خیر، عملکرد دوگانه حرکت به کانال بعدی (پایین) یا حرکت به پایین در منو را فراهم می‌کند. این دستور برای استفاده همراه با دستورهای LEFT، RIGHT و UP در نظر گرفته شده است. .TP .B ENTER یک دستور اینتر (Enter) مجازی ارسال می‌کند. هنگام تغییر کانال از این استفاده کنید: .br \h'4n'tvtime-command channel_1 channel_5 enter .br کانال را به 15 تغییر می‌دهد. .TP .B FINETUNE_DOWN تنظیم دقیق فرکانس (fine tuning) را برای کانال فعلی کاهش می‌دهد. .TP .B FINETUNE_UP تنظیم دقیق فرکانس (fine tuning) را برای کانال فعلی افزایش می‌دهد. .TP .B HUE_DOWN تنظیم فام رنگ (hue) ورودی را کاهش می‌دهد. .TP .B HUE_UP تنظیم فام رنگ (hue) ورودی را افزایش می‌دهد. .TP .B KEY_EVENT یک رویداد فشردن کلید ساختگی به tvtime ارسال می‌کند. این برای انجام عملیات‌های پیچیده از طریق کنترل از راه دور مفید است، زیرا می‌توانید رویدادها را به‌طور غیرمستقیم به سامانه اتصال کلیدهای داخلی tvtime هدایت کنید. .TP .B LEFT این دستور بسته به اینکه منو فعال است یا خیر، عملکرد دوگانه کاهش صدای میکسر یا دستور بازگشت در منو را فراهم می‌کند. این دستور برای استفاده به همراه دستورهای RIGHT، UP و DOWN در نظر گرفته شده است. .TP .B MENU_DOWN در حالت منو، این دستور مکان‌نما را یک مورد در منو به سمت پایین می‌برد..TP .B MENU_ENTER در حالت منو، این دستور ورودی فعلی را انتخاب کرده یا یک سطح در منو به جلو می‌رود. .TP .B MENU_EXIT در حالت منو، این دستور منو را می‌بندد. .TP .B MENU_BACK در حالت منو، این دستور یک سطح در منو به عقب بازمی‌گردد. .TP .B MENU_ENTER در حالت منو، این دستور ورودی فعلی را انتخاب کرده یا یک سطح در منو به جلو می‌رود. .TP .B MENU_UP در حالت منو، این دستور مکان‌نما را یک ورودی در منو به بالا می‌برد. .TP .B MIXER_DOWN میزان بلندی صدای دستگاه Line In را از طریق .IR /dev/mixer کاهش می‌دهد. یک پارامتر اختیاری درصد کاهش را مشخص می‌کند. .TP .B MIXER_TOGGLE_MUTE وضعیت بی‌صدا (mute) را از طریق میکسر تغییر می‌دهد، نه مانند .B TOGGLE_MUTE که این کار را از طریق کارت ضبط انجام می‌دهد. .TP .B MIXER_UP میزان بلندی صدای دستگاه Line In را از طریق .IR /dev/mixer افزایش می‌دهد. یک پارامتر اختیاری درصد افزایش را مشخص می‌کند. .TP .B NOOP دستوری برای انجام ندادن هیچ کاری. زمانی مفید است که بخواهید یکی از کلیدهای میانبر پیش‌فرض را در tvtime غیرفعال یا بی‌اثر کنید. .TP .B OVERSCAN_DOWN میزان جبران برش حاشیه‌ای (overscan) را کاهش می‌دهد. این کار بخش بیشتری از ورودی ضبط‌شده را نشان خواهد داد. .TP .B OVERSCAN_UP میزان جبران برش حاشیه‌ای (overscan) را افزایش می‌دهد. این کار بخش کمتری از ورودی ضبط‌شده را نشان خواهد داد. .TP .B PICTURE انتخاب می‌کند که کدام تنظیم تصویر (روشنایی/کنتراست/رنگ/فام) با استفاده از دستورهای .B PICTURE_UP و .B PICTURE_DOWN تغییر داده شود. .TP .B PICTURE_UP مقدار تنظیم تصویر فعلی (روشنایی/کنتراست/رنگ/فام) را افزایش می‌دهد. .TP .B PICTURE_DOWN مقدار تنظیم تصویر فعلی (روشنایی/کنتراست/رنگ/فام) را کاهش می‌دهد. .TP .B RESTART از tvtime می‌خواهد تا مجدداً راه‌اندازی شود. این دستور زمانی در منو به کار می‌رود که مقداری تغییر یافته باشد که هنوز امکان تغییر آن در زمان اجرا وجود ندارد. .TP .B RIGHT این دستور بسته به اینکه منو در حال حاضر فعال است یا خیر، قابلیت دوگانهٔ افزایش بلندی صدای میکسر یا دستور ورود به منو (menu enter) را فراهم می‌کند. این دستور باید همراه با دستورهای LEFT، UP و DOWN استفاده شود. .TP .B RUN_COMMAND به tvtime دستور اجرای یک فرمان را می‌دهد. از این می‌توان برای اجرای یک برنامه با استفاده از کلیدی در tvtime یا lirc استفاده کرد، مانند اجرای mythepg یا alevt. استفاده از tvtime-command run_command "xterm" باعث می‌شود tvtime دستور system( "xterm &" ) را فراخوانی کند. .TP .B SAVE_PICTURE_GLOBAL تنظیمات تصویر فعلی را به عنوان پیش‌فرض‌های سراسری ذخیره می‌کند. .TP .B SAVE_PICTURE_CHANNEL تنظیمات تصویر فعلی را به عنوان پیش‌فرض‌های کانال فعلی روی تیونر ذخیره می‌کند. .TP .B SCREENSHOT از .B tvtime می‌خواهد که یک تصویر از صفحه (اسکرین‌شات) بگیرد. اسکرین‌شات‌ها در دایرکتوری مشخص‌شده به عنوان دایرکتوری اسکرین‌شات در فایل پیکربندی .I tvtime.xml ذخیره می‌شوند. پیش‌فرض، دایرکتوری خانگی کاربری است که برنامه را اجرا کرده است. .TP .B SET_AUDIO_MODE این دستور یک پارامتر گرفته و حالت صوتی فعلی را تنظیم می‌کند. گزینه‌های معتبر عبارتند از "mono"، "stereo"، "sap"، "lang1" یا "lang2". .TP .B SET_DEINTERLACER این دستور یک پارامتر گرفته و روش deinterlacer فعلی را تنظیم می‌کند. گزینه‌های معتبر، نام کوتاه هر یک از deinterlacerهای موجود در tvtime هستند. .TP .B SET_FRAMERATE این دستور یک پارامتر گرفته و نرخ فریم فعلی را تنظیم می‌کند. گزینه‌های معتبر عبارتند از "full"، "top" و "bottom". .TP .B SET_FREQUENCY_TABLE این دستور یک پارامتر گرفته و جدول فرکانس فعلی را تنظیم می‌کند. .TP .B SET_FULLSCREEN_POSITION این دستور مشخص می‌کند که خروجی عریض (widescreen) در حالت تمام‌صفحه در کجای صفحه تراز شود؛ شامل top برای بالای صفحه، center برای وسط، یا bottom برای پایین. .TP .B SET_INPUT این دستور یک پارامتر گرفته و ورودی کارت ضبط (0-n) را تنظیم می‌کند. از جمله ورودی‌ها عبارتند از: تیونر، کانکتورهای کامپوزیت یا S-Video روی کارت ضبط. .TP .B SET_INPUT_WIDTH این دستور یک پارامتر گرفته و عرض ورودی فعلی را بر حسب پیکسل تعیین می‌کند. این مقدار پس از یک راه‌اندازی مجدد در tvtime اعمال خواهد شد. .TP .B SET_MATTE این دستور مَت (matte) اعمال‌شده روی خروجی را تعیین می‌کند. این کار اندازهٔ پنجرهٔ خروجی را تغییر می‌دهد و برای تماشای فیلم با نسبت 2.35:1 در یک پنجرهٔ کشیده و باریک، یا برای تماشای آن در بالای صفحه با استفاده از گزینهٔ موقعیت تمام‌صفحه مفید است. گزینه‌های معتبر در اینجا 16:9، 1.85:1، 2.35:1 یا 4:3 هستند. .TP .B SET_NORM این دستور یک پارامتر گرفته و استاندارد تلویزیونی فعلی را تنظیم می‌کند. این مقدار پس از راه‌اندازی مجدد در tvtime اعمال خواهد شد. .TP .B SET_STATION این دستور یک نام یا شمارهٔ ایستگاه را به عنوان پارامتر دریافت کرده و کانال را به ایستگاه داده‌شده تغییر می‌دهد. .TP .B SET_XMLTV_LANGUAGE کد زبان ترجیحی را برای داده‌های XMLTV تنظیم می‌کند. آرگومان می‌تواند یک کد زبان دو حرفی مطابق با ISO 639 یا یک عدد برای انتخاب یکی از زبان‌های شناخته‌شده باشد. .TP .B SHOW_DEINTERLACER_INFO یک صفحهٔ راهنما روی OSD نمایش می‌دهد که تنظیمات فعلی deinterlacer را شرح می‌دهد. .TP .B SHOW_MENU این دستور برای بالا آوردن منوی تنظیمات tvtime به کار می‌رود. .TP .B SHOW_STATS یک صفحهٔ اشکال‌زدایی را نمایش می‌دهد که آمارهای مربوط به نمونهٔ در حال اجرای tvtime را نشان می‌دهد..TP .B SLEEP این دستور تایمر خواب را تنظیم می‌کند تا به tvtime اعلام کند پس از مدت‌زمان معینی بسته شود. ارسال این دستور ابتدا این قابلیت را فعال می‌کند و ارسال مجدد آن، زمان‌سنج را تا رسیدن به مقدار بیشینه افزایش می‌دهد که در آن نقطه خاموش می‌شود. .TP .B TOGGLE_ALWAYSONTOP اگر توسط مدیر پنجرهٔ شما پشتیبانی شود، این دستور درخواست می‌کند که پنجره در وضعیت «همیشه در بالا» قرار گیرد، حالتی که هیچ پنجرهٔ دیگری نمی‌تواند روی آن قرار گیرد. .TP .B TOGGLE_ASPECT نمایش را بین حالت 4:3 و 16:9 تغییر می‌دهد. اگر یک پخش‌کنندهٔ DVD خارجی یا گیرندهٔ ماهواره‌ای را برای خروجی محتوای 16:9 آنامورفیک پیکربندی کرده‌اید، از حالت 16:9 استفاده کنید. .TP .B TOGGLE_AUDIO_MODE بین حالت‌های صوتی موجود در این کانال جابه‌جا می‌شود. ممکن است مدتی طول بکشد تا راه‌انداز در دسترس بودن حالت‌ها را شناسایی کند. .TP .B TOGGLE_BARS از .B tvtime می‌خواهد تا نوارهای رنگی را نمایش دهد. نوارهای رنگی توسط .B tvtime تولید می‌شوند و ارتباطی به کارت کپچر ندارند، بلکه صرفاً برای کمک به پیکربندی کارت گرافیک و دستگاه نمایشگر شما هستند. هنگامی که تنظیمات شما با این نوارهای رنگی درست شد، نوارهای رنگی حاصل از یک منبع ورودی مانند یک پخش‌کنندهٔ DVD خارجی را امتحان کنید و مطمئن شوید که با یکدیگر مطابقت دارند. .TP .B TOGGLE_CC نمایش اطلاعات زیرنویس (closed caption) را در پنجرهٔ .B tvtime فعال می‌کند. زیرنویس تنها در صورتی در دسترس است که خواندن VBI را در فایل پیکربندی .I tvtime.xml خود فعال کرده باشید. .TP .B TOGGLE_CHANNEL_PAL_DK برای کاربران PAL، حالت صوتی کانال فعلی را بین استانداردهای صوتی PAL-BG و PAL-DK تغییر می‌دهد. .TP .B TOGGLE_CHROMA_KILL فیلتر chroma killer را فعال یا غیرفعال می‌کند که ورودی را سیاه‌وسفید می‌سازد. هنگام تماشای یک فیلم سیاه‌وسفید برای جلوگیری از اعوجاج‌های رنگی (chrominance artifacts) مفید است. .TP .B TOGGLE_COLOR_INVERT / TOGGLE_COLOUR_INVERT فیلتر معکوس کردن رنگ را روشن یا خاموش می‌کند. این قابلیت (ظاهراً) برای کاربران شرکت کابلی استرالیایی Optus که می‌خواهند از استفاده از جعبه‌های رمزگشایی اجتناب کرده و مستقیماً با کارت کپچر خود کانال‌یابی کنند مفید است. .TP .B TOGGLE_DEINTERLACER بین روش‌های deinterlacing موجود جابه‌جا می‌شود. .TP .B TOGGLE_FULLSCREEN بین حالت تمام‌صفحه و پنجره‌ای جابه‌جا می‌شود. .TP .B TOGGLE_FRAMERATE نرخ فریمی که .B tvtime خروجی می‌دهد را تغییر می‌دهد. گزینه‌ها عبارتند از نرخ فریم کامل (هر فیلد به یک فریم deinterlace می‌شود)، نرخ فریم نیمه TFF (هر فیلد بالایی به یک فریم deinterlace می‌شود) و نرخ فریم نیمه BFF (هر فیلد پایینی به یک فریم deinterlace می‌شود). .TP .B TOGGLE_INPUT ورودی مورد استفادهٔ کارت کپچر را تعویض می‌کند. از جمله ورودی‌ها عبارتند از: تیونر، کامپوزیت، یا درگاه‌های S-Video روی کارت کپچر. .TP .B TOGGLE_MATTE بین مت‌های (matte) موجود جابه‌جا می‌شود. این کار بالا و پایین تصویر ورودی را برش می‌دهد تا به متناسب شدن پنجره با محتوای تصویر کمک کند. .TP .B TOGGLE_MIRROR فیلتر آینه‌ای (mirror) را روشن یا خاموش می‌کند که ورودی را وارون می‌کند. این قابلیت برای استفاده از tvtime با پروژکتورهای آینه‌ای مفید است، اگرچه فکر نمی‌کنم هنوز دقیقاً همان‌طور که در نظر گرفته شده کار کند زیرا خروجی OSD را وارون نمی‌کنیم. :) از بازخوردها استقبال می‌شود. .TP .B TOGGLE_MUTE وضعیت بی‌صدا را در کارت کپچر (و نه در کارت صدای شما) تغییر می‌دهد. .TP .B TOGGLE_NTSC_CABLE_MODE تنظیمات حالت کابلی NTSC را تغییر می‌دهد: حالت‌های .IR Standard ، .IR IRC " و " .I HRC در دسترس هستند. .TP .B TOGGLE_PAL_DK_AUDIO برای کاربران PAL، حالت صوتی پیش‌فرض تمام کانال‌ها را بین استانداردهای صوتی PAL-BG و PAL-DK تغییر می‌دهد. .TP .B TOGGLE_PAL_SECAM بین PAL و SECAM در کانال فعلی جابه‌جا می‌شود. این قابلیت برای مناطقی که هر دو کانال‌های PAL و SECAM را دریافت می‌کنند مفید است، به‌طوری که tvtime می‌تواند برای هر کانال به‌صورت مجزا بر روی استاندارد درست پیکربندی شود. .TP .B TOGGLE_PAUSE وارد حالت مکث می‌شود. حالت مکث یک قابلیت اشکال‌زدایی است که برای آزمایش فیلترهای deinterlacer استفاده می‌شود تا امکان مشاهدهٔ خروجی یک مجموعه فریم مشخص با deinterlacerهای مختلف را فراهم کند. .TP .B TOGGLE_PULLDOWN_DETECTION قابلیت تشخیص 2\[en]3 pulldown را برای ورودی NTSC فعال یا غیرفعال می‌کند. .TP .B TOGGLE_QUIET_SCREENSHOTS هنگامی که این گزینه فعال باشد، اسکرین‌شات‌ها روی OSD اعلام نخواهند شد. این ویژگی زمانی مفید است که قصد دارید تعداد زیادی اسکرین‌شات بگیرید و نمی‌خواهید متن نمایش داده شده تماشای تلویزیون شما را مختل کند یا در سایر اسکرین‌شات‌ها ظاهر شود. .TP .B TOGGLE_SIGNAL_DETECTION کد تشخیص سیگنال tvtime را فعال و غیرفعال می‌کند. تشخیص سیگنال قابلیت‌هایی مانند پویش کانال را فعال می‌سازد و پاسخ‌دهی را در کانال‌هایی با گیرندگی ضعیف افزایش می‌دهد، اما ممکن است تماشای ایستگاه‌هایی را که گیرندگی آن‌ها آن‌قدر ضعیف است که کارت نمی‌تواند با اطمینان آن را تشخیص دهد، غیرممکن کند. .TP .B TOGGLE_XDS کد رمزگشایی XDS برنامهٔ tvtime را فعال و غیرفعال می‌کند. از XDS برای ارسال اطلاعات مربوط به کانال از جمله نام شبکه و حروف شناسایی، و گاهی اوقات اطلاعاتی در مورد برنامهٔ در حال پخش استفاده می‌شود. این اطلاعات سپس روی OSD نشان داده شده و در فایل stationlist.xml ذخیره می‌شود. .TP .B TOGGLE_XMLTV_LANGUAGE زبانی را که باید به‌طور پیش‌فرض از فایل XMLTV نمایش داده شود، از بین زبان‌های موجود در فایل تغییر می‌دهد. .TP .B UP این دستور عملکرد دوگانهٔ کانال بعدی یا کلید جهت‌نمای بالا در منو را، بسته به اینکه منو در حال حاضر فعال باشد یا خیر، ارائه می‌دهد. این دستور باید همراه با دستورهای LEFT، RIGHT و DOWN استفاده شود. .TP .B QUIT از فرایند در حال اجرای .B tvtime می‌خواهد تا خارج شود..SH "نویسندگان (AUTHORS)" Billy Biggs, Stewart Allen. .SH "همچنین ببینید (SEE ALSO)" .BR tvtime (1), .IR tvtime.xml (5), .IR stationlist.xml (5).