public class Tiler extends ImgDataAdapter implements BlkImgDataSrc
All tiles produced are rectangular, non-overlapping and their union covers all the image. However, the tiling may not be uniform, depending on the nominal tile size, tiling origin, component subsampling and other factors. Therefore it might not be assumed that all tiles are of the same width and height.
The nominal dimension of the tiles is the maximal one, in the reference grid. All the components of the image have the same number of tiles.
ImgData
,
BlkImgDataSrc
Modifier and Type | Field and Description |
---|---|
private int[] |
compH
The component height in the current active tile, for each component
|
private int[] |
compW
The component width in the current active tile, for each component
|
private int |
ntX
The number of tiles in the horizontal direction.
|
private int |
ntY
The number of tiles in the vertical direction.
|
private BlkImgDataSrc |
src
The source of image data
|
private int[] |
tcx0
The horizontal coordinates of the upper-left corner of the components
in the current tile
|
private int[] |
tcy0
The vertical coordinates of the upper-left corner of the components in
the current tile.
|
private int |
tileH
The height of the current tile, on the reference grid.
|
private int |
tileW
The width of the current tile, on the reference grid.
|
private int |
tx
The horizontal index of the current tile
|
private int |
ty
The vertical index of the current tile
|
private int |
x0siz
Horizontal coordinate of the upper left hand reference grid point.
|
private int |
xt0siz
The horizontal coordinate of the tiling origin in the canvas system,
on the reference grid.
|
private int |
xtsiz
The nominal width of the tiles, on the reference grid.
|
private int |
y0siz
Vertical coordinate of the upper left hand reference grid point.
|
private int |
yt0siz
The vertical coordinate of the tiling origin in the canvas system, on
the reference grid.
|
private int |
ytsiz
The nominal height of the tiles, on the reference grid.
|
imgdatasrc, tIdx
Constructor and Description |
---|
Tiler(BlkImgDataSrc src,
int ax,
int ay,
int px,
int py,
int nw,
int nh)
Constructs a new tiler with the specified 'BlkImgDataSrc' source,
image origin, tiling origin and nominal tile size.
|
Modifier and Type | Method and Description |
---|---|
DataBlk |
getCompData(DataBlk blk,
int c)
Returns, in the blk argument, a block of image data containing the
specifed rectangular area, in the specified component.
|
int |
getCompULX(int c)
Returns the horizontal coordinate of the upper-left corner of the
specified component in the current tile.
|
int |
getCompULY(int c)
Returns the vertical coordinate of the upper-left corner of the
specified component in the current tile.
|
int |
getFixedPoint(int c)
Returns the position of the fixed point in the specified
component.
|
int |
getImgULX()
Returns the horizontal coordinate of the image origin, the top-left
corner, in the canvas system, on the reference grid.
|
int |
getImgULY()
Returns the vertical coordinate of the image origin, the top-left
corner, in the canvas system, on the reference grid.
|
DataBlk |
getInternCompData(DataBlk blk,
int c)
Returns, in the blk argument, a block of image data containing the
specifed rectangular area, in the specified component.
|
int |
getNomTileHeight()
Returns the nominal width of the tiles in the reference grid.
|
int |
getNomTileWidth()
Returns the nominal width of the tiles in the reference grid.
|
int |
getNumTiles()
Returns the total number of tiles in the image.
|
Point |
getNumTiles(Point co)
Returns the number of tiles in the horizontal and vertical directions.
|
Point |
getTile(Point co)
Returns the horizontal and vertical indexes of the current tile.
|
int |
getTileCompHeight(int t,
int c)
Returns the height in pixels of the specified tile-component.
|
int |
getTileCompWidth(int t,
int c)
Returns the width in pixels of the specified tile-component.
|
int |
getTileHeight()
Returns the overall height of the current tile in pixels.
|
int |
getTileIdx()
Returns the index of the current tile, relative to a standard scan-line
order.
|
int |
getTilePartULX()
Returns the horizontal tile partition offset in the reference grid
|
int |
getTilePartULY()
Returns the vertical tile partition offset in the reference grid
|
int |
getTileWidth()
Returns the overall width of the current tile in pixels.
|
Point |
getTilingOrigin(Point co)
Returns the tiling origin, referred to as '(xt0siz,yt0siz)' in the
codestream header (SIZ marker segment).
|
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 tile indexes.
|
String |
toString()
Returns a String object representing Tiler's informations
|
getCompImgHeight, getCompImgWidth, getCompSubsX, getCompSubsY, getImgHeight, getImgWidth, getNomRangeBits, getNumComps
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getCompImgHeight, getCompImgWidth, getCompSubsX, getCompSubsY, getImgHeight, getImgWidth, getNomRangeBits, getNumComps
private BlkImgDataSrc src
private int x0siz
private int y0siz
private int xt0siz
private int yt0siz
private int xtsiz
private int ytsiz
private int ntX
private int ntY
private int[] compW
private int[] compH
private int[] tcx0
private int[] tcy0
private int tx
private int ty
private int tileW
private int tileH
public Tiler(BlkImgDataSrc src, int ax, int ay, int px, int py, int nw, int nh)
src
- The 'BlkImgDataSrc' source from where to get the image
data. It must not be tiled and the image origin must be at '(0,0)' on
its canvas.ax
- The horizontal coordinate of the image origin in the canvas
system, on the reference grid (i.e. the image's top-left corner in the
reference grid).ay
- The vertical coordinate of the image origin in the canvas
system, on the reference grid (i.e. the image's top-left corner in the
reference grid).px
- The horizontal tiling origin, in the canvas system, on the
reference grid. It must satisfy 'px<=ax'.py
- The vertical tiling origin, in the canvas system, on the
reference grid. It must satisfy 'py<=ay'.nw
- The nominal tile width, on the reference grid. If 0 then
there is no tiling in that direction.nh
- The nominal tile height, on the reference grid. If 0 then
there is no tiling in that direction.IllegalArgumentException
- If src is tiled or "canvased", or
if the arguments do not satisfy the specified constraints.public final int getTileWidth()
getTileWidth
in interface ImgData
getTileWidth
in class ImgDataAdapter
public final int getTileHeight()
getTileHeight
in interface ImgData
getTileHeight
in class ImgDataAdapter
public final int getTileCompWidth(int t, int c)
getTileCompWidth
in interface ImgData
getTileCompWidth
in class ImgDataAdapter
t
- Tile indexc
- The index of the component, from 0 to N-1.public final int getTileCompHeight(int t, int c)
getTileCompHeight
in interface ImgData
getTileCompHeight
in class ImgDataAdapter
t
- The tile index.c
- The index of the component, from 0 to N-1.public int getFixedPoint(int c)
getFixedPoint
in interface BlkImgDataSrc
c
- The index of the component.public final DataBlk getInternCompData(DataBlk blk, int c)
The rectangular area to return is specified by the 'ulx', 'uly', 'w' and 'h' members of the 'blk' argument, relative to the current tile. These members are not modified by this method. The 'offset' and 'scanw' of the returned data can be arbitrary. See the 'DataBlk' class.
This method, in general, is more efficient than the 'getCompData()' method since it may not copy the data. However if the array of returned data is to be modified by the caller then the other method is probably preferable.
If the data array in blk is null, then a new one is created if necessary. The implementation of this interface may choose to return the same array or a new one, depending on what is more efficient. Therefore, the data array in blk prior to the method call should not be considered to contain the returned data, a new array may have been created. Instead, get the array from blk after the method has returned.
The returned data may have its 'progressive' attribute set. In this case the returned data is only an approximation of the "final" data.
getInternCompData
in interface BlkImgDataSrc
blk
- Its coordinates and dimensions specify the area to return,
relative to the current tile. Some fields in this object are modified
to return the data.c
- The index of the component from which to get the data.getCompData(jj2000.j2k.image.DataBlk, int)
public final DataBlk getCompData(DataBlk blk, int c)
The rectangular area to return is specified by the 'ulx', 'uly', 'w' and 'h' members of the 'blk' argument, relative to the current tile. These members are not modified by this method. The 'offset' of the returned data is 0, and the 'scanw' is the same as the block's width. See the 'DataBlk' class.
This method, in general, is less efficient than the 'getInternCompData()' method since, in general, it copies the data. However if the array of returned data is to be modified by the caller then this method is preferable.
If the data array in 'blk' is 'null', then a new one is created. If the data array is not 'null' then it is reused, and it must be large enough to contain the block's data. Otherwise an 'ArrayStoreException' or an 'IndexOutOfBoundsException' is thrown by the Java system.
The returned data may have its 'progressive' attribute set. In this case the returned data is only an approximation of the "final" data.
getCompData
in interface BlkImgDataSrc
blk
- Its coordinates and dimensions specify the area to return,
relative to the current tile. 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. Some fields in this object are modified to return the
data.c
- The index of the component from which to get the data.getInternCompData(jj2000.j2k.image.DataBlk, int)
public final void setTile(int x, int y)
setTile
in interface ImgData
setTile
in class ImgDataAdapter
x
- The horizontal index of the tile.y
- The vertical index of the new tile.public final void nextTile()
nextTile
in interface ImgData
nextTile
in class ImgDataAdapter
public final Point getTile(Point co)
getTile
in interface ImgData
getTile
in class ImgDataAdapter
co
- If not null this object is used to return the
information. If null a new one is created and returned.public final int getTileIdx()
getTileIdx
in interface ImgData
getTileIdx
in class ImgDataAdapter
public final int getCompULX(int c)
getCompULX
in interface ImgData
getCompULX
in class ImgDataAdapter
c
- The component index.public final int getCompULY(int c)
getCompULY
in interface ImgData
getCompULY
in class ImgDataAdapter
c
- The component index.public int getTilePartULX()
getTilePartULX
in interface ImgData
getTilePartULX
in class ImgDataAdapter
public int getTilePartULY()
getTilePartULY
in interface ImgData
getTilePartULY
in class ImgDataAdapter
public final int getImgULX()
getImgULX
in interface ImgData
getImgULX
in class ImgDataAdapter
public final int getImgULY()
getImgULY
in interface ImgData
getImgULY
in class ImgDataAdapter
public final Point getNumTiles(Point co)
getNumTiles
in interface ImgData
getNumTiles
in class ImgDataAdapter
co
- If not null this object is used to return the information. If
null a new one is created and returned.public final int getNumTiles()
getNumTiles
in interface ImgData
getNumTiles
in class ImgDataAdapter
public final int getNomTileWidth()
getNomTileWidth
in interface ImgData
getNomTileWidth
in class ImgDataAdapter
public final int getNomTileHeight()
getNomTileHeight
in interface ImgData
getNomTileHeight
in class ImgDataAdapter
public final Point getTilingOrigin(Point co)
co
- If not null this object is used to return the information. If
null a new one is created and returned.ImgData
Copyright © 2016 Open Microscopy Environment