.TH sane\-umax 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-umax

.SH "نام (NAME)"
sane\-umax \- بک‌اند SANE برای اسکنرهای UMAX

.SH "درباره این پرونده (ABOUT THIS FILE)"

این پرونده صرفاً یک شرح مختصر از بک‌اند
.B sane\-umax
برای SANE است! برای دریافت اطلاعات تفصیلی به
.I sane\-umax\-doc.html
(که در دایرکتوری سورس SANE و در راهنمای برخط
.BR xsane (1)
گنجانده شده است) مراجعه کنید!

.SH "توضیحات (DESCRIPTION)"

کتابخانهٔ
.B sane\-umax
یک بک‌اند SANE را پیاده‌سازی می‌کند که دسترسی به چندین اسکنر UMAX-SCSI و برخی اسکنرهای Linotype Hell SCSI را فراهم می‌آورد؛
اسکنرهای موازی (parallel) و USB پشتیبانی نمی‌شوند (و احتمالاً هرگز پشتیبانی نخواهند شد)!
.PP
.B پیشنهاد می‌کنم هنگام انجام اولین اسکن‌ها، یک دست خود را روی دکمه پاور اسکنر نگه دارید!

.SH "پیکربندی (CONFIGURATION)"

فایل پیکربندی این بک‌اند در مسیر
.IR /etc/sane.d/umax.conf
قرار دارد.
.PP
محتوای آن فهرستی از نام‌های دستگاه است که با اسکنرهای UMAX و سازگار با UMAX مطابقت دارند. خطوط خالی
و خطوطی که با علامت هش (#) آغاز می‌شوند، نادیده گرفته می‌شوند. یک نمونه فایل پیکربندی در
زیر نشان داده شده است:

.nf
 # this is a comment
 #
 option scsi\-maxqueue 4
 option scsi\-buffer\-size\-min 65536
 option scsi\-buffer\-size\-max 131072
 option scan\-lines 40
 option preview\-lines 10
 option scsi\-maxqueue 2
 option execute\-request\-sense 0
 option force\-preview\-bit\-rgb 0
 option slow\-speed \-1
 option care\-about\-smearing \-1
 option calibration\-full\-ccd \-1
 option calibration\-width\-offset \-1
 option calibration\-bytes\-pixel \-1
 option exposure\-time\-rgb\-bind \-1
 option invert\-shading\-data \-1
 option lamp\-control\-available 0
 option gamma\-lsb\-padded 0
 /dev/sge
\
 #scsi Vendor Model Type Bus Channel ID LUN
 # The following scanner supports lamp control
 option lamp\-control\-available 1
 scsi UMAX * Scanner * * * * *
\
 # scanner on /dev/scanner does not support lamp control
 option lamp\-control\-available 0
 /dev/scanner
.fi

.TP
execute\-request\-sense:
مقادیر: 0 = غیرفعال، 1 = فعال
.br
پیش‌فرض = 0
.br
اگر روی 1 تنظیم شود،
.BR umax_do_request_sense ()
در
.BR umax_do_calibration ()
فراخوانی می‌شود. این کار می‌تواند سیستم را متوقف (hang) کند، اما تا این نسخه فعال بوده است.
.TP
scsi\-buffer\-size\-min, scsi\-buffer\-size\-max:
مقادیر: 4096\-1048576
.br
پیش‌فرض: کمینه = 32768، بیشینه = 131072
.br
به‌ویژه مقدار کمینه بسیار مهم است.
اگر این مقدار بیش از حد کوچک تنظیم شود، بک‌اند قادر به
ارسال جدول‌های گاما به اسکنر یا انجام
کالیبراسیون صحیح رنگ نخواهد بود. این امر ممکن است منجر به
جلوه‌های رنگی نامتعارف شود. اگر مقدار کمینه بیش از حد بزرگ
تنظیم شود، بک‌اند قادر به تخصیص اندازه بافر SCSI درخواستی
نخواهد بود و با خطای اتمام حافظه (out of memory) متوقف می‌شود.
پیش‌فرض 32 کیلوبایت است، که برای برخی اسکنرها باید به 64 کیلوبایت افزایش یابد.
.TP
scan\-lines, preview\-lines:
مقادیر: 1\-65535
.br
پیش‌فرض: scan\-lines = 40، preview\-lines = 10
.br
حداکثر تعداد خطوطی را که در یک بافر اسکن می‌شوند مشخص می‌کند.
.TP
force\-preview\-bit\-rgb:
مقادیر:
0 = غیرفعال،
1 = فعال
.br
پیش‌فرض = 0
.br
تنظیم بیت پیش‌نمایش در اسکن واقعی RGB.
.TP
slow\-speed, care\-about\-smearing:
مقادیر:
\-1 = خودکار،
0 = غیرفعال،
1 = فعال
.br
پیش‌فرض = \-1
.br
گزینه‌های خطرناک، مورد نیاز برای برخی اسکنرها.
.br
این گزینه‌ها را تغییر ندهید مگر آنکه واقعاً بدانید چه کاری
انجام می‌دهید؛ در غیر این صورت ممکن است با مقادیر نامعتبر
به اسکنر خود آسیب بزنید.
.TP
calibration\-full\-ccd:
مقادیر:
\-1 = خودکار،
0 = غیرفعال،
1 = فعال
.br
پیش‌فرض = \-1
.br
انجام کالیبراسیون برای تک‌تک پیکسل‌های CCD به‌جای
تصویر انتخاب‌شده.
.TP
calibration\-width\-offset:
مقادیر: \-99999 = خودکار، < \-99999 مقدار تعیین‌شده
.br
افزودن یک آفست به عرض محاسبه‌شده برای تصویر/CCD.
.TP
calibration\-bytes\-pixel:
مقادیر:
\-1 = غیرفعال،
0 = تنظیم‌نشده،
1 = ۱ بایت/پیکسل،
2 = ۲ بایت/پیکسل
.br
استفاده از # بایت در هر پیکسل برای کالیبراسیون.
.TP
exposure\-time\-rgb\-bind:
مقادیر:
\-1 = تنظیم خودکار توسط درایور \- در صورت شناخته بودن،
0 = غیرفعال (انتخاب مجزا برای قرمز، سبز و آبی)،
1 = فعال (مقادیر یکسان برای قرمز، سبز و آبی)
.TP
invert\-shading\-data:
مقادیر:
\-1 = تنظیم خودکار توسط درایور \- در صورت شناخته بودن،
0 = غیرفعال،
1 = فعال
.br
پیش‌فرض = \-1
.br
معکوس‌کردن داده‌های سایه‌زنی پیش از ارسال مجدد به اسکنر.
.TP
lamp\-control\-available:
مقادیر:
0 = تنظیم خودکار توسط درایور \- در صورت شناخته بودن،
1 = در دسترس
.br
پیش‌فرض = 0
.TP
gamma\-lsb\-padded:
مقادیر:
\-1 = تنظیم خودکار توسط درایور \- در صورت شناخته بودن،
0 = داده‌های گاما با msb پدگذاری شده‌اند،
1 = داده‌های گاما با lsb پدگذاری شده‌اند
.br
پیش‌فرض = \-1
.TP
handle\-bad\-sense\-error:
مقادیر:
0 = رسیدگی به‌عنوان مشغول بودن دستگاه،
1 = رسیدگی به‌عنوان مناسب (ok)،
2 = رسیدگی به‌عنوان خطای ورودی/خروجی،
3 = نادیده گرفتن کد خطای نامناسب \- ادامه مدیریت سنس
.br
پیش‌فرض = 0
.TP
scsi\-maxqueue:
مقادیر:
1..# (حداکثر در زمان کامپایل تعریف می‌شود)
.br
پیش‌فرض = 2
.br
اکثر درایورهای SCSI صف‌بندی داخلی دستورات را با عمق ۲ دستور مجاز می‌دانند.
در بیشتر موارد، افزایش این مقدار بهبودی ایجاد نمی‌کند.
اگر درایور SCSI شما از صف‌بندی دستورات پشتیبانی نمی‌کند،
می‌توانید این مقدار را روی ۱ تنظیم کنید.

.PP
نام دستگاه ویژه باید یک دستگاه عمومی SCSI یا یک پیوند نمادین به چنین دستگاهی باشد.
برای آگاهی از این‌که اسکنر شما به کدام دستگاه اختصاص یافته است و چگونه باید
مجوزهای دسترسی آن دستگاه را تنظیم کنید، نگاهی به
.BR sane\-scsi (5)
بیندازید.

.SH "نکات آداپتور SCSI (SCSI ADAPTER TIPS)"

آداپتورهای ISA-SCSI که به همراه برخی اسکنرهای UMAX عرضه می‌شوند، به‌خوبی توسط لینوکس پشتیبانی نمی‌شوند
(پیشنهاد می‌کنم از آن‌ها استفاده نکنید)؛ آداپتورهای PCI-SCSI همراه با برخی اسکنرهای UMAX نیز
(تا آنجا که من می‌دانم) اصلاً پشتیبانی نمی‌شوند. در سایر پلتفرم‌ها نیز این آداپتورهای SCSI
پشتیبانی نمی‌شوند؛ بنابراین معمولاً نیاز است آداپتور SCSI دیگری تهیه کنید که توسط پلتفرم شما پشتیبانی می‌شود.
برای اطلاعات بیشتر به پرسش‌های متداول سخت‌افزاری و راهنماهای پلتفرم خود مراجعه کنید.
.PP
اسکنرهای UMAX هنگام اسکن کردن، گذرگاه SCSI را به مدت چند ثانیه مسدود می‌کنند. نیازی نیست
اسکنر را به یک آداپتور SCSI اختصاصی متصل کنید؛ اما اگر به زمان پاسخ‌دهی کوتاه برای دیسک سخت SCSI خود
(مثلاً اگر رایانه شما یک سرویس‌دهنده فایل است) یا سایر دستگاه‌های SCSI نیاز دارید، پیشنهاد می‌کنم
برای اسکنر UMAX خود از یک آداپتور SCSI اختصاصی و جداگانه استفاده کنید.
.PP
اگر مشکلی با اسکنر UMAX خود دارید، زنجیره SCSI را بررسی کنید (طول کابل، ترمیناسیون و...).
.PP
همچنین ببینید:
.BR sane\-scsi (5)

.SH "فایل‌ها (FILES)"

.TP
.I /etc/sane.d/umax.conf
فایل پیکربندی بک‌اند
.TP
.I /usr/lib/sane/libsane\-umax.a
کتابخانهٔ ایستا که این بک‌اند را پیاده‌سازی می‌کند
.TP
.I /usr/lib/sane/libsane\-umax.so
کتابخانهٔ اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است)

.SH "محیط (ENVIRONMENT)"

.TP
.B SANE_DEBUG_UMAX
اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی
سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸
درخواست چاپ تمامی خروجی‌های اشکال‌زدایی را می‌دهد. سطوح پایین‌تر میزان جزئیات خروجی را کاهش می‌دهند.
.br
مقادیر
.BR SANE_DEBUG_UMAX :

.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

.TP
مثال:
export SANE_DEBUG_UMAX=8

.SH "اشکالات (BUGS)"
تفکیک‌پذیری‌های افقی (X-resolutions) بزرگ‌تر از 600 dpi گاهی اوقات باعث بروز مشکل می‌شوند.

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

.SH "نویسنده (AUTHOR)"
Oliver Rauch

.SH "تماس با ایمیل (EMAIL-CONTACT)"
.I Oliver.Rauch@Rauch-Domain.DE