نام (NAME)

sane-genesys - پسوند SANE برای اسکنرهای تخت USB مبتنی بر تراشه‌های GL646، GL841، GL843، GL847 و GL124

توضیحات (DESCRIPTION)

کتابخانه sane-genesys یک پسوند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB مبتنی بر تراشه‌های Genesys GL646، GL841، GL843، GL847 و GL124 را فراهم می‌سازد. در حال حاضر، مشخص شده است که اسکنرهای زیر با این پسوند کار می‌کنند:

این یک نرم‌افزار پایدار برای مدل‌های پشتیبانی‌شده است. اما اگر اسکنرهای جدید یا آزمایش‌نشده را تست می‌کنید، دست خود را روی دوشاخه اسکنر نگه دارید و در صورتی که هد اسکنر به انتهای ناحیه اسکن برخورد کرد، آن را از برق بکشید.

اگر اسکنری غیر از موارد ذکرشده در بالا دارید که با این پسوند کار می‌کند، لطفاً با ارسال نام دقیق مدل اسکنر و شناسه‌های سازنده و دستگاه USB (به‌عنوان مثال از /proc/bus/usb/devices، sane-find-scanner یا syslog) به لیست پستی sane-devel اطلاع دهید. حتی اگر نام اسکنر تنها اندکی با مدل‌های ذکرشده در بالا تفاوت دارد، لطفاً اطلاع دهید.

اگر اسکنری دارید که توسط پسوند genesys شناسایی نمی‌شود اما دارای تراشه GL646، GL841، GL843، GL847 یا GL124 است، می‌توانید برای افزودن آن به این پسوند تلاش کنید.

کالیبراسیون (CALIBRATION)

برای ارائه کیفیت تصویر مناسب، اسکنرهای تغذیه برگه‌ای باید با استفاده از برگه کالیبراسیون فروخته‌شده همراه اسکنر کالیبره شوند. برای انجام کالیبراسیون، باید این برگه هدف را در تغذیه‌کننده قرار دهید و سپس با ارسال گزینه --calibrate به scanimage(1) یا با کلیک بر روی دکمه موجود «calibrate» در «advanced options» در یک رابط گرافیکی، کالیبراسیون را آغاز کنید. نتیجه کالیبراسیون در فایلی در دایرکتوری خانگی کاربری که آن را انجام می‌دهد ذخیره می‌شود. اگر اسکنر را به رایانه دیگری متصل کنید یا از آن با حساب کاربری دیگری استفاده نمایید، کالیبراسیون باید مجدداً انجام شود، مگر اینکه از گزینه --calibration-file استفاده کنید. اگر هیچ دایرکتوری خانگی تعریف نشده باشد، USERAPPPROFILE استفاده خواهد شد، سپس TMPDIR یا TMP. اگر هیچ‌یک از این دایرکتوری‌ها وجود نداشته باشند، پسوند تلاش خواهد کرد در دایرکتوری کاری جاری بنویسد. اسکنرهای تخت نیز از فایل کالیبراسیون به‌عنوان یک حافظه پنهان (کَش) استفاده می‌کنند تا از کالیبراسیون پیش از هر اسکن جلوگیری شود. در صورتی که تنها یک اسکنر شناسایی شود، نام فایل کالیبراسیون همان نام مدل اسکنر خواهد بود. در صورت وجود چندین مدل یکسان، نام فایل همان نام منطقی دستگاه USB خواهد بود. زمان انقضا، مدت‌زمانی را که یک کالیبراسیون در حافظه پنهان معتبر است مدیریت می‌کند. مقدار -1 به معنای دائمی و مقدار 0 به معنای عدم استفاده از حافظه پنهان است.

گزینه‌های اسکن اضافی (EXTRAS SCAN OPTIONS)

--lamp-off-time number

لامپ پس از زمان مشخص‌شده (برحسب دقیقه) خاموش خواهد شد. مقدار 0 به این معنی است که لامپ خاموش نخواهد شد.

--threshold percent

0..100% (با گام‌های 1 تایی). حداقل روشنایی را برای دستیابی به نقطه سفید انتخاب می‌کند. پیکسل‌هایی با روشنایی کمتر از این مقدار به‌صورت سیاه اسکن خواهند شد.

--brightness value

-100..100 (با گام‌های 1 تایی). تنظیم میزان بهبود روشنایی. 0 برای بدون تغییر، مقادیر منفی برای کاهش روشنایی، و مقادیر مثبت برای افزایش آن.

--contrast value

-100..100 (با گام‌های 1 تایی). تنظیم میزان بهبود کنتراست. 0 برای بدون تغییر، مقادیر منفی برای کاهش کنتراست، و مقادیر مثبت برای افزایش آن.

--disable-interpolation yes|no

هنگام استفاده از وضوح‌های بالا که در آن‌ها وضوح افقی کمتر از وضوح عمودی است، داده‌ها توسط نرم‌افزار گسترش می‌یابند تا هندسه تصویر حفظ شود. این ویژگی را می‌توان با این گزینه غیرفعال کرد تا داده‌های اسکن‌شده واقعی دریافت شوند.

--disable-dynamic-lineart yes|no

استفاده از الگوریتم انطباقی نرم‌افزاری برای تولید طرح خطی را غیرفعال کرده و بر طرح خطی سخت‌افزاری تکیه می‌کند.

--color-filter None|Red|Green|Blue

هنگام استفاده از حالت خاکستری یا طرح خطی، این گزینه رنگ مورد استفاده را انتخاب می‌کند. استفاده از فیلتر رنگ خروجی تک‌رنگ (monochrome) خواهد داد. اسکنرهای مبتنی بر CIS در صورت انتخاب نشدن هیچ فیلتری (مقدار None)، می‌توانند خاکستری واقعی تولید کنند.

--lamp-off-scan

لامپ در طول اسکن خاموش خواهد شد. کالیبراسیون همچنان با لامپ روشن انجام می‌شود.

--clear-calibration

داده‌های حافظه پنهان کالیبراسیون را پاک می‌کند، که باعث راه‌اندازی کالیبراسیون جدیدی برای دستگاه هنگام انجام اسکن بعدی خواهد شد.

--calibration-file

نام فایل کالیبراسیون مورد استفاده را مشخص می‌کند. حداقل دایرکتوری حاوی فایل باید وجود داشته باشد، زیرا ایجاد نخواهد شد. این گزینه در صورتی که پسوند با دسترسی کاربر ریشه (root) اجرا شود غیرفعال است. این گزینه ممکن است در مورد اسکنرهای تغذیه برگه‌ای برای به‌اشتراک‌گذاری فایل کالیبراسیون بین چندین کاربر استفاده شود.

--expiration-time

مدت‌زمانی (برحسب دقیقه) را که یک کالیبراسیون کش‌شده معتبر تلقی می‌شود مشخص می‌کند. اگر قدیمی‌تر از مقدار ارائه‌شده باشد، کالیبراسیون جدیدی انجام می‌شود. مقدار -1 به این معنی است که انقضایی وجود ندارد و مقادیر کش‌شده برای همیشه نگهداری می‌شوند مگر اینکه توسط کاربر با گزینه پاک‌سازی کالیبراسیون پاک شوند. مقدار 0 به این معنی است که حافظه پنهان غیرفعال است.

علاوه بر این، چندین گزینه «نرم‌افزاری» توسط این پسوند ارائه شده است. این‌ها بازپیاده‌سازی قابلیت‌هایی هستند که به‌طور بومی توسط اسکنرهای بزرگ‌تر ارائه می‌شوند، اما روی رایانه میزبان اجرا می‌گردند. این کار اسکنرهای کوچک‌تر را قادر می‌سازد تا قابلیت‌های مشابهی داشته باشند. لطفاً توجه داشته باشید که این ویژگی‌ها تا حدی ساده‌سازی‌شده هستند و ممکن است به خوبی پیاده‌سازی‌های بومی عمل نکنند. همچنین توجه داشته باشید که همه این ویژگی‌ها مستلزم آن هستند که درایور کل تصویر را در حافظه نگهداری کند. این موضوع تقریباً به‌طور قطع منجر به کاهش سرعت اسکن خواهد شد.

--swcrop

از درایور می‌خواهد که لبه‌های کاغذ را در تصویر بزرگ‌تر تشخیص دهد و حاشیه‌های خالی را برش بزند.

--swdeskew

از درایور می‌خواهد که انحراف و زاویه کاغذ را در تصویر بزرگ‌تر تشخیص داده و آن را صاف کند.

--swdespeck --despeck X

از درایور می‌خواهد که نقاط و لکه‌های با قطر X یا کوچک‌تر را از تصویر پیدا کرده و حذف کند، و فضای آن را با رنگ میانگین محیط اطراف پر کند.

--swskip 0..100% (in steps of 1) [0]

از درایور می‌خواهد صفحاتی را که تعداد کمی پیکسل تیره دارند نادیده بگیرد.

--swderotate[=(yes|no)] [no]

از درایور می‌خواهد که چرخش ۹۰ درجه تصویر را تشخیص داده و اصلاح کند.

مسائل سیستمی (SYSTEM ISSUES)

این پسوند نیازمند نصب بودن libusb-0.1.6 یا بالاتر است، و در پیکربندی‌هایی غیر از هسته لینوکس ۲.۶.۹ یا بالاتر آزمایش نشده است. با این حال، باید در هر سیستمی مجهز به libusb که بسته SANE بتواند روی آن کامپایل شود کار کند. برای تنظیم دسترسی‌ها و اطلاعات عمومی در مورد USB به sane-usb(5) مراجعه کنید.

پیکربندی (CONFIGURATION)

محتویات فایل genesys.conf فهرستی از خطوط usb حاوی شناسه‌های سازنده و محصول است که متناظر با اسکنرهای USB هستند. این فایل همچنین می‌تواند حاوی خطوط گزینه‌ها باشد. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند نادیده گرفته می‌شوند. اسکنرها به‌طور خودکار توسط عبارات usb vendor_id product_id که از قبل در genesys.conf گنجانده شده‌اند، شناسایی می‌شوند. عبارات «vendor_id» و «product_id» اعدادی در مبنای ۱۶ (هگزادسیمال) هستند که اسکنر را مشخص می‌کنند.

فایل‌ها (FILES)

/etc/sane.d/genesys.conf

فایل پیکربندی پسوند (همچنین به توضیحات SANE_CONFIG_DIR در زیر مراجعه کنید).

/usr/lib/sane/libsane-genesys.a

کتابخانه ایستا که این پسوند را پیاده‌سازی می‌کند.

/usr/lib/sane/libsane-genesys.so

کتابخانه اشتراکی که این پسوند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).

محیط (ENVIRONMENT)

SANE_CONFIG_DIR

این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های شبه‌یونیکس (*NIX)، دایرکتوری‌ها با دو‌نقطه («:») و در OS/2 با نقطه-ویرگول («;») از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا در دایرکتوری کاری جاری («.») و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های مشخص‌شده صریح جستجو می‌شوند. برای مثال، تنظیم SANE_CONFIG_DIR روی «/tmp/config:» منجر به این می‌شود که دایرکتوری‌های tmp/config، . و /etc/sane.d (به همین ترتیب) جستجو شوند.

SANE_DEBUG_GENESYS

اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این پسوند کنترل می‌کند. سطوح اشکال‌زدایی بالاتر، پرگویی خروجی را افزایش می‌دهند. اگر سطح اشکال‌زدایی روی 1 یا بالاتر تنظیم شود، برخی از گزینه‌های اشکال‌زدایی که معمولاً پنهان هستند در دسترس قرار می‌گیرند. با احتیاط از آن‌ها استفاده کنید. این کار پیام‌های مربوط به عملکردهای اصلی genesys را چاپ می‌کند.

SANE_DEBUG_GENESYS_IMAGE

اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی ثبت وقایع داده‌های تصویر میانی را فعال می‌کند. برای فعال کردن این حالت، متغیر محیطی را روی 1 تنظیم کنید.

مثال (خروجی کامل و بسیار باجزئیات برای gl646):
export SANE_DEBUG_GENESYS=255

قدردانی‌ها (CREDITS)

جک مک‌گیل (Jack McGill) برای اهدای چندین اسکنر تغذیه برگه‌ای و تخت، که افزودن پشتیبانی از آن‌ها را در پسوند genesys امکان‌پذیر ساخت:

شرکت cncsolutions برای حمایت مالی و پشتیبانی از کار روی Panasonic KV-SS080.

برایان پااوو (Brian Paavo) از Benthic Science Limited برای اهدای یک دستگاه Canoscan LiDE 700F.

دانی قومسیه (Dany Qumsiyeh) برای اهدای یک دستگاه Canoscan LiDE 210 و یک دستگاه LiDE 220.

لوک وِرهایخن (Luc Verhaegen) برای اهدای یک دستگاه Canoscan LiDE 120.

همچنین ببینید (SEE ALSO)

sane(7), sane-usb(5)

نویسندگان (AUTHORS)

Oliver Rauch
Henning Meier-Geinitz <henning@meier-geinitz.de>
Gerhard Jaeger <gerhard@gjaeger.de>
Stéphane Voltz <stef.dev@free.fr>
Philipp Schmid <philipp8288@web.de>
Pierre Willenbrock <pierre@pirsoft.dnsalias.org>
Alexey Osipov <simba@lerlan.ru> برای پشتیبانی نهایی از HP2400

محدودیت‌ها (LIMITATIONS)

صرفه‌جویی در مصرف انرژی برای اسکنرهای مبتنی بر gl646 پیاده‌سازی نشده است. طرح پویا (شبیه‌سازی‌شده از داده‌های خاکستری و همراه با ترام‌ریزی) برای اسکنرهای gl646 فعال نیست. طرح خطی سخت‌افزاری به دلیل نحوه ساخت حسگرهای تصویر، برای اسکنرهای مبتنی بر gl847 تا 600 dpi محدود شده است.

این پسوند در صورت عدم استفاده از libusb-1.0 بسیار کندتر خواهد بود. بنابراین اطمینان حاصل کنید که sane-backends با گزینه --enable-libusb_1_0 ساخته شده است.

اشکالات (BUGS)

برای مدل LiDE 200، داده‌های اسکن‌شده در وضوح 4800 dpi به‌صورت دست‌نخورده («همان‌طور که هست») از حسگر دریافت می‌شوند. به نظر می‌رسد درایور ویندوز پردازش دیجیتالی خاصی برای بهبود آن انجام می‌دهد که در این پسوند پیاده‌سازی نشده است.