sane(7)

الاسم
sane - الوصول إلى الماسحة الضوئية أصبح سهلاً الآن: واجهة برمجة تطبيقات (API) للوصول إلى الماسحات الضوئية

الوصف
إنّ SANE هي واجهة برمجة تطبيقات (API) توفر وصولاً معيارياً إلى أي عتاد لماسحة صور نقطية. تجعل الواجهة المعيارية من الممكن كتابة تعريف واحد فقط لكل جهاز ماسحة بدلاً من تعريف واحد لكل ماسحة وتطبيق.

بينما تستهدف SANE بيئة يونكس بشكل رئيس، إلا أن المعيار صُمم بعناية لجعل من الممكن تنفيذ واجهة برمجة التطبيقات على أي عتاد أو نظام تشغيل تقريباً.

توفر صفحة الدليل هذه ملخصاً للمعلومات المتاحة حول SANE.

إذا واجهت مشكلة في اكتشاف الماسحة الضوئية الخاصة بك، فاقرأ قسم PROBLEMS (المشكلات).

المصطلحات

يُسمى التطبيق الذي يستخدم واجهة SANE بـ SANE frontend (واجهة أمامية لـ SANE). ويُسمى التعريف الذي ينفذ واجهة SANE بـ SANE backend (واجهة خلفية لـ SANE). وتوفر meta backend (الواجهة الخلفية الوصفية) بعض الوسائل لإدارة واجهة خلفية واحدة أو أكثر.

حزم البرمجيات
تحتوي الحزمة sane-backends على الواجهات الخلفية، والتوثيق، ودعم الشبكات، وواجهة سطر الأوامر الأمامية scanimage(1). الواجهات الأمامية xscanimage(1) و xcam(1) و scanadf(1) مُضمنة في حزمة sane-frontends. يمكن تنزيل كلتا الحزمتين من صفحة SANE الرئيسة (http://www.sane-project.org/). يمكن أيضًاً العثور على معلومات حول الواجهات الأمامية والخلفية الأخرى على صفحة SANE الرئيسة.

معلومات عامة
توفر الأقسام التالية أوصافًا قصيرة وروابط لمزيد من المعلومات حول عدة جوانب من SANE. يشير الاسم الذي يليه رقم بين قوسين (مثل sane-dll(5)) إلى صفحة دليل. في هذه الحالة سيعرض man 5 sane-dll الصفحة. تُعد الإدخالات مثل /usr/share/doc/libsane/README مراجع لملفات نصية نُسخت إلى دليل وثائق SANE (/usr/share/doc/libsane/) أثناء التثبيت. كل شيء آخر هو رابط URL لمورد على الويب.

صفحة SANE الرئيسة
    يمكن العثور على معلومات حول جميع جوانب SANE بما في ذلك درس تعليمي ورابط للأسئلة الشائعة حول SANE على صفحة SANE الرئيسة: http://www.sane-project.org/.

قوائم أجهزة SANE
    تحتوي قوائم أجهزة SANE على معلومات حول حالة دعم SANE لجهاز معين. إذا لم يكن ماسحك الضوئي مدرجًا هناك (سواء كان مدعومًا أو غير مدعوم)، فيرجى متراسل. انظر قسم كيف يمكنك مساعدة SANE للمزيد من التفاصيل. توجد قوائم لإصدارات محددة من SANE، ولنسخة التطوير الحالية ومحرك بحث: http://www.sane-project.org/sane-supported-devices.html. القوائم مُثبتة أيضًا على نظامك في /usr/share/doc/libsane/.

القائمة البريدية لـ SANE
    توجد قائمة بريدية لغرض مناقشة معيار SANE وتنفيذاته: sane-devel. وعلى الرغم من اسمها، فإن القائمة ليست مخصصة للمطورين فحسب، بل للمستخدمين أيضًا. توجد أيضًا بعض القوائم الإضافية لمواضيع خاصة. ومع ذلك، بالنسبة للمستخدمين، تعد sane-devel هي القائمة المناسبة. كيفية الاشتراك وإلغاء الاشتراك: http://www.sane-project.org/mailing-lists.html.

قناة IRC الخاصة بـ SANE
    يمكن العثور على قناة الدردشة عبر الإنترنت (IRC) باسم #sane على شبكة Freenode (irc.libera.chat). وهي مخصصة لمناقشة مشكلات SANE، والتحدث عن التطوير والدردشة العامة المتعلقة بـ SANE. قبل طلب المساعدة، يرجى قراءة التوثيقات الأخرى المذكورة في صفحة الدليل هذه. يُستخدم موضوع القناة أيضًا للإعلان عن مشكلات في بنية SANE التحتية (القوائم البريدية، خادم الويب، إلخ).

ترجمة وتثبيت SANE
    انظر إلى /usr/share/doc/libsane/README وملفات README المعتمدة على نظام التشغيل للحصول على معلومات حول تصريف وتثبيت SANE.

ضبط SCSI
    للحصول على معلومات حول الأنظمة المختلفة ومتحكمات SCSI انظر sane-scsi(5).

ضبط USB
    للحصول على معلومات حول ضبط USB انظر sane-usb(5).

الواجهات الأمامية والبرامج المتنوعة

scanimage
    واجهة سطر الأوامر. انظر scanimage(1).

saned
    عفريت شبكة SANE الذي يسمح للعملاء البعيدين بالوصول إلى أجهزة جلب الصور المتاحة على المضيف المحلي. انظر saned(8).

sane-find-scanner
    أداة سطر أوامر للعثور على ماسحات SCSI و USB وتحديد ملفات أجهزة يونكس الخاصة بها. انظر sane-find-scanner(1).

أيضًا، ألقِ نظرة على حزمة sane-frontends (التي تتضمن xscanimage(1) و xcam(1) و scanadf(1)) وصفحة معلومات الواجهة الأمامية في http://www.sane-project.org/sane-frontends.html.

الواجهات الخلفية للماسحات الضوئية

abaton
    يدعم ماسحات Abaton المسطحة مثل Scan 300/GS (8 بت، 256 مستوى رمادي) و Scan 300/S (أبيض وأسود، لم يُختبر). انظر sane-abaton(5) للحصول على التفاصيل.

agfafocus
    يدعم ماسحات AGFA Focus و Siemens S9036 (لم يُختبر). انظر sane-agfafocus(5) للحصول على التفاصيل.

apple
    يدعم ماسحات آبل المسطحة بما في ذلك الماسحات التالية: AppleScanner و OneScanner و ColorOneScanner. انظر sane-apple(5) للحصول على التفاصيل.

artec
    يدعم العديد من ماسحات Artec/Ultima SCSI المسطحة بالإضافة إلى BlackWidow BW4800SP و Plustek 19200S. انظر sane-artec(5) للحصول على التفاصيل.

artec_eplus48u
    يدعم ماسحة Artec E+ 48U والنماذج المعاد تسميتها مثل Tevion MD 9693 و Medion MD 9693 و Medion MD 9705 و Trust Easy Webscan 19200. انظر sane-artec_eplus48u(5) للحصول على التفاصيل.

as6e
    يدعم ماسحة Artec AS6E ذات واجهة المنفذ المتوازي. انظر sane-as6e(5) للحصول على التفاصيل.

avision
    يدعم العديد من الماسحات المستندة إلى Avision بما في ذلك ماسحات Avision الأصلية (مثل AV 630، AV 620، ...) بالإضافة إلى سلسلة HP ScanJet 53xx و 74xx، و Fujitsu ScanPartner، وبعض ماسحات أفلام Mitsubishi و Minolta. انظر sane-avision(5) للحصول على التفاصيل.

bh  يدعم سلسلة ماسحات المستندات Bell+Howell Copiscan II. انظر sane-bh(5) للحصول على التفاصيل.

canon
    يدعم ماسحات CanoScan 300 و CanoScan 600 و CanoScan 2700F SCSI المسطحة. انظر sane-canon(5) للحصول على التفاصيل.

canon630u
    يدعم ماسحات CanoScan 630u و 636u USB. انظر sane-canon630u(5) للحصول على التفاصيل.

canon_dr
    يدعم ماسحات Canon DR-Series ADF SCSI و USB. انظر sane-canon_dr(5) للحصول على التفاصيل.

canon_lide70
    يدعم ماسحات CanoScan LiDE 70 و 600 USB. انظر sane-canon_lide70(5) للحصول على التفاصيل.

canon_pp
    يدعم ماسحات CanoScan FB330P و FB630P و N340P و N640P ذات المنفذ المتوازي. انظر sane-canon_pp(5) للحصول على التفاصيل.

cardscan
    دعم ماسحات Corex Cardscan USB. انظر sane-cardscan(5) للحصول على التفاصيل.

coolscan coolscan2 coolscan3
    يدعم ماسحات أفلام Nikon Coolscan. انظر sane-coolscan(5) و sane-coolscan2(5) و sane-coolscan3(5) للحصول على التفاصيل.

epjitsu
    يدعم ماسحات Fujitsu المستندة إلى Epson والتي تعمل عبر USB. انظر sane-epjitsu(5) للحصول على التفاصيل.

epson
    تعريف قديم لماسحات Epson SCSI، والمنفذ المتوازي، والماسحات المسطحة USB. انظر sane-epson(5) للحصول على التفاصيل ولكن جرب epson2 أولاً.

epson2
    تعريف أحدث لماسحات Epson SCSI والمنفذ المتوازي والشبكة والماسحات المسطحة USB (جرب هذا قبل epson الذي عفا عليه الزمن). انظر sane-epson2(5) للحصول على التفاصيل.

escl
    يدعم الماسحات عبر بروتوكول eSCL. انظر sane-escl(5) للحصول على التفاصيل.

fujitsu
    يدعم معظم ماسحات Fujitsu SCSI و USB، والماسحات المسطحة وماسحات adf. انظر sane-fujitsu(5) للحصول على التفاصيل.

genesys
    يدعم العديد من الماسحات القائمة على شرائح Genesys Logic GL646 و GL841 و GL843 و GL847 و GL124 مثل Medion 6471 و Hewlett-Packard 2300c. انظر sane-genesys(5) للحصول على التفاصيل.

gt68xx
    يدعم الماسحات القائمة على شرائح Grandtech GT-6801 و GT-6816 مثل Artec Ultima 2000 والعديد من طرز Mustek BearPaw CU و TA.
    تُدعم أيضًا بعض ماسحات Genius و Lexmark و Medion و Packard Bell و Plustek و Trust. انظر sane-gt68xx(5) للحصول على التفاصيل.

hp  يدعم ماسحات Hewlett-Packard ScanJet التي تستخدم SCL (لغة التحكم في الماسحة من HP). انظر sane-hp(5) للحصول على التفاصيل.

hpsj5s
    يدعم ماسحة Hewlett-Packard ScanJet 5S. انظر sane-hpsj5s(5) للحصول على التفاصيل.

hp3500
    يدعم سلسلة Hewlett-Packard ScanJet 3500. انظر sane-hp3500(5) للحصول على التفاصيل.

hp3900
    يدعم سلسلة Hewlett-Packard ScanJet 3900. انظر sane-hp3900(5) للحصول على التفاصيل.

hp4200
    يدعم سلسلة Hewlett-Packard ScanJet 4200. انظر sane-hp4200(5) للحصول على التفاصيل.

hp5400
    يدعم سلسلة Hewlett-Packard ScanJet 54XXC. انظر sane-hp5400(5) للحصول على التفاصيل.

hpljm1005
    يدعم ماسحة Hewlett-Packard LaserJet M1005. انظر sane-hpljm1005(5) للحصول على التفاصيل.

hs2p
    يدعم عائلة ماسحات SCSI من نوع Ricoh IS450. انظر sane-hs2p(5) للتفاصيل.

ibm يدعم بعض ماسحات SCSI من نوع IBM و Ricoh. انظر sane-ibm(5) للتفاصيل.

kodak
    يدعم بعض ماسحات Kodak الكبيرة. انظر sane-kodak(5) للتفاصيل.

kodakaio
    يدعم طابعات/ماسحات Kodak AiO. انظر sane-kodakaio(5) للتفاصيل.

kvs1025
    يدعم ماسحات Panasonic KV-S102xC. انظر sane-kvs1025(5) للتفاصيل.

leo يدعم LEO S3 و Across FS-1130، وهو ماسح LEO FS-1130 أُعيدت تسميته. انظر sane-leo(5) للتفاصيل.

lexmark
    يدعم سلسلة ماسحات USB من نوع Lexmark X1100. انظر sane-lexmark(5) للتفاصيل.

lexmark_x2600
    يدعم سلسلة ماسحات USB من نوع Lexmark X2600. انظر sane-lexmark_x2600(5) للتفاصيل.

ma1509
    يدعم الماسح المسطح USB من نوع Mustek BearPaw 1200F. انظر sane-ma1509(5) للتفاصيل.

magicolor
    يدعم الجهاز متعدد الوظائف (طابعة/ماسح/فاكس) KONICA MINOLTA magicolor 1690MF. انظر sane-magicolor(5) للتفاصيل.

matsushita
    يدعم بعض ماسحات Panasonic KVSS عالية السرعة. انظر sane-matsushita(5) للتفاصيل.

microtek
    يدعم ماسحات Microtek من "الجيل الثاني" مع مجموعة أوامر SCSI-1. انظر sane-microtek(5) للتفاصيل.

microtek2
    يدعم بعض ماسحات Microtek مع مجموعة أوامر SCSI-2. انظر sane-microtek2(5) للتفاصيل.

mustek
    يدعم معظم ماسحات Mustek المسطحة من نوع SCSI بما في ذلك سلسلتي Paragon و ScanExpress و 600 II N و 600 II EP (ليست SCSI). تُدعم بعض ماسحات Trust أيضًا. انظر sane-mustek(5) للتفاصيل.

mustek_pp
    يدعم ماسحات Mustek المسطحة ذات المنفذ المتوازي. انظر sane-mustek_pp(5) للتفاصيل.

mustek_usb
    يدعم بعض ماسحات Mustek ScanExpress المسطحة من نوع USB. انظر sane-mustek_usb(5) للتفاصيل.

mustek_usb2
    يدعم الماسحات التي تستخدم طقم رقاقات SQ113 مثل الماسح المسطح USB من نوع Mustek BearPaw 2448 TA Pro. انظر sane-mustek_usb2(5) للتفاصيل.

nec يدعم ماسح NEC PC-IN500/4C من نوع SCSI. انظر sane-nec(5) للتفاصيل.

niash
    يدعم Agfa Snapscan Touch والماسحات المسطحة USB من نوع HP ScanJet 3300c و 3400c و 4300c. انظر sane-niash(5) للتفاصيل.

p5  يدعم Primax PagePartner. انظر sane-p5(5) للتفاصيل.

pie يدعم الماسحات المسطحة SCSI من نوع Pacific Image Electronics (PIE) و Devcom. انظر sane-pie(5) للتفاصيل.

pixma
    يدعم سلسلة Canon PIXMA MP (أجهزة متعددة الوظائف)، وسلسلة Canon imageCLASS (أجهزة ليزر)، وسلسلة Canon MAXIFY وبعض سلسلة Canon CanoScan. انظر sane-pixma(5) للتفاصيل.

plustek
    يدعم الماسحات المسطحة USB التي تستخدم طقم رقاقات National Semiconductor LM983[1/2/3] المعروف باسم Merlin. تشمل الماسحات التي تستخدم رقاقات LM983x بعض الطرز من Plustek و KYE/Genius و Hewlett-Packard و Mustek و Umax و Epson و Canon. انظر sane-plustek(5) للتفاصيل.

plustek_pp
    يدعم ماسحات Plustek المسطحة ذات المنفذ المتوازي التي تستخدم Plustek ASIC P96001 و P96003 و P98001 و P98003، والتي تشمل بعض الطرز من Plustek و KYE/Genius و Primax. انظر sane-plustek_pp(5) للتفاصيل.

ricoh
    يدعم ماسحات Ricoh المسطحة IS50 و IS60. انظر sane-ricoh(5) للتفاصيل.

ricoh2
    يدعم ماسحات Ricoh المسطحة: SG-3100SNw و SP-100SU و SP-111SU. انظر sane-ricoh2(5) للتفاصيل.

s9036
    يدعم ماسحات Siemens 9036 المسطحة. انظر sane-s9036(5) للتفاصيل.

sceptre
    يدعم الماسح المسطح Sceptre S1200. انظر sane-sceptre(5) للتفاصيل.

sharp
    يدعم ماسحات Sharp من نوع SCSI. انظر sane-sharp(5) للتفاصيل.

sm3600
    يدعم ماسح USB من نوع Microtek ScanMaker 3600. انظر sane-sm3600(5) للتفاصيل.

sm3840
    يدعم ماسح USB من نوع Microtek ScanMaker 3840. انظر sane-sm3840(5) للتفاصيل.

snapscan
    يدعم ماسحات AGFA SnapScan المسطحة بما في ذلك بعض الماسحات التي أُعيدت تسميتها لعلامات تجارية أخرى. انظر sane-snapscan(5) للتفاصيل.

sp15c
    يدعم الماسح المسطح Fujitsu FCPA ScanPartner 15C. انظر sane-sp15c(5) للتفاصيل.

st400
    يدعم Siemens ST400 و ST800. انظر sane-st400(5) للتفاصيل.

tamarack
    يدعم ماسحات Tamarack Artiscan المسطحة. انظر sane-tamarack(5) للتفاصيل.

teco1 teco2 teco3
    يدعم بعض ماسحات TECO، التي تُباع عادةً تحت أسماء Relisys و Trust و Primax و Piotech و Dextra. انظر sane-teco1(5) و sane-teco2(5) و sane-teco3(5) للتفاصيل.

u12 يدعم الماسحات المسطحة USB المستندة إلى Plustek ASIC 98003 (منفذ متوازي ASIC) ورقاقة جسر USB-parport من GeneSys Logics مثل Plustek OpticPro U(T)12. انظر sane-u12(5) للتفاصيل.

umax
    يدعم ماسحات UMAX-SCSI وبعض ماسحات Linotype Hell SCSI. انظر sane-umax(5) للتفاصيل.

umax_pp
    يدعم ماسحات Umax المسطحة ذات المنفذ المتوازي و HP 3200C. انظر sane-umax_pp(5) للتفاصيل.

umax1200u
    يدعم الماسح المسطح (USB) من نوع UMAX Astra 1220U (وأيضًا UMAX Astra 2000U، نوعًا ما). انظر sane-umax1220u(5) للتفاصيل.

xerox_mfp
    يدعم ماسحات Samsung و Xerox و Dell المتعددة المستندة إلى Samsung. انظر sane-xerox_mfp(5) للتفاصيل.

أيضًا، ألقِ نظرة على صفحة معلومات الخلفية في http://www.sane-project.org/sane-supported-devices.html وقائمة المشاريع في /usr/share/doc/libsane/PROJECTS.

خلفيات الكاميرات الرقمية

dc210
    يدعم الكاميرا الرقمية Kodak DC210. انظر sane-dc210(5).

dc240
    يدعم الكاميرا الرقمية Kodak DC240. انظر dc240(5).

dc25
    يدعم الكاميرات الرقمية Kodak DC20/DC25. انظر dc25(5).

dmc يدعم كاميرا المجهر الرقمي من Polaroid. انظر dmc(5).

gphoto2
    يدعم الكاميرات الرقمية التي تدعمها حزمة مكتبة gphoto2. (انظر http://www.gphoto.org لمزيد من المعلومات وقائمة بالكاميرات المدعومة.) يدعم Gphoto2 أكثر من 140 طرازًا مختلفًا من الكاميرات. ومع ذلك، يرجى ملاحظة أن هناك حاجة لمزيد من التطوير والاختبار قبل أن تُدعم كل هذه الكاميرات بواسطة خلفية SANE. انظر gphoto2(5).

qcam
    يدعم كاميرات Connectix QuickCam. انظر qcam(5).

stv680
    يدعم كاميرات الويب التي تحتوي على رقاقة stv680. انظر stv680(5) للتفاصيل.

أيضًا، ألقِ نظرة على صفحة معلومات الخلفية في http://www.sane-project.org/sane-supported-devices.html وقائمة المشاريع في /usr/share/doc/libsane/PROJECTS.

خلفيات متنوعة

dll يُنفذ خلفية SANE توفر الوصول إلى عدد عشوائي من خلفيات SANE الأخرى عن طريق التحميل الديناميكي. انظر sane-dll(5).

net يوفر عفريت الشبكة saned(8) لـ SANE الوصول إلى الماسحات الضوئية الموجودة على حواسيب مختلفة بالاتصال مع الخلفية sane-net(5). انظر saned(8).

pnm خلفية وهمية لقارئ صور PNM. الغرض من هذه الخلفية هو المساعدة رئيسًا في تنقيح واجهات SANE الأمامية. انظر sane-pnm(5).

pint
    يدعم الماسحات الضوئية التي تستخدم تعريف الجهاز PINT (Pint Is Not Twain). يُطوَّر تعريف PINT بنشاط على منصة OpenBSD، ونُقل إلى بضعة أنظمة تشغيل أخرى شبيهة بـ *NIX. انظر sane-pint(5).

test
    يختبر الواجهات الأمامية وتثبيت SANE. يوفر صور اختبار وخيارات اختبار متنوعة. انظر sane-test(5).

v4l يوفر وصولاً عامًا إلى كاميرات الفيديو والمعدات المماثلة باستخدام واجهة برمجة تطبيقات V4L (فيديو من أجل لينكس). انظر sane-v4l(5).

أيضًا، ألقِ نظرة على صفحة معلومات الخلفية في http://www.sane-project.org/sane-supported-devices.html وقائمة المشاريع في /usr/share/doc/libsane/PROJECTS.

تغيير خلفية المستوى الأعلى
مبدئيًا، تُحمَّل جميع خلفيات (تعريفات) SANE ديناميكيًا بواسطة الخلفية الوصفية sane-dll. إذا كان لديك أي أسئلة حول التحميل الديناميكي، فاقرأ sane-dll(5). يمكن أيضًا ربط واجهات SANE الأمامية بخلفيات أخرى مباشرةً عن طريق نسخ أو ربط خلفية بـ libsane.so في /usr/lib/x86_64-linux-gnu/sane.

وثائق المطور
ليس من الصعب كتابة خلفية SANE. ومع ذلك، قد يستغرق الأمر بعض الوقت. يجب أن تكون لديك معرفة أساسية بلغة C وصبر كافٍ للعمل من خلال الوثائق ومعرفة كيفية عمل الماسح الضوئي الخاص بك. مُلحق طيه قائمة ببعض الوثائق التي تساعد في كتابة الخلفيات والواجهات الأمامية.

يحدد معيار SANE واجهة برمجة التطبيقات (API) المستخدمة للتواصل بين الواجهات الأمامية والخلفيات. يمكن العثور عليها في http://sane-project.gitlab.io/standard/ .

هناك بعض المعلومات الإضافية للمبرمجين في /usr/share/doc/libsane/backend-writing.txt. توثَّق معظم روتينات SANE الداخلية (sanei) باستخدام doxygen: http://www.sane-project.org/sanei/. قبل البدء في مشروع خلفية أو واجهة أمامية جديد، ألقِ نظرة على /usr/share/doc/libsane/PROJECTS للمشاريع المخطط لها أو التي لم تُدرج بعد في توزيعة SANE ونظام تتبع العوارض الخاص بنا: http://www.sane-project.org/bugs.html.

توجد بعض الروابط حول كيفية معرفة بروتوكول الماسح الضوئي: http://www.meier-geinitz.de/sane/misc/develop.html.

إذا بدأت في كتابة خلفية أو واجهة أمامية أو أي جزء آخر من SANE، يرجى متراسل القائمة البريدية sane-devel للتنسيق حتى لا يتكرر العمل.

الملفات

/etc/sane.d/*.conf
    ملفات ضبط الخلفية.

/usr/lib/x86_64-linux-gnu/sane/libsane-*.a
    المكتبات الساكنة التي تنفذ الخلفيات.

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

/usr/share/doc/libsane/*
    وثائق SANE: ملفات README، والملفات النصية للخلفيات وما إلى ذلك.

المشاكل
إذا لم يُعثر على جهازك ولكنك تعلم أنه مدعوم، فتأكد من اكتشافه بواسطة نظام التشغيل الخاص بك. بالنسبة لماسحات SCSI وUSB، استخدم أداة sane-find-scanner(1). تطبع سطرًا واحدًا لكل ماسح ضوئي اكتشفته وبعض التعليقات (#). إذا عثرت sane-find-scanner(1) على الماسح الضوئي الخاص بك كجذر فقط وليس كمستخدم عادي، فإن الأذونات لملفات الجهاز غير مضبوطة بشكل صحيح. إذا لم يُعثر على الماسح الضوئي على الإطلاق، فإن نظام التشغيل لم يكتشفه وقد يحتاج إلى بعض المساعدة. اعتمادًا على نوع الماسح الضوئي الخاص بك، اقرأ sane-usb(5) أو sane-scsi(5). إذا كان الماسح الضوئي (أو أي جهاز آخر) غير متصل عبر ناقل SCSI أو USB، فاقرأ صفحة دليل الخلفية للحصول على تفاصيل حول كيفية إعداده.

هل اكتشف نظام التشغيل الماسح الضوئي الخاص بك ولكن لم يكتشفه SANE؟ جرب scanimage -L. إذا لم يُعثر على الماسح الضوئي، فتحقق من ذكر اسم الخلفية في /etc/sane.d/dll.conf. بعض الخلفيات مُعلَّقة مبدئيًا. أزِل علامة التعليق لخلفيتك في هذه الحالة. أيضًا لا تُصرَّف بعض الخلفيات على الإطلاق إذا كان أحد متطلباتها الأساسية مفقودًا. تشمل الأمثلة dc210، dc240، canon_pp، hpsj5s، gphoto2، pint، qcam، v4l، net، sm3600، snapscan، pnm. إذا كنت بحاجة إلى إحدى هذه الخلفيات ولم تكن متوفرة، فاقرأ تعليمات البناء في ملف README وصفحات الدليل الفردية للخلفيات.

قد يكون هناك سبب آخر لعدم الاكتشاف بواسطة scanimage -L وهو فقدان أو عدم صحة الضبط في ملف ضبط الخلفية. بينما يحاول SANE العثور آليًا على معظم الماسحات الضوئية، لا يمكن إعداد بعضها بشكل صحيح دون تدخل المسؤول. كما أن الاكتشاف الآلي قد لا يعمل في بعض أنظمة التشغيل. تحقق من صفحة دليل الخلفية للحصول على التفاصيل.

إذا لم يُعثر على الماسح الضوئي الخاص بك بعد، فجرب ضبط متغيرات البيئة المتنوعة المتاحة للمساعدة في التنقيح. توثَّق متغيرات البيئة في صفحات الدليل ذات الصلة. على سبيل المثال، للحصول على أقصى قدر من معلومات التنقيح عند اختبار ماسح Mustek SCSI، اضبط متغيرات البيئة SANE_DEBUG_DLL وSANE_DEBUG_MUSTEK وSANE_DEBUG_SANEI_SCSI إلى 128 ثم استدعِ scanimage -L. تخبرك رسائل SANE_DEBUG_DLL ما إذا كان قد عُثر على خلفية sane-mustek(5) وحُمِّلت على الإطلاق. توضح رسائل SANE_DEBUG_MUSTEK ما تفعله الخلفية بينما يظهر تنقيح SANE_DEBUG_SCSI التعامل منخفض المستوى. إذا لم تتمكن من معرفة ما يحدث عن طريق التحقق من الرسائل بعناية، فمتراسل القائمة البريدية sane-devel للمساعدة (انظر الإبلاغ عن العوارض أدناه).

الآن بعد أن عُثر على ماسحك الضوئي بواسطة scanimage -L، حاول إجراء مسح: scanimage >image.pnm. يبدأ هذا الأمر مسحًا للماسح الضوئي المبدئي بالإعدادات المبدئية. تُدرج جميع الخيارات المتاحة عن طريق تشغيل scanimage --help. إذا أُجهض المسح برسالة خطأ، ففعل التنقيح كما ذكرنا أعلاه. ربما يحتاج ملف الضبط إلى بعض التعديل، مثل إعداد المسار لبرمجيات ثابتة تحتاجها بعض الماسحات الضوئية. انظر صفحة دليل الخلفية للحصول على التفاصيل. إذا لم تتمكن من معرفة الخطأ، فمتراسل sane-devel.

للتحقق من تثبيت مكتبات SANE بشكل صحيح، يمكنك استخدام خلفية الاختبار، حتى لو لم يكن لديك ماسح ضوئي أو جهاز SANE آخر:

    scanimage -d test -T

يجب أن تحصل على قائمة بالاختبارات الناجحة (PASS). يمكنك فعل الشيء نفسه مع خلفيتك عن طريق تغيير "test" إلى اسم خلفيتك.

إذاً الآن يعمل المسح باستخدام scanimage (1) وتريد استخدام أحد الواجهات الأمامية الرسومية مثل xsane(1) أو xscanimage(1) أو quiteinsane(1) ولكن هذه الواجهات لا تكتشف ماسحك الضوئي؟ قد يكون أحد الأسباب هو أنك ثبّت نسختين من SANE. مثلاً النسخة التي ثُبّتت بواسطة توزيعتك في /usr ونسخة ثبّتتها من المصدر في /usr/local/. تأكد من تثبيت نسخة واحدة فقط. سبب آخر محتمل هو أن المُحمّل الديناميكي لنظامك لا يمكنه العثور على مكتبات SANE. بالنسبة للينكس، تأكد من أن /etc/ld.so.conf يحتوي على /usr/local/lib ولا يحتوي على /usr/local/lib/sane. انظر أيضًا وثائق الواجهات الأمامية.

كيف يمكنك مساعدة SANE
نقدر أي مساعدة يمكننا الحصول عليها. يرجى إلقاء نظرة على صفحة الويب الخاصة بنا حول المساهمة في SANE: http://www.sane-project.org/contrib.html

متراسل
للإبلاغ عن العوارض أو طلب ميزات جديدة، يرجى استخدام نظام تتبع العوارض الخاص بنا: http://www.sane-project.org/bugs.html. يمكنك أيضًا متراسل مؤلف خلفيتك مباشرة. عادة ما يمكن العثور على عنوان البريد الإلكتروني في ملف /usr/share/doc/libsane/AUTHORS أو صفحة دليل الخلفية. للمناقشة العامة حول SANE، يرجى استخدام قائمة SANE البريدية sane-devel (انظر http://www.sane-project.org/mailing-lists.html لمزيد من التفاصيل).

انظر أيضًا
saned(8), sane-find-scanner(1), scanimage(1), sane-abaton(5), sane-agfafocus(5), sane-apple(5), sane-artec(5), sane-artec_eplus48u(5), sane-as6e(5), sane-avision(5), sane-bh(5), sane-canon(5), sane-canon630u(5), sane-canon_dr(5), sane-canon_pp(5), sane-cardscan(5), sane-coolscan(5), sane-coolscan2(5), sane-coolscan3(5), sane-dc210(5), sane-dc240(5), sane-dc25(5), sane-dll(5), sane-dmc(5), sane-epson(5), sane-epson2(5), sane-escl(5), sane-fujitsu(5), sane-genesys(5), sane-gphoto2(5), sane-gt68xx(5), sane-hp(5), sane-hpsj5s(5), sane-hp3500(5), sane-hp3900(5), sane-hp4200(5), sane-hp5400(5), sane-hpljm1005(5), sane-ibm(5), sane-kodak(5), sane-leo(5), sane-lexmark(5), sane-lexmark_x2600(5), sane-ma1509(5), sane-matsushita(5), sane-microtek2(5), sane-microtek(5), sane-mustek(5), sane-mustek_pp(5), sane-mustek_usb(5), sane-mustek_usb2(5), sane-nec(5), sane-net(5), sane-niash(5), sane-pie(5), sane-pint(5), sane-plustek(5), sane-plustek_pp(5), sane-pnm(5), sane-qcam(5), sane-ricoh(5), sane-ricoh2(5), sane-s9036(5), sane-sceptre(5), sane-scsi(5), sane-sharp(5), sane-sm3600(5), sane-sm3840(5), sane-snapscan(5), sane-sp15c(5), sane-st400(5), sane-stv680(5), sane-tamarack(5), sane-teco1(5), sane-teco2(5), sane-teco3(5), sane-test(5), sane-u12(5), sane-umax1220u(5), sane-umax(5), sane-umax_pp(5), sane-usb(5), sane-v4l(5), sane-xerox_mfp(5)

المؤلف
David Mosberger-Tang والعديد من الآخرين (انظر /usr/share/doc/libsane/AUTHORS للمزيد من التفاصيل). كُتبت صفحة الدليل هذه بواسطة Henning Meier-Geinitz. أُخذ الكثير من النص من معيار SANE وعدة صفحات دليل وملفات README.

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

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

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