QRTOOL-ENCODE(1)

General Commands Manual

QRTOOL-ENCODE(1)

نام (NAME)

qrtool-encode - کدگذاری داده‌های ورودی در یک کد QR

خلاصه دستور (SYNOPSIS)

qrtool encode [OPTION]... [STRING]

توضیحات (DESCRIPTION)

این دستور داده‌های ورودی را در یک کد QR https://www.qrcode.com کدگذاری کرده و آن را به عنوان تصویر PNG، تصویر SVG، رشته متنی یا سایر قالب‌ها خروجی می‌دهد. به‌طور پیش‌فرض، نتیجه در خروجی استاندارد چاپ خواهد شد.

این دستور تا حداکثر ۷,۰۹۰ بایت نخست داده‌های ورودی را می‌خواند. مقدار داده‌ای که می‌تواند توسط یک کد QR نمایش داده شود به حالت، نگارش و سطح تصحیح خطا بستگی دارد. بیشترین ظرفیت ذخیره‌سازی برای نگارش ۴۰ و سطح تصحیح خطای L است (40-L).

جدول ۱. حداکثر ظرفیت ذخیره‌سازی نویسه‌ها (40-L)

حالت ورودی	حداکثر نویسه‌ها	نویسه‌های مجاز
عددی (Numeric)	7,089	0-9
حرفی-عددی (Alphanumeric)	4,296	0-9، A-Z (فقط حروف بزرگ)، و چند نماد (فاصله، $، %، *، +، -، .، /، :)
بایتی (Byte)	2,953	داده‌های باینری دلخواه
کانجی (Kanji)	1,817	هر نویسه دوبیتی JIS X 0208

به‌طور پیش‌فرض، این دستور داده‌های ورودی را در یک کد QR با پیش‌زمینه مشکی
و پس‌زمینه سفید کدگذاری می‌کند، اما این مورد با تعیین --foreground و/یا --background قابل تغییر است. یک رشته رنگ CSS https://www.w3.org/TR/css-color-4 می‌تواند به عنوان مقدار این گزینه‌ها مشخص شود.

جدول ۲. فهرست روش‌های تعیین رنگ

قالب	مثال‌ها
رنگ‌های نام‌دار	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 معمولی https://www.qrcode.com/codes/model12.html، این دستور همچنین می‌تواند داده‌های ورودی را در یک کد Micro QR https://www.qrcode.com/codes/microqr.html و یک کد rMQR https://www.qrcode.com/codes/rmqr.html. کدگذاری کند.

آرگومان‌های مکانی (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. امکان بازیابی ۷٪ از کلمات رمز (codewords).

سطح M. امکان بازیابی ۱۵٪ از کلمات رمز. این مقدار پیش‌فرض است.

سطح Q. امکان بازیابی ۲۵٪ از کلمات رمز.

سطح 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 در زمان کامپایل فعال باشد.

مقادیر ممکن عبارتند از:

سطح ۰. این مقدار کمترین سطح بهینه‌سازی است.

سطح ۱.

سطح ۲. این مقدار پیش‌فرض است.

سطح ۳.

سطح ۴.

سطح ۵.

سطح ۶. این مقدار بیشترین سطح بهینه‌سازی است.

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

چاپ شماره نگارش.