.TH sane\-qcam 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-qcam
.SH "نام (NAME)"
sane\-qcam \- بک‌اند SANE برای دوربین‌های Connectix QuickCam
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-qcam
یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به دوربین‌های Connectix QuickCam را فراهم می‌سازد.
.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند انتظار نام‌های دستگاهی به این فرمت را دارد:
.PP
.RS
.I port
.RE
.PP
که در آن
.I port
آدرس درگاه I/O است که دستگاه در آن قرار دارد. این آدرس معمولاً با استفاده از نحو C در مبنای شانزده (هگزادسیمال) مشخص می‌شود (برای مثال 0x37b) و ممکن است پیشوند حرف "u" داشته باشد (برای مثال u0x37b) تا بک‌اند را مجبور کند به دوربین در حالت یک‌طرفه (uni-directional) دسترسی پیدا کند.
.SH "پیکربندی (CONFIGURATION)"
محتوای فایل
.I qcam.conf
فهرستی از آدرس‌های درگاه است که ممکن است به یک Connectix QuickCam متصل باشند. خطوط خالی و هر چیزی که با علامت هش (#) شروع شود تا انتهای خط نادیده گرفته می‌شوند. یک نمونه فایل پیکربندی در زیر نشان داده شده است:
.PP
.RS
0x37b  # /dev/lp0
.br
0x378  # /dev/lp1
.br
u0x278 # /dev/lp2 forced in uni-directional mode
.br
0x3bc  # /dev/lp0 (alternate address)
.RE
.PP
به طور کلی، امن‌ترین راه این است که فقط آدرس‌های درگاهی را فهرست کنید که واقعاً مربوط به یک QuickCam هستند. برای مثال، اگر یکی از آدرس‌های فهرست‌شده در عمل به یک چاپگر متصل باشد، راه‌اندازی این بک‌اند باعث می‌شود چاپگر بازنشانی دستگاه (device reset) را انجام دهد (که معمولاً نامطلوب است).
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/qcam.conf
فایل پیکربندی بک‌اند (همچنین توضیحات
.B SANE_CONFIG_DIR
را در زیر ببینید).
.TP
.I /usr/lib/sane/libsane\-qcam.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-qcam.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_QCAM
اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار 128 درخواست چاپ تمام خروجی‌های اشکال‌زدایی را می‌دهد. سطوح کوچک‌تر پرگویی و جزئیات خروجی را کاهش می‌دهند.

.SH "نویسنده (AUTHOR)"
David Mosberger

.SH "اشکالات (BUGS)"
پشتیبانی در حال حاضر به نسخه رنگی QuickCam محدود است. دوربین سیاه‌وسفید نیز شروع به کار کرده است، اما فکر نمی‌کنم هنوز در همه شرایط کار کند. طبق گزارش‌ها، دریافت تصاویر با اندازه‌های خاص به خوبی کار می‌کند، اما برخی دیگر منجر به تصاویر جابجا‌شده (شیفت‌خورده) می‌شوند (به نظر می‌رسد مشکلی ناشی از byte-padding باشد).
.PP
این برنامه به دسترسی‌های ریشه (root) نیاز دارد زیرا باید بتواند به درگاه‌های I/O دوربین دسترسی داشته باشد.

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