C# Class CSJ2K.j2k.wavelet.synthesis.InvWTFull

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.

Inheritance: InverseWT
Afficher le fichier Open project: cureos/csj2k

Méthodes publiques

Méthode Description
InvWTFull ( CBlkWTDataSrcDec src, DecoderSpecs decSpec ) : System

Initializes this object with the given source of wavelet coefficients. It initializes the resolution level for full resolutioin reconstruction.
getCompData ( CSJ2K.j2k.image.DataBlk blk, int c ) : CSJ2K.j2k.image.DataBlk

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)
getFixedPoint ( int c ) : int

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.
getImplementationType ( int c ) : int

Returns the implementation type of this wavelet transform, WT_IMPL_FULL (full-page based transform). All components return the same.
getInternCompData ( CSJ2K.j2k.image.DataBlk blk, int c ) : CSJ2K.j2k.image.DataBlk

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).
getNomRangeBits ( int c ) : int

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.
isReversible ( int t, int c ) : bool

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.
nextTile ( ) : void

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).
setTile ( int x, int y ) : void

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

Private Methods

Méthode Description
isSubbandReversible ( Subband subband ) : bool

Returns the reversibility of the current subband. It computes iteratively the reversibility of the child subbands. For each subband it tests the reversibility of the horizontal and vertical synthesis filters used to reconstruct this subband.
wavelet2DReconstruction ( CSJ2K.j2k.image.DataBlk db, CSJ2K.j2k.wavelet.synthesis.SubbandSyn sb, int c ) : void

Performs the 2D inverse wavelet transform on a subband of the image, on the specified component. This method will successively perform 1D filtering steps on all columns and then all lines of the subband.
waveletTreeReconstruction ( CSJ2K.j2k.image.DataBlk img, CSJ2K.j2k.wavelet.synthesis.SubbandSyn sb, int c ) : void

Performs the inverse wavelet transform on the whole component. It iteratively reconstructs the subbands from leaves up to the root node. This method is recursive, the first call to it the 'sb' must be the root of the subband tree. The method will then process the entire subband tree by calling itslef recursively.

Method Details

InvWTFull() public méthode

Initializes this object with the given source of wavelet coefficients. It initializes the resolution level for full resolutioin reconstruction.
public InvWTFull ( CBlkWTDataSrcDec src, DecoderSpecs decSpec ) : System
src CBlkWTDataSrcDec from where the wavelet coefficinets should be obtained. /// ///
decSpec CSJ2K.j2k.decoder.DecoderSpecs The decoder specifications /// ///
Résultat System

getCompData() public méthode

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)

public getCompData ( CSJ2K.j2k.image.DataBlk blk, int c ) : CSJ2K.j2k.image.DataBlk
blk CSJ2K.j2k.image.DataBlk 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 int The index of the component from which to get the data. /// ///
Résultat CSJ2K.j2k.image.DataBlk

getFixedPoint() public méthode

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.

public getFixedPoint ( int c ) : int
c int The index of the component. /// ///
Résultat int

getImplementationType() public méthode

Returns the implementation type of this wavelet transform, WT_IMPL_FULL (full-page based transform). All components return the same.
public getImplementationType ( int c ) : int
c int The index of the component. /// ///
Résultat int

getInternCompData() public méthode

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).

public getInternCompData ( CSJ2K.j2k.image.DataBlk blk, int c ) : CSJ2K.j2k.image.DataBlk
blk CSJ2K.j2k.image.DataBlk Its coordinates and dimensions specify the area to return. /// ///
c int The index of the component from which to get the data. /// ///
Résultat CSJ2K.j2k.image.DataBlk

getNomRangeBits() public méthode

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.

public getNomRangeBits ( int c ) : int
c int The index of the component. /// ///
Résultat int

isReversible() public méthode

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.
public isReversible ( int t, int c ) : bool
t int The index of the tile. /// ///
c int The index of the component. /// ///
Résultat bool

nextTile() public méthode

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).
public nextTile ( ) : void
Résultat void

setTile() public méthode

Changes the current tile, given the new indexes. An IllegalArgumentException is thrown if the indexes do not correspond to a valid tile.
public setTile ( int x, int y ) : void
x int The horizontal index of the tile. /// ///
y int The vertical index of the new tile. /// ///
Résultat void