'\" t
.\"     Title: zbarcam
.\"    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 "ZBARCAM" "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)"
zbarcam \- پویش و رمزگشایی بارکدها از یک دستگاه ویدیویی
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBzbarcam\fR\ 'u
\fBzbarcam\fR [\fB\-qv\fR] [\fB\-\-quiet\fR] [\fB\-\-nodisplay\fR] [\fB\-\-xml\fR] [\fB\-\-verbose\fR\fB[=\fIn\fR]\fR] [\fB\-\-prescale=\fR\fB\fIW\fR\fR\fBx\fR\fB\fIH\fR\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] [\fIdevice\fR]
.HP \w'\fBzbarcam\fR\ 'u
\fBzbarcam\fR {\fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR}
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBzbarcam\fR
یک منبع ویدیویی video4linux (مانند وب‌کم) را برای یافتن بارکدها پویش کرده و هر داده رمزگشایی‌شده را در خروجی استاندارد چاپ می‌کند\&. جریان ویدیویی نیز روی صفحه نمایش داده می‌شود\&.
.PP
شناسه
\fIdevice\fR
مسیر پرونده ویژه دستگاه نویسه‌ای video4linux (نسخه ۱ یا ۲) است (شماره اصلی ۸۱ و شماره فرعی ۰ تا ۶۳)\&. مقدار پیش‌فرض آن
/dev/video0
است\&.
.PP
کتابخانه زیربنایی در حال حاضر از نشانه‌گذاری‌های EAN\-13 (شامل زیرمجموعه‌های UPC و ISBN)، EAN\-8، DataBar، DataBar Expanded، Code 128، Code 93، Code 39، Codabar، Interleaved 2 of 5 و QR Code پشتیبانی می‌کند\&. نوع دقیق هر نماد شناسایی‌شده همراه با داده‌های رمزگشایی‌شده چاپ می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
این برنامه از ساختار معمول خط فرمان گنو (GNU) پیروی می‌کند\&. گزینه‌های تک‌حرفی می‌توانند با هم ترکیب شوند و گزینه‌های طولانی با دو خط تیره (`\-\*(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
برای تمامی نشانه‌گذاری‌های سازگار اعمال خواهد شد\&. موارد زیر
\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
برابر با ۶ و برای
\fBcode39\fR
برابر با ۱ است
(بر اساس توصیه تشخیص خودکار 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\-q\fR, \fB\-\-quiet\fR
.RS 4
عملکرد بی‌صدا؛ غیرفعال کردن صدای بوق شنیداری که در حالت عادی هنگام رمزگشایی نماد پخش می‌شود
.RE
.PP
\fB\-\-nodisplay\fR
.RS 4
غیرفعال کردن پنجره ویدیویی خروجی\&. ورودی ویدیویی تا زمان متوقف شدن برنامه یا دریافت سیگنال دیگر پویش خواهد شد
.RE
.PP
\fB\-\-xml\fR
.RS 4
ارسال نتایج با ساختار خروجی XML به‌صورت جریانی (Stream)\&. این ساختار، داده‌های خام نماد را همراه با اطلاعات مربوط به پویش در قالبی با قابلیت تجزیه آسان بسته‌بندی می‌کند\&. جدیدترین طرح‌واره (اسکیما) در پیوند زیر در دسترس است:
\m[blue]\fB\%http://zbar.sourceforge.net/2008/barcode.xsd\fR\m[]
.RE
.PP
\fB\-\-raw\fR
.RS 4
استفاده از ساختار خروجی داده‌های خام نماد\&. این ساختار داده‌های نماد را با خطوط جدید از هم جدا کرده و بدون اطلاعات اضافی نوع نشانه‌گذاری که به‌طور پیش‌فرض چاپ می‌شود، نمایش می‌دهد
.RE
.PP
\fB\-\-prescale=\fR\fB\fIW\fR\fR\fBx\fR\fB\fIH\fR\fR
.RS 4
درخواست مقیاس‌بندی ورودی ویدیویی از درایور دوربین\&. برای کوچک کردن فریم‌های بزرگ به‌منظور دستیابی به نرخ فریم بالاتر مفید است\&. توجه داشته باشید که درایور ممکن است درخواست مقیاس‌بندی را تنظیم کند یا به‌طور کامل نادیده بگیرد
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
پویش بارکدها با استفاده از دستگاه ویدیویی دوم و هدایت داده‌های به‌دست‌آمده از طریق لوله (pipe) به یک اسکریپت که هر کد را در پایگاه داده جستجو کرده و عملیات مفیدی روی آن‌ها انجام می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBzbarcam\fR /dev/video1 | \fBupcrpc\&.py\fR
.fi
.if n \{\
.RE
.\}
.sp
اسکریپت نمونه
\fBupcrpc\&.py\fR
موجود در زیرپوشه
examples/
توزیع، یک فراخوانی XMLRPC به یک پایگاه داده معروف اینترنتی UPC انجام داده و در صورت پیدا شدن، توضیحات محصول را چاپ می‌کند\&.
.PP
پویش بارکدها با استفاده از دستگاه ویدیویی پیش‌فرض و ارسال نتایج به خروجی استاندارد با قالب XML، همراه با غیرفعال کردن شناسایی کدهای Interleaved 2 of 5 جهت جلوگیری از تداخل با دیگر نشانه‌گذاری‌ها یا نویز پس‌زمینه:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBzbarcam\fR \fB\-\-xml\fR \fB\-Si25\&.disable\fR
.fi
.if n \{\
.RE
.\}
.PP
پویش منحصراً برای Code 39 بدون استفاده از پنجره پیش‌نمایش \- شاید برای یک سیستم نصب‌شده ثابت\&. برای فعال‌سازی اختصاصی Code 39، ابتدا تمام نشانه‌گذاری‌ها غیرفعال شده و سپس Code 39 مجدداً فعال می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
\fBzbarcam\fR \fB\-\-nodisplay\fR \fB\-Sdisable\fR \fB\-Scode39\&.enable\fR
.fi
.if n \{\
.RE
.\}
.sp
.SH "وضعیت خروج (EXIT STATUS)"
.PP
دستور
\fBzbarcam\fR
یک کد خروج را برای نشان دادن وضعیت اجرای برنامه برمی‌گرداند\&. کدهای خروج فعلی عبارتند از:
.PP
0
.RS 4
اتمام موفقیت‌آمیز برنامه\&.
.RE
.PP
1
.RS 4
خطایی رخ داده است\&. این شامل آرگومان‌های نامعتبر و خطاهای ورودی/خروجی (I/O) است\&.
.RE
.PP
2
.RS 4
یک خطای مهلک رخ داده است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
zbarimg(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 "نویسنده (AUTHOR)"
.PP
\fBJeff Brown\fR <\&spadix@users.sourceforge.net\&>
.RS 4
توسعه‌دهنده اصلی
.RE
.SH "حق نشر (COPYRIGHT)"
.br
کپی‌رایت \(co 2007-2010 Jeff Brown
.br
.PP
تمامی حقوق محفوظ است
.sp