kdu_codestream::get_timing_stats

If coder_only is false, the function returns the number of seconds since the last call to collect_timing_stats. If a block coder timing loop has been used to gather more accurate block coding statistics by running the block coder multiple times, the function estimates the number of seconds which would have been consumed if the block coder had been executed only once per code-block.

If coder_only is true, the function returns the number of seconds required to process all code-blocks. If the coder was invoked multiple times, the returned number of seconds is normalized to the time which would have been required by a single invocation of the coder. If the coding operation was not timed, the function returns 0.

If num_samples is non-NULL, it is used to return the number of samples associated with returned CPU time. If coder_only is true, this is the number of code-block samples. Otherwise, it is the number of samples in the current image region. In any event, dividing the returned time by the number of samples yields the most appropriate estimate of per-sample processing time.

num_samples [kdu_long *]

coder_only [bool]