.\" maxcso.1
.\"
.Dd November 22, 2018
.Dt MAXCSO 1
.Os
.Sh "نام (NAME)"
.Nm MAXCSO
.Nd فشرده‌ساز سریع CSO
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm maxcso
.Op Fl -args
.Op Ar input.iso
.Op Fl o Ar output.cso
.Sh "توضیحات (DESCRIPTION)"
برنامه‌ای سریع برای فشرده‌سازی ISO به CSO جهت استفاده در شبیه‌سازهای PSP و PS2، که از چندین الگوریتم برای دستیابی به بهترین نسبت فشرده‌سازی بهره می‌برد.
.Ss ویژگی‌ها
.Bl -bullet -offset <TAB> -compact
.It
امکان استفاده از هر تعداد هسته پردازنده (CPU) به میزان دلخواه شما.
.It
امکان استفاده از
.Xr zlib 3 ،
deflate متعلق به 7-zip و Zopfli.
.It
پردازش هم‌زمان چندین فایل در یک دستور.
.It
امکان دریافت فایل CSO یا DAX به عنوان منبع.
.It
توانایی تولید خروجی با اندازه‌های بلوک بزرگ‌تر.
.It
پشتیبانی از قالب‌های آزمایشی CSO v2 و ZSO با استفاده از
.Xr lz4 1
(فشرده‌گشایی سریع‌تر).
.It
تنظیم آستانه فشرده‌سازی deflate یا
.Xr lz4 1 .
.It
فشرده‌گشایی تمام ورودی‌های پشتیبانی‌شده (از جمله DAX و CSO v2).
.El
.Ss فشرده‌سازی
ابزار
.Nm maxcso
همیشه از سطح فشرده‌سازی ۹ استفاده می‌کند.
سرعت فشرده‌گشایی صرف‌نظر از سطح فشرده‌سازی تقریباً یکسان است، و دسترسی به دیسک با فایل‌های کوچک‌تر سریع‌تر انجام می‌شود.
.Pp
استفاده از deflate متعلق به 7-zip و Zopfli نسبت‌های فشرده‌سازی را بهبود می‌بخشد، اما انتظار تفاوت چشمگیری نداشته باشید.
نتایج معمول بین ۰٫۵٪ تا ۱٫۰٪ کوچک‌تر هستند.
.Pp
اندازه‌های بلوک بزرگ‌تر از مقدار پیش‌فرض، فشرده‌سازی را در محدوده ۲ تا ۳ درصد بهبود می‌بخشند.
با این حال، ممکن است این فایل‌ها با برخی نرم‌افزارها سازگار نباشند.
برای نمونه، نسخه‌هایی از
.Nm ppsspp
که پس از ۲۰۱۴-۱۰-۲۶ منتشر شده‌اند از اندازه‌های بلوک بزرگ‌تر پشتیبانی می‌کنند.
.Pp
در جاهایی که فایل‌های CSO با اندازه بلوک بزرگ‌تر پشتیبانی می‌شوند از DAX دوری کنید، چرا که DAX کارایی کمتری دارد.
.Pp
پشتیبانی از
.Xr lz4 1
بیشتر جنبه آزمایشی دارد.
.Ss سرعت
در مقایسه با ابزارهای دیگر مانند ciso و CisoPlus،
.Nm maxcso
می‌تواند بسیار سریع‌تر اجرا شود و به همان میزان فشرده‌سازی دست یابد.
از
.Fl -fast
برای دستیابی به سریع‌ترین فشرده‌سازی استفاده کنید که با سطح ۹ در سایر ابزارها مطابقت دارد.
.Pp
علاوه بر این، اگر پردازنده‌ای با بیش از دو هسته داشته باشید،
.Nm maxcso
از تمام هسته‌های شما استفاده خواهد کرد و عملکردی حتی بهتر ارائه می‌دهد.
.Pp
در عمل، CSOها معمولاً در تمام شبیه‌سازهای شناخته‌شده عملکرد خوبی دارند.
برخی نسخه‌های سفت‌افزار کنسول PSP دارای اشکالاتی در بخش پشتیبانی از CSO هستند، اما این موضوع بر شبیه‌سازها تأثیری نمی‌گذارد.
.Sh "گزینه‌ها (OPTIONS)"
می‌توان چندین فایل را مشخص کرد.
ورودی‌ها می‌توانند فایل‌های iso یا cso باشند.
.Bl -tag -width indent
.It Fl -threads=N
مشخص کردن N رشته (thread) برای I/O و فشرده‌سازی.
.It Fl -quiet
جلوگیری از نمایش وضعیت خروجی.
.It Fl -crc
ثبت مجموع‌های مقابله‌ای CRC32 و نادیده‌گرفتن روش‌ها و فایل‌های خروجی.
.It Fl -fast
تنها استفاده از
.Xr zlib 3
پایه یا lz4 برای دستیابی به سریع‌ترین نتیجه.
.It Fl -decompress
نوشتن روی فایل خام ISO و فشرده‌گشایی در صورت نیاز.
.It Fl -block=N
مشخص کردن اندازه بلوک (پیش‌فرض به اندازه iso بستگی دارد).
بسیاری از برنامه‌های خواننده تنها از اندازه 2048 پشتیبانی می‌کنند.
.It Fl -format=VER Ar cso1 , cso2 , zso , dax
مشخص کردن نسخه cso.
این نسخه‌ها آزمایشی هستند و مقدار پیش‌فرض
.Ar cso1
است.
.It Fl -usr-zlib
فعال‌سازی آزمودن
.Xr zlib 3
برای فشرده‌سازی deflate.
.It Fl -use-zopli
فعال‌سازی آزمودن Zopfli برای فشرده‌سازی deflate.
از آنجا که Zopfli به طور قابل‌توجهی از سایر روش‌ها کندتر است و حافظه بسیار بیشتری مصرف می‌کند، به طور پیش‌فرض غیرفعال است.
برای حداکثر فشرده‌سازی استفاده شود.
.It Fl -use-7zdeflate
فعال‌سازی آزمودن فشرده‌سازی deflate متعلق به 7-zip.
.It Fl -use-lz4
فعال‌سازی آزمودن lz4hc برای فشرده‌سازی
.Xr lz4 1 .
.It Fl -use-lz4brute
فعال‌سازی آزمودن جامع (bruteforce) با lz4hc برای فشرده‌سازی
.Xr lz4 1 .
.It Fl -only-METHOD
تنها اجازه دادن به یک روش فشرده‌سازی مشخص (مانند
.Xr zlib 3
و مواردی که در بالا آمد).
.It Fl -no-METHOD
غیرفعال‌سازی یک روش فشرده‌سازی مشخص (مانند
.Xr zlib 3
و مواردی که در بالا آمد).
.It Fl -lz4-cost=N
اجازه دادن به
.Xr lz4 1
برای افزایش اندازه بلوک حداکثر تا N% (تنها در cso2).
.It Fl -orig-cost=N
اجازه دادن به داده‌های فشرده‌نشده برای افزایش اندازه بلوک حداکثر تا N%.
.It Fl --output-path=X
خروجی در مسیر X/، استفاده از basename برای خروجی‌های پیش‌فرض.
.El
.Pp
آرگومان‌های cost به شما این امکان را می‌دهند تا با استفاده از
.Xr lz4 1
یا بدون فشرده‌سازی، اجازه دهید هر بلوک تا N% بزرگ‌تر باشد.
این کار خواندن فایل را سریع‌تر می‌کند (مصرف کمتر پردازنده)، اما فضای بیشتری اشغال خواهد شد.
.Sh "مثال‌ها (EXAMPLES)"
.Bl -tag -width indent
.It Nm maxcso Ar myfile.iso
فشرده‌سازی
.Ar myfile.iso
و ایجاد myfile.cso.
.It Nm maxcso Ar myfile.iso Fl o Ar output.cso
فشرده‌سازی
.Ar myfile.iso
و ایجاد
.Ar output.cso .
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr lz4 1 ,
.Xr PCSX2 1 ,
.Xr zlib 3
.Sh "گزارش باگ‌ها (BUGS)"
.Lk https://github.com/unknownbrackets/maxcso/issues "سامانه پیگیری مشکلات"