ucar.jpeg.jj2000.j2k.wavelet.synthesis

Class InvWTFull

java.lang.Object

ucar.jpeg.jj2000.j2k.wavelet.synthesis.InvWTAdapter

ucar.jpeg.jj2000.j2k.wavelet.synthesis.InverseWT

ucar.jpeg.jj2000.j2k.wavelet.synthesis.InvWTFull

All Implemented Interfaces:

BlkImgDataSrc, ImgData, InvWT, WaveletTransform

public class InvWTFull
extends InverseWT

This class implements the InverseWT with the full-page approach for int and float data.

The image can be reconstructed at different (image) resolution levels indexed from the lowest resolution available for each tile-component. This is controlled by the setImgResLevel() method.

Note: Image resolution level indexes may differ from tile-component resolution index. They are indeed indexed starting from the lowest number of decomposition levels of each component of each tile.

Example: For an image (1 tile) with 2 components (component 0 having 2 decomposition levels and component 1 having 3 decomposition levels), the first (tile-) component has 3 resolution levels and the second one has 4 resolution levels, whereas the image has only 3 resolution levels available.

This implementation does not support progressive data: Data is considered to be non-progressive (i.e. "final" data) and the 'progressive' attribute of the 'DataBlk' class is always set to false, see the 'DataBlk' class.

See Also:

DataBlk

Field Summary

Fields inherited from class ucar.jpeg.jj2000.j2k.wavelet.synthesis.InvWTAdapter

decSpec, maxImgRes, mressrc, reslvl

Fields inherited from interface ucar.jpeg.jj2000.j2k.wavelet.WaveletTransform

WT_IMPL_FULL, WT_IMPL_LINE

Constructor Summary

Constructors

Constructor and Description
InvWTFull(CBlkWTDataSrcDec src, DecoderSpecs decSpec) Initializes this object with the given source of wavelet coefficients.

Method Summary

Modifier and Type	Method and Description
DataBlk	getCompData(DataBlk blk, int c) Returns a block of image data containing the specifed rectangular area, in the specified component, as a copy (see below).
int	getFixedPoint(int c) Returns the position of the fixed point in the specified component.
int	getImplementationType(int c) Returns the implementation type of this wavelet transform, WT_IMPL_FULL (full-page based transform).
DataBlk	getInternCompData(DataBlk blk, int c) Returns a block of image data containing the specifed rectangular area, in the specified component, as a reference to the internal buffer (see below).
int	getNomRangeBits(int c) Returns the number of bits, referred to as the "range bits", corresponding to the nominal range of the data in the specified component.
boolean	isReversible(int t, int c) Returns the reversibility of the wavelet transform for the specified component, in the current tile.
void	nextTile() Advances to the next tile, in standard scan-line order (by rows then columns).
void	setTile(int x, int y) Changes the current tile, given the new indexes.

Methods inherited from class ucar.jpeg.jj2000.j2k.wavelet.synthesis.InverseWT

createInstance

Methods inherited from class ucar.jpeg.jj2000.j2k.wavelet.synthesis.InvWTAdapter

getCompImgHeight, getCompImgWidth, getCompSubsX, getCompSubsY, getCompULX, getCompULY, getImgHeight, getImgULX, getImgULY, getImgWidth, getNomTileHeight, getNomTileWidth, getNumComps, getNumTiles, getNumTiles, getSynSubbandTree, getTile, getTileCompHeight, getTileCompWidth, getTileHeight, getTileIdx, getTilePartULX, getTilePartULY, getTileWidth, setImgResLevel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ucar.jpeg.jj2000.j2k.image.ImgData

getCompImgHeight, getCompImgWidth, getCompSubsX, getCompSubsY, getCompULX, getCompULY, getImgHeight, getImgULX, getImgULY, getImgWidth, getNomTileHeight, getNomTileWidth, getNumComps, getNumTiles, getNumTiles, getTile, getTileCompHeight, getTileCompWidth, getTileHeight, getTileIdx, getTilePartULX, getTilePartULY, getTileWidth

Constructor Detail

InvWTFull

public InvWTFull(CBlkWTDataSrcDec src,
                 DecoderSpecs decSpec)

Initializes this object with the given source of wavelet coefficients. It initializes the resolution level for full resolutioin reconstruction.

Parameters:

src - from where the wavelet coefficinets should be obtained.

decSpec - The decoder specifications

Method Detail

isReversible

public boolean isReversible(int t,
                            int c)

Returns the reversibility of the wavelet transform for the specified component, in the current tile. A wavelet transform is reversible when it is suitable for lossless and lossy-to-lossless compression.

Parameters:

t - The index of the tile.

c - The index of the component.

Returns:

true is the wavelet transform is reversible, false if not.

getNomRangeBits

public int getNomRangeBits(int c)

Returns the number of bits, referred to as the "range bits", corresponding to the nominal range of the data in the specified component.

The returned value corresponds to the nominal dynamic range of the reconstructed image data, as long as the getNomRangeBits() method of the source returns a value corresponding to the nominal dynamic range of the image data and not not of the wavelet coefficients.

If this number is b then for unsigned data the nominal range is between 0 and 2^b-1, and for signed data it is between -2^(b-1) and 2^(b-1)-1.

Parameters:

c - The index of the component.

Returns:

The number of bits corresponding to the nominal range of the data.

getFixedPoint

public int getFixedPoint(int c)

Returns the position of the fixed point in the specified component. This is the position of the least significant integral (i.e. non-fractional) bit, which is equivalent to the number of fractional bits. For instance, for fixed-point values with 2 fractional bits, 2 is returned. For floating-point data this value does not apply and 0 should be returned. Position 0 is the position of the least significant bit in the data.

This default implementation assumes that the wavelet transform does not modify the fixed point. If that were the case this method should be overriden.

Parameters:

c - The index of the component.

Returns:

The position of the fixed-point, which is the same as the number of fractional bits. For floating-point data 0 is returned.

getInternCompData

public final DataBlk getInternCompData(DataBlk blk,
                                       int c)

Returns a block of image data containing the specifed rectangular area, in the specified component, as a reference to the internal buffer (see below). The rectangular area is specified by the coordinates and dimensions of the 'blk' object.

The area to return is specified by the 'ulx', 'uly', 'w' and 'h' members of the 'blk' argument. These members are not modified by this method.

The data returned by this method can be the data in the internal buffer of this object, if any, and thus can not be modified by the caller. The 'offset' and 'scanw' of the returned data can be arbitrary. See the 'DataBlk' class.

The returned data has its 'progressive' attribute unset (i.e. false).

Parameters:

blk - Its coordinates and dimensions specify the area to return.

c - The index of the component from which to get the data.

Returns:

The requested DataBlk

See Also:

getInternCompData(ucar.jpeg.jj2000.j2k.image.DataBlk, int)

getCompData

public DataBlk getCompData(DataBlk blk,
                           int c)

Returns a block of image data containing the specifed rectangular area, in the specified component, as a copy (see below). The rectangular area is specified by the coordinates and dimensions of the 'blk' object.

The area to return is specified by the 'ulx', 'uly', 'w' and 'h' members of the 'blk' argument. These members are not modified by this method.

The data returned by this method is always a copy of the internal data of this object, if any, and it can be modified "in place" without any problems after being returned. The 'offset' of the returned data is 0, and the 'scanw' is the same as the block's width. See the 'DataBlk' class.

If the data array in 'blk' is null, then a new one is created. If the data array is not null then it must be big enough to contain the requested area.

The returned data always has its 'progressive' attribute unset (i.e false)

Parameters:

blk - Its coordinates and dimensions specify the area to return. If it contains a non-null data array, then it must be large enough. If it contains a null data array a new one is created. The fields in this object are modified to return the data.

c - The index of the component from which to get the data.

Returns:

The requested DataBlk

See Also:

getCompData(ucar.jpeg.jj2000.j2k.image.DataBlk, int)

getImplementationType

public int getImplementationType(int c)

Returns the implementation type of this wavelet transform, WT_IMPL_FULL (full-page based transform). All components return the same.

Parameters:

c - The index of the component.

Returns:

WT_IMPL_FULL

See Also:

WaveletTransform.WT_IMPL_FULL

setTile

public void setTile(int x,
                    int y)

Changes the current tile, given the new indexes. An IllegalArgumentException is thrown if the indexes do not correspond to a valid tile.

Specified by:

setTile in interface ImgData

Overrides:

setTile in class InvWTAdapter

Parameters:

x - The horizontal index of the tile.

y - The vertical index of the new tile.

nextTile

public void nextTile()

Advances to the next tile, in standard scan-line order (by rows then columns). An 'NoNextElementException' is thrown if the current tile is the last one (i.e. there is no next tile).

Specified by:

nextTile in interface ImgData

Overrides:

nextTile in class InvWTAdapter