'\" t
.\"     Title: qrtool-encode
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-08
.\"    Manual: General Commands Manual
.\"    Source: qrtool 0.13.2
.\"  Language: Persian
.\"
.TH "QRTOOL\-ENCODE" "1" "2025-11-08" "qrtool 0.13.2" "General Commands Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
qrtool\-encode \- کدگذاری داده‌های ورودی در یک کد QR
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBqrtool encode\fP [\fIOPTION\fP].\|.\|. [\fISTRING\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور داده‌های ورودی را در یک \c
.URL "https://www.qrcode.com" "کد QR" ""
کدگذاری کرده و آن را به عنوان تصویر
PNG، تصویر SVG، رشته متنی یا سایر قالب‌ها خروجی می‌دهد. به‌طور پیش‌فرض، نتیجه در
خروجی استاندارد چاپ خواهد شد.
.sp
این دستور تا حداکثر ۷,۰۹۰ بایت نخست داده‌های ورودی را می‌خواند. مقدار
داده‌ای که می‌تواند توسط یک کد QR نمایش داده شود به حالت، نگارش
و سطح تصحیح خطا بستگی دارد. بیشترین ظرفیت ذخیره‌سازی برای
نگارش ۴۰ و سطح تصحیح خطای L است (40\-L).
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۱. حداکثر ظرفیت ذخیره‌سازی نویسه‌ها (40\-L)
.TS
allbox tab(:);
ltB ltB ltB.
T{
.sp
حالت ورودی
T}:T{
.sp
حداکثر نویسه‌ها
T}:T{
.sp
نویسه‌های مجاز
T}
.T&
lt lt lt.
T{
.sp
عددی (Numeric)
T}:T{
.sp
7,089
T}:T{
.sp
0\-9
T}
T{
.sp
حرفی\-عددی (Alphanumeric)
T}:T{
.sp
4,296
T}:T{
.sp
0\-9، A\-Z (فقط حروف بزرگ)، و چند نماد (فاصله، \f(CR$\fP، \f(CR%\fP، \f(CR*\fP، \f(CR+\fP، \f(CR\-\fP،
\f(CR.\fP، \f(CR/\fP، \f(CR:\fP)
T}
T{
.sp
بایتی (Byte)
T}:T{
.sp
2,953
T}:T{
.sp
داده‌های باینری دلخواه
T}
T{
.sp
کانجی (Kanji)
T}:T{
.sp
1,817
T}:T{
.sp
هر نویسه دوبیتی JIS X 0208
T}
.TE
.sp
.sp
به‌طور پیش‌فرض، این دستور داده‌های ورودی را در یک کد QR با پیش‌زمینه مشکی
و پس‌زمینه سفید کدگذاری می‌کند، اما این مورد با تعیین
\fB\-\-foreground\fP و/یا \fB\-\-background\fP قابل تغییر است. یک \c
.URL "https://www.w3.org/TR/css\-color\-4" "رشته رنگ CSS" ""
می‌تواند
به عنوان مقدار این گزینه‌ها مشخص شود.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول ۲. فهرست روش‌های تعیین رنگ
.TS
allbox tab(:);
ltB ltB.
T{
.sp
قالب
T}:T{
.sp
مثال‌ها
T}
.T&
lt lt.
T{
.sp
رنگ‌های نام‌دار
T}:T{
.sp
\f(CRbrown\fP, \f(CRlightslategray\fP
T}
T{
.sp
نمادگذاری هگزادسیمال
T}:T{
.sp
\f(CR#111\fP, \f(CR#eee8\fP, \f(CR#a52a2a\fP, \f(CR#7788997f\fP
T}
T{
.sp
توابع RGB
T}:T{
.sp
\f(CRrgb(165 42 42)\fP, \f(CRrgb(119 136 153 / 49.8%)\fP
T}
T{
.sp
توابع HSL
T}:T{
.sp
\f(CRhsl(248 39% 39.2%)\fP, \f(CRhsl(0 0% 66.3% / 49.8%)\fP
T}
T{
.sp
تابع HWB
T}:T{
.sp
\f(CRhwb(50.6 0% 0%)\fP, \f(CRhwb(0 66.3% 33.7% / 49.8%)\fP
T}
T{
.sp
تابع Oklab
T}:T{
.sp
\f(CRoklab(50.4% \-0.0906 0.0069)\fP, \f(CRoklab(61.9% \-0.0120 \-0.0302 / 0.5)\fP
T}
T{
.sp
تابع Oklch
T}:T{
.sp
\f(CRoklch(59.41% 0.16 301.29)\fP, \f(CRoklch(61.9% 0.032 248.35 / 49.8%)\fP
T}
.TE
.sp
.sp
علاوه بر یک \c
.URL "https://www.qrcode.com/codes/model12.html" "کد QR معمولی" "،"
این دستور همچنین می‌تواند
داده‌های ورودی را در یک \c
.URL "https://www.qrcode.com/codes/microqr.html" "کد Micro QR" ""
و یک
.URL "https://www.qrcode.com/codes/rmqr.html" "کد rMQR" "."
کدگذاری کند.
.SH "آرگومان‌های مکانی (POSITIONAL ARGUMENTS)"
.sp
\fISTRING\fP
.RS 4
داده‌های ورودی. اگر \fISTRING\fP مشخص نشود، داده‌ها از ورودی استاندارد
خوانده خواهند شد. \fISTRING\fP باید یک رشته معتبر UTF\-8 باشد. در صورت استفاده از
داده‌هایی به جز رشته معتبر UTF\-8، از \fB\-\-read\-from\fP استفاده کرده یا داده را
از ورودی استاندارد بخوانید. این آرگومان مکانی با \fB\-\-read\-from\fP تداخل دارد.
.RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-o\fP, \fB\-\-output\fP \fIFILE\fP
.RS 4
خروجی دادن نتیجه در یک فایل.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-from\fP \fIFILE\fP
.RS 4
خواندن داده‌های ورودی از یک فایل. این گزینه با \fISTRING\fP تداخل دارد.
.RE
.sp
\fB\-s\fP, \fB\-\-size\fP \fINUMBER\fP
.RS 4
اندازه ماژول (خانه) بر حسب پیکسل. اگر این گزینه مشخص نشود، اندازه ماژول
زمانی که قالب خروجی PNG، SVG، EPS یا PIC باشد برابر ۸ و در غیر این صورت ۱ است.
.RE
.sp
\fB\-l\fP, \fB\-\-error\-correction\-level\fP \fILEVEL\fP
.RS 4
سطح تصحیح خطا.
.sp
مقادیر ممکن عبارتند از:
.RS 4
.sp
\fBl\fP
.RS 4
سطح L. امکان بازیابی ۷٪ از کلمات رمز (codewords).
.RE
.sp
\fBm\fP
.RS 4
سطح M. امکان بازیابی ۱۵٪ از کلمات رمز. این مقدار پیش‌فرض است.
.RE
.sp
\fBq\fP
.RS 4
سطح Q. امکان بازیابی ۲۵٪ از کلمات رمز.
.RE
.sp
\fBh\fP
.RS 4
سطح H. امکان بازیابی ۳۰٪ از کلمات رمز.
.RE
.RE
.RE
.sp
\fB\-\-level\fP \fILEVEL\fP
.RS 4
نام مستعار برای \fB\-l\fP، \fB\-\-error\-correction\-level\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-symbol\-version\fP \fINUMBER\fP [\fINUMBER\fP]
.RS 4
نگارش نماد. اگر این گزینه مشخص نشود، کمترین نگارش مورد نیاز برای ذخیره داده‌ها
به‌طور خودکار انتخاب خواهد شد. برای کد QR معمولی، \fINUMBER\fP باید بین \fB1\fP
و \fB40\fP باشد. برای کد Micro QR، \fINUMBER\fP باید بین \fB1\fP و \fB4\fP باشد. برای کد
rMQR، مقدار \fINUMBER\fP اول باید \fB7\fP، \fB9\fP، \fB11\fP، \fB13\fP، \fB15\fP یا \fB17\fP باشد.
مقدار \fINUMBER\fP دوم باید \fB27\fP، \fB43\fP، \fB59\fP، \fB77\fP، \fB99\fP یا \fB139\fP باشد.
مقدار \fB27\fP فقط می‌تواند با \fB11\fP یا \fB13\fP استفاده شود. اگر نوع کد QR چیزی
به‌جز کد rMQR باشد، \fINUMBER\fP دوم نادیده گرفته می‌شود.
.RE
.sp
\fB\-\-symversion\fP \fINUMBER\fP [\fINUMBER\fP]
.RS 4
نام مستعار برای \fB\-v\fP، \fB\-\-symbol\-version\fP.
.RE
.sp
\fB\-m\fP, \fB\-\-margin\fP \fINUMBER\fP
.RS 4
عرض حاشیه. اگر این گزینه مشخص نشود، حاشیه برای کد QR معمولی برابر ۴
و برای موارد دیگر ۲ خواهد بود.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fIFORMAT\fP
.RS 4
قالب خروجی.
.sp
مقادیر ممکن عبارتند از:
.RS 4
.sp
\fBpng\fP
.RS 4
تصویر Portable Network Graphics. این گزینه تصویر 32\-bit RGBA PNG تولید می‌کند.
این مقدار پیش‌فرض است.
.RE
.sp
\fBsvg\fP
.RS 4
تصویر برداری مقیاس‌پذیر (Scalable Vector Graphics).
.RE
.sp
\fBeps\fP
.RS 4
قالب Encapsulated PostScript.
.RE
.sp
\fBpic\fP
.RS 4
زبان نشانه‌گذاری PIC.
.RE
.sp
\fBansi\fP
.RS 4
خروجی به ترمینال با استفاده از توالی‌های فرار ۴ بیتی ANSI. این مقدار در صورتی
در دسترس است که قابلیت \f(CRoutput\-as\-ansi\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBansi256\fP
.RS 4
خروجی به ترمینال با استفاده از توالی‌های فرار ۸ بیتی ANSI. این مقدار در صورتی
در دسترس است که قابلیت \f(CRoutput\-as\-ansi\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBansi\-true\-color\fP
.RS 4
خروجی به ترمینال با استفاده از توالی‌های فرار ۲۴ بیتی ANSI. این مقدار در صورتی
در دسترس است که قابلیت \f(CRoutput\-as\-ansi\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBascii\fP
.RS 4
خروجی به ترمینال به عنوان رشته ASCII.
.RE
.sp
\fBascii\-invert\fP
.RS 4
خروجی به ترمینال به عنوان رشته ASCII. این مقدار رنگ‌های پیش‌زمینه و پس‌زمینه
\fBascii\fP را معکوس کرده و رشته معکوس‌شده را خروجی می‌دهد. \fBASCIIi\fP یک
نام مستعار برای این مقدار است.
.RE
.sp
\fBunicode\fP
.RS 4
خروجی به ترمینال به عنوان رشته UTF\-8. شناسه‌های \fBterminal\fP و \fBUTF8\fP نام‌های
مستعار برای این مقدار هستند.
.RE
.sp
\fBunicode\-invert\fP
.RS 4
خروجی به ترمینال به عنوان رشته UTF\-8. این مقدار رنگ‌های پیش‌زمینه و پس‌زمینه
\fBunicode\fP را معکوس کرده و رشته معکوس‌شده را خروجی می‌دهد. \fBUTF8i\fP یک
نام مستعار برای این مقدار است.
.RE
.RE
.RE
.sp
\fB\-\-optimize\-png\fP [\fILEVEL\fP]
.RS 4
تنظیم سطح بهینه‌سازی برای تصویر PNG. سطوح پایین‌تر سریع‌تر هستند، در حالی که
سطوح بالاتر فشرده‌سازی بهتری ارائه می‌دهند. اگر \fILEVEL\fP مشخص نشود، فرض می‌شود
سطح پیش‌فرض ۲ تعیین شده است. این گزینه در صورتی در دسترس است که قابلیت
\f(CRoptimize\-output\-png\fP در زمان کامپایل فعال باشد.
.sp
مقادیر ممکن عبارتند از:
.RS 4
.sp
\fB0\fP
.RS 4
سطح ۰. این مقدار کمترین سطح بهینه‌سازی است.
.RE
.sp
\fB1\fP
.RS 4
سطح ۱.
.RE
.sp
\fB2\fP
.RS 4
سطح ۲. این مقدار پیش‌فرض است.
.RE
.sp
\fB3\fP
.RS 4
سطح ۳.
.RE
.sp
\fB4\fP
.RS 4
سطح ۴.
.RE
.sp
\fB5\fP
.RS 4
سطح ۵.
.RE
.sp
\fB6\fP
.RS 4
سطح ۶. این مقدار بیشترین سطح بهینه‌سازی است.
.RE
.sp
\fBmax\fP
.RS 4
این مقدار یک نام مستعار برای بیشترین سطح بهینه‌سازی است.
.RE
.RE
.RE
.sp
\fB\-\-zopfli\fP [\fIITERATION\fP]
.RS 4
استفاده از Zopfli برای فشرده‌سازی تصویر PNG. فشرده‌سازی را به تعداد تکرارهای
تعیین‌شده توسط \fIITERATION\fP انجام می‌دهد. اگر \fIITERATION\fP مشخص نشود،
تعداد تکرارها به‌طور پیش‌فرض ۱۵ در نظر گرفته می‌شود. این گزینه نیازمند
\fB\-\-optimize\-png\fP است. این گزینه در صورتی در دسترس است که قابلیت
\f(CRoptimize\-output\-png\fP در زمان کامپایل فعال باشد.
.RE
.sp
\fB\-\-mode\fP \fIMODE\fP
.RS 4
حالت خروجی. اگر این گزینه مشخص نشود، از کدگذاری بهینه استفاده می‌شود. این
گزینه نیازمند \fB\-\-symbol\-version\fP است.
.sp
مقادیر ممکن عبارتند از:
.RS 4
.sp
\fBnumeric\fP
.RS 4
فقط ارقام عددی.
.RE
.sp
\fBalphanumeric\fP
.RS 4
نویسه‌های حرفی\-عددی و چند نماد.
.RE
.sp
\fBbyte\fP
.RS 4
داده‌های باینری دلخواه.
.RE
.sp
\fBkanji\fP
.RS 4
متن Shift JIS.
.RE
.RE
.RE
.sp
\fB\-\-variant\fP \fITYPE\fP
.RS 4
نوع کد QR.
.sp
مقادیر ممکن عبارتند از:
.RS 4
.sp
\fBnormal\fP
.RS 4
کد QR معمولی. این مقدار پیش‌فرض است.
.RE
.sp
\fBmicro\fP
.RS 4
کد Micro QR.
.RE
.sp
\fBrmqr\fP
.RS 4
کد rMQR.
.RE
.RE
.RE
.sp
\fB\-\-foreground\fP \fICOLOR\fP
.RS 4
رنگ پیش‌زمینه. \fICOLOR\fP یک رشته رنگ CSS می‌پذیرد. خروجی رنگی فقط زمانی در دسترس
است که قالب خروجی PNG، SVG یا هر یک از توالی‌های فرار ANSI باشد.
توجه داشته باشید که بسته به فضای رنگی پشتیبانی‌شده توسط روش تعیین رنگ، عمق
رنگ پشتیبانی‌شده توسط قالب خروجی و غیره ممکن است تبدیل با اتلاف انجام شود.
مقدار پیش‌فرض مشکی است.
.RE
.sp
\fB\-\-background\fP \fICOLOR\fP
.RS 4
رنگ پس‌زمینه. \fICOLOR\fP یک رشته رنگ CSS می‌پذیرد. خروجی رنگی فقط زمانی در دسترس
است که قالب خروجی PNG، SVG یا هر یک از توالی‌های فرار ANSI باشد.
توجه داشته باشید که بسته به فضای رنگی پشتیبانی‌شده توسط روش تعیین رنگ، عمق
رنگ پشتیبانی‌شده توسط قالب خروجی و غیره ممکن است تبدیل با اتلاف انجام شود.
مقدار پیش‌فرض سفید است.
.RE
.sp
\fB\-\-verbose\fP
.RS 4
چاپ فراداده (متادیتا) نیز انجام شود. خروجی به stderr ارسال می‌گردد.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ پیام راهنما. پرچم کوتاه (\fB\-h\fP) پیام راهنمای مختصر را چاپ می‌کند
در حالی که پرچم بلند (\fB\-\-help\fP) پیام راهنمای تفصیلی را چاپ خواهد کرد.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ شماره نگارش.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
اجرای موفقیت‌آمیز برنامه.
.RE
.sp
\fB1\fP
.RS 4
خطایی رخ داد.
.RE
.sp
\fB2\fP
.RS 4
هنگام تجزیه آرگومان‌های خط فرمان خطایی رخ داد.
.RE
.sp
وضعیت‌های خروج به جز موارد بالا توسط \c
.URL "https://man.openbsd.org/sysexits" "\f(CR<sysexits.h>\fP" ""
تعریف می‌شوند.
.SH "نکات (NOTES)"
.sp
مخزن منبع:
.RS 4
.URL "https://github.com/sorairolake/qrtool" "" ""
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
کدگذاری رشته داده‌شده در یک کد QR:
.RS 4
$ \fBqrtool encode "QR code" > output.png\fP
.RE
.sp
کدگذاری فایل داده‌شده و خروجی در تصویر مشخص‌شده:
.RS 4
$ \fBqrtool encode \-o output.png \-r go.mod\fP
.RE
.sp
کدگذاری در یک کد QR و خروجی به صورت تصویر SVG:
.RS 4
$ \fBqrtool encode \-t svg "QR code" > output.svg\fP
.RE
.sp
کدگذاری در یک کد Micro QR:
.RS 4
$ \fBqrtool encode \-\-variant micro "QR code" > output.png\fP
.RE
.sp
کدگذاری در یک کد QR با رنگ‌های مشخص‌شده:
.RS 4
$ \fBqrtool encode \-o output.png \-\-foreground brown \-\-background lightslategray "QR code"\fP
.RE
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
گزارش باگ‌ها به:
.RS 4
.URL "https://github.com/sorairolake/qrtool/issues" "" ""
.RE
.SH "حق نشر (COPYRIGHT)"
.sp
کپی‌رایت \(co 2022 متعلق به Shun Sakai و مشارکت‌کنندگان
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
این برنامه تحت شرایط مجوز Apache License 2.0 یا مجوز MIT توزیع می‌شود.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
این صفحه راهنما تحت شرایط مجوز Creative Commons
Attribution 4.0 International Public License توزیع می‌شود.
.RE
.sp
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. تا حد مجاز طبق
قانون، هیچ ضمانتی وجود ندارد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBoxipng\fP(1), \fBqrencode\fP(1), \fBqrtool\fP(1), \fBqrtool\-completion\fP(1),
\fBqrtool\-decode\fP(1)