'\" t
'\" The line above instructs most `man' programs to invoke tbl
'\"
'\" Separate paragraphs; not the same as PP which resets indent level.
.de SP
.if t .sp .5
.if n .sp
..
'\"
'\" Replacement em-dash for nroff (default is too short).
.ie n .ds m " -
.el .ds m \(em
'\"
'\" Placeholder macro for if longer nroff arrow is needed.
.ds RA \(->
'\"
'\" Decimal point set slightly raised
.if t .ds d \v'-.15m'.\v'+.15m'
.if n .ds d .
'\"
'\" Enclosure macro for examples
.de EX
.SP
.nf
.ft CW
..
.de EE
.ft R
.SP
.fi
..
.TH opj_compress 1 "Version 2.1.1" "opj_compress" "converts to jpeg2000 files"
.P
.SH "نام (NAME)"
opj_compress \- فشرده‌سازی و تبدیل انواع تصاویر به پرونده‌های jpeg2000
.P
این برنامه تصویری از یک نوع مشخص را خوانده و آن را به یک پرونده jpeg2000 تبدیل می‌کند. این ابزار بخشی از کتابخانه OpenJPEG است.
.SP
پسوندهای معتبر برای تصویر ورودی عبارتند از:
.B .bmp, .pgm, .pgx, .png, .pnm, .ppm, .raw, .tga, .tif \fR. برای PNG و TIF به ترتیب به libpng و libtiff نیاز است.
.SP
پسوندهای معتبر برای تصویر خروجی عبارتند از:
.B .j2k, .jp2
.SH "خلاصه دستور (SYNOPSIS)"
.P
.B opj_compress \-i \fRinfile.bmp \fB-o \fRoutfile.j2k
.P
.B opj_compress \-ImgDir \fRdirectory_name \fB-OutFor \fRjp2
.P
.B opj_compress \-h \fRنمایش پیام راهنما و خروج.
.P
برای گزینه‌های ویژه، بخش «گزینه‌های JPWL (JPWL OPTIONS)» را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\^b " n,n"
(اندازه بلوک کد (مانند \-b 32,32). پیش‌فرض: 64 x 64)
.TP
.B \-\^c " n"
(اندازه ناحیه/precinct (مانند \-c 128,128). پیش‌فرض: 2^15 x 2^15)
.TP
.B \-\^cinema2K " fps"
جریان کد منطبق بر نمایه Digital Cinema 2K. مقادیر معتبر \fBfps\fR عدد 24 یا 48 است.
.TP
.B \-\^cinema4K
جریان کد منطبق بر نمایه Digital Cinema 4K. نیازی به fps ندارد: پیش‌فرض 24 fps است.
.TP
.B \-\^d " X,Y"
(مبدأ افست تصویر (مانند \-d 150,300))
.TP
.B \-\^h
نمایش پیام راهنما و خروج.
.TP
.B \-\^i " name"
(نام فایل ورودی)
.TP
.B \-\^n " n"
(تعداد تفکیک‌پذیری‌ها/وضوح‌ها. پیش‌فرض: 6)
.TP
.B \-\^o " name"
(نام فایل خروجی)
.TP
.B \-\^p " name"
ترتیب پیشرفت (Progression order). مقدار \fBname\fR می‌تواند یکی از این موارد باشد: LRCP، RLCP، RPCL، PCRL، CPRL. پیش‌فرض: LRCP.
.TP
.B \-\^q " n"
مقدار psnr متفاوت برای لایه‌های متوالی
.br
.B نکته: \fR(گزینه‌های \-r و \-q نمی‌توانند هم‌زمان استفاده شوند)
.TP
.B \-\^r " n"
نسبت(های) فشرده‌سازی مختلف برای لایه‌های متوالی. نرخ مشخص‌شده برای هر سطح کیفیت، ضریب فشرده‌سازی مورد نظر است.
.br
.B نکته: \fR(گزینه‌های \-r و \-q نمی‌توانند هم‌زمان استفاده شوند)
.TP
.B \-\^s " X,Y"
ضریب زیرنمونه‌برداری (مانند \-s 2,2). پیش‌فرض: بدون زیرنمونه‌برداری در جهت x یا y.
.br
.B توجه: \fRزیرنمونه‌برداری بزرگ‌تر از 2 می‌تواند خطا تولید کند.
.TP
.B \-\^t " W,H"
(اندازه کاشی/tile (مانند \-t 512,512))
.TP
.B \-\^x " name"
(ایجاد فایل نمایه و پر کردن آن. پیش‌فرض: بدون فایل نمایه)
.TP
.B \-\^EPH
(نوشتن نشانگر EPH پس از هر بسته سرایند. پیش‌فرض: بدون EPH)
.TP
.B \-\^F " rawWidth,rawHeight,rawComp,rawBitDepth,s_or_u"
مشخصات تصویر خام ورودی
.TP
.B \-\^I
(استفاده از DWT 9-7 برگشت‌ناپذیر. پیش‌فرض: DWT 5-3 برگشت‌پذیر)
.TP
.B \-\^ImgDir " directory_name"
(دایرکتوری حاوی فایل‌های ورودی)
.TP
.B \-\^M " n"
سوئیچ حالت با مقادیر: 1, 2, 4, 8, 16, 32. پیش‌فرض: هیچ سوئیچ حالتی فعال نیست.
.br
\fIمفهوم:\fR
.br
BYPASS(1) 
.br
RESET(2) 
.br
RESTART(4) 
.br
VSC(8) 
.br
ERTERM(16) 
.br
SEGMARK(32)
.br
مقادیر می‌توانند جمع شوند: RESTART(4) + RESET(2) + SEGMARK(32) = \-M 38
.TP
.B \-\^OutFor "ext"
(پسوند برای فایل‌های خروجی)
.TP
.B \-\^POC "TtileNr=resolutionStart, componentStart, layerEnd, resolutionEnd, componentEnd, progressionOrder"
(بخش مثال‌ها را ببینید)
.TP
.B \-\^ROI "c=n,U=n"
شاخص‌های کوانتش شیفت‌یافته به بالا برای مؤلفه c (مقدار 0 یا 1 یا 2) با مقدار U (بزرگ‌تر یا مساوی 0 و کوچک‌تر یا مساوی 37)
.br
مانند \fB-ROI c=0,U=25\fR
.TP
.B \-\^SOP
(نوشتن نشانگر SOP پیش از هر بسته. پیش‌فرض: بدون نشانگر SOP در جریان کد.)
.TP
.B \-\^T "X,Y"
(مبدأ مختصات کاشی‌ها (مانند \-T 100,75))
.TP
.B \-\^W
(بخش گزینه‌های JPWL را ببینید)
.P
.SH "گزینه‌های JPWL (JPWL OPTIONS)"
این گزینه‌ها تنها در صورتی قابل استفاده هستند که کتابخانه با \fB-DUSE_JPWL\fR کامپایل شده باشد.
.P
.B      \-W h<tilepart><=type>, s<tilepart><=method>, a=<addr>, z=<size>, g=<range>, p<tilepart:pack><=type>
.P
.B h\fR حفاظت خطای سرایند (EPB) را انتخاب می‌کند: \fBtype\fR می‌تواند این مقادیر باشد:
   [0=none 1,absent=predefined 16=CRC-16 32=CRC-32 37-128=RS]
   اگر \fBtilepart\fR مشخص نشده باشد، برای سرایندهای اصلی و کاشی اعمال می‌شود
   اگر \fBtilepart\fR مشخص شده باشد، از آن کاشی به بعد اعمال می‌شود،
     تا مشخصه بعدی h<>، یا تا آخرین بخش کاشی در جریان کد
     (حداکثر ۱۶ مشخصه)
.P
.B p \fRحفاظت خطای بسته (EEP/UEP همراه با EPBها) را برای اعمال
  روی داده‌های خام انتخاب می‌کند: \fBtype\fR می‌تواند این مقادیر باشد:
   [0=none 1,absent=predefined 16=CRC-16 32=CRC-32 37-128=RS]
   اگر \fBtilepart:pack\fR مشخص نشده باشد، از کاشی ۰، بسته ۰ اعمال می‌شود
   اگر \fBtilepart:pack\fR مشخص شده باشد، از آن کاشی و آن بسته به بعد
     اعمال می‌شود، تا مشخصه بسته بعدی یا تا آخرین بسته
     در آخرین بخش کاشی در جریان داده (حداکثر ۱۶ مشخصه)
.P
.B s \fRدرج داده‌های حساسیت (ESD) را فعال می‌کند: \fBmethod\fR می‌تواند این مقادیر باشد:
   [\-1=NO ESD 0=RELATIVE ERROR 1=MSE 2=MSE REDUCTION 3=PSNR
    4=PSNR INCREMENT 5=MAXERR 6=TSE 7=RESERVED]
   اگر \fBtilepart\fR مشخص نشده باشد، تنها برای سرایند اصلی اعمال می‌شود
   اگر \fBtilepart\fR مشخص شده باشد، از آن کاشی به بعد اعمال می‌شود،
     تا مشخصه بعدی s<>، یا تا آخرین بخش کاشی در جریان کد
     (حداکثر ۱۶ مشخصه)
.P
.B g \fRحالت آدرس‌دهی را تعیین می‌کند: \fBrange\fR می‌تواند این مقادیر باشد:
   [0=PACKET 1=BYTE RANGE 2=PACKET RANGE]
.P
.B a \fRاندازه آدرس‌دهی داده را تعیین می‌کند: \fBaddr\fR می‌تواند
   ۲/۴ بایت باشد (جریان‌های کد کوچک/بزرگ). در صورت تنظیم نشدن، حالت خودکار است
.P
.B z \fRاندازه مقادیر حساسیت را تعیین می‌کند: \fBsize\fR می‌تواند
   ۱/۲ بایت باشد، برای مقدار شبه ممیز شناور تبدیل‌شده
.P
.SH "مثال‌ها (EXAMPLES)"
.P
.B opj_compress \-i \fRfile.bmp \fB-o \fRfile.j2k \fB-r \fR20,10,1 \fR(فشرده‌سازی ۲۰ برابر، سپس ۱۰ برابر، سپس بدون اتلاف).
.P
.B opj_compress \-i \fRfile.ppm \fB-o \fRfile.j2k \fB-q \fR30,40,50
.P
.B opj_compress \-i \fRfile.pgx \fB-o \fRfile.j2k \fB-POC \fRT1=0,0,1,5,3,CPRL
.P
.B opj_compress \-i \fRlena.raw \fB-o \fRlena.j2k \fB-F \fR512,512,3,8,u
.P
.SH "نویسندگان (AUTHORS)"
Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium
.br
Copyright (c) 2002-2014, Professor Benoit Macq
.br
Copyright (c) 2001-2003, David Janssens
.br
Copyright (c) 2002-2003, Yannick Verschueren
.br
Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe
.br
Copyright (c) 2005, Herve Drolon, FreeImage Team
.br
Copyright (c) 2006-2007, Parvatha Elangovan
.P
.SH "همچنین ببینید (SEE ALSO)"
opj_decompress(1) opj_dump(1)