نام (NAME)

zbarimg - اسکن و رمزگشایی بارکدها از فایل(های) تصویر

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

zbarimg [-qv] [--polygon] [--quiet] [--verbose[=n]]
{-dD | --display | --nodisplay | --xml | --noxml | -S[symbology.]config[=value] | --set [symbology.]config[=value] | image...}

zbarimg {-h | --help | --version}

توضیحات (DESCRIPTION)

به ازای هر فایل image مشخص‌شده، zbarimg تصویر را برای یافتن بارکدها اسکن کرده و هرگونه دادهٔ رمزگشایی‌شده را در stdout چاپ می‌کند. تصاویر همچنین می‌توانند به‌صورت اختیاری روی صفحه نمایش داده شوند.

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

توجه داشته باشید که در این زمینه، «image» به هر قالبی که توسط ImageMagick پشتیبانی می‌شود اشاره دارد، از جمله بسیاری از قالب‌های برداری مانند PDF و PostScript. به یاد داشته باشید که قالب‌های برداری پیش از اسکن به تصویر شطرنجی (رستر) تبدیل می‌شوند؛ برای جلوگیری از آسیب دیدن ناخواستهٔ بیت‌مپ‌های بارکد جاسازی‌شده، تصاویر برداری را پیش از اسکن به‌صورت دستی رستر کنید.

گزینه‌ها (OPTIONS)

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

-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 برای همهٔ نشانه‌گذاری‌های مرتبط اعمال می‌شود. پیکربندی‌های شناخته‌شدهٔ کنونی عبارتند از موارد زیر. افزودن پیشوند «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 برابر 6 و برای code39 برابر 1 است (مطابق توصیهٔ تشخیص خودکار Code 39)؛ برای سایر موارد پیش‌فرض 0 است

x-density=n, y-density=n

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

--polygon

نقاط چندضلعی دربرگیرندهٔ بارکد را در خروجی چاپ می‌کند. با استفاده از قالبی سازگار با عنصر <polygon> در زبان نشانه‌گذاری گرافیک برداری مقیاس‌پذیر (SVG) -q, --quiet

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

-d, --display, -D, --nodisplay

فعال/غیرفعال کردن نمایش فایل‌های image بعدی، تا زمانی که به --display یا --nodisplay بعدی برخورد شود. این گزینه می‌تواند چندین بار برای فعال‌سازی نمایش تصاویر مشخصی تکرار شود. نمایش تصویر به‌طور پیش‌فرض غیرفعال است.

--xml, --noxml

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

--raw

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

مثال‌ها (EXAMPLES)

اسکن یک تصویر PNG از نماد بارکد UPC و ارسال داده‌های حاصل به اسکریپتی که کد را در یک پایگاه داده جستجو کرده و عملیات مفیدی روی آن انجام می‌دهد:

zbarimg product.png | upcrpc.py

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

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

zbarimg --display -Si25.disable label.jpg

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

zbarimg --xml -Sdisable -Scode39.enable scan.tiff

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

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

0

بارکدها در تمام تصاویر با موفقیت شناسایی شدند. ممکن است هشدارهایی تولید شده باشد، اما هیچ خطایی رخ نداده است.

1

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

2

خطای مهلک ImageMagick.

3

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

4

در یک یا چند تصویر هیچ بارکدی شناسایی نشد. خطای دیگری رخ نداده است.

zbarcam(1)

http://zbar.sf.net

گزارش باگ‌ها (BUGS)

به نشانی زیر مراجعه کنید: http://sf.net/tracker/?group_id=189236&atid=928515

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

Jeff Brown <spadix@users.sourceforge.net>

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

کپی‌رایت و تکثیر (COPYRIGHT)

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