.TH sane\-v4l 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-v4l
.SH "نام (NAME)"
sane\-v4l \- رابط SANE برای رابط برنامه‌نویسی Video for Linux
.SH "توضیحات (DESCRIPTION)"
کتابخانهٔ
.B sane\-v4l
یک بک‌اند SANE (Scanner Access Now Easy \- دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی عمومی به دوربین‌های ویدئویی و تجهیزات مشابه را با استفاده از رابط برنامه‌نویسی
.B V4L
(Video for Linux) فراهم می‌آورد.
.PP
این یک نرم‌افزار آلفا (آزمایشی) است. واقعاً! ویژگی‌های مهمی در آن وجود ندارد و دارای باگ‌های فراوانی است. کد در حال حاضر تنها روی یک سیستم لینوکس 2.4 با کارت ویدئوی Hauppauge WinTV آزمایش شده است.
.PP
.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند انتظار نام‌های دستگاهی با ساختار زیر را دارد:
.PP
.RS
.I special
.RE
.PP
که در آن
.I special
نام مسیر یونیکس برای دستگاه ویژه‌ای است که با دستگاه
.B v4l
مطابقت دارد. نام دستگاه ویژه باید یک دستگاه
.B v4l
یا یک پیوند نمادین به چنین دستگاهی باشد. برای نمونه، چنین نام دستگاهی می‌تواند
.I /dev/video0
یا
.IR /dev/bttv0
باشد.
.SH "پیکربندی (CONFIGURATION)"
محتوای فایل
.I v4l.conf
فهرستی از نام‌های دستگاه متناظر با دستگاه‌های
.B v4l
است. خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته می‌شوند. یک فایل پیکربندی نمونه در زیر نشان داده شده است:
.PP
.RS
/dev/bttv0
.br
# this is a comment
.br
/dev/video3
.RE
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/v4l.conf
فایل پیکربندی بک‌اند (توضیحات
.B SANE_CONFIG_DIR
در زیر را نیز ببینید).
.TP
.I /usr/lib/sane/libsane\-v4l.a
کتابخانهٔ ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-v4l.so
کتابخانهٔ مشترک که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).
.SH "محیط (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های *NIX، دایرکتوری‌ها با دونقطه (`:') و در OS/2 با نقطه‌ویرگول (`;') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا در دایرکتوری کاری جاری (".") و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسهٔ جداکنندهٔ دایرکتوری خاتمه یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای نمونه، تنظیم
.B SANE_CONFIG_DIR
روی "/tmp/config:" منجر به جستجو در دایرکتوری‌های
.IR tmp/config ،
.IR .
و
.I /etc/sane.d
(به همین ترتیب) خواهد شد.
.TP
.B SANE_DEBUG_V4L
اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای نمونه، مقدار ۱۲۸ درخواست چاپ همهٔ خروجی‌های اشکال‌زدایی را دارد. سطوح کوچک‌تر میزان پرگویی خروجی را کاهش می‌دهند.
.SH "نویسندگان (AUTHORS)"
Juergen G. Schimmer, Henning Meier-Geinitz

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

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR xcam (1)