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 يختار وضع المسح (رمادي أو ملون).

الخيار depth يحدد عدد البتات لكل عينة (1، 8، أو 16). ضع في اعتبارك أن هذه القيمة تشير إلى العينة، وليس البكسل. لذا depth=16 ينتج 48 بت لكل بكسل في الوضع الملون. التركيبات الأكثر شيوعاً هي mode=Gray، depth=1 للخطوط، mode=Gray، depth=8 للرمادي و mode=Color، depth=8 للوضع الملون. تركيبة اللون ووضع 1 بت غامضة جداً (8 ألوان) لكنها مسموحة في معيار SANE. لكن معنى البتات غير محدد. حالياً يُستخدم 1 = كثافة عالية و 0 = كثافة منخفضة.

ضبط الخيار hand-scanner يؤدي إلى تصرف خلفية الاختبار مثل ماسح يدوي. الماسحات اليدوية لا تعرف ارتفاع الصورة مسبقاً. بدلاً من ذلك، تُرجع ارتفاعاً بقيمة -1. ضبط هذا الخيار يسمح باختبار ما إذا كانت الواجهة الأمامية تستطيع التعامل مع هذا بشكل صحيح. هذا الخيار أيضًا يفعل عرضاً ثابتاً قدره 11 سم.

ضبط الخيار three-pass يحاكي ماسحاً ثلاثي المسح. الماسحات الملونة القديمة كانت تحتاج مسح الصورة مرة لكل لون (أحمر/أخضر/أزرق) للحصول على الصورة الكاملة. لذلك، في هذا الوضع تُنقل ثلاث إطارات منفردة في الوضع الملون.

الخيار three-pass-order يوفر دعماً لتغيير ترتيب الإطارات الثلاثة (انظر الخيار three-pass أعلاه). يجب أن تدعم الواجهة الأمامية جميع الترتيبات.

الخيار resolution يضبط دقة الصورة بالنقاط في البوصة.

الخيار source يمكن استخدامه لمحاكاة مغذي مستندات آلي (ADF). بعد 10 مسحات، سيكون ADF "فارغاً".

خيارات خاصة
الخيار test-picture يسمح بضبط الصورة التي تُعاد إلى الواجهة الأمامية. بينما "أبيض صلب" و"أسود صلب" واضحان تماماً، الخيارات الأخرى تحتاج إلى مزيد من الشرح. تُستخدم الأنماط اللونية لتحديد ما إذا كانت جميع الأوضاع وألوانها ممثلة بشكل صحيح بواسطة الواجهة الأمامية. يجب أن تبدو الشبكة متشابهة في كل وضع ودقة. جدول بجميع صور الاختبار موجود في: http://www.meier-geinitz.de/sane/test-backend/test-pictures.html.

إذا ضُبط الخيار invert-endianness، يتم تبادل البايتات العليا والدنيا لبيانات الصورة في أوضاع 16 بت. يمكن استخدام هذا الخيار لاختبار أوضاع 16 بت للواجهات الأمامية، مثلاً إذا كانت الواجهة الأمامية تستخدم الترتيب الصحيح للبايتات.

إذا ضُبط الخيار read-limit، يتم تحديد الحد الأقصى لكمية البيانات المنقولة مع كل استدعاء لـ sane_read().

الخيار read-limit-size يضبط الحد للخيار read-limit. حد منخفض يبطئ المسح. يمكن استخدامه لاكتشاف أخطاء في الواجهة الأمامية تحدث بسبب افتراضات خاطئة حول حجم المخزن المؤقت أو مشاكل التوقيت.

الخيار read-delay يفعل تأخير البيانات إلى الواجهة الأمامية.

الخيار read-delay-duration يختار عدد الميكروثواني التي تنتظرها الخلفية بعد كل نقل لمخزن مؤقت. هذا الخيار مفيد لإيجاد الأخطاء المتعلقة بالتوقيت، خاصة إذا استُخدم عبر الشبكة.

إذا كان الخيار read-return-value مختلفًا عن "Default"، فسيتم إرجاع الحالة المحددة بواسطة كل استدعاء لـ sane_read(). هذا مفيد لاختبار معالجة الواجهة الأمامية لحالات SANE.

إذا كان الخيار ppl-loss مختلفًا عن 0، فإنه يحدد عدد البكسلات التي "تُفقد" في نهاية كل سطر. هذا يعني أن الأسطر تُحشى ببيانات غير مستخدمة.

يحدد الخيار 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، والكمية 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/x86_64-linux-gnu/sane/libsane-test.a
    المكتبة الساكنة التي تنفذ هذا الخلفي.

/usr/lib/x86_64-linux-gnu/sane/libsane-test.so
    المكتبة المشتركة التي تنفذ هذا الخلفي (موجودة في الأنظمة التي تدعم التحميل الديناميكي).

البيئة

SANE_CONFIG_DIR
    يحدد متغير البيئة هذا قائمة الأدلة التي قد تحتوي على ملف الضبط. في أنظمة *NIX، تُفصل الأدلة بنقطتين رأسيين (`:')، وفي نظام OS/2، تُفصل بفاصلة منقوطة (`;'). إذا لم يُضبط هذا المتغير، فسيُبحث عن ملف الضبط في دليلين مبدئيين: أولاً، دليل العمل الحالي (".") ثم في /etc/sane.d. إذا انتهت قيمة متغير البيئة بمحرف فاصل الأدلة، فسيُبحث في الأدلة المبدئية بعد الأدلة المحددة صراحة. على سبيل المثال، ضبط SANE_CONFIG_DIR إلى "/tmp/config:" سيؤدي إلى البحث في الأدلة tmp/config، و .، و /etc/sane.d (بهذا الترتيب).

SANE_DEBUG_TEST
    إذا صُرّفت المكتبة مع تفعيل دعم التنقيح، فإن متغير البيئة هذا يتحكم في مستوى التنقيح لهذا الخلفي. تزيد مستويات التنقيح الأعلى من إسهاب المخرجات.

    مثال: 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>

العلل
- لا يتم اختبار قيم ملف التهيئة للتأكد من صحتها

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.