kdu_stripe_decompressor

This object provides a high level interface to the Kakadu decompression machinery, which is capable of satisfying the needs of most developers while providing essentially a one-function-call solution for simple applications. Most new developers will probably wish to base their decompression applications either upon this object, or the kdu_region_decompressor object.

It should be noted, however, that some performance benefits can be obtained by creating decompression engines yourself and directly recovering kdu_line_buf lines, since this can often avoid unnecessary copying and level shifting of image samples. Nevertheless, there has been a lot of demand for a dead-simple, yet also powerful interface to Kakadu, and this object is intended to fill that requirement. In fact, the various objects found in the "support" directory ( kdu_stripe_compressor, kdu_stripe_decompressor and kdu_region_decompressor) are aimed at meeting the needs of 90% of the applications using Kakadu. That is not to say that these objects are all that is required. You still need to open streams of one form or another and create a kdu_codestream interface.

In a typical decompression application based on this object, you will need to do the following:

• Create a kdu_codestream object;
• Initialize the kdu_stripe_decompressor object, by calling kdu_stripe_decompressor::start.
• Pull image stripes from kdu_stripe_decompressor::pull_stripe until the image is fully decompressed (you can do it all in one go, into a memory buffer of your choice, if you like);
• Call kdu_stripe_decompressor::finish (not strictly necessary).
• Call kdu_codestream::destroy.

For a tuturial example of how to use the present object in a typical application, consult the Kakadu demo application, "kdu_buffered_decompress".

kdu_stripe_decompressor {Java: Kdu_stripe_decompressor}

~kdu_stripe_decompressor {Java: Native_destroy}

start {Java: Start}

finish {Java: Finish}

get_recommended_stripe_heights {Java: Get_recommended_stripe_heights}

pull_stripe (4 forms)