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

sane-agfafocus - بک‌اند SANE برای اسکنرهای تخت AGFA Focus

کتابخانهٔ sane-agfafocus یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت AGFA Focus را فراهم می‌آورد. در حال حاضر، اسکنرهای زیر توسط این بک‌اند پشتیبانی می‌شوند:

AGFA Focus GS Scanner (مقیاس خاکستری ۶ بیتی) (آزمایش‌نشده)
AGFA Focus Lineart Scanner (خطی/lineart) (آزمایش‌نشده)
AGFA Focus II (مقیاس خاکستری ۸ بیتی) (آزمایش‌نشده)
AGFA Focus Color (رنگی ۲۴ بیتی ۳-گذر)
AGFA Focus Color Plus (رنگی ۲۴ بیتی ۳-گذر)

Siemens S9036 (مقیاس خاکستری ۸ بیتی) (آزمایش‌نشده)

این راه‌انداز از اسکن‌های خطی (line art)، مقیاس خاکستری 6bpp و 8bpp و رنگی 18bpp و 24bpp پشتیبانی می‌کند.

اگر اسکنری غیر از موارد ذکر شده در بالا دارید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام مدل اسکنر، شناسهٔ SCSI و نسخهٔ سفت‌افزار (firmware) به sane-devel@alioth-lists.debian.net ما را مطلع سازید. برای آگاهی از نحوهٔ عضویت در sane-devel نگاهی به http://www.sane-project.org/mailing-lists.html بیندازید.

همهٔ این اسکنرها متعلق به دورهٔ پیش از SCSI-2 هستند و حتی به پرس‌وجوی SCSI (Inquiry) به‌درستی پاسخ نمی‌دهند. این مورد معمولاً در پویش‌های گذرگاه SCSI مشهود است، جایی که اسکنر تنها با رشته‌های نامفهوم و باطل به عنوان سازنده و مدل شناسایی می‌شود.

این بک‌اند انتظار نام دستگاه‌هایی با قالب زیر را دارد:

special

که در آن special مسیر دستگاه ویژه‌ای است که با یک اسکنر SCSI متناظر است. برای اسکنرهای SCSI، نام دستگاه ویژه باید یک دستگاه عمومی SCSI یا یک پیوند نمادین (symlink) به چنین دستگاهی باشد. تحت لینوکس، چنین نام دستگاهی می‌تواند برای مثال /dev/sga یا /dev/sge باشد. برای جزئیات بیشتر به sane-scsi(5) مراجعه کنید.

محتوای فایل agfafocus.conf فهرستی از نام‌های دستگاه متناظر با اسکنرهای AGFA Focus است. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند، نادیده گرفته می‌شوند. یک نمونه فایل پیکربندی در زیر نشان داده شده است:

/dev/scanner
# this is a comment
/dev/sge

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

این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های شبه‌یونیکس (*NIX)، دایرکتوری‌ها با دونقطه (`:') و در OS/2 با نقطه‌ویرگول (`;') از یکدیگر جدا می‌شوند. اگر این متغیر مقداردهی نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری فعلی (".") و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسهٔ جداکنندهٔ دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های مشخص‌شده به صورت صریح جستجو می‌شوند. برای مثال، تنظیم SANE_CONFIG_DIR روی "/tmp/config:" منجر به جستجو در دایرکتوری‌های tmp/config، . و /etc/sane.d (به همین ترتیب) خواهد شد.
اگر کتابخانه با پشتیبانی از اشکال‌زدایی (debug) کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸ درخواست چاپ تمام خروجی‌های اشکال‌زدایی را می‌دهد. مقادیر کوچک‌تر میزان جزئیات را کاهش می‌دهند. مقادیر SANE_DEBUG_AGFAFOCUS: 
شماره   توضیح
 0       چاپ خطاهای مهم (هر بار چاپ می‌شود)
 1       چاپ خطاها
 2       چاپ وضعیت sense
 3       چاپ هشدارها
 4       چاپ پرس‌وجوی اسکنر (scanner-inquiry)
 5       چاپ اطلاعات
 6       چاپ اطلاعات کم‌اهمیت‌تر
 7       چاپ رویه‌های فراخوانی‌شده
 8       چاپ پیام‌های reader_process
 10      چاپ روتین‌های فراخوانی‌شده sane-init
 11      چاپ رویه‌های فراخوانی‌شده sane
 12      چاپ اطلاعات sane
 13      چاپ پیام‌های کنترل گزینهٔ sane

بارگذاری ماتریس‌های dither و منحنی‌های تن رنگ (tonecurves) پیاده‌سازی شده است، اما تاکنون مفید بودن آن برای منظوری اثبات نشده است. به همین دلیل این گزینه‌ها غیرفعال شده‌اند.

اسکنرهایی که از قطع اتصال (disconnect) پشتیبانی نمی‌کنند، در صورت پر بار شدن گذرگاه SCSI (برای مثال اگر هم‌زمان با اسکن کردن اقدام به ساخت هسته کنید) با مشکلات اتمام مهلت زمانی (timeout) در SCSI مواجه می‌شوند. برای بررسی اینکه آیا اسکنر شما از disconnect پشتیبانی می‌کند یا خیر، دستور SANE_DEBUG_AGFAFOCUS=128 scanimage -L را در یک پایانه اجرا کرده و به دنبال خط حاوی "disconnect:" بگردید.

اگر در شناسایی اسکنرتان توسط SANE مشکل دارید، مطمئن شوید که بک‌اند Artec غیرفعال است. به دلیلی، این بک‌اند دست‌کم باعث می‌شود اسکنر من به درستی به دستورات پرس‌وجوی SCSI inquiry پاسخ ندهد.

اگر با باگی مواجه شدید، لطفاً متغیر محیطی SANE_DEBUG_AGFAFOCUS را روی ۱۲۸ تنظیم کرده و سعی کنید مشکل را بازتولید نمایید. سپس گزارشی به همراه لاگ‌های ثبت‌شده برای من ارسال کنید.

اگر با خطای گذرگاه SCSI یا تصاویر بریده‌شده و/یا جابه‌جا شده مواجه شدید، لطفاً پیش از ارسال گزارش، متغیر محیطی SANE_DEBUG_SANEI_SCSI را نیز روی ۱۲۸ تنظیم کنید.

اسکنرهای بیشتر؟
اسکنرهای AGFA ACS و ARCUS شبیه به اسکنرهای FOCUS هستند. احتمالاً می‌توان راه‌انداز را بدون نیاز به تغییرات زیاد برای پشتیبانی از این اسکنرها گسترش داد. من به چنین اسکنرهایی دسترسی ندارم و نمی‌توانم پشتیبانی از آن‌ها را اضافه کنم. با این حال، اگر شما چنین اسکنری در اختیار دارید، می‌توانم در افزودن پشتیبانی از آن‌ها به شما کمک کنم.

اسکنرهای AGFA HORIZON از نوع SCSI-2 هستند و احتمالاً پشتیبانی از این اسکنرها در یک بک‌اند منطبق با استاندارد SCSI-2 ساده‌تر خواهد بود.

sane(7), sane-scsi(5)

Ingo Schneider و Karl Anders Øygard.

10 Jul 2008