'\" t
.\"     Title: qrtool-decode
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-28
.\"    Manual: General Commands Manual
.\"    Source: qrtool 0.13.2
.\"  Language: English
.\"
.TH "QRTOOL\-DECODE" "1" "2025-11-28" "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-decode \- تشخیص و رمزگشایی کد QR
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBqrtool decode\fP [\fIOPTION\fP].\|.\|. [\fIIMAGE\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور یک \c
.URL "https://www.qrcode.com" "کد QR" ""
را از یک تصویر رستری یا برداری تشخیص داده و رمزگشایی می‌کند. به‌طور پیش‌فرض، نتیجه در خروجی استاندارد نوشته خواهد شد.
.sp
.B فرمت‌های پشتیبانی‌شده فایل تصویری
.br
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/BMP_file_format" "BMP" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/DirectDraw_Surface" "DDS" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://tools.suckless.org/farbfeld" "Farbfeld" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/GIF" "GIF" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/RGBE_image_format" "Radiance RGBE" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/ICO_(file_format)" "ICO" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://jpeg.org/jpeg" "JPEG" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://openexr.com" "OpenEXR" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/PNG" "PNG" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://netpbm.sourceforge.net/doc/pnm.html" "PNM" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://qoiformat.org" "QOI" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://www.w3.org/Graphics/SVG" "SVG" ""
(در صورت فعال بودن در زمان کامپایل)
.RE.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/Truevision_TGA" "TGA" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/TIFF" "TIFF" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://developers.google.com/speed/webp" "WebP" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://en.wikipedia.org/wiki/X_BitMap" "XBM" ""
(در صورت فعال بودن در زمان کامپایل)
.RE
.sp
برای تعیین قالب تصویر از گزینهٔ \fB\-t\fP استفاده کنید. اگر این گزینه مشخص نشده باشد،
قالب تصویر بر اساس پسوند یا عدد جادویی (magic number) تعیین می‌شود.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B احتیاط
.ps -1
.br
.sp
این دستور تنها از رمزگشایی
.URL "https://www.qrcode.com/codes/model12.html" "QR کد عادی" ""
پشتیبانی می‌کند و از رمزگشایی
.URL "https://www.qrcode.com/codes/microqr.html" "Micro QR کد" ""
و
.URL "https://www.qrcode.com/codes/rmqr.html" "rMQR کد" " پشتیبانی نمی‌کند."
.sp .5v
.RE
.SH "آرگومان‌های مکانی (POSITIONAL ARGUMENTS)"
.sp
\fIIMAGE\fP
.RS 4
فایل تصویر ورودی. اگر \fIIMAGE\fP مشخص نشده باشد، یا اگر «\-» مشخص شود، تصویر
از ورودی استاندارد خوانده خواهد شد. قالب‌های تصویر شطرنجی (رَستر) پشتیبانی‌شده
بر اساس قالب‌های پشتیبانی‌شده توسط کریت \c
.URL "https://crates.io/crates/image" "\f(CRimage\fP" ""
هستند. در صورت امکان،
قالب \fIIMAGE\fP بر اساس پسوند یا عدد جادویی (magic number) تعیین می‌شود.
اگر قالب قابل تشخیص نباشد، از \fB\-\-type\fP استفاده کنید. توجه داشته باشید که تصویر
SVG پیش از اسکن رَستِرایز می‌شود.
.RE.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-t\fP, \fB\-\-type\fP \fIFORMAT\fP
.RS 4
قالب ورودی. اگر \fIFORMAT\fP مشخص نشود، قالب بر اساس پسوند یا عدد جادویی (magic number)
تعیین می‌شود.
.sp
مقادیر ممکن عبارتند از:
.RS 4
.sp
\fBbmp\fP
.RS 4
‏Windows Bitmap. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-bmp\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBdds\fP
.RS 4
‏DirectDraw Surface. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-dds\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBfarbfeld\fP
.RS 4
‏Farbfeld. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-ff\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBgif\fP
.RS 4
‏Graphics Interchange Format. این مقدار در صورتی در دسترس است که ویژگی
\f(CRdecode\-from\-gif\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBhdr\fP
.RS 4
‏Radiance RGBE. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-hdr\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBico\fP
.RS 4
قالب فایل ICO. این مقدار همچنین شامل قالب فایل CUR نیز می‌شود. این مقدار
در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-ico\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBjpeg\fP
.RS 4
‏JPEG. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-jpeg\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBopenexr\fP
.RS 4
‏OpenEXR. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-exr\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBpng\fP
.RS 4
‏Portable Network Graphics.
.RE
.sp
\fBpnm\fP
.RS 4
‏Portable Anymap Format. این مقدار در صورتی در دسترس است که ویژگی
\f(CRdecode\-from\-pnm\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBqoi\fP
.RS 4
‏Quite OK Image Format. این مقدار در صورتی در دسترس است که ویژگی
\f(CRdecode\-from\-qoi\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBsvg\fP
.RS 4
‏Scalable Vector Graphics. این مقدار همچنین تصویر SVG فشرده‌شده با
gzip را شامل می‌شود. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-svg\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBtga\fP
.RS 4
‏Truevision TGA. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-tga\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBtiff\fP
.RS 4
‏Tag Image File Format. این مقدار در صورتی در دسترس است که ویژگی
\f(CRdecode\-from\-tiff\fP در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBwebp\fP
.RS 4
‏WebP. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-webp\fP
در زمان کامپایل فعال شده باشد.
.RE
.sp
\fBxbm\fP
.RS 4
‏X BitMap. این مقدار در صورتی در دسترس است که ویژگی \f(CRdecode\-from\-xbm\fP
در زمان کامپایل فعال شده باشد.
.RE
.RE
.RE
.sp
\fB\-\-verbose\fP
.RS 4
فراداده (metadata) را نیز چاپ می‌کند. این خروجی به stderr ارسال می‌شود. این گزینه با
\fB\-\-metadata\fP تداخل دارد.
.RE
.sp
\fB\-\-metadata\fP
.RS 4
تنها فراداده (metadata) را چاپ می‌کند. این خروجی به stderr ارسال می‌شود. این گزینه با
\fB\-\-verbose\fP تداخل دارد.
.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
وضعیت‌های خروج غیر از این موارد در
.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 decode input.png\fP
.RE
.sp
رمزگشایی یک کد QR از تصویر WebP داده‌شده:
.RS 4
$ \fBqrtool decode \-t webp input.webp\fP
.RE
.sp
چاپ فراداده نیز هنگام رمزگشایی یک کد QR:
.RS 4
$ \fBqrtool decode \-\-verbose input.qoi\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 License توزیع می‌شود.
.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
\fBqrtool\fP(1), \fBqrtool\-completion\fP(1), \fBqrtool\-encode\fP(1), \fBzbarimg\fP(1)