.\" 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 "Fiascotopnm User Manual" 0 "12 July 2000" "netpbm documentation"

.SH "نام (NAME)"
fiascotopnm \- تبدیل تصویر فشردهٔ FIASCO به PGM یا PPM

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

\fBfiascotopnm \fP
[\fIoption\fP]...
[\fIfilename\fP]...
.PP
تمام نام‌های گزینه‌ها می‌توانند خلاصه شوند؛ برای نمونه، --output می‌تواند به‌صورت --outp یا --ou نوشته شود. برای تمام گزینه‌ها یک گزینهٔ کوتاه تک‌حرفی ارائه شده است. آرگومان‌های اجباری یا اختیاری گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری یا اختیاری هستند. هر دو نوع گزینه‌های کوتاه و طولانی به حروف کوچک و بزرگ حساس هستند.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBfiascotopnm\fP فایل‌های نام‌برده شدهٔ FIASCO، یا در صورت مشخص نشدن فایلی، ورودی استاندارد را از حالت فشرده خارج کرده و بسته به این که تصویر FIASCO سیاه و سفید یا رنگی باشد، تصاویر را در قالب فایل‌های PGM یا PPM می‌نویسد.

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


.TP
\fB-o\fP[\fIname\fP], \fB--output=\fP[\fIname\fP]
 تصویر خارج‌شده از حالت فشرده را در فایل \fIname\fP.ppm (اگر PPM باشد) یا \fIname\fP.pgm (اگر PGM باشد) می‌نویسد. اگر \fIname\fP برابر با \fB-\fP باشد، فایل تصویر در خروجی استاندارد تولید می‌شود. آرگومان اختیاری \fIname\fP می‌تواند حذف شود، که در این صورت نام فایل ورودی به همراه پسوند .ppm یا .pgm به عنوان نام پایه استفاده خواهد شد. در مورد جریان‌های ویدئویی، فریم‌ها در فایل‌های \fIname\fP.\fBN\fP.ppm ذخیره می‌شوند که در آن \fBN\fP شمارهٔ فریم است (به شکل 00..0 تا 99..9)؛ خروجی روی خروجی استاندارد برای جریان‌های ویدئویی امکان‌پذیر نیست.
.sp
 اگر \fIname\fP یک مسیر نسبی باشد و متغیر محیطی \fBFIASCO_IMAGES\fP یک فهرست (جداشده با دونقطه) از دایرکتوری‌ها باشد، فایل(های) خروجی در نخستین دایرکتوری (قابل نوشتن) این فهرست نوشته می‌شوند. در غیر این صورت، از دایرکتوری جاری برای ذخیرهٔ فایل(های) خروجی استفاده می‌شود.

.TP
\fB-z\fP, \fB--fast\fP
تصاویر را در قالب 4:2:0 از حالت فشرده خارج می‌کند؛ یعنی هر کانال رنگ (chroma) به تصویری با عرض و ارتفاع نصف‌شده از حالت فشرده خارج می‌شود. از این گزینه روی سیستم‌های کند زمانی که به نرخ فریم مطلوب دسترسی پیدا نمی‌شود استفاده کنید؛ کیفیت خروجی تنها اندکی کاهش می‌یابد. 

.TP
\fB-d\fP, \fB--double\fP
اندازهٔ پنجرهٔ X11 را در هر دو بعد عرض و ارتفاع دو برابر می‌کند؛ هیچ درون‌یابی پیکسلی انجام نمی‌شود، هر پیکسل تنها با چهار پیکسل همسان جایگزین می‌گردد.

.TP
\fB-p\fP, \fB--panel\fP
یک پنل با دکمه‌های play، stop، pause، record و exit برای کنترل نمایش ویدئوها نشان می‌دهد. با فشردن دکمهٔ record، تمام فریم‌ها از حالت فشرده خارج شده و در حافظه ذخیره می‌شوند. سایر دکمه‌ها طبق معمول کار می‌کنند.

.TP
\fB-m\fP \fIN\fP, \fB--magnify=\fP\fIN\fP
بزرگ‌نمایی تصویر خارج‌شده از فشرده‌سازی را تنظیم می‌کند. مقادیر مثبت عرض و ارتفاع تصویر را با ضریب 2^|\fIN\fP| بزرگ کرده و مقادیر منفی آن را کاهش می‌دهند.

.TP
\fB-s\fP \fIN\fP, \fB--smoothing=\fP\fIN\fP
تصویر(های) خارج‌شده از حالت فشرده را در راستای مرزهای بخش‌بندی به مقدار داده‌شدهٔ \fIN\fP هموارسازی می‌کند. مقدار \fIN\fP بین 1 (حداقل) تا 100 (حداکثر) است؛ پیش‌فرض 70 است. هنگامی که \fIN\fP=0 باشد، مقدار هموارسازی مشخص‌شده در فایل FIASCO استفاده می‌شود (تعریف‌شده توسط کدکنندهٔ FIASCO).

.TP
\fB-F\fP \fIN\fP, \fB--fps=\fP\fIN\fP
تعداد فریم بر ثانیه را به \fIN\fP تنظیم می‌کند. هنگام استفاده از این گزینه، نرخ فریم مشخص‌شده در فایل FIASCO بازنویسی می‌شود.

.TP
\fB--verbose=\fP\fIN\fP
سطح گزارش پرگویی (verbose) دستور \fBfiascotopnm\fP را روی \fIN\fP تنظیم می‌کند.

.TP
\fB-v\fP, \fB--version\fP
شمارهٔ نسخهٔ \fBfiascotopnm\fP را چاپ کرده و سپس خارج می‌شود.

.TP
\fB-f\fP \fIname\fP, \fB--config=\fP\fIname\fP
فایل پارامتر \fIname\fP را برای مقداردهی اولیهٔ گزینه‌های \fBfiascotopnm\fP بارگذاری می‌کند. برای مثالی از ساختار نحو به فایل \fBsystem.fiascorc\fP مراجعه کنید. گزینه‌های \fBfiascotopnm \fP با هر یک از روش‌های زیر (به ترتیب مشخص‌شده) تنظیم می‌شوند:


.IP \(bu
فایل منبع سراسری \fB/etc/system.fiascorc\fP

.IP \(bu
$HOME\fB/.fiascorc\fP

.IP \(bu
خط فرمان

.IP \(bu
--config=\fIname\fP


.TP
\fB-h\fP, \fB--info\fP
راهنمای مختصری را چاپ کرده و سپس خارج می‌شود.

.TP
\fB-H\fP, \fB--help\fP
راهنمای تفصیلی را چاپ کرده و سپس خارج می‌شود.




.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
fiascotopnm foo.wfa >foo.ppm
.fi
.PP
فایل FIASCO با نام «foo.wfa» را از حالت فشرده خارج کرده و آن را به عنوان «foo.ppm» ذخیره می‌کند.

.nf
fiascotopnm -o foo1.wfa foo2.wfa
.fi
.PP
فایل‌های FIASCO به نام‌های «foo1.wfa» و «foo2.wfa» را از حالت فشرده خارج کرده و فریم‌ها را در فایل‌های تصویر «foo1.wfa.ppm» و «foo2.wfa.ppm» می‌نویسد.

.nf
fiascotopnm -oimage foo1.wfa
.fi
.PP
فایل FIASCO با نام «foo1.wfa» را از حالت فشرده خارج کرده و تمام ۱۵ فریم را در فایل‌های تصویر «image.00.ppm»، ... و «image.14.ppm» می‌نویسد.

.nf
fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm
.fi
.PP
فایل FIASCO با نام «video.wfa» را از حالت فشرده خارج می‌کند. سرعت استخراج در بالاترین حد ممکن است: تصویر (در قالب 4:2:0) در یک‌چهارم اندازهٔ اصلی خود از حالت فشرده خارج می‌شود؛ سپس با دو برابر کردن پیکسل‌ها تصویر مجدداً بزرگ می‌گردد.

.UN files
.SH "فایل‌ها (FILES)"


.TP
\fB/etc/system.fiascorc\fP
فایل مقداردهی اولیهٔ سراسری سیستم.

.TP
$HOME\fB/.fiascorc\fP
فایل مقداردهی اولیهٔ شخصی.



.UN environment
.SH "محیط (ENVIRONMENT)"


.TP
\fBFIASCO_IMAGES\fP
مسیر ذخیره برای فایل‌های تصویر. پیش‌فرض "./" است.

.TP
\fBFIASCO_DATA\fP
مسیر جستجو برای فایل‌های FIASCO. پیش‌فرض "./" است.




.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmtofiasco" (1)\c
\&,
.BR "pnm" (1)\c
\&
.PP
Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.
\fBWeighted Finite Automata for Video Compression\fP, IEEE Journal on
Selected Areas In Communications, January 1998
Ullrich Hafner. \fBLow Bit-Rate Image and Video Coding with Weighted
Finite Automata\fP, Ph.D. thesis, Mensch & Buch Verlag, ISBN
3-89820-002-7, October 1999.

.UN author
.SH "نویسندگان (AUTHORS)"

Ullrich Hafner <\fIhafner@bigfoot.de\fP>
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما از منبع HTML توسط ابزار makeman در Netpbm تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/fiascotopnm.html
.PP