kdu_compressed_target::set_target_size

This function may be called by the rate allocator at any point, to indicate the total size of the code-stream currently being generated, including all marker codes. The function may be called after some or all of the code-stream bytes have been delivered to the write member function; in fact, it may never be called at all. The kdu_codestream object's rate allocation procedure (e.g., kdu_codestream::flush) should attempt to identify the code-stream size as soon as it can, but this might not always be possible. If the target requires knowledge of the size before writing the data, it may need to buffer the code-stream data until this function has been called or the object is destroyed.

num_bytes [kdu_long]