XJADEO(1) User Commands XJADEO(1)

xjadeo - نمایشگر ویدیوی هماهنگ با جک برای سامانه پنجره اکس

xjadeo [ OPTIONS ] [ video-file ]

xjadeo - نمایشگر ویدیویی جک برای اکس (X Jack Video Monitor)

برنامه Xjadeo یک پخش‌کننده ویدیوی نرم‌افزاری است که کلیپ ویدیو را به صورت همگام‌شده با یک منبع زمانی خارجی (MTC، LTC، انتقال JACK) نمایش می‌دهد.

برنامه Xjadeo برای ساخت و تنظیم موسیقی فیلم، پایش ویدیو طراحی شده و برای هر کاری که نیازمند هماهنگ‌سازی فریم‌های فیلم با رویدادهای صوتی باشد سودمند است.

نمایش پیام‌های پرجزئیات رمزگشای ویدیو.
نگه‌داشتن پنجره xjadeo بالاتر از سایر برنامه‌ها.
مقیاس‌بندی فیلم برای پر کردن پنجره. بدون این گزینه، برای حفظ نسبت تصویر از کادربندی مشکی (letterbox) استفاده می‌شود.
چاپ اطلاعات مربوط به توسعه و اشکال‌زدایی.
مشخص کردن درایور midi مورد استفاده. برای فهرست کردن درایور(های) پشتیبانی‌شده، 'xjadeo -V' را اجرا کنید. <name> به بزرگی و کوچکی حروف حساس نیست و می‌تواند تا نخستین نام یکتا کوتاه شود. برای نمونه: '-d j' برای jack، و '-d alsa-r' برای alsa-raw
نرخ نوسازی مد نظر برای نمایش ویدیو بر حسب فریم. اگر این مقدار برابر یا کمتر از صفر باشد، xjadeo از FPS خود فایل ویدیو به عنوان بسامد به‌روزرسانی استفاده خواهد کرد (که پیش‌فرض است). نکته: این مورد بر همگام‌سازی صفحه/vblank تأثیری ندارد. همگام‌سازی با نرخ نوسازی عمودی صفحه نمایش به سخت‌افزار وابسته است (و در صورت وجود همواره استفاده می‌شود).
نمایش این راهنما و خروج.
این گزینه تنها برای فایل‌های ویدیویی دارای آفست شروع، مانند فایل‌های چندبخشی vob سودمند است. به طور پیش‌فرض xjadeo آفست‌های مشخص‌شده در سرآیند فایل ویدیو را لحاظ می‌کند. این گزینه اجازه می‌دهد این آفست را نادیده بگیرید (و کسر کنید) تا شروع فایل با کد زمانی 00:00:00:00 تراز شود.
نمایش اطلاعات زمانی با استفاده از OSD (نمایش روی صفحه). 0: خاموش، 1: شماره فریم، 2: کد زمانی، 3: هر دو.
در زمان شروع برنامه به JACK متصل نشود و از هیچ منبع همگام‌سازی دیگری نیز استفاده نکند.
مشخص کردن حد فاصل بیشینه برای فریم‌های کلیدی (key-frame). در بیشتر کدک‌های ویدیویی، هر فریم ویدیو حاصل جمع یک فریم کلیدی به‌علاوه تفاوت‌های آن از نزدیک‌ترین فریم کلیدی است. برای پخش غیرپیوسته و جستجوهای تصادفی (random seeks)، برنامه xjadeo ناچار است به یک فریم کلیدی بازگردد و به صورت ترتیبی تا فریم مقصد رمزگشایی کند. این کار می‌تواند بار پردازشی بالایی برای پردازنده داشته باشد و از این رو حداکثر توالی رمزگشایی ترتیبی محدود شده است؛ به طور پیش‌فرض تا ۱۰۰ فریم. برای جستجوهای سریع و دقیق در سطح فریم، قویاً توصیه می‌شود فایل ویدیویی را با استفاده از کدکی ترنسکد کنید که در آن همه فریم‌ها یک فریم کلیدی باشند (مانند mjpeg) و ویدیو تنها شامل فریم‌های "intra" باشد. (فاصله فریم‌های کلیدی گاهی «گروه تصاویر» یا GOP نیز خوانده می‌شود).
همگام‌سازی با کد زمانی خطی (Linear Time Code ‏- جک صوتی).
مشخص کردن حالت تبدیل MTC:
0:
استفاده از نرخ فریم ساعت MTC (پیش‌فرض)
1:
استفاده از fps فایل ویدیو
2:
«نمونه‌برداری مجدد» (resample) فریم‌برثانیه فایل / MTC
استفاده از MTC به عنوان منبع همگام‌سازی. آرگومان <port> به درایور midi بستگی دارد:
مشخص کردن نام یک درگاه midi جهت اتصال،
یا "" برای عدم اتصال خودکار.
alsa-seq: مشخص کردن شناسه عددی جهت اتصال (-1: هیچ‌کدام)
برای نمونه: -m ardour یا -m 80
alsa-raw: مشخص کردن دستگاه سخت‌افزاری
برای نمونه: -m hw:1,0 یا -m 1
portmidi: شناسه عددی؛ -1: تشخیص خودکار
مقداری بزرگتر از -1 شماره درگاه مورد استفاده را مشخص می‌کند.
برای دیدن فهرست درگاه‌های midi از '-v -m -1' استفاده کنید.
شنود پیام‌های OSC روی درگاه مشخص‌شده. برنامه Xjadeo می‌تواند از راه دور با استفاده از Open Sound Control کنترل شود. برای دیدن فهرست دستورات در دسترس، لطفاً به کد منبع یا مستندات برخط مراجعه کنید.
انحراف زمانی ویدیو از منبع کد زمانی. این گزینه امکان می‌دهد پخش ویدیو به تعداد معینی فریم (ویدیویی) نسبت به منبع زمانی جابه‌جا شود. مقادیر مثبت و منفی مجاز هستند. این آفست می‌تواند به صورت یک عدد صحیح برای شماره فریم یا به صورت کد زمانی جداشده با دونقطه مشخص شود.
چاپ دستورات در دسترس OSC و خروج.
فعال‌سازی صف‌های پیام بی‌درنگ (realtime) بر پایه POSIX. این کار یک کانال ارتباطی برای کنترل از راه دور برپا می‌کند که جهت استفاده با `xjremote` در نظر گرفته شده است.
جلوگیری از خروجی‌های معمول.
فعال‌سازی حالت تعاملی کنترل از راه دور با استفاده از ورودی/خروجی استاندارد. این گزینه متضمن حالت غیر پرجزئیات (non-verbose) و ساکت (quiet) است چرا که ترمینال برای تعامل استفاده می‌شود.
مشخص کردن یک فایل پیکربندی سفارشی برای بارگذاری.
صرف‌نظر کردن از توالی راه‌اندازی نمایش روی صفحه (صفحه خوش‌آمدگویی).
راه‌اندازی xjadeo در حالت تمام‌صفحه.
مسیر فایل قلم .ttf برای نمایش روی صفحه (OSD)
مشخص کردن شناسه یکتای نشست جک (JACK SESSION UUID).
چاپ اطلاعات نسخه و خروج.
راه‌اندازی صف‌های پیام IPC برای کنترل از راه دور. ارتباط بین‌فرآیندی (IPC) توسط `xjremote` در OSX و پلتفرم‌های دیگری که از صف‌های پیام بی‌درنگ پشتیبانی نمی‌کنند استفاده می‌شود.
چاپ اطلاعات بیشتر.
انتخاب حالت خروجی ویدیو (پیش‌فرض: 0: تشخیص خودکار). مقدار -1 حالت‌های در دسترس را فهرست کرده و خارج می‌شود..SH "منابع همگام‌سازی (Synchronization Sources):"
انتقال JACK (JACK transport)
کد زمانی طولی/خطی (Linear/Longitudinal Time Code) - از طریق صوت JACK
کد زمانی MIDI از طریق JACK MIDI
کد زمانی MIDI از طریق ALSA sequencer (فقط در لینوکس)
کد زمانی MIDI از طریق دستگاه‌های خام ALSA (فقط در لینوکس)
کد زمانی MIDI از طریق portmidi (در OSX و Windows)
پیمایش‌های دستی کنترل‌شده از راه دور.

اگر هیچ‌یک از گزینه‌های -m یا -l داده نشوند، xjadeo به‌طور پیش‌فرض با jack transport همگام‌سازی می‌شود.

برنامه xjadeo برای رمزگشایی فایل‌های ویدیو از ffmpeg استفاده می‌کند، بنابراین طیف گسترده‌ای از قالب‌ها و کدک‌ها پشتیبانی می‌شوند. با این حال توجه داشته باشید که تمام کدک‌ها از پیمایش (seeking) قابل اتکا پشتیبانی نمی‌کنند. اکیداً توصیه می‌شود فایل ویدیویی را به یک قالب/کدک مناسب تبدیل (transcode) کنید. ترکیب پیشنهادی avi/mjpeg است. برای مثال: ffmpeg -i input-file.xxx -an -vcodec mjpeg output-file.avi این دستور از input-file.xxx شما یک فایل ویدیویی با کدگذاری AVI mjpeg بدون صدا و بدون فشرده‌سازی میان‌فریمی (motion jpeg ‏- که در آن هر فریم یک فریم کلیدی است) می‌سازد. همچنین ممکن است بخواهید با کاهش اندازه هندسی (geometry) ویدیو، حجم فایل را کاهش دهید. این کار منابع سیستم کمتری را برای رمزگشایی و نمایش مصرف می‌کند و فضای بیشتری را در صفحه نمایش برای نرم‌افزار صوتی شما باقی می‌گذارد. گزینه -s <width>x<height> در ffmpeg را ببینید و برای گزینه‌های بیشتر به صفحه راهنمای ffmpeg مراجعه کنید؛ برای نمونه -qscale 0 برای حفظ کیفیت تصویر.

در هنگام راه‌اندازی، xjadeo فایل‌های پیکربندی منابع زیر را به ترتیب زیر می‌خواند:

سراسری در سیستم:
/etc/xjadeorc یا /usr/local/etc/xjadeorc
پیکربندی قدیمی کاربر:
$HOME/.xjadeorc
پیکربندی کاربر:
$XDM_CONFIG_HOME/xjadeo/xjadeorc (معمولاً $HOME/.config/)
در OSX:
$HOME/Library/Preferences/xjadeorc
در Windows:
$HOMEDRIVE$HOMEPATH\xjadeorc
و $HOMEDRIVE$HOMEPATH\Local Settings\xjadeorc
(معمولاً C:\Documents and Settings\<Username>\)
مختص پروژه:
$PWD/xjadeorc

هر خط در فایل پیکربندی یک جفت KEY=VALUE است. اگر نخستین نویسه در یک خط '#' یا ';' باشد، آن خط نادیده گرفته می‌شود. کلیدها (KEYS) به بزرگی و کوچکی حروف حساس نیستند. مقادیر بولی به‌صورت 'yes' یا 'no' مشخص می‌شوند. برای دیدن فهرستی از کلیدهای موجود، لطفاً فایل پیکربندی نمونه را که در پوشه مستندات کد منبع موجود است بررسی کنید.

اگر xjadeo با پشتیبانی از jack session کامپایل شده باشد، وضعیت فعلی خود را به‌صورت یک فایل پیکربندی ذخیره کرده و آن را به عنوان یک شناسه به مدیر نشست jack (jack session manager) ارسال می‌کند.

پنجره xjadeo یک منوی کلیک‌راست زمینه‌ای (context menu) ارائه می‌دهد (به جز در OSX که برنامه دارای نوار منوی اصلی است) که دسترسی آسان به قابلیت‌های رایج را فراهم می‌آورد. در OSX و Windows این منو دیالوگ باز کردن فایل را برای تغییر فایل ویدیویی تحت نظارت ارائه می‌دهد. در لینوکس می‌توان با کشیدن فایل و رها کردن آن روی خود پنجره، فایل‌های جدید را بارگذاری کرد. علاوه بر این، xjadeo به فشردن کلیدها پاسخ می‌دهد. میان‌برهای زیر تعریف شده‌اند:

'Esc'
بستن پنجره و خروج
'a'
تغییر وضعیت حالت همیشه در بالا (always-on-top)
'b'
تغییر وضعیت حاشیه سیاه در نمایش روی صفحه (OSD)
'Shift+C'
پاک کردن تمام پیام‌های نمایشی OSD.
'f'
تغییر حالت تمام‌صفحه
'g'
تغییر وضعیت نمایش ابعاد هندسی فایل روی صفحه
'i'
تغییر وضعیت نمایش اطلاعات زمان فایل روی صفحه
'l'
تغییر وضعیت مقیاس‌بندی سینمایی (letterbox)
'm'
تغییر وضعیت نمایانی مکان‌نمای موشوار
'o'
جابجایی بین حالت‌های مختلف نمایش آفست (offset).
'p'
جابجایی موقعیت کد زمانی/شماره فریم در OSD.
's'
تغییر وضعیت نمایش کد زمانی منبع همگام‌سازی روی صفحه
'v'
جابجایی بین نمایش VTS/شماره فریم روی صفحه
'x'
تغییر وضعیت نوار پیمایش (seek-bar) (آزمایشی)
'\'
بازنشانی آفست کد زمانی به صفر
'='
افزایش آفست کد زمانی به اندازه یک فریم
'-'
کاهش آفست کد زمانی به اندازه یک فریم
'+'
افزایش آفست کد زمانی به اندازه یک ثانیه
'_'
کاهش آفست کد زمانی به اندازه یک ثانیه
'{'
کاهش آفست کد زمانی به اندازه یک دقیقه
'}'
افزایش آفست کد زمانی به اندازه یک دقیقه
','
تغییر اندازه پنجره برای هماهنگی با نسبت ابعاد تصویر (aspect ratio)
'.'
تغییر اندازه پنجره به ابعاد اولیه ویدیو
'<'
کاهش اندازه پنجره به میزان ۲۰٪
'>'
افزایش اندازه پنجره به میزان ۲۰٪
'backspace'
بازگرداندن jack transport به 00:00:00:00
'space'
تغییر وضعیت پخش/توقف jack transport
'e'
نمایش اکولایزر رنگ (فقط در x11/imlib و XV)
'Shift+E'
بازنشانی اکولایزر رنگ (فقط در x11/imlib و XV)
'0-9'
تغییر تنظیمات اکولایزر رنگ (فقط در x11/imlib و XV)
'Shift+1-4'
تنظیم دقیق اکولایزر رنگ (فقط در x11/imlib و XV) روشنایی: 1+2، کنتراست: 3+4، گاما: 5+6، اشباع: 7+8 فام: 9+0. توازن رنگ XV وابسته به سخت‌افزار است.

توجه داشته باشید که می‌توان برخی از قابلیت‌ها را با استفاده از کنترل از راه دور غیرفعال کرد. یک میزبان (Host) می‌تواند کنترل جنبه‌های خاصی مانند آفست را به دست گیرد یا از بستن نمایشگر ویدیو، مگر از طریق امکانات ارائه‌شده توسط خود میزبان، جلوگیری کند..SH "گزارش باگ‌ها (BUGS)" گزارش باگ‌ها را به https://github.com/x42/xjadeo/issues ارسال کنید
وب‌گاه: http://xjadeo.sf.net

ساخته‌شده از:
scm-v0.8.15
کامپایل‌شده با: AVFORMAT=0x3a2d64 AVCODEC=0x3a5b64 AVUTIL:0x383364 پیکربندی: [ LTC JACK-SESSION POSIX-MQueue OSC ]
MTC/MIDI: [ jack-midi alsa-sequencer portmidi alsa-raw ]
نمایشگر(ها): [ openGL Xv SDL X11/imlib2(RGBA32) ]

کپی‌رایت © GPL 2006-2021 Robin Gareus <robin@gareus.org>
کپی‌رایت © GPL 2006-2011 Luis Garrido <luisgarrido@users.sourceforge.net>
این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، کد منبع را ببینید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

November 2025 xjadeo version 0.8.15