QRTOOL-DECODE(1)

General Commands Manual

QRTOOL-DECODE(1)

نام (NAME)

qrtool-decode - تشخیص و رمزگشایی کد QR

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

qrtool decode [OPTION]... [IMAGE]

توضیحات (DESCRIPTION)

این دستور یک کد QR https://www.qrcode.com را از یک تصویر رستری یا برداری تشخیص داده و رمزگشایی می‌کند. به‌طور پیش‌فرض، نتیجه در خروجی استاندارد نوشته خواهد شد.

فرمت‌های پشتیبانی‌شده فایل تصویری

•BMP https://en.wikipedia.org/wiki/BMP_file_format (در صورت فعال بودن در زمان کامپایل)

•DDS https://en.wikipedia.org/wiki/DirectDraw_Surface (در صورت فعال بودن در زمان کامپایل)

•Farbfeld https://tools.suckless.org/farbfeld (در صورت فعال بودن در زمان کامپایل)

•GIF https://en.wikipedia.org/wiki/GIF (در صورت فعال بودن در زمان کامپایل)

•Radiance RGBE https://en.wikipedia.org/wiki/RGBE_image_format (در صورت فعال بودن در زمان کامپایل)

•ICO <https://en.wikipedia.org/wiki/ICO_(file_format)> (در صورت فعال بودن در زمان کامپایل)

•JPEG https://jpeg.org/jpeg (در صورت فعال بودن در زمان کامپایل)

•OpenEXR https://openexr.com (در صورت فعال بودن در زمان کامپایل)

•PNG https://en.wikipedia.org/wiki/PNG

•PNM https://netpbm.sourceforge.net/doc/pnm.html (در صورت فعال بودن در زمان کامپایل)

•QOI https://qoiformat.org (در صورت فعال بودن در زمان کامپایل)

•SVG https://www.w3.org/Graphics/SVG (در صورت فعال بودن در زمان کامپایل)

•TGA https://en.wikipedia.org/wiki/Truevision_TGA (در صورت فعال بودن در زمان کامپایل)

•TIFF https://en.wikipedia.org/wiki/TIFF (در صورت فعال بودن در زمان کامپایل)

•WebP https://developers.google.com/speed/webp (در صورت فعال بودن در زمان کامپایل)

•XBM https://en.wikipedia.org/wiki/X_BitMap (در صورت فعال بودن در زمان کامپایل)

برای تعیین قالب تصویر از گزینهٔ -t استفاده کنید. اگر این گزینه مشخص نشده باشد، قالب تصویر بر اساس پسوند یا عدد جادویی (magic number) تعیین می‌شود.

احتیاط

این دستور تنها از رمزگشایی
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)

IMAGE

فایل تصویر ورودی. اگر IMAGE مشخص نشده باشد، یا اگر «-» مشخص شود، تصویر از ورودی استاندارد خوانده خواهد شد. قالب‌های تصویر شطرنجی (رَستر) پشتیبانی‌شده بر اساس قالب‌های پشتیبانی‌شده توسط کریت image https://crates.io/crates/image هستند. در صورت امکان، قالب IMAGE بر اساس پسوند یا عدد جادویی (magic number) تعیین می‌شود. اگر قالب قابل تشخیص نباشد، از --type استفاده کنید. توجه داشته باشید که تصویر SVG پیش از اسکن رَستِرایز می‌شود.

-t, --type FORMAT

قالب ورودی. اگر FORMAT مشخص نشود، قالب بر اساس پسوند یا عدد جادویی (magic number) تعیین می‌شود.

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

bmp

‏Windows Bitmap. این مقدار در صورتی در دسترس است که ویژگی decode-from-bmp در زمان کامپایل فعال شده باشد.

dds

‏DirectDraw Surface. این مقدار در صورتی در دسترس است که ویژگی decode-from-dds در زمان کامپایل فعال شده باشد.

farbfeld

‏Farbfeld. این مقدار در صورتی در دسترس است که ویژگی decode-from-ff در زمان کامپایل فعال شده باشد.

gif

‏Graphics Interchange Format. این مقدار در صورتی در دسترس است که ویژگی decode-from-gif در زمان کامپایل فعال شده باشد.

hdr

‏Radiance RGBE. این مقدار در صورتی در دسترس است که ویژگی decode-from-hdr در زمان کامپایل فعال شده باشد.

ico

قالب فایل ICO. این مقدار همچنین شامل قالب فایل CUR نیز می‌شود. این مقدار در صورتی در دسترس است که ویژگی decode-from-ico در زمان کامپایل فعال شده باشد.

jpeg

‏JPEG. این مقدار در صورتی در دسترس است که ویژگی decode-from-jpeg در زمان کامپایل فعال شده باشد.

openexr

‏OpenEXR. این مقدار در صورتی در دسترس است که ویژگی decode-from-exr در زمان کامپایل فعال شده باشد.

png

‏Portable Network Graphics.

pnm

‏Portable Anymap Format. این مقدار در صورتی در دسترس است که ویژگی decode-from-pnm در زمان کامپایل فعال شده باشد.

qoi

‏Quite OK Image Format. این مقدار در صورتی در دسترس است که ویژگی decode-from-qoi در زمان کامپایل فعال شده باشد.

svg

‏Scalable Vector Graphics. این مقدار همچنین تصویر SVG فشرده‌شده با gzip را شامل می‌شود. این مقدار در صورتی در دسترس است که ویژگی decode-from-svg در زمان کامپایل فعال شده باشد.

tga

‏Truevision TGA. این مقدار در صورتی در دسترس است که ویژگی decode-from-tga در زمان کامپایل فعال شده باشد.

tiff

‏Tag Image File Format. این مقدار در صورتی در دسترس است که ویژگی decode-from-tiff در زمان کامپایل فعال شده باشد.

webp

‏WebP. این مقدار در صورتی در دسترس است که ویژگی decode-from-webp در زمان کامپایل فعال شده باشد.

xbm

‏X BitMap. این مقدار در صورتی در دسترس است که ویژگی decode-from-xbm در زمان کامپایل فعال شده باشد.

--verbose

فراداده (metadata) را نیز چاپ می‌کند. این خروجی به stderr ارسال می‌شود. این گزینه با --metadata تداخل دارد.

--metadata

تنها فراداده (metadata) را چاپ می‌کند. این خروجی به stderr ارسال می‌شود. این گزینه با --verbose تداخل دارد.

-h, --help

پیام راهنما را چاپ می‌کند. پرچم کوتاه (-h) یک پیام راهنمای مختصر و پرچم بلند (--help) پیام راهنمای دقیقی را نمایش خواهد داد.

-V, --version

چاپ شماره نسخه.

اجرای موفقیت‌آمیز برنامه.

خطایی رخ داد.

هنگام تجزیه آرگومان‌های خط فرمان خطایی رخ داد.

وضعیت‌های خروج غیر از این موارد در <sysexits.h> https://man.openbsd.org/sysexits تعریف شده‌اند.

نکات (NOTES)

مخزن کد مبدأ:

https://github.com/sorairolake/qrtool

مثال‌ها (EXAMPLES)

تشخیص و رمزگشایی یک کد QR از تصویر داده‌شده:

$ qrtool decode input.png

رمزگشایی یک کد QR از تصویر WebP داده‌شده:

$ qrtool decode -t webp input.webp

چاپ فراداده نیز هنگام رمزگشایی یک کد QR:

$ qrtool decode --verbose input.qoi

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به:

https://github.com/sorairolake/qrtool/issues

کپی‌رایت و تکثیر (COPYRIGHT)

1.این برنامه تحت شرایط یکی از مجوزهای Apache License 2.0 یا MIT License توزیع می‌شود.

2.این صفحهٔ راهنما تحت شرایط مجوز Creative Commons Attribution 4.0 International Public License توزیع می‌شود.

این یک نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

همچنین ببینید (SEE ALSO)

qrtool(1), qrtool-completion(1), qrtool-encode(1), zbarimg(1)

2025-11-28

qrtool 0.13.2