J2K-Codec ™

News
Overview
Download
Order
F.A.Q.
More info
Support
Links

Welcome
QuickStart

ActiveX Control

C++ Wrapper
J2K_Image
open
easyDecode
selectTiles
getMetaData
decode
close
J2K_Frames
open
getFrames
getFrame
operators
close

API Reference
General
getVersion
getLastError
getErrorStr
getLastErrorStr
Unlock
Open / Close
Open
Close
Info
GetInfo
GetInfoEx
GetResolutions
GetResDimensions
GetMetaData
Decoding
EasyDecode
SelectTiles
Decode
Cancel
Debug
StartLogging
StopLogging


J2K_Image::selectTiles


You need to use this function only if you want to decode a particular tile (or a tile range) from the image.

int selectTiles(int start_tile, int end_tile, int action);


Parameters

start_tile
Start tile number of selection range.

end_tile
End tile number of selection range (inclusive).

action
Action to do: 1 - select, 0 - unselect (remove from processing).

Return value

Returns J2KERR_SUCCESS or an error code if the function has failed. See the list of error codes here.

Notes

1. By default (if this function is not used) all tiles are selected.

2. Tiles are numbered starting from 0 in the raster order (i.e. first - by X axis and then by Y).

3. If end_tile == -1 then the max tile number will be used instead.

4. If end_tile < start_tile they will be swapped.

Example

J2K_Image image;

int j2k_err = image.open("test.j2k");

if(j2k_err != J2KERR_SUCCESS){ printf("\n J2K-Codec error: %s.\n", image.errStr); return -1; }

image.selectTiles(0, -1, 0); // Unselect all tiles

image.selectTiles(2, 2, 1); // Select the third tile only

// Work with selected tiles
...

See also

J2K_Image::open()
2004-2008 © Alex Saveliev