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_Frames class


It is usual practice for game developers to store animation frames as tiles in a single large image.
For example, see the following picture:

Explosion frames in a single image

This class helps to handle such images and represent them as a collection of frames.

To use it, you'll need to create a tiled JPEG2000 image (with or without alpha-channel), which holds each frame in a corresponding tile.

J2K_Frames class will load such image and convert all tiles into frames. Each frame has the following format:

FieldSizeDescription
Width 4 Width of the frame
Height 4 Height of the frame
isAlpha 4 Alpha presence flag (1 - alpha channel is present)
Pixels ... Width × Height pixels (4 bytes each)

See "f_Alpha" sample where this class is actually used.

Members:

errStr const char * Error description string. Will be set in case of an error.


Methods:

J2K_Frames::open()

J2K_Frames::getFrames()

J2K_Frames::getFrame()

J2K_Frames operators

J2K_Frames::close()


Notes

Don't forget to use tiled JPEG2000 images for this class to work. Simply combining all your frames into a single image is not enough. You must save it with tiles, equal in size to the frames.
2004-2008 © Alex Saveliev