.TH "V4L2-CTL" "1" "March 2015" "v4l-utils 1.32.0" "User Commands"
.SH "نام (NAME)"
v4l2-ctl \- ابزاری برای کنترل درایورهای video4linux
.SH "خلاصه دستور (SYNOPSIS)"
.B v4l2-ctl
[\fI-h\fR] [\fI-d <dev>\fR] [بسیاری گزینه‌های دیگر]
.SH "توضیحات (DESCRIPTION)"
ابزار v4l2-ctl برای کنترل دستگاه‌های video4linux شامل ویدیو، vbi، رادیو یا swradio (هم ورودی و هم خروجی) به کار می‌رود. این ابزار قادر است تقریباً هر جنبه‌ای از چنین دستگاه‌هایی را کنترل کرده و تمام V4L2 API را پوشش دهد.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-A\fR, \fB--list-devices\fR
فهرست کردن تمام دستگاه‌های v4l. اگر \fB-z\fR داده شده باشد، تنها دستگاه‌های متعلق به دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده توسط گزینه \fB-z\fR فهرست می‌شوند.
.TP
\fB\-d\fR, \fB\-\-device\fR \fI<dev>\fR
استفاده از دستگاه \fI<dev>\fR به عنوان دستگاه V4L2.
اگر \fI<dev>\fR با یک رقم آغاز شود، از /dev/video\fI<dev>\fR استفاده می‌شود.
در غیر این صورت اگر پیش‌تر \fB-z\fR مشخص شده باشد، \fI<dev>\fR نام موجودیت (entity name) یا شناسه رابط (interface ID، در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری (topology) دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه \fB-z\fR یافت می‌شود.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال کردن گزارش‌دهی پرگو (verbose).
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه.
.TP
\fB\-w\fR, \fB\-\-wrapper\fR
استفاده از کتابخانه پوششی libv4l2 برای تمام دسترسی‌ها به دستگاه V4L2. به‌طور پیش‌فرض v4l2-ctl مستقیماً به دستگاه V4L2 دسترسی پیدا می‌کند، اما با این گزینه تمام دسترسی‌ها از طریق این کتابخانه پوششی انجام خواهد شد.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ پیام راهنما.
.TP
\fB\-\-help\-io\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن ورودی‌ها و خروجی‌ها، هم ویدیویی و هم صوتی.
.TP
\fB\-\-help\-meta\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های فراداده (metadata).
.TP
\fB\-\-help\-misc\fR
چاپ پیام راهنما برای گزینه‌های متفرقه.
.TP
\fB\-\-help\-overlay\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های overlay و framebuffer.
.TP
\fB\-\-help\-sdr\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های رادیوی نرم‌افزاری (SDR).
.TP
\fB\-\-help\-selection\fR
چاپ پیام راهنما برای تمام گزینه‌های مربوط به انتخاب‌ها (برش و ترکیب‌بندی / cropping and composing).
.TP
\fB\-\-help\-stds\fR
چاپ پیام راهنما برای تمام گزینه‌های مربوط به استانداردهای SDTV و زمان‌بندی‌های ویدیوی دیجیتال.
.TP
\fB\-\-help\-streaming\fR
چاپ پیام راهنما برای تمام گزینه‌های مربوط به جریان‌سازی داده‌ها (streaming).
.TP
\fB\-\-help\-subdev\fR
چاپ پیام راهنما برای تمام گزینه‌های مربوط به دستگاه‌های v4l-subdevX.
.TP
\fB\-\-help\-tuner\fR
چاپ پیام راهنما برای تمام گزینه‌های مربوط به تیونرها و مدولاتورها.
.TP
\fB\-\-help\-vbi\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های VBI.
.TP
\fB\-\-help\-vidcap\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های دریافت/ضبط ویدیو (video capture).
.TP
\fB\-\-help\-vidout\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم/فهرست کردن قالب‌های خروجی ویدیو (video output).
.TP
\fB\-\-help\-edid\fR
چاپ پیام راهنما برای تمام گزینه‌های دریافت/تنظیم EDIDها.
.TP
\fB\-\-help\-all\fR
چاپ پیام راهنما برای تمام گزینه‌ها.
.TP
\fB--all\fR
نمایش تمام اطلاعات موجود.
.TP
\fB-C\fR, \fB--get-ctrl\fR \fI<ctrl>\fR[,\fI<ctrl>\fR...]
دریافت مقدار کنترل‌ها [VIDIOC_G_EXT_CTRLS].
.TP
\fB-c\fR, \fB--set-ctrl\fR \fI<ctrl>\fR=\fI<val>\fR[,\fI<ctrl>\fR=\fI<val>\fR...]
تنظیم مقدار کنترل‌ها [VIDIOC_S_EXT_CTRLS].
.TP
\fB-D\fR, \fB--info\fR
نمایش اطلاعات درایور [VIDIOC_QUERYCAP].
.TP
\fB-e\fR, \fB--out-device\fR \fI<dev>\fR
استفاده از دستگاه \fI<dev>\fR برای جریان‌های خروجی به جای دستگاه پیش‌فرض تنظیم‌شده با \fB--device\fR. اگر \fI<dev>\fR با یک رقم آغاز شود، از /dev/video\fI<dev>\fR استفاده می‌شود.
در غیر این صورت اگر پیش‌تر \fB-z\fR مشخص شده باشد، \fI<dev>\fR نام موجودیت یا شناسه رابط (در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه \fB-z\fR یافت می‌شود.
.TP
\fB-E\fR, \fB--export-device\fR \fI<dev>\fR
استفاده از دستگاه \fI<dev>\fR برای برون‌ریزی بافرهای DMA.
اگر \fI<dev>\fR با یک رقم آغاز شود، از /dev/video\fI<dev>\fR استفاده می‌شود.
در غیر این صورت اگر پیش‌تر \fB-z\fR مشخص شده باشد، \fI<dev>\fR نام موجودیت یا شناسه رابط (در صورت داشتن پیشوند 0x) خواهد بود که در مکان‌نگاری دستگاه چندرسانه‌ای با رشته bus info مشخص‌شده با گزینه \fB-z\fR یافت می‌شود.
.TP
\fB-z\fR, \fB--media-bus-info\fR \fI<bus-info>\fR
یافتن دستگاه چندرسانه‌ای با رشته \fI<bus-info>\fR داده‌شده. در صورت تنظیم، گزینه‌های \fB-d\fR، \fB-e\fR و \fB-E\fR می‌توانند از نام موجودیت یا شناسه رابط برای اشاره به گره‌های دستگاه استفاده کنند. مثال: v4l2-ctl -z platform:vivid-000 -d vivid-000-vid-cap
.TP
\fB-k\fR, \fB--concise\fR
ارائه خروجی خلاصه‌تر در صورت امکان.
.TP
\fB-l\fR, \fB--list-ctrls\fR
نمایش تمام کنترل‌ها و مقادیر آن‌ها [VIDIOC_QUERYCTRL].
.TP
\fB-L\fR, \fB--list-ctrls-menus\fR
نمایش تمام کنترل‌ها و منوهای آن‌ها [VIDIOC_QUERYMENU].
.TP
\fB-r\fR, \fB--subset\fR \fI<ctrl>\fR[,\fI<offset>\fR,\fI<size>\fR]+
زیرمجموعه آرایه N-بعدی برای دریافت/تنظیم جهت کنترل \fI<ctrl>\fR؛ برای هر بعد یک چندتایی (\fI<offset>\fR, \fI<size>\fR) داده می‌شود.
.TP
\fB--list-devices-input\fR \fI<name>\fR
مشابه \fB--list-devices\fR، اما تنها دستگاه‌هایی را نشان می‌دهد که نام ورودی فعلی آن‌ها با \fI<name>\fR مطابقت دارد.
.TP
\fB--list-devices-output\fR \fI<name>\fR
مشابه \fB--list-devices\fR، اما تنها دستگاه‌هایی را نشان می‌دهد که نام خروجی فعلی آن‌ها با \fI<name>\fR مطابقت دارد.
.TP
\fB--log-status\fR
ثبت وضعیت برد در لاگ‌های هسته [VIDIOC_LOG_STATUS].
.TP
\fB--get-priority\fR
پرس‌وجوی اولویت دسترسی فعلی [VIDIOC_G_PRIORITY].
.TP
\fB--set-priority\fR \fI<prio>\fR
تنظیم اولویت دسترسی جدید [VIDIOC_S_PRIORITY].
مقدار \fI<prio>\fR برابر است با 1 (پس‌زمینه)، 2 (تعاملی) یا 3 (ضبط).
.TP
\fB--silent\fR
تنها تنظیم کد نتیجه، بدون چاپ هیچ پیامی.
.TP
\fB--sleep\fR \fI<secs>\fR
توقف به مدت \fI<secs>\fR ثانیه، فراخوانی QUERYCAP و بستن دستگیره فایل.
.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت، 0 برمی‌گرداند. در غیر این صورت، کد خطا را برمی‌گرداند.
.SH "مثال‌ها (EXAMPLES)"
پرس‌وجوی اطلاعات دستگاه /dev/video1:

	v4l2-ctl -d1 -D

جریان‌سازی ویدیو با استفاده از I/O جریانی MMAP از /dev/video0:

	v4l2-ctl -d0 --stream-mmap

جریان‌سازی یک فریم ویدیو از /dev/video0 و ذخیره آن در یک فایل:

	v4l2-ctl --stream-mmap --stream-count=1 --stream-to=file.raw

جریان‌سازی ویدیو از /dev/video0 و ارسال جریانی آن روی شبکه:

	v4l2-ctl --stream-mmap --stream-to-host <hostname>

استفاده از \(aqqvidcap -p\(aq روی میزبان برای مشاهده ویدیو.

جریان‌سازی ویدیو از /dev/video0 با استفاده از DMABUFهای صادرشده از /dev/video2:

	v4l2-ctl --stream-dmabuf --export-device /dev/video2

جریان‌سازی ویدیو از یک دستگاه حافظه-به-حافظه (memory-to-memory):

	v4l2-ctl --stream-mmap --stream-out-mmap

جریان‌سازی ویدیو از یک دستگاه ضبط ویدیویی (/dev/video1) به یک دستگاه خروجی ویدیویی
(/dev/video2):

	v4l2-ctl -d1 --stream-mmap --out-device /dev/video2 --stream-out-dmabuf

.SH "گزارش باگ‌ها (BUGS)"
این صفحه راهنما در حال توسعه و تکمیل است.

گزارش‌های باگ یا سؤالات پیرامون این ابزار باید به فهرست پستی linux-media@vger.kernel.org ارسال شوند.