kdu_codestream::restart

This function has a similar effect to destroying the existing code-stream management machinery (see destroy) and then creating another one. Its principle intent is for efficient re-use of the structures created for frame-by-frame video decompression 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 second form of the create function.

All code-stream marker segments are read from the source object, exactly as for the second form of the create function. If the coding parameters are exactly the same as they were in the existing object, a great deal of the internal machinery can be left intact, saving significant computational effort, especially when working with small video frame sizes. Otherwise, the function essentially destroys the existing code-stream machinery and rebuilds it from scratch. 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.

source [kdu_compressed_source *]