.TH sane\-kodak 5 "10 Feb 2010" "" "SANE Scanner Access Now Easy"
.IX sane\-kodak

.SH "نام (NAME)"
sane\-kodak \- بک‌اند SANE برای اسکنرهای بزرگ تخت و ADF کداک

.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-kodak
یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای بزرگ تخت (flatbed) و دارای تغذیه‌کننده خودکار سند (ADF) کداک را فراهم می‌سازد.
.PP
این سند نسخه ۷ این بک‌اند را توصیف می‌کند که همراه با SANE 1.0.21 عرضه شده است.

.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
این نسخه باید از مدل‌هایی که از پروتکل‌های SCSI و Firewire کداک استفاده می‌کنند پشتیبانی کند. مدل i1860 برای توسعه این بک‌اند استفاده شده است، اما سایر مدل‌ها ممکن است با تغییراتی بسیار جزئی کار کنند. لطفاً برای مشاهده فهرست به‌روزشده به نشانی زیر مراجعه کنید:
.I http://www.sane\-project.org/sane\-supported\-devices.html

.PP
اگر دستگاهی دارید که در این فهرست نیست یا وضعیت آن به عنوان «آزمایش‌نشده» (untested) گزارش شده است، بهترین راه برای تعیین سطح پشتیبانی، آزمایش مستقیم اسکنر یا جمع‌آوری ردگیری (trace) درایور ویندوز در حین کار است. لطفاً برای راهنمایی یا ارسال نتایج آزمایش با نویسنده تماس بگیرید.

.SH "سخت‌افزارهای پشتیبانی‌نشده (UNSUPPORTED HARDWARE)"
بیشتر دستگاه‌های مصرفی یا اداری/گروه‌کاری (workgroup) اخیر کداک بر پایه تراشه‌های متفاوتی ساخته شده‌اند و توسط این بک‌اند پشتیبانی نمی‌شوند. برخی از این اسکنرها ممکن است توسط بک‌اند دیگری پشتیبانی شوند.

.SH "گزینه‌ها (OPTIONS)"
تلاش شده است تا گزینه‌های سخت‌افزاری پایه‌ای در دسترس قرار گیرند، از جمله:
.PP
.B \-\-source s
.RS
منبع اسکن را انتخاب می‌کند. گزینه‌ها ممکن است شامل
"Flatbed" (تخت)،
"ADF Front" (روی برگه ADF)،
"ADF Back" (پشت برگه ADF)
و
"ADF Duplex" (دوطرفه ADF)
باشند.
.RE
.PP
.B \-\-mode m
.RS
حالت اسکن را انتخاب می‌کند. گزینه‌ها ممکن است شامل
"Lineart" (خطی/سیاه‌وسفید)،
"Halftone" (طرح سایه‌روشن)،
"Gray" (خاکستری)
و
"Color" (رنگی)
باشند.
.RE
.PP
.B \-\-resolution
.RS
وضوح اسکن را کنترل می‌کند. گزینه‌های در دسترس ممکن است بر اساس حالت اسکن محدود باشند.
.RE
.PP
.BR \-\-tl\-x ", " \-\-tl\-y ", " \-\-br\-x ", "  \-\-br\-y
.RS
مختصات گوشه بالا-چپ و پایین-راست ناحیه اسکن را تنظیم می‌کند. این گزینه‌ها در برخی از رابط‌های کاربری به
.BR \-t ", " \-l ", " \-x ", " \-y
تغییر نام داده شده‌اند.
.RE
.PP
.BR \-\-page\-width ", " \-\-page\-height
.RS
اندازه کاغذ را تنظیم می‌کند. این گزینه توسط اسکنر برای تعیین مرکز مختصات اسکن در زمان استفاده از ADF (تغذیه خودکار اسناد) و تشخیص خطای تغذیه دو برگ همزمان (double feed) استفاده می‌شود.
.RE
.PP
سایر گزینه‌ها بر اساس قابلیت‌های اسکنر در دسترس خواهند بود. برای مشاهده فهرست گزینه‌ها از دستور
.I scanimage \-\-help
استفاده کنید، اما توجه داشته باشید که برخی از گزینه‌ها تنها در صورتی قابل تنظیم هستند که گزینه دیگری پیش‌تر تنظیم شده باشد، و ممکن است گزینه‌های پیشرفته توسط برخی از برنامه‌های واسط کاربری پنهان شده باشند.
.PP

.SH "فایل پیکربندی (CONFIGURATION FILE)"
فایل پیکربندی
.I kodak.conf
برای تعیین نحوه جستجوی اسکنرها توسط بک‌اند و ارائه گزینه‌های کنترل‌کننده عملکرد بک‌اند استفاده می‌شود. این فایل هر بار که واسط کاربری از بک‌اند فهرست اسکنرها را درخواست می‌کند (به‌طور کلی فقط هنگام راه‌اندازی واسط کاربری) خوانده می‌شود. در صورت نبود فایل پیکربندی، بک‌اند از مجموعه‌ای از پیش‌فرض‌های کامپایل‌شده استفاده خواهد کرد که کاملاً با فایل پیکربندی پیش‌فرض ارائه‌شده همراه با SANE یکسان هستند.
.PP
اسکنرها را می‌توان در فایل پیکربندی به ۲ روش مشخص کرد:
.PP
"scsi KODAK"
.RS
از بک‌اند درخواست می‌کند تا تمام گذرگاه‌های SCSI سیستم را برای یافتن دستگاهی که خود را اسکنر ساخت «KODAK» معرفی می‌کند جستجو کند.
.RE
.PP
"scsi /dev/sg0" (یا سایر فایل‌های دستگاه scsi)
.RS
از بک‌اند درخواست می‌کند دستگاه SCSI نام‌برده‌شده را باز کند. این قابلیت فقط زمانی کاربرد دارد که چندین اسکنر سازگار به سیستم شما متصل باشند و نیاز به مشخص کردن یکی از آن‌ها داشته باشید. احتمالاً نباید همراه با سطر دیگر "scsi" در بالا استفاده شود.
.RE
.PP
تنها گزینه پیکربندی پشتیبانی‌شده
"buffer\-size=xxx"
است که به شما اجازه می‌دهد تعداد بایت‌های بافر داده را روی مقداری غیر از پیش‌فرض کامپایل‌شده، یعنی ۳۲۷۶۸ (32K)، تنظیم کنید. برخی کاربران گزارش داده‌اند که در صورت کافی نبودن بافر، اسکنر آن‌ها در میانه صفحه متوقف («هنگ») می‌شود یا در انتقال تصویر شکست می‌خورد.
.PP
نکته: این گزینه ممکن است چندین بار در فایل پیکربندی تکرار شود. این گزینه تنها برای اسکنرهایی اعمال می‌شود که توسط سطرهای 'scsi/usb' پس از آن شناسایی شوند.
.PP
نکته: بک‌اند هیچ حد بالایی برای این مقدار تعیین نمی‌کند، زیرا برخی از کاربران نیاز داشته‌اند که مقدار آن بسیار بزرگ باشد. مقادیر بالاتر از حد پیش‌فرض توصیه نمی‌شوند و ممکن است باعث از کار افتادن سیستم‌عامل یا قفل شدن درایور کارت SCSI شما شوند؛ عواقب آن بر عهده خودتان است.
.PP

.SH "محیط (ENVIRONMENT)"
این بک‌اند از یک متغیر محیطی استفاده می‌کند:
.BR SANE_DEBUG_KODAK ،
که خروجی اشکال‌زدایی را در stderr فعال می‌سازد. مقادیر معتبر عبارتند از:
.PP
.RS
5  خطاها (Errors)
.br
10 ردگیری توابع (Function trace)
.br
15 جزئیات توابع (Function detail)
.br
20 دستورات گزینه‌ها (Option commands)
.br
25 ردگیری SCSI (SCSI trace)
.br
30 جزئیات SCSI (SCSI detail)
.br
35 پیام‌های غیرضروری و شلوغی خروجی (Useless noise)
.RE

.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
بیشتر گزینه‌های سخت‌افزاری پشتیبانی نمی‌شوند یا برای کنترل توسط کاربر ارائه نشده‌اند، از جمله: تشخیص تغذیه همزمان چند برگ (multifeed detection)، فشرده‌سازی تصویر (image compression)، برش خودکار (autocropping)، مهرزن/چاپگر سند (endorser)، تعیین آستانه (thresholding)، چندجریانی (multi\-stream) و غیره.
.PP

.SH "قدردانی‌ها (CREDITS)"
نویسندگان مختلف بک‌اند
.BR sane\-fujitsu (5)
کدهای مفیدی ارائه دادند.
.br
شرکت کداک (Kodak) دسترسی به سخت‌افزار، مستندات و پرسنل را فراهم کرد.

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

.SH "نویسندگان (AUTHORS)"
m. allan noah:
.RI < "kitno455 a t gmail d o t com" >