.\" 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 "Pnmtofiasco User Manual" 0 "09 April 2025" "netpbm documentation" .SH "نام (NAME)" pnmtofiasco \- تبدیل فایل PNM به فایل فشردهٔ FIASCO .UN synopsis .SH "خلاصه دستور (SYNOPSIS)" \fBpnmtofiasco\fP [\fIگزینه\fP]... [\fIنام‌فایل\fP]... .UN description .SH "توضیحات (DESCRIPTION)" .PP این برنامه بخشی از .BR "Netpbm" (1)\c \& است. \fBpnmtofiasco\fP فایل‌های تصویر pbm، pgm یا ppm نام‌برده‌شده، یا در صورت مشخص نشدن هیچ فایلی، ورودی استاندارد را فشرده کرده و یک فایل FIASCO در خروجی استاندارد تولید می‌کند. .UN options .SH "گزینه‌ها (OPTIONS)" .PP افزون بر گزینه‌های مشترک میان تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP، به .UR index.html#commonoptions گزینه‌های مشترک (Common Options) .UE \& مراجعه کنید)، \fBpnmtofiasco\fP گزینه‌های خط فرمان زیر را می‌شناسد: .PP تمام نام‌های گزینه‌ها می‌توانند خلاصه شوند؛ برای نمونه، --optimize می‌تواند به صورت --optim یا --opt نوشته شود. برای بیشتر گزینه‌ها یک گزینهٔ کوتاه تک‌حرفی ارائه شده است. آرگومان‌های اجباری یا اختیاری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری یا اختیاری هستند. هر دو نوع گزینهٔ کوتاه و طولانی به حروف کوچک و بزرگ حساس هستند. .UN basicopts .SS "گزینه‌های پایه (Basic Options)" .TP \fB--image-name=\fP\fIname\fP, \fB-i\fP \fIname\fP تصاویر نام‌برده‌شده را فشرده می‌کند، نه ورودی استاندارد را. اگر \fIname\fP برابر با \fB-\fP باشد، ورودی استاندارد خوانده می‌شود. \fIname\fP باید نام فایل یک تصویر یا الگویی به شکل زیر باشد: .nf prefix[start-end{+,-}step]suffix .fi .sp الگوها هنگام فشرده‌سازی جریان‌های ویدئویی مفید هستند: برای نمونه، اگر الگوی \fBimg0[12-01-2].pgm\fP را تعیین کنید، آنگاه \fBpnmtofiasco\fP تصاویر img012.pgm، img010.pgm، ...، img002.pgm را فشرده می‌کند. .sp اگر \fIname\fP یک مسیر نسبی باشد، \fBpnmtofiasco \fP فایل‌های تصویر را در دایرکتوری جاری و در فهرست (جداشده با دونقطه) دایرکتوری‌های مشخص‌شده توسط متغیر محیطی \fBFIASCO_IMAGES\fP جستجو می‌کند. .TP \fB--output-name=\fP\fIname\fP, \fB-o\fP \fIoutput-file\fP خروجی FIASCO را در فایل مشخص‌شده می‌نویسد، نه در خروجی استاندارد. .sp اگر \fIname\fP یک مسیر نسبی باشد و متغیر محیطی \fBFIASCO_DATA\fP فهرستی از دایرکتوری‌ها (جداشده با دونقطه) باشد، آنگاه \fBpnmtofiasco\fP فایل خروجی را در نخستین دایرکتوری (قابل نوشتن) این فهرست می‌نویسد. در غیر این صورت، \fBpnmtofiasco\fP آن را در دایرکتوری جاری می‌نویسد. .TP \fB--quality=\fP\fIN\fP, \fB-q\fP \fIN\fP کیفیت فشرده‌سازی را روی \fIN\fP تنظیم می‌کند. کیفیت از 1 (بدترین) تا 100 (بهترین) است؛ مقدار پیش‌فرض 20 است. .TP \fB--version\fP, \fB-v\fP نمایش شماره نسخهٔ \fBpnmtofiasco\fP و سپس خروج. .TP \fB--verbose \fP\fIN\fP, \fB-V\fP \fIN\fP تنظیم سطح پرگویی (verbosity) روی \fIN\fP. سطح می‌تواند 0 (بدون هیچ خروجی)، 1 (نمایش نشانگر پیشرفت)، یا 2 (نمایش جزئیات آمار فشرده‌سازی) باشد؛ مقدار پیش‌فرض 1 است. .TP \fB--progress-meter \fP\fIN\fP, \fB-B\fP \fIN\fP تنظیم نوع نشانگر پیشرفت روی \fIN\fP. نوع‌های زیر در دسترس هستند؛ مقدار پیش‌فرض 1 است: .TP \fB0\fP بدون نشانگر پیشرفت .TP \fB1\fP نوار پیشرفت به سبک RPM با استفاده از 50 علامت هش (#) .TP \fB2\fP نشانگر درصدی .TP \fB--config=\fP\fIname\fP, \fB-f\fP \fIname\fP بارگذاری فایل پارامتر \fIname \fP برای مقداردهی اولیهٔ گزینه‌های \fBpnmtofiasco\fP. برای نمونه‌ای از نحو، فایل \fBsystem.fiascorc\fP را ببینید. گزینه‌های \fBpnmtofiasco\fP با هر یک از روش‌های زیر (به ترتیبی که ذکر شده) تنظیم می‌شوند: .IP \(bu فایل منبع سراسری \fB/etc/system.fiascorc\fP .IP \(bu $HOME/.fiascorc .IP \(bu خط فرمان (command line) .IP \(bu --config=\fIname\fP .TP \fB--info\fP, \fB-h\fP چاپ راهنمای کوتاه و سپس خروج. .TP \fB--help\fP, \fB-H\fP چاپ راهنمای جامع و سپس خروج. .UN advancedopts.SS گزینه‌ها برای کاربران پیشرفته (Options for Advanced Users) .TP \fB--basis-name=\fP\fIname\fP, \fB-b\fP \fIname\fP پایه‌ی فشرده‌سازی \fIname\fP را از پیش در FIASCO بارگذاری می‌کند. پایه‌ی \fIname\fP فرهنگ‌لغت فشرده‌سازی اولیه را فراهم می‌سازد. می‌توانید از یکی از فایل‌های "small.fco"، "medium.fco" یا "large.fco" که همراه با \fBpnmtofiasco \fP ارائه می‌شوند استفاده کنید، یا یک فایل پایه‌ی ASCII جدید بسازید. .TP \fB--optimize=\fP\fIN\fP, \fB-z\fP \fIN\fP سطح بهینه‌سازی را روی \fIN\fP تنظیم می‌کند. سطح از 0 (سریع‌ترین) تا 3 (کندترین) است. هشدار: زمان کدگذاری وقتی \fIN\fP=\fB2\fP یا \fIN\fP=\fB3\fP باشد به شدت افزایش می‌یابد، در حالی که کارایی فشرده‌سازی تنها اندکی بهبود پیدا می‌کند. .sp پیش‌فرض 0 است. .TP \fB--prediction\fP, \fB-P\fP استفاده از کدگذاری پیش‌بینانه اضافی. در صورت فعال بودن این بهینه‌سازی، تصویر در دو مرحله فشرده می‌شود. در مرحله نخست، تقریبی کلی از تصویر با استفاده از بلوک‌های بزرگ تک‌رنگ محاسبه می‌شود. در نهایت، تصویر دلتا (تفاضلی) محاسبه شده و خطای پیش‌بینی با استفاده از الگوریتم استاندارد FIASCO تقریب زده می‌شود. .TP \fB--dictionary-size=\fP\fIN\fP, \fB-D\fP \fIN\fP اندازه فرهنگ‌لغتی را که هنگام کدگذاری باند روشنایی استفاده می‌شود روی \fIN\fP تنظیم می‌کند؛ پیش‌فرض 10000 است، یعنی فرهنگ‌لغت محدودیتی ندارد. .TP \fB--chroma-dictionary=\fP\fIN\fP, \fB-C\fP \fIN\fP اندازه فرهنگ‌لغتی را که هنگام کدگذاری باندهای رنگ استفاده می‌شود روی \fIN\fP تنظیم می‌کند؛ پیش‌فرض 40 است. .TP \fB--chroma-qfactor=\fP\fIN\fP, \fB-Q\fP \fIN\fP کیفیت فشرده‌سازی باند رنگ را نسبت به کیفیت تعریف‌شده توسط کاربر \fIq\fP برای فشرده‌سازی باند روشنایی (\fB--quality\fP=\fIq\fP)، به میزان \fIN\fP برابر کاهش می‌دهد؛ پیش‌فرض 2 است. .TP \fB--tiling-exponent=\fP\fIN\fP, \fB-t\fP \fIN\fP پیش از کدگذاری، تصویر را به 2^\fIN\fP کاشی تقسیم می‌کند؛ پیش‌فرض 4 است، یعنی تصویر به 16 کاشی تقسیم می‌شود. ترتیب پردازش کاشی‌های مجزا با گزینه زیر مشخص می‌شود: .TP \fB--tiling-method=\fP\fIname\fP, \fB-T\fP \fIname\fP کاشی‌های مجزای تصویر (که تصویر به آن‌ها تقسیم شده است؛ گزینه \fB--tiling-exponent=\fP\fIN\fP را ببینید) را بر اساس روش \fIname\fP مرتب می‌کند؛ پیش‌فرض \fBdesc-variance\fP است. .TP \fBdesc-variance\fP کاشی‌های با واریانس کمتر ابتدا پردازش می‌شوند. .TP \fBasc-variance\fP کاشی‌های با واریانس بیشتر ابتدا پردازش می‌شوند. .TP \fBdesc-spiral\fP کاشی‌ها به ترتیب مارپیچی با شروع از مرکز پردازش می‌شوند. .TP \fBasc-spiral\fP کاشی‌ها به ترتیب مارپیچی با شروع از لبه‌ها پردازش می‌شوند. .TP \fB--rpf-mantissa=\fP\fIN\fP استفاده از \fIN\fP بیت مانتیس برای ضرایب کوانتیده‌شده. .TP \fB--dc-rpf-mantissa=\fP\fIN\fP استفاده از \fIN\fP بیت مانتیس برای ضرایب DC کوانتیده‌شده. .TP \fB--rpf-range=\fP\fIN\fP ضرایب خارج از بازه کوانتایزاسیون [-\fIN\fP,+\fIN\fP] برابر با صفر قرار می‌گیرند. .TP \fB--dc-rpf-range=\fP\fIN\fP ضرایب DC خارج از بازه کوانتایزاسیون [-\fIN\fP,+\fIN\fP] برابر با صفر قرار می‌گیرند. .UN videoopts.SS گزینه‌های بیشتر برای فشرده‌سازی ویدیو .TP \fB--smooth=\fP\fIN\fP, \fB-s\fP \fIN\fP فریم‌های مرجع از حالت فشرده خارج‌شده را در امتداد مرزهای افراز به میزان مشخص‌شدهٔ \fIN\fP هموار می‌کند. \fIN\fP مقداری بین 0 (بدون هموارسازی) تا 100 است؛ پیش‌فرض 70 است. این ضریب در فایل FIASCO ذخیره می‌شود. .TP \fB--min-level=\fP\fIN\fP, \fB-m\fP \fIN\fP پیش‌بینی (پیش‌بینی با جبران حرکت یا پیش‌بینی اضافی) را از سطح بلوک \fIN\fP آغاز می‌کند؛ پیش‌فرض سطح 6 است. به این معنی که جبران حرکت برای تمام بلوک‌های تصویری حداقل 8x8 پیکسل (سطح درخت دودویی \fIN\fP=6)، 16x8 (\fIN\fP=7)، 16x16 (\fIN\fP=8) و غیره اعمال می‌شود. .TP \fB--max-level=\fP\fIN\fP, \fB-M\fP \fIN\fP پیش‌بینی (پیش‌بینی با جبران حرکت یا پیش‌بینی اضافی) را در سطح بلوک \fIN\fP متوقف می‌کند؛ پیش‌فرض سطح 10 است. به این معنی که جبران حرکت برای تمام بلوک‌های تصویری حداکثر 16x16 پیکسل (\fIN\fP=8)، 32x16 (\fIN\fP=9)، 32x32 (\fIN\fP=10) و غیره اعمال می‌شود. .TP \fB--half-pixel\fP, \fB-2\fP استفاده از جبران حرکت با دقت نیم‌پیکسل. .TP \fB--fps=\fP\fIN\fP, \fB-F\fP \fIN\fP تعداد فریم بر ثانیه را روی \fIN\fP تنظیم می‌کند. این مقدار در فایل خروجی FIASCO ذخیره شده و در رمزگشای .BR "fiascotopnm" (1)\c \& برای کنترل نرخ فریم به کار می‌رود. .TP \fB--pattern=\fP\fItype\fP, \fB-p\fP \fItype\fP نوع فشرده‌سازی بین‌فریمی که باید برای فریم‌های جداگانهٔ یک جریان ویدیویی اعمال شود را تعیین می‌کند. \fItype\fP دنباله‌ای از نویسه‌ها است؛ مقدار پیش‌فرض "IPPPPPPPPP" است. عنصر \fBN\fP نوع پیش‌بینی مورد استفاده برای فریم \fBN\fP را مشخص می‌کند؛ الگوی نوع فریم به طور دوره‌ای تکرار می‌شود. نویسه‌های معتبر عبارتند از: .TP \fBI\fP فریم درونی (intra frame)؛ یعنی مطلقاً از هیچ پیش‌بینیِ جبران حرکت استفاده نمی‌شود. .TP \fBP\fP فریم پیش‌بینی‌شده (predicted frame)؛ یعنی از فریمی که پیش‌تر کدگذاری شده است برای پیش‌بینی استفاده می‌شود (پیش‌بینی رو به جلو). .TP \fBB\fP فریم پیش‌بینی‌شدهٔ دوجهته (bidirectional predicted frame)؛ یعنی نه تنها از فریمی که قبلاً نمایش داده شده، بلکه از فریمی در آینده نیز برای پیش‌بینی استفاده می‌شود (پیش‌بینی رو به جلو، رو به عقب، یا درون‌یابی‌شده). .TP \fB--cross-B-search\fP به جای استفاده از جستجوی فراگیر، از الگوریتم «Cross-B-Search» برای یافتن بهترین پیش‌بینی درون‌یابی‌شده برای فریم‌های B استفاده می‌شود. .TP \fB--B-as-past-ref\fP هنگام پیش‌بینی فریم جاری، از فریم‌های B که پیش‌تر کدگذاری شده‌اند نیز استفاده می‌کند. در صورت تنظیم نشدن این گزینه، تنها از فریم‌های I و P برای پیش‌بینی فریم جاری استفاده خواهد شد. .UN examples .SH "مثال‌ها (EXAMPLES)" .PP فشرده‌سازی تصویر ثابت "foo.ppm" به فایل FIASCO با نام "foo.wfa" با استفاده از گزینه‌های پیش‌فرض: .nf pnmtofiasco < foo.ppm >foo.wfa .fi .PP فشرده‌سازی فریم‌های ویدیویی "foo0*.ppm" به فایل FIASCO با نام "video.wfa" با استفاده از جبران حرکت با دقت نیم‌پیکسل و نرخ فریم ۱۵ فریم بر ثانیه. فریم درونی ۱ برای پیش‌بینی فریم P شمارهٔ ۴ استفاده می‌شود، فریم‌های ۱ و ۴ برای پیش‌بینی فریم‌های B شماره‌های ۲ و ۳ به کار می‌روند و به همین ترتیب. فریم ۱۰ مجدداً یک فریم درونی است. .nf pnmtofiasco -2 -p "IBBPBBPBB" -fps 15 -o video.wfa foo0*.ppm .fi .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 "fiascotopnm" (1)\c \&, .BR "pnmtojpeg" (1)\c \&, .BR "pnmtojbig" (1)\c \&, .BR "pamtogif" (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 .PP 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. .PP FIASCO: An Open-Source Fractal Image and Sequence Codec, Linux Journal, January 2001. .UN author .SH "نویسندگان (AUTHORS)" Ullrich Hafner <\fIhafner@bigfoot.de\fP> .SH "منبع سند (DOCUMENT SOURCE)" این صفحه راهنما توسط ابزار \(aqmakeman\(aq متعلق به Netpbm و از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد: .IP .B http://netpbm.sourceforge.net/doc/pnmtofiasco.html .PP