.\" 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 "Giftopnm User Manual" 0 "13 September 2012" "netpbm documentation"

.SH "نام (NAME)"
giftopnm \- تبدیل یک فایل GIF به یک تصویر PNM

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

\fBgiftopnm\fP
[\fB--alphaout=\fP{\fIalpha-filename\fP,\fB-\fP}]
[\fB-verbose\fP]
[\fB-comments\fP]
[\fB-image=\fP{\fIN\fP,\fBall\fP}]
[\fB-repair\fP]
[\fB-quitearly\fP]
[\fIGIFfile\fP]
.PP
حداقل اختصار یکتا برای هر گزینه پذیرفته می‌شود. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله برای جداسازی نام گزینه از مقدار آن استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
این ابزار یک مبدل قالب گرافیکی از قالب GIF به قالب PNM (یعنی PBM، PGM یا PPM) است.
.PP
اگر تصویر تنها حاوی سیاه و بیشترین میزان روشنایی سفید باشد، خروجی PBM خواهد بود. اگر تصویر حاوی رنگ‌هایی بیش از این دو باشد، اما فقط از طیف خاکستری تشکیل شده باشد، خروجی PGM است. اگر تصویر دارای رنگ‌های دیگری باشد، خروجی PPM خواهد بود.
.PP
یک تصویر GIF حاوی پیکسل‌های مستطیلی است. همگی دارای نسبت ابعاد یکسانی هستند، اما ممکن است مربع نباشند (در واقع غیرمربع بودن آن‌ها بسیار غیرمعمول است، اما ممکن است رخ دهد). پیکسل‌های یک تصویر Netpbm همیشه مربع هستند. به دلیل پیچیدگی مهندسی برای انجام کاری جز این، \fBgiftopnm\fP یک تصویر GIF را پیکسل‌به‌پیکسل به یک تصویر Netpbm تبدیل می‌کند. این بدان معناست که اگر پیکسل‌های GIF مربع نباشند، تصویر خروجی Netpbm نسبت ابعاد نادرستی خواهد داشت. در این حالت، \fBgiftopnm\fP پیامی اطلاع‌رسانی صادر می‌کند که به شما می‌گوید برای اصلاح خروجی، \fBpamscale\fP را اجرا کنید.

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


.TP
\fB--alphaout=\fP\fIalpha-filename\fP
برنامه \fBgiftopnm \fP یک فایل PBM حاوی اطلاعات شفافیت تصویر ورودی ایجاد می‌کند. ابعاد این تصویر شفافیت مشابه تصویر ورودی است و هر پیکسل از تصویر شفافیت نشان می‌دهد که آیا پیکسل متناظر در تصویر ورودی شفاف است یا خیر. رنگ سیاه به معنای شفاف و رنگ سفید به معنای کدر است. اگر \fB--alphaout\fP را مشخص نکنید، \fBgiftopnm\fP فایل شفافیت تولید نمی‌کند و اگر تصویر ورودی دارای کانال شفافیت باشد، \fBgiftopnm\fP به‌سادگی آن را نادیده می‌گیرد.
.sp
اگر \fB-\fP را به عنوان نام فایل تعیین کنید، \fBgiftopnm\fP خروجی شفافیت را در خروجی استاندارد می‌نویسد و از تصویر اصلی صرف‌نظر می‌کند.
.sp
برای مشاهده یکی از روش‌های استفاده از فایل خروجی شفافیت،
.BR "pamcomp" (1)\c
\& را ببینید.

.TP
\fB-verbose\fP
تولید خروجی پرگو درباره فایل ورودی GIF.

.TP
\fB-comments\fP
با این گزینه، \fBgiftopnm\fP پیام‌هایی را حاوی یادداشت‌های GIF نمایش می‌دهد (یک جریان GIF89 می‌تواند شامل توضیحاتی در افزونه‌های یادداشت باشد).
.sp
به طور پیش‌فرض، \fBgiftopnm\fP افزونه‌های یادداشت را نادیده می‌گیرد.


.TP
\fB-image=\fP{\fIN\fP,\fBall\fP}
این گزینه مشخص می‌کند که کدام تصویر از جریان GIF را می‌خواهید. می‌توانید یک تصویر یا همه تصاویر را انتخاب کنید. همه تصاویر را با \fBall\fP انتخاب کنید. یک تصویر را با تعیین شماره توالی آن در جریان مشخص کنید: \fB1\fP، \fB2\fP، \fB3\fP و غیره.
.sp
مقدار پیش‌فرض، تصویر ۱ است.
.sp
یک جریان GIF معمولاً تنها حاوی یک تصویر است، بنابراین به این گزینه نیازی نخواهید داشت. اما برخی جریان‌ها، از جمله GIFهای متحرک، دارای چندین تصویر هستند.
.sp
هنگامی که چند تصویر GIF را انتخاب می‌کنید، خروجی یک جریان PNM با چندین تصویر خواهد بود.
.sp
اگر یک تصویر واحد را مشخص کنید، \fBgiftopnm\fP باید تصاویر پیش از آن را در جریان بخواند و تا حدی اعتبارسنجی کند. ممکن است برای تصاویر پس از آن نیز همین کار را انجام دهد یا ندهد؛ گزینه \fB-quitearly\fP را ببینید.
.sp
مقدار \fBall\fP در Netpbm 10.16 (ژوئن ۲۰۰۳) افزوده شد. نسخه‌های پیشین \fBgiftopnm\fP تنها می‌توانستند یک تصویر را استخراج کنند.

.TP
\fB-repair\fP
این گزینه باعث می‌شود \fBgiftopnm\fP تلاش کند تا هر آنچه را که می‌تواند از یک ورودی نامعتبر GIF نجات دهد.
.sp
به‌ویژه، هنگامی که \fBgiftopnm\fP تشخیص می‌دهد ورودی GIF نامعتبر است به طوری که تعیین چیستی پیکسل‌ها غیرممکن است، یک رنگ دلخواه منفرد را برای تمام پیکسل‌های بعدی در تصویر تولید می‌کند. برنامه \fBgiftopnm\fP تصویر را از بالا به پایین و از چپ به راست پردازش می‌کند، بنابراین این بدان معناست که پایین‌ترین پیکسل‌ها این پُرکننده خواهند بود.
.sp
هنگامی که \fBgiftopnm\fP تصویری را به این شکل نجات می‌دهد، پیام‌های هشداری صادر می‌کند.
.sp
بدون این گزینه، \fBgiftopnm\fP در صورت تشخیص ورودی نامعتبر GIF با شکست مواجه می‌شود. هر خروجی‌ای که تولید کند دلخواه است و معمولاً یک تصویر PNM معتبر نیست.
.sp
بسیار معمول است که یک تصویر به گونه‌ای آسیب ببیند که در ابتدا یک GIF معتبر بوده، اما انتهای فایل بریده شده باشد. یک انتقال شبکه قطع‌شده تمایل دارد چنین نتیجه‌ای ایجاد کند. در این حالت، عملیات نجات \fBgiftopnm\fP یک تصویر PNM معتبر با ابعاد مناسب، اما با یک رنگ دلخواه یکدست برای پیکسل‌هایی که در فایل جا مانده‌اند تولید می‌کند.
.sp
این گزینه در Netpbm 10.38 (مارس ۲۰۰۷) تازه بود. از نسخه 10.32 تا 10.37، در صورت تشخیص ورودی GIF نامعتبر، \fBgiftopnm\fP همیشه با شکست مواجه می‌شود. پیش از 10.32، در صورت وجود یک تصویر ناقص موفق می‌شد و پیکسل‌های مفقود را با رنگ‌های دلخواهی که لزوماً همه یکسان نبودند جایگزین می‌کرد (رفتار پیش از 10.32 در واقع بر اساس طراحی مورد نظر نبود).


.TP
\fB-quitearly\fP
این گزینه باعث می‌شود \fBgiftopnm\fP به محض اینکه تصاویر درخواستی شما از ورودی را تبدیل کرد و به خروجی فرستاد، خواندن فایل ورودی را متوقف کند. به طور پیش‌فرض، \fBgiftopnm\fP تا انتهای جریان GIF را می‌خواند و هر داده‌ای پس از تصاویر درخواستی شما را نادیده می‌گیرد.
.sp
دو دلیل برای \fIعدم\fP استفاده از این گزینه:

.IP \(bu
فایل ورودی یک لوله (pipe) است و فرایندی که آن لوله را پر می‌کند انتظار دارد لوله تمام جریان را دریافت کند و در غیر این صورت دچار شکست یا توقف می‌شود.

.IP \(bu
می‌خواهید تمام جریان GIF را اعتبارسنجی کنید.


.sp
دو دلیل برای استفاده از این گزینه:


.IP \(bu
در زمان و سایر منابع لازم برای خواندن انتهای جریان صرفه‌جویی می‌کند.
.IP \(bu
خطاهایی در انتهای جریان وجود دارند که باعث شکست \fBgiftopnm\fP می‌شوند.

.sp
این گزینه در صورتی که \fB-image=all\fP را نیز مشخص کنید، هیچ تأثیری ندارد.
.sp
این گزینه در Netpbm 10.35 (اوت ۲۰۰۶) تازه بود. پیش از آن، \fBgiftopnm\fP همیشه کل جریان را می‌خواند.
     


.UN restrictions
.SH "محدودیت‌ها (RESTRICTIONS)"
.PP
این برنامه افزونه متن ساده (Plain Text Extension) در استاندارد GIF89 را به درستی پشتیبانی نمی‌کند، چرا که نویسنده هیچ فایل ورودی نمونه‌ای که حاوی آن باشد در اختیار نداشته است.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamtogif" (1)\c
\&،
.BR "ppmcolormask" (1)\c
\&،
.BR "pamcomp" (1)\c
\&،
.UR http://www.lcdf.org/gifsicle
http://www.lcdf.org/gifsicle
.UE
\&،
.BR "ppm" (1)\c
\&.

.UN author
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر (c) ۱۹۹۳ متعلق به David Koblas (\fIkoblas@netcom.com\fP)

.UN license
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.PP
به عنوان یک نکته تاریخی، برای مدت طولانی اگر از \fBgiftopnm\fP استفاده می‌کردید، از یک حق امتیاز اختراع (پتنت) برای روش فشرده‌سازی LZW استفاده می‌کردید که متعلق به Unisys بود و با احتمال فراوان مجوزی از Unisys برای انجام این کار نداشتید. Unisys معمولاً برای استفاده‌های جزئی از این پتنت ۵۰۰۰ دلار بابت مجوز مطالبه می‌کرد. Unisys هرگز این پتنت را علیه کاربران جزئی اعمال نکرد و اعلام نمود بسیار کمتر از بابت استفاده افراد از پتنت برای رفع فشرده‌سازی (کاری که \fBgiftopnm\fP انجام می‌دهد) نگران است تا فشرده‌سازی. این حق اختراع در سال ۲۰۰۳ منقضی شد.
.PP
شایعاتی وجود دارد مبنی بر اینکه IBM نیز دارای یک حق ثبت اختراع است که شامل \fBgiftopnm\fP می‌شود.
.PP
یک جایگزین برای قالب GIF که هرگز نیازی به مجوز پتنت نداشته است، قالب PNG است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/giftopnm.html
.PP