QRTOOL-ENCODE(1) General Commands Manual QRTOOL-ENCODE(1) نام (NAME) qrtool-encode - کدگذاری داده‌های ورودی در یک کد QR خلاصه دستور (SYNOPSIS) qrtool encode [OPTION]... [STRING] توضیحات (DESCRIPTION) این دستور داده‌های ورودی را در یک کد QR کدگذاری کرده و آن را به عنوان تصویر PNG، تصویر SVG، رشته متنی یا سایر قالب‌ها خروجی می‌دهد. به‌طور پیش‌فرض، نتیجه در خروجی استاندارد چاپ خواهد شد. این دستور تا حداکثر ۷,۰۹۰ بایت نخست داده‌های ورودی را می‌خواند. مقدار داده‌ای که می‌تواند توسط یک کد QR نمایش داده شود به حالت، نگارش و سطح تصحیح خطا بستگی دارد. بیشترین ظرفیت ذخیره‌سازی برای نگارش ۴۰ و سطح تصحیح خطای L است (40-L). جدول ۱. حداکثر ظرفیت ذخیره‌سازی نویسه‌ها (40-L) ┌───────────────┬────────────────┬─────────────────────┐ │حالت ورودی │ حداکثر نویسه‌ها │ نویسه‌های مجاز │ ├───────────────┼────────────────┼─────────────────────┤ │عددی (Numeric) │ 7,089 │ 0-9 │ ├───────────────┼────────────────┼─────────────────────┤ │حرفی-عددی │ 4,296 │ 0-9، A-Z (فقط حروف │ │(Alphanumeric) │ │ بزرگ)، و چند نماد │ │ │ │ (فاصله، $، %، *، +، │ │ │ │ -، .، /، :) │ ├───────────────┼────────────────┼─────────────────────┤ │بایتی (Byte) │ 2,953 │ داده‌های باینری │ │ │ │ دلخواه │ ├───────────────┼────────────────┼─────────────────────┤ │کانجی (Kanji) │ 1,817 │ هر نویسه دوبیتی JIS │ │ │ │ X 0208 │ └───────────────┴────────────────┴─────────────────────┘ به‌طور پیش‌فرض، این دستور داده‌های ورودی را در یک کد QR با پیش‌زمینه مشکی و پس‌زمینه سفید کدگذاری می‌کند، اما این مورد با تعیین --foreground و/یا --background قابل تغییر است. یک رشته رنگ CSS می‌تواند به عنوان مقدار این گزینه‌ها مشخص شود. جدول ۲. فهرست روش‌های تعیین رنگ ┌─────────────────────┬────────────────────────────┐ │قالب │ مثال‌ها │ ├─────────────────────┼────────────────────────────┤ │رنگ‌های نام‌دار │ brown, lightslategray │ ├─────────────────────┼────────────────────────────┤ │نمادگذاری هگزادسیمال │ #111, #eee8, #a52a2a, │ │ │ #7788997f │ ├─────────────────────┼────────────────────────────┤ │توابع RGB │ rgb(165 42 42), rgb(119 │ │ │ 136 153 / 49.8%) │ ├─────────────────────┼────────────────────────────┤ │توابع HSL │ hsl(248 39% 39.2%), hsl(0 │ │ │ 0% 66.3% / 49.8%) │ ├─────────────────────┼────────────────────────────┤ │تابع HWB │ hwb(50.6 0% 0%), hwb(0 │ │ │ 66.3% 33.7% / 49.8%) │ ├─────────────────────┼────────────────────────────┤ │تابع Oklab │ oklab(50.4% -0.0906 │ │ │ 0.0069), oklab(61.9% │ │ │ -0.0120 -0.0302 / 0.5) │ ├─────────────────────┼────────────────────────────┤ │تابع Oklch │ oklch(59.41% 0.16 301.29), │ │ │ oklch(61.9% 0.032 248.35 / │ │ │ 49.8%) │ └─────────────────────┴────────────────────────────┘ علاوه بر یک کد QR معمولی ، این دستور همچنین می‌تواند داده‌های ورودی را در یک کد Micro QR و یک کد rMQR . کدگذاری کند. آرگومان‌های مکانی (POSITIONAL ARGUMENTS) STRING داده‌های ورودی. اگر STRING مشخص نشود، داده‌ها از ورودی استاندارد خوانده خواهند شد. STRING باید یک رشته معتبر UTF-8 باشد. در صورت استفاده از داده‌هایی به جز رشته معتبر UTF-8، از --read-from استفاده کرده یا داده را از ورودی استاندارد بخوانید. این آرگومان مکانی با --read-from تداخل دارد. گزینه‌ها (OPTIONS) -o, --output FILE خروجی دادن نتیجه در یک فایل. -r, --read-from FILE خواندن داده‌های ورودی از یک فایل. این گزینه با STRING تداخل دارد. -s, --size NUMBER اندازه ماژول (خانه) بر حسب پیکسل. اگر این گزینه مشخص نشود، اندازه ماژول زمانی که قالب خروجی PNG، SVG، EPS یا PIC باشد برابر ۸ و در غیر این صورت ۱ است. -l, --error-correction-level LEVEL سطح تصحیح خطا. مقادیر ممکن عبارتند از: l سطح L. امکان بازیابی ۷٪ از کلمات رمز (codewords). m سطح M. امکان بازیابی ۱۵٪ از کلمات رمز. این مقدار پیش‌فرض است. q سطح Q. امکان بازیابی ۲۵٪ از کلمات رمز. h سطح H. امکان بازیابی ۳۰٪ از کلمات رمز. --level LEVEL نام مستعار برای -l، --error-correction-level. -v, --symbol-version NUMBER [NUMBER] نگارش نماد. اگر این گزینه مشخص نشود، کمترین نگارش مورد نیاز برای ذخیره داده‌ها به‌طور خودکار انتخاب خواهد شد. برای کد QR معمولی، NUMBER باید بین 1 و 40 باشد. برای کد Micro QR، NUMBER باید بین 1 و 4 باشد. برای کد rMQR، مقدار NUMBER اول باید 7، 9، 11، 13، 15 یا 17 باشد. مقدار NUMBER دوم باید 27، 43، 59، 77، 99 یا 139 باشد. مقدار 27 فقط می‌تواند با 11 یا 13 استفاده شود. اگر نوع کد QR چیزی به‌جز کد rMQR باشد، NUMBER دوم نادیده گرفته می‌شود. --symversion NUMBER [NUMBER] نام مستعار برای -v، --symbol-version. -m, --margin NUMBER عرض حاشیه. اگر این گزینه مشخص نشود، حاشیه برای کد QR معمولی برابر ۴ و برای موارد دیگر ۲ خواهد بود. -t, --type FORMAT قالب خروجی. مقادیر ممکن عبارتند از: png تصویر Portable Network Graphics. این گزینه تصویر 32-bit RGBA PNG تولید می‌کند. این مقدار پیش‌فرض است. svg تصویر برداری مقیاس‌پذیر (Scalable Vector Graphics). eps قالب Encapsulated PostScript. pic زبان نشانه‌گذاری PIC. ansi خروجی به ترمینال با استفاده از توالی‌های فرار ۴ بیتی ANSI. این مقدار در صورتی در دسترس است که قابلیت output-as-ansi در زمان کامپایل فعال شده باشد. ansi256 خروجی به ترمینال با استفاده از توالی‌های فرار ۸ بیتی ANSI. این مقدار در صورتی در دسترس است که قابلیت output-as-ansi در زمان کامپایل فعال شده باشد. ansi-true-color خروجی به ترمینال با استفاده از توالی‌های فرار ۲۴ بیتی ANSI. این مقدار در صورتی در دسترس است که قابلیت output-as-ansi در زمان کامپایل فعال شده باشد. ascii خروجی به ترمینال به عنوان رشته ASCII. ascii-invert خروجی به ترمینال به عنوان رشته ASCII. این مقدار رنگ‌های پیش‌زمینه و پس‌زمینه ascii را معکوس کرده و رشته معکوس‌شده را خروجی می‌دهد. ASCIIi یک نام مستعار برای این مقدار است. unicode خروجی به ترمینال به عنوان رشته UTF-8. شناسه‌های terminal و UTF8 نام‌های مستعار برای این مقدار هستند. unicode-invert خروجی به ترمینال به عنوان رشته UTF-8. این مقدار رنگ‌های پیش‌زمینه و پس‌زمینه unicode را معکوس کرده و رشته معکوس‌شده را خروجی می‌دهد. UTF8i یک نام مستعار برای این مقدار است. --optimize-png [LEVEL] تنظیم سطح بهینه‌سازی برای تصویر PNG. سطوح پایین‌تر سریع‌تر هستند، در حالی که سطوح بالاتر فشرده‌سازی بهتری ارائه می‌دهند. اگر LEVEL مشخص نشود، فرض می‌شود سطح پیش‌فرض ۲ تعیین شده است. این گزینه در صورتی در دسترس است که قابلیت optimize-output-png در زمان کامپایل فعال باشد. مقادیر ممکن عبارتند از: 0 سطح ۰. این مقدار کمترین سطح بهینه‌سازی است. 1 سطح ۱. 2 سطح ۲. این مقدار پیش‌فرض است. 3 سطح ۳. 4 سطح ۴. 5 سطح ۵. 6 سطح ۶. این مقدار بیشترین سطح بهینه‌سازی است. max این مقدار یک نام مستعار برای بیشترین سطح بهینه‌سازی است. --zopfli [ITERATION] استفاده از Zopfli برای فشرده‌سازی تصویر PNG. فشرده‌سازی را به تعداد تکرارهای تعیین‌شده توسط ITERATION انجام می‌دهد. اگر ITERATION مشخص نشود، تعداد تکرارها به‌طور پیش‌فرض ۱۵ در نظر گرفته می‌شود. این گزینه نیازمند --optimize-png است. این گزینه در صورتی در دسترس است که قابلیت optimize-output-png در زمان کامپایل فعال باشد. --mode MODE حالت خروجی. اگر این گزینه مشخص نشود، از کدگذاری بهینه استفاده می‌شود. این گزینه نیازمند --symbol-version است. مقادیر ممکن عبارتند از: numeric فقط ارقام عددی. alphanumeric نویسه‌های حرفی-عددی و چند نماد. byte داده‌های باینری دلخواه. kanji متن Shift JIS. --variant TYPE نوع کد QR. مقادیر ممکن عبارتند از: normal کد QR معمولی. این مقدار پیش‌فرض است. micro کد Micro QR. rmqr کد rMQR. --foreground COLOR رنگ پیش‌زمینه. COLOR یک رشته رنگ CSS می‌پذیرد. خروجی رنگی فقط زمانی در دسترس است که قالب خروجی PNG، SVG یا هر یک از توالی‌های فرار ANSI باشد. توجه داشته باشید که بسته به فضای رنگی پشتیبانی‌شده توسط روش تعیین رنگ، عمق رنگ پشتیبانی‌شده توسط قالب خروجی و غیره ممکن است تبدیل با اتلاف انجام شود. مقدار پیش‌فرض مشکی است. --background COLOR رنگ پس‌زمینه. COLOR یک رشته رنگ CSS می‌پذیرد. خروجی رنگی فقط زمانی در دسترس است که قالب خروجی PNG، SVG یا هر یک از توالی‌های فرار ANSI باشد. توجه داشته باشید که بسته به فضای رنگی پشتیبانی‌شده توسط روش تعیین رنگ، عمق رنگ پشتیبانی‌شده توسط قالب خروجی و غیره ممکن است تبدیل با اتلاف انجام شود. مقدار پیش‌فرض سفید است. --verbose چاپ فراداده (متادیتا) نیز انجام شود. خروجی به stderr ارسال می‌گردد. -h, --help چاپ پیام راهنما. پرچم کوتاه (-h) پیام راهنمای مختصر را چاپ می‌کند در حالی که پرچم بلند (--help) پیام راهنمای تفصیلی را چاپ خواهد کرد. -V, --version چاپ شماره نگارش. وضعیت خروج (EXIT STATUS) 0 اجرای موفقیت‌آمیز برنامه. 1 خطایی رخ داد. 2 هنگام تجزیه آرگومان‌های خط فرمان خطایی رخ داد. وضعیت‌های خروج به جز موارد بالا توسط تعریف می‌شوند. نکات (NOTES) مخزن منبع: مثال‌ها (EXAMPLES) کدگذاری رشته داده‌شده در یک کد QR: $ qrtool encode "QR code" > output.png کدگذاری فایل داده‌شده و خروجی در تصویر مشخص‌شده: $ qrtool encode -o output.png -r go.mod کدگذاری در یک کد QR و خروجی به صورت تصویر SVG: $ qrtool encode -t svg "QR code" > output.svg کدگذاری در یک کد Micro QR: $ qrtool encode --variant micro "QR code" > output.png کدگذاری در یک کد QR با رنگ‌های مشخص‌شده: $ qrtool encode -o output.png --foreground brown --background lightslategray "QR code" گزارش باگ‌ها (REPORTING BUGS) گزارش باگ‌ها به: حق نشر (COPYRIGHT) کپی‌رایت © 2022 متعلق به Shun Sakai و مشارکت‌کنندگان 1. این برنامه تحت شرایط مجوز Apache License 2.0 یا مجوز MIT توزیع می‌شود. 2. این صفحه راهنما تحت شرایط مجوز Creative Commons Attribution 4.0 International Public License توزیع می‌شود. این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. تا حد مجاز طبق قانون، هیچ ضمانتی وجود ندارد. همچنین ببینید (SEE ALSO) oxipng(1), qrencode(1), qrtool(1), qrtool-completion(1), qrtool-decode(1) qrtool 0.13.2 2025-11-08 QRTOOL-ENCODE(1)