.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH OPJ_JP3D_COMPRESS "1" "October 2017" "opj_jp3d_compress 2.1.0" "User Commands"
.SH NAME
opj_jp3d_compress \- Works with JPEG2000 files
.SH DESCRIPTION
List of parameters for the JPEG2000 Part 10 encoder:
\fB\-\-\-\-\-\-\-\-\-\-\-\-\fR
.PP
Required Parameters (except with \fB\-h\fR):
.PP
\fB\-i\fR           : source file  (\fB\-i\fR source.bin or source*.pgx)
.PP
\fB\-m\fR           : source characteristics file (\fB\-m\fR imgfile.img)
.PP
\fB\-o\fR           : destination file (\fB\-o\fR dest.jp3d)
.PP
Optional Parameters:
.PP
\fB\-h\fR           : display the help information
.PP
\fB\-n\fR           : number of resolutions (\fB\-n\fR 3,3,3)
.PP
\fB\-I\fR           : use the irreversible transforms: ICT + DWT 9\-7 (\fB\-I\fR)
.PP
\fB\-C\fR           : coding algorithm (\fB\-C\fR 2EB) [2EB, 3EB]
.PP
\fB\-r\fR           : different compression ratios for successive layers (\fB\-r\fR 20,10,5)
.IP
\- The rate specified for each quality level is the desired compression factor.
\- Rate 1 means lossless compression
.IP
(options \fB\-r\fR and \fB\-q\fR cannot be used together)
.PP
\fB\-q\fR           : different psnr for successive layers (\fB\-q\fR 30,40,50)
.IP
(options \fB\-r\fR and \fB\-q\fR cannot be used together)
.PP
\fB\-b\fR           : size of code block (\fB\-b\fR 32,32,32)
.PP
\fB\-c\fR           : size of precinct (\fB\-c\fR 128,128,128)
.PP
\fB\-t\fR           : size of tile (\fB\-t\fR 512,512,512)
.PP
\fB\-p\fR           : progression order (\fB\-p\fR LRCP) [LRCP, RLCP, RPCL, PCRL, CPRL]
.PP
\fB\-s\fR           : subsampling factor (\fB\-s\fR 2,2,2) [\-s X,Y,Z]
.IP
\- Remark: subsampling bigger than 2 can produce error
.PP
\fB\-SOP\fR         : write SOP marker before each packet
.PP
\fB\-EPH\fR         : write EPH marker after each header packet
.PP
\fB\-M\fR           : code\-block style (\fB\-M\fR 0) [1=BYPASS(LAZY) 2=RESET 4=RESTART(TERMALL)
.IP
8=VSC 16=PTERM 32=SEGSYM 64=3DCTXT]
Indicate multiple modes by adding their values.
ex: RESTART(4) + RESET(2) + SEGMARK(32) = \fB\-M\fR 38
.PP
\fB\-D\fR           : define DC offset (\fB\-D\fR 12)
.PP
\fB\-x\fR           : create an index file *.Idx (\fB\-x\fR index_name.Idx)
.PP
\fB\-ROI\fR         : c=%d,U=%d : quantization indices upshifted
.IP
for component c=%d [%d = 0,1,2]
with a value of U=%d [0 <= %d <= 37] (i.e. \fB\-ROI\fR:c=0,U=25)
.PP
\fB\-d\fR           : offset of the origin of the volume (\fB\-d\fR 150,300,100)
.PP
\fB\-l\fR           : offset of the origin of the tiles (\fB\-l\fR 100,75,25)
.PP
DEFAULT CODING:
\fB\-\-\-\-\-\-\-\-\-\-\-\-\fR
.IP
* Lossless
* 1 tile
* Size of precinct : 2^15 x 2^15 x 2^15 (means 1 precinct)
* Size of code\-block : 64 x 64 x 64
* Number of resolutions in x, y and z axis: 3
* No SOP marker in the codestream
* No EPH marker in the codestream
* No sub\-sampling in x, y or z direction
* No mode switch activated
* Progression order: LRCP
* No index file
* No ROI upshifted
* No offset of the origin of the volume
* No offset of the origin of the tiles
* Reversible DWT 5\-3 on each 2D slice
* Coding algorithm: 2D\-EBCOT
.PP
REMARKS:
\fB\-\-\-\-\-\-\-\-\-\fR
.PP
\- The markers written to the main_header are : SOC SIZ COD QCD COM.
\- COD and QCD markers will never appear in the tile_header.
.PP
\- You need enough disk space memory (twice the original) to encode
the volume,i.e. for a 1.5 GB volume you need a minimum of 3GB of disk memory)
.PP
\- When loading *.pgx files, a relative path to directory is needed for input argument
.IP
followed by the common prefix of the slices and a '*' character representing sequential numeration.
.PP
( \fB\-i\fR relativepath/slices*.pgx )
.IP
\- The index file has the structure below:
.IP
Image_height Image_width Image_depth
Progression order: 0 (LRCP)
Tiles_size_X Tiles_size_Y Tiles_size_Z
Components_nb
Layers_nb
Decomposition_levels
[Precincts_size_X_res_Nr Precincts_size_Y_res_Nr Precincts_size_Z_res_Nr]
.IP
\&...
.IP
[Precincts_size_X_res_0 Precincts_size_Y_res_0 Precincts_size_Z_res_0]
Main_header_end_position
Codestream_size
Tile_0 [start_pos end_header end_pos TotalDisto NumPix MaxMSE]
\&...
Tile_Nt [  ''         ''        ''        ''       ''    ''  ]
.IP
Tpacket_0 [Tile layer res. comp. prec. start_pos end_pos disto]
\&...
Tpacket_Np [''   ''    ''   ''    ''       ''       ''     '' ]
MaxDisto
TotalDisto
.SH AUTHOR
This  manual  page was written by Mathieu Malaterre <malat@debian.org> for
the Debian GNU/Linux system, but may be used by others.