ZINT(1) General Commands Manual ZINT(1)

zint - کدگذاری داده‌ها به صورت تصویر بارکد

zint [-h | --help]

zint [گزینه‌ها]

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

داده‌های ورودی UTF-8 هستند، مگر اینکه --binary مشخص شده باشد.

متن خوانا برای انسان (HRT) به طور پیش‌فرض برای بارکدهایی که از HRT پشتیبانی می‌کنند نمایش داده می‌شود، مگر اینکه --notext مشخص شده باشد.

فایل تصویری خروجی (مشخص‌شده با -o | --output) می‌تواند در یکی از این قالب‌ها باشد: Windows Bitmap (BMP)، Enhanced Metafile Format (EMF)، Encapsulated PostScript (EPS)، Graphics Interchange Format (GIF)، ZSoft Paintbrush (PCX)، Portable Network Format (PNG)، Scalable Vector Graphic (SVG)، یا Tagged Image File Format (TIF).

چاپ اطلاعات نحوه استفاده در خلاصه‌ای از گزینه‌های خط فرمان.
تنظیم نمادشناسی (symbology) بارکد که برای کدگذاری داده‌ها استفاده خواهد شد. TYPE شماره یا نام نمادشناسی بارکد است. اگر داده نشود، نمادشناسی به صورت پیش‌فرض 20 (Code 128) خواهد بود. برای مشاهدهٔ نوع‌های موجود، از گزینهٔ -t | --types استفاده کنید. نام انواع به بزرگ و کوچک بودن حروف حساس نیستند و نویسه‌های غیرالفبایی-عددی نادیده گرفته می‌شوند.
برای نمادشناسی‌های EAN/UPC، فاصله بین داده‌های اصلی و بخش الحاقی (add-on) را تنظیم می‌کند. INTEGER بر حسب مضارب صحیحی از بُعد X است. بیشترین فاصله‌ای که می‌توان تعیین کرد ۱۲ است. کمترین مقدار ۷ است، به جز برای UPC-A که در آن کمترین مقدار ۹ است.
رفتار با هر خط از فایل ورودی مشخص‌شده با -i | --input به عنوان یک مجموعه دادهٔ جداگانه و تولید یک تصویر بارکد برای هر یک از آن‌ها. تصاویر بارکد به طور پیش‌فرض در فایل‌هایی با نام‌های شماره‌گذاری‌شده با شروع از “00001.png”، “00002.png” و غیره خروجی داده می‌شوند که این نام‌ها را می‌توان با استفاده از گزینهٔ -o | --output تغییر داد.
مشخص کردن رنگ پس‌زمینه (کاغذ) که در آن COLOUR در قالب شانزده‌شانزدهی RRGGBB یا RRGGBBAA یا در قالب درصدهای ده‌دهی C,M,Y,K است.
رفتار با داده‌های ورودی به عنوان داده‌های باینری ۸-بیتی خام به جای UTF-8 پیش‌فرض. ترجمه خودکار جدول کد (code page) به یک صفحهٔ ECI غیرفعال می‌شود و هیچ اعتبارسنجی روی رمزگذاری نویسه‌های داده انجام نمی‌گیرد.
افزودن نوارهای مرزی افقی (که با نام bearer bars نیز شناخته می‌شوند) به نماد. عرض نوارهای مرزی توسط گزینهٔ --border مشخص می‌شود. --bind همچنین می‌تواند برای افزودن نوارهای جداکننده سطر به نمادهای پشته‌شده با چندین ورودی -d | --data استفاده شود، که در این حالت عرض نوارهای جداکننده با گزینهٔ --separator مشخص می‌شود.
افزودن یک نوار مرزی افقی به بالای نماد. عرض نوار مرزی با گزینهٔ --border مشخص می‌شود.
استفاده از قلم پررنگ (bold) برای متن خوانا برای انسان (HRT).
تنظیم عرض نوارهای مرزی (--bind یا --bindtop) یا کادر دور نماد (--box)، که در آن INTEGER به صورت مضارب صحیحی از بُعد X است. پیش‌فرض صفر است.
افزودن یک کادر (جعبه) در اطراف نماد. عرض کادرها با گزینهٔ --border مشخص می‌شود.
استفاده از فضای رنگی CMYK هنگام خروجی گرفتن در فایل‌های Encapsulated PostScript (EPS) یا TIF.
تنظیم تعداد ستون‌های داده در نماد بر روی INTEGER. روی نمادهای Codablock-F، DotCode، GS1 DataBar Expanded Stacked (DBAR_EXPSTK)، MicroPDF417 و PDF417 تأثیر می‌گذارد.
هشدار در صورتی که ارتفاع مشخص‌شده توسط گزینهٔ --height با مشخصات استاندارد بارکد سازگار نباشد؛ یا در صورتی که --height داده نشود، پیش‌فرض قرار دادن ارتفاع تعیین‌شده در مشخصات استاندارد (در صورت وجود).
مشخص کردن DATA ورودی برای کدگذاری. می‌توان از گزینهٔ --esc برای وارد کردن نویسه‌های غیرقابل‌چاپ با استفاده از توالی‌های گریز استفاده کرد. DATA باید به صورت UTF-8 باشد، مگر اینکه گزینهٔ --binary داده شده باشد که در آن صورت می‌تواند هر چیزی باشد.
ارسال خروجی به stdout، که در بیشتر موارد باید به یک لوله (pipe) یا یک فایل هدایت شود. از --filetype برای تعیین قالب خروجی استفاده کنید.
برای نمادهای Data Matrix، استفاده از جانمایی استاندارد کلمه‌کد (codeword) بر اساس ISO/IEC برای نمادهای با اندازهٔ 144 x 144 (--vers=24) به جای جانمایی پیش‌فرض “de facto” (که جانمایی کلمه‌کدهای ECC را می‌چرخاند).
برای نمادهای Data Matrix، مجاز دانستن اندازه‌های Data Matrix Rectangular Extended (DMRE) هنگام در نظر گرفتن اندازه‌های خودکار. همچنین نگاه کنید به --square.
تنظیم شعاع نقطه‌ها در حالت نقطه‌ای (--dotty). NUMBER بر حسب ابعاد X است و می‌تواند عدد اعشاری (ممیز شناور) باشد. پیش‌فرض 0.8 است.
استفاده از نقطه به جای مربع برای نمادهای ماتریسی. DotCode همواره در حالت نقطه‌ای است.
تخلیهٔ (dump) یک نمایش شانزده‌شانزدهی از کدگذاری نماد در stdout. همین نمایش می‌تواند با استفاده از پسوند .txt به همراه -o | --output یا با تعیین --filetype=txt در یک فایل خروجی داده شود.
نمایش جدول ECIها (Extended Channel Interpretations).
تنظیم کد ECI برای داده‌های ورودی بر روی INTEGER. برای دیدن فهرستی از ECIهای موجود به -e | --ecinos مراجعه کنید. ECIها توسط Aztec Code، Code One، Data Matrix، DotCode، Grid Matrix، Han Xin Code، MaxiCode، MicroPDF417، PDF417، QR Code، rMQR و Ultracode پشتیبانی می‌شوند.
برای خروجی برداری، تعبیه کردن قلم در فایل به جهت سازگاری و حمل‌پذیری. در حال حاضر تنها برای خروجی SVG در دسترس است.
پردازش نویسه‌های گریز (escape) در داده‌های ورودی. توالی‌های گریز عبارتند از:
\0       (0x00)    NUL  Null character
\E       (0x04)    EOT  End of Transmission
\a       (0x07)    BEL  Bell
\b       (0x08)    BS   Backspace
\t       (0x09)    HT   Horizontal Tab
\n       (0x0A)    LF   Line Feed
\v       (0x0B)    VT   Vertical Tab
\f       (0x0C)    FF   Form Feed
\r       (0x0D)    CR   Carriage Return
\e       (0x1B)    ESC  Escape
\G       (0x1D)    GS   Group Separator
\R       (0x1E)    RS   Record Separator
\(       (0x28)    (    Opening parenthesis (only with
                        --gs1parens)
\)       (0x29)    )    Closing parenthesis (only with
                        --gs1parens)
\\       (0x5C)    \    Backslash
\dNNN    (NNN)          Any 8-bit character where NNN is
                        decimal (000-255)
\oNNN    (0oNNN)        Any 8-bit character where NNN is
                        octal (000-377)
\xNN     (0xNN)         Any 8-bit character where NN is
                        hexadecimal (00-FF)
\uNNNN   (U+NNNN)       Any 16-bit Unicode BMP character
                        where NNNN is hexadecimal
\UNNNNNN (U+NNNNNN)     Any 21-bit Unicode character
                        where NNNNNN is hexadecimal
--extraesc تنها برای Code 128، علاوه بر پردازش توالی‌های گریز عادی بالا، توالی‌های گریز ویژهٔ \^A، \^B، \^C و \^@ که امکان تعویض دستی Code Setها را فراهم می‌کنند، و توالی گریز ویژهٔ \^1 که نویسهٔ FNC1 را درج می‌کند، پردازش شوند. توالی \@ تعویض دستی را غیرفعال می‌کند. توالی \^^ می‌تواند برای کدگذاری داده‌هایی که شامل توالی‌های گریز ویژه هستند استفاده شود.
استفاده از کدگذاری سریع‌تر اگرچه با بهینگی کمتر یا سایر میان‌برها (تنها بر Data Matrix، MicroPDF417، PDF417، QRCODE و UPNQR اثر می‌گذارد).
مشخص کردن رنگ پیش‌زمینه (جوهر) که در آن COLOUR در قالب شانزده‌شانزدهی RRGGBB یا RRGGBBAA یا در قالب درصدهای دهدهی C,M,Y,K است.
تنظیم نوع فایل خروجی به TYPE، که یکی از موارد BMP، EMF، EPS، GIF، PCX، PNG، SVG، TIF یا TXT است.
استفاده از حالت‌های چندبایتی Grid Matrix، Han Xin و QR Code برای داده‌های غیر ASCII.
در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1. شناسه‌های کاربردی (AIs یا Application Identifiers) باید درون قلاب‌های "[]" قرار گیرند (اما گزینهٔ --gs1parens را نیز ببینید). همچنین URIهای GS1 Digital Link (تأییدنشده) را برای نمادشناسی‌های ماتریسی می‌پذیرد.
در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1 (مانند --gs1) اما بدون بررسی درستی و اعتبار داده‌ها.
در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1 (مانند --gs1) اما پردازش پرانتزها "()" به عنوان جداکننده‌های AI در GS1 به جای قلاب‌های "[]". اگر داده‌های AI شامل پرانتز باز باشند، باید با بک‌اسلش آورده شوند ("\(").
در نظر گرفتن ورودی به عنوان داده‌های سازگار با GS1 (مانند --gs1) و استفاده از GS1 Syntax Engine (در صورت موجود بودن) برای اعتبارسنجی دقیق داده‌های GS1، شامل URIهای GS1 Digital Link. اگر --gs1nocheck نیز مشخص شده باشد، این گزینه نادیده گرفته می‌شود.
برای Data Matrix در حالت GS1، استفاده از GS (0x1D) به عنوان جداکنندهٔ داده‌های GS1 به جای FNC1.
برای نمادهای EAN/UPC، تنظیم ارتفاعی که میله‌های محافظ (guard bars) به زیر میله‌های اصلی امتداد می‌یابند، که در آن NUMBER بر حسب ابعاد X (X-dimensions) است. NUMBER می‌تواند ممیز شناور باشد.
برای نمادهای EAN/UPC، افزودن نشانگرهای ناحیهٔ آرام "<" و/یا ">" به HRT در صورت امکان.
تنظیم ارتفاع نماد بر حسب ابعاد X. NUMBER می‌تواند ممیز شناور باشد.
در نظر گرفتن ارتفاع به صورت به‌ازای‌هر‌سطر. بر Codablock-F، Code 16K، Code 49، GS1 DataBar Expanded Stacked (DBAR_EXPSTK)، MicroPDF417 و PDF417 اثر می‌گذارد.
خواندن داده‌های ورودی از FILE. برای خواندن از stdin، یک خط تیرهٔ تکی (-) را برای FILE مشخص کنید.
ایجاد یک نماد مقداردهی اولیهٔ خوانشگر (برنامه‌ریزی) (Reader Initialisation).
تنظیم الگوی ماسک مورد استفاده برای DotCode، Han Xin یا QR Code به INTEGER، که انتخاب خودکار را لغو می‌کند.
استفاده از داده‌های دسته‌ای برای تعیین نام فایل در حالت دسته‌ای (--batch). گزینهٔ -o | --output می‌تواند برای مشخص کردن یک دایرکتوری خروجی استفاده شود (هرگونه نام فایل نادیده گرفته خواهد شد).
برای نمادهای MaxiCode و GS1 Composite، تنظیم حالت کدگذاری به INTEGER.

برای MaxiCode (منظور از SCM، Structured Carrier Message با ۳ فیلد است: کد پستی، کد کشور ۳ رقمی بر اساس ISO 3166-1، کد سرویس ۳ رقمی):

2   SCM با کد پستی عددی ۹ رقمی
3   SCM با کد پستی حرفی-عددی ۶ نویسه‌ای
4   ECC بهبودیافته برای بخش اصلی پیام
5   ECC بهبودیافته برای تمام پیام
6   مقداردهی اولیهٔ خوانشگر (برنامه‌ریزی)

برای نمادهای GS1 Composite (نام‌هایی که به _CC ختم می‌شوند، یعنی EAN8_CC، EAN13_CC، GS1_128_CC، DBAR_OMN_CC و غیره):

1   CC-A
2   CC-B
3   CC-C (تنها GS1_128_CC)
حذف رنگ پس‌زمینه (تنها برای EMF، EPS، GIF، PNG، SVG و TIF).
غیرفعال کردن تمام نواحی آرام (quiet zones) برای نمادهایی که آن‌ها را به صورت پیش‌فرض تعریف کرده‌اند.
حذف متن خوانا برای انسان (HRT یا Human Readable Text).
ارسال خروجی به FILE. هنگامی که در حالت دسته‌ای نباشد، مقدار پیش‌فرض “out.png” است (یا اگر zint بدون پشتیبانی از PNG ساخته شده باشد، “out.gif”). در حالت دسته‌ای (--batch)، می‌توان از نویسه‌های ویژه برای قالب‌بندی نام فایل‌های خروجی استفاده کرد:
~           درج یک عدد یا 0
#           درج یک عدد یا فاصله
@           درج یک عدد یا * (+ در Windows)
سایر موارد  درج به صورت لفظی
برای MaxiCode، تنظیم محتوای پیام اولیه. برای نمادهای GS1 Composite، تنظیم محتوای نماد خطی.
افزودن نواحی آرام منطبق با استاندارد برای نمادهایی که آن‌ها را تعیین کرده‌اند. این افزون بر هرگونه فضای خالی تعیین‌شده توسط -w | --whitesp یا --vwhitesp است.
معکوس کردن رنگ‌های پیش‌زمینه و پس‌زمینه (سفید روی سیاه). معروف به “وارونگی بازتاب” یا “بازتاب وارونه”.
چرخاندن نماد به میزان INTEGER درجه، که در آن INTEGER می‌تواند 0، 90، 270 یا 360 باشد.
تنظیم تعداد سطرهای Codablock-F یا PDF417 به INTEGER. همچنین حداقل تعداد سطرها برای Code 16K یا Code 49، و حداکثر تعداد سطرها برای GS1 DataBar Expanded Stacked (DBAR_EXPSTK) را تنظیم می‌کند.
تنظیم اندازهٔ بعد X (X-dimension). NUMBER می‌تواند ممیز شناور باشد، و قبل از اعمال (به جز برای MaxiCode) در 2 ضرب می‌شود. مقیاس پیش‌فرض 1 است.

برای MaxiCode، مقیاس برای خروجی رستر در 10، برای خروجی EMF در 40، و در غیر این صورت در 2 ضرب می‌شود.

افزایش‌های 0.5 (نیمه‌صحیح) برای خروجی رستر غیر MaxiCode (شامل BMP، GIF، PCX، PNG و TIF) توصیه می‌شود. متن خوانا برای انسان (HRT) در خروجی رستر برای مقیاس‌های کمتر از 1 نمایش داده نخواهد شد..PP همچنین گزینهٔ --scalexdimdp در زیر را ببینید.

تصویر را بر اساس بعد X با مقدار X و تفکیک‌پذیری R مقیاس‌بندی می‌کند، که در آن X بر حسب میلی‌متر و R بر حسب dpmm (نقطه در میلی‌متر) است. X و R می‌توانند ممیز شناور باشند. R اختیاری است و مقدار پیش‌فرض آن 12 dpmm (تقریباً 300 dpi) است. X می‌تواند صفر باشد که در این صورت پیش‌فرض مختص به نمادشناسی (symbology) استفاده می‌شود.

مقیاس‌بندی، نوع فایل خروجی را در نظر گرفته و به تمام جزئیات ذکرشده در بالا رسیدگی می‌کند. واحدها را می‌توان برای X با الصاق “in” (اینچ) یا “mm”، و برای R با الصاق “dpi” (نقطه در اینچ) یا “dpmm” تعیین کرد - برای نمونه --scalexdimdp=0.013in,300dpi.

برای MaxiCode، پیشوند Structured Carrier Message (SCM) را برابر با "[)>\R01\Gvv" قرار می‌دهد، که در آن vv یک INTEGER دو رقمی است.
سطح تصحیح خطا (ECC) را روی INTEGER تنظیم می‌کند. معنای آن مختص نمادهای ماتریسی زیر است (همه به جز PDF417 تقریبی هستند):
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^(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%)
محتوای ECI و DATA را برای قطعهٔ N تنظیم می‌کند که در آن N بین ۱ تا ۹ است. گزینهٔ -d | --data همچنان باید مشخص شود و به عنوان قطعهٔ 0 در نظر گرفته می‌شود، و ECI آن با --eci تعیین می‌شود. قطعه‌ها باید متوالی باشند.
ارتفاع میله‌های جداکنندهٔ سطر را برای نمادشناسی‌های انباشته (stacked symbologies) تعیین می‌کند، که در آن INTEGER مضرب صحیحی از بعد X است. پیش‌فرض صفر است.
استفاده از قلم کوچک‌تر برای متن خوانا برای انسان (HRT).
برای نمادهای Data Matrix، هنگام در نظر گرفتن اندازه‌های خودکار، ابعاد مستطیلی را نادیده می‌گیرد. همچنین --dmre را ببینید.
اطلاعات Structured Append را تنظیم می‌کند، که در آن I نمایهٔ مبتنی بر ۱، C تعداد کل نمادها در دنباله، و ID (که اختیاری است) شناسهٔ مشترک تمام نمادهای دنباله است. قابلیت Structured Append توسط Aztec Code، Code One، Data Matrix، DotCode، Grid Matrix، MaxiCode، MicroPDF417، PDF417، QR Code و Ultracode پشتیبانی می‌شود.
نمایش جدول انواع بارکد (نمادشناسی‌ها). می‌توان از شماره‌ها یا نام‌ها همراه با -b | --barcode استفاده کرد.
فاصلهٔ بین بارکد و متن خوانا برای انسان (HRT) را تنظیم می‌کند. NUMBER بر حسب ابعاد X است و می‌تواند ممیز شناور باشد. بیشینه ۱۰ و کمینه -5 است. پیش‌فرض ۱ است.
نسخهٔ نماد (اندازه، ارقام کنترلی، سایر گزینه‌ها) را روی INTEGER تنظیم می‌کند. معنای آن وابسته به نماد است.

برای اغلب نمادهای ماتریسی، اندازه را مشخص می‌کند:

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
برای شماری از نمادهای خطی، گزینه‌های نویسهٔ کنترلی را مشخص می‌کند
(“hide” یا “hidden” به‌معنای عدم نمایش در HRT،
و “visible” به‌معنای نمایش در HRT است):
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    (پنهان‌سازی)

برای چند نمادشناسی دیگر، مشخصه‌های دیگری را تعیین می‌کند:

Channel Code    3 تا 8    (تعداد کانال‌ها)
DAFT            50 تا 900 (نسبت ردیاب در هزار)
DPD             1         (برچسب‌گذاری مجدد)
PZN             1         (PZN7 به‌جای PZN8 پیش‌فرض)
Ultracode       2         (ویرایش ۲)
VIN             1         (افزودن پیشوند بین‌المللی)
نمایش نسخهٔ zint.
تنظیم ارتفاع فضای خالی عمودی در بالا و پایین بارکد، که در آن INTEGER مضرب صحیحی از X-dimension است.
تنظیم عرض فضای خالی افقی در دو طرف بارکد، که در آن INTEGER مضرب صحیحی از X-dimension است.
تبدیل تمام هشدارها به خطا.

0
موفقیت (از جمله هنگام استفاده از گزینه‌های اطلاع‌رسانی -h | --help، -e | --ecinos، -t | --types، -v | --version).
1
متن خوانا برای انسان (HRT) کوتاه شد (حداکثر ۱۹۹ بایت) (ZINT_WARN_HRT_TRUNCATED)
2
گزینهٔ نامعتبر داده شد اما توسط Zint بازنویسی شد (ZINT_WARN_INVALID_OPTION)
3
ECI خودکار توسط Zint درج شد (ZINT_WARN_USES_ECI)
4
نماد ایجادشده با استانداردها سازگار نیست (ZINT_WARN_NONCOMPLIANT)
5
طول داده‌های ورودی نادرست است (ZINT_ERROR_TOO_LONG)
6
داده‌های ورودی نادرست است (ZINT_ERROR_INVALID_DATA)
7
رقم کنترلی ورودی نادرست است (ZINT_ERROR_INVALID_CHECK)
8
گزینهٔ نادرست مشخص شده است (ZINT_ERROR_INVALID_OPTION)
9
خطای داخلی (نباید رخ دهد) (ZINT_ERROR_ENCODING_PROBLEM)
10
خطا در باز کردن فایل خروجی (ZINT_ERROR_FILE_ACCESS)
11
شکست در تخصیص حافظه (malloc) (ZINT_ERROR_MEMORY)
12
خطا در نوشتن روی فایل خروجی (ZINT_ERROR_FILE_WRITE)
13
معادل خطای هشدار در صورت استفاده از --werror (ZINT_ERROR_USES_ECI)
14
معادل خطای هشدار در صورت استفاده از --werror (ZINT_ERROR_NONCOMPLIANT)
15
معادل خطای هشدار در صورت استفاده از --werror (ZINT_ERROR_HRT_TRUNCATED).SH "مثال‌ها (EXAMPLES)" ایجاد “out.png” (یا “out.gif” اگر zint بدون پشتیبانی از PNG ساخته شده باشد) در دایرکتوری جاری، به عنوان نماد Code 128.
zint -d 'This Text'

ایجاد “qr.svg” در دایرکتوری جاری، به عنوان نماد QR Code.

zint -b QRCode -d 'This Text' -o 'qr.svg'

استفاده از حالت دسته‌ای (batch mode) برای خواندن از فایل ورودی “ean13nos.txt” شامل فهرستی از کدهای ۱۳ رقمی GTIN (هر کدام در یک خط جداگانه)، جهت ایجاد مجموعه‌ای از بارکدهای EAN-13 و قالب‌بندی نام فایل‌های خروجی به شکل “ean001.gif”،‏ “ean002.gif” و غیره با استفاده از نویسهٔ ویژهٔ “~”.

zint -b EAN13 --batch -i 'ean13nos.txt' -o 'ean~~~.gif'

لطفاً گزارش باگ‌ها را به https://sourceforge.net/p/zint/tickets ارسال کنید.

مستندات کامل برای zint (و API مربوط به libzint و واسط گرافیکی zint-qt) در نشانی زیر موجود است:

https://zint.org.uk/manual

و همچنین در:

https://sourceforge.net/p/zint/docs/manual.txt

ابزار Zint به‌گونه‌ای طراحی شده است که با چندین استاندارد بین‌المللی سازگار باشد، از جمله:

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)

کپی‌رایت © 2025 Robin Stuart. تحت مجوز GNU GPL نسخهٔ 3.0 یا بالاتر منتشر شده است.

Robin Stuart robin@zint.org.uk

December 2025 Version 2.16.0