.TH recordMyDesktop 1 2017-04-05
.SH "نام (NAME)"
recordMyDesktop \- ضبط نشست‌های میزکار در یک فایل ویدیویی Ogg Theora با صدای \
Vorbis
.SH "خلاصه دستور (SYNOPSIS)"
.B recordmydesktop
.PP
.B recordmydesktop
.I output-filename
.PP
.B recordmydesktop \-\-rescue
.I path-to-data
.PP
.B recordmydesktop
.RI { image-options | sound-options | encoding-options | miscellaneous-options \
"| ... }
.PP
.B recordmydesktop
.RB { \-h | \-\-help }
.PP
.B recordmydesktop \-\-version
.PP
.B recordmydesktop \-\-print\-config
.SH "توضیحات (DESCRIPTION)"
.B recordMyDesktop
یک فایل
.RI ( out.ogv
به‌طور پیش‌فرض) حاوی ضبط ویدیو و صدای یک نشست X Window System تولید می‌کند.
.PP
برای یک سناریوی معمول، ضبط نشست به سادگی اجرای دستور زیر است:
.RS
$
.B recordmydesktop
.RE
که یک ضبط تمام‌صفحه به نام
.I out.ogv
در دایرکتوری کاری فعلی تولید خواهد کرد، در حالی که دستور
.RS
$
.B recordmydesktop ../foo
.RE
ضبط را در
.I foo.ogv
در دایرکتوری والد دایرکتوری کاری فعلی ذخیره خواهد کرد.
.PP
برای پایان دادن به ضبط، کلیدهای
.BR Control+C
را فشار دهید.
(این عمل یک سیگنال
.B SIGINT
به
.B recordMyDesktop
ارسال می‌کند.)
.PP
برای مشخص کردن ناحیه‌ای از صفحه جهت ضبط می‌توانید دستور زیر را وارد کنید:
.RS
$
.B recordmydesktop \-x
.I x-pos
.B \-y
.I y-pos
.B \-\-width
.I w
.B \-\-height
.I h
.B \-o foo.ogv
.RE
که در آن
.I x-pos
و
.I y-pos
میزان انحراف (افست) بر حسب پیکسل را از گوشه بالا سمت چپ صفحه، و
.I w
و
.I h
اندازه ناحیه مورد نظر برای ضبط را، باز هم بر حسب پیکسل، مشخص می‌کنند.
.\" It would be nice to take an X-style geometry specification.
اگر ناحیه فراتر از تفکیک‌پذیری (وضوح) فعلی شما امتداد یابد، به درستی به شما اطلاع داده شده و هیچ کاری انجام نخواهد شد.
.PP
.IR نکته :
اگر از
.I هر
گزینه‌ای استفاده شود و بخواهید نام فایلی غیر از نام پیش‌فرض را برای خروجی به کار ببرید، باید آن را با گزینه
.B \-o
مشخص کنید.
.\" That's not consistent with argv parsing in most of the Unix world.
.PP
از نسخه 0.3 برنامه
.BR recordMyDesktop ،
کدگذاری بلافاصله پس از پایان ضبط انجام می‌شود.
اگرچه این رفتار تا حد زیادی در مصرف پردازنده (CPU) صرفه‌جویی می‌کند، با مشخص کردن گزینه
.B \-\-on\-the\-fly\-encoding
می‌توانید به رفتار قبلی بازگردید.
.PP
رفتار پیش‌فرض ضبط این است که نواحی تغییر‌یافته (طبق تشخیص افزونه X Damage) علامت‌گذاری شده و فریم به‌روزرسانی شود.
این رفتار را می‌توان از طریق گزینه
.B \-\-full\-shots
تغییر داد تا نتیجه دقیق‌تری تولید شود یا پنجره‌هایی که هنگام تغییر رویدادهای X ایجاد نمی‌کنند (مانند پنجره‌های با کانتکست سه‌بعدی شتاب‌یافته) ضبط شوند، اما این کار بار پردازشی را به میزان قابل توجهی افزایش خواهد داد.
.PP
برنامه
.B recordMyDesktop
به معنای مرسوم دارای رابط کاربری نیست.
پس از راه‌اندازی، تنها از طریق سیگنال‌های زیر قابل کنترل است:
.TP
.B SIGUSR1
در صورتی که برنامه در حال حاضر مشغول ضبط باشد باعث مکث (توقف موقت) می‌شود، و بالعکس.
.TP
.B SIGTERM
.TQ
.B SIGINT
باعث خاتمه عادی ضبط می‌شوند.
.TP
.B SIGABRT
برنامه را متوقف کرده و فایل خروجی را حذف می‌کند.
.PP
این سیگنال‌ها همچنین می‌توانند با پیکربندی میانبرهای صفحه‌کلید به برنامه ارسال شوند.
به
.B \-\-pause\-shortcut
و
.B \-\-stop\-shortcut
در زیربخش
.B گوناگون (Miscellaneous)
از بخش
.B گزینه‌ها (OPTIONS)
در ادامه مراجعه کنید.
.PP
برای اعمال تغییرات و تنظیمات بیشتر روی نتیجه نهایی، به بخش‌های
.B گزینه‌ها (OPTIONS)
و
.B یادداشت‌ها (NOTES)
در ادامه مراجعه کنید..SH "گزینه‌ها (OPTIONS)"
اگر و
.I تنها اگر
هیچ گزینه‌ای مشخص نشده باشد،
.B recordMyDesktop
یک عملوند منفرد را می‌پذیرد که آن را به عنوان نام فایل خروجی تفسیر می‌کند.
.PP
دستور
.B recordMyDesktop
گزینه‌های خط فرمان متعددی را می‌پذیرد.
توضیحات زیر آن‌ها را در دسته‌بندی‌هایی گروه‌بندی می‌کند.
.SS "عمومی (General)"
.TP
.B \-h \fRیا\fP \-\-help
چاپ خلاصه‌ای از نحوه استفاده و خروج.
.TP
.B \-\-version
چاپ نسخه برنامه و خروج.
.TP
.B
\-\-print\-config
چاپ اطلاعات مربوط به گزینه‌های انتخاب‌شده در زمان کامپایل و خروج.
در حال حاضر مشخص می‌کند که آیا ضبط Jack فعال است و اینکه آیا ALSA یا OSS استفاده می‌شود؛
ممکن است در آینده اطلاعات بیشتری را گزارش دهد.
.SS "تصویر (Image)"
.TP
.BI \-\-windowid " wid"
ضبط ناحیه‌ای از صفحه نمایش که با پنجره X به شناسه
.IR wid
در زمان شروع به کار
.B recordMyDesktop
مطابقت دارد.
ضبط یک پنجره خود پنجره را دنبال نمی‌کند، بلکه ناحیه‌ای را که می‌پوشاند ضبط می‌کند؛ اگر پنجره جابه‌جا شود،
.B recordMyDesktop
آن را دنبال نمی‌کند.
اگر پنجره توسط پنجره دیگری پوشانده شود، محتویات پنجره پوشاننده درون ناحیه ضبط ثبت خواهند شد.
شناسه پنجره یک کلاینت X را می‌توان با برنامه
.BR xwininfo (1)
به‌دست آورد؛ بخش
.B "یادداشت‌ها (Notes)"
در ادامه را ببینید.
.TP
.BI \-\-display " x-display"
اتصال به نمایشگر سامانه پنجره X در
.IR x-display .
به‌طور پیش‌فرض، مقدار متغیر محیطی
.B DISPLAY
برای تعیین نمایشگر استفاده می‌شود.
.TP
.BI \-x " x-offset"
محدود کردن ناحیه ضبط به شروع از
.I x-offset
پیکسل از لبه چپ صفحه نمایش یا شناسه پنجره X تعیین‌شده با
.BR \-\-windowid .
مقدار پیش‌فرض 0 است.
.TP
.BI \-y " y-offset"
محدود کردن ناحیه ضبط به شروع از
.I y-offset
پیکسل از لبه بالای صفحه نمایش یا شناسه پنجره X تعیین‌شده با
.BR \-\-windowid .
مقدار پیش‌فرض 0 است.
.TP
.BI \-\-width " w"
محدود کردن عرض ناحیه ضبط به
.I w
پیکسل.
مقدار پیش‌فرض، کل عرض صفحه نمایش یا شناسه پنجره X تعیین‌شده با
.BR \-\-windowid
است.
.TP
.BI \-\-height " h"
محدود کردن ارتفاع ناحیه ضبط به
.I h
پیکسل.
مقدار پیش‌فرض، کل ارتفاع صفحه نمایش یا شناسه پنجره X تعیین‌شده با
.BR \-\-windowid
است.
.TP
.BI \-\-dummy\-cursor " color"
رسم یک مکان‌نمای ساختگی به جای مکان‌نمای عادی.
مقدار
.I color
داده‌شده باید یک رشته باشد، یا
.RB \(lq black \(rq
یا
.RB \(lq white \(rq.
.TP
.B \-\-no\-cursor
غیرفعال کردن رسم مکان‌نما.
.TP
.B \-\-no\-shared
عدم استفاده از
.UR https://www.x.org/releases/X11R7.7/doc/xextproto/shm.html
افزونه حافظه مشترک MIT (MIT-SHM)
.UE .
.I استفاده از این گزینه توصیه نمی‌شود.
.TP
.B \-\-full\-shots
گرفتن یک تصویر کامل از صفحه نمایش در هر فریم.
.I استفاده از این گزینه توصیه نمی‌شود.
.TP
.B \-\-follow\-mouse
هنگامی که این گزینه فعال باشد، ناحیه ضبط مکان‌نمای ماوس را دنبال می‌کند.
این مورد تنها زمانی معنا دارد که ناحیه انتخاب‌شده زیرمجموعه‌ای از کل صفحه نمایش باشد.
این گزینه به‌طور ضمنی
.BR \-\-full-shots
را نیز فعال می‌کند.
.TP
.B \-\-quick\-subsampling
زیرنمونه‌برداری از صفحات کروما با دور ریختن پیکسل‌های اضافی.
.TP
.BI \-\-fps " n"
تلاش برای ضبط
.I n
فریم در ثانیه، که در آن
.I n
عددی مثبت است و می‌تواند یک عدد صحیح یا ممیز شناور باشد.
نرخ فریم قابل دستیابی توسط سخت‌افزار سیستم و بار کاری آن محدود می‌شود.
مقدار پیش‌فرض 15 است..SS "صدا (Sound)"
.TP
.BI \-\-channels " n"
ضبط حداکثر تا
.I n
کانال، که در آن
.I n
یک عدد صحیح مثبت است.
پیش‌فرض 2 (استریو) است.
.TP
.BI \-\-freq " n"
ضبط با نرخ نمونه‌برداریِ
.I n
هرتز، که در آن
.I n
یک عدد صحیح مثبت است.
پیش‌فرض 22050 (22.05 کیلوهرتز) است.
.TP
.BI \-\-buffer\-size " n"
بافر کردن
.I n
بایت از داده‌های صوتی هنگام استفاده از سامانه‌های صوتی ALSA یا OSS، که در آن
.I n
یک عدد صحیح مثبت است.
پیش‌فرض 4096 (4 کیبی‌بایت) است.
.TP
.BI \-\-ring\-buffer\-size " n"
تنظیم اندازه بافر حلقه‌ای JACK بر حسب ثانیه، که در آن
.I n
یک عدد اعشاری مثبت است.
پیش‌فرض 3.0 است.
.IP ""
اندازه کل بافر بر حسب بایت را می‌توان به صورت یک عبارت به زبان C بیان کرد:
.EX
ring_buffer_size * sample_rate * number_of_ports
        * sizeof(jack_default_audio_sample_t),
.EE
که در آن
.ft CR
sizeof(jack_default_audio_sample_t)
.ft
معمولاً 4 است.
.TP
.BI \-\-device " sound-device"
ضبط صدا از
.IR sound-device .
پیش‌فرض بسته به این‌که از ALSA یا OSS استفاده شود، به ترتیب
.IR default
یا
.IR /dev/dsp
است.
.TP
.BI \-\-use\-jack " port \fR...\fP"
ضبط صدا از فهرست مشخص‌شده‌ای از درگاه‌های JACK که با فاصله از هم جدا شده‌اند.
هنگام استفاده از این گزینه، سایر گزینه‌های مرتبط با صدا (به‌جز
.BR \-\-no-sound )
.\" ...and --ring-buffer-size?
نادیده گرفته می‌شوند.
.TP
.B \-\-no\-sound
صدا ضبط نشود.
.SS "کدگذاری (Encoding)"
.TP
.B \-\-on\-the\-fly\-encoding
کدگذاری داده‌های صوتی/تصویری هم‌زمان با ضبط.
پیش‌فرض این است که کدگذاری تا پس از اتمام ضبط به تعویق بیفتد.
.TP
.BI \-\-v_quality " n"
تنظیم کیفیت ویدیوی دلخواه روی
.IR n ،
یک عدد صحیح بین 0 تا 63 (شامل هر دو)؛ مقادیر بالاتر بهتر است.
پیش‌فرض 63 است.
بخش
.B Notes
در ادامه را ببینید.
.TP
.BI \-\-v_bitrate " n"
تنظیم نرخ بیت دلخواه ویدیوی کدگذاری‌شده روی
.I n
بیت در ثانیه.
محدوده مجاز برای
.I n
بین 0 تا 200,000,000 (شامل هر دو) است؛ پیش‌فرض 0 است.
(جداکننده هزارگان در اینجا برای وضوح نشان داده شده است؛ از آن در آرگومان گزینه استفاده نکنید.)
.TP
.BI \-\-s_quality " n"
تنظیم کیفیت صدای دلخواه روی
.IR n ،
یک عدد صحیح بین \-1 تا 10 (شامل هر دو)؛ مقادیر بالاتر بهتر است.
پیش‌فرض 10 است..SS "متفرقه (Miscellaneous)"
.TP
.BI \-\-rescue " path-to-data"
داده‌های حافظهٔ نهان (cache) از یک نشست پیشین را در قالب یک فایل Ogg Theora کدگذاری می‌کند.
نام فایل همان نامی خواهد بود که در ابتدا انتخاب شده بود.
هر گزینهٔ دیگری که همراه با این گزینه مشخص شود، به‌طور ضمنی نادیده گرفته شده و
.B recordMyDesktop
پس از پایان کدگذاری خارج خواهد شد.
این گزینه در نسخهٔ 0.3.7 برنامهٔ
.B recordMyDesktop
اضافه شده است و با فایل‌های حافظهٔ نهان ایجادشده توسط نسخه‌های پیشین کار نخواهد کرد.
هنگام استفاده از این گزینه، توجه داشته باشید که حافظهٔ نهان
.B recordMyDesktop
از نظر اندازهٔ انواع داده و ترتیب بایت‌ها (endianness) ایمن نیست.
برای یافتن داده‌های ذخیره‌شده در حافظهٔ نهان، گزینهٔ
.B \-\-workdir
در زیر را ببینید.
.TP
.B \-\-no\-wm\-check
هنگامی که یک مدیر پنجرهٔ ترکیبی سه‌بعدی (3D compositing window manager) شناسایی شود، برنامه به گونه‌ای عمل می‌کند که گویی گزینهٔ
.B \-\-full\-shots
مشخص شده است.
این گزینه این بررسی را غیرفعال می‌کند.
.TP
.B \-\-no\-frame
به‌طور معمول، فریمی دور ناحیهٔ ضبط کشیده می‌شود تا به کاربر در تشخیص آنچه ضبط می‌شود و آنچه ضبط نمی‌شود کمک کند.
هنگامی که گزینهٔ
.B \-\-follow\-mouse
داده شود، این فریم نشانگر ماوس را نیز دنبال خواهد کرد.
با این حال، ممکن است این فریم برای عملیات کشیدن و رها کردن (drag-and-drop) مشکلاتی ایجاد کند.
اگر تمایلی ندارید که این فریم نمایش داده شود، از این گزینه استفاده کنید.
.TP
.BI \-\-pause\-shortcut " mod" + key
یک ترکیب کلید را برای تغییر وضعیت مکث (pause) ضبط تعیین می‌کند.
.I mod
می‌تواند هر ترکیبی از کلیدهای تبدیلگر (modifier) زیر باشد: Control، Shift و Mod1 تا Mod5.
تبدیلگرها می‌توانند با هر نویسه‌ای
.RI ( "به جز فاصله" )
یا اصلاً بدون هیچ نویسه‌ای از یکدیگر جدا شوند.
.I key
می‌تواند هر کلیدی باشد که در
.\" If outputting HTML, make the filename a clickable link.
.ie '\*(.T'html' \{\
.UR file:///usr/include/X11/keysymdef.h
.UE . \}
.el \{\
.IR /usr/include/X11/keysymdef.h . \}
تعریف شده است.
پیشوند XK_ را از نام کلیدهای موجود در آن فایل حذف کنید.
فهرست تبدیلگرها باید با علامت جمع \(lq+\(rq از کلید جدا شود.
پیش‌فرض
.BR Control+Mod1+p
است (Mod1 معمولاً متناظر با کلید Alt چپ است).
.TP
.BI \-\-stop\-shortcut " mod" + key
یک ترکیب کلید را برای متوقف کردن ضبط تعیین می‌کند.
برای جزئیات بیشتر، گزینهٔ
.B \-\-pause\-shortcut
در بالا را ببینید.
پیش‌فرض
.BR Control+Mod1+s
است.
.TP
.B \-\-compress\-cache
داده‌های تصویری با یک فشرده‌سازی سبک در حافظهٔ نهان ذخیره می‌شوند.
.TP
.BI \-\-workdir " dir"
.B recordMyDesktop
یک دایرکتوری موقت در
.I dir
برای ذخیرهٔ فایل‌های میانی در حافظهٔ نهان ایجاد می‌کند.
در صورت مقداردهی، مقدار پیش‌فرض از متغیر محیطی
.B TMPDIR
خوانده می‌شود، در غیر این صورت از
.IR /tmp
استفاده خواهد شد.
.TP
.BI \-\-delay " n\fR[\fP" H \fR|\fP h \fR|\fP M \fR|\fP m \fR]\fP
پیش از آغاز ضبط، به مدت
.I n
واحد زمانی (اگر مشخص نشود، ثانیه) صبر می‌کند، که در آن
.I n
یک مقدار عددی صحیح غیرمنفی یا ممیز شناور است.
پسوند اختیاری
.B H
یا
.BR h ،
.B M
یا
.BR m
به‌ترتیب نشان‌دهندهٔ واحدهای زمانی ساعت یا دقیقه است.
پیش‌فرض بدون تأخیر است.
.TP
.B \-\-overwrite
اگر فایل خروجی از قبل وجود داشته باشد، آن را حذف می‌کند.
حالت پیش‌فرض، خودداری از رونویسی و درج یک شناسهٔ عددی تفکیک‌کننده در نام فایل است (بخش
.B Files
در زیر را ببینید).
.TP
.BI \-o " filename"
ویدئوی کدگذاری‌شده را در
.I filename
می‌نویسد.
پیش‌فرض
.IR out.ogv
است..SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج 0 بر اساس قراردادهای معمول یونیکس نشان‌دهنده موفقیت است.
.PP
وضعیت خروج غیرصفر به این معناست که خطایی رخ داده است؛ این وضعیت‌ها با پیام‌های عیب‌یابی در خطای استاندارد همراه هستند.
علاوه بر این، چندین وضعیت استثنایی با وضعیت‌های خروج مشخص تفکیک شده‌اند.
.IP 1
تجزیه آرگومان با شکست مواجه شد یا آرگومان ورودی نامفهوم بود.
.IP 2
راه‌اندازی اولیه انکودر با شکست مواجه شد (Vorbis یا Theora).
.IP 3
امکان باز کردن یا پیکربندی دستگاه صوتی وجود نداشت.
.IP 4
افزونه XDamage موجود نیست.
.IP 5
افزونه MIT-SHM موجود نیست.
.IP 6
افزونه XFixes موجود نیست.
.IP 7
فراخوانی
.BR XInitThreads (3)
با شکست مواجه شد.
.IP 8
متغیر محیطی
.B DISPLAY
تنظیم نشده است و هیچ گزینهٔ
.B \-\-display
مشخص نگردیده است.
.IP 9
امکان اتصال به سرور X وجود نداشت.
.IP 10
عمق رنگ پنجره ریشه (root window) برابر ۳۲، ۲۴ یا ۱۶ بیت بر پیکسل نیست.
.IP 11
مشخصات پنجره ضبط نامعتبر بود.
.IP 12
امکان پیوست کردن حافظه مشترک به فرایند وجود نداشت.
.IP 13
امکان باز کردن فایل برای نوشتن وجود نداشت.
.\" کدهای خروج زیر ظاهراً دیگر استفاده نمی‌شوند.
.\" .IP 14
.\" بارگذاری کتابخانه JACK ناموفق بود (استفاده‌نشده از زمان
.\" .B recordMyDesktop
.\" 0.3.8).
.\" .IP 15
.\" ایجاد کلاینت جدید (JACK؟) ممکن نشد.
.\" .IP 16
.\" فعال‌سازی کلاینت (JACK؟) ممکن نیست.
.\" .IP 17
.\" ثبت یا اتصال پورت (JACK؟) ناموفق بود.
.SH "محیط (ENVIRONMENT)"
.TP
.B DISPLAY
سرور X را برای اتصال مشخص می‌کند.
برای موارد استفاده معمول، این متغیر از پیش به درستی در محیط تنظیم شده است و با نمایشگر X که کاربر در حال حاضر با آن کار می‌کند مطابقت دارد (به عبارت دیگر،
.B recordMyDesktop
\(lqکار درست را انجام می‌دهد\(rq).
برای اطلاعات بیشتر بخش
.B Display Names
را در
.BR X (7)
ببینید.
.SH "فایل‌ها (FILES)"
.B recordMyDesktop
پسوند
.I .ogv
را به نام هر فایل خروجی که از قبل آن را نداشته باشد (با هر حالت بزرگی یا کوچکی حروف) اضافه می‌کند.
.PP
اگر سعی کنید در فایلی که از پیش موجود است ذخیره کنید، یک تمایزدهنده عددی به شکل
.I \-n
پیش از پسوند
.I .ogv
در نام فایل درج می‌شود.
عدد
.I n
از ۱ آغاز می‌شود و در صورتی که فایلی با آن تمایزدهنده از قبل وجود داشته باشد، افزایش می‌یابد.
.PP
برای نمونه، در صورت مشخص نکردن نام، اگر
.I out.ogv
وجود داشته باشد، فایل جدید
.IR out\-1.ogv
خواهد بود، و اگر آن هم موجود باشد، از
.I out\-2.ogv
استفاده می‌شود و به همین ترتیب
.I ad infinitum
(نه واقعاً بی‌نهایت، بلکه بیشتر شبیه به
.IR "ad unsigned short" )..SH "نکات (NOTES)"
.SS "ضبط با استفاده از شناسه پنجره X"
هنگام استفاده از گزینهٔ
.B \-\-windowid
شرح آن را در بخش
.B "گزینه‌ها (OPTIONS)"
در بالا، و همچنین شرح گزینه‌های
.BR \-x ،
.BR \-y ،
.BR \-\-width
و
.B \-\-height
را به دقت مطالعه کنید.
.PP
یک راه آسان برای یافتن شناسه یک پنجره، استفاده از برنامهٔ
.BR xwininfo (1)
است.
اجرای دستوری مانند
.RS
$
.B xwininfo | awk \(aq/Window id:/ {print $4}\(aq
.RE
تنها شناسهٔ پنجره را گزارش خواهد داد، که یک عدد صحیح در مبنای شانزده با قالب لیترال C خواهد بود، مانند \(lq0x4800005\(rq.
برای راحتی بیشتر، می‌توانید همهٔ آن را در دستوری که
.B recordMyDesktop
را اجرا می‌کند به این صورت قرار دهید:
.RS
$
.B
recordmydesktop \-\-windowid $(xwininfo | awk \(aq/Window id:/ {print $4}\(aq)
.RE
.SS "تنظیم کیفیت ویدیو"
هر چه کیفیت انتخابی شما در یک ضبط ویدیویی پایین‌تر باشد (با استفاده از گزینهٔ
.BR \-\-v_quality )،
به توان پردازشی CPU بیشتری نیاز خواهید داشت.
بنابراین اگر همزمان از گزینهٔ
.B \-\-on\-the\-fly\-encoding
نیز استفاده می‌کنید، بهتر است کار را با مقادیر پیش‌فرض آغاز کرده و نتیجهٔ نهایی را با برنامهٔ دیگری پردازش کنید.
یک مبدل بسیار عالی، پخش‌کنندهٔ رسانهٔ
.BR vlc (1)
است که می‌تواند عملیات گوناگون تبدیل کد (transcoding) را چه با استفاده از رابط گرافیکی و چه از طریق خط فرمان انجام دهد.
.B vlc
نرم‌افزار پیچیده‌ای است؛ پیش از استفاده باید مستندات آن را مطالعه کنید.
در ادامه مثالی آمده است که اندازهٔ ویدیوی ضبط‌شده‌ای به نام
.I out.ogv
را به 512\(mu384 تغییر اندازه می‌دهد.
.RS
$
.B
vlc \-I dummy out.ogv vlc:quit \-\-sout "#transcode{ vcodec = theo, \
width = 512, height = 384 }:duplicate{ dst = std{ access = file, mux=ogg, \
dst = \\"out_512x384.ogv\\" }}"
.RE
.PP
اگر مایلید کیفیت ویدیو را تغییر دهید، می‌توانید گزینهٔ
.BI \-\-sout\-theora\-quality= n\fR،\fP
را اضافه کنید که در آن
.I n
در بازهٔ
[1,10] است؛ برای مثال،
.RS
$
.B
vlc \-I dummy out.ogv vlc:quit \-\-sout "#transcode{ vcodec = theo, \
width = 512, height = 384 }:duplicate{ dst = std{ access = file, mux=ogg, \
dst = \\"out_512x384.ogv\\" }}" \-\-sout\-theora\-quality=3
.RE
فایلی با کیفیت ویدیویی 18 (در بازهٔ 0\(en63) تولید می‌کند که برای انتشار در وب مناسب است.
.PP
گزینهٔ دیگر
.BR ffmpeg2theora (1)
است که\(emبرخلاف نامش\(emیک مبدل Theora-به-Theora نیز هست.
تغییر کیفیت یک فایل ضبط‌شده به کمک آن می‌تواند به همین سادگی باشد:
.RS
$
.B
ffmpeg2theora infile.ogv \-v 3 \-a 4 \-o outfile.ogv
.RE
این ابزار حتی می‌تواند ابعاد هندسی ویدیوی ضبط‌شده را تغییر اندازه داده یا مدت‌زمان کلی آن را تغییر دهد..SH "گزارش باگ‌ها (BUGS)"
.IP \(bu
اگر
.B \-\-full\-shots
مشخص نشده باشد، پنجره‌های سه‌بعدی ضبط نمی‌شوند.
.IP \(bu
ذخیره کردن ۶۵۵۳۶ فایل با نام یکسان منجر به رفتاری غیرقابل‌پیش‌بینی خواهد شد،
که ممکن است به شکل یک حلقهٔ بی‌پایان یا خطای دسترسی به حافظه (segmentation fault) بروز کند.
.\" ...or a full disk.
.SH "نویسندگان (AUTHORS)"
John Varouhakis
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR ffmpeg2theora (1),
.BR jack_lsp (1),
.BR vlc (1),
.BR xwininfo (1)
.\" vim:set et ft=nroff tw=80: