.TH sane\-gphoto2 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-gphoto2
.SH "نام (NAME)"
sane\-gphoto2 \- بک‌اند SANE برای دوربین‌های پشتیبانی‌شده در gphoto2
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-gphoto2
یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به دوربین‌های دیجیتال پشتیبانی‌شده توسط gphoto2 را فراهم می‌سازد.
این بک‌اند تاکنون تنها با تعداد اندکی دوربین آزمایش شده است. از وصله‌ها و پچ‌ها برای پشتیبانی از سایر مدل‌ها استقبال می‌شود.
.PP
به دلیل آزمایش محدود این بک‌اند، به طور پیش‌فرض در فایل
.I /etc/sane.d/dll.conf
کامنت شده است. یا باید علامت کامنت حذف شود یا بک‌اند باید صریحاً فراخوانی گردد؛ مانند:
.I "scanimage \-d gphoto2"
یا
.IR "xscanimage gphoto2" .
.SH "نام دستگاه‌ها (DEVICE NAMES)"
نسخه فعلی این بک‌اند تنها اجازه اتصال یک دوربین را می‌دهد. نام دستگاه همواره "0" است.
.SH "پیکربندی (CONFIGURATION)"
محتویات فایل
.I gphoto2.conf
ویژگی‌های دوربینی را که قرار است استفاده شود مشخص می‌کند. تعیین تفکیک‌پذیری‌ها (وضوح بالا، وضوح پایین و اندازه تصویر بندانگشتی) الزامی است چرا که فرانت‌اندهای sane به آن‌ها نیاز دارند، اما نمی‌توان آن‌ها را از طریق رابط gphoto2 به دست آورد. درگاه‌ها و دوربین‌های معتبر را می‌توان با دستورات زیر به دست آورد:
.I "gphoto2 \-\-list\-cameras"
و
.IR "gphoto2 \-\-list\-ports" .
.PP
خط
.B dumpinquiry
باعث چاپ برخی اطلاعات پیرامون دوربین می‌شود.
.PP
خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:
.PP
خط
.B topfolder
بخش «ثابت» مسیر فایل را تعیین می‌کند. برای مثال، در دوربین Kodak DC-240، فایل‌ها در دایرکتوری
.IR /DCIM/100DC240
ذخیره می‌شوند. بخش
.I /DCIM
ثابت است، اما 100DC240 تغییر خواهد کرد و باید از دوربین خوانده شود. در این حالت، خط به صورت "topfolder=/DCIM" نوشته می‌شود.
.PP
برخی دوربین‌ها ساختار فایلی را پیاده‌سازی نمی‌کنند و تمام تصاویر را در دایرکتوری
.I "/"
ذخیره می‌نمایند. این وضعیت با تنظیم "subdirs=0" همراه با "topfolder=/" مشخص می‌شود.
.PP
.RS
port=usb:
.br
camera=Kodak DC240
.br
# this is a comment
.br
high_resolution=1280x960
.br
low_resolution=640x480
.br
thumb_resolution=160x120
.br
dumpinquiry
.RE
.PP
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/gphoto2.conf
فایل پیکربندی بک‌اند (همچنین توضیحات
.B SANE_CONFIG_DIR
در زیر را ببینید).
.TP
.I /usr/lib/sane/libsane\-gphoto2.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-gphoto2.so
کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).

.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرستی از دایرکتوری‌هایی را که ممکن است حاوی فایل پیکربندی باشند مشخص می‌کند. در سیستم‌های شبه‌یونیکس (*NIX)، دایرکتوری‌ها با دو نقطه (':') و در سیستم OS/2 با نقطه ویرگول (';') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: نخست دایرکتوری کاری فعلی
.RI ( "." )
و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای مثال، تنظیم
.B SANE_CONFIG_DIR
روی "/tmp/config:" باعث می‌شود که دایرکتوری‌های
.IR "tmp/config" ,
.IR "." ,
و
.I "/etc/sane.d"
به همین ترتیب جستجو شوند.
.TP
.B SANE_DEBUG_GPHOTO2
اگر کتابخانه با فعال بودن قابلیت اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. مقدار ۱۲۸ بیشترین خروجی اشکال‌زدایی پرحرف را درخواست می‌کند؛ مقادیر کمتر میزان پرحرفی را کاهش می‌دهند.
.TP
.B GP_DEBUG
تنظیم روی 1، 2 یا 3 برای فعال کردن سطوح مختلف اشکال‌زدایی در کتابخانه‌های gphoto2 استفاده می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR scanimage (1),
.BR xscanimage (1),
.BR libgphoto2 (3)

.SH "نویسنده (AUTHOR)"
Peter S. Fales

.PP
این صفحه راهنما عمدتاً از صفحه راهنمای
.BR sane\-dc210 (5)
الگوبرداری شده است.

.SH "اشکالات (BUGS)"
بدون شک اشکالات فراوانی دارد.
.PP
نظرات عمومی‌تر، پیشنهادات و پرسش‌ها پیرامون فرانت‌اندها یا SANE باید به فهرست پستی توسعه‌دهندگان SANE ارسال شوند (برای جزئیات به نشانی
.I http://www.sane\-project.org/mailing\-lists.html
مراجعه فرمایید).
شما باید عضو این فهرست پستی باشید، در غیر این صورت ایمیل شما برای اعضا ارسال نخواهد شد.