kdu_codestream::restart

This function has a similar effect to destroying the existing code-stream management machinery (see destroy) and then creating another one with exactly the same set of coding parameter attributes. Its principle intent is for efficient re-use of the structures created for frame-by-frame video compression applications.

Note carefully, that this function may not be called unless enable_restart was called after the code-stream management machinery was originally created with the create function.

While the principle intent is that the original coding parameter attributes should be re-used, it is possible to access the parameter sub-system (see access_siz) and modify individual parameters. If any parameter values are changed, however, the value of recreation (from an efficiency point of view) will be lost. To detect changes in the coding parameters, this function relies on the kdu_params::clear_marks and kdu_params::any_changes functions.

If you wish to textualize parameter attributes for the new code-stream, you must call set_textualization after the present function returns. The textualization state is not preserved across multiple restarts.

Any code-stream comments generated using add_comment are discarded by this function.

target [kdu_compressed_target *]