-
Notifications
You must be signed in to change notification settings - Fork 50
Home
This program reads in an image of a certain type and converts it to a JPEG 2000 file. opj_compress command line options are listed below:
Input file. Either this argument or the -ImgDir argument described below is required. Valid input image extensions are BMP, PGM, PGX, PNG, PNM, PPM, RAW, RAWL, TGA, TIF. For PNG resp. TIF, it needs libpng resp. libtiff. Concerning the BMP format, the coder accepts 24 bits color images and 8 bits (RLE or no-RLE) images. TIF files can have up to 16 bits per component. With RAW or RAWL images, the -F parameter must be used (see below). In the case of raw images with a component depth comprised between 9 and 16 bits, each component data must be stored on two bytes, RAW format assumes big endianness, RAWL assumes little endianness. When using this option output file must be specified using -o.
Output file. Required when using -i option. Valid output image extensions are J2K, JP2, J2C.
Path to the folder where the images to be compressed are stored. Either this argument or the -i argument described above is required. When Image files are in the same directory as the executable it can be indicated by a dot "." argument. When using this option, output format must be specified using -OutFor. The output codestreams are saved in the same folder.
Output format used to compress the images read from the directory specified with -ImgDir. Required when -ImgDir option is used. Accepted formats are J2K, J2C, and JP2.
Raw input image characteristics. If subsampling is omitted, 1x1 is assumed for all components. Required only if RAW or RAWL input file is provided.
Example of a raw 512x512 image with 4:2:0 subsampling
-F 512,512,3,8,u@1x1:2x2:2x2
Compression ratio values. Each value is a factor of compression, thus 20 means 20 times compressed. Each value represents a quality layer. The order used to define the different levels of compression is important and must be from left to right in descending order. A final lossless quality layer will be signified by the value 1. Default: 1 single lossless quality layer.
Quality values. Each value is a psnr, to be given in dB, and represents a quality layer. The order used to define the different psnr-values is important and must be from left to right in ascending order. Default: 1 single lossless quality layer.
Number of resolutions. It corresponds to the number of DWT decompositions +1. Default: 6.
Code-block size. The dimension must respect the constraint defined in the JPEG-2000 standard (no dimension smaller than 4 or greater than 1024, no code-block with more than 4096 coefficients). The maximum value authorized is 64x64. Default: 64x64.
Precinct size. Values specified must be power of 2. Multiple records may be supplied, in which case the first record refers to the highest resolution level and subsequent records to lower resolution levels. The last specified record is right-shifted for each remaining lower resolution levels. Default: 215x215 at each resolution.
Tile size. Default: the dimension of the whole image, thus only one tile.
Irreversible compression (ICT + DWT 9-7). This option offers the possibility to work with the Irreversible Color Transformation (ICT) in place of the Reversible Color Transformation (RCT) and with the irreversible DWT 9-7 in place of the 5-3 filter. Default: off.
Progression order. The five progression orders are : LRCP, RLCP, RPCL, PCRL and CPRL. Default: LRCP.
Cinema2K profile.This option generates a codestream compliant to the Digital cinema specifications for a 2K resolution content. The value given is the frame rate which can be 24 or 48 fps. The main specifications of the JPEG Profile-3 (2K Digital Cinema Profile) are * Image size = 2048 x 1080 (at least one of the dimensions should match 2048 x 1080) * Single tile * Wavelet transform levels = Maximum of 5 * Wavelet filter = 9-7 filter * Codeblock size = 32 x 32 * Precinct size = 128 x 128 (Lowest frequency subband), 256 x 256 (other subbands) * Maximum Bit rate for entire frame = 1302083 bytes for 24 fps, 651041 bytes for 48fps * Maximum Bit rate for each color component= 1041666 bytes for 24 fps, 520833 bytes for 48fps * Tile parts = 3; Each tile part contains data necessary to decompress one 2K color component * 12 bits per component.
Cinema4K profile. This option generates a codestream compliant to the Digital cinema specifications for a 4K resolution content. The value for frame rate should not be specified. Value is initialized to 24fps. The main specifications of the JPEG Profile-4 (4K Digital Cinema Profile) are * Image size = 4096 x 2160 (at least one of the dimensions must match 4096 x 2160) * Single tile * Wavelet transform levels = Maximum of 6 and mininum of 1 * Wavelet filter = 9-7 filter * Codeblock size = 32 x 32 * Precinct size = 128 x 128 (Lowest frequency subband), 256 x 256 (other subbands) * Maximum Bit rate for entire frame = 1302083 bytes for 24 fps * Maximum Bit rate for each color component= 1041666 bytes for 24 fps * Tile parts = 6; Each of first 3 tile parts contains data necessary to decompress one 2K color component, and each of last 3 tile parts contains data necessary to decompress one 4K color component. * 12 bits per component
-POC T<tile number>=<res num start>,<comp num start>,<layer num end>,<res num end>,<comp num end>,<progression order>
Progression order change. This defines the bounds of resolution, color component, layer and progression order if a progression order change is desired.
Example:
-POC T1=0,0,1,5,3,CPRL/T1=5,0,1,6,3,CPRL
Subsampling factor in X and Y direction, for all components. Currently, this option only enlarges the image canevas and does not not actually reduce the image size. Value higher than 2 can be a source of error ! Default: no subsampling.
SOP marker before each packet. This option offers the possibility to add a specific marker before each packet. Default: no SOP.
EPH marker after each packet header. This option offers the possibility to add a specific marker at the head of each packet header. Default: no EPH.
Switch modes. This option offers the possibility to use a mode switch during the encoding process. There are 6 modes switches: * BYPASS(LAZY) [1] * RESET [2] * RESTART(TERMALL) [4] * VSC [8] * ERTERM(SEGTERM) [16] * SEGMARK(SEGSYM)] [32] For several mode switch you have to add the value between []. Default: no mode switch.
Example : RESTART(4) + RESET(2) + SEGMARK(32) => -M 38
Quantization indices upshifted for a component. Warning: This option does not implement the usual ROI (Region of Interest). It should be understood as a "Component of Interest". It offers the possibility to upshift the value of a component during quantization step. The value after c= is the component number [0, 1, 2, ...] and the value after U= is the value of upshifting. U must be in the range [0, 37].
Offset of the image origin. The division in tile could be modified as the anchor point for tiling will be different than the image origin. However we must keep in mind that the offset of the image can not be higher than the tile dimension if the tile option is used. The 2 values are respectively for X and Y axis offset. Default: no offset.
Offset of the tile origin. We must keep in mind that the tile anchor point can not be on the image area. The 2 values are respectively for X and Y axis offset. Default: no offset.
Explicitly specify if a Multiple Component Transform has to be used. 0: no MCT 1: RGB->YCC conversion 2: custom MCT. If custom MCT, "-m" option has to be used (see below). By default, RGB->YCC conversion is used if there are 3 components or more, no conversion otherwise.
Use array-based MCT, values are coma separated, line by line no specific separators between lines, no space allowed between values. If this option is used, it automatically sets "-mct" option to 2.
Print a help message and exit.
Lossless compression
1 layer of quality
1 tile
Size of precinct 215 x 215 (means 1 precinct)
Size of code-block 64 x 64
Number of resolution (i.e. DWT decomposition level) : 6
No SOP marker in the codestream
No EPH marker in the codestream
No sub-sampling in x and y direction
No mode switch activated
Progression order : LRCP
No index file
No ROI upshifted
No offset of the origin of the image
No offset of the origin of the tiles
Reversible DWT 5-3
This program reads in a jpeg2000 image and converts it to another image type. Valid input image extensions are .j2k, .jp2, .j2c, .jpt Valid output image extensions are .bmp, .pgm, .pgx, .png, .pnm, .ppm, .raw, .tga, .tif . For PNG resp. TIF it needs libpng resp. libtiff .
Input file. Either this argument or the -ImgDir argument described below is required. Valid input image extensions are J2K, JP2, JPC, JPT. When using this option output file must be specified using -o.
Output file. Required when using -i option. Currently accepts BMP, TIF, RAW, TGA, PGM, PPM, PNM and PGX files. Binary data is written to the file (not ascii). If a PGX filename is given, there will be as many output files as there are components: an indice starting from 0 will then be appended to the output filename, just before the "pgx" extension. If a PGM filename is given and there are more than one component, only the first component will be written to the file.
Path to the folder where the compressed images are stored. Either this argument or the -i argument described above is required. When Image files are in the same directory as the executable it can be indicated by a dot "." argument. When using this option, output format must be specified using -OutFor. The output images are saved in the same folder.
Output format used to decompress the codestreams read from the directory specified with -ImgDir. Required when -ImgDir option is used. Currently accepts TIF, RAW, TGA, PGM, PPM, PNM, PGX and BMP format.
Reduce factor. Set the number of highest resolution levels to be discarded. The image resolution is effectively divided by 2 to the power of the number of discarded levels. The reduce factor is limited by the smallest total number of decomposition levels among tiles.
Layer number. Set the maximum number of quality layers to decode. If there are less quality layers than the specified number, all the quality layers are decoded.
Decoding area. Set the decoded area. By default all the image is decoded.
Tile number. Set the tile number of the decoded tile. Follow the JPEG2000 convention from left-up to right-bottom. By default all tiles are decoded.
Force the precision (bit depth) of components. There shall be at least 1 value. Theres no limit on the number of values (comma separated, last values ignored if too much values). If there are less values than components, the last value is used for remaining components. If 'C' is specified (default), values are clipped. If 'S' is specified, values are scaled. A 0 value can be specified (meaning original bit depth).
Force output image colorspace to RGB.
Downsampled components will be upsampled to image size.
Split output components to different files when writing to PNM.
Print a help message and exit.