نام (NAME)

sane-stv680 - بک‌اند SANE برای دوربین‌های STV680

توضیحات (DESCRIPTION)

کتابخانه sane-stv680 یک بک‌اند SANE (دسترسی آسان به اسکنر - Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به برخی از دوربین‌های STV680 را فراهم می‌سازد. این بک‌اند باید به عنوان یک نرم‌افزار با کیفیت بتا (آزمایشی) در نظر گرفته شود! دوربین‌های STV680 تحت برندهای گوناگونی مانند Aiptek به فروش می‌رسند. این بک‌اند ممکن است از دوربین شما پشتیبانی کند یا نکند.

دوربین‌هایی که باید با این بک‌اند کار کنند عبارتند از:

Vendor Model              USB vendor id  USB product id  status
------------------------  -------------  --------------  --------
AIPTEK stv680                0x0553         0x0202       basic
Konica e-mini                0x04c8         0x0722       untested
DigitalDream l'espion XS     0x1183         0x0001       untested
Creative WebCam Go mini      0x041e         0x4007       untested

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

برای راه‌اندازی این بک‌اند بررسی کنید که ماژول هسته stv680 در صورت وجود، حذف یا غیرفعال شده باشد.
همچنین پیش از استفاده، با ویرایش فایل /etc/sane.d/dll.conf و تغییر عبارت #stv680 به stv680، بک‌اند را فعال کنید.

برای مشکلات مربوط به دوربین‌های آزمایش‌نشده، باید با نویسنده برنامه تماس بگیرید.

گزینه‌هایی که این بک‌اند پشتیبانی می‌کند را می‌توان از طریق گزینه‌های خط فرمان برای برنامه‌هایی مانند scanimage(1) یا از طریق مؤلفه‌های گرافیکی در xcam(1) انتخاب کرد. برای هر دو برنامه از گزینه -B که برای بافر اندازه مورد نیاز است استفاده کنید.

چند مثال از برنامه‌های فرانت‌اند:

xcam(1)

xcam -B

scanimage(1): برای نوشتن در حالت دسته‌ای در یک فایل یا هر بار در یک فایل جدید:

scanimage -B -d stv680:libusb:001:002 --batch=out.ppm --batch-count 5 --mode "Color RGB"

scanimage -B -d stv680:libusb:001:002 --batch=out%d.ppm --batch-count 5 --mode "Color RGB"

اگر در استفاده از دوربینی که در اینجا فهرست نشده است موفقیتی داشتید، یا اگر متوجه هرگونه رفتار عجیبی شدید، لطفاً به نگهدارنده بک‌اند یا به فهرست رایانامه SANE گزارش دهید.

گزینه‌های معتبر خط فرمان و ساختار نحوی آن‌ها را می‌توان با استفاده از دستور زیر فهرست کرد:

scanimage --help -d stv680

حالت اسکن (Scan Mode)
--mode: حالت عملکرد پایه وب‌کم را از میان گزینه‌های معتبر انتخاب می‌کند.
حالت تفکیک‌پذیری خواندن ۸ بیت و تفکیک‌پذیری خروجی ۲۴ بیت است. تفکیک‌پذیری را برای یک اسکن تعیین می‌کند. دوربین تنها می‌تواند تفکیک‌پذیری‌های فهرست‌شده را ارائه دهد.
--Raw: در این حالت داده‌های خام نمایش داده می‌شوند.
--Color: در این حالت جداسازی بایر انجام می‌شود اما تصحیح رنگ صورت نمی‌گیرد.
--Color_RGB: جداسازی بایر و تصحیح رنگ انجام می‌شود.
--Color_RGB_TXT: جداسازی بایر، تصحیح رنگ و اضافه شدن خط متنی با تاریخ و زمان.
گزینه‌های بهبود تصویر (Enhancement options)
--white-level-r -32..+32: مشخص می‌کند چه سطحی از تابش رنگ قرمز باید در هنگام اسکن برگه‌ها با تغییر مقدار کالیبراسیون بارگذاری‌شده در اسکنر، به عنوان «سفید» در نظر گرفته شود. مقیاس -32 .. 0 .. +32 با گام‌های ۱.
--white-level-g -32..+32: مشخص می‌کند چه سطحی از تابش رنگ سبز باید در هنگام اسکن برگه‌ها با تغییر مقدار کالیبراسیون بارگذاری‌شده در اسکنر، به عنوان «سفید» در نظر گرفته شود. مقیاس -32 .. 0 .. +32 با گام‌های ۱.
--white-level-b -32..+32: مشخص می‌کند چه سطحی از تابش رنگ آبی باید در هنگام اسکن برگه‌ها با تغییر مقدار کالیبراسیون بارگذاری‌شده در اسکنر، به عنوان «سفید» در نظر گرفته شود. مقیاس -32 .. 0 .. +32 با گام‌های ۱.

فایل پیکربندی (CONFIGURATION FILE)

فایل پیکربندی /etc/sane.d/stv680.conf تنها از یک مورد پشتیبانی می‌کند: نام دستگاه مورد استفاده (مانند usb 0x.... 0x....).

فایل‌ها (FILES)

/usr/lib/sane/libsane-stv680.a: کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-stv680.so: کتابخانه مشترک که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).

متغیرهای محیطی (ENVIRONMENT)

SANE_DEBUG_STV680: اگر کتابخانه با پشتیبانی از اشکال‌زدایی فعال کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸ درخواست می‌کند که تمام خروجی‌های اشکال‌زدایی چاپ شوند. مقادیر کوچک‌تر، پرگویی خروجی را کاهش می‌دهند.

محدودیت‌ها (LIMITATIONS)

درایور TWAIN در ویندوز گزینه‌های بسیار بیشتری نسبت به این بک‌اند SANE دارد. با این حال، آن‌ها فقط تنظیمات نرم‌افزاری هستند. این بک‌اند تنها مواردی را پیاده‌سازی می‌کند که وب‌کم می‌تواند پشتیبانی کند.

اشکالات (BUGS)

بسیار زیاد است. بخش‌هایی از این بک‌اند هنوز در دست توسعه هستند.: ۱. برخی دوربین‌های آزمایش‌نشده.
۲. پخش ویدیو کُند است و گاهی متوقف می‌شود (scanimage).
۳. گاهی یک‌سوم تصویر نامناسب است (xcam).

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

sane(7), sane-usb(5), scanimage(1), xcam(1)

نویسندگان (AUTHORS)

Gerard Klaver
http://gkall.hobby.nl/stv680-aiptek.html

قدردانی (CREDITS)

با تشکر از توسعه‌دهندگان سایر برنامه‌های stv680:: ماژول هسته STV680
برنامه pencam2
برنامه libghoto2(3) (camlib stv0680)