| scanimage(1) | SANE (الوصول إلى الماسحة الضوئية أصبح سهلاً الآن) | 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 باسم الجهاز، اسم البائع، اسم الطراز، نوع الماسح، رقم فهرس وسطر جديد على التوالي. الأمر
سينتج شيئًا مثل:
توفر خيارات --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 عبر سطر أوامر بالشكل:
توثيق الخيارات الخاصة بالجهاز المطبوعة بواسطة --help يُشرح بأفضل صورة عبر بعض الأمثلة:
-l 0..218mm [0]
الوصف أعلاه يُظهر أن الخيار -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
- هذا الملف يحتوي على أسطر بالصيغة
يستخدم 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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.
| 10 يوليو 2008 |