jp2_source

Provides full support for interacting with JP2 files. You may wish to use the jpx_source, since it is able to handle both JP2 files and the much more general JPX files in a consistent manner. Note that the present object has changed in two important ways since Kakadu v3.4.

• The JP2 source must now be opened indirectly by first opening a jp2_family_src object and then passing it to the open function. You must then call the read_header member to complete the process of opening the JP2 source, reading its header and preparing to read from the embedded contiguous code-stream.
• Whereas this object used to be an interface to an hidden internal object, so that copying the interface served simply to duplicate the reference to the internal object, this is no longer the case. Assigning one jp2_source object to another is now strictly prohibited, and you should pass only references to such objects around inside your application. This is unlikely to impact many applications.

An important benefit of the changes described above is that it is possible to pass the same jp2_family_src object to multiple jp2_input_box or jp2_input_box-derived objects, so that the JP2 source can be examined in a variety of different ways. In some cases, multiple code-streams may be available from a single source, and each of these can be opened and passed to kdu_codestream::create now. A second benefit, is that the read_header method can be used with caching data sources whose cache entries evolve over time; it may be called multiple times, until sufficient information is available to deduce all relevant header information.

jp2_source (2 forms) {Java: Jp2_source}

~jp2_source [virtual] {Java: Native_destroy}

operator=

open [virtual] {Java: Open}

read_header {Java: Read_header}

get_header_bytes {Java: Get_header_bytes}

access_dimensions {Java: Access_dimensions}

access_palette {Java: Access_palette}

access_channels {Java: Access_channels}

access_colour {Java: Access_colour}

access_resolution {Java: Access_resolution}