kdu_stripe_compressor

This object provides a high level interface to the Kakadu compression 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 compression applications upon this object.

It should be noted, however, that some performance benefits can be obtained by creating compression engines yourself and directly passing them 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 compression application based on this object, you will need to do the following:

• Create a kdu_codestream object;
• Use the interface recovered using kdu_codestream::access_siz to install any custom compression parameters you have in mind, unless you are happy with all the defaults;
• Initialize the kdu_stripe_compressor object, by calling kdu_stripe_compressor::start.
• Push image stripes into kdu_stripe_compressor::push_stripe until the image is fully compressed (you can do it all in one go, from a memory buffer of your choice, if you like);
• Call kdu_stripe_compressor::finish.
• 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_compress".

kdu_stripe_compressor {Java: Kdu_stripe_compressor}

~kdu_stripe_compressor {Java: Native_destroy}

start {Java: Start}

finish {Java: Finish}

get_recommended_stripe_heights {Java: Get_recommended_stripe_heights}

push_stripe (4 forms)