kdu_codestream::set_textualization

Supplies an output messaging object to which code-stream parameters will be textualized as they become available. Main header parameters are written immediately, while tile-specific parameters are written at the point when the tile is destroyed. This function is legal only when invoked prior to the first tile access.

Note that the specification of regions of interest without persistence (see apply_input_restrictions and set_persistent) may prevent some tiles from actually being read — if these contain tile-specific parameters, they may not be textualized.

If restart is used to restart the code-stream management machinery, you must call the present function again to re-enable textualization after each restart call.

output [kdu_message *]