.\" Automatically generated by Pandoc 3.8.3 .\" .TH "ZINT" "1" "December 2025" "Version 2.16.0" .SH "نام (NAME)" \f[CR]zint\f[R] \- کدگذاری داده‌ها به صورت تصویر بارکد .SH "خلاصه دستور (SYNOPSIS)" .PP \f[CR]zint\f[R] [\f[CR]\-h\f[R] | \f[CR]\-\-help\f[R]] .PD 0 .P .PD \f[CR]zint\f[R] [\f[I]گزینه‌ها\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[CR]zint\f[R] داده‌های ورودی را از خط فرمان یا یک فایل برای کدگذاری در یک بارکد دریافت می‌کند، که سپس در یک فایل تصویری خروجی داده می‌شود. .PP داده‌های ورودی UTF\-8 هستند، مگر اینکه \f[CR]\-\-binary\f[R] مشخص شده باشد. .PP متن خوانا برای انسان (HRT) به طور پیش‌فرض برای بارکدهایی که از HRT پشتیبانی می‌کنند نمایش داده می‌شود، مگر اینکه \f[CR]\-\-notext\f[R] مشخص شده باشد. .PP فایل تصویری خروجی (مشخص‌شده با \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R]) می‌تواند در یکی از این قالب‌ها باشد: Windows Bitmap (\f[CR]BMP\f[R])، Enhanced Metafile Format (\f[CR]EMF\f[R])، Encapsulated PostScript (\f[CR]EPS\f[R])، Graphics Interchange Format (\f[CR]GIF\f[R])، ZSoft Paintbrush (\f[CR]PCX\f[R])، Portable Network Format (\f[CR]PNG\f[R])، Scalable Vector Graphic (\f[CR]SVG\f[R])، یا Tagged Image File Format (\f[CR]TIF\f[R]). .SH "گزینه‌ها (OPTIONS)" .TP \f[CR]\-h\f[R], \f[CR]\-\-help\f[R] چاپ اطلاعات نحوه استفاده در خلاصه‌ای از گزینه‌های خط فرمان. .TP \f[CR]\-b TYPE\f[R], \f[CR]\-\-barcode=TYPE\f[R] تنظیم نمادشناسی (symbology) بارکد که برای کدگذاری داده‌ها استفاده خواهد شد. \f[I]TYPE\f[R] شماره یا نام نمادشناسی بارکد است. اگر داده نشود، نمادشناسی به صورت پیش‌فرض 20 (Code 128) خواهد بود. برای مشاهدهٔ نوع‌های موجود، از گزینهٔ \f[CR]\-t\f[R] | \f[CR]\-\-types\f[R] استفاده کنید. نام انواع به بزرگ و کوچک بودن حروف حساس نیستند و نویسه‌های غیرالفبایی\-عددی نادیده گرفته می‌شوند. .TP \f[CR]\-\-addongap=INTEGER\f[R] برای نمادشناسی‌های EAN/UPC، فاصله بین داده‌های اصلی و بخش الحاقی (add\-on) را تنظیم می‌کند. \f[I]INTEGER\f[R] بر حسب مضارب صحیحی از بُعد X است. بیشترین فاصله‌ای که می‌توان تعیین کرد ۱۲ است. کمترین مقدار ۷ است، به جز برای UPC\-A که در آن کمترین مقدار ۹ است. .TP \f[CR]\-\-batch\f[R] رفتار با هر خط از فایل ورودی مشخص‌شده با \f[CR]\-i\f[R] | \f[CR]\-\-input\f[R] به عنوان یک مجموعه دادهٔ جداگانه و تولید یک تصویر بارکد برای هر یک از آن‌ها. تصاویر بارکد به طور پیش‌فرض در فایل‌هایی با نام‌های شماره‌گذاری‌شده با شروع از \(lq00001.png\(rq، \(lq00002.png\(rq و غیره خروجی داده می‌شوند که این نام‌ها را می‌توان با استفاده از گزینهٔ \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R] تغییر داد. .TP \f[CR]\-\-bg=COLOUR\f[R] مشخص کردن رنگ پس‌زمینه (کاغذ) که در آن \f[I]COLOUR\f[R] در قالب شانزده‌شانزدهی \f[CR]RRGGBB\f[R] یا \f[CR]RRGGBBAA\f[R] یا در قالب درصدهای ده‌دهی \f[CR]C,M,Y,K\f[R] است. .TP \f[CR]\-\-binary\f[R] رفتار با داده‌های ورودی به عنوان داده‌های باینری ۸\-بیتی خام به جای UTF\-8 پیش‌فرض. ترجمه خودکار جدول کد (code page) به یک صفحهٔ ECI غیرفعال می‌شود و هیچ اعتبارسنجی روی رمزگذاری نویسه‌های داده انجام نمی‌گیرد. .TP \f[CR]\-\-bind\f[R] افزودن نوارهای مرزی افقی (که با نام bearer bars نیز شناخته می‌شوند) به نماد. عرض نوارهای مرزی توسط گزینهٔ \f[CR]\-\-border\f[R] مشخص می‌شود. \f[CR]\-\-bind\f[R] همچنین می‌تواند برای افزودن نوارهای جداکننده سطر به نمادهای پشته‌شده با چندین ورودی \f[CR]\-d\f[R] | \f[CR]\-\-data\f[R] استفاده شود، که در این حالت عرض نوارهای جداکننده با گزینهٔ \f[CR]\-\-separator\f[R] مشخص می‌شود. .TP \f[CR]\-\-bindtop\f[R] افزودن یک نوار مرزی افقی به بالای نماد. عرض نوار مرزی با گزینهٔ \f[CR]\-\-border\f[R] مشخص می‌شود. .TP \f[CR]\-\-bold\f[R] استفاده از قلم پررنگ (bold) برای متن خوانا برای انسان (HRT). .TP \f[CR]\-\-border=INTEGER\f[R] تنظیم عرض نوارهای مرزی (\f[CR]\-\-bind\f[R] یا \f[CR]\-\-bindtop\f[R]) یا کادر دور نماد (\f[CR]\-\-box\f[R])، که در آن \f[I]INTEGER\f[R] به صورت مضارب صحیحی از بُعد X است. پیش‌فرض صفر است. .TP \f[CR]\-\-box\f[R] افزودن یک کادر (جعبه) در اطراف نماد. عرض کادرها با گزینهٔ \f[CR]\-\-border\f[R] مشخص می‌شود. .TP \f[CR]\-\-cmyk\f[R] استفاده از فضای رنگی CMYK هنگام خروجی گرفتن در فایل‌های Encapsulated PostScript (EPS) یا TIF. .TP \f[CR]\-\-cols=INTEGER\f[R] تنظیم تعداد ستون‌های داده در نماد بر روی \f[I]INTEGER\f[R]. روی نمادهای Codablock\-F، DotCode، GS1 DataBar Expanded Stacked (DBAR_EXPSTK)، MicroPDF417 و PDF417 تأثیر می‌گذارد. .TP \f[CR]\-\-compliantheight\f[R] هشدار در صورتی که ارتفاع مشخص‌شده توسط گزینهٔ \f[CR]\-\-height\f[R] با مشخصات استاندارد بارکد سازگار نباشد؛ یا در صورتی که \f[CR]\-\-height\f[R] داده نشود، پیش‌فرض قرار دادن ارتفاع تعیین‌شده در مشخصات استاندارد (در صورت وجود). .TP \f[CR]\-d\f[R], \f[CR]\-\-data=DATA\f[R] مشخص کردن \f[I]DATA\f[R] ورودی برای کدگذاری. می‌توان از گزینهٔ \f[CR]\-\-esc\f[R] برای وارد کردن نویسه‌های غیرقابل‌چاپ با استفاده از توالی‌های گریز استفاده کرد. \f[I]DATA\f[R] باید به صورت UTF\-8 باشد، مگر اینکه گزینهٔ \f[CR]\-\-binary\f[R] داده شده باشد که در آن صورت می‌تواند هر چیزی باشد. .TP \f[CR]\-\-direct\f[R] ارسال خروجی به stdout، که در بیشتر موارد باید به یک لوله (pipe) یا یک فایل هدایت شود. از \f[CR]\-\-filetype\f[R] برای تعیین قالب خروجی استفاده کنید. .TP \f[CR]\-\-dmiso144\f[R] برای نمادهای Data Matrix، استفاده از جانمایی استاندارد کلمه‌کد (codeword) بر اساس ISO/IEC برای نمادهای با اندازهٔ 144 x 144 (\f[CR]\-\-vers=24\f[R]) به جای جانمایی پیش‌فرض \(lqde facto\(rq (که جانمایی کلمه‌کدهای ECC را می‌چرخاند). .TP \f[CR]\-\-dmre\f[R] برای نمادهای Data Matrix، مجاز دانستن اندازه‌های Data Matrix Rectangular Extended (DMRE) هنگام در نظر گرفتن اندازه‌های خودکار. همچنین نگاه کنید به \f[CR]\-\-square\f[R]. .TP \f[CR]\-\-dotsize=NUMBER\f[R] تنظیم شعاع نقطه‌ها در حالت نقطه‌ای (\f[CR]\-\-dotty\f[R]). \f[I]NUMBER\f[R] بر حسب ابعاد X است و می‌تواند عدد اعشاری (ممیز شناور) باشد. پیش‌فرض 0.8 است. .TP \f[CR]\-\-dotty\f[R] استفاده از نقطه به جای مربع برای نمادهای ماتریسی. DotCode همواره در حالت نقطه‌ای است. .TP \f[CR]\-\-dump\f[R] تخلیهٔ (dump) یک نمایش شانزده‌شانزدهی از کدگذاری نماد در stdout. همین نمایش می‌تواند با استفاده از پسوند \f[CR].txt\f[R] به همراه \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R] یا با تعیین \f[CR]\-\-filetype=txt\f[R] در یک فایل خروجی داده شود. .TP \f[CR]\-e\f[R], \f[CR]\-\-ecinos\f[R] نمایش جدول ECIها (Extended Channel Interpretations). .TP \f[CR]\-\-eci=INTEGER\f[R] تنظیم کد ECI برای داده‌های ورودی بر روی \f[I]INTEGER\f[R]. برای دیدن فهرستی از ECIهای موجود به \f[CR]\-e\f[R] | \f[CR]\-\-ecinos\f[R] مراجعه کنید. ECIها توسط Aztec Code، Code One، Data Matrix، DotCode، Grid Matrix، Han Xin Code، MaxiCode، MicroPDF417، PDF417، QR Code، rMQR و Ultracode پشتیبانی می‌شوند. .TP \f[CR]\-\-embedfont\f[R] برای خروجی برداری، تعبیه کردن قلم در فایل به جهت سازگاری و حمل‌پذیری. در حال حاضر تنها برای خروجی SVG در دسترس است. .TP \f[CR]\-\-esc\f[R] پردازش نویسه‌های گریز (escape) در داده‌های ورودی. توالی‌های گریز عبارتند از: .RS .IP .EX \(rs0 (0x00) NUL Null character \(rsE (0x04) EOT End of Transmission \(rsa (0x07) BEL Bell \(rsb (0x08) BS Backspace \(rst (0x09) HT Horizontal Tab \(rsn (0x0A) LF Line Feed \(rsv (0x0B) VT Vertical Tab \(rsf (0x0C) FF Form Feed \(rsr (0x0D) CR Carriage Return \(rse (0x1B) ESC Escape \(rsG (0x1D) GS Group Separator \(rsR (0x1E) RS Record Separator \(rs( (0x28) ( Opening parenthesis (only with \-\-gs1parens) \(rs) (0x29) ) Closing parenthesis (only with \-\-gs1parens) \(rs\(rs (0x5C) \(rs Backslash \(rsdNNN (NNN) Any 8\-bit character where NNN is decimal (000\-255) \(rsoNNN (0oNNN) Any 8\-bit character where NNN is octal (000\-377) \(rsxNN (0xNN) Any 8\-bit character where NN is hexadecimal (00\-FF) \(rsuNNNN (U+NNNN) Any 16\-bit Unicode BMP character where NNNN is hexadecimal \(rsUNNNNNN (U+NNNNNN) Any 21\-bit Unicode character where NNNNNN is hexadecimal .EE .RE.TP \f[CR]\-\-extraesc\f[R] تنها برای Code 128، علاوه بر پردازش توالی‌های گریز عادی بالا، توالی‌های گریز ویژهٔ \f[CR]\(rs\(haA\f[R]، \f[CR]\(rs\(haB\f[R]، \f[CR]\(rs\(haC\f[R] و \f[CR]\(rs\(ha\(at\f[R] که امکان تعویض دستی Code Setها را فراهم می‌کنند، و توالی گریز ویژهٔ \f[CR]\(rs\(ha1\f[R] که نویسهٔ \f[CR]FNC1\f[R] را درج می‌کند، پردازش شوند. توالی \f[CR]\(rs\(at\f[R] تعویض دستی را غیرفعال می‌کند. توالی \f[CR]\(rs\(ha\(ha\f[R] می‌تواند برای کدگذاری داده‌هایی که شامل توالی‌های گریز ویژه هستند استفاده شود. .TP \f[CR]\-\-fast\f[R] استفاده از کدگذاری سریع‌تر اگرچه با بهینگی کمتر یا سایر میان‌برها (تنها بر Data Matrix، MicroPDF417، PDF417، QRCODE و UPNQR اثر می‌گذارد). .TP \f[CR]\-\-fg=COLOUR\f[R] مشخص کردن رنگ پیش‌زمینه (جوهر) که در آن \f[I]COLOUR\f[R] در قالب شانزده‌شانزدهی \f[CR]RRGGBB\f[R] یا \f[CR]RRGGBBAA\f[R] یا در قالب درصدهای دهدهی \f[CR]C,M,Y,K\f[R] است. .TP \f[CR]\-\-filetype=TYPE\f[R] تنظیم نوع فایل خروجی به \f[I]TYPE\f[R]، که یکی از موارد \f[CR]BMP\f[R]، \f[CR]EMF\f[R]، \f[CR]EPS\f[R]، \f[CR]GIF\f[R]، \f[CR]PCX\f[R]، \f[CR]PNG\f[R]، \f[CR]SVG\f[R]، \f[CR]TIF\f[R] یا \f[CR]TXT\f[R] است. .TP \f[CR]\-\-fullmultibyte\f[R] استفاده از حالت‌های چندبایتی Grid Matrix، Han Xin و QR Code برای داده‌های غیر ASCII. .TP \f[CR]\-\-gs1\f[R] در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1. شناسه‌های کاربردی (AIs یا Application Identifiers) باید درون قلاب‌های \f[CR]\(dq[]\(dq\f[R] قرار گیرند (اما گزینهٔ \f[CR]\-\-gs1parens\f[R] را نیز ببینید). همچنین URIهای GS1 Digital Link (تأییدنشده) را برای نمادشناسی‌های ماتریسی می‌پذیرد. .TP \f[CR]\-\-gs1nocheck\f[R] در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1 (مانند \f[CR]\-\-gs1\f[R]) اما بدون بررسی درستی و اعتبار داده‌ها. .TP \f[CR]\-\-gs1parens\f[R] در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1 (مانند \f[CR]\-\-gs1\f[R]) اما پردازش پرانتزها \f[CR]\(dq()\(dq\f[R] به عنوان جداکننده‌های AI در GS1 به جای قلاب‌های \f[CR]\(dq[]\(dq\f[R]. اگر داده‌های AI شامل پرانتز باز باشند، باید با بک‌اسلش آورده شوند (\f[CR]\(dq\(rs(\(dq\f[R]). .TP \f[CR]\-\-gs1strict\f[R] در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1 (مانند \f[CR]\-\-gs1\f[R]) و استفاده از GS1 Syntax Engine (در صورت موجود بودن) برای اعتبارسنجی دقیق داده‌های GS1، شامل URIهای GS1 Digital Link. اگر \f[CR]\-\-gs1nocheck\f[R] نیز مشخص شده باشد، این گزینه نادیده گرفته می‌شود. .TP \f[CR]\-\-gssep\f[R] برای Data Matrix در حالت GS1، استفاده از \f[CR]GS\f[R] (0x1D) به عنوان جداکنندهٔ داده‌های GS1 به جای \f[CR]FNC1\f[R]. .TP \f[CR]\-\-guarddescent=NUMBER\f[R] برای نمادهای EAN/UPC، تنظیم ارتفاعی که میله‌های محافظ (guard bars) به زیر میله‌های اصلی امتداد می‌یابند، که در آن \f[I]NUMBER\f[R] بر حسب ابعاد X (X\-dimensions) است. \f[I]NUMBER\f[R] می‌تواند ممیز شناور باشد. .TP \f[CR]\-\-guardwhitespace\f[R] برای نمادهای EAN/UPC، افزودن نشانگرهای ناحیهٔ آرام \f[CR]\(dq<\(dq\f[R] و/یا \f[CR]\(dq>\(dq\f[R] به HRT در صورت امکان. .TP \f[CR]\-\-height=NUMBER\f[R] تنظیم ارتفاع نماد بر حسب ابعاد X. \f[I]NUMBER\f[R] می‌تواند ممیز شناور باشد. .TP \f[CR]\-\-heightperrow\f[R] در نظر گرفتن ارتفاع به صورت به‌ازای‌هر‌سطر. بر Codablock\-F، Code 16K، Code 49، GS1 DataBar Expanded Stacked (DBAR_EXPSTK)، MicroPDF417 و PDF417 اثر می‌گذارد. .TP \f[CR]\-i\f[R], \f[CR]\-\-input=FILE\f[R] خواندن داده‌های ورودی از \f[I]FILE\f[R]. برای خواندن از stdin، یک خط تیرهٔ تکی (\f[CR]\-\f[R]) را برای \f[I]FILE\f[R] مشخص کنید. .TP \f[CR]\-\-init\f[R] ایجاد یک نماد مقداردهی اولیهٔ خوانشگر (برنامه‌ریزی) (Reader Initialisation). .TP \f[CR]\-\-mask=INTEGER\f[R] تنظیم الگوی ماسک مورد استفاده برای DotCode، Han Xin یا QR Code به \f[I]INTEGER\f[R]، که انتخاب خودکار را لغو می‌کند. .TP \f[CR]\-\-mirror\f[R] استفاده از داده‌های دسته‌ای برای تعیین نام فایل در حالت دسته‌ای (\f[CR]\-\-batch\f[R]). گزینهٔ \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R] می‌تواند برای مشخص کردن یک دایرکتوری خروجی استفاده شود (هرگونه نام فایل نادیده گرفته خواهد شد). .TP \f[CR]\-\-mode=INTEGER\f[R] برای نمادهای MaxiCode و GS1 Composite، تنظیم حالت کدگذاری به \f[I]INTEGER\f[R]. .RS .PP برای MaxiCode (منظور از SCM، Structured Carrier Message با ۳ فیلد است: کد پستی، کد کشور ۳ رقمی بر اساس ISO 3166\-1، کد سرویس ۳ رقمی): .IP .EX 2 SCM با کد پستی عددی ۹ رقمی 3 SCM با کد پستی حرفی\-عددی ۶ نویسه‌ای 4 ECC بهبودیافته برای بخش اصلی پیام 5 ECC بهبودیافته برای تمام پیام 6 مقداردهی اولیهٔ خوانشگر (برنامه‌ریزی) .EE .PP برای نمادهای GS1 Composite (نام‌هایی که به \f[CR]_CC\f[R] ختم می‌شوند، یعنی \f[CR]EAN8_CC\f[R]، \f[CR]EAN13_CC\f[R]، \f[CR]GS1_128_CC\f[R]، \f[CR]DBAR_OMN_CC\f[R] و غیره): .IP .EX 1 CC\-A 2 CC\-B 3 CC\-C (تنها GS1_128_CC) .EE .RE .TP \f[CR]\-\-nobackground\f[R] حذف رنگ پس‌زمینه (تنها برای EMF، EPS، GIF، PNG، SVG و TIF). .TP \f[CR]\-\-noquietzones\f[R] غیرفعال کردن تمام نواحی آرام (quiet zones) برای نمادهایی که آن‌ها را به صورت پیش‌فرض تعریف کرده‌اند. .TP \f[CR]\-\-notext\f[R] حذف متن خوانا برای انسان (HRT یا Human Readable Text). .TP \f[CR]\-o\f[R], \f[CR]\-\-output=FILE\f[R] ارسال خروجی به \f[I]FILE\f[R]. هنگامی که در حالت دسته‌ای نباشد، مقدار پیش‌فرض \(lqout.png\(rq است (یا اگر zint بدون پشتیبانی از PNG ساخته شده باشد، \(lqout.gif\(rq). در حالت دسته‌ای (\f[CR]\-\-batch\f[R])، می‌توان از نویسه‌های ویژه برای قالب‌بندی نام فایل‌های خروجی استفاده کرد: .RS .IP .EX \(ti درج یک عدد یا 0 # درج یک عدد یا فاصله \(at درج یک عدد یا * (+ در Windows) سایر موارد درج به صورت لفظی .EE .RE .TP \f[CR]\-\-primary=STRING\f[R] برای MaxiCode، تنظیم محتوای پیام اولیه. برای نمادهای GS1 Composite، تنظیم محتوای نماد خطی. .TP \f[CR]\-\-quietzones\f[R] افزودن نواحی آرام منطبق با استاندارد برای نمادهایی که آن‌ها را تعیین کرده‌اند. این افزون بر هرگونه فضای خالی تعیین‌شده توسط \f[CR]\-w\f[R] | \f[CR]\-\-whitesp\f[R] یا \f[CR]\-\-vwhitesp\f[R] است. .TP \f[CR]\-r\f[R], \f[CR]\-\-reverse\f[R] معکوس کردن رنگ‌های پیش‌زمینه و پس‌زمینه (سفید روی سیاه). معروف به \(lqوارونگی بازتاب\(rq یا \(lqبازتاب وارونه\(rq. .TP \f[CR]\-\-rotate=INTEGER\f[R] چرخاندن نماد به میزان \f[I]INTEGER\f[R] درجه، که در آن \f[I]INTEGER\f[R] می‌تواند 0، 90، 270 یا 360 باشد. .TP \f[CR]\-\-rows=INTEGER\f[R] تنظیم تعداد سطرهای Codablock\-F یا PDF417 به \f[I]INTEGER\f[R]. همچنین حداقل تعداد سطرها برای Code 16K یا Code 49، و حداکثر تعداد سطرها برای GS1 DataBar Expanded Stacked (DBAR_EXPSTK) را تنظیم می‌کند. .TP \f[CR]\-\-scale=NUMBER\f[R] تنظیم اندازهٔ بعد X (X\-dimension). \f[I]NUMBER\f[R] می‌تواند ممیز شناور باشد، و قبل از اعمال (به جز برای MaxiCode) در 2 ضرب می‌شود. مقیاس پیش‌فرض 1 است. .RS .PP برای MaxiCode، مقیاس برای خروجی رستر در 10، برای خروجی EMF در 40، و در غیر این صورت در 2 ضرب می‌شود. .PP افزایش‌های 0.5 (نیمه‌صحیح) برای خروجی رستر غیر MaxiCode (شامل BMP، GIF، PCX، PNG و TIF) توصیه می‌شود. متن خوانا برای انسان (HRT) در خروجی رستر برای مقیاس‌های کمتر از 1 نمایش داده نخواهد شد..PP همچنین گزینهٔ \f[CR]\-\-scalexdimdp\f[R] در زیر را ببینید. .RE .TP \f[CR]\-\-scalexdimdp=X[,R]\f[R] تصویر را بر اساس بعد X با مقدار \f[I]X\f[R] و تفکیک‌پذیری \f[I]R\f[R] مقیاس‌بندی می‌کند، که در آن \f[I]X\f[R] بر حسب میلی‌متر و \f[I]R\f[R] بر حسب dpmm (نقطه در میلی‌متر) است. \f[I]X\f[R] و \f[I]R\f[R] می‌توانند ممیز شناور باشند. \f[I]R\f[R] اختیاری است و مقدار پیش‌فرض آن 12 dpmm (تقریباً 300 dpi) است. \f[I]X\f[R] می‌تواند صفر باشد که در این صورت پیش‌فرض مختص به نمادشناسی (symbology) استفاده می‌شود. .RS .PP مقیاس‌بندی، نوع فایل خروجی را در نظر گرفته و به تمام جزئیات ذکرشده در بالا رسیدگی می‌کند. واحدها را می‌توان برای \f[I]X\f[R] با الصاق \(lqin\(rq (اینچ) یا \(lqmm\(rq، و برای \f[I]R\f[R] با الصاق \(lqdpi\(rq (نقطه در اینچ) یا \(lqdpmm\(rq تعیین کرد \- برای نمونه\ \f[CR]\-\-scalexdimdp=0.013in,300dpi\f[R]. .RE .TP \f[CR]\-\-scmvv=INTEGER\f[R] برای MaxiCode، پیشوند Structured Carrier Message (SCM) را برابر با \f[CR]\(dq[)>\(rsR01\(rsGvv\(dq\f[R] قرار می‌دهد، که در آن \f[CR]vv\f[R] یک \f[I]INTEGER\f[R] دو رقمی است. .TP \f[CR]\-\-secure=INTEGER\f[R] سطح تصحیح خطا (ECC) را روی \f[I]INTEGER\f[R] تنظیم می‌کند. معنای آن مختص نمادهای ماتریسی زیر است (همه به جز PDF417 تقریبی هستند): .RS .IP .EX Aztec Code 1 to 4 (10%, 23%, 36%, 50%) Grid Matrix 1 to 5 (10% to 50%) Han Xin 1 to 4 (8%, 15%, 23%, 30%) Micro QR 1 to 3 (7%, 15%, 25%) (L, M, Q) PDF417 0 to 8 (2\(ha(INTEGER + 1) codewords) QR Code 1 to 4 (7%, 15%, 25%, 30%) (L, M, Q, H) rMQR 2 or 4 (15% or 30%) (M or H) Ultracode 1 to 6 (0%, 5%, 9%, 17%, 25%, 33%) .EE .RE .TP \f[CR]\-\-segN=ECI,DATA\f[R] محتوای \f[I]ECI\f[R] و \f[I]DATA\f[R] را برای قطعهٔ N تنظیم می‌کند که در آن N بین ۱ تا ۹ است. گزینهٔ \f[CR]\-d\f[R] | \f[CR]\-\-data\f[R] همچنان باید مشخص شود و به عنوان قطعهٔ 0 در نظر گرفته می‌شود، و ECI آن با \f[CR]\-\-eci\f[R] تعیین می‌شود. قطعه‌ها باید متوالی باشند. .TP \f[CR]\-\-separator=INTEGER\f[R] ارتفاع میله‌های جداکنندهٔ سطر را برای نمادشناسی‌های انباشته (stacked symbologies) تعیین می‌کند، که در آن \f[I]INTEGER\f[R] مضرب صحیحی از بعد X است. پیش‌فرض صفر است. .TP \f[CR]\-\-small\f[R] استفاده از قلم کوچک‌تر برای متن خوانا برای انسان (HRT). .TP \f[CR]\-\-square\f[R] برای نمادهای Data Matrix، هنگام در نظر گرفتن اندازه‌های خودکار، ابعاد مستطیلی را نادیده می‌گیرد. همچنین \f[CR]\-\-dmre\f[R] را ببینید. .TP \f[CR]\-\-structapp=I,C[,ID]\f[R] اطلاعات Structured Append را تنظیم می‌کند، که در آن \f[I]I\f[R] نمایهٔ مبتنی بر ۱، \f[I]C\f[R] تعداد کل نمادها در دنباله، و \f[I]ID\f[R] (که اختیاری است) شناسهٔ مشترک تمام نمادهای دنباله است. قابلیت Structured Append توسط Aztec Code، Code One، Data Matrix، DotCode، Grid Matrix، MaxiCode، MicroPDF417، PDF417، QR Code و Ultracode پشتیبانی می‌شود. .TP \f[CR]\-t\f[R], \f[CR]\-\-types\f[R] نمایش جدول انواع بارکد (نمادشناسی‌ها). می‌توان از شماره‌ها یا نام‌ها همراه با \f[CR]\-b\f[R] | \f[CR]\-\-barcode\f[R] استفاده کرد. .TP \f[CR]\-\-textgap=NUMBER\f[R] فاصلهٔ بین بارکد و متن خوانا برای انسان (HRT) را تنظیم می‌کند. \f[I]NUMBER\f[R] بر حسب ابعاد X است و می‌تواند ممیز شناور باشد. بیشینه ۱۰ و کمینه \-5 است. پیش‌فرض ۱ است. .TP \f[CR]\-\-vers=INTEGER\f[R] نسخهٔ نماد (اندازه، ارقام کنترلی، سایر گزینه‌ها) را روی \f[I]INTEGER\f[R] تنظیم می‌کند. معنای آن وابسته به نماد است. .RS .PP برای اغلب نمادهای ماتریسی، اندازه را مشخص می‌کند: .IP .EX Aztec Code 1 to 36 (1 to 4 compact) 1 15x15 13 53x53 25 105x105 2 19x19 14 57x57 26 109x109 3 23x23 15 61x61 27 113x113 4 27x27 16 67x67 28 117x117 5 19x19 17 71x71 29 121x121 6 23x23 18 75x75 30 125x125 7 27x27 19 79x79 31 131x131 8 31x31 20 83x83 32 135x135 9 37x37 21 87x87 33 139x139 10 41x41 22 91x91 34 143x143 11 45x45 23 95x95 35 147x147 12 49x49 24 101x101 36 151x151 Code One 1 to 10 (9 and 10 variable width) (HxW) 1 16x18 6 70x76 2 22x22 7 104x98 3 28x32 8 148x134 4 40x42 9 8xW 5 52x54 10 16xW Data Matrix 1 to 48 (31 to 48 DMRE) (HxW) 1 10x10 17 72x72 33 8x80 2 12x12 18 80x80 34 8x96 3 14x14 19 88x88 35 8x120 4 16x16 20 96x96 36 8x144 5 18x18 21 104x104 37 12x64 6 20x20 22 120x120 38 12x88 7 22x22 23 132x132 39 16x64 8 24x24 24 144x144 40 20x36 9 26x26 25 8x18 41 20x44 10 32x32 26 8x32 42 20x64 11 36x36 27 12x26 43 22x48 12 40x40 28 12x36 44 24x48 13 44x44 29 16x36 45 24x64 14 48x48 30 16x48 46 26x40 15 52x52 31 8x48 47 26x48 16 64x64 32 8x64 48 26x64 Grid Matrix 1 to 13 1 18x18 6 78x78 11 138x138 2 30x30 7 90x90 12 150x150 3 42x42 8 102x102 13 162x162 4 54x54 9 114x114 5 66x66 10 126x126 Han Xin 1 to 84 1 23x23 29 79x79 57 135x135 2 25x25 30 81x81 58 137x137 3 27x27 31 83x83 59 139x139 4 29x29 32 85x85 60 141x141 5 31x31 33 87x87 61 143x143 6 33x33 34 89x89 62 145x145 7 35x35 35 91x91 63 147x147 8 37x37 36 93x93 64 149x149 9 39x39 37 95x95 65 151x151 10 41x41 38 97x97 66 153x153 11 43x43 39 99x99 67 155x155 12 45x45 40 101x101 68 157x157 13 47x47 41 103x103 69 159x159 14 49x49 42 105x105 70 161x161 15 51x51 43 107x107 71 163x163 16 53x53 44 109x109 72 165x165 17 55x55 45 111x111 73 167x167 18 57x57 46 113x113 74 169x169 19 59x59 47 115x115 75 171x171 20 61x61 48 117x117 76 173x173 21 63x63 49 119x119 77 175x175 22 65x65 50 121x121 78 177x177 23 67x67 51 123x123 79 179x179 24 69x69 52 125x125 80 181x181 25 71x71 53 127x127 81 183x183 26 73x73 54 129x129 82 185x185 27 75x75 55 131x131 83 187x187 28 77x77 56 133x133 84 189x189 Micro QR 1 to 4 (M1, M2, M3, M4) 1 11x11 3 15x15 2 13x13 4 17x17 QR Code 1 to 40 1 21x21 15 77x77 29 133x133 2 25x25 16 81x81 30 137x137 3 29x29 17 85x85 31 141x141 4 33x33 18 89x89 32 145x145 5 37x37 19 93x93 33 149x149 6 41x41 20 97x97 34 153x153 7 45x45 21 101x101 35 157x157 8 49x49 22 105x105 36 161x161 9 53x53 23 109x109 37 165x165 10 57x57 24 113x113 38 169x169 11 61x61 25 117x117 39 173x173 12 65x65 26 121x121 40 177x177 13 69x69 27 125x125 14 73x73 28 129x129 rMQR 1 to 38 (33 to 38 automatic width) (HxW) 1 7x43 14 11x77 27 15x139 2 7x59 15 11x99 28 17x43 3 7x77 16 11x139 29 17x59 4 7x99 17 13x27 30 17x77 5 7x139 18 13x43 31 17x99 6 9x43 19 13x59 32 17x139 7 9x59 20 13x77 33 7xW 8 9x77 21 13x99 34 9xW 9 9x99 22 13x139 35 11xW 10 9x139 23 15x43 36 13xW 11 11x27 24 15x59 37 15xW 12 11x43 25 15x77 38 17xW 13 11x59 26 15x99 .EE.PP برای شماری از نمادهای خطی، گزینه‌های نویسهٔ کنترلی را مشخص می‌کند (\(lqhide\(rq یا \(lqhidden\(rq به‌معنای عدم نمایش در HRT، و \(lqvisible\(rq به‌معنای نمایش در HRT است): .IP .EX C25IATA 1 یا 2 (افزودن رقم کنترلی آشکار یا پنهان) C25IND همان C25INTER همان C25LOGIC همان C25STANDARD همان Codabar 1 یا 2 (افزودن رقم کنترلی پنهان یا آشکار) Code 11 0 تا 2 (۲ رقم کنترلی آشکار تا هیچ) 0 (پیش‌فرض ۲ رقم کنترلی آشکار) 1 (۱ رقم کنترلی آشکار) 2 (بدون رقم کنترلی) Code 39 1 یا 2 (افزودن رقم کنترلی آشکار یا پنهان) Code 93 1 (نمایش نویسه‌های کنترلی پیش‌فرض) EXCODE39 1 یا 2 (افزودن رقم کنترلی آشکار یا پنهان) LOGMARS 1 یا 2 (افزودن رقم کنترلی آشکار یا پنهان) UK Plessey 1 (نمایش نویسه‌های کنترلی پیش‌فرض) MSI Plessey 0 تا 6 (هیچ تا گزینه‌های گوناگون آشکار) 1, 2 (mod\-10, mod\-10 + mod\-10) 3, 4 (mod\-11 IBM, mod\-11 IBM + mod\-10) 5, 6 (mod\-11 NCR, mod\-11 NCR + mod\-10) +10 (پنهان‌سازی) .EE .PP برای چند نمادشناسی دیگر، مشخصه‌های دیگری را تعیین می‌کند: .IP .EX Channel Code 3 تا 8 (تعداد کانال‌ها) DAFT 50 تا 900 (نسبت ردیاب در هزار) DPD 1 (برچسب‌گذاری مجدد) PZN 1 (PZN7 به‌جای PZN8 پیش‌فرض) Ultracode 2 (ویرایش ۲) VIN 1 (افزودن پیشوند بین‌المللی) .EE .RE .TP \f[CR]\-v\f[R], \f[CR]\-\-version\f[R] نمایش نسخهٔ zint. .TP \f[CR]\-\-vwhitesp=INTEGER\f[R] تنظیم ارتفاع فضای خالی عمودی در بالا و پایین بارکد، که در آن \f[I]INTEGER\f[R] مضرب صحیحی از X\-dimension است. .TP \f[CR]\-w\f[R], \f[CR]\-\-whitesp=INTEGER\f[R] تنظیم عرض فضای خالی افقی در دو طرف بارکد، که در آن \f[I]INTEGER\f[R] مضرب صحیحی از X\-dimension است. .TP \f[CR]\-\-werror\f[R] تبدیل تمام هشدارها به خطا. .SH "وضعیت خروج (EXIT STATUS)" .TP \f[CR]0\f[R] موفقیت (از جمله هنگام استفاده از گزینه‌های اطلاع‌رسانی \f[CR]\-h\f[R] | \f[CR]\-\-help\f[R]، \f[CR]\-e\f[R] | \f[CR]\-\-ecinos\f[R]، \f[CR]\-t\f[R] | \f[CR]\-\-types\f[R]، \f[CR]\-v\f[R] | \f[CR]\-\-version\f[R]). .TP \f[CR]1\f[R] متن خوانا برای انسان (HRT) کوتاه شد (حداکثر ۱۹۹ بایت) (\f[CR]ZINT_WARN_HRT_TRUNCATED\f[R]) .TP \f[CR]2\f[R] گزینهٔ نامعتبر داده شد اما توسط Zint بازنویسی شد (\f[CR]ZINT_WARN_INVALID_OPTION\f[R]) .TP \f[CR]3\f[R] ECI خودکار توسط Zint درج شد (\f[CR]ZINT_WARN_USES_ECI\f[R]) .TP \f[CR]4\f[R] نماد ایجادشده با استانداردها سازگار نیست (\f[CR]ZINT_WARN_NONCOMPLIANT\f[R]) .TP \f[CR]5\f[R] طول داده‌های ورودی نادرست است (\f[CR]ZINT_ERROR_TOO_LONG\f[R]) .TP \f[CR]6\f[R] داده‌های ورودی نادرست است (\f[CR]ZINT_ERROR_INVALID_DATA\f[R]) .TP \f[CR]7\f[R] رقم کنترلی ورودی نادرست است (\f[CR]ZINT_ERROR_INVALID_CHECK\f[R]) .TP \f[CR]8\f[R] گزینهٔ نادرست مشخص شده است (\f[CR]ZINT_ERROR_INVALID_OPTION\f[R]) .TP \f[CR]9\f[R] خطای داخلی (نباید رخ دهد) (\f[CR]ZINT_ERROR_ENCODING_PROBLEM\f[R]) .TP \f[CR]10\f[R] خطا در باز کردن فایل خروجی (\f[CR]ZINT_ERROR_FILE_ACCESS\f[R]) .TP \f[CR]11\f[R] شکست در تخصیص حافظه (malloc) (\f[CR]ZINT_ERROR_MEMORY\f[R]) .TP \f[CR]12\f[R] خطا در نوشتن روی فایل خروجی (\f[CR]ZINT_ERROR_FILE_WRITE\f[R]) .TP \f[CR]13\f[R] معادل خطای هشدار در صورت استفاده از \f[CR]\-\-werror\f[R] (\f[CR]ZINT_ERROR_USES_ECI\f[R]) .TP \f[CR]14\f[R] معادل خطای هشدار در صورت استفاده از \f[CR]\-\-werror\f[R] (\f[CR]ZINT_ERROR_NONCOMPLIANT\f[R]) .TP \f[CR]15\f[R] معادل خطای هشدار در صورت استفاده از \f[CR]\-\-werror\f[R] (\f[CR]ZINT_ERROR_HRT_TRUNCATED\f[R]).SH "مثال‌ها (EXAMPLES)" ایجاد \(lqout.png\(rq (یا \(lqout.gif\(rq اگر zint بدون پشتیبانی از PNG ساخته شده باشد) در دایرکتوری جاری، به عنوان نماد Code 128. .IP .EX zint \-d \(aqThis Text\(aq .EE .PP ایجاد \(lqqr.svg\(rq در دایرکتوری جاری، به عنوان نماد QR Code. .IP .EX zint \-b QRCode \-d \(aqThis Text\(aq \-o \(aqqr.svg\(aq .EE .PP استفاده از حالت دسته‌ای (batch mode) برای خواندن از فایل ورودی \(lqean13nos.txt\(rq شامل فهرستی از کدهای ۱۳ رقمی GTIN (هر کدام در یک خط جداگانه)، جهت ایجاد مجموعه‌ای از بارکدهای EAN\-13 و قالب‌بندی نام فایل‌های خروجی به شکل \(lqean001.gif\(rq،‏ \(lqean002.gif\(rq و غیره با استفاده از نویسهٔ ویژهٔ \(lq\(ti\(rq. .IP .EX zint \-b EAN13 \-\-batch \-i \(aqean13nos.txt\(aq \-o \(aqean\(ti\(ti\(ti.gif\(aq .EE .SH "گزارش باگ‌ها (BUGS)" لطفاً گزارش باگ‌ها را به https://sourceforge.net/p/zint/tickets ارسال کنید. .SH "همچنین ببینید (SEE ALSO)" مستندات کامل برای \f[CR]zint\f[R] (و API مربوط به \f[CR]libzint\f[R] و واسط گرافیکی \f[CR]zint\-qt\f[R]) در نشانی زیر موجود است: .IP .EX https://zint.org.uk/manual .EE .PP و همچنین در: .IP .EX https://sourceforge.net/p/zint/docs/manual.txt .EE .SH "سازگاری با استانداردها (CONFORMING TO)" ابزار Zint به‌گونه‌ای طراحی شده است که با چندین استاندارد بین‌المللی سازگار باشد، از جمله: .PP ISO/IEC 24778:2024, ANSI/AIM BC12\-1998, EN 798:1996, AIM ISS\-X\-24 (1995), ISO/IEC 15417:2007, EN 12323:2005, ISO/IEC 16388:2023, ANSI/AIM BC6\-2000, ANSI/AIM BC5\-1995, AIM USS Code One (1994), ISO/IEC 16022:2024, ISO/IEC 21471:2019, ISO/IEC 15420:2009, AIMD014 (v 1.63) (2008), ISO/IEC 24723:2010, ISO/IEC 24724:2011, ISO/IEC 20830:2021, ISO/IEC 16390:2007, ISO/IEC 16023:2000, ISO/IEC 24728:2006, ISO/IEC 15438:2015, ISO/IEC 18004:2024, ISO/IEC 23941:2022, AIM ITS/04\-023 (2022) .SH "کپی‌رایت و تکثیر (COPYRIGHT)" کپی‌رایت © 2025 Robin Stuart. تحت مجوز GNU GPL نسخهٔ 3.0 یا بالاتر منتشر شده است. .SH "نویسندگان (AUTHORS)" Robin Stuart \c .MT robin@zint.org.uk .ME \c