.TH sane\-test 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-test
.SH "نام (NAME)"
sane\-test \- بک‌اند SANE برای آزمایش فرانت‌اندها
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-test
یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که امکان آزمایش نصب SANE و فرانت‌اندهای SANE را فراهم می‌سازد. این بک‌اند دسترسی به تعداد (تقریباً) نامحدودی از دستگاه‌های مجازی را فراهم می‌کند. هیچ پشتیبانی از اسکنرها یا دوربین‌های واقعی وجود ندارد. با این حال، این بک‌اند اسکن کردن و تنظیم گزینه‌ها را شبیه‌سازی می‌کند.
.PP
هدف نه تنها یافتن اشکال‌ها در فرانت‌اندها، بلکه نمایش تمام قابلیت‌های SANE است. بنابراین
.B sane\-test
توابع و گزینه‌هایی را پیاده‌سازی می‌کند که در سایر بک‌اندها یافت نمی‌شوند (یا به ندرت یافت می‌شوند).
.PP
این بک‌اند در
.IR /etc/sane.d/dll.conf
کامنت شده است، بنابراین یا باید نویسه کامنت برداشته شود یا بک‌اند باید به صراحت فراخوانی شود. مانند
.I scanimage \-d test
یا
.IR "xscanimage test" .


.SH "گزینه‌های حالت اسکن (SCAN MODE OPTIONS)"
گزینه
.B mode
حالت اسکن (Gray یا Color) را انتخاب می‌کند.
.PP
گزینه
.B depth
تعداد بیت در هر نمونه (1، 8 یا 16) را تعیین می‌کند. به خاطر داشته باشید که این مقدار به نمونه اشاره دارد، نه پیکسل. بنابراین depth=16 منجر به 48 بیت در هر پیکسل در حالت رنگی می‌شود. معمول‌ترین ترکیب‌ها عبارتند از mode=Gray و depth=1 برای lineart،‏ mode=Gray و depth=8 برای خاکستری و mode=Color و depth=8 برای حالت رنگی. ترکیب حالت رنگی و 1 بیتی نسبتاً نامتعارف است (8 رنگ) اما در استاندارد SANE مجاز است. با این حال، معنای بیت‌ها تعریف نشده است. در حال حاضر 1 = شدت بالا و 0 = شدت پایین استفاده می‌شود.
.PP
تنظیم گزینه
.B hand\-scanner
منجر به رفتار بک‌اند آزمایشی مانند یک اسکنر دستی می‌شود. اسکنرهای دستی ارتفاع تصویر را از قبل نمی‌دانند. در عوض، ارتفاع \-1 را برمی‌گردانند. تنظیم این گزینه امکان آزمایش اینکه آیا یک فرانت‌اند می‌تواند این وضعیت را به درستی مدیریت کند یا خیر را فراهم می‌سازد. این گزینه همچنین عرض ثابت 11 سانتی‌متر را فعال می‌کند.
.PP
تنظیم گزینه
.B three\-pass
یک اسکنر سه-مرحله‌ای (three-pass) را شبیه‌سازی می‌کند. اسکنرهای رنگی قدیمی‌تر نیاز داشتند تصویر را برای هر رنگ (قرمز/سبز/آبی) یک بار اسکن کنند تا تصویر کامل به دست آید. بنابراین، در این حالت سه فریم مجزا در حالت رنگی ارسال می‌شود.
.PP
گزینه
.B three\-pass\-order
پشتیبانی برای تغییر ترتیب سه فریم را فراهم می‌کند (گزینه three-pass در بالا را ببینید). یک فرانت‌اند باید از تمام ترتیب‌ها پشتیبانی کند.
.PP
گزینه
.B resolution
تفکیک‌پذیری تصویر را بر حسب نقطه بر اینچ (dpi) تنظیم می‌کند.
.PP
.PP
گزینه
.B source
می‌تواند برای شبیه‌سازی تغذیه‌کننده خودکار اسناد (ADF) استفاده شود. پس از 10 اسکن، ADF «خالی» خواهد شد.
.PP

.SH "گزینه‌های ویژه (SPECIAL OPTIONS)"
گزینه
.B test\-picture
امکان تنظیم تصویری که به فرانت‌اند بازگردانده می‌شود را فراهم می‌سازد. در حالی که "Solid white" و "Solid black" کاملاً واضح هستند، سایر گزینه‌ها به توضیحات بیشتری نیاز دارند. الگوهای رنگی برای تعیین اینکه آیا تمام حالت‌ها و رنگ‌های آن‌ها به درستی توسط فرانت‌اند نمایش داده می‌شوند یا خیر استفاده می‌شوند. شبکه (grid) باید در هر حالت و تفکیک‌پذیری یکسان به نظر برسد. جدولی از تمام تصاویر آزمایشی را می‌توان در نشانی زیر یافت:
.IR http://www.meier\-geinitz.de/sane/test\-backend/test\-pictures.html .
.PP
اگر گزینه
.B invert\-endianness
تنظیم شود، بایت‌های بالا و پایین داده‌های تصویر در حالت‌های 16 بیتی جابه‌جا می‌شوند. این گزینه می‌تواند برای آزمایش حالت‌های 16 بیتی فرانت‌اندها استفاده شود، برای مثال برای بررسی اینکه آیا فرانت‌اند از ترتیب بایت (endianness) صحیح استفاده می‌کند یا خیر.
.PP
اگر گزینه
.B read\-limit
تنظیم شود، حداکثر مقدار داده منتقل‌شده با هر فراخوانی
.BR sane_read ()
محدود می‌شود.
.PP
گزینه
.B read\-limit\-size
حد را برای گزینه read-limit تعیین می‌کند. حد پایین اسکن را کند می‌کند. می‌توان از آن برای شناسایی خطاهایی در فرانت‌اند استفاده کرد که به دلیل فرضیات نادرست درباره اندازه بافر یا مشکلات زمان‌بندی رخ می‌دهند.
.PP
گزینه
.B read\-delay
تاخیر در ارسال داده به فرانت‌اند را فعال می‌کند.
.PP
گزینه
.B read\-delay\-duration
تعداد میکروثانیه‌هایی که بک‌اند پس از هر انتقال بافر منتظر می‌ماند را انتخاب می‌کند. این گزینه برای یافتن اشکال‌های مربوط به زمان‌بندی مفید است، به ویژه اگر از طریق شبکه استفاده شود.
.PP
اگر گزینه
.B read\-return\-value
متفاوت از "Default" باشد، وضعیت انتخاب‌شده توسط هر فراخوانی
.BR sane_read ()
بازگردانده خواهد شد. این گزینه برای آزمایش نحوه مدیریت وضعیت‌های SANE توسط فرانت‌اند مفید است.
.PP
اگر گزینه
.B ppl\-loss
متفاوت از 0 باشد، تعداد پیکسل‌هایی که در انتهای هر خط «از دست می‌روند» را تعیین می‌کند. این بدان معناست که خطوط با داده‌های استفاده‌نشده پر (pad) می‌شوند.
.PP
گزینه
.B fuzzy\-parameters
تعیین می‌کند که تا زمانی که اسکن شروع نشده است، پارامترهای مبهم (غیردقیق) بازگردانده شوند. این گزینه می‌تواند برای بررسی اینکه آیا فرانت‌اند از پارامترهایی که قبل از شروع اسکن دریافت کرده استفاده می‌کند یا خیر (که نباید بکند) به کار رود.
.PP
گزینه
.B non\-blocking
تعیین می‌کند که آیا در صورت پشتیبانی فرانت‌اند، ورودی/خروجی مسدودنشدنی برای
.BR sane_read ()
استفاده شود یا خیر.
.PP
اگر گزینه
.B select\-fd
تنظیم شود، بک‌اند یک توصیف‌گر پرونده select را برای تشخیص اینکه آیا
.BR sane_read()
داده برمی‌گرداند یا خیر ارائه می‌دهد.
.PP
اگر گزینه
.B enable\-test\-options
تنظیم شود، فهرست نسبتاً بزرگی از گزینه‌ها برای آزمایش انواع مختلف گزینه‌های SANE فعال می‌شود.
.PP
گزینه
.B print\-options
می‌تواند برای چاپ فهرستی از تمام گزینه‌ها در خروجی خطای استاندارد استفاده شود.
.PP

.SH "گزینه‌های هندسه (GEOMETRY OPTIONS)"
گزینه
.B tl\-x
موقعیت x گوشه بالا-چپ ناحیه اسکن را تعیین می‌کند.
.PP
گزینه
.B tl\-y
موقعیت y گوشه بالا-چپ ناحیه اسکن را تعیین می‌کند.
.PP
گزینه
.B br\-x
موقعیت x گوشه پایین-راست ناحیه اسکن را تعیین می‌کند.
.PP
گزینه
.B br\-y
موقعیت y گوشه پایین-راست ناحیه اسکن را تعیین می‌کند.
.PP

.SH "گزینه‌های آزمون بولی (BOOL TEST OPTIONS)"
در مجموع 6 گزینه آزمون بولی وجود دارد. هر گزینه شماره‌گذاری شده است. (3/6) به این معناست: این گزینه 3 از 6 است. طرح شماره‌گذاری برای شناسایی آسان‌تر گزینه‌هایی است که توسط فرانت‌اند نمایش داده نمی‌شوند (به دلیل عدم پشتیبانی یا اشکال‌ها).
.PP
گزینه
.B bool\-soft\-select\-soft\-detect
(1/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب نرم‌افزاری و تشخیص نرم‌افزاری (و پیشرفته) است. این فقط یک گزینه بولی معمولی است.
.PP
گزینه
.B bool\-hard\-select\-soft\-detect
(2/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب سخت‌افزاری و تشخیص نرم‌افزاری (و پیشرفته) است. این بدان معناست که گزینه نمی‌تواند توسط فرانت‌اند تنظیم شود، بلکه توسط کاربر تنظیم می‌شود (برای مثال با فشردن دکمه‌ای روی دستگاه).
.PP
گزینه
.B bool\-hard\-select
(3/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب سخت‌افزاری (و پیشرفته) است. این بدان معناست که گزینه نمی‌تواند توسط فرانت‌اند تنظیم شود بلکه توسط کاربر تنظیم می‌شود (برای مثال با فشردن دکمه‌ای روی دستگاه) و نمی‌تواند توسط فرانت‌اند خوانده شود.
.PP
گزینه
.B bool\-soft\-detect
(4/6) یک گزینه آزمون بولی است که دارای قابلیت‌های تشخیص نرم‌افزاری (و پیشرفته) است. این بدان معناست که گزینه فقط‌خواندنی است.
.PP
گزینه
.B bool\-soft\-select\-soft\-detect\-emulated
(5/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب نرم‌افزاری، تشخیص نرم‌افزاری و شبیه‌سازی‌شده (و پیشرفته) است.
.PP
گزینه
.B bool\-soft\-select\-soft\-detect\-auto
(6/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب نرم‌افزاری، تشخیص نرم‌افزاری و خودکار (و پیشرفته) است. این گزینه می‌تواند به صورت خودکار توسط بک‌اند تنظیم شود.
.PP

.SH "گزینه‌های آزمون عدد صحیح (INT TEST OPTIONS)"
در مجموع 7 گزینه آزمون عدد صحیح وجود دارد.
.PP
گزینه
.B int
(1/7) یک گزینه آزمون عدد صحیح بدون واحد و بدون محدودیت تنظیم‌شده است.
.PP
گزینه
.B int\-constraint\-range
(2/7) یک گزینه آزمون عدد صحیح با واحد پیکسل و محدوده محدودیت تعیین‌شده است. کمینه 4، بیشینه 192 و گام (quant) برابر 2 است.
.PP
گزینه
.B int\-constraint\-word\-list
(3/7) یک گزینه آزمون عدد صحیح با واحد بیت و فهرست کلمات محدودیت تعیین‌شده است.
.PP
گزینه
.B int\-constraint\-array
(4/7) یک گزینه آزمون عدد صحیح با واحد میلی‌متر و با استفاده از آرایه بدون محدودیت است.
.PP
گزینه
.B int\-constraint\-array\-constraint\-range
(5/7) یک گزینه آزمون عدد صحیح با واحد میلی‌متر و با استفاده از آرایه با محدودیت محدوده است. کمینه 4، بیشینه 192 و گام برابر 2 است.
.PP
گزینه
.B int\-constraint\-array\-constraint\-word\-list
(6/7) یک گزینه آزمون عدد صحیح با واحد درصد و با استفاده از محدودیت آرایه یا فهرست کلمات است.
.PP
گزینه
.B int\-inexact
(7/7) یک گزینه آزمون عدد صحیح است که مقدار درخواستی را افزایش می‌دهد و پرچم SANE_INFO_INEXACT را برمی‌گرداند.


.SH "گزینه‌های آزمون ممیز ثابت (FIXED TEST OPTIONS)"
در مجموع 3 گزینه آزمون ممیز ثابت وجود دارد.
.PP
گزینه
.B fixed
(1/3) یک گزینه آزمون ممیز ثابت بدون واحد و بدون محدودیت تنظیم‌شده است.
.PP
گزینه
.B fixed\-constraint\-range
(2/3) یک گزینه آزمون ممیز ثابت با واحد میکروثانیه و محدوده محدودیت تعیین‌شده است. کمینه \-42.17، بیشینه 32767.9999 و گام برابر 2.0 است.
.PP
گزینه
.B fixed\-constraint\-word\-list
(3/3) یک گزینه آزمون ممیز ثابت بدون واحد و فهرست کلمات محدودیت تعیین‌شده است.
.PP

.SH "گزینه‌های آزمون رشته (STRING TEST OPTIONS)"
در مجموع 3 گزینه آزمون رشته وجود دارد.
.PP
گزینه
.B string
(1/3) یک گزینه آزمون رشته بدون محدودیت است.
.PP
گزینه
.B string\-constraint\-string\-list
(2/3) یک گزینه آزمون رشته با محدودیت فهرست رشته است.
.PP
گزینه
.B string\-constraint\-long\-string\-list
(3/3) یک گزینه آزمون رشته با محدودیت فهرست رشته است. شامل ورودی‌های بیشتری است...
.PP

.SH "گزینه آزمون دکمه (BUTTON TEST OPTION)"
گزینه
.B button
(1/1) یک گزینه آزمون دکمه است. مقداری متن چاپ می‌کند...
.PP

.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/test.conf
پرونده پیکربندی بک‌اند (همچنین به توضیحات
.B SANE_CONFIG_DIR
در زیر مراجعه کنید). مقادیر اولیه بیشتر گزینه‌های پایه‌ای SANE می‌تواند در این پرونده پیکربندی شود. یک الگو حاوی تمام مقادیر پیش‌فرض به همراه این بک‌اند ارائه می‌شود. یکی از مقادیر جالب‌تر ممکن است
.BR number_of_devices
باشد. می‌توان از آن برای بررسی توانایی فرانت‌اند در نمایش فهرست طولانی از دستگاه‌ها استفاده کرد. مقادیر پیکربندی مربوط به تفکیک‌پذیری و هندسه می‌توانند برای آزمایش مدیریت اندازه‌های بزرگ پرونده مفید باشند.

.TP
.I /usr/lib/sane/libsane\-test.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-test.so
کتابخانه مشترک که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).

.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی پرونده پیکربندی باشند. در سیستم‌های *NIX، دایرکتوری‌ها با دونقطه (`:`) و در OS/2 با نقطه\-ویرگول (`;`) جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، پرونده پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری جاری (".") و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های به صراحت مشخص‌شده جستجو می‌شوند. برای مثال، تنظیم
.B SANE_CONFIG_DIR
روی "/tmp/config:" باعث می‌شود دایرکتوری‌های
.IR tmp/config ،
.IR . ،
و
.I "/etc/sane.d"
(به همین ترتیب) جستجو شوند.
.TP
.B SANE_DEBUG_TEST
اگر کتابخانه با پشتیبانی اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. سطوح بالاتر اشکال‌زدایی، پرگویی خروجی را افزایش می‌دهند.

مثال:
export SANE_DEBUG_TEST=4

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR scanimage (1),
.BR xscanimage (1)
.br
.IR http://www.meier\-geinitz.de/sane/test\-backend


.SH "نویسنده (AUTHOR)"
Henning Meier-Geinitz
.RI < henning@meier\-geinitz.de >

.SH "اشکالات (BUGS)"
\- مقادیر پرونده پیکربندی از نظر درستی آزمایش نمی‌شوند