The IDLffJPEG2000::GetTileProperty procedure method returns information describing the properties of a tile in an IDLffJPEG2000 object in the supplied variable-keyword pairs. The object must be open for reading. An error is produced if the object is open for writing.
Syntax
Obj->[IDLffJPEG2000::]GetTileProperty [, TileIndex [, TileComponent]], [, N_LAYERS=variable] [, N_LEVELS=variable] [, PROGRESSION=variable] [, REVERSIBLE=variable] [, TILE_DIMENSIONS=variable] [, TILE_OFFSET=variable] [, YCC=variable]
Arguments
TileIndex
This argument specifies the index of the tile whose attributes are to be returned. JPEG2000 tiles are numbered in raster scan fashion, starting from 0 and going up to a maximum of 65535. The default value for this argument is 0.
TileComponent
This argument specifies the component index of the tile whose attributes are to be queried. Indices range from 0 to N_COMPONENTS-1. The default value for this argument is 0.
Keywords
N_LAYERS
Set this keyword to a named variable in which to return the number of quality layers available for the tile. If this keyword is set, the TileComponent argument is ignored.
N_LEVELS
Set this keyword to a named variable in which to return the total number of available resolution levels for this tile component.
PROGRESSION
Set this keyword to a named variable in which to return a string containing the progression order for that tile. The returned value will be one of: LRCP, RLCP, RPCL, PCRL, CPRL.
See PROGRESSION under Properties for the definition of these values.
REVERSIBLE
Set this keyword to a named variable in which to return 1 if the tile-component is compressed reversibly, 0 if irreversible.
TILE_DIMENSIONS
Set this keyword to a named variable in which to return a two-element vector containing the width and height of the tile, taking into account any clipping of the tile to the image.
TILE_OFFSET
Set this keyword to a named variable in which to return a two-element vector containing the horizontal and vertical offset of the tile, taking into account any clipping of the tile to the image.
YCC
Set this keyword to a named variable in which to return 1 if a component color transform was used for the first 3 components of the tile specified by the TileIndex argument, 0 otherwise.
Version History