.TH "QVIDCAP" "1" "June 2016" "v4l-utils 1.32.0" "User Commands"
.SH "نام (NAME)"
qvidcap \- نمایش‌دهنده تصویربرداری ویدئویی v4l2
.SH "خلاصه دستور (SYNOPSIS)"
.B qvidcap
[\fI<options>\fR]
.SH "توضیحات (DESCRIPTION)"
ابزار qvidcap برای آزمایش دستگاه‌های ضبط و دریافت تصویر video4linux، چه از طریق یک دستگاه ویدئویی، یک فایل یا بر بستر شبکه به کار می‌رود. این برنامه همچنین می‌تواند به‌عنوان یک برنامه نمایش‌دهنده عمومی ویدئو/تلویزیون استفاده شود.
.PP
این ابزار (هنوز) از جریان‌های ویدئویی فشرده‌شده به جز MJPEG پشتیبانی نمی‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR, \fB\-\-device\fR=\fI<dev>\fR
استفاده از دستگاه <dev> به‌عنوان دستگاه ویدئویی؛ اگر <dev> یک عدد باشد، از /dev/video<dev> استفاده می‌شود.
.TP
\fB\-f\fR, \fB\-\-file\fR=\fI<file>\fR
خواندن داده‌های خام فریم از فایل <file>.
.TP
\fB\-p\fR, \fB\-\-port\fR\fI[=<port>]\fR
گوش دادن به یک اتصال شبکه روی درگاه مشخص‌شده. درگاه پیش‌فرض 8362 است.
.TP
\fB\-T\fR, \fB\-\-tpg\fR
استفاده از سازنده الگوی آزمایشی (test pattern generator). اگر هیچ‌یک از گزینه‌های \-d، \-f یا \-T مشخص نشده باشد، از /dev/video0 استفاده خواهد شد.
.TP
\fB\-c\fR, \fB\-\-count\fR=\fI<cnt>\fR
توقف پس از دریافت و ضبط <cnt> فریم.
.TP
\fB\-b\fR, \fB\-\-buffers\fR=\fI<bufs>\fR
درخواست <bufs> بافر (پیش‌فرض ۴) هنگام استریم از یک دستگاه ویدئویی.
.TP
\fB\-s\fR, \fB\-\-single\-step\fR\fI[=<frm>]\fR
شروع با فریم <frm> (پیش‌فرض ۰) و توقف پس از نمایش هر فریم تا زمانی که کلید Space فشرده شود.
.TP
\fB\-C\fR, \fB\-\-colorspace\fR=\fI<c>\fR
نادیده گرفتن فضای رنگ (colorspace). مقدار <c> می‌تواند یکی از فضاهای رنگ زیر باشد: smpte170m، smpte240m، rec709، 470m، 470bg، jpeg، srgb، oprgb، bt2020، dcip3
.TP
\fB\-X\fR, \fB\-\-xfer-func\fR=\fI<x>\fR
نادیده گرفتن تابع انتقال (transfer function). مقدار <x> می‌تواند یکی از توابع انتقال زیر باشد: default، 709، srgb، oprgb، smpte240m، smpte2084، dcip3، none
.TP
\fB\-Y\fR, \fB\-\-ycbcr-enc\fR=\fI<y>\fR
نادیده گرفتن کدگذاری Y'CbCr. مقدار <y> می‌تواند یکی از کدگذاری‌های Y'CbCr زیر باشد: default، 601، 709، xv601، xv709، bt2020، bt2020c، smpte240m
.TP
\fB\-Q\fR, \fB\-\-quant\fR=\fI<q>\fR
نادیده گرفتن کوانتیزاسیون. مقدار <q> می‌تواند یکی از روش‌های کوانتیزاسیون زیر باشد: default، full-range، lim-range
.TP
\fB\-P\fR, \fB-\-pixelformat\fR=\fI<p>\fR
برای دستگاه‌های ویدئویی: قالب را به این قالب پیکسلی تنظیم می‌کند.
برای خواندن از فایل: داده‌ها را بر اساس این تنظیم قالب پیکسلی تفسیر می‌کند.
در حالت‌های دیگر نادیده گرفته می‌شود.
برای مشاهده فهرست قالب‌های پیکسلی پشتیبانی‌شده از گزینه \-l استفاده کنید.
.TP
\fB\-l\fR, \fB\-\-list-formats\fR
نمایش تمام قالب‌های پشتیبانی‌شده.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما.
.TP
\fB\-t\fR, \fB\-\-timing\fRs
گزارش زمان‌بندی رندر فریم‌ها.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش اطلاعات با جزئیات بیشتر.
.TP
\fB\-R\fR, \fB\-\-raw\fR
باز کردن دستگاه در حالت خام (raw).
.TP
\fB\--opengl\fR
اجبار به استفاده از openGL برای نمایش ویدئو.
.TP
\fB\--opengles\fR
اجبار به استفاده از openGL ES برای نمایش ویدئو.
.TP
گزینه‌های زیر هنگام ضبط از یک دستگاه ویدئویی نادیده گرفته می‌شوند:
.TP
\fB\-W,-\-width\fR=\fI<width>\fR
تنظیم عرض.
.TP
\fB\-H,-\-height\fR=\fI<height>\fR
تنظیم ارتفاع فریم (نه فیلد!).
.TP
\fB\-A,-\-padding\fR=\fI<bytes>\fR
تنظیم فاصله خالی (padding) افقی اضافی (پس از عرض).
.TP
\fB--fps\fR=\fI<fps>\fR
تنظیم فریم بر ثانیه (پیش‌فرض ۳۰ است).
.TP
گزینه‌های زیر تنها هنگام خواندن از یک فایل معتبر هستند:
.TP
\fB\-F\fR, \fB-\-field\fR=\fI<f>\fR
نادیده گرفتن تنظیم فیلد. مقدار <f> می‌تواند یکی از ساختارهای فیلد زیر باشد: any، none، top، bottom، interlaced، seq_tb، seq_bt، alternate، interlaced_tb، interlaced_bt
.TP
\fB\-\-no\-loop\fR
توقف در انتهای فایل؛ عدم تکرار پخش از ابتدا.
.TP
\fB\-\-from\-frame\fR=\fI<frame>\fR
شروع بازپخش فایل از شماره فریم مشخص‌شده (نخستین فریم، فریم ۰ است).
.TP
گزینه‌های زیر مختص سازنده الگوی آزمایشی هستند:
.TP
\fB--list-patterns\fR
فهرست الگوهای موجود برای استفاده با گزینه \-\-pattern.
.TP
\fB--pattern\fR=\fI<pat>\fR
انتخاب الگوی آزمایشی خروجی؛ پیش‌فرض 0 است.
.TP
\fB--square\fR
نمایش یک مربع در مرکز الگوی آزمایشی خروجی.
.TP
\fB--border\fR
نمایش یک حاشیه در اطراف ویدئو دارای نوار سیاه کناری یا بالایی/پایینی (pillar/letterbox).
.TP
\fB--sav\fR
درج یک کد SAV در هر خط.
.TP
\fB--eav\fR
درج یک کد EAV در هر خط.
.TP
\fB--pixel-aspect\fR=\fI<aspect>\fR
انتخاب نسبت تصویر پیکسلی؛ پیش‌فرض تشخیص خودکار است. مقدار <aspect> می‌تواند یکی از موارد زیر باشد: square، ntsc، pal
.TP
\fB--video-aspect\fR=\fI<aspect>\fR
انتخاب نسبت تصویر ویدئو؛ پیش‌فرض استفاده از نسبت فریم است. مقدار <aspect> می‌تواند یکی از موارد زیر باشد: 4x3، 14x9، 16x9، anamorphic
.TP
\fB--alpha\fR=\fI<alpha-value>\fR
مقدار مورد استفاده برای مؤلفه آلفا (alpha) در محدوده ۲۵۵-۰؛ پیش‌فرض 0 است.
.TP
\fB--alpha-red-only\fR
استفاده از مقدار \-\-alpha تنها برای رنگ‌های قرمز؛ برای سایر رنگ‌ها از 0 استفاده می‌شود.
.TP
\fB--rgb-lim-range\fR
کدگذاری مقادیر RGB به‌صورت محدوده محدود [16-235] به جای محدوده کامل (full range).
.TP
\fB--hor-speed\fR=\fI<speed>\fR
انتخاب سرعت حرکت افقی؛ پیش‌فرض 0 است و بازه آن [3...3\-] می‌باشد.
.TP
\fB--vert-speed\fR=\fI<speed>\fR
انتخاب سرعت حرکت عمودی؛ پیش‌فرض 0 است و بازه آن [3...3\-] می‌باشد.
.TP
\fB--perc-fill\fR=\fI<percentage>\fR
درصد فریم برای پر کردن واقعی؛ پیش‌فرض %100 است.
.TP
این گزینه‌ها از سازنده الگوی آزمایشی برای آزمودن بک‌اند OpenGL استفاده می‌کنند:
.TP
\fB--test\fR=\fI<count>\fR
آزمودن تمام قالب‌ها؛ هر آزمون <count> فریم تولید می‌کند.
.TP
\fB--test-mask\fR=\fI<mask>\fR
ماسک مشخص‌کننده اینکه کدام آزمون‌ها اجرا شوند. مقدار <mask\> یک ماسک بیتی با این مقادیر است:
.br
0x01: ماسک پیمایش روی قالب‌های پیکسلی
.br
0x02: ماسک پیمایش روی فیلدها
.br
0x04: ماسک پیمایش روی فضاهای رنگ
.br
0x08: ماسک پیمایش روی توابع انتقال
.br
0x10: ماسک پیمایش روی کدگذاری‌های Y'CbCr
.br
0x20: ماسک پیمایش روی محدوده‌های کوانتیزاسیون
.SH "کلیدهای میانبر (HOTKEYS)"
.TP
\fIQ\fR
خروج از برنامه.
.TP
\fIP\fR
پیمایش رو به جلو در میان تمام قالب‌های پیکسلی پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی قالب پیکسلی اصلی.
تنها با گزینه \-\-file در دسترس است.
.TP
\fII\fR
پیمایش رو به جلو در میان تمام تنظیمات فیلد اینترلیسد پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی تنظیم فیلد اینترلیسد اصلی.
تنها با گزینه \-\-file در دسترس است.
.TP
\fIC\fR
پیمایش رو به جلو در میان تمام فضاهای رنگ پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی فضای رنگ اصلی.
.TP
\fIX\fR
پیمایش رو به جلو در میان تمام توابع انتقال پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی تابع انتقال اصلی.
.TP
\fIY\fR
پیمایش رو به جلو در میان تمام کدگذاری‌های Y'CbCr پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی کدگذاری Y'CbCr اصلی.
.TP
\fIH\fR
پیمایش رو به جلو در میان تمام کدگذاری‌های HSV پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی کدگذاری HSV اصلی.
.TP
\fIR\fR
پیمایش رو به جلو در میان تمام محدوده‌های کوانتیزاسیون پشتیبانی‌شده.
همراه با کلید Shift: پیمایش رو به عقب.
همراه با کلید Ctrl: بازگردانی محدوده کوانتیزاسیون اصلی.
.TP
\fIRight-Click\fR
باز کردن منو.
.TP
\fIDouble left-click\fR
فعال یا غیرفعال کردن حالت تمام‌صفحه.
.TP
\fIF\fR
فعال یا غیرفعال کردن حالت تمام‌صفحه.
.TP
\fIESC\fR
خروج از حالت تمام‌صفحه.
.TP
\fISpace\fR
در حالت آزمایشی (\fB\-\-test\fR)، فشردن کلید Space به آزمون بعدی می‌رود.
هنگام گام‌به‌گام (single-stepping)، رفتن به فریم بعدی. هنگام خواندن از یک فایل،
مکث در پخش تا فشردن بعدی کلید Space.
.TP
\fIBackspace\fR
هنگام گام‌به‌گام، بازگشت به فریم قبلی.
.TP
\fIUp\fR
کاهش وضوح به اندازه دو پیکسل در ارتفاع. تنها زمانی که «Override resolution» فعال باشد در دسترس است.
.TP
\fIDown\fR
افزایش وضوح به اندازه دو پیکسل در ارتفاع. تنها زمانی که «Override resolution» فعال باشد در دسترس است.
.TP
\fILeft\fR
کاهش وضوح به اندازه دو پیکسل در عرض. تنها زمانی که «Override resolution» فعال باشد در دسترس است.
.TP
\fIRight\fR
افزایش وضوح به اندازه دو پیکسل در عرض. تنها زمانی که «Override resolution» فعال باشد در دسترس است.
.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت، مقدار 0 برگردانده می‌شود. در غیر این صورت، تعداد خطاها برگردانده خواهد شد.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به Hans Verkuil <hverkuil@kernel.org>