.TH sane\-agfafocus 5 "10 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-agfafocus
.SH "نام (NAME)"
sane\-agfafocus \- بک‌اند SANE برای اسکنرهای تخت AGFA Focus
.SH "توضیحات (DESCRIPTION)"
کتابخانهٔ
.B sane\-agfafocus
یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که
دسترسی به اسکنرهای تخت AGFA Focus را فراهم می‌آورد. در حال حاضر،
اسکنرهای زیر توسط این بک‌اند پشتیبانی می‌شوند:
.PP
.RS
AGFA Focus GS Scanner (مقیاس خاکستری ۶ بیتی) (آزمایش‌نشده)
.br
AGFA Focus Lineart Scanner (خطی/lineart) (آزمایش‌نشده)
.br
AGFA Focus II (مقیاس خاکستری ۸ بیتی) (آزمایش‌نشده)
.br
AGFA Focus Color (رنگی ۲۴ بیتی ۳-گذر)
.br
AGFA Focus Color Plus (رنگی ۲۴ بیتی ۳-گذر)
.br
.PP
Siemens S9036 (مقیاس خاکستری ۸ بیتی) (آزمایش‌نشده)
.br
.RE
.PP
این راه‌انداز از اسکن‌های خطی (line art)، مقیاس خاکستری 6bpp و 8bpp و رنگی 18bpp و 24bpp پشتیبانی می‌کند.
.PP
اگر اسکنری غیر از موارد ذکر شده در بالا دارید که با این بک‌اند کار می‌کند،
لطفاً با ارسال نام مدل اسکنر، شناسهٔ SCSI و نسخهٔ سفت‌افزار (firmware) به
.IR sane\-devel@alioth-lists.debian.net
ما را مطلع سازید. برای آگاهی از نحوهٔ عضویت در sane\-devel نگاهی به
.I http://www.sane\-project.org/mailing\-lists.html
بیندازید.
.PP
همهٔ این اسکنرها متعلق به دورهٔ پیش از SCSI-2 هستند و حتی به پرس‌وجوی SCSI (Inquiry)
به‌درستی پاسخ نمی‌دهند. این مورد معمولاً در پویش‌های گذرگاه SCSI مشهود است، جایی که
اسکنر تنها با رشته‌های نامفهوم و باطل به عنوان سازنده و مدل شناسایی می‌شود.

.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند انتظار نام دستگاه‌هایی با قالب زیر را دارد:
.PP
.RS
.I special
.RE
.PP
که در آن
.I special
مسیر دستگاه ویژه‌ای است که با یک اسکنر SCSI متناظر است. برای اسکنرهای
SCSI، نام دستگاه ویژه باید یک دستگاه عمومی SCSI یا یک پیوند نمادین
(symlink) به چنین دستگاهی باشد. تحت لینوکس، چنین نام دستگاهی می‌تواند
برای مثال
.I /dev/sga
یا
.I /dev/sge
باشد. برای جزئیات بیشتر به
.BR sane\-scsi (5)
مراجعه کنید.

.SH "پیکربندی (CONFIGURATION)"
محتوای فایل
.I agfafocus.conf
فهرستی از نام‌های دستگاه متناظر با اسکنرهای AGFA Focus است. خطوط خالی
و خطوطی که با علامت هش (#) شروع می‌شوند، نادیده گرفته می‌شوند. یک
نمونه فایل پیکربندی در زیر نشان داده شده است:
.PP
.RS
/dev/scanner
.br
# this is a comment
.br
/dev/sge
.RE

.PP
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/agfafocus.conf
فایل پیکربندی بک‌اند (همچنین به توضیحات
.B SANE_CONFIG_DIR
در زیر مراجعه کنید).
.TP
.I /usr/lib/libsane\-agfafocus.a
کتابخانهٔ ایستایی که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/libsane\-agfafocus.so
کتابخانهٔ اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی
که از بارگذاری پویا پشتیبانی می‌کنند).
.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است
حاوی فایل پیکربندی باشند. در سیستم‌های شبه‌یونیکس (*NIX)، دایرکتوری‌ها
با دونقطه (`:') و در OS/2 با نقطه‌ویرگول (`;') از یکدیگر جدا می‌شوند.
اگر این متغیر مقداردهی نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض
جستجو می‌شود: ابتدا دایرکتوری کاری فعلی (".") و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسهٔ جداکنندهٔ دایرکتوری پایان یابد، دایرکتوری‌های
پیش‌فرض پس از دایرکتوری‌های مشخص‌شده به صورت صریح جستجو می‌شوند. برای مثال،
تنظیم
.B SANE_CONFIG_DIR
روی "/tmp/config:" منجر به جستجو در دایرکتوری‌های
.IR tmp/config ،
.IR .
و
.I /etc/sane.d
(به همین ترتیب) خواهد شد.
.TP
.B SANE_DEBUG_AGFAFOCUS
اگر کتابخانه با پشتیبانی از اشکال‌زدایی (debug) کامپایل شده باشد، این متغیر
محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸
درخواست چاپ تمام خروجی‌های اشکال‌زدایی را می‌دهد. مقادیر کوچک‌تر میزان
جزئیات را کاهش می‌دهند.
مقادیر
.BR SANE_DEBUG_AGFAFOCUS :

.sp
.ft CR
.nf
شماره   توضیح
\
 0       چاپ خطاهای مهم (هر بار چاپ می‌شود)
 1       چاپ خطاها
 2       چاپ وضعیت sense
 3       چاپ هشدارها
 4       چاپ پرس‌وجوی اسکنر (scanner-inquiry)
 5       چاپ اطلاعات
 6       چاپ اطلاعات کم‌اهمیت‌تر
 7       چاپ رویه‌های فراخوانی‌شده
 8       چاپ پیام‌های reader_process
 10      چاپ روتین‌های فراخوانی‌شده sane-init
 11      چاپ رویه‌های فراخوانی‌شده sane
 12      چاپ اطلاعات sane
 13      چاپ پیام‌های کنترل گزینهٔ sane
.fi
.ft R

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

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

.SH "اشکال‌زدایی (DEBUG)"
اگر در شناسایی اسکنرتان توسط SANE مشکل دارید، مطمئن شوید که بک‌اند Artec
غیرفعال است. به دلیلی، این بک‌اند دست‌کم باعث می‌شود اسکنر من به درستی به
دستورات پرس‌وجوی SCSI inquiry پاسخ ندهد.
.PP
اگر با باگی مواجه شدید، لطفاً متغیر محیطی
.B SANE_DEBUG_AGFAFOCUS
را روی ۱۲۸ تنظیم کرده و سعی کنید مشکل را بازتولید نمایید. سپس گزارشی به همراه
لاگ‌های ثبت‌شده برای من ارسال کنید.
.PP
اگر با خطای گذرگاه SCSI یا تصاویر بریده‌شده و/یا جابه‌جا شده مواجه شدید،
لطفاً پیش از ارسال گزارش، متغیر محیطی
.B SANE_DEBUG_SANEI_SCSI
را نیز روی ۱۲۸ تنظیم کنید.

.SH "کارهای آینده (TODO)"
.TP
.B اسکنرهای بیشتر؟
اسکنرهای AGFA ACS و ARCUS شبیه به اسکنرهای FOCUS هستند. احتمالاً می‌توان
راه‌انداز را بدون نیاز به تغییرات زیاد برای پشتیبانی از این اسکنرها گسترش داد.
من به چنین اسکنرهایی دسترسی ندارم و نمی‌توانم پشتیبانی از آن‌ها را اضافه کنم.
با این حال، اگر شما چنین اسکنری در اختیار دارید، می‌توانم در افزودن پشتیبانی
از آن‌ها به شما کمک کنم.
.PP
اسکنرهای AGFA HORIZON از نوع SCSI-2 هستند و احتمالاً پشتیبانی از این
اسکنرها در یک بک‌اند منطبق با استاندارد SCSI-2 ساده‌تر خواهد بود.

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR sane\-scsi (5)

.SH "نویسندگان (AUTHORS)"
Ingo Schneider و Karl Anders \[/O]ygard.