نام (NAME)

sane-hp5590 - بک‌اند SANE برای اسکنرهای اسناد و کارگروهی Hewlett-Packard مدل‌های 4500C/4570C/5500C/5550C/5590/7650

توضیحات (DESCRIPTION)

کتابخانه sane-hp5590 یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای اسناد و کارگروهی Hewlett-Packard زیر را فراهم می‌سازد:

•

ScanJet 4500C

•

ScanJet 4570C

•

ScanJet 5500C

•

ScanJet 5550C

•

ScanJet 5590

•

ScanJet 7650

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

گزینه‌ها (OPTIONS)

گزینه‌هایی که این بک‌اند پشتیبانی می‌کند را می‌توان از طریق گزینه‌های خط فرمان برای برنامه‌هایی مانند scanimage(1) یا از طریق عناصر رابط کاربری گرافیکی در xscanimage(1) یا xsane(1) انتخاب کرد. گزینه‌های معتبر خط فرمان و ساختار نحوی آن‌ها را می‌توان با دستور زیر فهرست کرد:

scanimage --help -d hp5590:interface:device

که در آن interface و device دستگاه مورد نظر را مانند فایل پیکربندی مشخص می‌کنند. گزینه --all-options را برای فهرست کردن گزینه‌های بازخوانی سخت‌افزاری نیز اضافه کنید. پارامتر -d و آرگومان آن را می‌توان برای به دست آوردن اطلاعات درباره نخستین اسکنر شناسایی‌شده حذف کرد.

از دستور:

scanimage -L

برای فهرست کردن تمامی دستگاه‌های شناخته‌شده توسط سامانه SANE خود استفاده کنید.

گزینه‌های ویژه دستگاه (DEVICE SPECIFIC OPTIONS)

-l n

موقعیت افقی (X) گوشه بالا-چپ ناحیه اسکن بر حسب mm. محدوده مجاز: 0 .. 215.889.

-t n

موقعیت عمودی (Y) گوشه بالا-چپ ناحیه اسکن بر حسب mm. محدوده مجاز: 0 .. 297.699.

-x n

عرض افقی (X) ناحیه اسکن بر حسب mm. محدوده مجاز: 0 .. 215.889.

-y n

ارتفاع عمودی (Y) ناحیه اسکن بر حسب mm. محدوده مجاز: 0 .. 297.699.

به‌طور پیش‌فرض، حداکثر اندازه اسکن خواهد شد.

--mode mode

انتخاب حالت رنگی. mode باید یکی از موارد زیر باشد: “Color”، “Color (48 bits)”، “Gray”، “Lineart”.

--source source

انتخاب منبع اسکن. source باید یکی از موارد زیر باشد: “Flatbed”، “ADF”، “ADF Duplex”، “TMA Slides”، “TMA Negatives”.

--resolution res

تنظیم وضوح تصویر اسکن‌شده بر حسب dpi. res باید یکی از مقادیر روبه‌رو باشد: 100, 200, 300, 600, 1200, 2400.

تنظیمات پیش‌فرض: Lineart، Flatbed، 100dpi.

--extend-lamp-timeout[=yes|no]

افزایش بازه زمانی مهلت خاموش شدن لامپ. no = ۱۵ دقیقه، yes = ۱ ساعت. (پیش‌فرض: no)

--wait-for-button[=yes|no]

انتظار برای فشردن دکمه پیش از شروع اسکن. (پیش‌فرض: no)

--preview[=yes|no]

درخواست اسکن با کیفیت پیش‌نمایش. (پیش‌فرض: no)

--hide-eop-pixel[=yes|no]

پنهان کردن پیکسل‌های نشانگر پایان صفحه و جایگزینی آن‌ها با رنگ نزدیک‌ترین پیکسل‌های مجاور. (پیش‌فرض: yes)
اسکنر از آخرین پیکسل در هر خط اسکن برای ذخیره وضعیت پایان صفحه استفاده می‌کند. این امر برای تشخیص پایان برگه سند در زمان استفاده از تغذیه‌کننده خودکار اسناد (ADF) لازم است. متأسفانه پیکسل‌های پایان صفحه در اسکن‌های تخت (flatbed) نیز تولید می‌شوند. توصیه می‌شود این پیکسل‌ها پنهان شوند.

--trailing-lines-mode mode

حالت پر کردن خطوط انتهایی پس از پایان صفحه در هنگام استفاده از تغذیه‌کننده خودکار اسناد (ADF). mode باید یکی از موارد زیر باشد: “last”، “raw”، “raster”، “white”، “black”، “color”. (پیش‌فرض: “last”)

--trailing-lines-color n

تنظیم مقدار رنگ برای پر کردن خطوط اسکن انتهایی در حالت خطوط انتهایی “color” (گزینه قبلی را ببینید). (رنگ پیش‌فرض: violet)
مقدار رنگ RGB باید به‌صورت 65536 * r + 256 * g + b مشخص و محاسبه شود، به گونه‌ای که r و g و b مقادیری در محدوده 0 .. 255 باشند.

گزینه‌های بازخوانی (READ OUT OPTIONS)

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

--button-pressed

دریافت شناسه آخرین دکمه فشرده‌شده. شناسه یکی از موارد زیر است: “none”، “power”، “scan”، “collect”، “file”، “email”، “copy”، “up”، “down”، “mode”، “cancel”.
اسکنر شناسه آخرین دکمه فشرده‌شده را تا زمان بازخوانی ذخیره می‌کند. پس از بازخوانی، وضعیت بازنشانی می‌شود و خواندن‌های بعدی مقدار “none” را بازمی‌گردانند.

--color-led

دریافت وضعیت نشانگرهای LED رنگی. وضعیت یا “color” است یا “black_white”.

--counter-value

دریافت مقدار شمارنده مطابق آنچه روی نمایشگر LCD نشان داده می‌شود. مقدار در محدوده 1 .. 99 است.

--doc-in-adf

دریافت وضعیت نشانگر وجود سند در تغذیه‌کننده خودکار اسناد (ADF). وضعیت یا “yes” است یا “no”.

نکاتی برای کاربران SCANBD (HINTS FOR USERS OF SCANBD)

برنامه scanbd(8) یک دیمن دکمه اسکنر است که می‌تواند دکمه‌های اسکنر را بازخوانی کند و اقدامات اسکن را راه‌اندازی نماید.

از رابط قدیمی scanbuttond(8) با hp5590 استفاده نکنید. این رابط منسوخ شده است و دیگر نباید مورد استفاده قرار گیرد. رابط استاندارد scanbd(8) به‌طور کامل توسط نسخه فعلی بک‌اند hp5590 پشتیبانی می‌شود.

این مثال یک فایل پیکربندی کمینه و فایل اسکریپت متناظر برای scanbd(8) را نشان می‌دهد که باید در scanbd.conf قرار گیرد.

•

hp5590.conf

device hp5590 {
    # Device matching
    filter = "^hp5590.*"
    desc = "HP5590 Scanner Family"
    # Read out counter value and store in environment variable.
    function function_lcd_counter {
        filter = "^counter-value.*"
        desc   = "hp5590: LCD counter"
        env    = "SCANBD_FUNCTION_LCD_COUNTER"
    }
    # Run scan script when button is pressed.
    action do-scan {
        filter = "^button-pressed.*"
        desc   = "hp5590: Scan button pressed"
        script = "scan_action.script"
        string-trigger {
            from-value  = "none"
            to-value    = "scan"
        }
    }
}

•

scan_action.script

#!/bin/bash
echo device = $SCANBD_DEVICE
echo action = $SCANBD_ACTION
echo counter = $SCANBD_FUNCTION_LCD_COUNTER
scanfile="$HOME/tmp/scans/scan-$(date +%s).pnm"
case $SCANBD_ACTION in
do-scan)
    scanimage -d "$SCANBD_DEVICE" > "$scanfile"
    ;;
*)
    echo Warning: Unknown scanbd action: "$SCANBD_ACTION"
    ;;
esac

فایل‌ها (FILES)

@LIBDIR@/libsane-hp5590.a

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

@LIBDIR@/libsane-hp5590.so

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

محیط (ENVIRONMENT)

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

SANE_DEBUG_HP5590

سطوح بالاتر اشکال‌زدایی، جزئیات خروجی را افزایش می‌دهند:

10 - generic processing
20 - verbose backend messages
40 - HP5590 high-level commands
50 - HP5590 low-level (USB-in-USB) commands

مثال:

export SANE_DEBUG_HP5590=50

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

sane(7), sane-usb(5), scanbd(8), scanimage(1), xscanimage(1), xsane(1)

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

Ilia Sotnikov <hostcc@gmail.com>.