sane-test(5) SANE Scanner Access Now Easy sane-test(5)

sane-test - بک‌اند SANE برای آزمایش فرانت‌اندها

کتابخانه sane-test یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که امکان آزمایش نصب SANE و فرانت‌اندهای SANE را فراهم می‌سازد. این بک‌اند دسترسی به تعداد (تقریباً) نامحدودی از دستگاه‌های مجازی را فراهم می‌کند. هیچ پشتیبانی از اسکنرها یا دوربین‌های واقعی وجود ندارد. با این حال، این بک‌اند اسکن کردن و تنظیم گزینه‌ها را شبیه‌سازی می‌کند.

هدف نه تنها یافتن اشکال‌ها در فرانت‌اندها، بلکه نمایش تمام قابلیت‌های SANE است. بنابراین sane-test توابع و گزینه‌هایی را پیاده‌سازی می‌کند که در سایر بک‌اندها یافت نمی‌شوند (یا به ندرت یافت می‌شوند).

این بک‌اند در /etc/sane.d/dll.conf کامنت شده است، بنابراین یا باید نویسه کامنت برداشته شود یا بک‌اند باید به صراحت فراخوانی شود. مانند scanimage -d test یا xscanimage test.

گزینه mode حالت اسکن (Gray یا Color) را انتخاب می‌کند.

گزینه 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 = شدت پایین استفاده می‌شود.

تنظیم گزینه hand-scanner منجر به رفتار بک‌اند آزمایشی مانند یک اسکنر دستی می‌شود. اسکنرهای دستی ارتفاع تصویر را از قبل نمی‌دانند. در عوض، ارتفاع -1 را برمی‌گردانند. تنظیم این گزینه امکان آزمایش اینکه آیا یک فرانت‌اند می‌تواند این وضعیت را به درستی مدیریت کند یا خیر را فراهم می‌سازد. این گزینه همچنین عرض ثابت 11 سانتی‌متر را فعال می‌کند.

تنظیم گزینه three-pass یک اسکنر سه-مرحله‌ای (three-pass) را شبیه‌سازی می‌کند. اسکنرهای رنگی قدیمی‌تر نیاز داشتند تصویر را برای هر رنگ (قرمز/سبز/آبی) یک بار اسکن کنند تا تصویر کامل به دست آید. بنابراین، در این حالت سه فریم مجزا در حالت رنگی ارسال می‌شود.

گزینه three-pass-order پشتیبانی برای تغییر ترتیب سه فریم را فراهم می‌کند (گزینه three-pass در بالا را ببینید). یک فرانت‌اند باید از تمام ترتیب‌ها پشتیبانی کند.

گزینه resolution تفکیک‌پذیری تصویر را بر حسب نقطه بر اینچ (dpi) تنظیم می‌کند.

گزینه source می‌تواند برای شبیه‌سازی تغذیه‌کننده خودکار اسناد (ADF) استفاده شود. پس از 10 اسکن، ADF «خالی» خواهد شد.

گزینه test-picture امکان تنظیم تصویری که به فرانت‌اند بازگردانده می‌شود را فراهم می‌سازد. در حالی که "Solid white" و "Solid black" کاملاً واضح هستند، سایر گزینه‌ها به توضیحات بیشتری نیاز دارند. الگوهای رنگی برای تعیین اینکه آیا تمام حالت‌ها و رنگ‌های آن‌ها به درستی توسط فرانت‌اند نمایش داده می‌شوند یا خیر استفاده می‌شوند. شبکه (grid) باید در هر حالت و تفکیک‌پذیری یکسان به نظر برسد. جدولی از تمام تصاویر آزمایشی را می‌توان در نشانی زیر یافت: http://www.meier-geinitz.de/sane/test-backend/test-pictures.html.

اگر گزینه invert-endianness تنظیم شود، بایت‌های بالا و پایین داده‌های تصویر در حالت‌های 16 بیتی جابه‌جا می‌شوند. این گزینه می‌تواند برای آزمایش حالت‌های 16 بیتی فرانت‌اندها استفاده شود، برای مثال برای بررسی اینکه آیا فرانت‌اند از ترتیب بایت (endianness) صحیح استفاده می‌کند یا خیر.

اگر گزینه read-limit تنظیم شود، حداکثر مقدار داده منتقل‌شده با هر فراخوانی sane_read() محدود می‌شود.

گزینه read-limit-size حد را برای گزینه read-limit تعیین می‌کند. حد پایین اسکن را کند می‌کند. می‌توان از آن برای شناسایی خطاهایی در فرانت‌اند استفاده کرد که به دلیل فرضیات نادرست درباره اندازه بافر یا مشکلات زمان‌بندی رخ می‌دهند.

گزینه read-delay تاخیر در ارسال داده به فرانت‌اند را فعال می‌کند.

گزینه read-delay-duration تعداد میکروثانیه‌هایی که بک‌اند پس از هر انتقال بافر منتظر می‌ماند را انتخاب می‌کند. این گزینه برای یافتن اشکال‌های مربوط به زمان‌بندی مفید است، به ویژه اگر از طریق شبکه استفاده شود.

اگر گزینه read-return-value متفاوت از "Default" باشد، وضعیت انتخاب‌شده توسط هر فراخوانی sane_read() بازگردانده خواهد شد. این گزینه برای آزمایش نحوه مدیریت وضعیت‌های SANE توسط فرانت‌اند مفید است.

اگر گزینه ppl-loss متفاوت از 0 باشد، تعداد پیکسل‌هایی که در انتهای هر خط «از دست می‌روند» را تعیین می‌کند. این بدان معناست که خطوط با داده‌های استفاده‌نشده پر (pad) می‌شوند.

گزینه fuzzy-parameters تعیین می‌کند که تا زمانی که اسکن شروع نشده است، پارامترهای مبهم (غیردقیق) بازگردانده شوند. این گزینه می‌تواند برای بررسی اینکه آیا فرانت‌اند از پارامترهایی که قبل از شروع اسکن دریافت کرده استفاده می‌کند یا خیر (که نباید بکند) به کار رود.

گزینه non-blocking تعیین می‌کند که آیا در صورت پشتیبانی فرانت‌اند، ورودی/خروجی مسدودنشدنی برای sane_read() استفاده شود یا خیر.

اگر گزینه select-fd تنظیم شود، بک‌اند یک توصیف‌گر پرونده select را برای تشخیص اینکه آیا sane_read() داده برمی‌گرداند یا خیر ارائه می‌دهد.

اگر گزینه enable-test-options تنظیم شود، فهرست نسبتاً بزرگی از گزینه‌ها برای آزمایش انواع مختلف گزینه‌های SANE فعال می‌شود.

گزینه print-options می‌تواند برای چاپ فهرستی از تمام گزینه‌ها در خروجی خطای استاندارد استفاده شود.

گزینه tl-x موقعیت x گوشه بالا-چپ ناحیه اسکن را تعیین می‌کند.

گزینه tl-y موقعیت y گوشه بالا-چپ ناحیه اسکن را تعیین می‌کند.

گزینه br-x موقعیت x گوشه پایین-راست ناحیه اسکن را تعیین می‌کند.

گزینه br-y موقعیت y گوشه پایین-راست ناحیه اسکن را تعیین می‌کند.

در مجموع 6 گزینه آزمون بولی وجود دارد. هر گزینه شماره‌گذاری شده است. (3/6) به این معناست: این گزینه 3 از 6 است. طرح شماره‌گذاری برای شناسایی آسان‌تر گزینه‌هایی است که توسط فرانت‌اند نمایش داده نمی‌شوند (به دلیل عدم پشتیبانی یا اشکال‌ها).

گزینه bool-soft-select-soft-detect (1/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب نرم‌افزاری و تشخیص نرم‌افزاری (و پیشرفته) است. این فقط یک گزینه بولی معمولی است.

گزینه bool-hard-select-soft-detect (2/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب سخت‌افزاری و تشخیص نرم‌افزاری (و پیشرفته) است. این بدان معناست که گزینه نمی‌تواند توسط فرانت‌اند تنظیم شود، بلکه توسط کاربر تنظیم می‌شود (برای مثال با فشردن دکمه‌ای روی دستگاه).

گزینه bool-hard-select (3/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب سخت‌افزاری (و پیشرفته) است. این بدان معناست که گزینه نمی‌تواند توسط فرانت‌اند تنظیم شود بلکه توسط کاربر تنظیم می‌شود (برای مثال با فشردن دکمه‌ای روی دستگاه) و نمی‌تواند توسط فرانت‌اند خوانده شود.

گزینه bool-soft-detect (4/6) یک گزینه آزمون بولی است که دارای قابلیت‌های تشخیص نرم‌افزاری (و پیشرفته) است. این بدان معناست که گزینه فقط‌خواندنی است.

گزینه bool-soft-select-soft-detect-emulated (5/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب نرم‌افزاری، تشخیص نرم‌افزاری و شبیه‌سازی‌شده (و پیشرفته) است.

گزینه bool-soft-select-soft-detect-auto (6/6) یک گزینه آزمون بولی است که دارای قابلیت‌های انتخاب نرم‌افزاری، تشخیص نرم‌افزاری و خودکار (و پیشرفته) است. این گزینه می‌تواند به صورت خودکار توسط بک‌اند تنظیم شود.

در مجموع 7 گزینه آزمون عدد صحیح وجود دارد.

گزینه int (1/7) یک گزینه آزمون عدد صحیح بدون واحد و بدون محدودیت تنظیم‌شده است.

گزینه int-constraint-range (2/7) یک گزینه آزمون عدد صحیح با واحد پیکسل و محدوده محدودیت تعیین‌شده است. کمینه 4، بیشینه 192 و گام (quant) برابر 2 است.

گزینه int-constraint-word-list (3/7) یک گزینه آزمون عدد صحیح با واحد بیت و فهرست کلمات محدودیت تعیین‌شده است.

گزینه int-constraint-array (4/7) یک گزینه آزمون عدد صحیح با واحد میلی‌متر و با استفاده از آرایه بدون محدودیت است.

گزینه int-constraint-array-constraint-range (5/7) یک گزینه آزمون عدد صحیح با واحد میلی‌متر و با استفاده از آرایه با محدودیت محدوده است. کمینه 4، بیشینه 192 و گام برابر 2 است.

گزینه int-constraint-array-constraint-word-list (6/7) یک گزینه آزمون عدد صحیح با واحد درصد و با استفاده از محدودیت آرایه یا فهرست کلمات است.

گزینه int-inexact (7/7) یک گزینه آزمون عدد صحیح است که مقدار درخواستی را افزایش می‌دهد و پرچم SANE_INFO_INEXACT را برمی‌گرداند.

در مجموع 3 گزینه آزمون ممیز ثابت وجود دارد.

گزینه fixed (1/3) یک گزینه آزمون ممیز ثابت بدون واحد و بدون محدودیت تنظیم‌شده است.

گزینه fixed-constraint-range (2/3) یک گزینه آزمون ممیز ثابت با واحد میکروثانیه و محدوده محدودیت تعیین‌شده است. کمینه -42.17، بیشینه 32767.9999 و گام برابر 2.0 است.

گزینه fixed-constraint-word-list (3/3) یک گزینه آزمون ممیز ثابت بدون واحد و فهرست کلمات محدودیت تعیین‌شده است.

در مجموع 3 گزینه آزمون رشته وجود دارد.

گزینه string (1/3) یک گزینه آزمون رشته بدون محدودیت است.

گزینه string-constraint-string-list (2/3) یک گزینه آزمون رشته با محدودیت فهرست رشته است.

گزینه string-constraint-long-string-list (3/3) یک گزینه آزمون رشته با محدودیت فهرست رشته است. شامل ورودی‌های بیشتری است...

گزینه button (1/1) یک گزینه آزمون دکمه است. مقداری متن چاپ می‌کند...

/etc/sane.d/test.conf
پرونده پیکربندی بک‌اند (همچنین به توضیحات SANE_CONFIG_DIR در زیر مراجعه کنید). مقادیر اولیه بیشتر گزینه‌های پایه‌ای SANE می‌تواند در این پرونده پیکربندی شود. یک الگو حاوی تمام مقادیر پیش‌فرض به همراه این بک‌اند ارائه می‌شود. یکی از مقادیر جالب‌تر ممکن است number_of_devices باشد. می‌توان از آن برای بررسی توانایی فرانت‌اند در نمایش فهرست طولانی از دستگاه‌ها استفاده کرد. مقادیر پیکربندی مربوط به تفکیک‌پذیری و هندسه می‌توانند برای آزمایش مدیریت اندازه‌های بزرگ پرونده مفید باشند.
/usr/lib/sane/libsane-test.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-test.so
کتابخانه مشترک که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).

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

مثال: export SANE_DEBUG_TEST=4

sane(7), scanimage(1), xscanimage(1)
http://www.meier-geinitz.de/sane/test-backend

Henning Meier-Geinitz <henning@meier-geinitz.de>

- مقادیر پرونده پیکربندی از نظر درستی آزمایش نمی‌شوند

14 Jul 2008