نام (NAME)

qrencode - کدگذاری داده‌های ورودی در یک QR Code و ذخیره به‌صورت تصویر PNG یا EPS.

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

qrencode [-o FILENAME] [OPTION]... [STRING]

توضیحات (DESCRIPTION)

کتابخانهٔ Libqrencode ابزاری برای کدگذاری داده‌ها در نماد QR Code است؛ نوعی نمادشناسی دوبُعدی (2D) که می‌تواند توسط پایانه‌های دستی مانند تلفن همراه مجهز به CCD پویش شود. گنجایش QR Code حداکثر تا ۷۰۰۰ رقم یا ۴۰۰۰ نویسه بوده و دارای پایداری و مقاومت بالایی است.

برنامهٔ Qrencode ابزاری کاربردی است که با بهره‌گیری از libqrencode، داده‌های رشته‌ای را در یک QR Code کدگذاری کرده و به‌صورت تصویر PNG یا EPS ذخیره می‌کند.

گزینه‌ها (OPTIONS)

-h, --help: نمایش پیام راهنما.
-o FILENAME, --output=FILENAME: نوشتن تصویر در FILENAME. اگر '-' مشخص شود، نتیجه در خروجی استاندارد نوشته می‌شود. اگر -S داده شود، نمادهای ساختاریافته در FILENAME-01.png و FILENAME-02.png و... ذخیره می‌شوند (در صورت مشخص بودن، پسوند از FILENAME حذف می‌شود).
-r FILENAME, --read-from=FILENAME: خواندن داده‌های ورودی از FILENAME.
-s NUMBER, --size=NUMBER: تعیین اندازهٔ نقطه (پیکسل). (پیش‌فرض=3)
-l {LMQH}, --level={LMQH}: تعیین سطح تصحیح خطا از L (کمترین) تا H (بیشترین). (پیش‌فرض=L)
-v NUMBER, --symversion=NUMBER: تعیین کمینهٔ نسخهٔ نماد. برای اطلاعات بیشتر بخش «نسخه‌های نماد (SYMBOL VERSIONS)» را ببینید. (پیش‌فرض=auto)
-m NUMBER, --margin=NUMBER: تعیین عرض حاشیه. (پیش‌فرض=4)
-d NUMBER, --dpi=NUMBER: تعیین میزان DPI تصویر PNG تولیدشده. (پیش‌فرض=72)
-t {PNG,PNG32,EPS,SVG,XPM,ANSI,ANSI256,ASCII,ASCIIi,UTF8,UTF8i,ANSIUTF8,ANSIUTF8i,ANSI256UTF8}
--type={PNG,PNG32,EPS,SVG,XPM,ANSI,ANSI256,ASCII,ASCIIi,UTF8,UTF8i,ANSIUTF8,ANSIUTF8i,ANSI256UTF8}: تعیین نوع تصویر تولیدشده. (پیش‌فرض=PNG)
-S, --structured: ایجاد نمادهای ساختاریافته. شمارهٔ نسخه باید با '-v' مشخص شود.
-k, --kanji: فرض کردن اینکه متن ورودی شامل کانجی (shift-jis) است.
-c, --casesensitive: کدگذاری نویسه‌های کوچک الفبا در حالت ۸ بیتی. (پیش‌فرض)
-i, --ignorecase: نادیده گرفتن تمایز حروف کوچک و بزرگ و تنها استفاده از حروف بزرگ.
-8, --8bit: کدگذاری تمام داده‌ها در حالت ۸ بیتی. گزینه‌های -k، -c و -i نادیده گرفته خواهند شد.
-M, --micro: کدگذاری در یک Micro QR Code. برای اطلاعات بیشتر بخش «میکرو کیوآر کد (MICRO QR CODE)» را ببینید.
--rle: فعال‌سازی کدگذاری طول اجرا (RLE) برای SVG.
--svg-path: استفاده از یک مسیر (path) واحد برای رسم ماژول‌ها در SVG.
--inline: تنها برای خروجی SVG کاربرد دارد؛ یک خروجی SVG بدون برچسب XML تولید می‌کند.
--foreground=RRGGBB[AA]
--background=RRGGBB[AA]: تعیین رنگ پیش‌زمینه/پس‌زمینه در نمادگذاری هگزادسیمال. فرمت‌های ۶ رقمی (RGB) یا ۸ رقمی (RGBA) پشتیبانی می‌شوند. پشتیبانی از خروجی رنگی تنها در PNG، EPS و SVG امکان‌پذیر است.
--strict-version: غیرفعال‌سازی تنظیم خودکار شمارهٔ نسخه. اگر داده‌های ورودی برای نسخهٔ مشخص‌شده بیش از حد بزرگ باشند، برنامه با کد خروج ۱ خارج می‌شود.
-V, --version: نمایش شمارهٔ نسخه و حق نشر qrencode.
--verbose: نمایش اطلاعات دقیق و مشروح در stderr.
[STRING]: داده‌های ورودی. اگر مشخص نشود، داده‌ها از ورودی استاندارد دریافت خواهند شد.

نسخه‌های نماد (SYMBOL VERSIONS)

نسخه‌های نماد QR Code از نسخهٔ ۱ تا نسخهٔ ۴۰ را شامل می‌شود. هر نسخه پیکربندی یا تعداد ماژول متفاوتی دارد که از نسخهٔ ۱ (۲۱ در ۲۱ ماژول) تا نسخهٔ ۴۰ (۱۷۷ در ۱۷۷ ماژول) متغیر است. به‌طور پیش‌فرض، هر نسخهٔ بالاتر شامل ۴ ماژول اضافی در هر ضلع است. برای مشاهدهٔ فهرست تفصیلی نسخه‌ها به http://www.qrcode.com/en/about/version.html مراجعه کنید.

میکرو کیوآر کد (MICRO QR CODE)

با Micro QR Code می‌توانید داده‌ها را در فضایی کوچک‌تر نسبت به QR Code جای دهید، اما ظرفیت داده‌ها به‌شدت محدود است. نسخه‌های این نماد از نسخهٔ ۱ تا ۴ متغیر هستند.

مثال‌ها (EXAMPLES)

qrencode -l L -v 1 -o output.png 'Hello, world!': کدگذاری در یک نماد با نسخهٔ ۱ و سطح L.
qrencode -iSv 1 --output=output.png: خواندن از ورودی استاندارد و کدگذاری آن در نمادهای پیوست‌شدهٔ ساختاریافته بدون حساسیت به حروف کوچک و بزرگ.
qrencode -S -v 40 -l L -r bigfile.txt -o output.png: خواندن داده‌های ورودی از bigfile.txt و کدگذاری در یک نماد با نسخهٔ ۴۰ و سطح L.