sane-v4l(5) SANE Scanner Access Now Easy sane-v4l(5)

sane-v4l - رابط SANE برای رابط برنامه‌نویسی Video for Linux

کتابخانهٔ sane-v4l یک بک‌اند SANE (Scanner Access Now Easy ‏- دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی عمومی به دوربین‌های ویدئویی و تجهیزات مشابه را با استفاده از رابط برنامه‌نویسی V4L (Video for Linux) فراهم می‌آورد.

این یک نرم‌افزار آلفا (آزمایشی) است. واقعاً! ویژگی‌های مهمی در آن وجود ندارد و دارای باگ‌های فراوانی است. کد در حال حاضر تنها روی یک سیستم لینوکس 2.4 با کارت ویدئوی Hauppauge WinTV آزمایش شده است.

این بک‌اند انتظار نام‌های دستگاهی با ساختار زیر را دارد:

special

که در آن special نام مسیر یونیکس برای دستگاه ویژه‌ای است که با دستگاه v4l مطابقت دارد. نام دستگاه ویژه باید یک دستگاه v4l یا یک پیوند نمادین به چنین دستگاهی باشد. برای نمونه، چنین نام دستگاهی می‌تواند /dev/video0 یا /dev/bttv0 باشد.

محتوای فایل v4l.conf فهرستی از نام‌های دستگاه متناظر با دستگاه‌های v4l است. خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:

/dev/bttv0
# this is a comment
/dev/video3

/etc/sane.d/v4l.conf
فایل پیکربندی بک‌اند (توضیحات SANE_CONFIG_DIR در زیر را نیز ببینید).
/usr/lib/sane/libsane-v4l.a
کتابخانهٔ ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-v4l.so
کتابخانهٔ مشترک که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).

این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های *NIX، دایرکتوری‌ها با دونقطه (`:') و در OS/2 با نقطه‌ویرگول (`;') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا در دایرکتوری کاری جاری (".") و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسهٔ جداکنندهٔ دایرکتوری خاتمه یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای نمونه، تنظیم SANE_CONFIG_DIR روی "/tmp/config:" منجر به جستجو در دایرکتوری‌های tmp/config، . و /etc/sane.d (به همین ترتیب) خواهد شد.
اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای نمونه، مقدار ۱۲۸ درخواست چاپ همهٔ خروجی‌های اشکال‌زدایی را دارد. سطوح کوچک‌تر میزان پرگویی خروجی را کاهش می‌دهند.

Juergen G. Schimmer, Henning Meier-Geinitz

اگر بیش از یک کارت ویدئو وجود داشته باشد، ممکن است فروپاشی (crash) رخ دهد. امکان انتخاب فرکانس و هندسه (geometry) وجود ندارد.
گزارش‌های باگ را به فهرست پستی SANE ارسال کنید: sane-devel@alioth-lists.debian.net. برای ارسال ایمیل باید در این لیست مشترک باشید. برای جزئیات به نشانی http://www.sane-project.org/mailing-lists.html مراجعه کنید.

sane(7), xcam(1)

14 Jul 2008