openjpeg/libopenjpeg/jpwl
Mickael Savinaud 3135642ff5 [trunk] Remove CMake-language block-end command arguments
Ancient versions of CMake required else(), endif(), and similar block termination commands to have arguments matching the command starting the block.  This is no longer the preferred style.
Thanks to Hans Johnson
2012-08-30 17:20:03 +00:00
..
CMakeLists.txt [trunk] Remove CMake-language block-end command arguments 2012-08-30 17:20:03 +00:00
Makefile.am [trunk] add libopenjpeg-jpwl.pc.in. fix output when --disable-shared or --disable-static is passed to configure. Minor clean up of configure.ac. 2011-10-10 06:51:08 +00:00
README.txt [trunk] Remove exe bit on CMakeLists.txt. Set from DOS eol to UNIX eol 2012-03-02 14:33:29 +00:00
crc.c [trunk] move functionalities of stdint/inttype into opj_stdint/opj_inttypes 2012-03-19 10:15:46 +00:00
crc.h re-organization of openjpeg directories hierarchy : step 1 2011-04-13 21:01:39 +00:00
jpwl.c [trunk] STYLE: Clean up documentation errors 2012-08-30 16:56:31 +00:00
jpwl.h [trunk] realloc is misused and may leak memory (Issue#168) (complements: compilation errors) 2012-08-23 19:34:41 +00:00
jpwl_lib.c [trunk] realloc is misused and may leak memory (Issue#168) (complements: compilation errors) 2012-08-23 19:34:41 +00:00
rs.c re-organization of openjpeg directories hierarchy : step 1 2011-04-13 21:01:39 +00:00
rs.h re-organization of openjpeg directories hierarchy : step 1 2011-04-13 21:01:39 +00:00

README.txt

===============================================================================
	JPEG2000 Part 11 (ISO/IEC 15444-11 JPWL) Software



		Version 20061213
===============================================================================





1. Scope
=============

This document describes the installation and use of the JPWL module in the framework of OpenJPEG library.

This implementation has been developed from OpenJPEG implementation of JPEG2000 standard, and for this reason it is written in C language.

If you find some bugs or if you have problems using the encoder/decoder, please send an e-mail to jpwl@diei.unipg.it


2. Installing the code
==========================

The JPWL code is integrated with the standard OpenJPEG library and codecs: it is activated by setting the macro USE_JPWL to defined in the preprocessor configuration options of your preferred C compiler.

2.1. Compiling the source code in Windows
-------------------------------------------

The "jpwl" directory is already populated with a couple of Visual C++ 6.0 workspaces

 * JPWL_image_to_j2k.dsw - Creates the encoder with JPWL functionalities
 * JPWL_j2k_to_image.dsw - Creates the decoder with JPWL functionalities

2.2. Compiling the source code in Unix-like systems
-----------------------------------------------------

Under linux, enter the jpwl directory and type "make clean" and "make".


3. Running the JPWL software
=========================

The options available at the command line are exactly the same of the base OpenJPEG codecs. In addition, there is a "-W" switch that activates JPWL functionalities.

3.1. JPWL Encoder
-------------------

-W           : adoption of JPWL (Part 11) capabilities (-W params)
               The parameters can be written and repeated in any order:
               [h<tile><=type>,s<tile><=method>,a=<addr>,z=<size>,g=<range>,...
                ...,p<tile:pack><=type>]

                 h selects the header error protection (EPB): 'type' can be
                   [0=none 1,absent=predefined 16=CRC-16 32=CRC-32 37-128=RS]
                   if 'tile' is absent, it applies to main and tile headers
                   if 'tile' is present, it applies from that tile
                     onwards, up to the next h<tile> spec, or to the last tile
                     in the codestream (max. 16 specs)

                 p selects the packet error protection (EEP/UEP with EPBs)
                  to be applied to raw data: 'type' can be
                   [0=none 1,absent=predefined 16=CRC-16 32=CRC-32 37-128=RS]
                   if 'tile:pack' is absent, it starts from tile 0, packet 0
                   if 'tile:pack' is present, it applies from that tile
                     and that packet onwards, up to the next packet spec
                     or to the last packet in the last tile in the codestream
                     (max. 16 specs)

                 s enables sensitivity data insertion (ESD): 'method' can be
                   [-1=NO ESD 0=RELATIVE ERROR 1=MSE 2=MSE REDUCTION 3=PSNR
                    4=PSNR INCREMENT 5=MAXERR 6=TSE 7=RESERVED]
                   if 'tile' is absent, it applies to main header only
                   if 'tile' is present, it applies from that tile
                     onwards, up to the next s<tile> spec, or to the last tile
                     in the codestream (max. 16 specs)

                 g determines the addressing mode: <range> can be
                   [0=PACKET 1=BYTE RANGE 2=PACKET RANGE]

                 a determines the size of data addressing: <addr> can be
                   2/4 bytes (small/large codestreams). If not set, auto-mode

                 z determines the size of sensitivity values: <size> can be
                   1/2 bytes, for the transformed pseudo-floating point value

                 ex.:
 h,h0=64,h3=16,h5=32,p0=78,p0:24=56,p1,p3:0=0,p3:20=32,s=0,s0=6,s3=-1,a=0,g=1,z=1
                 means
                   predefined EPB in MH, rs(64,32) from TPH 0 to TPH 2,
                   CRC-16 in TPH 3 and TPH 4, CRC-32 in remaining TPHs,
                   UEP rs(78,32) for packets 0 to 23 of tile 0,
                   UEP rs(56,32) for packets 24 to the last of tile 0,
                   UEP rs default for packets of tile 1,
                   no UEP for packets 0 to 19 of tile 3,
                   UEP CRC-32 for packets 20 of tile 3 to last tile,
                   relative sensitivity ESD for MH,
                   TSE ESD from TPH 0 to TPH 2, byte range with automatic
                   size of addresses and 1 byte for each sensitivity value

                 ex.:
                       h,s,p
                 means
                   default protection to headers (MH and TPHs) as well as
                   data packets, one ESD in MH

                 N.B.: use the following recommendations when specifying
                       the JPWL parameters list
                   - when you use UEP, always pair the 'p' option with 'h'

3.2. JPWL Decoder
-------------------

  -W <options>
    Activates the JPWL correction capability, if the codestream complies.
    Options can be a comma separated list of <param=val> tokens:
    c, c=numcomps
       numcomps is the number of expected components in the codestream
       (search of first EPB rely upon this, default is 3)


4. Known bugs and limitations
===============================

4.1. Bugs
-----------

* It is not possible to save a JPWL encoded codestream using the wrapped file format (i.e. JP2): only raw file format (i.e. J2K) is working

4.2. Limitations
------------------

* When specifying an UEP protection, you need to activate even TPH protection for those tiles where there is a protection of the packets
* RED insertion is not currently implemented at the decoder
* JPWL at entropy coding level is not implemented