.\" Automatically generated by Pandoc 2.7.2 .\" .TH "sane-hp5590" "5" "13 Jul 2008" "" "SANE Scanner Access Now Easy" .hy .SH "نام (NAME)" .PP sane-hp5590 \- بک‌اند SANE برای اسکنرهای اسناد و کارگروهی Hewlett-Packard مدل‌های 4500C/4570C/5500C/5550C/5590/7650 .SH "توضیحات (DESCRIPTION)" .PP کتابخانه .B sane-hp5590 یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای اسناد و کارگروهی Hewlett-Packard زیر را فراهم می‌سازد: .IP \[bu] 2 ScanJet 4500C .IP \[bu] 2 ScanJet 4570C .IP \[bu] 2 ScanJet 5500C .IP \[bu] 2 ScanJet 5550C .IP \[bu] 2 ScanJet 5590 .IP \[bu] 2 ScanJet 7650 .PP اگر اسکنری غیر از موارد فهرست‌شده در بالا دارید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام دقیق مدل اسکنر و شناسه‌های دستگاه و سازنده USB (برای نمونه از .IR /sys/bus/usb/devices ، .BR sane-find-scanner (1) یا syslog) به ما اطلاع دهید. حتی اگر نام اسکنر تنها اندکی با مدل‌های ذکر شده در بالا تفاوت دارد، لطفاً به ما اطلاع دهید. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌هایی که این بک‌اند پشتیبانی می‌کند را می‌توان از طریق گزینه‌های خط فرمان برای برنامه‌هایی مانند .BR scanimage (1) یا از طریق عناصر رابط کاربری گرافیکی در .BR xscanimage (1) یا .BR xsane (1) انتخاب کرد. گزینه‌های معتبر خط فرمان و ساختار نحوی آن‌ها را می‌توان با دستور زیر فهرست کرد: .IP .nf \f[C] scanimage --help -d hp5590:interface:device \f[R] .fi .PP که در آن \f[I]interface\f[R] و \f[I]device\f[R] دستگاه مورد نظر را مانند فایل پیکربندی مشخص می‌کنند. گزینه .B --all-options را برای فهرست کردن گزینه‌های بازخوانی سخت‌افزاری نیز اضافه کنید. پارامتر .B \-d و آرگومان آن را می‌توان برای به دست آوردن اطلاعات درباره نخستین اسکنر شناسایی‌شده حذف کرد. .PP از دستور: .IP .nf \f[C] scanimage -L \f[R] .fi .PP برای فهرست کردن تمامی دستگاه‌های شناخته‌شده توسط سامانه SANE خود استفاده کنید. .SH "گزینه‌های ویژه دستگاه (DEVICE SPECIFIC OPTIONS)" .TP .B -l \f[I]n\f[R] موقعیت افقی (X) گوشه بالا-چپ ناحیه اسکن بر حسب \f[B]mm\f[R]. محدوده مجاز: 0 .. 215.889. .TP .B -t \f[I]n\f[R] موقعیت عمودی (Y) گوشه بالا-چپ ناحیه اسکن بر حسب \f[B]mm\f[R]. محدوده مجاز: 0 .. 297.699. .TP .B -x \f[I]n\f[R] عرض افقی (X) ناحیه اسکن بر حسب \f[B]mm\f[R]. محدوده مجاز: 0 .. 215.889. .TP .B -y \f[I]n\f[R] ارتفاع عمودی (Y) ناحیه اسکن بر حسب \f[B]mm\f[R]. محدوده مجاز: 0 .. 297.699. .PP به‌طور پیش‌فرض، حداکثر اندازه اسکن خواهد شد. .TP .B --mode \f[I]mode\f[R] انتخاب حالت رنگی. \f[I]mode\f[R] باید یکی از موارد زیر باشد: \[lq]Color\[rq]، \[lq]Color (48 bits)\[rq]، \[lq]Gray\[rq]، \[lq]Lineart\[rq]. .RS .IP \[bu] 2 \[lq]Color\[rq] \- اسکن با ۳ مقدار رنگی ۸ بیتی RGB برای هر پیکسل انجام می‌شود. .IP \[bu] 2 \[lq]Color (48 bits)\[rq] \- اسکن با ۳ مقدار رنگی ۱۶ بیتی RGB برای هر پیکسل انجام می‌شود. .IP \[bu] 2 \[lq]Gray\[rq] \- اسکن با ۱ مقدار خاکستری ۸ بیتی برای هر پیکسل انجام می‌شود. .IP \[bu] 2 \[lq]Lineart\[rq] \- اسکن با مقدار سیاه و سفید ۱ بیتی برای هر پیکسل انجام می‌شود. .RE .TP .B --source \f[I]source\f[R] انتخاب منبع اسکن. \f[I]source\f[R] باید یکی از موارد زیر باشد: \[lq]Flatbed\[rq]، \[lq]ADF\[rq]، \[lq]ADF Duplex\[rq]، \[lq]TMA Slides\[rq]، \[lq]TMA Negatives\[rq]. .RS .IP \[bu] 2 \[lq]Flatbed\[rq] \- اسکن سند روی شیشه تخت اسکنر. .IP \[bu] 2 \[lq]ADF\[rq] \- اسکن روی اسناد با استفاده از تغذیه‌کننده خودکار اسناد (ADF). .IP \[bu] 2 \[lq]ADF Duplex\[rq] \- اسکن دوروی اسناد با تغذیه‌کننده خودکار اسناد (ADF). توجه: تصاویر پشت برگه باید در یک مرحله پس‌پردازش جداگانه چرخانده شوند. .IP \[bu] 2 \[lq]TMA Slides\[rq] \- اسکن اسلاید با آداپتور رسانه شفاف (TMA). (به‌طور کامل توسط بک‌اند hp5590 پشتیبانی نمی‌شود). .IP \[bu] 2 \[lq]TMA Negatives\[rq] \- اسکن نگاتیو فیلم با آداپتور رسانه شفاف (TMA). (به‌طور کامل توسط بک‌اند hp5590 پشتیبانی نمی‌شود). .RE .TP .B --resolution \f[I]res\f[R] تنظیم وضوح تصویر اسکن‌شده بر حسب \f[B]dpi\f[R]. \f[I]res\f[R] باید یکی از مقادیر روبه‌رو باشد: 100, 200, 300, 600, 1200, 2400. .PP تنظیمات پیش‌فرض: Lineart، Flatbed، 100dpi. .TP .B --extend-lamp-timeout[=yes|no] افزایش بازه زمانی مهلت خاموش شدن لامپ. no = ۱۵ دقیقه، yes = ۱ ساعت. (پیش‌فرض: no) .TP .B --wait-for-button[=yes|no] انتظار برای فشردن دکمه پیش از شروع اسکن. (پیش‌فرض: no) .TP .B --preview[=yes|no] درخواست اسکن با کیفیت پیش‌نمایش. (پیش‌فرض: no) .TP .B --hide-eop-pixel[=yes|no] پنهان کردن پیکسل‌های نشانگر پایان صفحه و جایگزینی آن‌ها با رنگ نزدیک‌ترین پیکسل‌های مجاور. (پیش‌فرض: yes) .br اسکنر از آخرین پیکسل در هر خط اسکن برای ذخیره وضعیت پایان صفحه استفاده می‌کند. این امر برای تشخیص پایان برگه سند در زمان استفاده از تغذیه‌کننده خودکار اسناد (ADF) لازم است. متأسفانه پیکسل‌های پایان صفحه در اسکن‌های تخت (flatbed) نیز تولید می‌شوند. توصیه می‌شود این پیکسل‌ها پنهان شوند. .TP .B --trailing-lines-mode \f[I]mode\f[R] حالت پر کردن خطوط انتهایی پس از پایان صفحه در هنگام استفاده از تغذیه‌کننده خودکار اسناد (ADF). \f[I]mode\f[R] باید یکی از موارد زیر باشد: \[lq]last\[rq]، \[lq]raw\[rq]، \[lq]raster\[rq]، \[lq]white\[rq]، \[lq]black\[rq]، \[lq]color\[rq]. (پیش‌فرض: \[lq]last\[rq]) .RS .IP \[bu] 2 \[lq]last\[rq] = تکرار آخرین خط اسکن (توصیه‌شده)، .IP \[bu] 2 \[lq]raw\[rq] = خواندن داده‌های خام اسکن (توصیه نمی‌شود)، .IP \[bu] 2 \[lq]raster\[rq] = ایجاد الگوی پیکسلی سیاه و سفید، .IP \[bu] 2 \[lq]white\[rq] = پیکسل‌های سفید، .IP \[bu] 2 \[lq]black\[rq] = پیکسل‌های سیاه، .IP \[bu] 2 \[lq]color\[rq] = پیکسل‌های رنگی RGB یا خاکستری (گزینه بعدی را ببینید). .RE .TP .B --trailing-lines-color \f[I]n\f[R] تنظیم مقدار رنگ برای پر کردن خطوط اسکن انتهایی در حالت خطوط انتهایی \[lq]color\[rq] (گزینه قبلی را ببینید). (رنگ پیش‌فرض: violet) .br مقدار رنگ RGB باید به‌صورت 65536 * r + 256 * g + b مشخص و محاسبه شود، به گونه‌ای که r و g و b مقادیری در محدوده 0 .. 255 باشند. .SH "گزینه‌های بازخوانی (READ OUT OPTIONS)" .PP گزینه‌های زیر امکان بازخوانی وضعیت دکمه‌ها، مقدار شمارنده، تنظیمات رنگ و وضعیت سند در ADF را فراهم می‌کنند. این قابلیت را می‌توان برای کنترل برنامه‌نویسی‌شده گزینه‌های اسکنر متناظر مانند جابجایی بین حالت‌های \f[I]flatbed\f[R] و \f[I]ADF\f[R]، یا راه‌اندازی فرآیندهای پس‌پردازش پس از اسکن به کار برد. .TP .B --button-pressed دریافت شناسه آخرین دکمه فشرده‌شده. شناسه یکی از موارد زیر است: \[lq]none\[rq]، \[lq]power\[rq]، \[lq]scan\[rq]، \[lq]collect\[rq]، \[lq]file\[rq]، \[lq]email\[rq]، \[lq]copy\[rq]، \[lq]up\[rq]، \[lq]down\[rq]، \[lq]mode\[rq]، \[lq]cancel\[rq]. .br اسکنر شناسه آخرین دکمه فشرده‌شده را تا زمان بازخوانی ذخیره می‌کند. پس از بازخوانی، وضعیت بازنشانی می‌شود و خواندن‌های بعدی مقدار \[lq]none\[rq] را بازمی‌گردانند. .TP .B --color-led دریافت وضعیت نشانگرهای LED رنگی. وضعیت یا \[lq]color\[rq] است یا \[lq]black_white\[rq]. .TP .B --counter-value دریافت مقدار شمارنده مطابق آنچه روی نمایشگر LCD نشان داده می‌شود. مقدار در محدوده 1 .. 99 است. .TP .B --doc-in-adf دریافت وضعیت نشانگر وجود سند در تغذیه‌کننده خودکار اسناد (ADF). وضعیت یا \[lq]yes\[rq] است یا \[lq]no\[rq]. .SH "نکاتی برای کاربران SCANBD (HINTS FOR USERS OF SCANBD)" .PP برنامه .BR scanbd (8) یک دیمن دکمه اسکنر است که می‌تواند دکمه‌های اسکنر را بازخوانی کند و اقدامات اسکن را راه‌اندازی نماید. .PP از رابط قدیمی .BR scanbuttond (8) با hp5590 استفاده نکنید. این رابط منسوخ شده است و دیگر نباید مورد استفاده قرار گیرد. رابط استاندارد .BR scanbd (8) به‌طور کامل توسط نسخه فعلی بک‌اند \f[I]hp5590\f[R] پشتیبانی می‌شود. .PP این مثال یک فایل پیکربندی کمینه و فایل اسکریپت متناظر برای .BR scanbd (8) را نشان می‌دهد که باید در .IR scanbd.conf قرار گیرد. .IP \[bu] 2 .I hp5590.conf .IP .nf \f[C] device hp5590 { # Device matching filter = \[dq]\[ha]hp5590.*\[dq] desc = \[dq]HP5590 Scanner Family\[dq] # Read out counter value and store in environment variable. function function_lcd_counter { filter = \[dq]\[ha]counter-value.*\[dq] desc = \[dq]hp5590: LCD counter\[dq] env = \[dq]SCANBD_FUNCTION_LCD_COUNTER\[dq] } # Run scan script when button is pressed. action do-scan { filter = \[dq]\[ha]button-pressed.*\[dq] desc = \[dq]hp5590: Scan button pressed\[dq] script = \[dq]scan_action.script\[dq] string-trigger { from-value = \[dq]none\[dq] to-value = \[dq]scan\[dq] } } } \f[R] .fi .IP \[bu] 2 \f[B]scan_action.script\f[R] .IP .nf \f[C] #!/bin/bash echo device = $SCANBD_DEVICE echo action = $SCANBD_ACTION echo counter = $SCANBD_FUNCTION_LCD_COUNTER scanfile=\[dq]$HOME/tmp/scans/scan-$(date +%s).pnm\[dq] case $SCANBD_ACTION in do-scan) scanimage -d \[dq]$SCANBD_DEVICE\[dq] > \[dq]$scanfile\[dq] ;; *) echo Warning: Unknown scanbd action: \[dq]$SCANBD_ACTION\[dq] ;; esac \f[R] .fi .SH "فایل‌ها (FILES)" .TP .B \f[I]\[at]LIBDIR\[at]/libsane-hp5590.a\f[R] کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند. .TP .B \f[I]\[at]LIBDIR\[at]/libsane-hp5590.so\f[R] کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است). .SH "محیط (ENVIRONMENT)" .PP اگر کتابخانه با فعال بودن قابلیت اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. .PP \f[B]SANE_DEBUG_HP5590\f[R] .PP سطوح بالاتر اشکال‌زدایی، جزئیات خروجی را افزایش می‌دهند: .IP .nf \f[C] 10 - generic processing 20 - verbose backend messages 40 - HP5590 high-level commands 50 - HP5590 low-level (USB-in-USB) commands \f[R] .fi .TP .B مثال: export SANE_DEBUG_HP5590=50 .SH "همچنین ببینید (SEE ALSO)" .PP .BR sane (7), .BR sane\-usb (5), .BR scanbd (8), .BR scanimage (1), .BR xscanimage (1), .BR xsane (1) .SH "نویسندگان (AUTHORS)" Ilia Sotnikov .RI < hostcc@gmail.com >.