نام (NAME)

g3topbm - تبدیل فایل فکس گروه ۳ به تصویر PBM

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

g3topbm [-reversebits] [-stretch] [-width=pixels | paper_size={A3|A4|A5|A6|B4}] [-stop_error] [-correctlong] [-kludge] [g3file]

کوتاه‌ترین مخفف یکتای گزینه قابل قبول است. می‌توانید برای مشخص کردن گزینه‌ها، به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسه فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

برنامه g3topbm یک فایل فکس گروه ۳ (Group 3) با فشرده‌سازی MH (هافمن اصلاح‌شده) را به عنوان ورودی می‌خواند و یک تصویر PBM را به عنوان خروجی تولید می‌کند.

برنامه g3topbm انحراف‌های گوناگون از استاندارد را تحمل می‌کند تا در صورت وجود خطای ارسال، بخشی از تصویر را بازیابی کند. یکی از مواردی که تحمل می‌کند خطوط با طول متغیر است. استاندارد ایجاب می‌کند که تمام خطوط طول یکسانی داشته باشند؛ g3topbm عرض تصویر خروجی را برابر با طولانی‌ترین خط در ورودی قرار می‌دهد و سایر خطوط را در سمت راست با فاصله پر (pad) می‌کند. هنگام انجام این کار به شما هشدار می‌دهد.

می‌توانید از گزینه -stop_error استفاده کنید تا g3topbm بر ورودی معتبر پافشاری کند.

هیچ برنامه‌ای در Netpbm وجود ندارد که سایر روش‌های فشرده‌سازی فکس G3 را بفهمد: یعنی MR (روش Read اصلاح‌شده) و MMR (روش Read دو بار اصلاح‌شده).

توجه داشته باشید که قالب فایل فکس گروه ۳ شامل هیچ نوع امضا یا شناسه‌ای (signature) نیست تا g3topbm بتواند بررسی کند که آیا واقعاً به یک فایل G3 نگاه می‌کند یا این‌که روش فشرده‌سازی MH است یا خیر. برنامه هر دنباله‌ای از بایت‌ها را که به آن بدهید طوری تفسیر می‌کند که گویی G3 است، و در حالی که معمولاً پیام‌های خطای زیادی درباره عدم انطباق فایل با قالب G3 MH صادر می‌کند، خروجی تولید خواهد کرد (مگر اینکه از -stoperror استفاده کنید). به‌ویژه اگر یک فایل MR یا MMR را به g3topbm بدهید، اشتباه شما را گوشزد نخواهد کرد.

زیرقالب‌هایی از TIFF وجود دارند که در درون خود از کدگذاری‌های فکس گروه ۳ استفاده می‌کنند. به tifftopnm مراجعه کنید.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet، به گزینه‌های مشترک (Common Options) مراجعه کنید)، g3topbm گزینه‌های خط فرمان زیر را می‌شناسد:

-reversebits

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

-stretch

این گزینه به g3topbm می‌گوید تا با تکرار کردن هر سطر، تصویر را به صورت عمودی کشش دهد. این کار برای حالت ارسال با کیفیت پایین است.

-width=pixels

این گزینه به g3topbm اعلام می‌کند که قرار است پهنای تصویر برابر با pixels پیکسل باشد. اگر خطی در آن به این اندازه نباشد، بسته به اینکه گزینه -stop_error را مشخص کرده باشید یا نه، g3topbm یک هشدار صادر می‌کند یا با شکست مواجه می‌شود.

نمی‌توانید هر دو گزینه -width و -paper_size را هم‌زمان مشخص کنید.

این گزینه از Netpbm 10.33 (مارس ۲۰۰۶) اضافه شده است.

-paper_size={A3,A4,A5,A6,B4}

این گزینه به g3topbm اعلام می‌کند که این تصویر قرار است برای چه اندازه کاغذی قالب‌بندی شود. g3topbm از عرض کاغذ به همان شیوهٔ گزینهٔ -width استفاده می‌کند. g3topbm از ارتفاع کاغذ برای هیچ منظوری استفاده نمی‌کند.

نمی‌توانید هر دو گزینه -width و -paper_size را هم‌زمان مشخص کنید.

این گزینه از Netpbm 10.33 (مارس ۲۰۰۶) اضافه شده است.

-stop_error

این گزینه به g3topbm می‌گوید هنگام یافتن مشکلی در ورودی با خطا متوقف شود. "شکست" یعنی با کد وضعیت غیرصفر پایان می‌یابد و محتوای فایل خروجی نامشخص خواهد بود.

اگر این گزینه را مشخص نکنید، g3topbm تمام تلاش خود را می‌کند تا خطاهای ورودی را دور بزند و تا حد امکان بخش بیشتری از تصویر را در تصویر خروجی نجات دهد. برنامه ابتدا تلاش می‌کند با جستجوی نشانگر بعدی پایان خط (End Of Line)، با خطی بعدی همگام شود و خطوط یا بخش‌های ناقص بین آن‌ها را نادیده بگیرد. برنامه ابتدای خطی را که در آن با مشکل مواجه شده است ذخیره می‌کند. اگر فایل ورودی پیش از موعد به پایان برسد، g3topbm خروجی شامل خطوط را تا همان نقطه‌ای که با مشکل روبه‌رو شد تولید می‌کند.

هنگامی که g3topbm با وجود خطاهای ورودی به کار خود ادامه می‌دهد، پیام‌های هشدار صادر می‌کند.

این گزینه از Netpbm 10.24 (اوت ۲۰۰۴) اضافه شد. پیش از آن، g3topbm همیشه هنگام برخورد با EOF زودرس با خطا متوقف می‌شد و با رخ دادن سایر مشکلات هرگز متوقف نمی‌شد. -correctlong

این گزینه به برخی از فایل‌های ورودی آسیب‌دیده کمک می‌کند. فکس‌ها اغلب به دلیل خطاهای خطوط ارتباطی آسیب می‌بینند. یک خرابی به‌ویژه آزاردهنده باعث می‌شود که یک خط بسیار طولانی‌تر از آنچه باید باشد شود. یک دلیل این اتفاق نبود نشانگر «پایان خط» است، بنابراین دو خط متوالی به یک خط تبدیل می‌شوند.

بدون این گزینه، g3topbm سند را دقیقاً مطابق با آنچه کدگذاری شده رندر می‌کند، بنابراین تصویر PBM خروجی صرفاً حاوی آن خط طولانی خواهد بود. این آسیب‌دیدگی بسیار مشکل‌ساز است زیرا کل تصویر خروجی تقریباً دو برابر پهن‌تر از آنچه باید باشد می‌شود. اما با -correctlong، برنامه g3topbm آن خط را کوتاه می‌کند؛ بنابراین نتیجه کلی خرابی ورودی، از دست رفتن یک خط خواهد بود نه اینکه عرض تصویر دو برابر شود.

به طور مشخص، با -correctlong، برنامه طول تمام خطوط (که در یک تصویر G3 سالم همگی یکسان هستند) را بررسی کرده و طولی از خط را که بیشترین فراوانی را دارد به عنوان پهنای مورد نظر تصویر در نظر می‌گیرد. سپس هر خطی را که طولانی‌تر از آن باشد برش داده و کوتاه می‌کند.

برنامه به شما هشدار می‌دهد هنگامی که خرابی سبب شده تصویر ورودی خطوطی با بیش از یک اندازه داشته باشد، خواه گزینه -correctlong را تعیین کرده باشید یا نه.

توجه داشته باشید اگر -stop_error را تعیین کرده باشید، مشخص کردن -correctlong هیچ فایده‌ای ندارد.

این گزینه از Netpbm 11.04 (سپتامبر ۲۰۲۳) اضافه شد.

-kludge

به g3topbm اعلام می‌کند که از چند خط نخست فایل صرف‌نظر کند؛ گاهی فایل‌های فکس حاوی مقداری داده زائد در ابتدا هستند.

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

pbmtog3(1), tifftopnm(1), pbm(1), fax formats(1)

منبع سند (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:

http://netpbm.sourceforge.net/doc/g3topbm.html