.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH scanimage 1 "10 يوليو 2008" "" "SANE (الوصول إلى الماسحة الضوئية أصبح سهلاً الآن)" .IX scanimage .SH الاسم scanimage \- مسح صورة .SH موجز \fBscanimage\fP [\fB\-d\fP \fIdev\fP] [\fB\-\-format\fP\fI=output\-format\fP] [\fB\-i\fP \fIprofile\fP] [\fB\-L\fP] [\fB\-f\fP \fIdevice\-format\fP] [\fB\-b\fP [\fIformat\fP]] [\fB\-\-batch\-start\fP\fI=start\fP] [\fB\-\-batch\-count\fP\fI=count\fP] [\fB\-\-batch\-increment\fP\fI=increment\fP] [\fB\-\-batch\-double\fP] [\fB\-\-accept\-md5\-only\fP] [\fB\-p]\fP [\fB\-o\fP \fIpath\fP] [\fB\-n\fP] [\fB\-T\fP] [\fB\-A\fP] [\fB\-h\fP] [\fB\-v\fP] [\fB\-B\fP size\fI]\fP [\fB\-V\fP] [\fIdevice\-specific\-options\fP] .SH الوصف \fBscanimage\fP هي واجهة سطر أوامر للتحكم بأجهزة التقاط الصور مثل الماسحات الضوئية المسطحة أو الكاميرات. يتحكم بالجهاز عبر خيارات سطر الأوامر. بعد معالجة سطر الأوامر، يشرع \fBscanimage\fP عادةً في التقاط صورة. تُكتب بيانات الصورة إلى المخرج المعياري بأحد تنسيقات PNM (PBM للصور أبيض\-أسود، PGM للصور تدرج رمادي، وPPM للصور ملونة)، أو تنسيق TIFF (أبيض\-أسود، تدرج رمادي أو ملون)، أو تنسيق PNG، أو تنسيق JPEG (مستوى ضغط 75). يصل \fBscanimage\fP إلى أجهزة التقاط الصور عبر واجهة \fBSANE\fP (Scanner Access Now Easy) وبالتالي يمكنه دعم أي جهاز يوجد له خلفية \fBSANE\fP (جرب \fBapropos\fP \fIsane\-\fP للحصول على قائمة بالخلفيات المتاحة). .SH أمثلة للحصول على قائمة بالأجهزة: scanimage \-L للمسح بالإعدادات المبدئية إلى الملف image.pnm: scanimage >image.pnm لمسح 100x100 مم إلى الملف image.tiff (\-x و \-y قد لا يكونان متاحين مع جميع الأجهزة): scanimage \-x 100 \-y 100 \-\-format=tiff >image.tiff لطباعة جميع الخيارات المتاحة: scanimage \-h .SH الخيارات توجد مجموعتان من الخيارات المتاحة عند تشغيل \fBscanimage\fP. .PP الخيارات التي يوفرها \fBscanimage\fP نفسه مُدرجة أدناه. بالإضافة إلى ذلك، تقدم كل خلفية مجموعتها الخاصة من الخيارات ويمكن أيضًا تحديدها. لاحظ أن الخيارات المتاحة من الخلفية قد تختلف اعتمادًا على جهاز المسح المحدد. .PP غالبًا ما تُنفذ الخيارات المتشابهة في الوظيفة بشكل مختلف عبر الخلفيات. مثال على هذا الاختلاف هو \fI\-\-mode Gray\fP و \fI\-\-mode Grayscale\fP. قد يكون هذا بسبب تفضيلات مؤلفي الخلفيات المختلفة. في أحيان أخرى، تُعرف الخيارات بواسطة جهاز المسح نفسه وبالتالي تكون خارج سيطرة كود الخلفية. .PP تُفصل المعاملات بفراغ عن خيارات الحرف الواحد (مثل \fB\-d \fP\fIepson\fP) وبعلامة "=" عن خيارات متعددة الأحرف (مثل \fB\-\-device\-name\fP=\fIepson\fP). .TP \fB\-d\fP\fI dev\fP, \fB\-\-device\-name\fP=\fIdev\fP يحدد الجهاز المراد الوصول إليه ويجب أن يتبعه اسم جهاز SANE مثل `\fIepson:/dev/sg0\fP' أو `\fIhp:/dev/usbscanner0\fP'. يمكن الحصول على قائمة (جزئية) بالأجهزة المتاحة باستخدام الخيار \fB\-\-list\-devices\fP (انظر أدناه). إذا لم يُحدد اسم جهاز صراحة، يقرأ \fBscanimage\fP اسم جهاز من المتغير البيئي \fBSANE_DEFAULT_DEVICE\fP. إذا لم يُعيّن هذا المتغير، سيحاول \fBscanimage\fP فتح أول جهاز متاح. .TP \fB\-\-format\fP=\fIoutput\-format\fP يختار كيفية كتابة بيانات الصورة إلى المخرج المعياري أو الملف المحدد بواسطة الخيار \fB\-\-output\-file\fP. يمكن أن يكون \fIoutput\-format\fP \fBpnm\fP أو \fBtiff\fP أو \fBpng\fP أو \fBjpeg\fP. إذا لم يُحدد \fB\-\-format\fP، يُكتب PNM بشكل مبدئي. .TP \fB\-i\fP\fI profile\fP, \fB\-\-icc\-profile\fP=\fIprofile\fP يُستخدم لتضمين تشكيلة ICC في ملف TIFF. .TP \fB\-L\fP, \fB\-\-list\-devices\fP يطلب قائمة (جزئية) بالأجهزة المتاحة. قد لا تكون القائمة كاملة لأن بعض الأجهزة قد تكون متاحة ولكنها غير مدرجة في أي من ملفات الإعداد (المخزنة عادةً في الدليل \fI/etc/sane.d\fP). هذا هو الحال بشكل خاص عند الوصول إلى الماسحات الضوئية عبر الشبكة. إذا لم يُدرج جهاز في ملف إعداد، فإن الطريقة الوحيدة للوصول إليه هي باسم جهازه الكامل. قد تحتاج إلى استشارة مسؤول النظام لمعرفة أسماء هذه الأجهزة. .TP \fB\-f\fP\fI format\fP, \fB\-\-formatted\-device\-list\fP=\fIdevice\-format\fP يعمل بشكل مشابه لـ \fB\-\-list\-devices\fP، لكنه يتطلب سلسلة تنسيق. يستبدل \fBscanimage\fP العناصر النائبة \fB%d %v %m %t %i %n\fP باسم الجهاز، اسم البائع، اسم الطراز، نوع الماسح، رقم فهرس وسطر جديد على التوالي. الأمر .LP .RS \fBscanimage \-f\fP \fI\*(lq scanner number %i device %d is a %t, model %m, produced by %v \*(rq\fP .LP سينتج شيئًا مثل: .PP .RS scanner number 0 device sharp:/dev/sg1 is a flatbed scanner, model JX250 SCSI, produced by SHARP .RE .RE .PP توفر خيارات \fB\-\-batch*\fP ميزات لمسح المستندات باستخدام مغذيات المستندات. .RS .TP \fB\-b\fP [\fIformat\fP], \fB\-\-batch\fP=[\fIformat\fP] يُستخدم لتحديد تنسيق اسم الملف الذي ستُكتب إليه كل صفحة. تُكتب كل صفحة في ملف واحد. إذا لم يُحدد \fIformat\fP، يُستخدم المبدئي \fIout%d.pnm\fP (أو \fIout%d.tif\fP لـ \fB\-\-format tiff\fP، أو \fIout%d.png\fP لـ \fB\-\-format png\fP، أو \fIout%d.jpg\fP لـ \fB\-\-format jpeg\fP). هذا الخيار غير متوافق مع خيار \fB\-\-output\-path\fP. يُعطى \fIformat\fP كسلسلة نمط printf بمعامل صحيح واحد. .TP \fB\-\-batch\-start\fP=\fIstart\fP يختار رقم الصفحة لبدء تسمية الملفات بها. إذا لم يُعط هذا الخيار، يبدأ العداد من 1. .TP \fB\-\-batch\-count\fP=\fIcount\fP يحدد عدد الصفحات لمحاولة مسحها ضوئيًا. إذا لم يُعط، يواصل \fBscanimage\fP المسح حتى يُرجع الماسح حالة غير OK. لا تشير جميع الماسحات ذات مغذيات المستندات عند فراغ ADF. استخدم هذا الخيار للتعامل معها. .TP \fB\-\-batch\-increment\fP=\fIincrement\fP يضبط المقدار الذي يُزاد به الرقم في اسم الملف. يُستخدم هذا عمومًا عند مسح مستندات مزدوجة الوجه على مغذي مستندات أحادي الوجه. \fB\-\-batch\-double\fP هو أمر محدد يُقدم للمساعدة في ذلك. .TP \fB\-\-batch\-double\fP يضبط الزيادة آليًا إلى 2. مكافئ لـ \fB\-\-batch\-increment\fP=2. .TP \fB\-\-batch\-prompt\fP يطلب الضغط على RETURN قبل مسح صفحة. يمكن استخدام هذا لمسح صفحات متعددة دون مغذي مستندات آلي. .RE .TP \fB\-\-accept\-md5\-only\fP يقبل فقط طلبات استيثاق المستخدم التي تدعم أمان MD5. خادم شبكة \fBSANE\fP \fBsaned\fP(8) قادر على تنفيذ هذه الطلبات. .TP \fB\-p\fP, \fB\-\-progress\fP يطلب من \fBscanimage\fP طباعة عداد تقدم. يُظهر مقدار بيانات الصورة الحالية التي استُلمت بالفعل (بالنسبة المئوية). .TP \fB\-o\fP\fI path\fP, \fB\-\-output\-file\fP=\fIpath\fP يطلب من \fBscanimage\fP حفظ مخرجات المسح إلى \fIpath\fP المُعطى. هذا الخيار غير متوافق مع خيار \fB\-\-batch\fP. يحاول البرنامج تخمين \fB\-\-format\fP من اسم الملف. إذا لم يكن ذلك ممكنًا، يطبع رسالة خطأ ويخرج. .TP \fB\-n\fP, \fB\-\-dont\-scan\fP يطلب من \fBscanimage\fP ضبط الخيارات التي قدمها المستخدم فقط دون إجراء مسح فعلي. يمكن استخدام هذا الخيار مثلًا لإطفاء مصباح الماسح (إذا كان مدعومًا من الخلفية). .TP \fB\-T\fP, \fB\-\-test\fP يطلب من \fBscanimage\fP إجراء بعض اختبارات الصلاحية البسيطة للتأكد من عمل الخلفية كما هو محدد بواسطة واجهة برمجة تطبيقات \fBSANE\fP. على وجه الخصوص، تُختبر دالة \fBsane_read\fP() بهذا الاختبار. .TP \fB\-A\fP, \fB\-\-all\-options\fP يطلب من \fBscanimage\fP سرد جميع الخيارات المتاحة التي تعرضها الخلفية، بما في ذلك خيارات الأزرار. تُطبع المعلومات على المخرجات القياسية ولا يُجرى أي مسح. .TP \fB\-h\fP، \fB\-\-help\fP يطلب معلومات المساعدة. تُطبع المعلومات على المخرجات القياسية ولا يُجرى أي مسح. .TP \fB\-v\fP، \fB\-\-verbose\fP يزيد تفصيل مخرجات \fBscanimage\fP. يمكن تحديد الخيار مرارًا، مع زيادة مستوى التفصيل في كل مرة. .TP \fB\-B\fP [\fIsize\fP], \fB\-\-buffer\-size\fP=\fIsize\fP يغير حجم مخزن الإدخال المؤقت من المبدئي 1MB إلى \fIsize\fP كيلوبايت. .TP \fB\-V\fP، \fB\-\-version\fP يطلب من \fBscanimage\fP طباعة اسم البرنامج والحزمة، رقم إصدار توزيعة \fBSANE\fP التي جاء معها، وإصدار الخلفية التي يحملها. إذا كانت هناك حاجة لمزيد من المعلومات حول أرقام إصدارات الخلفيات، يمكن استخدام متغير \fBDEBUG\fP لطبقة dll. مثال: \fISANE_DEBUG_DLL=3 scanimage \-L\fP. .PP كما قد تتخيل، يأتي الكثير من قوة \fBscanimage\fP من حقيقة أنه يمكنه التحكم في أي خلفية \fBSANE\fP. وبالتالي، تعتمد مجموعة خيارات سطر الأوامر الدقيقة على قدرات الجهاز المحدد. لعرض الخيارات لجهاز باسم \fIdev\fP، استدعِ \fBscanimage\fP عبر سطر أوامر بالشكل: .PP .RS scanimage \-\-help \-\-device\-name \fIdev\fP .RE .PP توثيق الخيارات الخاصة بالجهاز المطبوعة بواسطة \fB\-\-help\fP يُشرح بأفضل صورة عبر بعض الأمثلة: \fB\-l 0..218mm [0]\fP .RS موضع x العلوي الأيسر لمنطقة المسح الضوئي. .PP الوصف أعلاه يُظهر أن الخيار \fB\-l\fP يتوقع قيمة خيار في النطاق من 0 إلى 218 مم. القيمة بين قوسين مربعين تشير إلى أن قيمة الخيار الحالية هي 0 مم. معظم الخلفيات توفر خيارات هندسية مشابهة للموضع العلوي الأيسر y (\fB\-t\fP)، العرض (\fB\-x\fP) وارتفاع منطقة المسح (\-y\fB).\fP .RE \fB\-\-brightness \-100..100% [0]\fP .RS يتحكم في سطوع الصورة الملتقطة. .PP الوصف أعلاه يُظهر أن الخيار \fB\-\-brightness\fP يتوقع قيمة خيار في النطاق من \-100 إلى 100 بالمئة. القيمة بين قوسين مربعين تشير إلى أن قيمة الخيار الحالية هي 0 بالمئة. .RE \fB\-\-default\-enhancements\fP .RS يضبط القيم المبدئية لعناصر تحكم التحسين. .PP الوصف أعلاه يُظهر أن الخيار \fB\-\-default\-enhancements\fP ليس له قيمة خيار. يجب اعتباره ذا تأثير فوري عند نقطة سطر الأوامر التي يظهر فيها. على سبيل المثال، بما أن هذا الخيار يعيد ضبط الخيار \fB\-\-brightness\fP، فإن زوج الخيارات \fB\-\-brightness 50 \-\-default\-enhancements\fP سيكون بلا تأثير فعليًا. .RE \fB\-\-mode Lineart|Gray|Color [Gray]\fP .RS يختار وضع المسح (مثل، خطي أو لوني). .PP الوصف أعلاه يُظهر أن الخيار \fB\-\-mode\fP يقبل وسيطًا يجب أن يكون أحد السلاسل \fBLineart\fP أو \fBGray\fP أو \fBColor\fP. القيمة بين القوسين المربعين تشير إلى أن الخيار مضبوط حاليًا على \fBGray\fP. للراحة، من القانوني اختصار قيم السلاسل طالما بقيت فريدة. أيضًا، حالة الأحرف لا تهم. على سبيل المثال، إعداد الخيار \fB\-\-mode col\fP مطابق لـ \fB\-\-mode Color\fP. .RE \fB\-\-custom\-gamma[=(yes|no)] [inactive]\fP .RS يحدد ما إذا كان يجب استخدام جدول غاما مدمج أم مخصص. .PP الوصف أعلاه يُظهر أن الخيار \fB\-\-custom\-gamma\fP يتوقع إما عدم وجود قيمة خيار، أو سلسلة "yes"، أو سلسلة "no". تحديد الخيار بدون قيمة يعادل تحديد "yes". القيمة بين قوسين مربعين تشير إلى أن الخيار غير نشط حاليًا. أي أن محاولة ضبط الخيار ستؤدي إلى رسالة خطأ. مجموعة الخيارات المتاحة تعتمد عادةً على إعدادات الخيارات الأخرى. على سبيل المثال، قد يكون جدول \fB\-\-custom\-gamma\fP نشطًا فقط عند طلب وضع مسح تدرج رمادي أو لوني. لاحظ أن الخيار \fB\-\-help\fP يُعالج فقط بعد معالجة جميع الخيارات الأخرى. هذا يجعل من الممكن رؤية إعدادات الخيارات لوضع معين بتحديد خيارات الوضع المناسبة مع الخيار \fB\-\-help\fP. على سبيل المثال، سطر الأوامر: .PP \fBscanimage \-\-help \-\-mode\fP \fIcolor\fP .PP سيطبع إعدادات الخيارات السارية عند اختيار الوضع اللوني. .RE \fB\-\-gamma\-table 0..255,...\fP .RS جدول تصحيح غاما. في الوضع اللوني، يؤثر هذا الخيار بالتساوي على القنوات الحمراء والخضراء والزرقاء في وقت واحد (أي أنه جدول غاما للشدة). .PP الوصف أعلاه يُظهر أن الخيار \fB\-\-gamma\-table\fP يتوقع صفرًا أو أكثر من القيم في النطاق 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". يمكن استخدام البرنامج \fBgamma4scanimage\fP لتوليد جداول غاما هذه (انظر \fBgamma4scanimage\fP(1) للتفاصيل). .RE \fB\-\-filename [/tmp/input.ppm]\fP .RS اسم ملف الصورة المراد تحميلها. .PP الوصف أعلاه هو مثال لخيار يأخذ قيمة سلسلة عشوائية (وهي اسم ملف). مرة أخرى، القيمة بين القوسين تُظهر أن الخيار مضبوط حاليًا على اسم الملف \fI/tmp/input.ppm\fP. .RE .SH البيئة .TP \fBSANE_DEFAULT_DEVICE\fP اسم الجهاز المبدئي. .SH الملفات .TP \fI/etc/sane.d\fP هذا الدليل يحتوي على ملفات تهيئة متنوعة. للتفاصيل، يُرجى الرجوع إلى صفحات الدليل المدرجة أدناه. .TP \fI~/.sane/pass\fP هذا الملف يحتوي على أسطر بالصيغة .PP .RS user:password:resource .PP يستخدم \fBscanimage\fP هذه المعلومات للإجابة على طلبات استيثاق المستخدم آليًا. يجب أن يكون للملف أذونات 0600 أو أكثر تشددًا. يجب استخدام هذا الملف بالتزامن مع الخيار \fB\-\-accept\-md5\-only\fP لتجنب هجمات جانب الخادم. قد يحتوي المورد على أي حرف ولكنه محدود بـ 127 حرفًا. .SH "انظر أيضًا" \fBsane\fP(7), \fBgamma4scanimage\fP(1), \fBxscanimage\fP(1), \fBxcam\fP(1), \fBxsane\fP(1), \fBscanadf\fP(1), \fBsane\-dll\fP(5), \fBsane\-net\fP(5), \fBsane\-"backendname"\fP(5) .SH المؤلف David Mosberger، Andreas Beck، Gordon Matzigkeit، Caskey Dickson، وآخرون كثيرون. للأسئلة والتعليقات، اتصل بالقائمة البريدية sane\-devel (انظر \fIhttp://www.sane\-project.org/mailing\-lists.html\fP). .SH العلل بالنسبة لخيارات المتجه، لا يحتوي مخرج المساعدة حاليًا على أي إشارة إلى عدد العناصر التي يجب أن تحتويها قيمة المتجه. .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .