Permalink
Browse files

Adding common files describing the project.

Licensed under MS-Pl
  • Loading branch information...
loarabia committed Jan 18, 2011
1 parent af8362f commit c0e0f5408c07403a1552d187b796cb129ed4c16f
Showing with 125 additions and 0 deletions.
  1. +61 −0 License.txt
  2. +64 −0 ReadMe.txt
View
@@ -0,0 +1,61 @@
+MICROSOFT PUBLIC LICENSE (Ms-PL)
+
+This license governs use of the accompanying software. If you use the
+software, you accept this license. If you do not accept the license, do
+not use the software.
+
+1. Definitions
+
+The terms "reproduce," "reproduction," "derivative works," and
+"distribution" have the same meaning here as under U.S. copyright law.
+
+A "contribution" is the original software, or any additions or changes
+to the software.
+
+A "contributor" is any person that distributes its contribution under
+this license.
+
+"Licensed patents" are a contributor's patent claims that read directly
+on its contribution.
+
+2. Grant of Rights
+
+(A) Copyright Grant- Subject to the terms of this license, including the
+license conditions and limitations in section 3, each contributor grants
+you a non-exclusive, worldwide, royalty-free copyright license to
+reproduce its contribution, prepare derivative works of its
+contribution, and distribute its contribution or any derivative works
+that you create.
+
+(B) Patent Grant- Subject to the terms of this license, including the
+license conditions and limitations in section 3, each contributor grants
+you a non-exclusive, worldwide, royalty-free license under its licensed
+patents to make, have made, use, sell, offer for sale, import, and/or
+otherwise dispose of its contribution in the software or derivative
+works of the contribution in the software.
+
+3. Conditions and Limitations
+
+(A) No Trademark License- This license does not grant you rights to use
+any contributors' name, logo, or trademarks.
+
+(B) If you bring a patent claim against any contributor over patents
+that you claim are infringed by the software, your patent license from
+such contributor to the software ends automatically.
+
+(C) If you distribute any portion of the software, you must retain all
+copyright, patent, trademark, and attribution notices that are present
+in the software.
+
+(D) If you distribute any portion of the software in source code form,
+you may do so only under this license by including a complete copy of
+this license with your distribution. If you distribute any portion of
+the software in compiled or object code form, you may only do so under a
+license that complies with this license.
+
+(E) The software is licensed "as-is." You bear the risk of using it. The
+contributors give no express warranties, guarantees or conditions. You
+may have additional consumer rights under your local laws which this
+license cannot change. To the extent permitted under your local laws,
+the contributors exclude the implied warranties of merchantability,
+fitness for a particular purpose and non-infringement.
View
@@ -0,0 +1,64 @@
+# ManagedMediaHelpers #
+
+## Code Quick Start ##
+
+If you just want to get right into the code, check out these directories
+
+* MediaParsers.Desktop
+* Mp3MediaStreamSource.SL4
+
+Otherwise, read on for a little more detail.
+
+## Overview ##
+
+The ManagedMediaHelpers projects are a set of classes for working with and learning about [Silverlight]'s [MediaStreamSource] which allows media developers to ignore the media container and transport mechanism.
+
+You may wonder -- why would anyone want to do this?
+
+For one thing, having access to elementary streams means that developers can now implement scenarios that other solutions haven't necessarily provided thus far. One example of this is adaptive streaming or multi-bitrate support as was seen during the 2008 Olympics and which is available with [IIS]'s [SmoothStreaming]
+
+For another reason, having access to elementary streams allows developers to implement scenarios that the Silverlight runtime hasn't had a chance to implement yet or that the runtime might not be able to implement in the same timeframe that a developer wants it. Examples of this could be, RTSP:T protocol support, SHOUTcast protocol support, seamless audio looping, ID3 v1 and ID3 v2 metadata support, and many other scenarios.
+
+Finally, having access to an object which takes elementary data (video frames and audio samples) gives developers a chance to explore and learn about some of the upper layers of media technologies without worrying about setting up lots of underlying scaffolding and the headaches and context that can entail.
+
+## How is this project structured ##
+
+This solution consists of 9 projects with varying extensions.
+
+You can look at these from a platform centric POV . . .
+
+* __.Desktop__ builds against .NET Framework
+* __.Phone__ builds against Windows Phone 7
+* __.SL4__ builds against Silverlight
+
+. . . or a purpose centric POV.
+
+* __Demo__ live apps for WP7 or Silverlight showing the MediaStreamSource in action
+* __Test__ test project for the MediaParsers
+* __MediaParsers__ Utility classes, common media classes, and mp3 specific data conversion
+* __Mp3MediaStreamSource__ The core class that handles reading a media stream and parsing it as Mp3 content
+
+## Tools used to create the project ##
+* [Visual Studio 2010]
+* [Style Cop]
+* [Windows Phone 7 Tools]
+* [git]
+
+## License ##
+
+This code is released under the Microsoft Public License (Ms-PL).
+See License.txt for a complete copy of the license.
+
+(c) Copyright 2008 Larry Olson
+
+Changes to support duration and streaming (i.e. non-seekable) content
+(c) Copyright 2010 Rdio.
+
+[Visual Studio 2010]: http://msdn.microsoft.com/en-us/vstudio/default.aspx
+[Style Cop]: http://stylecop.codeplex.com/
+[Windows Phone 7 Tools]: http://create.msdn.com/en-us/home/getting_started
+[Silverlight]: http://www.silverlight.net
+[MediaStreamSource]: http://msdn.microsoft.com/en-us/library/system.windows.media.mediastreamsource(VS.95).aspx
+[IIS]: http://www.iis.net/
+[SmoothStreaming]: http://www.iis.net/download/SmoothStreaming
+[git]: http://git-scm.com/

0 comments on commit c0e0f54

Please sign in to comment.