'\" t
.\"     Title: gphoto2
.\"    Author: The gPhoto2 Team
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: <pubdate>2015-08-01</pubdate>August 2006
.\"    Manual: The gPhoto2 Reference (the man pages)
.\"    Source: [FIXME: source]
.\"  Language: Persian
.\"
.TH "GPHOTO2" "1" "<pubdate>2015-08-01</pubdate>August 2006" "[FIXME: source]" "The gPhoto2 Reference (the man"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
gphoto2 \- کلاینت خط فرمانی gphoto2
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBgphoto2\fR\ 'u
\fBgphoto2\fR [\-\-debug] [\-\-debug\-logfile\ \fIFILENAME\fR] [\-\-debug\-loglevel\ \fILEVEL\fR] [[\-q] | [\-\-quiet]] [[\-v] | [\-\-verbose]] [[\-h] | [\-\-help]] [\-\-usage]
.br
[\-\-hook\-script\ \fIFILENAME\fR]
.br
[\-\-list\-cameras] [\-\-list\-ports] [\-\-stdout] [\-\-stdout\-size] [\-\-parsable]
.br
[\-\-auto\-detect] [\-\-port\ \fIPATH\fR] [\-\-speed\ \fISPEED\fR] [\-\-camera\ \fIMODEL\fR]
.br
[\-\-filename\ \fIFILENAME\fR] [\-\-filenumber\ \fIFILENUMBER\fR]
.br
[\-\-usbid\ \fIUSBIDS\fR]
.br
[[\-a] | [\-\-abilities]]
.br
[[\-\-folder\ \fIFOLDER\fR] | [\-f\ \fIFOLDER\fR]] [[[\-R] | [\-\-recurse]] | [\-\-no\-recurse]]
.br
[[\-l] | [\-\-list\-folders]]
.br
[[\-L] | [\-\-list\-files]] [[\-m\ \fINAME\fR] | [\-\-mkdir\ \fINAME\fR]]
.br
[[\-r\ \fINAME\fR] | [\-\-rmdir\ \fINAME\fR]] [[\-n] | [\-\-num\-files]]
.br
[[\-p\ \fIRANGE\ or\ NAME\fR] | [\-\-get\-file\ \fIRANGE\ or\ NAME\fR]] [[\-P] | [\-\-get\-all\-files]]
.br
[[\-t\ \fIRANGE\ or\ NAME\fR] | [\-\-get\-thumbnail\ \fIRANGE\ or\ NAME\fR]]
.br
[[\-T] | [\-\-get\-all\-thumbnails]]
.br
[\-\-get\-raw\-data\ \fIRANGE\ or\ NAME\fR] [\-\-get\-all\-raw\-data]
.br
[\-\-get\-audio\-data\ \fIRANGE\ or\ NAME\fR] [\-\-get\-all\-audio\-data]
.br
[\-\-get\-exif\ \fIRANGE\ or\ NAME\fR] [\-\-get\-all\-exif]
.br
[\-\-get\-metadata\ \fIRANGE\ or\ NAME\fR] [\-\-get\-all\-metadata] [\-\-upload\-metadata\ \fIFILENAME\fR]
.br
[\-\-force\-overwrite]
.br
[\-\-new]
.br
[[\-d\ \fIRANGE\ or\ NAME\fR] | [\-\-delete\-file\ \fIRANGE\ or\ NAME\fR]] [[\-D] | [\-\-delete\-all\-files]]
.br
[[\-u\ \fIFILENAME\fR] | [\-\-upload\-file\ \fIFILENAME\fR]] [\-\-config]
.br
[\-\-list\-config] [\-\-list\-all\-config]
.br
[\-\-get\-config\ \fICONFIGENTRY\fR] [\-\-set\-config\ \fICONFIGENTRY=CONFIGVALUE\fR] [\-\-set\-config\-index\ \fICONFIGENTRY=CONFIGINDEX\fR] [\-\-set\-config\-value\ \fICONFIGENTRY=CONFIGVALUE\fR] [\-\-reset]
.br
[\-\-capture\-preview] [\-\-show\-preview]
.br
[[\-F\ \fICOUNT\fR] | [\-\-frames\ \fICOUNT\fR]] [[\-I\ \fISECONDS\fR] | [\-\-interval\ \fISECONDS\fR]]
.br
[\-\-reset\-interval]
.br
[\-\-capture\-image] [\-\-trigger\-capture] [\-\-capture\-movie\ \fISECONDS\ or\ COUNT\fR] [\-\-capture\-sound]
.br
[\-\-capture\-tethered\ \fISECONDS,\ COUNT\ or\ STRING\fR]
.br
[\-\-wait\-event\ \fISECONDS,\ COUNT\ or\ STRING\fR] [\-\-wait\-event\-and\-download\ \fISECONDS,\ COUNT\ or\ STRING\fR]
.br
[\-\-keep] [\-\-no\-keep]
.br
[\-\-reverse]
.br
[\-\-show\-info\ \fIRANGE\ or\ NAME\fR]
.br
[\-\-show\-exif\ \fIRANGE\ or\ NAME\fR]
.br
[\-\-storage\-info]
.br
[\-\-summary]
.br
[\-\-manual]
.br
[\-\-about]
.br
[\-\-shell]
.SH "توضیحات (DESCRIPTION)"
.PP
کتابخانه
libgphoto2(3)
یک کتابخانه چندسکویی برای دوربین‌های دیجیتال است و
gphoto2(1)
یک کلاینت خط فرمان برای آن می‌باشد\&.
.PP
در مواردی که یک گزینه
\fIRANGE\fR
(محدوده) فایل‌ها، بندانگشتی‌ها یا سایر داده‌ها را می‌پذیرد، شماره‌گذاری آن‌ها از ۱ آغاز می‌شود\&. یک محدوده، فهرستی از اعداد یا بازه‌ها (\(lq\fIfirst\fR\-\fIlast\fR\(rq) است که با کاما از هم جدا شده‌اند\&. محدوده‌ها به صورت XOR (یا مانعه‌الجمع) اعمال می‌شوند، به طوری که
\(lq1\-5,3,7\(rq
معادل
\(lq1,2,4,5,7\(rq
است\&.
.PP
\fB\-\-debug\fR
.RS 4
فعال‌سازی خروجی اشکال‌زدایی (دیباگ)\&. خروجی اشکال‌زدایی به صورت پیش‌فرض در stderr یا در نام فایل مشخص‌شده با گزینه
\fB\-\-debug\-logfile\fR
نوشته می‌شود\&.
.RE
.PP
\fB\-\-debug\-logfile\fR \fIFILENAME\fR (از نسخه 2\&.3\&.0)
.RS 4
فایل لاگی که در صورت مشخص شدن
\fB\-\-debug\fR
، اطلاعات اشکال‌زدایی در آن نوشته می‌شود\&.
.RE
.PP
\fB\-\-debug\-loglevel\fR \fILEVEL\fR (از نسخه 2\&.5\&.5)
.RS 4
میزان جزئیات لاگ‌های اشکال‌زدایی\&. مقادیر مجاز به ترتیب افزایش جزئیات عبارتند از:
\fBerror\fR,
\fBdebug\fR,
\fBdata\fR,
\fBall\fR\&. مقدار پیش‌فرض
\fBall\fR
است\&.
.RE
.PP
\fB\-\-hook\-script\fR \fIFILENAME\fR (جدید پس از 2\&.3\&.0)
.RS 4
اجرای اسکریپت قلاب (hook script)
\fIFILENAME\fR
در هر بار وقوع رویدادی خاص در
\fBgphoto2\fR\&.
اسکریپت قلاب متغیر محیطی
\fBACTION\fR
را می‌خواند\&. این اسکریپت باید مقادیر ناشناخته
\fBACTION\fR
را نادیده بگیرد\&.
.PP
\fBACTION\fR=init
.RS 4
دستور
\fBgphoto2\fR
به‌تازگی مقداردهی اولیه شده است\&. اگر اسکریپت قلاب اکنون کد خروج غیرصفر بازگرداند،
\fBgphoto2\fR
متوقف خواهد شد\&.
.RE
.PP
\fBACTION\fR=start
.RS 4
دستور
\fBgphoto2\fR
به‌تازگی تحلیل خط فرمان را به پایان رسانده و در شرف آغاز اجرای دستورات مشخص‌شده در خط فرمان است\&.
.RE
.PP
\fBACTION\fR=download
.RS 4
دستور
\fBgphoto2\fR
به‌تازگی فایلی را در رایانه بارگیری کرده و آن را در فایلی که با متغیر محیطی
\fBARGUMENT\fR
مشخص شده ذخیره کرده است\&.
.RE
.PP
\fBACTION\fR=stop
.RS 4
دستور
\fBgphoto2\fR
در شرف پایان کار است\&. پاک‌سازی‌های نهایی خود را در اینجا انجام دهید\&.
.RE
.sp
تمام متغیرهای محیطی دیگر بدون تغییر به اسکریپت قلاب ارسال می‌شوند\&. می‌توانید از این ویژگی برای ارسال داده‌ها به اسکریپت قلاب استفاده کنید\&.
.sp
اسکریپت قلاب را می‌توان در فایل
~/\&.gphoto/settings
به صورت
\fBgphoto2=hook\-script=\fR\fIfilename\fR
مشخص کرد\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
خروجی بی‌صدا (پیش‌فرض=همراه با جزئیات کامل)\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
نمایش نسخه و خروج\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌ها و توضیحات کوتاه\&.
.RE
.PP
\fB\-\-usage\fR
.RS 4
نمایش پیام کوتاه نحوه استفاده\&.
.RE
.PP
\fB\-\-list\-cameras\fR
.RS 4
فهرست کردن مدل‌های دوربین پشتیبانی‌شده\&.
.RE
.PP
\fB\-\-list\-ports\fR
.RS 4
فهرست کردن دستگاه‌های پورت پشتیبانی‌شده\&.
.RE
.PP
\fB\-\-stdout\fR
.RS 4
ارسال فایل به خروجی استاندارد (stdout)\&.
.RE
.PP
\fB\-\-stdout\-size\fR
.RS 4
چاپ اندازه فایل پیش از داده‌ها\&.
.RE
.PP
\fB\-\-parsable\fR
.RS 4
خروجی فهرست فایل‌ها را در قالب خط‌به‌خط ارائه می‌دهد تا بتوان آن را به یک اسکریپت شل یا فیلتر دیگری ارسال کرد\&.
.RE
.PP
\fB\-\-auto\-detect\fR
.RS 4
فهرست کردن دوربین‌های شناسایی‌شده خودکار و پورت‌هایی که به آن‌ها متصل هستند\&.
.RE
.PP
\fB\-\-port\fR \fIPATH\fR
.RS 4
مشخص کردن دستگاه پورت\&. گزینه
\fB\-\-list\-ports\fR
فهرستی از پورت‌های معتبر و قابل استفاده را چاپ می‌کند\&. در صورت وجود چندین دوربین USB، گزینه
\fB\-\-auto\-detect\fR
پورت خاصی را که هر دوربین به آن متصل است نشان می‌دهد\&.
.RE
.PP
\fB\-\-speed\fR \fISPEED\fR
.RS 4
مشخص کردن سرعت انتقال سریال\&.
.RE
.PP
\fB\-\-camera\fR \fIMODEL\fR
.RS 4
مشخص کردن مدل دوربین\&. گزینه
\fB\-\-list\-cameras\fR
فهرستی از تمام دوربین‌های صراحتاً پشتیبانی‌شده را چاپ می‌کند\&.
.sp
بیشتر نام‌های مدل حاوی فاصله هستند: به یاد داشته باشید که نام را در کوتیشن قرار دهید تا شل بداند که یک پارامتر واحد است؛ برای مثال:
\fB\fB\-\-camera\fR\fR\fB "Kodak DC240"\fR\&.
.sp
توجه داشته باشید که اگر
\fB\fB\-\-camera\fR\fR
را مشخص کنید، باید
\fB\fB\-\-port\fR\fR
را نیز مشخص نمایید\&. در غیر این صورت گزینه
\fB\fB\-\-camera\fR\fR
بدون هیچ پیامی نادیده گرفته خواهد شد\&.
.RE
.PP
\fB\-\-filename\fR \fIFILENAME\fR
.RS 4
هنگام بارگیری فایل‌ها از دوربین، نام فایل یا الگوی نام فایلی را مشخص می‌کند که برای ذخیره فایل بارگیری‌شده روی دیسک محلی استفاده می‌شود\&. هنگام بارگذاری فایل به دوربین، نام فایلی را مشخص می‌کند که فایل بارگذاری‌شده تحت آن روی دوربین ذخیره می‌شود\&.
.sp
گزینه
\fB\-\-filename\fR
الگوهای %a, %A, %b, %B, %d, %H, %k, %I, %l, %j, %m, %M, %S, %y, %% (به date(1) مراجعه کنید) و علاوه بر آن، %n برای شماره، %C برای پسوند نام فایل، %f برای نام فایل بدون پسوند، %F برای نام پوشه و %: برای نام کامل فایل با حروف کوچک را می‌پذیرد\&.
.sp
توجه داشته باشید که %: هنوز در مرحله آلفا است و نویسه یا نحو واقعی آن ممکن است تغییر کند؛ مثلاً ممکن است استفاده از %#f و %#C برای نسخه‌های با حروف کوچک و %^f و %^C برای نسخه‌های با حروف بزرگ امکان‌پذیر شود\&.
.sp
الگوی %n تنها مشخص‌کننده تبدیلی است که نویسه پرکننده (padding) و عرض را می‌پذیرد: %03n با صفر تا عرض ۳ پر می‌کند (مثلاً عدد ۷ را به صورت
\(lq007\(rq
چاپ می‌کند)\&. حذف نویسه پرکننده (مانند %3n) از نویسه پرکننده پیش‌فرض وابسته به پیاده‌سازی استفاده می‌کند که ممکن است برای استفاده در نام فایل‌ها مناسب باشد یا نباشد\&.
.sp
مقدار پیش‌فرض این گزینه را می‌توان در فایل
~/\&.gphoto/settings
به صورت
\fBgphoto2=filename=value\fR
مشخص کرد\&.
.RE
.PP
\fB\-\-filenumber\fR \fIFILENUMBER\fR
.RS 4
اگر نام فایل را با استفاده از گزینه
\fB\-\-filename\fR
و الگوی %n مشخص کنید، این الگو معمولاً از ۱ شروع می‌شود\&. برای استفاده افزایشی، می‌توانید از
\fB\-\-filenumber\fR
استفاده کنید تا از عدد دیگری (FILENUMBER) شروع شود\&.
.RE
.PP
\fB\-\-usbid\fR \fI\fIUSBIDS\fR\fR
.RS 4
(تنها برای کاربران حرفه‌ای) بازنویسی شناسه‌های
USB\&.
مقدار
\fI \fR\fI\fIUSBIDS\fR\fR
باید به شکل
\fI \fR\fI\fIDetectedVendorID\fR\fR\fI:\fR\fI\fIDetectedProductID\fR\fR\fI=\fR\fI\fITreatAsVendorID\fR\fR\fI:\fR\fI\fITreatAsProductID\fR\fR
باشد تا هر دستگاه USB شناسایی‌شده به عنوان
\fI\fIDetectedVendorID\fR\fR\fI:\fR\fI\fIDetectedProductID\fR\fR
در عوض به عنوان
\fI\fITreatAsVendorID\fR\fR\fI:\fR\fI\fITreatAsProductID\fR\fR
در نظر گرفته شود\&. تمام VendorIDها و ProductIDها باید اعداد هگزادسیمال با نمادگذاری زبان C باشند، یعنی با \*(Aq0x\*(Aq شروع شوند\&.
.sp
مثال:
\fB\-\-usbid \fR\fB\fI0x4a9:0x306b=0x4a9:0x306c\fR\fR
.RE
.PP
\fB\-a\fR, \fB\-\-abilities\fR
.RS 4
نمایش قابلیت‌های دوربین و درایور مشخص‌شده در درایور libgphoto2\&. این کار دوربین را مورد پرس‌وجو قرار نمی‌دهد، بلکه از داده‌های ارائه‌شده توسط کتابخانه استفاده می‌کند\&. برای دریافت نمای کلی از وضعیت دوربین، از گزینه
\fB\-\-summary\fR
استفاده کنید\&.
.RE
.PP
\fB\-f\fR, \fB\-\-folder\fR \fIFOLDER\fR
.RS 4
مشخص کردن پوشه دوربین (پیش‌فرض="/")\&.
.RE
.PP
\fB\-R\fR, \fB\-\-recurse\fR
.RS 4
پیمایش بازگشتی (پیش‌فرض برای بارگیری)\&.
.RE
.PP
\fB\-\-no\-recurse\fR
.RS 4
عدم پیمایش بازگشتی (پیش‌فرض برای حذف)\&.
.RE
.PP
\fB\-l\fR, \fB\-\-list\-folders\fR
.RS 4
فهرست کردن پوشه‌های موجود در پوشه جاری\&.
.RE
.PP
\fB\-L\fR, \fB\-\-list\-files\fR
.RS 4
فهرست کردن فایل‌های موجود در پوشه جاری\&.
.RE
.PP
\fB\-m\fR, \fB\-\-mkdir\fR \fINAME\fR
.RS 4
ایجاد یک دایرکتوری\&.
.RE
.PP
\fB\-r\fR, \fB\-\-rmdir\fR \fINAME\fR
.RS 4
حذف یک دایرکتوری\&.
.RE
.PP
\fB\-n\fR, \fB\-\-num\-files\fR
.RS 4
نمایش تعداد فایل‌ها\&.
.RE
.PP
\fB\-p\fR, \fB\-\-get\-file\fR \fIRANGE\fR
.RS 4
دریافت فایل‌های مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-P\fR, \fB\-\-get\-all\-files\fR
.RS 4
دریافت تمام فایل‌ها از پوشه\&.
.RE
.PP
\fB\-t\fR, \fB\-\-get\-thumbnail\fR \fIRANGE\fR
.RS 4
دریافت تصاویر بندانگشتی مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-T\fR, \fB\-\-get\-all\-thumbnails\fR
.RS 4
دریافت تمام تصاویر بندانگشتی از پوشه\&.
.RE
.PP
\fB\-\-get\-raw\-data\fR \fIRANGE\fR
.RS 4
دریافت داده‌های خام مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-\-get\-all\-raw\-data\fR
.RS 4
دریافت تمام داده‌های خام از پوشه\&.
.RE
.PP
\fB\-\-get\-audio\-data\fR \fIRANGE\fR
.RS 4
دریافت داده‌های صوتی مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-\-get\-all\-audio\-data\fR
.RS 4
دریافت تمام داده‌های صوتی از پوشه\&.
.RE
.PP
\fB\-\-get\-exif\fR \fIRANGE\fR
.RS 4
دریافت داده‌های Exif مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-\-get\-all\-exif\fR
.RS 4
دریافت تمام داده‌های Exif از پوشه\&.
.RE
.PP
\fB\-\-upload\-metadata\fR \fIFILENAME\fR
.RS 4
بارگذاری متاداده برای فایل مشخص‌شده، که از فایلی با پیشوند _meta گرفته می‌شود\&.
.RE
.PP
\fB\-\-get\-metadata\fR \fIRANGE\fR
.RS 4
دریافت متاداده‌های مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-\-get\-all\-metadata\fR
.RS 4
دریافت تمام متاداده‌ها از پوشه\&.
.RE
.PP
\fB\-\-force\-overwrite\fR
.RS 4
بازنویسی فایل‌ها بدون پرسش\&.
.RE
.PP
\fB\-\-skip\-existing\fR
.RS 4
رد کردن فایل‌ها در صورتی که در دایرکتوری محلی از قبل وجود داشته باشند\&.
.RE
.PP
\fB\-\-new\fR
.RS 4
تنها دریافت فایل‌هایی که پیش از این بارگیری نشده‌اند\&. این گزینه به پشتیبانی دوربین از نشانه‌گذاری تصاویر قبلاً بارگیری‌شده بستگی دارد و برای تمام درایورها در دسترس نیست\&.
.RE
.PP
\fB\-d\fR, \fB\-\-delete\-file\fR \fIRANGE\fR
.RS 4
حذف فایل‌های مشخص‌شده در محدوده\&.
.RE
.PP
\fB\-D\fR, \fB\-\-delete\-all\-files\fR
.RS 4
حذف تمام فایل‌های موجود در پوشه (پیش‌فرض
\fB\-\-no\-recurse\fR
است)\&.
.RE
.PP
\fB\-u\fR, \fB\-\-upload\-file\fR \fIFILENAME\fR
.RS 4
بارگذاری یک فایل به دوربین\&.
.RE
.PP
\fB\-\-capture\-preview\fR
.RS 4
ثبت یک پیش‌نمایش سریع\&.
.RE
.PP
\fB\-B\fR\fB\-\-bulb\fR \fISECONDS\fR
.RS 4
عکاسی بالب (bulb capture) برای مدت زمان مشخص‌شده بر حسب ثانیه\&.
.RE
.PP
\fB\-\-show\-preview\fR
.RS 4
ثبت یک پیش‌نمایش سریع و نمایش آن در ترمینال با استفاده از هنر اسکی (Ascii Art) (در صورتی که برنامه با aalib ساخته شده باشد)\&.
.RE
.PP
\fB\-F \fR\fB\fICOUNT\fR\fR, \fB\-\-frames \fR\fB\fICOUNT\fR\fR
.RS 4
تعداد فریم‌هایی که در یک بار اجرا ثبت می‌شوند\&. پیش‌فرض تعداد فریم‌های نامحدود است\&.
.RE
.PP
\fB\-I \fR\fB\fISECONDS\fR\fR, \fB\-\-interval \fR\fB\fISECONDS\fR\fR
.RS 4
فاصله زمانی بین ثبت چندین فریم\&.
.sp
(از نسخه 2\&.4) در صورت دریافت سیگنال
SIGUSR1،
بدون انتظار برای اتمام دوره بازه زمانی فعلی، بلافاصله یک عکس گرفته می‌شود (به بخش
\(lqسیگنال‌ها (SIGNALS)\(rq
مراجعه کنید)\&. مقدار 1\- باعث می‌شود gphoto2 برای همیشه (یعنی تا زمان رسیدن سیگنال) منتظر بماند\&. همچنین به
\fB\-\-reset\-interval\fR
مراجعه کنید\&.
.RE
.PP
\fB\-\-reset\-interval\fR
.RS 4
تنظیم این گزینه باعث می‌شود هنگام دریافت سیگنال
SIGUSR1
در حالت تایم‌لپس، بازه زمانی به مقدار داده‌شده توسط گزینه
\fB\-I|\-\-interval\fR
بازنشانی شود\&.
.RE
.PP
\fB\-\-capture\-image\fR
.RS 4
ثبت یک تصویر و نگه‌داشتن آن روی دوربین\&.
.RE
.PP
\fB\-\-capture\-image\-and\-download\fR
.RS 4
ثبت یک تصویر و بارگیری فوری آن در رایانه\&.
.RE
.PP
\fB\-\-trigger\-capture\fR
.RS 4
شروع فرایند ثبت تصویر و بازگشت\&. اگر می‌خواهید تصویر بارگیری شود، به \-\-wait\-event\-and\-download مراجعه کنید\&.
.sp
این قابلیت تنها برای برخی از برندهای دوربین و درایورها در دسترس است\&.
.RE
.PP
\fB\-\-reverse\fR
.RS 4
هنگام انجام عملیات فایل مانند \-\-get\-all\-files، \-P یا \-T ترتیب بارگیری فایل‌ها را معکوس می‌کند\&.
.RE
.PP
\fB\-\-keep\fR
.RS 4
هنگام استفاده از \-\-capture\-image\-and\-download یا ثبت با بازه زمانی، این گزینه تصاویر را روی کارت حافظه دوربین نگه می‌دارد\&.
.RE
.PP
\fB\-\-no\-keep\fR
.RS 4
هنگام استفاده از \-\-capture\-image\-and\-download یا ثبت با بازه زمانی، این گزینه پس از بارگیری تصاویر در حین ثبت، آن‌ها را روی کارت حافظه دوربین نگه نمی‌دارد (پیش‌فرض)\&.
.RE
.PP
\fB\-\-keep\-raw\fR
.RS 4
هنگام استفاده از \-\-capture\-image\-and\-download یا ثبت با بازه زمانی، این گزینه تصاویر RAW را روی کارت حافظه دوربین نگه می‌دارد، اما تصاویر JPEG را همچنان بارگیری می‌کند\&. این ویژگی هنگام عکاسی دوحالته (dual mode) و زمانی که می‌خواهید تصاویر JPEG را در حین عکاسی بازبینی کنید مفید است\&.
.RE
.PP
\fB\-\-capture\-movie \fR\fB\fISECONDS\fR\fR
.RS 4
ضبط ویدیو\&. اگر دوربین از پیش‌نمایش پشتیبانی کند، این گزینه جریانی از فریم‌های پیش‌نمایش (motion\-jpeg) را با بیشترین سرعت ممکن دوربین ثبت می‌کند\&.
.sp
اگر هیچ آرگومانی مشخص نشود، تا زمانی که کلیدهای Ctrl\-C را فشار دهید فریم‌های پیش‌نمایش را ثبت می‌کند\&. آرگومان‌های قابل تعیین یا مدت زمان ثبت بر حسب ثانیه هستند یا تعداد فریم‌های پیش‌نمایش\&.
.RE
.PP
\fB\-\-capture\-sound\fR
.RS 4
ضبط یک کلیپ صوتی\&. در حال حاضر هیچ درایوری از این ویژگی پشتیبانی نمی‌کند\&.
.RE
.PP
\fB\-\-capture\-tethered \fR\fB\fISECONDS, MILLISECONDS, COUNT or MATCHSTRING\fR\fR
.RS 4
به gphoto2 امکان می‌دهد منتظر اعلان‌های دوربین مبنی بر اضافه شدن یک شیء (تصویر) بماند\&. این ویژگی برای عکاسی متصل (tethered capture) مفید است، جایی که فشردن شاتر روی دوربین بلافاصله تصویر را برای پردازش به دستگاه منتقل می‌کند\&.
.sp
ترکیب این گزینه با
\fB\-\-hook\-script\fR
برای پردازش ثانویه فوری یا نمایش تصاویر می‌تواند به گردش کار استودیویی کمک کند\&.
.sp
این گزینه نیازمند پشتیبانی درایور و دوربین است؛ در حال حاضر مدل‌های جدیدتر Canon EOS و Nikon DSLR کار می‌کنند\&.
.RE
.PP
\fB\-\-wait\-event \fR\fB\fISECONDS, MILLISECONDS, COUNT or MATCHSTRING\fR\fR, \fB\-\-wait\-event\-and\-download \fR\fB\fISECONDS, MILLISECONDS, COUNT or MATCHSTRING\fR\fR
.RS 4
به gphoto2 اجازه می‌دهد برای رویدادهای گوناگون، منتظر اعلان‌های دوربین بماند\&. این ویژگی برای مشاهده عملکرد دوربین و انتظار برای اضافه شدن اشیاء جدید مفید است\&. در حالت
\(lq\-\-wait\-event\(rq
اشیاء روی دوربین باقی می‌مانند، اما با
\(lq\-\-wait\-event\-and\-download\(rq
بارگیری می‌شوند\&.
.sp
گزینه \-\-wait\-event\-and\-download معادل \-\-capture\-tethered است\&.
.sp
زمان انتظار را می‌توان به صورت ثانیه کامل با پسوند "s"، تعداد میلی‌ثانیه با پسوند "ms"، به عنوان تعداد رویدادها (فقط یک عدد)، یا یک زیررشته برای تطابق مشخص کرد\&. اگر رویدادی رخ ندهد، پس از ۱ ثانیه زمان‌انتظار (timeout) ایجاد می‌شود، بنابراین
\(lqwait\-event=5\(rq
حداکثر ۵ ثانیه طول خواهد کشید\&. عبارت
\(lq\-\-wait\-event=5s\(rq
دقیقاً ۵ ثانیه زمان خواهد برد\&.
.sp
همچنین امکان انتظار برای MATCHSTRING برای مواردی مانند CAPTURECOMPLETE، FILEADDED، TIMEOUT یا سایر رویدادهای چاپ‌شده وجود دارد\&.
.sp
اگر هیچ آرگومانی داده نشود، زمان انتظار ۱ میلیون رویداد (اساساً تا ابد) خواهد بود\&.
.sp
در گونهٔ بارگیری، می‌توان از این گزینه همراه با
\fB\-\-hook\-script\fR
برای پردازش ثانویه فوری یا نمایش تصاویر استفاده کرد که به گردش کار استودیویی کمک می‌کند\&.
.sp
این گزینه نیازمند پشتیبانی درایور و دوربین است\&.
.sp
اگر gphoto2 در حین انتظار یک سیگنال SIGUSR1 دریافت کند، بلافاصله عکسی خواهد گرفت (مشابه
\(lq\-\-capture\-image\(rq)
و بسته به حالت انتخابی، آن را روی دوربین باقی می‌گذارد یا بارگیری می‌کند\&. (از نسخه 2\&.5\&.28)
.sp
اگر gphoto2 در حین انتظار یک سیگنال SIGUSR2 دریافت کند، با امنیت به عکاسی متصل (tethering) پایان می‌دهد\&. (از نسخه 2\&.5\&.25)
.RE
.PP
\fB\-\-show\-info\fR \fIRANGE\fR
.RS 4
نمایش اطلاعات یک یا چند تصویر مانند عرض، ارتفاع، اندازه یا زمان ثبت\&.
.RE
.PP
\fB\-\-config\fR
.RS 4
راه‌اندازی منوی متنی پیکربندی مبتنی بر ncurses\&. برای این قابلیت، gphoto2 باید با پشتیبانی از CDK ساخته شده باشد\&.
.RE
.PP
\fB\-\-list\-config\fR
.RS 4
فهرست کردن تمام مدخل‌های پیکربندی\&.
.RE
.PP
\fB\-\-list\-all\-config\fR
.RS 4
فهرست کردن تمام مدخل‌های پیکربندی همراه با مقادیر و گزینه‌های انتخابی آن‌ها\&.
.sp
این دستور ترکیبی از اجرای
\fB\-\-list\-config\fR
و فراخوانی
\fB\-\-get\-config\fR
روی تمام مدخل‌ها است\&.
.RE
.PP
\fB\-\-get\-config\fR \fICONFIGENTRY\fR
.RS 4
دریافت مدخل پیکربندی مشخص‌شده\&.
.sp
این دستور نوع، مقدار فعلی و همچنین گزینه‌های در دسترس این مقدار پیکربندی را فهرست می‌کند\&.
.RE
.PP
\fB\-\-set\-config\fR \fICONFIGENTRY=CONFIGVALUE\fR
.RS 4
تنظیم مدخل پیکربندی مشخص‌شده\&. برای فهرست‌های گزینه‌های مقادیر، این تنظیم ابتدا CONFIGVALUE را به عنوان مقدار و سپس به عنوان نمایه (شاخص) در فهرست گزینه‌ها جستجو می‌کند\&. از آنجا که این موضوع کاملاً واضح نیست، می‌توانید از
\fB\-\-set\-config\-index\fR
یا
\fB\-\-set\-config\-value\fR
استفاده کنید تا نوع مورد جستجو مشخص‌تر باشد\&.
.sp
برای مشاهده مقادیر قابل تنظیم در اینجا، به خروجی
\fB\-\-get\-config\fR
نگاه کنید\&.
.RE
.PP
\fB\-\-set\-config\-index\fR \fICONFIGENTRY=CONFIGINDEX\fR
.RS 4
تنظیم مدخل پیکربندی مشخص‌شده با تعیین نمایه (شاخص) در فهرست گزینه‌های مقدار پیکربندی\&. این گزینه طبیعتاً تنها برای تنظیمات پیکربندی که فهرستی از گزینه‌ها را ارائه می‌دهند کار می‌کند\&.
.sp
برای مشاهده نمایه‌های قابل تنظیم در اینجا، به خروجی
\fB\-\-get\-config\fR
نگاه کنید\&.
.RE
.PP
\fB\-\-set\-config\-value\fR \fICONFIGENTRY=CONFIGVALUE\fR
.RS 4
تنظیم مدخل پیکربندی مشخص‌شده با تعیین مقدار جدید آن\&. برای فهرست‌های گزینه‌ها، مقدار جستجو و تنظیم می‌شود\&.
.sp
برای مشاهده مقادیر قابل تنظیم در اینجا، به خروجی
\fB\-\-get\-config\fR
نگاه کنید\&.
.RE
.PP
\fB\-\-reset\fR
.RS 4
بازنشانی پورت USB مشخص‌شده (یا خودکار شناسایی‌شده)\&.
.sp
این دستور پورت USB نخستین دوربین شناسایی‌شده خودکار یا پورت مشخص‌شده با
\fB\-\-port usb:XXX,YYY\fR
را بازنشانی می‌کند\&. این گزینه در صورتی مفید است که پروتکل ارتباط با دوربین به نحوی قفل کرده باشد و عمل کشیدن و دوباره وصل کردن کابل دوربین را شبیه‌سازی می‌کند\&.
.RE
.PP
\fB\-\-storage\-info\fR
.RS 4
نمایش اطلاعات مربوط به رسانه ذخیره‌سازی دوربین\&.
.RE
.PP
\fB\-\-summary\fR
.RS 4
خلاصه وضعیت دوربین\&.
.RE
.PP
\fB\-\-manual\fR
.RS 4
راهنمای درایور دوربین\&.
.RE
.PP
\fB\-\-about\fR
.RS 4
درباره درایور دوربین\&.
.RE
.PP
\fB\-\-shell\fR
.RS 4
شروع شل تعاملی gphoto2\&. برای توضیحات دقیق، بخش
«حالت شل (SHELL MODE)»
را ببینید\&.
.RE
.SH "حالت شل (SHELL MODE)"
.PP
دستورات زیر در دسترس هستند:
.PP
cd \fIDIRECTORY\fR
.RS 4
تغییر مسیر به دایرکتوری مشخص‌شده روی دوربین\&.
.RE
.PP
ls
.RS 4
فهرست کردن محتویات دایرکتوری جاری روی دوربین\&.
.RE
.PP
lcd \fIDIRECTORY\fR
.RS 4
تغییر مسیر به دایرکتوری مشخص‌شده روی دستگاه محلی\&.
.RE
.PP
get \fIFILENAME\fR
.RS 4
بارگیری فایل مشخص‌شده در دایرکتوری جاری\&.
.RE
.PP
put \fIFILENAME\fR
.RS 4
بارگذاری فایل مشخص‌شده از دایرکتوری سیستم محلی به دایرکتوری جاری دوربین\&.
.RE
.PP
get\-thumbnail \fIFILENAME\fR
.RS 4
بارگیری تصویر بندانگشتی مشخص‌شده در دایرکتوری جاری\&.
.RE
.PP
get\-raw \fIFILENAME\fR
.RS 4
بارگیری داده‌های خام مشخص‌شده در دایرکتوری جاری\&.
.RE
.PP
get\-exif \fIFILENAME\fR
.RS 4
بارگیری داده‌های Exif مشخص‌شده در دایرکتوری جاری\&.
.RE
.PP
show\-info \fIFILENAME\fR
.RS 4
نمایش اطلاعات فایل مشخص‌شده\&.
.RE
.PP
delete \fIFILENAME\fR
.RS 4
حذف فایل یا دایرکتوری مشخص‌شده\&.
.RE
.PP
mkdir \fIDIRECTORY\fR
.RS 4
ایجاد دایرکتوری با نام
\(lqDIRECTORY\(rq\&.
.RE
.PP
rmdir \fIDIRECTORY\fR
.RS 4
حذف دایرکتوری با نام
\(lqDIRECTORY\(rq\&.
.RE
.PP
show\-exif \fIFILENAME\fR
.RS 4
نمایش اطلاعات EXIF (تنها در صورت کامپایل شدن با پشتیبانی از EXIF)\&.
.RE
.PP
capture\-image
.RS 4
ثبت یک تصویر واحد و نگه‌داشتن آن روی دوربین\&.
.RE
.PP
capture\-image\-and\-download
.RS 4
ثبت یک تصویر واحد و بارگیری آن از دوربین\&.
.RE
.PP
capture\-preview
.RS 4
ثبت یک تصویر پیش‌نمایش و بارگیری آن از دوربین\&.
.RE
.PP
list\-config
.RS 4
فهرست کردن تمام مقادیر پیکربندی\&.
.RE
.PP
get\-config \fINAME\fR
.RS 4
دریافت پیکربندی مشخص‌شده با
\(lqNAME\(rq\&.
.RE
.PP
set\-config \fINAME=VALUE\fR
.RS 4
تنظیم پیکربندی مشخص‌شده با
\(lqNAME\(rq
به مقدار
\(lqVALUE\(rq\&.
.RE
.PP
set\-config\-value \fINAME=VALUE\fR
.RS 4
تنظیم پیکربندی مشخص‌شده با
\(lqNAME\(rq
به مقدار
\(lqVALUE\(rq\&.
.RE
.PP
set\-config\-index \fINAME=VALUE\fR
.RS 4
تنظیم پیکربندی مشخص‌شده با
\(lqNAME\(rq
به نمایه (شاخص)
\(lqINDEX\(rq
در فهرست گزینه‌ها\&. تنها برای مدخل‌های Menu یا Radio button کار می‌کند\&.
.RE
.PP
wait\-event \fICOUNT or SECONDS\fR
.RS 4
انتظار برای رویدادهای دوربین به مدت زمان مشخص‌شده بر حسب SECONDS (در صورت داشتن پسوند s) یا تعداد COUNT رویداد از دوربین، که در آن هر ثانیه یک رویداد پایان زمان (timeout) رخ می‌دهد\&. تصاویر جدید اضافه شده روی دوربین باقی می‌مانند\&.
.sp
پیش‌فرض ۱ رویداد است\&.
.RE
.PP
wait\-event\-and\-download \fICOUNT or SECONDS\fR, capture\-tethered \fICOUNT or SECONDS\fR
.RS 4
انتظار برای رویدادهای دوربین به مدت زمان مشخص‌شده بر حسب SECONDS (در صورت داشتن پسوند s) یا تعداد COUNT رویداد از دوربین، که در آن هر ثانیه یک رویداد پایان زمان (timeout) رخ می‌دهد\&. تصاویر جدید اضافه شده از دوربین بارگیری می‌شوند\&.
.sp
پیش‌فرض ۱ رویداد است\&.
.RE
.PP
help, ?
.RS 4
نمایش نحوه استفاده از دستورات\&.
.RE
.PP
exit, quit, q
.RS 4
خروج از شل gphoto2\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBCAMLIBS\fR
.RS 4
در صورت تنظیم، دایرکتوری‌ای را مشخص می‌کند که کتابخانه
libgphoto2
در آن به دنبال درایورهای دوربین خود (camlibs) می‌گردد\&. تنها در نصب‌های غیر استاندارد نیاز به تنظیم این متغیر خواهید داشت\&.
.RE
.PP
\fBIOLIBS\fR
.RS 4
در صورت تنظیم، دایرکتوری‌ای را مشخص می‌کند که کتابخانه
libgphoto2_port
در آن به دنبال درایورهای ورودی/خروجی (iolibs) می‌گردد\&. تنها در نصب‌های غیر استاندارد نیاز به تنظیم این متغیر خواهید داشت\&.
.RE
.PP
\fBLD_DEBUG\fR
.RS 4
تنظیم این متغیر روی
\fIall\fR
باعث دریافت اطلاعات اشکال‌زدایی فراوان درباره بارگذاری کتابخانه‌ها در سیستم‌های مبتنی بر
\fBld\fR
می‌شود\&.
.RE
.PP
\fBUSB_DEBUG\fR
.RS 4
در صورت تنظیم، سطح عددی اشکال‌زدایی را که کتابخانه
libusb
پیام‌ها را با آن چاپ می‌کند تعیین می‌نماید\&. برای دریافت خروجی اشکال‌زدایی، آن را روی
\fI1\fR
تنظیم کنید\&.
.RE
.SH "سیگنال‌ها (SIGNALS)"
.PP
SIGUSR1 (از نسخه 2\&.4)
.RS 4
در عکاسی تایم‌لپس و در حالت اتصال (tethering) یا wait\-event، دریافت سیگنال SIGUSR1 باعث می‌شود gphoto2 بلافاصله عکسی بگیرد\&.
.sp
اگر گزینه
\fB\-\-reset\-interval\fR
مشخص شده باشد، شمارنده زمان به مقدار داده‌شده توسط گزینه
\fB\-I|\-\-interval\fR
بازنشانی می‌شود\&. توجه داشته باشید که دوربین برای ثبت واقعی تصویر به کمی زمان (از ۵۰ میلی‌ثانیه تا چند ثانیه) نیاز خواهد داشت\&.
.RE
.PP
SIGUSR2 (از نسخه 2\&.5\&.26)
.RS 4
در حالت اتصال (tethering) یا wait\-event، دریافت سیگنال SIGUSR2 به حالت اتصال یا انتظار برای رویداد پایان می‌دهد\&. این گزینه در صورتی که زمان پایان را از قبل نمی‌دانید اما می‌خواهید با امنیت از حالت انتظار خارج شوید مفید است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
libgphoto2(3),
\m[blue]\fBراهنمای gPhoto2\fR\m[]\&\s-2\u[1]\d\s+2,

\m[blue]\fBوب‌سایت gphoto\&.org\fR\m[]\&\s-2\u[2]\d\s+2,
\m[blue]\fBپشتیبانی از دوربین دیجیتال برای UNIX، Linux و BSD\fR\m[]\&\s-2\u[3]\d\s+2
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBgphoto2 \fR\fB\fB\-\-list\-ports\fR\fR
.RS 4
نمایش انواع پورت‌های موجود (USB
و سریال)\&.
.RE
.PP
\fBgphoto2 \fR\fB\fB\-\-auto\-detect\fR\fR
.RS 4
نمایش دوربین(هایی) که متصل کرده‌اید\&.
.RE
.PP
\fBgphoto2 \fR\fB\fB\-\-list\-files\fR\fR
.RS 4
فهرست کردن فایل‌های روی دوربین\&.
.RE
.PP
\fBgphoto2 \fR\fB\fB\-\-get\-file\fR\fR\fB \fR\fB\fI7\-13\fR\fR
.RS 4
دریافت فایل‌های شماره ۷ تا ۱۳ از خروجی فهرست
\fB\fBgphoto2\fR\fR\fB \fR\fB\fB\-\-list\-files\fR\fR\&.
.RE
.PP
\fBgphoto2 \fR\fB\fB\-\-capture\-image\fR\fR\fB \fR\fB\fB\-\-interval\fR\fR\fB \fR\fB\fI60\fR\fR\fB \fR\fB\fB\-\-hook\-script\fR\fR\fB \fR\fB\fI/usr/share/doc/gphoto2/test\-hook\&.sh\fR\fR
.RS 4
ثبت یک تصویر در هر ۶۰ ثانیه از اکنون تا بی‌نهایت\&. اسکریپت قلاب نمونه، پس از ذخیره هر تصویر ثبت‌شده در رایانه فراخوانی می‌شود\&.
.RE
.PP
برای ردیابی خطاها، می‌توانید پارامتر
\fB\-\-debug\fR
را به خط فرمان
\fBgphoto2\fR
اضافه کنید و در صورت بروز مشکلات USB، متغیر محیطی
\fBUSB_DEBUG\fR\fI=1\fR
را تنظیم نمایید\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBTim Waugh\fR
.RS 4
نویسنده.
.RE
.PP
\fBHans Ulrich Niedermann, current maintainer\fR <\&gp@n-dimensional.de\&>
.RS 4
نویسنده.
.RE
.PP
\fBMichael J. Rensing\fR
.RS 4
نویسنده.
.RE
.PP
\fBMarcus Meissner\fR <\&marcus@jet.franken.de\&>
.RS 4
نویسنده.
.RE
.PP
\fBمشارکت‌کنندگان متفرقه.\fR
.PP
\fBThe gPhoto2 Team\fR
.RS 4
نویسنده.
.RE
.PP
\fBTim Waugh\fR <\&twaugh@redhat\&.com\&>
.RS 4
نویسنده اولیه صفحه راهنما\&.
.RE
.PP
\fBHans Ulrich Niedermann\fR <\&gp@n\-dimensional\&.de\&>
.RS 4
ویرایشگر فعلی صفحه راهنما\&.
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
راهنمای gPhoto2
.RS 4
\%http://www.gphoto.org/doc/manual
.RE
.IP " 2." 4
وب‌سایت gphoto.org
.RS 4
\%http://www.gphoto.org
.RE
.IP " 3." 4
پشتیبانی از دوربین دیجیتال برای UNIX، Linux و BSD
.RS 4
\%http://www.teaser.fr/~hfiguiere/linux/digicam.html
.RE