jp2_target

Provides full support for generating or copying JP2 files. After calling jp2_target::open, you may pass the object directly to kdu_codestream::create. Note, however, that you should not invoke kdu_codestream::flush until after you have called write_header and open_codestream. In general, the sequence of operations used to generate a JP2 file is as follows:

• Create and open a jp2_family_tgt object.
• Pass this object to jp2_target::open (not the base object's jp2_output_box::open function).
• Pass the open jp2_target object into kdu_codestream::create
• Configure header attributes by using the present object's access functions and initializing the various attributes ( jp2_dimensions, jp2_colour, jp2_channels, etc.) as appropriate.
• Call write_header to write the JP2 header.
• Optionally write additional boxes, opening them using the base object's jp2_output_box::open_next function, writing their contents (or sub-boxes) and closing them using jp2_output_box::close.
• Call open_codestream prior to any call to kdu_codestream::flush.
• Call the base object's jp2_output_box::close function.
• Optionally write additional boxes or code-streams by using jp2_output_box::open_next and/or open_codestream, closing the relevant boxes once you are done with them.
• Call jp2_family_tgt::close when you are completely finished.

Note that objects of this class are no longer merely interfaces to an internal implementation object. For this reason, it is now illegal to directly assign a jp2_target object to another jp2_target object.

Also note that the base object's jp2_output_box::close function does not close the file (or other target device). It simply closes the currently open output box. To close the file, you need to call jp2_family_tgt::close.

From Kakadu Version 4.1 the new jpx_target object is available for creating instances of the much more general JPX file format. You may wish to create JP2 compatible JPX files rather than just JP2 files.

jp2_target (2 forms) {Java: Jp2_target}

~jp2_target [virtual] {Java: Native_destroy}

operator=

open [virtual] {Java: Open}

write_header {Java: Write_header}

open_codestream {Java: Open_codestream}

access_dimensions {Java: Access_dimensions}

access_colour {Java: Access_colour}

access_palette {Java: Access_palette}

access_channels {Java: Access_channels}

access_resolution {Java: Access_resolution}