sane-gphoto2(5) SANE Scanner Access Now Easy sane-gphoto2(5)

sane-gphoto2 - بک‌اند SANE برای دوربین‌های پشتیبانی‌شده در gphoto2

کتابخانه sane-gphoto2 یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به دوربین‌های دیجیتال پشتیبانی‌شده توسط gphoto2 را فراهم می‌سازد. این بک‌اند تاکنون تنها با تعداد اندکی دوربین آزمایش شده است. از وصله‌ها و پچ‌ها برای پشتیبانی از سایر مدل‌ها استقبال می‌شود.

به دلیل آزمایش محدود این بک‌اند، به طور پیش‌فرض در فایل /etc/sane.d/dll.conf کامنت شده است. یا باید علامت کامنت حذف شود یا بک‌اند باید صریحاً فراخوانی گردد؛ مانند: scanimage -d gphoto2 یا xscanimage gphoto2.

نسخه فعلی این بک‌اند تنها اجازه اتصال یک دوربین را می‌دهد. نام دستگاه همواره "0" است.

محتویات فایل gphoto2.conf ویژگی‌های دوربینی را که قرار است استفاده شود مشخص می‌کند. تعیین تفکیک‌پذیری‌ها (وضوح بالا، وضوح پایین و اندازه تصویر بندانگشتی) الزامی است چرا که فرانت‌اندهای sane به آن‌ها نیاز دارند، اما نمی‌توان آن‌ها را از طریق رابط gphoto2 به دست آورد. درگاه‌ها و دوربین‌های معتبر را می‌توان با دستورات زیر به دست آورد: gphoto2 --list-cameras و gphoto2 --list-ports.

خط dumpinquiry باعث چاپ برخی اطلاعات پیرامون دوربین می‌شود.

خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:

خط topfolder بخش «ثابت» مسیر فایل را تعیین می‌کند. برای مثال، در دوربین Kodak DC-240، فایل‌ها در دایرکتوری /DCIM/100DC240 ذخیره می‌شوند. بخش /DCIM ثابت است، اما 100DC240 تغییر خواهد کرد و باید از دوربین خوانده شود. در این حالت، خط به صورت "topfolder=/DCIM" نوشته می‌شود.

برخی دوربین‌ها ساختار فایلی را پیاده‌سازی نمی‌کنند و تمام تصاویر را در دایرکتوری / ذخیره می‌نمایند. این وضعیت با تنظیم "subdirs=0" همراه با "topfolder=/" مشخص می‌شود.

port=usb:
camera=Kodak DC240
# this is a comment
high_resolution=1280x960
low_resolution=640x480
thumb_resolution=160x120
dumpinquiry

/etc/sane.d/gphoto2.conf
فایل پیکربندی بک‌اند (همچنین توضیحات SANE_CONFIG_DIR در زیر را ببینید).
/usr/lib/sane/libsane-gphoto2.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-gphoto2.so
کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).

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

sane(7), scanimage(1), xscanimage(1), libgphoto2(3)

Peter S. Fales

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

بدون شک اشکالات فراوانی دارد.

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

11 Jul 2008