.TH sane\-sharp 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-sharp
.SH "نام (NAME)"
sane\-sharp \- بک‌اند SANE برای اسکنرهای SHARP
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-sharp
یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که
دسترسی به اسکنرهای SCSI شارپ (Sharp) را فراهم می‌آورد. این بک‌اند باید به عنوان یک نرم‌افزار
.B با کیفیت بتا (آزمایشی)
در نظر گرفته شود! در وضعیت فعلی، عملکرد آن با اسکنرهای JX-610 و JX-250 تایید شده است. این بک‌اند برای استفاده با اسکنرهای سری JX-330 آماده شده است،
اما امکان آزمایش آن با این دستگاه‌ها برای ما فراهم نبوده است.
.PP
برای سایر اسکنرهای شارپ، ممکن است کار کند یا نکند.
.PP
در حال حاضر،
مشخص شده است که اسکنرهای زیر با این بک‌اند کار می‌کنند:
.RS
.PP
.ft CR
.nf
Vendor  Product id:
-----   -----------
Sharp   JX-610
Sharp   JX-250
Sharp   JX-320
Sharp   JX-330
Sharp   JX-350
.fi
.ft R
.RE
.PP
اسکنرهای زیر توسط بک‌اند شناسایی می‌شوند اما آزمایش نشده‌اند:
.PP
.RS
.ft CR
.nf
Vendor  Product id:
-----   -----------
Sharp   JX-325
.fi
.ft R
.RE
.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند نام‌های دستگاه را به این شکل انتظار دارد:
.PP
.RS
.I special
.RE
.PP
که در آن
.I special
مسیر دستگاه خاصی است که متناظر با یک اسکنر
SCSI است. نام دستگاه خاص باید یک دستگاه عمومی SCSI یا یک
پیوند نمادین (symlink) به چنین دستگاهی باشد. تحت لینوکس، چنین نام دستگاهی می‌تواند به عنوان مثال
.I /dev/sga
یا
.IR /dev/sge
باشد. برای جزئیات بیشتر به
.BR sane\-scsi (5)
مراجعه کنید.

.SH "گزینه‌های اسکن (SCAN OPTIONS)"
.TP
.B \-\-mode
حالت اسکن (Scan Mode). مقادیر ممکن عبارتند از:
.I Lineart
(اسکن‌های ۱ بیتی سیاه و سفید)،
.I Gray
(اسکن‌های ۸ بیتی مقیاس خاکستری)،
.I Lineart Color
(اسکن‌های رنگی دو-سطحی)، و
.I Color
(اسکن‌های ۸ بیتی RGB). مقدار پیش‌فرض
.I Color
است.

.TP
.B \-\-halftone\-pattern
الگوی هاف‌تون (Halftone Pattern). فقط برای اسکنرهای سری JX-330 موجود است.
تنظیمات ممکن:
.IR none "، " "Dither Bayer" "، " "Dither Spiral" "، " "Dither Dispersed"
و
.IR "Error Diffusion" .
مقدار پیش‌فرض
.IR none
است.

.TP
.B \-\-source
منبع کاغذ (Paper Source). این گزینه تنها در صورتی موجود است که یک تغذیه‌کننده خودکار سند (ADF)
یا یک آداپتور شفافیت نصب شده باشد. تنظیمات ممکن عبارتند از:
.IR Flatbed "، " "Automatic Document Feeder"
و
.IR "Transparency Adapter" .
در صورت نصب بودن ADF یا آداپتور شفافیت، استفاده از آن انتخاب پیش‌فرض خواهد بود.

.TP
.B \-\-custom\-gamma
گامای سفارشی (Custom Gamma). این گزینه مشخص می‌کند که آیا از یک جدول گامای داخلی استفاده شود یا سفارشی.
تنظیمات ممکن عبارتند از:
.I yes
(فعال‌سازی جدول‌های گامای سفارشی) یا
.I no
(فعال‌سازی جدول گامای توکار).

.TP
.B \-\-gamma
گاما (Gamma). این گزینه تنها در صورتی در دسترس است که
.B Custom Gamma
روی
.IR no
تنظیم شده باشد.
مقادیر ممکن عبارتند از:
.IR 1.0 " یا " 2.2 "."
مقدار پیش‌فرض
.IR 2.2
است.
(اسکنرهای JX-250 و JX-350 دارای تصحیح گامای داخلی نیستند؛ برای این اسکنرها، یک جدول گاما توسط بک‌اند در اسکنر بارگذاری می‌شود.)

.TP
.B \-\-gamma\-table
جدول گاما (Gamma Table). مقادیر مجاز: 0..255؛ باید ۲۵۶ عدد تعریف شود.
مقادیر پیش‌فرض 0, 1, 2, .. 255 هستند (یعنی gamma == 1). این جدول
فقط برای اسکن‌های مقیاس خاکستری استفاده می‌شود.

.TP
.B \-\-red\-gamma\-table
جدول گامای قرمز (Red Gamma Table). مقادیر مجاز: 0..255؛ باید ۲۵۶ عدد تعریف شود.
مقادیر پیش‌فرض 0, 1, 2, .. 255 هستند (یعنی gamma == 1).

.TP
.B \-\-green\-gamma\-table
جدول گامای سبز (Green Gamma Table). مقادیر مجاز: 0..255؛ باید ۲۵۶ عدد تعریف شود.
مقادیر پیش‌فرض 0, 1, 2, .. 255 هستند (یعنی gamma == 1).

.TP
.B \-\-blue\-gamma\-table
جدول گامای آبی (Blue Gamma Table). مقادیر مجاز: 0..255؛ باید ۲۵۶ عدد تعریف شود.
مقادیر پیش‌فرض 0, 1, 2, .. 255 هستند (یعنی gamma == 1).

.TP
.B \-\-resolution
وضوح تصویر اسکن شده را انتخاب می‌کند. مقادیر مجاز:
.I 30..600
(برای JX-330، JX-350 و JX-610) و
.I 30..400
(برای JX-250).
مقدار پیش‌فرض 150 است.

.TP
.BR \-l "، " \-t "، " \-x "، " \-y
پنجره اسکن (Scan Window).
موقعیت x گوشه بالا-چپ ناحیه اسکن
.RB ( \-l )،
موقعیت y گوشه بالا-چپ ناحیه اسکن
.RB ( \-t )،
موقعیت x گوشه پایین-راست ناحیه اسکن
.RB ( \-x )
و موقعیت y گوشه پایین-راست ناحیه اسکن
.RB ( \-y ).
تنظیمات ممکن به مدل اسکنر و برای JX-250 و JX-350، همچنین به استفاده از تغذیه‌کننده خودکار سند یا آداپتور شفافیت بستگی دارد.
لطفاً به مقادیر مجاز توسط
.BR xscanimage (1)
یا
.BR xsane (1)
مراجعه کنید. با استفاده از
.BR scanimage (1)،
یکی از دستورات زیر را برای مشاهده مقادیر مجاز پارامترهای پنجره اسکن وارد کنید:

.RS
scanimage \-d sharp \-\-source "Automatic Document Feeder" \-\-help

scanimage \-d sharp \-\-source Flatbed \-\-help

scanimage \-d sharp \-\-source "Transparency Adapter" \-\-help
.RE

.TP
.B \-\-edge emphasis
تأکید بر لبه‌ها (Edge emphasis). این گزینه برای JX-250 و JX-350 در دسترس نیست.
تنظیمات ممکن:
.IR None "، " Middle "، " Strong "، و " Blur .
مقدار پیش‌فرض
.IR None
است.

.TP
.B \-\-threshold
آستانه (Threshold) پیکسل‌های سیاه و سفید را در حالت lineart تنظیم می‌کند.
مقادیر ممکن 1..255 هستند.
مقدار پیش‌فرض 128 است.
این گزینه فقط در حالت اسکن
.IR lineart
در دسترس است.

.TP
.B \-\-threshold-red
آستانه مؤلفه قرمز یک پیکسل را
در حالت اسکن خطی رنگی (lineart color) تنظیم می‌کند. مقادیر ممکن 1..255 هستند.
مقدار پیش‌فرض 128 است.
این گزینه فقط در حالت اسکن
.IR lineart color
در دسترس است.

.TP
.B \-\-threshold-green
آستانه مؤلفه سبز یک پیکسل را
در حالت اسکن خطی رنگی (lineart color) تنظیم می‌کند. مقادیر ممکن 1..255 هستند.
مقدار پیش‌فرض 128 است.
این گزینه فقط در حالت اسکن
.I lineart color
در دسترس است.

.TP
.B \-\-threshold-blue
آستانه مؤلفه آبی یک پیکسل را
در حالت اسکن خطی رنگی (lineart color) تنظیم می‌کند. مقادیر ممکن 1..255 هستند.
مقدار پیش‌فرض 128 است.
این گزینه فقط در حالت اسکن
.IR lineart color
در دسترس است.

.TP
.B \-\-lightcolor
رنگ منبع نور را تنظیم می‌کند. مقادیر ممکن عبارتند از:
.IR white ،
.IR red ،
.I green
و
.IR blue .
مقدار پیش‌فرض
.IR white
است.
این گزینه تنها در حالت‌های اسکن
.I "lineart color"
و
.IR color
در دسترس است.

.SH "استفاده از ADF (ADF USAGE)"
در صورت گیر کردن کاغذ، درپوش نگهداری (maintenance cover)
.I
باید
باز و بسته شود، حتی اگر کاغذ گیر کرده بتواند بدون باز کردن درپوش برداشته شود.
در غیر این صورت، وضعیت خطا پاک نخواهد شد.

.SH "پیکربندی (CONFIGURATION)"
محتویات فایل
.I sharp.conf
فهرستی از گزینه‌ها و نام‌های دستگاه است که با اسکنرهای Sharp
مطابقت دارند. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند
نادیده گرفته می‌شوند. برای جزئیات بیشتر درباره نام‌های دستگاه، به
.BR sane\-scsi (5)
مراجعه کنید.
.PP
خطوط تنظیم‌کننده یک گزینه با کلمه کلیدی
.B option
شروع می‌شوند که پس از آن نام گزینه و مقدار گزینه می‌آید. در حال حاضر، سه گزینه تعریف شده است:
.B buffers، buffersize
و
.B readqueue.
.PP
گزینه‌های تعریف‌شده در ابتدای
.I sharp.conf
برای همه دستگاه‌ها اعمال می‌شوند؛ گزینه‌های تعریف‌شده پس از یک نام دستگاه، فقط برای آن دستگاه اعمال می‌گردند.
.PP
گزینه‌های
.B buffers
و
.B readqueue
تنها زمانی موثر هستند که بک‌اند به‌گونه‌ای کامپایل شده باشد که برای هر اسکن یک فرآیند ثانویه منشعب (fork) شود (سوئیچ
.B USE_FORK
در
.I sharp.c
). این فرآیند داده‌های اسکن را از اسکنر خوانده و آن‌ها را در یک بلوک حافظه اشتراکی (shared memory) می‌نویسد.
فرآیند والد، داده‌ها را از این بلوک حافظه خوانده و به فرانت‌اند تحویل می‌دهد. این گزینه‌ها اندازه و نحوه استفاده از این بلوک حافظه اشتراکی را کنترل می‌کنند.
.PP
.B option buffers
تعداد بافرهای مورد استفاده را مشخص می‌کند. کمترین مقدار مجاز ۲ است.
.PP
.B option buffersize
اندازه یک بافر را مشخص می‌کند. از آنجا که هر بافر با یک دستور خواندن واحد ارسال‌شده به اسکنر پر می‌شود، اندازه آن به‌طور خودکار به اندازه‌ای محدود می‌شود که توسط سیستم‌عامل یا کتابخانه Sane SCSI برای دستورات خواندن SCSI مجاز است. اندازه بافر ۱۲۸ کیلوبایت یا ۲۵۶ کیلوبایت برای وضوح‌های اسکن ۳۰۰ dpi و بالاتر توصیه می‌شود.
.PP
.B option readqueue
مشخص می‌کند که چه تعداد دستور خواندن ارسال‌شده به اسکنر در صف قرار گیرند. در حال حاضر، کتابخانه Sane SCSI فقط برای لینوکس از صف‌بندی دستورات خواندن پشتیبانی می‌کند. برای سایر سیستم‌عامل‌ها،
.B option readqueue
باید روی 0 تنظیم شود. برای لینوکس،
.B option readqueue
باید روی 2 تنظیم شود. مقادیر بزرگتر از 2 برای
.B option readqueue
در بیشتر موارد منطقی نیستند.
.B option buffers
باید بزرگتر از
.B option readqueue
باشد.

.SH "ملاحظات عملکرد (PERFORMANCE CONSIDERATIONS)"
این بخش بر مشکل توقف‌های کالسکه اسکنر (carriage) در طول اسکن تمرکز دارد. توقف‌های کالسکه عمدتاً در JX-250 رخ می‌دهد. این اسکنر در مقایسه با سرعتش، بافر داخلی کوچکی دارد. این بدان معناست که بک‌اند باید داده‌ها را تا حد امکان سریع از اسکنر بخواند تا از توقف کالسکه جلوگیری شود.
.PP
حتی JX-250 برای یک اسکن مقیاس خاکستری A4 با وضوح 400 dpi تنها به کمتر از ۱۰ ثانیه زمان نیاز دارد، که منجر به نرخ انتقال داده بیش از ۱.۶ مگابایت بر ثانیه می‌شود. این بدان معناست که داده‌های تولید شده توسط اسکنر باید با سرعت بالایی پردازش شوند. به دلیل بافر داخلی کوچک JX-250، بک‌اند باید بلافاصله پس از خواندن یک بلوک از داده‌ها، درخواست خواندن بلوک بعدی را ارسال کند تا از توقف کالسکه جلوگیری شود.
.PP
توقف‌های کالسکه می‌تواند به دلایل زیر رخ دهد:
.PP
.RS
\- ترافیک بیش از حد در گذرگاه SCSI،
.br
\- پاسخ‌های کند بک‌اند به اسکنر،
.br
\- کند بودن برنامه‌ای که داده‌های دریافت‌شده توسط بک‌اند را پردازش می‌کند.
.PP
.RE
ترافیک بیش از حد در گذرگاه SCSI: این حالت زمانی رخ می‌دهد که مثلاً دیسک‌های سخت به همان گذرگاه SCSI اسکنر متصل باشند و انتقال داده به/از این دیسک‌ها بخش قابل توجهی از پهنای باند SCSI را در طول اسکن اشغال کند. اگر چنین است، باید اتصال اسکنر به یک آداپتور SCSI مجزا را در نظر بگیرید.
.PP
پاسخ‌های کند بک‌اند به اسکنر: متأسفانه، سیستم‌عامل‌های شبه‌یونیکس عموماً قابلیت‌های بلادرنگ (real-time) ندارند. بنابراین هیچ تضمینی وجود ندارد که بک‌اند تحت هر شرایطی بتواند با سرعت مورد نیاز با اسکنر ارتباط برقرار کند. برای به حداقل رساندن این مشکل، بک‌اند باید به‌گونه‌ای کامپایل شود که یک فرآیند خواننده جداگانه منشعب شود: مطمئن شوید هنگام کامپایل
.I sharp.c
مقدار
.B USE_FORK
تعریف شده باشد. اگر پاسخ‌های کند بک‌اند همچنان یک مشکل باقی بماند، می‌توانید بار سیستم را کاهش دهید. حتی با اینکه بک‌اند و فرآیند خواننده به میزان ناچیزی از زمان پردازنده نیاز دارند، سایر فرآیندهای در حال اجرا می‌توانند باعث افزایش تاخیر بین دو برش زمانی (time slice) داده‌شده به فرآیند خواننده شوند. در سیستم‌های کندتر، چنین تاخیر افزایشی می‌تواند برای ایجاد توقف کالسکه در JX-250 کافی باشد. برای لینوکس، استفاده از درایور SG نسخه 2.1.36 یا بالاتر توصیه می‌شود، زیرا این نسخه در ترکیب با کتابخانه SCSI نسخه 1.0.2 متعلق به Sane از صف‌بندی دستورات درون هسته پشتیبانی می‌کند. این پیاده‌سازی صف‌بندی در ترکیب با بافری با اندازه حداقل ۱۲۸ کیلوبایت باید از بیشتر توقف‌های کالسکه جلوگیری کند.
.PP
پردازش کند داده‌های اسکن: نمونه‌ای از این وضعیت، دسترسی به اسکنر از طریق شبکه اترنت 10 MBit است که قطعاً برای انتقال داده‌های اسکن با سرعتی که توسط اسکنر تولید می‌شوند بسیار کند است. اگر حافظه کافی در دسترس دارید، می‌توانید
.B option buffers
را افزایش دهید تا یک تصویر کامل در این بافرها ذخیره شود.
.PP
برای بررسی اینکه آیا بک‌اند خیلی کند است یا پردازش بعدی داده‌ها کند است، متغیر محیطی
.B SANE_DEBUG_SHARP
را روی 1 تنظیم کنید. وقتی اسکن تمام می‌شود، بک‌اند خط «buffer full conditions:
.IR nn »
را در stderr می‌نویسد. اگر
.I nn
صفر باشد، توقف‌های کالسکه ناشی از پاسخ‌های بسیار کند بک‌اند یا ترافیک زیاد روی گذرگاه SCSI است. اگر
.I nn
بزرگتر از صفر باشد، بک‌اند مجبور شده است
.I nn
بار منتظر بماند تا بافر توسط فرانت‌اند پردازش شود. (لطفاً توجه داشته باشید که
.B option buffers
باید بزرگتر از
.B option readqueue
باشد تا خروجی مفیدی برای «buffer full conditions» دریافت کنید.)

.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/sharp.conf
فایل پیکربندی بک‌اند.
.TP
.I /usr/lib/sane/libsane\-sharp.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-sharp.so
کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).
.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_DEBUG_SHARP
اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی (debug level) را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار 128 درخواست می‌کند که تمام خروجی‌های اشکال‌زدایی چاپ شوند. مقادیر کوچکتر میزان جزئیات را کاهش می‌دهند.
.SH "مشکلات شناخته‌شده (KNOWN PROBLEMS)"
۱. حالت ADF
.RS
پس از چندین اسکن ADF، اسکنر کالسکه را به موقعیت بی‌کار (idle) و قبل از شروع اسکن مجدداً به موقعیت اسکن ADF برمی‌گرداند. ما نمی‌دانیم که آیا این مشکل از اسکنر است یا باگی در بک‌اند. در حال حاضر، برای متوقف کردن این رفتار آزاردهنده، باید اسکنر را خاموش و روشن کرد.
.RE

۲. سطح آستانه (Threshold) کار نمی‌کند (فقط JX\-610).
.PP
۳. حداکثر وضوح تصویر به 600 dpi (اسکنر JX\-610 تا 1200 dpi را پشتیبانی می‌کند) و 400 dpi (برای JX\-250) محدود شده است.
.PP
۴. اگر JX\-250 با یک ADF استفاده شود، ممکن است وضعیت زیر رخ دهد: پس از چندین اسکن، اسکنر پس از بارگذاری یک برگ کاغذ جدید، کالسکه را به موقعیت بی‌کار و سپس به موقعیت مورد استفاده برای اسکن‌های ADF منتقل می‌کند. این اتفاق برای
.I
هر
اسکن رخ می‌دهد، بر خلاف کالیبراسیون که بعد از هر ۱۰ اسکن انجام می‌شود. (برای کالیبراسیون نیز کالسکه به موقعیت بی‌کار منتقل می‌شود.) ما نمی‌دانیم که آیا این رفتار ناشی از بک‌اند است یا باگی در سفت‌افزار (firmware) اسکنر.
.PP
۵. استفاده از آداپتور شفافیت (واحد اسکن فیلم) پشتیبانی می‌شود، اما آزمایش نشده است.

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

.SH "نویسندگان (AUTHORS)"
Kazuya Fukuda, Abel Deuring

.SH "قدردانی‌ها (CREDITS)"
بک‌اند Sharp بر اساس بک‌اند Canon که توسط Helmut Koeberle نوشته شده، طراحی گردیده است.
.PP
بخش‌هایی از این صفحه راهنما رونوشت مستقیمی از
.BR sane\-mustek (5)
نوشته David Mosberger-Tang، Andreas Czechanowski و Andreas Bolsch است.