kdu_codestream::destroy

Providing an explicit destructor for kdu_codestream is dangerous, since it is merely a container for a hidden reference to the internal code-stream mangement machinery. The interpretation of copying should be (and is) that of generating another reference, so the underlying object should not be destroyed when the copy goes out of scope. Reference counting would be an elegant, though tedious and less explicit way of avoiding this difficulty.

Destroys the internal code-stream management machinery, along with all tiles, tile-components and other subordinate state information for which interfaces are described in this header.