jpx_codestream_target::access_stream

Returns a pointer to the same internal jp2_output_box object which will be returned by open_stream, but does not actually open any box. This function may be called at any time at all, enabling you to pass the returned interface to kdu_codestream::create before opening an output box. This can be quite important, since it allows you to use the created kdu_codestream object to initialize jp2_dimensions and even to start compressing the imagery before actually writing the JPX file header. Note, however, that you will have to call open_stream at some point before invoking kdu_codestream::flush.

Pointer to the internal jp2_output_box object, which is deliberately cast to the base of its derivation hierarchy ( kdu_compressed_target) so as to discourage you from using it for anything other than passing to kdu_codestream::create. Note that the returned object cannot be written to until after open_stream has been called, but this does not stop you from passing it to kdu_codestream::create.