MultiResImgData Interface

This interface defines methods to access image attributes (width, height, number of components, etc.) of multiresolution images, such as those resulting from an inverse wavelet transform. The image can be tiled or not (i.e. if the image is not tiled then there is only 1 tile). It should be implemented by all classes that provide multi-resolution image data, such as entropy decoders, dequantizers, etc. This interface, however, does not define methods to transfer image data (i.e. pixel data), that is defined by other interfaces, such as 'CBlkQuantDataSrcDec'.

       <p>This interface is very similar to the 'ImgData' one. It differs only by
       the fact that it handles multiple resolutions.</p>

       <p>Resolution levels are counted from 0 to L. Resolution level 0 is the
       lower resolution, while L is the maximum resolution level, or full
       resolution, which is returned by 'getMaxResLvl()'. Note that there are L+1
       resolution levels available.</p>

       <p>As in the 'ImgData' interface a multi-resolution image lies on top of a
       canvas. The canvas coordinates are mapped from the full resolution
       reference grid (i.e. resolution level 'L' reference grid) to a resolution
       level 'l' reference grid by '(x_l,y_l) =
       (ceil(x_l/2^(L-l)),ceil(y_l/2^(L-l)))', where '(x,y)' are the full
       resolution reference grid coordinates and '(x_l,y_l)' are the level 'l'
       reference grid coordinates.</p>

       <p>For details on the canvas system and its implications consult the
       'ImgData' interface.</p>

       <p>Note that tile sizes may not be obtained by simply dividing the tile
       size in the reference grid by the subsampling factor.</p>

Namespace: CSJ2K.j2k.wavelet.synthesis

Assembly: C1.C1Pdf.4.8.dll

Syntax

public interface MultiResImgData

Public Interface MultiResImgData

Properties

Name	Description
NomTileHeight	Returns the nominal tiles height
NomTileWidth	Returns the nominal tiles width
NumComps	Returns the number of components in the image.
TileIdx	Returns the index of the current tile, relative to a standard scan-line order.
TilePartULX	Returns the horizontal tile partition offset in the reference grid
TilePartULY	Returns the vertical tile partition offset in the reference grid

Methods

Name	Description
getCompImgHeight(int, int)	Returns the height in pixels of the specified component in the overall image, for the given resolution level.
getCompImgWidth(int, int)	Returns the width in pixels of the specified component in the overall image, for the given resolution level.
getCompSubsX(int)	Returns the component subsampling factor in the horizontal direction, for the specified component. This is, approximately, the ratio of dimensions between the reference grid and the component itself, see the 'ImgData' interface desription for details.
getCompSubsY(int)	Returns the component subsampling factor in the vertical direction, for the specified component. This is, approximately, the ratio of dimensions between the reference grid and the component itself, see the 'ImgData' interface desription for details.
getImgHeight(int)	Returns the overall height of the image in pixels, for the given resolution level. This is the image's height without accounting for any component subsampling or tiling. The resolution level is indexed from the lowest number of resolution levels of all components of the current tile.
getImgULX(int)	Returns the horizontal coordinate of the image origin, the top-left corner, in the canvas system, on the reference grid at the specified resolution level. The resolution level is indexed from the lowest number of resolution levels of all components of the current tile.
getImgULY(int)	Returns the vertical coordinate of the image origin, the top-left corner, in the canvas system, on the reference grid at the specified resolution level. The resolution level is indexed from the lowest number of resolution levels of all components of the current tile.
getImgWidth(int)	Returns the overall width of the image in pixels, for the given resolution level. This is the image's width without accounting for any component subsampling or tiling. The resolution level is indexed from the lowest number of resolution levels of all components of the current tile.
getNumTiles()	Returns the total number of tiles in the image.
getNumTiles(Coord)	Returns the number of tiles in the horizontal and vertical directions.
getResULX(int, int)	Returns the horizontal coordinate of the upper-left corner of the specified resolution in the given component of the current tile.
getResULY(int, int)	Returns the vertical coordinate of the upper-left corner of the specified resolution in the given component of the current tile.
getSynSubbandTree(int, int)	Returns the specified synthesis subband tree
getTile(Coord)	Returns the indexes of the current tile. These are the horizontal and vertical indexes of the current tile.
getTileCompHeight(int, int, int)	Returns the height in pixels of the specified tile-component for the given resolution level.
getTileCompWidth(int, int, int)	Returns the width in pixels of the specified tile-component for the given resolution level.
getTileHeight(int)	Returns the overall height of the current tile in pixels, for the given resolution level. This is the tile's height without accounting for any component subsampling. The resolution level is indexed from the lowest number of resolution levels of all components of the current tile.
getTileWidth(int)	Returns the overall width of the current tile in pixels for the given resolution level. This is the tile's width without accounting for any component subsampling. The resolution level is indexed from the lowest number of resolution levels of all components of the current tile.
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).
setTile(int, int)	Changes the current tile, given the new indexes. An IllegalArgumentException is thrown if the indexes do not correspond to a valid tile.