\
.\" 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 "Ppmtogif User Manual" 0 "" "netpbm documentation"

.SH "نام (NAME)"

ppmtogif \- تبدیل تصویر PPM به GIF (با pamtogif جایگزین شده است)

.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه
\fBppmtogif\fP
در نسخه 10.37 از Netpbm (دسامبر ۲۰۰۶) با
.BR "pamtogif" (1)\c
\& جایگزین شد.
.PP
برنامه
\fBpamtogif\fP
تا حد زیادی با
\fBppmtogif\fP
سازگار با گذشته (backward compatible) است.
.PP
یکی از مواردی که
\fBpamtogif\fP
با
\fBppmtogif\fP
سازگاری با گذشته ندارد این است که برای تعیین ماسک شفافیت (آلفا) در
\fBppmtogif\fP،
باید شفافیت را به صورت یک تصویر مجزای شبه-PGM ارائه داده و از گزینه
\fB-alpha\fP
استفاده کنید، در حالی که در
\fBpamtogif\fP،
یک تصویر ورودی ارائه می‌دهید که شفافیت درون آن گنجانده شده است، و گزینه‌ای به نام
\fB-alpha\fP
وجود ندارد.
.PP
مورد پیچیده‌تر دیگری که در آن
\fBpamtogif\fP
با گذشته سازگار نیست، گزینه
\fB-map\fP
است. شما از این گزینه برای تعیین رنگ‌های مد نظر خود در تصویر GIF استفاده می‌کنید، زیرا یک تصویر GIF حداکثر می‌تواند ۲۵۶ رنگ داشته باشد و ممکن است تصویر ورودی شما رنگ‌های بیشتری داشته باشد. در
\fBpamtogif\fP،
تصویر نگاشت (map) باید همان عمق تصویر ورودی را داشته باشد، اما در
\fBppmtogif\fP
نیازی به این موضوع نیست.
.PP
برنامه
\fBppmtogif\fP
هنوز به عنوان یک برنامه مجزا برای حفظ سازگاری با گذشته وجود دارد، اما کار اصلی را با اجرای
\fBpamtogif\fP
انجام می‌دهد. نسخه سازگاری
\fBppmtogif\fP
گزینه
\fB-alpha\fP
را با خواندن تصویر شفافیت و ترکیب آن با تصویر ورودی تفسیر می‌کند و سپس تصویر ترکیبی حاصل را به
\fBpamtogif\fP
می‌دهد. اگر از گزینه
\fB-map\fP
استفاده کنید، نسخه سازگاری
\fBppmtogif\fP
همچنین از
\fBpnmremap\fP
روی ورودی شما استفاده می‌کند تا عمق آن با فایل نگاشت برابر شود. به غیر از این موارد، نسخه سازگاری
\fBppmtogif\fP
صرفاً ورودی و گزینه‌ها را مستقیماً به
\fBpamtogif\fP
منتقل می‌کند.
.PP
شما نباید هیچ استفاده جدیدی از
\fBppmtogif\fP
داشته باشید و اگر کاربرد قبلی و موجودی دارید، باید آن را به
\fBpamtogif\fP
ارتقا دهید. اما توجه داشته باشید که اگر برنامه‌ای می‌نویسید که ممکن است با نسخه‌های قدیمی Netpbm استفاده شود،
\fBppmtogif\fP
تنها راه برای انجام آن است.
.PP
مگر در مواردی که از گزینه
\fB-alpha\fP
یا
\fB-map\fP
استفاده کنید، می‌توانید به سادگی نام برنامه را تغییر دهید. اگر از
\fB-alpha\fP
استفاده می‌کنید، نحوه ارتقا به این صورت است:

.nf
\f(CW
  $ ppmtogif -alpha=myalpha.pgm myinput.ppm >myoutput.gif
\fP
.fi

تبدیل می‌شود به:

.nf
\f(CW
  $ pamstack -tupletype=RGB_ALPHA myinput.ppm myalpha.pgm |  \e
      pamtogif >myoutput.gif
\fP
.fi


.SH "نسخه اصلی PPMTOGIF (ORIGINAL PPMTOGIF)"
.PP
اگر از Netpbm قبل از نسخه 10.37 استفاده می‌کنید،
\fBpamtogif\fP
وجود ندارد، بنابراین از
\fBppmtogif\fP
استفاده می‌کنید. می‌توانید از راهنمای
\fBpamtogif\fP
برای
\fBppmtogif\fP
استفاده کنید، به استثنای موارد زیر:
.PP
مستندات فعلی
\fBpamtogif\fP
تمام نسخه‌های آن برنامه را پوشش می‌دهد. فقط از اطلاعات مربوط به نسخه 10.37 استفاده کنید.
.PP
برنامه
\fBppmtogif\fP
قبل از Netpbm 10.31 ورودی PAM را به هیچ وجه نمی‌پذیرد.
.PP
برنامه
\fBppmtogif\fP
ورودی PAM حاوی اطلاعات شفافیت را نمی‌پذیرد. در عوض،
\fBppmtogif\fP
دارای یک گزینه
\fB-alpha\fP
است.
.PP
ساختار این گزینه به صورت
\fB-alpha=\fP\fIpgmfile\fP
است.
\fBppmtogif\fP
با محتویات فایل PGM داده‌شده به همان شیوه‌ای رفتار می‌کند که
\fBpamtogif\fP
با صفحه آلفای یک PAM رفتار می‌کند. تصویر PGM باید ابعادی مشابه فایل ورودی داشته باشد. اما برخلاف PAM، تصویر آلفا نیازی ندارد که دارای maxval یکسان با ورودی باشد.
\fBppmtogif\fP
فایل آلفا را با استفاده از maxval خود فایل آلفا تفسیر می‌کند.
.PP
نمی‌توانید به طور هم‌زمان هر دو گزینه
\fB-transparent\fP
و
\fB-alpha\fP
را مشخص کنید.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmtogif.html
.PP