[Live-devel] New software release - changes "FramedSource" data passing convention

[Ross Finlayson]

A new version (2004.01.06) of the "LIVE.COM Streaming Media" source code 
has now been released.  Starting with this version, there has been an 
important change in the way that data is returned from a "FramedSource".

First, the "getPlayTime()" member function has been removed.  Subclasses of 
"FramedSource" need no longer provide an implementation of this function.

Second, the parameter signature of the 'after getting' function that is 
passed to "FramedSource::getNextFrame()" (and called when new data becomes 
available) has changed.  As you can see in 
"liveMedia/include/FramedSource.hh", this function now has two extra 
parameters:
1/ "numTruncatedBytes" - the number of bytes (if any) that were omitted due 
to the frame being too large (i.e., larger than the "maxSize" parameter 
that was passed to "getNextFrame"
2/ "durationInMicroseconds" - the duration (i.e., playing time) of this 
frame of data (if it's known).  This replaces the functionality of the old 
"getPlayTime()" command.

If you have developed your own subclass of "FramedSource", then it is 
likely that you will need to make some changes to your code to conform to 
the new calling convention.  For now, however, the old calling convention 
is still supported, for backwards compatibility.  Eventually, though, 
support for the old calling convention will be removed.  If you have your 
own subclass of "FramedSource", then I suggest that you test it - with the 
new calling convention - by commenting out the line
	#define BACKWARDS_COMPATIBLE_WITH_OLD_AFTER_GETTING_FUNC
in "liveMedia/include/FramedSource.hh", and recompiling.

Please upgrade to the new software release, and let us know should you see 
any problems.  (As always, support is provided for the newest version of 
the software only.)

	Ross Finlayson
	LIVE.COM
	<http://www.live.com/>