.TH sane\-microtek 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-microtek
.SH "نام (NAME)"
sane\-microtek \- بک‌اند SANE برای اسکنرهای Microtek
.SH "توضیحات (DESCRIPTION)"
کتابخانهٔ
.B sane\-microtek
یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که
دسترسی به اسکنرهای «نسل دوم» Microtek را فراهم می‌سازد. در حال حاضر،
سخت‌افزارهای زیر برای کار با این بک‌اند شناخته شده‌اند:
.PP
.RS
Microtek ScanMaker E2, E3, E6
.br
Microtek ScanMaker II, IIG, IIHR, IISP, III
.br
Microtek ScanMaker 35t, 35t+, 45t
.br
Microtek ScanMaker 600GS, 600ZS (بخش گزارش باگ‌ها را ببینید)
.br
Agfa StudioScan
.br
Agfa StudioScan II, StudioScan IIsi
.br
Agfa Arcus II (اما نه «Arcus»)
.br
Agfa DuoScan (مقدماتی)
.br
Vobis "Highscreen Realscan"
.br
Microtek Color PageWiz (مقدماتی)
.br
.PP
Transparent Media Adapter (آداپتور رسانه شفاف)
.br
Document AutoFeeder (تغذیه خودکار اسناد)
.br
.RE
.PP
این درایور از اسکن‌های خطی (line art)، ترام (halftone)، خاکستری 8bpp و رنگی 24bpp
در تفکیک‌پذیری‌های عادی و «گسترش‌یافته» (مثلاً 1200x1200 روی یک E6)، اسکن‌های سریع
برای پیش‌نمایش رنگی، و جدول‌های گامای قابل بارگیری پشتیبانی می‌کند.
.PP
اسکنرهای پشتیبانی‌شده همگی از نوع اسکنرهای SCSI هستند. با این حال، برخی از
مدل‌های درگاه موازی (parallel port) ممکن است (در لینوکس) کار کنند، اگر از یک تراشهٔ
parport->scsi استفاده کنند، و اگر بتوانید یک درایور scsi->parport پیدا کنید. این موضوع
برای مدل Color PageWiz صدق می‌کند.
.PP
این درایور از جدیدترین اسکنرهای Microtek، مانند V330 و V660 که از مجموعه دستورات
جدید و بسیار متفاوت SCSI-II استفاده می‌کنند پشتیبانی
.B نمی‌کند.
برای آن‌ها، بک‌اند جایگزین
.BR microtek2 (5)
را امتحان کنید. اکثر اسکنرهای غیر SCSI از مجموعه دستورات جدید استفاده می‌کنند. بیشتر
اسکنرهای جدیدتر از Scanmaker E6 نیز از مجموعه دستورات جدید استفاده خواهند کرد.
.PP
اگر اسکنری از Microtek به غیر از مدل‌های ذکر شده در بالا دارید، به ما اطلاع دهید چه اتفاقی می‌افتد --- بخش
.BR "گزارش باگ‌ها (BUGS)"
را در انتهای این سند ببینید.
.PP
اگرچه این صفحهٔ راهنما معمولاً با هر انتشار به‌روزرسانی می‌شود،
اما اطلاعات به‌روز دربارهٔ نسخه‌های جدید و نکات کمکی متفرقه
از طریق صفحهٔ خانگی بک‌اند در دسترس است:
.br
.PP
.RS
.I http://www.mir.com/mtek/
.RE

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

.SH "پیکربندی (CONFIGURATION)"
محتوای فایل
.I microtek.conf
فهرستی از نام‌های دستگاه است که متناظر با اسکنرهای
Microtek هستند. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند
نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:
.PP
.RS
/dev/scanner
.br
# this is a comment
.br
/dev/sge
.RE
.PP
فایل پیکربندی همچنین می‌تواند شامل نشانه‌های ویژهٔ
.I norealcal
یا
.I noprecal
باشد.
.I norealcal
استفاده از دستورات جادویی و مستند‌نشدهٔ کالیبراسیون اسکنر را که برای کار روی E6 شناخته شده‌اند، اما ممکن است با مدل‌های دیگر کار نکنند، غیرفعال می‌کند.
.I noprecal
منطقی را که سعی در اجتناب از پیش‌کالیبراسیون اسکنر دارد، غیرفعال خواهد کرد. این منطق تنها در صورتی فعال می‌شد که کد کالیبراسیون جادویی خاموش شده باشد.

.PP
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/microtek.conf
فایل پیکربندی بک‌اند (همچنین توضیحات
.B SANE_CONFIG_DIR
را در زیر ببینید).
.TP
.I /usr/lib/sane/libsane\-microtek.a
کتابخانهٔ ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-microtek.so
کتابخانهٔ مشترک (shared library) که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگیری پویا پشتیبانی می‌کنند موجود است).

.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_MICROTEK
اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این
متغیر محیطی سطح اشکال‌زدایی (debug level) را برای این بک‌اند کنترل می‌کند.
مقدار 128 حداکثر خروجی اشکال‌زدایی را درخواست می‌کند؛ مقادیر کمتر
میزان جزئیات را کاهش می‌دهند.

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

.SH "نویسندگان (AUTHORS)"
Matt Marjanovic

.SH "گزارش باگ‌ها (BUGS)"
باگ‌ها و محدودیت‌های شناخته‌شده عبارتند از:
.PP
.RS
روشنایی (Brightness) و کنتراست (contrast) خراب هستند.
.br
مدل 600GS فقط سیاه و سفید/خاکستری (grayscale) است و در صورت انتخاب رنگ قفل خواهد کرد.
(متأسفانه، مدل‌های 600GS و 600ZS از طریق نرم‌افزار قابل تفکیک نیستند.)
.br
.RE
.PP
به بیانی دیگر، در مورد این موارد شکایت نکنید --- اما اگر روشنایی و/یا کنتراست
برای شما کار
.B می‌کنند،
لطفاً به من اطلاع دهید.
.PP
اگر اسکنر شما قفل می‌کند، گزینهٔ
.I norealcal
یا
.I noprecal
را در فایل پیکربندی تنظیم کنید (ابتدا یکی، سپس هر دو) و ببینید آیا کمکی می‌کند یا خیر.
(اگر مؤثر بود، آن را گزارش دهید.)
.PP
گزارش‌های طولانی باگ و اطلاعات اسکنرهای جدید را به
.I mtek\-bugs@mir.com
ارسال کنید. همهٔ گزارش‌های باگ و پرسش‌ها دربارهٔ اسکنرهای جدید باید شامل یک فایل گزارش خطا (log) باشند.
می‌توانید با تنظیم متغیر محیطی
.B SANE_DEBUG_MICROTEK
که در بالا توضیح داده شد، خروجی مفصلی روی stderr ایجاد کنید. به عنوان مثال:
.PP
.RS
setenv SANE_DEBUG_MICROTEK 128
.RE
.PP
نظرات عمومی‌تر، پیشنهادات و پرسش‌ها دربارهٔ رابط‌های کاربری (frontends)
یا SANE باید به
.IR sane\-devel@alioth-lists.debian.net ،
فهرست پستی توسعه‌دهندگان SANE ارسال شوند. برای اشتراک در sane\-devel نگاهی به
.I http://www.sane\-project.org/mailing\-lists.html
بیندازید.