نام (NAME)

zbarcam - پویش و رمزگشایی بارکدها از یک دستگاه ویدیویی

خلاصه دستور (SYNOPSIS)

zbarcam [-qv] [--quiet] [--nodisplay] [--xml] [--verbose[=n]] [--prescale=WxH] [-S[symbology.]config[=value]] [--set [symbology.]config[=value]] [device]

zbarcam {-h | --help | --version}

توضیحات (DESCRIPTION)

دستور zbarcam یک منبع ویدیویی video4linux (مانند وب‌کم) را برای یافتن بارکدها پویش کرده و هر داده رمزگشایی‌شده را در خروجی استاندارد چاپ می‌کند. جریان ویدیویی نیز روی صفحه نمایش داده می‌شود.

شناسه device مسیر پرونده ویژه دستگاه نویسه‌ای video4linux (نسخه ۱ یا ۲) است (شماره اصلی ۸۱ و شماره فرعی ۰ تا ۶۳). مقدار پیش‌فرض آن /dev/video0 است.

کتابخانه زیربنایی در حال حاضر از نشانه‌گذاری‌های EAN-13 (شامل زیرمجموعه‌های UPC و ISBN)، EAN-8، DataBar، DataBar Expanded، Code 128، Code 93، Code 39، Codabar، Interleaved 2 of 5 و QR Code پشتیبانی می‌کند. نوع دقیق هر نماد شناسایی‌شده همراه با داده‌های رمزگشایی‌شده چاپ می‌شود.

گزینه‌ها (OPTIONS)

این برنامه از ساختار معمول خط فرمان گنو (GNU) پیروی می‌کند. گزینه‌های تک‌حرفی می‌توانند با هم ترکیب شوند و گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند.

-h, --help

پیام راهنمای کوتاهی شامل توضیح گزینه‌های خط فرمان را در خروجی استاندارد چاپ کرده و خارج می‌شود

--version

اطلاعات نسخه برنامه را در خروجی استاندارد چاپ کرده و خارج می‌شود

-v, --verbose[=n]

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

-S[symbology.]config[=value], --set [symbology.]config[=value]

تنظیم گزینه پیکربندی رمزگشا config برای نشانه‌گذاری symbology روی مقدار value. در صورت عدم ذکر، مقدار پیش‌فرض value برابر با ۱ است. symbology یکی از موارد ean13، ean8، upca، upce، isbn13، isbn10، i25، codabar، code39، code93، code128، qrcode یا مقدار ویژه * است. اگر symbology ذکر نشود یا * باشد، مقدار config برای تمامی نشانه‌گذاری‌های سازگار اعمال خواهد شد. موارد زیر configهای شناخته‌شده فعلی هستند. برای نقیض کردن یک پیکربندی، پیشوند "no-" را به آن اضافه کنید. همه پیکربندی‌ها برای هر نشانه‌گذاری مناسب نیستند.

enable

کنترل رمزگشایی/گزارش یک نشانه‌گذاری. برای نشانه‌گذاری‌هایی که تنها زیرمجموعه‌ای از ean13 هستند (upca، upce، isbn13، isbn10)، این پیکربندی مشخص می‌کند که آیا زیرمجموعه‌ها شناسایی شده و به همان صورت گزارش شوند یا خیر. این موارد خاص به‌طور پیش‌فرض غیرفعال هستند، اما سایر نشانه‌گذاری‌ها به‌طور پیش‌فرض فعال می‌باشند

disable

متضاد enable

emit-check

کنترل اینکه آیا رقم‌های کنترل (چک‌دیجیت) در خروجی رمزگشایی گنجانده شوند یا خیر. به‌طور پیش‌فرض فعال است. این پیکربندی برای code128، که هرگز رقم کنترل را برنمی‌گرداند، اعمال نمی‌شود. همچنین برای مواردی که رقم کنترل غیرفعال است اعمال نمی‌گردد (نگاه کنید به add-check). رقم‌های کنترل در حال حاضر برای i25 یا code39 پیاده‌سازی نشده‌اند

add-check

فعال‌سازی رمزگشایی و اعتبارسنجی رقم کنترل برای نشانه‌گذاری‌هایی که این رقم در آن‌ها اختیاری است؛ این مورد شامل code39 و i25 خواهد بود، هرچند هیچ‌کدام هنوز رقم کنترل را پیاده‌سازی نکرده‌اند

ascii

فعال‌سازی دنباله‌های فرار (escape sequences) که کل مجموعه نویسه‌های ASCII را کدگذاری می‌کنند. این مورد برای code39 اعمال می‌شود، با این استثنا که این قابلیت نیز هنوز پیاده‌سازی نشده است...

position

فعال‌سازی جمع‌آوری اطلاعات موقعیت نماد. به‌طور پیش‌فرض فعال است. در حال حاضر اطلاعات موقعیت غیرقابل‌استفاده هستند، بنابراین می‌توانید با غیرفعال کردن آن در چند چرخه پردازشی صرفه‌جویی کنید.

test-inverted

به‌ویژه برای تصاویر کدهای QR؛ گاهی تصویر معکوس (نگاتیو) است، برای مثال خطوط به‌جای مشکی با رنگ سفید رسم شده‌اند. این گزینه ZBar را وادار می‌کند در صورت شکست در ترتیب عادی، تصویر را معکوس کرده و دوباره تجزیه کند. فعال‌سازی آن بر همه رمزگشاها تأثیر می‌گذارد.

min-length=n, max-length=n

محدود کردن تعداد نویسه‌های رمزگشایی‌شده در یک نماد معتبر. اگر نتیجه رمزگشایی خارج از محدوده تعیین‌شده min/max (شامل خود مقادیر) باشد، گزارش نخواهد شد. برای غیرفعال کردن بررسی متناظر، مقدار را روی 0 تنظیم کنید. این تنظیم برای نشانه‌گذاری‌های با طول متغیر اعمال می‌شود: i25، codabar، code39، code128 و pdf417. مقدار پیش‌فرض min-length برای i25 برابر با ۶ و برای code39 برابر با ۱ است (بر اساس توصیه تشخیص خودکار Code 39)؛ برای بقیه موارد مقدار پیش‌فرض 0 است

x-density=n, y-density=n

تنظیم تراکم گذرگاه‌های پویشگر. مقادیر کمتر بخش بیشتری از تصویر را به قیمت کاهش کارایی پویش می‌کنند. تنظیم مقدار روی 0 پویش در راستای آن محور را غیرفعال می‌کند. مقدار پیش‌فرض هر دو 1 است.

-q, --quiet

عملکرد بی‌صدا؛ غیرفعال کردن صدای بوق شنیداری که در حالت عادی هنگام رمزگشایی نماد پخش می‌شود

--nodisplay

غیرفعال کردن پنجره ویدیویی خروجی. ورودی ویدیویی تا زمان متوقف شدن برنامه یا دریافت سیگنال دیگر پویش خواهد شد

--xml

ارسال نتایج با ساختار خروجی XML به‌صورت جریانی (Stream). این ساختار، داده‌های خام نماد را همراه با اطلاعات مربوط به پویش در قالبی با قابلیت تجزیه آسان بسته‌بندی می‌کند. جدیدترین طرح‌واره (اسکیما) در پیوند زیر در دسترس است: http://zbar.sourceforge.net/2008/barcode.xsd

--raw

استفاده از ساختار خروجی داده‌های خام نماد. این ساختار داده‌های نماد را با خطوط جدید از هم جدا کرده و بدون اطلاعات اضافی نوع نشانه‌گذاری که به‌طور پیش‌فرض چاپ می‌شود، نمایش می‌دهد

--prescale=WxH

درخواست مقیاس‌بندی ورودی ویدیویی از درایور دوربین. برای کوچک کردن فریم‌های بزرگ به‌منظور دستیابی به نرخ فریم بالاتر مفید است. توجه داشته باشید که درایور ممکن است درخواست مقیاس‌بندی را تنظیم کند یا به‌طور کامل نادیده بگیرد

مثال‌ها (EXAMPLES)

پویش بارکدها با استفاده از دستگاه ویدیویی دوم و هدایت داده‌های به‌دست‌آمده از طریق لوله (pipe) به یک اسکریپت که هر کد را در پایگاه داده جستجو کرده و عملیات مفیدی روی آن‌ها انجام می‌دهد:

zbarcam /dev/video1 | upcrpc.py

اسکریپت نمونه upcrpc.py موجود در زیرپوشه examples/ توزیع، یک فراخوانی XMLRPC به یک پایگاه داده معروف اینترنتی UPC انجام داده و در صورت پیدا شدن، توضیحات محصول را چاپ می‌کند.

پویش بارکدها با استفاده از دستگاه ویدیویی پیش‌فرض و ارسال نتایج به خروجی استاندارد با قالب XML، همراه با غیرفعال کردن شناسایی کدهای Interleaved 2 of 5 جهت جلوگیری از تداخل با دیگر نشانه‌گذاری‌ها یا نویز پس‌زمینه:

zbarcam --xml -Si25.disable

پویش منحصراً برای Code 39 بدون استفاده از پنجره پیش‌نمایش - شاید برای یک سیستم نصب‌شده ثابت. برای فعال‌سازی اختصاصی Code 39، ابتدا تمام نشانه‌گذاری‌ها غیرفعال شده و سپس Code 39 مجدداً فعال می‌شود:

zbarcam --nodisplay -Sdisable -Scode39.enable

وضعیت خروج (EXIT STATUS)

دستور zbarcam یک کد خروج را برای نشان دادن وضعیت اجرای برنامه برمی‌گرداند. کدهای خروج فعلی عبارتند از:

0

اتمام موفقیت‌آمیز برنامه.

1

خطایی رخ داده است. این شامل آرگومان‌های نامعتبر و خطاهای ورودی/خروجی (I/O) است.

2

یک خطای مهلک رخ داده است.

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

zbarimg(1)

http://zbar.sf.net

اشکالات (BUGS)

مشاهده در http://sf.net/tracker/?group_id=189236&atid=928515

نویسنده (AUTHOR)

Jeff Brown <spadix@users.sourceforge.net>

توسعه‌دهنده اصلی

حق نشر (COPYRIGHT)

تمامی حقوق محفوظ است