kdu_codestream::collect_timing_stats

Modifies the behaviour of kdu_block_encoder or kdu_block_decoder, if used, to collect timing statistics which may later be retrieved using the get_timing_stats function.

If num_coder_iterations is non-zero, the block encoder or decoder will be asked to time itself (it need not necessarily comply) by processing each block num_coder_iterations times. If it does so, block coder throughput statistics will also be reported. If num_coder_iterations is 0, end-to-end times are generally very reliable. Otherwise, the numerous calls to the internal clock function required to time block coding operations may lead to some inaccuracies. The larger the value of num_coder_iterations, the more reliable block coding times are likely to be, since the coder is executed multiple times between calls to clock. On the other hand, the end-to-end execution time needs to be corrected to account for multiple invocations of the block coder, and this correction can introduce substantial inaccuracies.

num_coder_iterations [int]