[mythtv-firehose] mythtv/master commit: 031b9a4d5 by Mark Kendall (mark-kendall)

[MythTV]

      Author:  Mark Kendall <mkendall at mythtv.org>
 Change Date:  2011-06-03T00:23:54-07:00
   Push Date:  2011/06/03 00:24:07 -0700
  Repository:  mythtv
      Branch:  master
New Revision:  031b9a4d568fc2d2e480fbc9b1cb3ebf4dd5bef7
   Changeset:  https://github.com/MythTV/mythtv/commit/031b9a4d5

Log:

RingBuffer: Add bitrate monitoring code.

- enable monitoring with EnableBitrateMonitor(true)
- poll for data via GetDecoderRate, GetStorageRate, GetAvailableBuffer
- disable monitoring with EnableBitrateMonitor(false)

The decoder rate is the rate at which the decoder has requested data
from the buffer over the previous second. The storage rate is the
average rate at which data has been delivered to the buffer in the
previous second. The available buffer is the % of the buffer that is
available for the decoder.

N.B. the storage rate can be misleading. For dvd and bluray playback the
rate shown is the speed of retrieving data from the libdvdnav/libbluray
object - there is another ringbuffer layer that performs the actual
reads from local or remote storage. For network mounted drives and
http:/ streaming, there is additional buffering that may suggest that
read speeds are in excess of the actual network capabilities.

Modified:

   mythtv/libs/libmythtv/ringbuffer.cpp
   mythtv/libs/libmythtv/ringbuffer.h