'\" t
.\"     Title: zbarimg
.\"    Author: Jeff Brown <spadix@users.sourceforge.net>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2017-04-11
.\"    Manual: ZBar Barcode Reader
.\"    Source: zbar-0.23.93
.\"  Language: Persian
.\"
.TH "ZBARIMG" "1" "2017-04-11" "zbar-0.23.93" "ZBar Barcode Reader"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
zbarimg \- اسکن و رمزگشایی بارکدها از فایل(های) تصویر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBzbarimg\fR\ 'u
\fBzbarimg\fR [\fB\-qv\fR] [\fB\-\-polygon\fR] [\fB\-\-quiet\fR] [\fB\-\-verbose\fR\fB[=\fIn\fR]\fR]
.br
{\fB\-dD\fR | \fB\-\-display\fR | \fB\-\-nodisplay\fR | \fB\-\-xml\fR | \fB\-\-noxml\fR | \fB\-S\fR\fB[\fIsymbology\fR\&.]\fR\fB\fIconfig\fR\fR\fB[=\fIvalue\fR]\fR | \fB\-\-set\ \fR\fB[\fIsymbology\fR\&.]\fR\fB\fIconfig\fR\fR\fB[=\fIvalue\fR]\fR | \fIimage\fR...}
.HP \w'\fBzbarimg\fR\ 'u
\fBzbarimg\fR {\fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR}
.SH "توضیحات (DESCRIPTION)"
.PP
به ازای هر فایل
\fIimage\fR
مشخص‌شده،
\fBzbarimg\fR
تصویر را برای یافتن بارکدها اسکن کرده و هرگونه دادهٔ رمزگشایی‌شده را در stdout چاپ می‌کند\&. تصاویر همچنین می‌توانند به‌صورت اختیاری روی صفحه نمایش داده شوند\&.
.PP
کتابخانهٔ زیربنایی در حال حاضر از نشانه‌گذاری‌های (symbologies) EAN\-13 (شامل زیرمجموعه‌های UPC و ISBN)، EAN\-8، DataBar، DataBar Expanded، Code 128، Code 93، Code 39، Codabar، Interleaved 2 of 5 و QR Code پشتیبانی می‌کند\&. نوع دقیق هر نماد شناسایی‌شده همراه با داده‌های رمزگشایی‌شده چاپ می‌شود\&.
.PP
توجه داشته باشید که در این زمینه، «\fIimage\fR» به هر قالبی که توسط ImageMagick پشتیبانی می‌شود اشاره دارد، از جمله بسیاری از قالب‌های برداری مانند PDF و PostScript\&. به یاد داشته باشید که قالب‌های برداری پیش از اسکن به تصویر شطرنجی (رستر) تبدیل می‌شوند؛ برای جلوگیری از آسیب دیدن ناخواستهٔ بیت‌مپ‌های بارکد جاسازی‌شده، تصاویر برداری را پیش از اسکن به‌صورت دستی رستر کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
این برنامه از شیوه‌نگارش معمول خط فرمان گنو پیروی می‌کند\&. گزینه‌های تک‌حرفی می‌توانند با هم ترکیب شوند و گزینه‌های طولانی با دو خط تیره (`\-\*(Aq) آغاز می‌شوند\&.
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
چاپ یک پیام راهنمای کوتاه در توصیف گزینه‌های خط فرمان در خروجی استاندارد و خروج
.RE
.PP
\fB\-\-version\fR
.RS 4
چاپ اطلاعات نسخهٔ برنامه در خروجی استاندارد و خروج
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR\fB[=\fIn\fR]\fR
.RS 4
افزایش سطح خروجی اشکال‌زدایی\&. استفادهٔ چندباره از گزینهٔ
\fB\-v\fR
خروجی پرحرف‌تری تولید می‌کند\&. همچنین می‌توان با مشخص کردن
\fIn\fR
سطح اشکال‌زدایی را مستقیماً تعیین کرد
.RE
.PP
\fB\-S\fR\fB[\fIsymbology\fR\&.]\fR\fB\fIconfig\fR\fR\fB[=\fIvalue\fR]\fR, \fB\-\-set \fR\fB[\fIsymbology\fR\&.]\fR\fB\fIconfig\fR\fR\fB[=\fIvalue\fR]\fR
.RS 4
تنظیم گزینهٔ پیکربندی رمزگشا
\fIconfig\fR
برای
\fIsymbology\fR
به مقدار
\fIvalue\fR\&.
در صورت حذف، مقدار پیش‌فرض
\fIvalue\fR
برابر ۱ است\&.
\fIsymbology\fR
یکی از موارد
\fBean13\fR،
\fBean8\fR،
\fBupca\fR،
\fBupce\fR،
\fBisbn13\fR،
\fBisbn10\fR،
\fBi25\fR،
\fBcodabar\fR،
\fBcode39\fR،
\fBcode93\fR،
\fBcode128\fR،
\fBqrcode\fR
یا مقدار ویژهٔ
\fB*\fR
است\&. اگر
\fIsymbology\fR
حذف شود یا
\fB*\fR
باشد،
\fIconfig\fR
برای همهٔ نشانه‌گذاری‌های مرتبط اعمال می‌شود\&. پیکربندی‌های شناخته‌شدهٔ کنونی عبارتند از موارد زیر\&. افزودن پیشوند «no\-» به ابتدای یک پیکربندی آن را نقیض (غیرفعال) می‌کند\&. همهٔ پیکربندی‌ها برای هر نشانه‌گذاری مناسب نیستند\&.
.PP
\fBenable\fR
.RS 4
کنترل رمزگشایی/گزارش یک نشانه‌گذاری\&. برای نشانه‌گذاری‌هایی که صرفاً زیرمجموعه‌ای از
\fBean13\fR
هستند
(\fBupca\fR،
\fBupce\fR،
\fBisbn13\fR،
\fBisbn10\fR)،
این پیکربندی کنترل می‌کند که آیا زیرمجموعه‌ها به همین عنوان شناسایی و گزارش شوند یا خیر\&. این حالت‌های خاص به‌طور پیش‌فرض غیرفعال هستند، در حالی که سایر نشانه‌گذاری‌ها به‌طور پیش‌فرض فعال‌اند
.RE
.PP
\fBdisable\fR
.RS 4
متضاد
\fBenable\fR
.RE
.PP
\fBemit\-check\fR
.RS 4
کنترل اینکه آیا ارقام کنترلی در خروجی رمزگشایی‌شده گنجانده شوند یا خیر\&. به‌طور پیش‌فرض فعال است\&. این پیکربندی برای
\fBcode128\fR
که هرگز رقم کنترلی را برنمی‌گرداند اعمال نمی‌شود\&. همچنین برای مواردی که رقم کنترلی غیرفعال شده است کاربرد ندارد (نگاه کنید به
\fBadd\-check\fR)\&.
ارقام کنترلی در حال حاضر برای
\fBi25\fR
یا
\fBcode39\fR
پیاده‌سازی نشده‌اند
.RE
.PP
\fBadd\-check\fR
.RS 4
فعال‌سازی رمزگشایی و اعتبارسنجی رقم کنترلی برای نشانه‌گذاری‌هایی که در آن‌ها اختیاری است: این شامل
\fBcode39\fR
و
\fBi25\fR
می‌شود، هرچند هیچ‌کدام از آن‌ها هنوز رقم کنترلی را پیاده‌سازی نکرده‌اند
.RE
.PP
\fBascii\fR
.RS 4
فعال‌سازی توالی‌های گریز (escape sequences) که کل مجموعه نویسه‌های ASCII را کدگذاری می‌کنند\&. این مورد برای
\fBcode39\fR
کاربرد خواهد داشت، با این استثنا که آن هم هنوز پیاده‌سازی نشده است\&.\&.\&.
.RE
.PP
\fBposition\fR
.RS 4
فعال‌سازی جمع‌آوری اطلاعات موقعیت نماد\&. به‌طور پیش‌فرض فعال است\&. در حال حاضر اطلاعات موقعیت غیرقابل استفاده است، بنابراین می‌توانید با غیرفعال کردن آن، در مصرف چرخه‌های پردازشی صرفه‌جویی کنید\&.
.RE
.PP
\fBtest\-inverted\fR
.RS 4
به‌ویژه برای تصاویر کدهای QR، گاهی تصویر معکوس است؛ به عنوان مثال خطوط به‌جای سیاه با رنگ سفید کشیده شده‌اند\&. این گزینه باعث می‌شود که ZBar در صورت ناموفق بودن در حالت عادی، تصویر را معکوس کرده و دوباره پردازش کند\&. فعال‌سازی آن روی همهٔ رمزگشاها تأثیر می‌گذارد\&.
.RE
.PP
\fBmin\-length=\fR\fB\fIn\fR\fR, \fBmax\-length=\fR\fB\fIn\fR\fR
.RS 4
محدود کردن تعداد نویسه‌های رمزگشایی‌شده در یک نماد معتبر\&. اگر نتیجهٔ رمزگشایی خارج از محدودهٔ min/max تعیین‌شده باشد (به‌صورت فراگیر)، گزارش نخواهد شد\&. برای غیرفعال کردن بررسی مربوطه، آن را روی 0 تنظیم کنید\&. این تنظیم برای نشانه‌گذاری‌های با طول متغیر اعمال می‌شود:
\fBi25\fR،
\fBcodabar\fR،
\fBcode39\fR،
\fBcode128\fR
و
\fBpdf417\fR\&.
مقدار پیش‌فرض
\fBmin\-length\fR
برای
\fBi25\fR
برابر 6 و برای
\fBcode39\fR
برابر 1 است (مطابق توصیهٔ تشخیص خودکار Code 39)؛ برای سایر موارد پیش‌فرض 0 است
.RE
.PP
\fBx\-density=\fR\fB\fIn\fR\fR, \fBy\-density=\fR\fB\fIn\fR\fR
.RS 4
تنظیم تراکم پیمایش‌های اسکنر\&. مقادیر کمتر بخش بیشتری از تصویر را به قیمت کاهش کارایی اسکن می‌کنند\&. تنظیم روی 0 اسکن در امتداد آن محور را غیرفعال می‌کند\&. مقدار پیش‌فرض هر دو 1 است\&.
.RE
.RE
.PP
\fB\-\-polygon\fR
.RS 4
نقاط چندضلعی دربرگیرندهٔ بارکد را در خروجی چاپ می‌کند\&. با استفاده از قالبی سازگار با عنصر <polygon> در زبان نشانه‌گذاری گرافیک برداری مقیاس‌پذیر (SVG)
.RE.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
عملیات بی‌صدا؛ فقط داده‌های نماد رمزگشایی‌شده را خروجی می‌دهد\&. به‌طور مشخص، این گزینه سطر آماری چاپ‌شده (در stderr) پیش از خروج و همچنین پیام هشداری که در صورت نیافتن هیچ بارکدی در تصویر چاپ می‌شود (آن هم در stderr) را غیرفعال می‌کند\&.
.RE
.PP
\fB\-d\fR, \fB\-\-display\fR, \fB\-D\fR, \fB\-\-nodisplay\fR
.RS 4
فعال/غیرفعال کردن نمایش فایل‌های
\fIimage\fR
بعدی، تا زمانی که به
\fB\-\-display\fR
یا
\fB\-\-nodisplay\fR
بعدی برخورد شود\&. این گزینه می‌تواند چندین بار برای فعال‌سازی نمایش تصاویر مشخصی تکرار شود\&. نمایش تصویر به‌طور پیش‌فرض غیرفعال است\&.
.RE
.PP
\fB\-\-xml\fR, \fB\-\-noxml\fR
.RS 4
فعال/غیرفعال کردن خروجی نتایج در قالب XML\&. این قالب داده‌های خام نماد را به همراه اطلاعات اسکن (مانند شماره صفحات) در قالبی با تجزیه آسان قرار می‌دهد\&. آخرین طرح‌واره (schema) در این نشانی در دسترس است:
\m[blue]\fB\%http://zbar.sourceforge.net/2008/barcode.xsd\fR\m[]\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
فعال‌سازی خروجی داده‌های خام نماد\&. این قالب داده‌های نماد را جداشده با خط جدید (newline) و بدون اطلاعات اضافی نوع نمادشناسی که به‌طور پیش‌فرض چاپ می‌شود، نمایش می‌دهد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
اسکن یک تصویر PNG از نماد بارکد UPC و ارسال داده‌های حاصل به اسکریپتی که کد را در یک پایگاه داده جستجو کرده و عملیات مفیدی روی آن انجام می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBzbarimg\fR product\&.png | \fBupcrpc\&.py\fR
.fi
.if n \{\
.RE
.\}
.sp
اسکریپت نمونه‌ی
\fBupcrpc\&.py\fR
که در زیرپوشه‌ی
examples/
توزیع قرار دارد، یک فراخوانی XMLRPC به یک پایگاه داده اینترنتی معروف UPC انجام داده و در صورت پیدا شدن، شرح محصول را چاپ می‌کند\&.
.PP
اسکن یک تصویر JPEG شامل چند بارکد و نمایش تصویر در یک پنجره، به همراه غیرفعال کردن شناسایی کدهای Interleaved 2 of 5 برای جلوگیری از تداخل با سایر نمادشناسی‌ها یا نویز پس‌زمینه:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBzbarimg\fR \fB\-\-display\fR \fB\-Si25\&.disable\fR label\&.jpg
.fi
.if n \{\
.RE
.\}
.PP
جستجو در یک سند اسکن‌شده فقط برای یافتن Code 39 با استفاده از قالب خروجی XML تا شماره صفحات در دسترس باشند\&. برای فعال‌سازی فقط Code 39، ابتدا تمامی نمادشناسی‌ها غیرفعال شده و سپس Code 39 دوباره فعال می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBzbarimg\fR \fB\-\-xml\fR \fB\-Sdisable\fR \fB\-Scode39\&.enable\fR scan\&.tiff
.fi
.if n \{\
.RE
.\}
.sp
.SH "وضعیت خروج (EXIT STATUS)"
.PP
دستور
\fBzbarimg\fR
یک کد خروج برای نشان دادن وضعیت اجرای برنامه برمی‌گرداند\&. کدهای خروج فعلی عبارتند از:
.PP
0
.RS 4
بارکدها در تمام تصاویر با موفقیت شناسایی شدند\&. ممکن است هشدارهایی تولید شده باشد، اما هیچ خطایی رخ نداده است\&.
.RE
.PP
1
.RS 4
هنگام پردازش برخی از تصویر(ها) خطایی رخ داد\&. این شامل آرگومان‌های نامعتبر، خطاهای I/O و خطاهای مدیریت تصویر از سوی ImageMagick است\&.
.RE
.PP
2
.RS 4
خطای مهلک ImageMagick\&.
.RE
.PP
3
.RS 4
کاربر پیش از اسکن تمام تصاویر از برنامه خارج شد\&. این حالت فقط هنگام اجرا در حالت تعاملی (با
\fB\-\-display\fR)
رخ می‌دهد\&.
.RE
.PP
4
.RS 4
در یک یا چند تصویر هیچ بارکدی شناسایی نشد\&. خطای دیگری رخ نداده است\&.
.RE.SH "همچنین ببینید (SEE ALSO)"
.PP
zbarcam(1)
.PP
\m[blue]\fB\%http://zbar.sf.net\fR\m[]
.SH "گزارش باگ‌ها (BUGS)"
.PP
به نشانی زیر مراجعه کنید:
\m[blue]\fB\%http://sf.net/tracker/?group_id=189236&atid=928515\fR\m[]
.SH "نویسندگان (AUTHORS)"
.PP
\fBJeff Brown\fR <\&spadix@users.sourceforge.net\&>
.RS 4
توسعه‌دهنده اصلی
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
کپی‌رایت \(co 2007-2010 Jeff Brown
.br
.PP
تمامی حقوق محفوظ است.
.sp