GPHOTO2(1)

The gPhoto2 Reference (the man

GPHOTO2(1)

نام (NAME)

gphoto2 - کلاینت خط فرمانی gphoto2

خلاصه دستور (SYNOPSIS)

gphoto2 [--debug] [--debug-logfile FILENAME] [--debug-loglevel LEVEL] [[-q] | [--quiet]] [[-v] | [--verbose]] [[-h] | [--help]] [--usage]
[--hook-script FILENAME]
[--list-cameras] [--list-ports] [--stdout] [--stdout-size] [--parsable]
[--auto-detect] [--port PATH] [--speed SPEED] [--camera MODEL]
[--filename FILENAME] [--filenumber FILENUMBER]
[--usbid USBIDS]
[[-a] | [--abilities]]
[[--folder FOLDER] | [-f FOLDER]] [[[-R] | [--recurse]] | [--no-recurse]]
[[-l] | [--list-folders]]
[[-L] | [--list-files]] [[-m NAME] | [--mkdir NAME]]
[[-r NAME] | [--rmdir NAME]] [[-n] | [--num-files]]
[[-p RANGE or NAME] | [--get-file RANGE or NAME]] [[-P] | [--get-all-files]]
[[-t RANGE or NAME] | [--get-thumbnail RANGE or NAME]]
[[-T] | [--get-all-thumbnails]]
[--get-raw-data RANGE or NAME] [--get-all-raw-data]
[--get-audio-data RANGE or NAME] [--get-all-audio-data]
[--get-exif RANGE or NAME] [--get-all-exif]
[--get-metadata RANGE or NAME] [--get-all-metadata] [--upload-metadata FILENAME]
[--force-overwrite]
[--new]
[[-d RANGE or NAME] | [--delete-file RANGE or NAME]] [[-D] | [--delete-all-files]]
[[-u FILENAME] | [--upload-file FILENAME]] [--config]
[--list-config] [--list-all-config]
[--get-config CONFIGENTRY] [--set-config CONFIGENTRY=CONFIGVALUE] [--set-config-index CONFIGENTRY=CONFIGINDEX] [--set-config-value CONFIGENTRY=CONFIGVALUE] [--reset]
[--capture-preview] [--show-preview]
[[-F COUNT] | [--frames COUNT]] [[-I SECONDS] | [--interval SECONDS]]
[--reset-interval]
[--capture-image] [--trigger-capture] [--capture-movie SECONDS or COUNT] [--capture-sound]
[--capture-tethered SECONDS, COUNT or STRING]
[--wait-event SECONDS, COUNT or STRING] [--wait-event-and-download SECONDS, COUNT or STRING]
[--keep] [--no-keep]
[--reverse]
[--show-info RANGE or NAME]
[--show-exif RANGE or NAME]
[--storage-info]
[--summary]
[--manual]
[--about]
[--shell]

توضیحات (DESCRIPTION)

کتابخانه libgphoto2(3) یک کتابخانه چندسکویی برای دوربین‌های دیجیتال است و gphoto2(1) یک کلاینت خط فرمان برای آن می‌باشد.

در مواردی که یک گزینه RANGE (محدوده) فایل‌ها، بندانگشتی‌ها یا سایر داده‌ها را می‌پذیرد، شماره‌گذاری آن‌ها از ۱ آغاز می‌شود. یک محدوده، فهرستی از اعداد یا بازه‌ها (“first-last”) است که با کاما از هم جدا شده‌اند. محدوده‌ها به صورت XOR (یا مانعه‌الجمع) اعمال می‌شوند، به طوری که “1-5,3,7” معادل “1,2,4,5,7” است.

--debug

فعال‌سازی خروجی اشکال‌زدایی (دیباگ). خروجی اشکال‌زدایی به صورت پیش‌فرض در stderr یا در نام فایل مشخص‌شده با گزینه --debug-logfile نوشته می‌شود.

--debug-logfile FILENAME (از نسخه 2.3.0)

فایل لاگی که در صورت مشخص شدن --debug ، اطلاعات اشکال‌زدایی در آن نوشته می‌شود.

--debug-loglevel LEVEL (از نسخه 2.5.5)

میزان جزئیات لاگ‌های اشکال‌زدایی. مقادیر مجاز به ترتیب افزایش جزئیات عبارتند از: error, debug, data, all. مقدار پیش‌فرض all است.

--hook-script FILENAME (جدید پس از 2.3.0)

اجرای اسکریپت قلاب (hook script) FILENAME در هر بار وقوع رویدادی خاص در gphoto2. اسکریپت قلاب متغیر محیطی ACTION را می‌خواند. این اسکریپت باید مقادیر ناشناخته ACTION را نادیده بگیرد.

ACTION=init

دستور gphoto2 به‌تازگی مقداردهی اولیه شده است. اگر اسکریپت قلاب اکنون کد خروج غیرصفر بازگرداند، gphoto2 متوقف خواهد شد.

ACTION=start

دستور gphoto2 به‌تازگی تحلیل خط فرمان را به پایان رسانده و در شرف آغاز اجرای دستورات مشخص‌شده در خط فرمان است.

ACTION=download

دستور gphoto2 به‌تازگی فایلی را در رایانه بارگیری کرده و آن را در فایلی که با متغیر محیطی ARGUMENT مشخص شده ذخیره کرده است.

ACTION=stop

دستور gphoto2 در شرف پایان کار است. پاک‌سازی‌های نهایی خود را در اینجا انجام دهید.

تمام متغیرهای محیطی دیگر بدون تغییر به اسکریپت قلاب ارسال می‌شوند. می‌توانید از این ویژگی برای ارسال داده‌ها به اسکریپت قلاب استفاده کنید.

اسکریپت قلاب را می‌توان در فایل ~/.gphoto/settings به صورت gphoto2=hook-script=filename مشخص کرد.

-q, --quiet

خروجی بی‌صدا (پیش‌فرض=همراه با جزئیات کامل).

-v, --version

نمایش نسخه و خروج.

-h, --help

نمایش گزینه‌ها و توضیحات کوتاه.

--usage

نمایش پیام کوتاه نحوه استفاده.

--list-cameras

فهرست کردن مدل‌های دوربین پشتیبانی‌شده.

--list-ports

فهرست کردن دستگاه‌های پورت پشتیبانی‌شده.

--stdout

ارسال فایل به خروجی استاندارد (stdout).

--stdout-size

چاپ اندازه فایل پیش از داده‌ها.

--parsable

خروجی فهرست فایل‌ها را در قالب خط‌به‌خط ارائه می‌دهد تا بتوان آن را به یک اسکریپت شل یا فیلتر دیگری ارسال کرد.

--auto-detect

فهرست کردن دوربین‌های شناسایی‌شده خودکار و پورت‌هایی که به آن‌ها متصل هستند.

--port PATH

مشخص کردن دستگاه پورت. گزینه --list-ports فهرستی از پورت‌های معتبر و قابل استفاده را چاپ می‌کند. در صورت وجود چندین دوربین USB، گزینه --auto-detect پورت خاصی را که هر دوربین به آن متصل است نشان می‌دهد.

--speed SPEED

مشخص کردن سرعت انتقال سریال.

--camera MODEL

مشخص کردن مدل دوربین. گزینه --list-cameras فهرستی از تمام دوربین‌های صراحتاً پشتیبانی‌شده را چاپ می‌کند.

بیشتر نام‌های مدل حاوی فاصله هستند: به یاد داشته باشید که نام را در کوتیشن قرار دهید تا شل بداند که یک پارامتر واحد است؛ برای مثال: --camera "Kodak DC240".

توجه داشته باشید که اگر --camera را مشخص کنید، باید --port را نیز مشخص نمایید. در غیر این صورت گزینه --camera بدون هیچ پیامی نادیده گرفته خواهد شد.

--filename FILENAME

هنگام بارگیری فایل‌ها از دوربین، نام فایل یا الگوی نام فایلی را مشخص می‌کند که برای ذخیره فایل بارگیری‌شده روی دیسک محلی استفاده می‌شود. هنگام بارگذاری فایل به دوربین، نام فایلی را مشخص می‌کند که فایل بارگذاری‌شده تحت آن روی دوربین ذخیره می‌شود.

گزینه --filename الگوهای %a, %A, %b, %B, %d, %H, %k, %I, %l, %j, %m, %M, %S, %y, %% (به date(1) مراجعه کنید) و علاوه بر آن، %n برای شماره، %C برای پسوند نام فایل، %f برای نام فایل بدون پسوند، %F برای نام پوشه و %: برای نام کامل فایل با حروف کوچک را می‌پذیرد.

توجه داشته باشید که %: هنوز در مرحله آلفا است و نویسه یا نحو واقعی آن ممکن است تغییر کند؛ مثلاً ممکن است استفاده از %#f و %#C برای نسخه‌های با حروف کوچک و %^f و %^C برای نسخه‌های با حروف بزرگ امکان‌پذیر شود.

الگوی %n تنها مشخص‌کننده تبدیلی است که نویسه پرکننده (padding) و عرض را می‌پذیرد: %03n با صفر تا عرض ۳ پر می‌کند (مثلاً عدد ۷ را به صورت “007” چاپ می‌کند). حذف نویسه پرکننده (مانند %3n) از نویسه پرکننده پیش‌فرض وابسته به پیاده‌سازی استفاده می‌کند که ممکن است برای استفاده در نام فایل‌ها مناسب باشد یا نباشد.

مقدار پیش‌فرض این گزینه را می‌توان در فایل ~/.gphoto/settings به صورت gphoto2=filename=value مشخص کرد.

--filenumber FILENUMBER

اگر نام فایل را با استفاده از گزینه --filename و الگوی %n مشخص کنید، این الگو معمولاً از ۱ شروع می‌شود. برای استفاده افزایشی، می‌توانید از --filenumber استفاده کنید تا از عدد دیگری (FILENUMBER) شروع شود.

--usbid USBIDS

(تنها برای کاربران حرفه‌ای) بازنویسی شناسه‌های USB. مقدار USBIDS باید به شکل DetectedVendorID:DetectedProductID=TreatAsVendorID:TreatAsProductID باشد تا هر دستگاه USB شناسایی‌شده به عنوان DetectedVendorID:DetectedProductID در عوض به عنوان TreatAsVendorID:TreatAsProductID در نظر گرفته شود. تمام VendorIDها و ProductIDها باید اعداد هگزادسیمال با نمادگذاری زبان C باشند، یعنی با '0x' شروع شوند.

مثال: --usbid 0x4a9:0x306b=0x4a9:0x306c

-a, --abilities

نمایش قابلیت‌های دوربین و درایور مشخص‌شده در درایور libgphoto2. این کار دوربین را مورد پرس‌وجو قرار نمی‌دهد، بلکه از داده‌های ارائه‌شده توسط کتابخانه استفاده می‌کند. برای دریافت نمای کلی از وضعیت دوربین، از گزینه --summary استفاده کنید.

-f, --folder FOLDER

مشخص کردن پوشه دوربین (پیش‌فرض="/").

-R, --recurse

پیمایش بازگشتی (پیش‌فرض برای بارگیری).

--no-recurse

عدم پیمایش بازگشتی (پیش‌فرض برای حذف).

-l, --list-folders

فهرست کردن پوشه‌های موجود در پوشه جاری.

-L, --list-files

فهرست کردن فایل‌های موجود در پوشه جاری.

-m, --mkdir NAME

ایجاد یک دایرکتوری.

-r, --rmdir NAME

حذف یک دایرکتوری.

-n, --num-files

نمایش تعداد فایل‌ها.

-p, --get-file RANGE

دریافت فایل‌های مشخص‌شده در محدوده.

-P, --get-all-files

دریافت تمام فایل‌ها از پوشه.

-t, --get-thumbnail RANGE

دریافت تصاویر بندانگشتی مشخص‌شده در محدوده.

-T, --get-all-thumbnails

دریافت تمام تصاویر بندانگشتی از پوشه.

--get-raw-data RANGE

دریافت داده‌های خام مشخص‌شده در محدوده.

--get-all-raw-data

دریافت تمام داده‌های خام از پوشه.

--get-audio-data RANGE

دریافت داده‌های صوتی مشخص‌شده در محدوده.

--get-all-audio-data

دریافت تمام داده‌های صوتی از پوشه.

--get-exif RANGE

دریافت داده‌های Exif مشخص‌شده در محدوده.

--get-all-exif

دریافت تمام داده‌های Exif از پوشه.

--upload-metadata FILENAME

بارگذاری متاداده برای فایل مشخص‌شده، که از فایلی با پیشوند _meta گرفته می‌شود.

--get-metadata RANGE

دریافت متاداده‌های مشخص‌شده در محدوده.

--get-all-metadata

دریافت تمام متاداده‌ها از پوشه.

--force-overwrite

بازنویسی فایل‌ها بدون پرسش.

--skip-existing

رد کردن فایل‌ها در صورتی که در دایرکتوری محلی از قبل وجود داشته باشند.

--new

تنها دریافت فایل‌هایی که پیش از این بارگیری نشده‌اند. این گزینه به پشتیبانی دوربین از نشانه‌گذاری تصاویر قبلاً بارگیری‌شده بستگی دارد و برای تمام درایورها در دسترس نیست.

-d, --delete-file RANGE

حذف فایل‌های مشخص‌شده در محدوده.

-D, --delete-all-files

حذف تمام فایل‌های موجود در پوشه (پیش‌فرض --no-recurse است).

-u, --upload-file FILENAME

بارگذاری یک فایل به دوربین.

--capture-preview

ثبت یک پیش‌نمایش سریع.

-B--bulb SECONDS

عکاسی بالب (bulb capture) برای مدت زمان مشخص‌شده بر حسب ثانیه.

--show-preview

ثبت یک پیش‌نمایش سریع و نمایش آن در ترمینال با استفاده از هنر اسکی (Ascii Art) (در صورتی که برنامه با aalib ساخته شده باشد).

-F COUNT, --frames COUNT

تعداد فریم‌هایی که در یک بار اجرا ثبت می‌شوند. پیش‌فرض تعداد فریم‌های نامحدود است.

-I SECONDS, --interval SECONDS

فاصله زمانی بین ثبت چندین فریم.

(از نسخه 2.4) در صورت دریافت سیگنال SIGUSR1، بدون انتظار برای اتمام دوره بازه زمانی فعلی، بلافاصله یک عکس گرفته می‌شود (به بخش “سیگنال‌ها (SIGNALS)” مراجعه کنید). مقدار 1- باعث می‌شود gphoto2 برای همیشه (یعنی تا زمان رسیدن سیگنال) منتظر بماند. همچنین به --reset-interval مراجعه کنید.

--reset-interval

تنظیم این گزینه باعث می‌شود هنگام دریافت سیگنال SIGUSR1 در حالت تایم‌لپس، بازه زمانی به مقدار داده‌شده توسط گزینه -I|--interval بازنشانی شود.

--capture-image

ثبت یک تصویر و نگه‌داشتن آن روی دوربین.

--capture-image-and-download

ثبت یک تصویر و بارگیری فوری آن در رایانه.

--trigger-capture

شروع فرایند ثبت تصویر و بازگشت. اگر می‌خواهید تصویر بارگیری شود، به --wait-event-and-download مراجعه کنید.

این قابلیت تنها برای برخی از برندهای دوربین و درایورها در دسترس است.

--reverse

هنگام انجام عملیات فایل مانند --get-all-files، -P یا -T ترتیب بارگیری فایل‌ها را معکوس می‌کند.

--keep

هنگام استفاده از --capture-image-and-download یا ثبت با بازه زمانی، این گزینه تصاویر را روی کارت حافظه دوربین نگه می‌دارد.

--no-keep

هنگام استفاده از --capture-image-and-download یا ثبت با بازه زمانی، این گزینه پس از بارگیری تصاویر در حین ثبت، آن‌ها را روی کارت حافظه دوربین نگه نمی‌دارد (پیش‌فرض).

--keep-raw

هنگام استفاده از --capture-image-and-download یا ثبت با بازه زمانی، این گزینه تصاویر RAW را روی کارت حافظه دوربین نگه می‌دارد، اما تصاویر JPEG را همچنان بارگیری می‌کند. این ویژگی هنگام عکاسی دوحالته (dual mode) و زمانی که می‌خواهید تصاویر JPEG را در حین عکاسی بازبینی کنید مفید است.

--capture-movie SECONDS

ضبط ویدیو. اگر دوربین از پیش‌نمایش پشتیبانی کند، این گزینه جریانی از فریم‌های پیش‌نمایش (motion-jpeg) را با بیشترین سرعت ممکن دوربین ثبت می‌کند.

اگر هیچ آرگومانی مشخص نشود، تا زمانی که کلیدهای Ctrl-C را فشار دهید فریم‌های پیش‌نمایش را ثبت می‌کند. آرگومان‌های قابل تعیین یا مدت زمان ثبت بر حسب ثانیه هستند یا تعداد فریم‌های پیش‌نمایش.

--capture-sound

ضبط یک کلیپ صوتی. در حال حاضر هیچ درایوری از این ویژگی پشتیبانی نمی‌کند.

--capture-tethered SECONDS, MILLISECONDS, COUNT or MATCHSTRING

به gphoto2 امکان می‌دهد منتظر اعلان‌های دوربین مبنی بر اضافه شدن یک شیء (تصویر) بماند. این ویژگی برای عکاسی متصل (tethered capture) مفید است، جایی که فشردن شاتر روی دوربین بلافاصله تصویر را برای پردازش به دستگاه منتقل می‌کند.

ترکیب این گزینه با --hook-script برای پردازش ثانویه فوری یا نمایش تصاویر می‌تواند به گردش کار استودیویی کمک کند.

این گزینه نیازمند پشتیبانی درایور و دوربین است؛ در حال حاضر مدل‌های جدیدتر Canon EOS و Nikon DSLR کار می‌کنند.

--wait-event SECONDS, MILLISECONDS, COUNT or MATCHSTRING, --wait-event-and-download SECONDS, MILLISECONDS, COUNT or MATCHSTRING

به gphoto2 اجازه می‌دهد برای رویدادهای گوناگون، منتظر اعلان‌های دوربین بماند. این ویژگی برای مشاهده عملکرد دوربین و انتظار برای اضافه شدن اشیاء جدید مفید است. در حالت “--wait-event” اشیاء روی دوربین باقی می‌مانند، اما با “--wait-event-and-download” بارگیری می‌شوند.

گزینه --wait-event-and-download معادل --capture-tethered است.

زمان انتظار را می‌توان به صورت ثانیه کامل با پسوند "s"، تعداد میلی‌ثانیه با پسوند "ms"، به عنوان تعداد رویدادها (فقط یک عدد)، یا یک زیررشته برای تطابق مشخص کرد. اگر رویدادی رخ ندهد، پس از ۱ ثانیه زمان‌انتظار (timeout) ایجاد می‌شود، بنابراین “wait-event=5” حداکثر ۵ ثانیه طول خواهد کشید. عبارت “--wait-event=5s” دقیقاً ۵ ثانیه زمان خواهد برد.

همچنین امکان انتظار برای MATCHSTRING برای مواردی مانند CAPTURECOMPLETE، FILEADDED، TIMEOUT یا سایر رویدادهای چاپ‌شده وجود دارد.

اگر هیچ آرگومانی داده نشود، زمان انتظار ۱ میلیون رویداد (اساساً تا ابد) خواهد بود.

در گونهٔ بارگیری، می‌توان از این گزینه همراه با --hook-script برای پردازش ثانویه فوری یا نمایش تصاویر استفاده کرد که به گردش کار استودیویی کمک می‌کند.

این گزینه نیازمند پشتیبانی درایور و دوربین است.

اگر gphoto2 در حین انتظار یک سیگنال SIGUSR1 دریافت کند، بلافاصله عکسی خواهد گرفت (مشابه “--capture-image”) و بسته به حالت انتخابی، آن را روی دوربین باقی می‌گذارد یا بارگیری می‌کند. (از نسخه 2.5.28)

اگر gphoto2 در حین انتظار یک سیگنال SIGUSR2 دریافت کند، با امنیت به عکاسی متصل (tethering) پایان می‌دهد. (از نسخه 2.5.25)

--show-info RANGE

نمایش اطلاعات یک یا چند تصویر مانند عرض، ارتفاع، اندازه یا زمان ثبت.

--config

راه‌اندازی منوی متنی پیکربندی مبتنی بر ncurses. برای این قابلیت، gphoto2 باید با پشتیبانی از CDK ساخته شده باشد.

--list-config

فهرست کردن تمام مدخل‌های پیکربندی.

--list-all-config

فهرست کردن تمام مدخل‌های پیکربندی همراه با مقادیر و گزینه‌های انتخابی آن‌ها.

این دستور ترکیبی از اجرای --list-config و فراخوانی --get-config روی تمام مدخل‌ها است.

--get-config CONFIGENTRY

دریافت مدخل پیکربندی مشخص‌شده.

این دستور نوع، مقدار فعلی و همچنین گزینه‌های در دسترس این مقدار پیکربندی را فهرست می‌کند.

--set-config CONFIGENTRY=CONFIGVALUE

تنظیم مدخل پیکربندی مشخص‌شده. برای فهرست‌های گزینه‌های مقادیر، این تنظیم ابتدا CONFIGVALUE را به عنوان مقدار و سپس به عنوان نمایه (شاخص) در فهرست گزینه‌ها جستجو می‌کند. از آنجا که این موضوع کاملاً واضح نیست، می‌توانید از --set-config-index یا --set-config-value استفاده کنید تا نوع مورد جستجو مشخص‌تر باشد.

برای مشاهده مقادیر قابل تنظیم در اینجا، به خروجی --get-config نگاه کنید.

--set-config-index CONFIGENTRY=CONFIGINDEX

تنظیم مدخل پیکربندی مشخص‌شده با تعیین نمایه (شاخص) در فهرست گزینه‌های مقدار پیکربندی. این گزینه طبیعتاً تنها برای تنظیمات پیکربندی که فهرستی از گزینه‌ها را ارائه می‌دهند کار می‌کند.

برای مشاهده نمایه‌های قابل تنظیم در اینجا، به خروجی --get-config نگاه کنید.

--set-config-value CONFIGENTRY=CONFIGVALUE

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

برای مشاهده مقادیر قابل تنظیم در اینجا، به خروجی --get-config نگاه کنید.

--reset

بازنشانی پورت USB مشخص‌شده (یا خودکار شناسایی‌شده).

این دستور پورت USB نخستین دوربین شناسایی‌شده خودکار یا پورت مشخص‌شده با --port usb:XXX,YYY را بازنشانی می‌کند. این گزینه در صورتی مفید است که پروتکل ارتباط با دوربین به نحوی قفل کرده باشد و عمل کشیدن و دوباره وصل کردن کابل دوربین را شبیه‌سازی می‌کند.

--storage-info

نمایش اطلاعات مربوط به رسانه ذخیره‌سازی دوربین.

--summary

خلاصه وضعیت دوربین.

--manual

راهنمای درایور دوربین.

--about

درباره درایور دوربین.

--shell

شروع شل تعاملی gphoto2. برای توضیحات دقیق، بخش «حالت شل (SHELL MODE)» را ببینید.

حالت شل (SHELL MODE)

دستورات زیر در دسترس هستند:

cd DIRECTORY

تغییر مسیر به دایرکتوری مشخص‌شده روی دوربین.

فهرست کردن محتویات دایرکتوری جاری روی دوربین.

lcd DIRECTORY

تغییر مسیر به دایرکتوری مشخص‌شده روی دستگاه محلی.

get FILENAME

بارگیری فایل مشخص‌شده در دایرکتوری جاری.

put FILENAME

بارگذاری فایل مشخص‌شده از دایرکتوری سیستم محلی به دایرکتوری جاری دوربین.

get-thumbnail FILENAME

بارگیری تصویر بندانگشتی مشخص‌شده در دایرکتوری جاری.

get-raw FILENAME

بارگیری داده‌های خام مشخص‌شده در دایرکتوری جاری.

get-exif FILENAME

بارگیری داده‌های Exif مشخص‌شده در دایرکتوری جاری.

show-info FILENAME

نمایش اطلاعات فایل مشخص‌شده.

delete FILENAME

حذف فایل یا دایرکتوری مشخص‌شده.

mkdir DIRECTORY

ایجاد دایرکتوری با نام “DIRECTORY”.

rmdir DIRECTORY

حذف دایرکتوری با نام “DIRECTORY”.

show-exif FILENAME

نمایش اطلاعات EXIF (تنها در صورت کامپایل شدن با پشتیبانی از EXIF).

capture-image

ثبت یک تصویر واحد و نگه‌داشتن آن روی دوربین.

capture-image-and-download

ثبت یک تصویر واحد و بارگیری آن از دوربین.

capture-preview

ثبت یک تصویر پیش‌نمایش و بارگیری آن از دوربین.

list-config

فهرست کردن تمام مقادیر پیکربندی.

get-config NAME

دریافت پیکربندی مشخص‌شده با “NAME”.

set-config NAME=VALUE

تنظیم پیکربندی مشخص‌شده با “NAME” به مقدار “VALUE”.

set-config-value NAME=VALUE

تنظیم پیکربندی مشخص‌شده با “NAME” به مقدار “VALUE”.

set-config-index NAME=VALUE

تنظیم پیکربندی مشخص‌شده با “NAME” به نمایه (شاخص) “INDEX” در فهرست گزینه‌ها. تنها برای مدخل‌های Menu یا Radio button کار می‌کند.

wait-event COUNT or SECONDS

انتظار برای رویدادهای دوربین به مدت زمان مشخص‌شده بر حسب SECONDS (در صورت داشتن پسوند s) یا تعداد COUNT رویداد از دوربین، که در آن هر ثانیه یک رویداد پایان زمان (timeout) رخ می‌دهد. تصاویر جدید اضافه شده روی دوربین باقی می‌مانند.

پیش‌فرض ۱ رویداد است.

wait-event-and-download COUNT or SECONDS, capture-tethered COUNT or SECONDS

پیش‌فرض ۱ رویداد است.

help, ?

نمایش نحوه استفاده از دستورات.

exit, quit, q

خروج از شل gphoto2.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

CAMLIBS

در صورت تنظیم، دایرکتوری‌ای را مشخص می‌کند که کتابخانه libgphoto2 در آن به دنبال درایورهای دوربین خود (camlibs) می‌گردد. تنها در نصب‌های غیر استاندارد نیاز به تنظیم این متغیر خواهید داشت.

IOLIBS

در صورت تنظیم، دایرکتوری‌ای را مشخص می‌کند که کتابخانه libgphoto2_port در آن به دنبال درایورهای ورودی/خروجی (iolibs) می‌گردد. تنها در نصب‌های غیر استاندارد نیاز به تنظیم این متغیر خواهید داشت.

LD_DEBUG

تنظیم این متغیر روی all باعث دریافت اطلاعات اشکال‌زدایی فراوان درباره بارگذاری کتابخانه‌ها در سیستم‌های مبتنی بر ld می‌شود.

USB_DEBUG

در صورت تنظیم، سطح عددی اشکال‌زدایی را که کتابخانه libusb پیام‌ها را با آن چاپ می‌کند تعیین می‌نماید. برای دریافت خروجی اشکال‌زدایی، آن را روی 1 تنظیم کنید.

سیگنال‌ها (SIGNALS)

SIGUSR1 (از نسخه 2.4)

در عکاسی تایم‌لپس و در حالت اتصال (tethering) یا wait-event، دریافت سیگنال SIGUSR1 باعث می‌شود gphoto2 بلافاصله عکسی بگیرد.

اگر گزینه --reset-interval مشخص شده باشد، شمارنده زمان به مقدار داده‌شده توسط گزینه -I|--interval بازنشانی می‌شود. توجه داشته باشید که دوربین برای ثبت واقعی تصویر به کمی زمان (از ۵۰ میلی‌ثانیه تا چند ثانیه) نیاز خواهد داشت.

SIGUSR2 (از نسخه 2.5.26)

در حالت اتصال (tethering) یا wait-event، دریافت سیگنال SIGUSR2 به حالت اتصال یا انتظار برای رویداد پایان می‌دهد. این گزینه در صورتی که زمان پایان را از قبل نمی‌دانید اما می‌خواهید با امنیت از حالت انتظار خارج شوید مفید است.

همچنین ببینید (SEE ALSO)

libgphoto2(3), راهنمای gPhoto2[1],

وب‌سایت gphoto.org[2], پشتیبانی از دوربین دیجیتال برای UNIX، Linux و BSD[3]

مثال‌ها (EXAMPLES)

gphoto2 --list-ports

نمایش انواع پورت‌های موجود (USB و سریال).

gphoto2 --auto-detect

نمایش دوربین(هایی) که متصل کرده‌اید.

gphoto2 --list-files

فهرست کردن فایل‌های روی دوربین.

gphoto2 --get-file 7-13

دریافت فایل‌های شماره ۷ تا ۱۳ از خروجی فهرست gphoto2 --list-files.

gphoto2 --capture-image --interval 60 --hook-script /usr/share/doc/gphoto2/test-hook.sh

ثبت یک تصویر در هر ۶۰ ثانیه از اکنون تا بی‌نهایت. اسکریپت قلاب نمونه، پس از ذخیره هر تصویر ثبت‌شده در رایانه فراخوانی می‌شود.

برای ردیابی خطاها، می‌توانید پارامتر --debug را به خط فرمان gphoto2 اضافه کنید و در صورت بروز مشکلات USB، متغیر محیطی USB_DEBUG=1 را تنظیم نمایید.