\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "G3topbm User Manual" 0 "02 July 2023" "netpbm documentation"

.SH "نام (NAME)"
g3topbm \- تبدیل فایل فکس گروه ۳ به تصویر PBM

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBg3topbm\fP
[\fB-reversebits\fP]
[\fB-stretch\fP]
[\fB-width=\fP\fIpixels\fP | paper_size={A3|A4|A5|A6|B4}]
[\fB-stop_error\fP]
[\fB-correctlong\fP]
[\fB-kludge\fP]
[\fIg3file\fP]
.PP
کوتاه‌ترین مخفف یکتای گزینه قابل قبول است. می‌توانید برای مشخص کردن گزینه‌ها، به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسه فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBg3topbm\fP یک فایل فکس گروه ۳ (Group 3) با فشرده‌سازی MH (هافمن اصلاح‌شده) را به عنوان ورودی می‌خواند و یک تصویر PBM را به عنوان خروجی تولید می‌کند.
.PP
برنامه \fBg3topbm\fP انحراف‌های گوناگون از استاندارد را تحمل می‌کند تا در صورت وجود خطای ارسال، بخشی از تصویر را بازیابی کند. یکی از مواردی که تحمل می‌کند خطوط با طول متغیر است. استاندارد ایجاب می‌کند که تمام خطوط طول یکسانی داشته باشند؛ \fBg3topbm\fP عرض تصویر خروجی را برابر با طولانی‌ترین خط در ورودی قرار می‌دهد و سایر خطوط را در سمت راست با فاصله پر (pad) می‌کند. هنگام انجام این کار به شما هشدار می‌دهد.
.PP
می‌توانید از گزینه \fB-stop_error\fP استفاده کنید تا \fBg3topbm\fP بر ورودی معتبر پافشاری کند.
.PP
هیچ برنامه‌ای در Netpbm وجود ندارد که سایر روش‌های فشرده‌سازی فکس G3 را بفهمد: یعنی MR (روش Read اصلاح‌شده) و MMR (روش Read دو بار اصلاح‌شده).
.PP
توجه داشته باشید که قالب فایل فکس گروه ۳ شامل هیچ نوع امضا یا شناسه‌ای (signature) نیست تا \fBg3topbm\fP بتواند بررسی کند که آیا واقعاً به یک فایل G3 نگاه می‌کند یا این‌که روش فشرده‌سازی MH است یا خیر. برنامه هر دنباله‌ای از بایت‌ها را که به آن بدهید طوری تفسیر می‌کند که گویی G3 است، و در حالی که معمولاً پیام‌های خطای زیادی درباره عدم انطباق فایل با قالب G3 MH صادر می‌کند، خروجی تولید خواهد کرد (مگر اینکه از
\fB-stoperror\fP استفاده کنید). به‌ویژه اگر یک فایل MR یا MMR را به \fBg3topbm\fP بدهید، اشتباه شما را گوشزد نخواهد کرد.
.PP
زیرقالب‌هایی از TIFF وجود دارند که در درون خود از کدگذاری‌های فکس گروه ۳ استفاده می‌کنند. به \fBtifftopnm\fP مراجعه کنید.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک تمام برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP، به 
.UR index.html#commonoptions
گزینه‌های مشترک (Common Options)
.UE
\& مراجعه کنید)، \fBg3topbm\fP گزینه‌های خط فرمان زیر را می‌شناسد:


.TP
\fB-reversebits\fP
به \fBg3topbm\fP اعلام می‌کند که بیت‌ها را با کم‌ارزش‌ترین بیت در ابتدا (least-significant first)، به جای حالت پیش‌فرض باارزش‌ترین بیت در ابتدا (most-significant first)، تفسیر کند. ظاهراً برخی از مودم‌های فکس به یک روش و برخی دیگر به روش دیگر عمل می‌کنند. اگر با پیام‌های متعدد "bad code word" مواجه شدید، از این گزینه استفاده کنید.

.TP
\fB-stretch\fP
این گزینه به \fBg3topbm\fP می‌گوید تا با تکرار کردن هر سطر، تصویر را به صورت عمودی کشش دهد. این کار برای حالت ارسال با کیفیت پایین است.

.TP
\fB-width=\fP\fIpixels\fP
این گزینه به \fBg3topbm\fP اعلام می‌کند که قرار است پهنای تصویر برابر با \fIpixels\fP پیکسل باشد. اگر خطی در آن به این اندازه نباشد، بسته به اینکه گزینه \fB-stop_error\fP را مشخص کرده باشید یا نه، \fBg3topbm\fP یک هشدار صادر می‌کند یا با شکست مواجه می‌شود.
.sp
نمی‌توانید هر دو گزینه \fB-width\fP و \fB-paper_size\fP را هم‌زمان مشخص کنید.
.sp
این گزینه از Netpbm 10.33 (مارس ۲۰۰۶) اضافه شده است.

.TP
\fB-paper_size=\fP{\fBA3\fP,\fBA4\fP,\fBA5\fP,\fBA6\fP,\fBB4\fP}
این گزینه به \fBg3topbm\fP اعلام می‌کند که این تصویر قرار است برای چه اندازه کاغذی قالب‌بندی شود. \fBg3topbm\fP از عرض کاغذ به همان شیوهٔ گزینهٔ \fB-width\fP استفاده می‌کند. \fBg3topbm\fP از ارتفاع کاغذ برای هیچ منظوری استفاده نمی‌کند.
.sp
نمی‌توانید هر دو گزینه \fB-width\fP و \fB-paper_size\fP را هم‌زمان مشخص کنید.
.sp
این گزینه از Netpbm 10.33 (مارس ۲۰۰۶) اضافه شده است.

.TP
\fB-stop_error\fP
این گزینه به \fBg3topbm\fP می‌گوید هنگام یافتن مشکلی در ورودی با خطا متوقف شود. "شکست" یعنی با کد وضعیت غیرصفر پایان می‌یابد و محتوای فایل خروجی نامشخص خواهد بود.
.sp
اگر این گزینه را مشخص نکنید، \fBg3topbm\fP تمام تلاش خود را می‌کند تا خطاهای ورودی را دور بزند و تا حد امکان بخش بیشتری از تصویر را در تصویر خروجی نجات دهد. برنامه ابتدا تلاش می‌کند با جستجوی نشانگر بعدی پایان خط (End Of Line)، با خطی بعدی همگام شود و خطوط یا بخش‌های ناقص بین آن‌ها را نادیده بگیرد. برنامه ابتدای خطی را که در آن با مشکل مواجه شده است ذخیره می‌کند. اگر فایل ورودی پیش از موعد به پایان برسد، \fBg3topbm\fP خروجی شامل خطوط را تا همان نقطه‌ای که با مشکل روبه‌رو شد تولید می‌کند.
.sp
هنگامی که \fBg3topbm\fP با وجود خطاهای ورودی به کار خود ادامه می‌دهد، پیام‌های هشدار صادر می‌کند.
.sp
این گزینه از Netpbm 10.24 (اوت ۲۰۰۴) اضافه شد. پیش از آن، \fBg3topbm\fP همیشه هنگام برخورد با EOF زودرس با خطا متوقف می‌شد و با رخ دادن سایر مشکلات هرگز متوقف نمی‌شد.
\fB-correctlong\fP
.sp
این گزینه به برخی از فایل‌های ورودی آسیب‌دیده کمک می‌کند. فکس‌ها اغلب به دلیل خطاهای خطوط ارتباطی آسیب می‌بینند. یک خرابی به‌ویژه آزاردهنده باعث می‌شود که یک خط بسیار طولانی‌تر از آنچه باید باشد شود. یک دلیل این اتفاق نبود نشانگر «پایان خط» است، بنابراین دو خط متوالی به یک خط تبدیل می‌شوند.
.sp
بدون این گزینه، \fBg3topbm\fP سند را دقیقاً مطابق با آنچه کدگذاری شده رندر می‌کند، بنابراین تصویر PBM خروجی صرفاً حاوی آن خط طولانی خواهد بود. این آسیب‌دیدگی بسیار مشکل‌ساز است زیرا کل تصویر خروجی تقریباً دو برابر پهن‌تر از آنچه باید باشد می‌شود. اما با \fB-correctlong\fP، برنامه \fBg3topbm\fP آن خط را کوتاه می‌کند؛ بنابراین نتیجه کلی خرابی ورودی، از دست رفتن یک خط خواهد بود نه اینکه عرض تصویر دو برابر شود.
.sp
به طور مشخص، با \fB-correctlong\fP، برنامه طول تمام خطوط (که در یک تصویر G3 سالم همگی یکسان هستند) را بررسی کرده و طولی از خط را که بیشترین فراوانی را دارد به عنوان پهنای مورد نظر تصویر در نظر می‌گیرد. سپس هر خطی را که طولانی‌تر از آن باشد برش داده و کوتاه می‌کند.
.sp
برنامه به شما هشدار می‌دهد هنگامی که خرابی سبب شده تصویر ورودی خطوطی با بیش از یک اندازه داشته باشد، خواه گزینه \fB-correctlong\fP را تعیین کرده باشید یا نه.
.sp
توجه داشته باشید اگر \fB-stop_error\fP را تعیین کرده باشید، مشخص کردن \fB-correctlong\fP هیچ فایده‌ای ندارد.
.sp
این گزینه از Netpbm 11.04 (سپتامبر ۲۰۲۳) اضافه شد.
    
.TP
\fB-kludge\fP
به \fBg3topbm\fP اعلام می‌کند که از چند خط نخست فایل صرف‌نظر کند؛ گاهی فایل‌های فکس حاوی مقداری داده زائد در ابتدا هستند.




.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pbmtog3" (1)\c
\&,
.BR "tifftopnm" (1)\c
\&,
.BR "pbm" (1)\c
\&,
.BR "fax formats" (1)\c
\&
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML
تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/g3topbm.html
.PP