NAME¶

opj_jp3d_compress - Works with JPEG2000 files

DESCRIPTION¶

List of parameters for the JPEG2000 Part 10 encoder: ------------ Required Parameters (except with -h): -i : source file (-i source.bin or source*.pgx) -m : source characteristics file (-m imgfile.img) -o : destination file (-o dest.jp3d) Optional Parameters: -h : display the help information -n : number of resolutions (-n 3,3,3) -I : use the irreversible transforms: ICT + DWT 9-7 (-I) -C : coding algorithm (-C 2EB) [2EB, 3EB] -r : different compression ratios for successive layers (-r 20,10,5)

- The rate specified for each quality level is the desired compression factor. - Rate 1 means lossless compression

(options -r and -q cannot be used together)

-q : different psnr for successive layers (-q 30,40,50)

(options -r and -q cannot be used together)

-b : size of code block (-b 32,32,32) -c : size of precinct (-c 128,128,128) -t : size of tile (-t 512,512,512) -p : progression order (-p LRCP) [LRCP, RLCP, RPCL, PCRL, CPRL] -s : subsampling factor (-s 2,2,2) [-s X,Y,Z]

- Remark: subsampling bigger than 2 can produce error

-SOP : write SOP marker before each packet -EPH : write EPH marker after each header packet -M : code-block style (-M 0) [1=BYPASS(LAZY) 2=RESET 4=RESTART(TERMALL)

8=VSC 16=PTERM 32=SEGSYM 64=3DCTXT] Indicate multiple modes by adding their values. ex: RESTART(4) + RESET(2) + SEGMARK(32) = -M 38

-D : define DC offset (-D 12) -x : create an index file *.Idx (-x index_name.Idx) -ROI : c=%d,U=%d : quantization indices upshifted

for component c=%d [%d = 0,1,2] with a value of U=%d [0 <= %d <= 37] (i.e. -ROI:c=0,U=25)

-d : offset of the origin of the volume (-d 150,300,100) -l : offset of the origin of the tiles (-l 100,75,25) DEFAULT CODING: ------------

* 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

REMARKS: --------- - The markers written to the main_header are : SOC SIZ COD QCD COM. - COD and QCD markers will never appear in the tile_header. - 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) - When loading *.pgx files, a relative path to directory is needed for input argument

followed by the common prefix of the slices and a '*' character representing sequential numeration.

( -i relativepath/slices*.pgx )

- The index file has the structure below:

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]

...

[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 [ '' '' '' '' '' '' ]

Tpacket_0 [Tile layer res. comp. prec. start_pos end_pos disto] ... Tpacket_Np ['' '' '' '' '' '' '' '' ] MaxDisto TotalDisto

AUTHOR¶

This manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system, but may be used by others.