نام (NAME)

sane-qcam - بک‌اند SANE برای دوربین‌های Connectix QuickCam

توضیحات (DESCRIPTION)

کتابخانه sane-qcam یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به دوربین‌های Connectix QuickCam را فراهم می‌سازد.

نام‌های دستگاه (DEVICE NAMES)

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

port

که در آن port آدرس درگاه I/O است که دستگاه در آن قرار دارد. این آدرس معمولاً با استفاده از نحو C در مبنای شانزده (هگزادسیمال) مشخص می‌شود (برای مثال 0x37b) و ممکن است پیشوند حرف "u" داشته باشد (برای مثال u0x37b) تا بک‌اند را مجبور کند به دوربین در حالت یک‌طرفه (uni-directional) دسترسی پیدا کند.

پیکربندی (CONFIGURATION)

محتوای فایل qcam.conf فهرستی از آدرس‌های درگاه است که ممکن است به یک Connectix QuickCam متصل باشند. خطوط خالی و هر چیزی که با علامت هش (#) شروع شود تا انتهای خط نادیده گرفته می‌شوند. یک نمونه فایل پیکربندی در زیر نشان داده شده است:

0x37b # /dev/lp0
0x378 # /dev/lp1
u0x278 # /dev/lp2 forced in uni-directional mode
0x3bc # /dev/lp0 (alternate address)

به طور کلی، امن‌ترین راه این است که فقط آدرس‌های درگاهی را فهرست کنید که واقعاً مربوط به یک QuickCam هستند. برای مثال، اگر یکی از آدرس‌های فهرست‌شده در عمل به یک چاپگر متصل باشد، راه‌اندازی این بک‌اند باعث می‌شود چاپگر بازنشانی دستگاه (device reset) را انجام دهد (که معمولاً نامطلوب است).

فایل‌ها (FILES)

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

محیط (ENVIRONMENT)

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

نویسنده (AUTHOR)

David Mosberger

اشکالات (BUGS)

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

این برنامه به دسترسی‌های ریشه (root) نیاز دارد زیرا باید بتواند به درگاه‌های I/O دوربین دسترسی داشته باشد.

همچنین ببینید (SEE ALSO)

sane(7)