scanimage(1)

الاسم
scanimage - مسح صورة

موجز
scanimage [-d dev] [--format=output-format] [-i profile] [-L] [-f device-format] [-b [format]] [--batch-start=start] [--batch-count=count] [--batch-increment=increment] [--batch-double] [--accept-md5-only] [-p] [-o path] [-n] [-T] [-A] [-h] [-v] [-B size] [-V] [device-specific-options]

الوصف
scanimage هي واجهة سطر أوامر للتحكم بأجهزة التقاط الصور مثل الماسحات الضوئية المسطحة أو الكاميرات. يتحكم بالجهاز عبر خيارات سطر الأوامر. بعد معالجة سطر الأوامر، يشرع scanimage عادةً في التقاط صورة. تُكتب بيانات الصورة إلى المخرج المعياري بأحد تنسيقات PNM (PBM للصور أبيض-أسود، PGM للصور تدرج رمادي، وPPM للصور ملونة)، أو تنسيق TIFF (أبيض-أسود، تدرج رمادي أو ملون)، أو تنسيق PNG، أو تنسيق JPEG (مستوى ضغط 75). يصل scanimage إلى أجهزة التقاط الصور عبر واجهة SANE (Scanner Access Now Easy) وبالتالي يمكنه دعم أي جهاز يوجد له خلفية SANE (جرب apropos sane- للحصول على قائمة بالخلفيات المتاحة).

أمثلة
للحصول على قائمة بالأجهزة:

  scanimage -L

للمسح بالإعدادات المبدئية إلى الملف image.pnm:

  scanimage >image.pnm

لمسح 100x100 مم إلى الملف image.tiff (-x و -y قد لا يكونان متاحين مع جميع الأجهزة):

  scanimage -x 100 -y 100 --format=tiff >image.tiff

لطباعة جميع الخيارات المتاحة:

  scanimage -h

الخيارات
توجد مجموعتان من الخيارات المتاحة عند تشغيل scanimage.

الخيارات التي يوفرها scanimage نفسه مُدرجة أدناه. بالإضافة إلى ذلك، تقدم كل خلفية مجموعتها الخاصة من الخيارات ويمكن أيضًا تحديدها. لاحظ أن الخيارات المتاحة من الخلفية قد تختلف اعتمادًا على جهاز المسح المحدد.

غالبًا ما تُنفذ الخيارات المتشابهة في الوظيفة بشكل مختلف عبر الخلفيات. مثال على هذا الاختلاف هو --mode Gray و --mode Grayscale. قد يكون هذا بسبب تفضيلات مؤلفي الخلفيات المختلفة. في أحيان أخرى، تُعرف الخيارات بواسطة جهاز المسح نفسه وبالتالي تكون خارج سيطرة كود الخلفية.

تُفصل المعاملات بفراغ عن خيارات الحرف الواحد (مثل -d epson) وبعلامة "=" عن خيارات متعددة الأحرف (مثل --device-name=epson).

-d dev, --device-name=dev
    يحدد الجهاز المراد الوصول إليه ويجب أن يتبعه اسم جهاز SANE مثل `epson:/dev/sg0' أو `hp:/dev/usbscanner0'. يمكن الحصول على قائمة (جزئية) بالأجهزة المتاحة باستخدام الخيار --list-devices (انظر أدناه). إذا لم يُحدد اسم جهاز صراحة، يقرأ scanimage اسم جهاز من المتغير البيئي SANE_DEFAULT_DEVICE. إذا لم يُعيّن هذا المتغير، سيحاول scanimage فتح أول جهاز متاح.

--format=output-format
    يختار كيفية كتابة بيانات الصورة إلى المخرج المعياري أو الملف المحدد بواسطة الخيار --output-file. يمكن أن يكون output-format pnm أو tiff أو png أو jpeg. إذا لم يُحدد --format، يُكتب PNM بشكل مبدئي.

-i profile, --icc-profile=profile
    يُستخدم لتضمين تشكيلة ICC في ملف TIFF.

-L, --list-devices
    يطلب قائمة (جزئية) بالأجهزة المتاحة. قد لا تكون القائمة كاملة لأن بعض الأجهزة قد تكون متاحة ولكنها غير مدرجة في أي من ملفات الإعداد (المخزنة عادةً في الدليل /etc/sane.d). هذا هو الحال بشكل خاص عند الوصول إلى الماسحات الضوئية عبر الشبكة. إذا لم يُدرج جهاز في ملف إعداد، فإن الطريقة الوحيدة للوصول إليه هي باسم جهازه الكامل. قد تحتاج إلى استشارة مسؤول النظام لمعرفة أسماء هذه الأجهزة.

-f format, --formatted-device-list=device-format
    يعمل بشكل مشابه لـ --list-devices، لكنه يتطلب سلسلة تنسيق. يستبدل scanimage العناصر النائبة %d %v %m %t %i %n باسم الجهاز، اسم البائع، اسم الطراز، نوع الماسح، رقم فهرس وسطر جديد على التوالي. الأمر

    scanimage -f “ scanner number %i device %d is a %t, model %m, produced by %v ”

    سينتج شيئًا مثل:

        scanner number 0 device sharp:/dev/sg1 is a flatbed scanner, model JX250 SCSI, produced by SHARP

توفر خيارات --batch* ميزات لمسح المستندات باستخدام مغذيات المستندات.

    -b [format], --batch=[format]
        يُستخدم لتحديد تنسيق اسم الملف الذي ستُكتب إليه كل صفحة. تُكتب كل صفحة في ملف واحد. إذا لم يُحدد format، يُستخدم المبدئي out%d.pnm (أو out%d.tif لـ --format tiff، أو out%d.png لـ --format png، أو out%d.jpg لـ --format jpeg). هذا الخيار غير متوافق مع خيار --output-path. يُعطى format كسلسلة نمط printf بمعامل صحيح واحد.

    --batch-start=start
        يختار رقم الصفحة لبدء تسمية الملفات بها. إذا لم يُعط هذا الخيار، يبدأ العداد من 1.

    --batch-count=count
        يحدد عدد الصفحات لمحاولة مسحها ضوئيًا. إذا لم يُعط، يواصل scanimage المسح حتى يُرجع الماسح حالة غير OK. لا تشير جميع الماسحات ذات مغذيات المستندات عند فراغ ADF. استخدم هذا الخيار للتعامل معها.

    --batch-increment=increment
        يضبط المقدار الذي يُزاد به الرقم في اسم الملف. يُستخدم هذا عمومًا عند مسح مستندات مزدوجة الوجه على مغذي مستندات أحادي الوجه. --batch-double هو أمر محدد يُقدم للمساعدة في ذلك.

    --batch-double
        يضبط الزيادة آليًا إلى 2. مكافئ لـ --batch-increment=2.

    --batch-prompt
        يطلب الضغط على RETURN قبل مسح صفحة. يمكن استخدام هذا لمسح صفحات متعددة دون مغذي مستندات آلي.

--accept-md5-only
    يقبل فقط طلبات استيثاق المستخدم التي تدعم أمان MD5. خادم شبكة SANE saned(8) قادر على تنفيذ هذه الطلبات.

-p, --progress
    يطلب من scanimage طباعة عداد تقدم. يُظهر مقدار بيانات الصورة الحالية التي استُلمت بالفعل (بالنسبة المئوية).

-o path, --output-file=path
    يطلب من scanimage حفظ مخرجات المسح إلى path المُعطى. هذا الخيار غير متوافق مع خيار --batch. يحاول البرنامج تخمين --format من اسم الملف. إذا لم يكن ذلك ممكنًا، يطبع رسالة خطأ ويخرج.

-n, --dont-scan
    يطلب من scanimage ضبط الخيارات التي قدمها المستخدم فقط دون إجراء مسح فعلي. يمكن استخدام هذا الخيار مثلًا لإطفاء مصباح الماسح (إذا كان مدعومًا من الخلفية).

-T, --test
    يطلب من scanimage إجراء بعض اختبارات الصلاحية البسيطة للتأكد من عمل الخلفية كما هو محدد بواسطة واجهة برمجة تطبيقات SANE. على وجه الخصوص، تُختبر دالة sane_read() بهذا الاختبار.

-A, --all-options
    يطلب من scanimage سرد جميع الخيارات المتاحة التي تعرضها الخلفية، بما في ذلك خيارات الأزرار. تُطبع المعلومات على المخرجات القياسية ولا يُجرى أي مسح.

-h، --help
    يطلب معلومات المساعدة. تُطبع المعلومات على المخرجات القياسية ولا يُجرى أي مسح.

-v، --verbose
    يزيد تفصيل مخرجات scanimage. يمكن تحديد الخيار مرارًا، مع زيادة مستوى التفصيل في كل مرة.

-B [size], --buffer-size=size
    يغير حجم مخزن الإدخال المؤقت من المبدئي 1MB إلى size كيلوبايت.

-V، --version
    يطلب من scanimage طباعة اسم البرنامج والحزمة، رقم إصدار توزيعة SANE التي جاء معها، وإصدار الخلفية التي يحملها. إذا كانت هناك حاجة لمزيد من المعلومات حول أرقام إصدارات الخلفيات، يمكن استخدام متغير DEBUG لطبقة dll. مثال: SANE_DEBUG_DLL=3 scanimage -L.

كما قد تتخيل، يأتي الكثير من قوة scanimage من حقيقة أنه يمكنه التحكم في أي خلفية SANE. وبالتالي، تعتمد مجموعة خيارات سطر الأوامر الدقيقة على قدرات الجهاز المحدد. لعرض الخيارات لجهاز باسم dev، استدعِ scanimage عبر سطر أوامر بالشكل:

    scanimage --help --device-name dev

توثيق الخيارات الخاصة بالجهاز المطبوعة بواسطة --help يُشرح بأفضل صورة عبر بعض الأمثلة:

-l 0..218mm [0]
    موضع x العلوي الأيسر لمنطقة المسح الضوئي.

    الوصف أعلاه يُظهر أن الخيار -l يتوقع قيمة خيار في النطاق من 0 إلى 218 مم. القيمة بين قوسين مربعين تشير إلى أن قيمة الخيار الحالية هي 0 مم. معظم الخلفيات توفر خيارات هندسية مشابهة للموضع العلوي الأيسر y (-t)، العرض (-x) وارتفاع منطقة المسح (-y).

--brightness -100..100% [0]
    يتحكم في سطوع الصورة الملتقطة.

    الوصف أعلاه يُظهر أن الخيار --brightness يتوقع قيمة خيار في النطاق من -100 إلى 100 بالمئة. القيمة بين قوسين مربعين تشير إلى أن قيمة الخيار الحالية هي 0 بالمئة.

--default-enhancements
    يضبط القيم المبدئية لعناصر تحكم التحسين.

    الوصف أعلاه يُظهر أن الخيار --default-enhancements ليس له قيمة خيار. يجب اعتباره ذا تأثير فوري عند نقطة سطر الأوامر التي يظهر فيها. على سبيل المثال، بما أن هذا الخيار يعيد ضبط الخيار --brightness، فإن زوج الخيارات --brightness 50 --default-enhancements سيكون بلا تأثير فعليًا.

--mode Lineart|Gray|Color [Gray]
    يختار وضع المسح (مثل، خطي أو لوني).

    الوصف أعلاه يُظهر أن الخيار --mode يقبل وسيطًا يجب أن يكون أحد السلاسل Lineart أو Gray أو Color. القيمة بين القوسين المربعين تشير إلى أن الخيار مضبوط حاليًا على Gray. للراحة، من القانوني اختصار قيم السلاسل طالما بقيت فريدة. أيضًا، حالة الأحرف لا تهم. على سبيل المثال، إعداد الخيار --mode col مطابق لـ --mode Color.

--custom-gamma[=(yes|no)] [inactive]
    يحدد ما إذا كان يجب استخدام جدول غاما مدمج أم مخصص.

    الوصف أعلاه يُظهر أن الخيار --custom-gamma يتوقع إما عدم وجود قيمة خيار، أو سلسلة "yes"، أو سلسلة "no". تحديد الخيار بدون قيمة يعادل تحديد "yes". القيمة بين قوسين مربعين تشير إلى أن الخيار غير نشط حاليًا. أي أن محاولة ضبط الخيار ستؤدي إلى رسالة خطأ. مجموعة الخيارات المتاحة تعتمد عادةً على إعدادات الخيارات الأخرى. على سبيل المثال، قد يكون جدول --custom-gamma نشطًا فقط عند طلب وضع مسح تدرج رمادي أو لوني.

    لاحظ أن الخيار --help يُعالج فقط بعد معالجة جميع الخيارات الأخرى. هذا يجعل من الممكن رؤية إعدادات الخيارات لوضع معين بتحديد خيارات الوضع المناسبة مع الخيار --help. على سبيل المثال، سطر الأوامر:

    scanimage --help --mode color

    سيطبع إعدادات الخيارات السارية عند اختيار الوضع اللوني.

--gamma-table 0..255,...
    جدول تصحيح غاما. في الوضع اللوني، يؤثر هذا الخيار بالتساوي على القنوات الحمراء والخضراء والزرقاء في وقت واحد (أي أنه جدول غاما للشدة).

    الوصف أعلاه يُظهر أن الخيار --gamma-table يتوقع صفرًا أو أكثر من القيم في النطاق 0 إلى 255. على سبيل المثال، قيمة قانونية لهذا الخيار ستكون "3,4,5,6,7,8,9,10,11,12". نظرًا لأن تحديد متجهات طويلة بهذه الصيغة مرهق، يمكن التعبير عن نفس الشيء بالصيغة المختصرة "[0]3-[9]12". ما يعنيه هذا هو أن العنصر الأول من المتجه مضبوط على 3، والعنصر التاسع مضبوط على 12، والقيم بينهما تُدرج خطيًا. بالطبع، من الممكن تحديد عدة مقاطع خطية من هذا القبيل. على سبيل المثال، "[0]3-[2]3-[6]7,[7]10-[9]6" يعادل "3,3,3,4,5,6,7,10,8,6". يمكن استخدام البرنامج gamma4scanimage لتوليد جداول غاما هذه (انظر gamma4scanimage(1) للتفاصيل).

--filename <string> [/tmp/input.ppm]
    اسم ملف الصورة المراد تحميلها.

    الوصف أعلاه هو مثال لخيار يأخذ قيمة سلسلة عشوائية (وهي اسم ملف). مرة أخرى، القيمة بين القوسين تُظهر أن الخيار مضبوط حاليًا على اسم الملف /tmp/input.ppm.

البيئة

SANE_DEFAULT_DEVICE
    اسم الجهاز المبدئي.

الملفات

/etc/sane.d
    هذا الدليل يحتوي على ملفات تهيئة متنوعة. للتفاصيل، يُرجى الرجوع إلى صفحات الدليل المدرجة أدناه.

~/.sane/pass
    هذا الملف يحتوي على أسطر بالصيغة

    user:password:resource

    يستخدم scanimage هذه المعلومات للإجابة على طلبات استيثاق المستخدم آليًا. يجب أن يكون للملف أذونات 0600 أو أكثر تشددًا. يجب استخدام هذا الملف بالتزامن مع الخيار --accept-md5-only لتجنب هجمات جانب الخادم. قد يحتوي المورد على أي حرف ولكنه محدود بـ 127 حرفًا.

انظر أيضًا
sane(7), gamma4scanimage(1), xscanimage(1), xcam(1), xsane(1), scanadf(1), sane-dll(5), sane-net(5), sane-"backendname"(5)

المؤلف
David Mosberger، Andreas Beck، Gordon Matzigkeit، Caskey Dickson، وآخرون كثيرون. للأسئلة والتعليقات، اتصل بالقائمة البريدية sane-devel (انظر http://www.sane-project.org/mailing-lists.html).

العلل
بالنسبة لخيارات المتجه، لا يحتوي مخرج المساعدة حاليًا على أي إشارة إلى عدد العناصر التي يجب أن تحتويها قيمة المتجه.

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

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

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