.\" -*-Nroff-*- .\"" .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .TH XINE 5 2005-06-15 "The xine project" .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection .\" other parms are allowed: see man(7), man(1) .\"" .SH "نام (NAME)" xine \- یک پخش‌کننده ویدیویی آزاد .SH "مکان‌یاب منبع چندرسانه‌ای (MRL \- media resource locator)" شناسه‌های MRL مشابه URLها در مرورگر وب شما هستند. آن‌ها رسانه‌ای را که باید خوانده شود مشخص می‌کنند. شناسه‌های معتبر MRL ممکن است نام‌های ساده فایل یا یکی از موارد زیر باشند (یادداشت‌های زیر را نیز ببینید): .TP \(bu سیستم فایل (Filesystem): .br .BI file: .br .BI fifo: .br .BI stdin:/ .LP .TP \(bu لوح فشرده و دی‌وی‌دی (CD and DVD): .br .BI dvd:/[ device_name ][/ title [. part ]] .br .BI dvd:/ DVD_image_file [/ title [. part ]] .br .BI dvd:/ DVD_directory [/ title [. part ]] .br (از مسیر دایرکتوری حاوی VIDEO_TS استفاده کنید) .br .BI vcd://[ CD_image_or_device_name ][@[ letter ] number ] .br .BI vcdo:// track_number .br .BI cdda:/[ device ][/ track_number ] .LP .TP \(bu دستگاه‌های ویدیویی (Video devices): .br .BI v4l://[ tuner_device / frequency ] .br .BI v4l2:// tuner_device .br .BI dvb:// channel_number .br (کانال n\-ام در channels.conf شما) .br .BI dvb:// channel_name .br .BI dvbc:// channel_name : tuning_parameters .br .BI dvbs:// channel_name : tuning_parameters .br .BI dvbt:// channel_name : tuning_parameters .br .BI dvba:// channel_name : tuning_parameters .br .BI pvr:/ tmp_files_path ! saved_files_path ! max_page_age .br (برای WinTV PVR 250 و 350) .LP .TP \(bu شبکه (Network): .br .BI http:// host... .br .BI tcp:// host [: port ] .br .BI udp:// host [: port [?iface= interface ]] .br .BI rtp:// host [: port [?iface= interface ]] .br (درگاه پیش‌فرض برای tcp، udp و rtp عدد ۷۶۵۸ است) .br .BI smb://... .br .BI mms:// host... .br .BI pnm:// host... .br .BI rtsp:// host... "\fR (نیازمند کُدک‌های Real است)" .br .LP افزونه‌های ورودی دیگر انواع بیشتری از MRL را ارائه می‌دهند. مواردی که در بالا فهرست شده‌اند به همراه نسخه رسمی libxine در دسترس هستند. \fBنکته:\fP در جایی که نام فایل الزامی است، \fIمسیر کامل باید ارائه شود\fP \- در یک پوسته، معمولاً می‌توانید از \fB"$PWD/file"\fP یا \fB"$(pwd)/file"\fP یا \fB"\`pwd\`/file"\fP استفاده کنید، در صورتی که فایل در دایرکتوری جاری باشد. (اینکه کدام مورد کار کند به پوسته شما بستگی دارد؛ هر سه مورد در bash کار می‌کنند. همچنین، قوانین متداول کدگذاری URL اعمال می‌شوند؛ به‌ویژه `%' باید به صورت `%25' کدگذاری شود.) از نسخه 1.1.3 کتابخانه xine\-lib، شماره عنوان DVD می‌تواند 0 باشد (انتخاب ناوبری) و شماره فصل می‌تواند 0 باشد (عنوان کامل). .SS "نحو MRL دیسک تصویری (VCD MRL Syntax)" یک دستور ساده \fBvcd:/\fP مورد پیش‌فرض را (مثلاً شاید شیار ۱ یا ورودی ۰) با استفاده از دستگاه پیش‌فرض VCD (احتمالاً /dev/cdrom) اجرا می‌کند. هم مورد پیش‌فرض و هم دستگاه پیش‌فرض توسط کاربر قابل پیکربندی هستند. با این حال، امکان مشخص کردن صریح دستگاه/نام‌فایل دیسک تصویری (Video CD) و مورد به صورت مشخص در MRL نیز وجود دارد. برای مثال، \fBvcd:/dev/dvd\fP ورودی پیش‌فرض را با استفاده از دستگاه /dev/dvd مشخص می‌کند که در صورتی که این درایو DVD شما باشد و با درایو CD\-ROM شما تفاوت داشته باشد و درایو DVD شما بتواند دیسک‌های CD را پخش کند، کاربردی است. همچنین \fBvcd://test_svcd_ntsc.cue\fP فایل cue ایمیج CD روی دیسک را مشخص می‌کند. (فایل test_svcd_ntsc.bin فایل bin متناظر با آن است، اما استفاده از آن کار نخواهد کرد.) پس از نام اختیاری دستگاه یا نام فایل، می‌توانید نوع واحد را با قرار دادن یک دونقطه قبل از آن مشخص کنید. شناسه MRL که به یک دونقطه ختم شود مانند این است که اصلاً آن را اضافه نکرده باشید: نوع و شماره ورودی پیش‌فرض استفاده می‌شود. آیتم‌ها در ۴ نوع ارائه می‌شوند: "\fBTrack\fP" (شیار)، "\fBEntry\fP" (ورودی)، "\fBPlayback\fP" (پخش) و "\fBSegment\fP" (قطعه). این واحدها با حرف بزرگ ابتدای هر نوع مشخص می‌شوند: \fBT\fP، \fBE\fP، \fBP\fP، \fBS\fP، \fBs\fP. حرف بزرگ \fBS\fP در نمایش MRL نشان‌دهنده یک قطعه NTSC است در حالی که حرف کوچک \fBs\fP نشان‌دهنده یک قطعه PAL است. با این حال، هنگام وارد کردن یک MRL، بزرگی یا کوچکی این حروف اهمیتی ندارد. بسته به دیسک تصویری (Video CD)، ممکن است هیچ قطعه قابل پخشی (\fBS\fP،\fBs\fP) یا کنترل پخشی (\fBP\fP) نداشته باشید. اگر یک MRL بدهید که به یک ورودی کنترل پخش ارجاع داشته باشد اما کنترل پخشی وجود نداشته باشد، شماره پخش شما در سکوت به شماره ورودی متناظر تبدیل خواهد شد. می‌توانید موارد گوناگونی را که بر انتخاب MRLها در هنگام وجود ابهام در نام MRL اثر می‌گذارند پیکربندی کنید. گزینه \fImedia.vcd.autoplay\fP مشخص می‌کند که در صورت عدم تعیین، از چه نوع واحدی در MRL استفاده شود. تنظیم پیکربندی دیگر، \fIvcd.device\fP، دستگاه مورد استفاده را در صورت مشخص نشدن این بخش تعیین می‌کند. هنگامی که دکمه VCD را فشار می‌دهید، این کار معادل وارد کردن \fBvcd:/\fP است و بنابراین این دو تنظیم پیکربندی برای بسط دادن MRL به کار گرفته می‌شوند. چند مثال از شناسه‌های MRL در زیر آمده است. در این مثال‌ها، فرض می‌کنیم تنظیمات پیکربندی زیر اعمال شده است: .TP .BI vcd:// پخش (ناوبری) مورد پیش‌فرض (در این مورد شناسه ورودی ۰) از دستگاه پیش‌فرض (در این حالت تنظیم‌شده روی /dev/cdrom) .TP .BI vcd://@ مشابه بالا .TP .BI vcd:///dev/cdrom@ تأثیری مشابه بالا دارد زیرا دستگاه پیش‌فرض روی /dev/cdrom تنظیم شده است. .TP .BI vcd:///dev/cdrom@E0 مشابه بالا؛ اما توجه داشته باشید که این به این دلیل است که autoplay:entry تنظیم شده است که دیگر مقدار پیش‌فرض نیست. .TP .BI vcd:///dev/cdrom2@ پخش (ناوبری) مورد پیش‌فرض از /dev/cdrom2 .TP .BI vcd:///dev/cdrom2 باید مشابه بالا باشد اما در حال حاضر دچار اشکال است؟ .TP .BI vcd:///dev/cdrom2@T1 پخش شیار ۱ از /dev/cdrom2 .TP .BI vcd:///dev/cdrom@S1 پخش قطعه ۱ از /dev/cdrom. این فرض می‌کند که قطعه ۱ وجود *دارد*. برای دیدن این مورد، فهرست MRL را بررسی کنید. .TP .BI vcd://@P1 پخش مورد فهرست پخش ۱ از دستگاه پیش‌فرض. اگر کنترل پخشی وجود نداشته باشد، MRL به vcd:/@E0 تبدیل خواهد شد. مجدداً فهرست MRL را بررسی کنید تا ببینید آیا P1 وجود دارد یا خیر. .TP .BI vcd://@P1* احتمالاً مشابه بالا. .TP .BI vcd:///dev/cdrom@E1 پخش شناسه ورودی ۱ از دستگاه پیش‌فرض. .TP .BI vcd://@S0 پخش قطعه ۰ از دستگاه پیش‌فرض. .TP .BI vcd://@3 پخش شیار ۳ از دستگاه پیش‌فرض. .TP .BI vcd:///dev/cdrom2:1 پخش شیار ۱ از /dev/cdrom2. .TP .BI vcd:///tmp/ntsc.cue@ پخش مورد پیش‌فرض (E0) از /tmp/ntsc.bin. به \fB@\fP انتهایی توجه کنید. .TP .BI vcd://ntsc.cue/@E0 پخش ورودی ۰ از ntsc.bin. .TP .BI vcd:///tmp/ntsc.nrg/@E0 پخش ورودی ۰ از /tmp/ntsc.nrg (فایل Nero). برای برخی ایمیج‌های ساده Nero کار می‌کند. .br .SS "پخش ویدیوی دیجیتال (DVB)" .PP شناسه‌های DVB MRL نیازمند این هستند که xine\-lib/channels.conf در $XDG_CONFIG_HOME/ یا ~/.config/ وجود داشته باشد و شامل داده‌های معتبر باشد. این فایل را می‌توان با ایجاد یک فایل تنظیم فرکانس با استفاده از ابزار "scan" در برنامه‌های LinuxTV DVB (یا "dvbscan" اگر از نسخه‌ای جدیدتر از 1.1.0 استفاده می‌کنید) به دست آورد: .PP .B scan -o zap /usr/share/doc/dvb-utils/examples/scan/dvb-t/uk-PontopPike >~/.config/xine-lib/channels.conf .PP (این مثال برای فرستنده محلی نویسنده است و از فایلی از بسته Debian dvb\-utils استفاده می‌کند.) .PP برای شناسه‌های MRL مربوط به dvbc، dvbs و dvbt، پارامترهای تنظیم فرکانس انتظار می‌رود که یکی از قالب‌های زیر را می‌گیرند: .TP .B DVB-S :::::: .TP .B DVB-C ::::::: .TP .B DVB-T ::::::::::: .TP .B DVB-A :::: .PP پارامترهای منفرد عبارتند از: .TP 20 .B frequency عدد، معمولاً بر حسب کیلوهرتز (kHz) .TP 20 .B polarisation `v` یا `h` (قطبش عمودی یا افقی) .TP 20 .B sat-no عدد صحیح بدون علامت، معمولاً 0 .TP 20 .B sym-rate نرخ نماد بر حسب MSyms/sec .TP 20 .B inversion INVERSION_ON, INVERSION_OFF, INVERSION_AUTO .TP 20 .B fec, fec-hp, fec-lp FEC_1_2, FEC_2_3, FEC_3_4 ... FEC_8_9, FEC_AUTO, FEC_NONE .TP 20 .B qam QPSK, QAM_128, QAM_16 ... .TP 20 .B bw BANDWIDTH_6_MHZ, BANDWIDTH_7_MHZ, BANDWIDTH_8_MHZ .TP 20 .B transmission-mode TRANSMISSION_MODE_2K, TRANSMISSION_MODE_8K .TP 20 .B guardlist GUARD_INTERVAL_1_4, GUARD_INTERVAL_1_8, GUARD_INTERVAL_1_16, GUARD_INTERVAL_1_32, .TP 20 .B hierarchy-info HIERARCHY_1, HIERARCHY_2, HIERARCHY_4, HIERARCHY_NONE .TP 20 .B vpid شناسه ویدیوی برنامه (video program ID) .TP 20 .B apid شناسه صوتی برنامه (audio program ID) .TP 20 .B service-id شناسه سرویس (مورد نیاز برای اطلاعات فعلی/بعدی و غیره) .PP ورودی‌های صفحه‌کلید و موشواره زیر ممکن است پذیرفته شوند: .TP 24 .B Menu 2 شروع/توقف ضبط .TP 24 .B Menu 3 تغییر وضعیت بزرگ‌نمایی (zoom) .TP 24 .B Menu 7 تغییر وضعیت نمایش اکنون/بعدی .TP 24 .B Previous/Next Chapter کانال قبلی/بعدی .TP 24 .B Mouse wheel & button 1 پیمایش در فهرست کانال‌ها و انتخاب کانال برگزیده .SH "زیرنویس (SUBTITLE)" .B فایل‌های زیرنویس خارجی (هر mrl) .br فایل‌های زیرنویس متنی ممکن است به MRL افزوده شوند:. .TP .BI #subtitle: این روش معمول برای مشخص کردن فایل زیرنویس مورد استفاده است. رابط کاربری (frontend) توجهی به فایل زیرنویس نخواهد کرد. برای مثال: .br .I file://home/user/wibble.mpg#subtitle:/home/user/wibble.sub .br (توجه داشته باشید که برخی از رابط‌های کاربری می‌توانند فایل‌های زیرنویس را در مواردی که نام آن‌ها متفاوت است، همان‌طور که در مثال نشان داده شده است، شناسایی کنند.) .br .SH "گزینه‌های جریان (STREAM OPTIONS)" .br پس از علامت جداکننده \fB#\fP می‌توانید چندین پارامتر جریان را اضافه کنید: .TP .B novideo ویدیو نادیده گرفته خواهد شد. .TP .B noaudio صدا نادیده گرفته خواهد شد. .TP .B nospu زیرنویس‌های تصویری (Subpictures) نادیده گرفته خواهند شد. .TP .BI demux: افزونه demux مورد استفاده را مشخص کنید. .TP .BI volume: تنظیم بلندی صدا. .TP .BI compression: تنظیم فشرده‌سازی محدوده دینامیکی صدا. .TP .BI : اختصاص مقدار جدید به هر مدخل پیکربندی. .TP .BI save: ذخیره جریان (در صورت مجاز بودن) در فایل مشخص‌شده، نسبت به دایرکتوری تعیین‌شده توسط گزینه "media.capture.save_dir". .TP .B تغییر گزینه پیکربندی به‌صورت بلادرنگ (on the fly): .br شما می‌توانید یک گزینه پیکربندی را در هر زمان با استفاده از شیوه ویژه MRL به صورت .B cfg:/ تغییر دهید. نحو آن به این صورت است: .br cfg:/ : .br برخلاف گزینه پیکربندی جریان، می‌توانید هر چیزی را \fIپیش از\fP پخش جریان تغییر دهید. .SH "همچنین ببینید (SEE ALSO)" \fBxine\fP(1), \fBaaxine\fP(1), \fBgxine\fP(1), \fBtoxine\fP(1), \fBtotem\fP(1), \fBkaffeine\fP(1) ... .br برنامه‌ها به طور کامل در صفحه اصلی xine مستند شده‌اند: .UR http://www.xine-project.org .IR "http://www.xine-project.org" .UE .SH "نویسندگان (AUTHORS)" این متن از صفحه راهنمای xine توسط Darren Salt استخراج شده است. صفحه راهنمای xine توسط Siggi Langauf برای پروژه xine نوشته شده است. با اضافات بسیار توسط Guenter Bartsch , Daniel Caujolle-Bert , Rocky Bernstein , و Philipp Hahn .