Skip to content
This repository
Browse code

Adding common files describing the project.

Licensed under MS-Pl
  • Loading branch information...
commit c0e0f5408c07403a1552d187b796cb129ed4c16f 1 parent af8362f
Larry Olson authored January 17, 2011

Showing 2 changed files with 125 additions and 0 deletions. Show diff stats Hide diff stats

  1. 61  License.txt
  2. 64  ReadMe.txt
61  License.txt
... ...
@@ -0,0 +1,61 @@
  1
+MICROSOFT PUBLIC LICENSE (Ms-PL)
  2
+
  3
+This license governs use of the accompanying software. If you use the
  4
+software, you accept this license. If you do not accept the license, do
  5
+not use the software.
  6
+
  7
+1. Definitions
  8
+
  9
+The terms "reproduce," "reproduction," "derivative works," and
  10
+"distribution" have the same meaning here as under U.S. copyright law.
  11
+
  12
+A "contribution" is the original software, or any additions or changes
  13
+to the software.
  14
+
  15
+A "contributor" is any person that distributes its contribution under
  16
+this license. 
  17
+
  18
+"Licensed patents" are a contributor's patent claims that read directly
  19
+on its contribution. 
  20
+
  21
+2. Grant of Rights
  22
+
  23
+(A) Copyright Grant- Subject to the terms of this license, including the
  24
+license conditions and limitations in section 3, each contributor grants
  25
+you a non-exclusive, worldwide, royalty-free copyright license to
  26
+reproduce its contribution, prepare derivative works of its
  27
+contribution, and distribute its contribution or any derivative works
  28
+that you create.
  29
+
  30
+(B) Patent Grant- Subject to the terms of this license, including the
  31
+license conditions and limitations in section 3, each contributor grants
  32
+you a non-exclusive, worldwide, royalty-free license under its licensed
  33
+patents to make, have made, use, sell, offer for sale, import, and/or
  34
+otherwise dispose of its contribution in the software or derivative
  35
+works of the contribution in the software. 
  36
+
  37
+3. Conditions and Limitations
  38
+
  39
+(A) No Trademark License- This license does not grant you rights to use
  40
+any contributors' name, logo, or trademarks.
  41
+
  42
+(B) If you bring a patent claim against any contributor over patents
  43
+that you claim are infringed by the software, your patent license from
  44
+such contributor to the software ends automatically.
  45
+
  46
+(C) If you distribute any portion of the software, you must retain all
  47
+copyright, patent, trademark, and attribution notices that are present
  48
+in the software.
  49
+
  50
+(D) If you distribute any portion of the software in source code form,
  51
+you may do so only under this license by including a complete copy of
  52
+this license with your distribution. If you distribute any portion of
  53
+the software in compiled or object code form, you may only do so under a
  54
+license that complies with this license.
  55
+
  56
+(E) The software is licensed "as-is." You bear the risk of using it. The
  57
+contributors give no express warranties, guarantees or conditions. You
  58
+may have additional consumer rights under your local laws which this
  59
+license cannot change. To the extent permitted under your local laws,
  60
+the contributors exclude the implied warranties of merchantability,
  61
+fitness for a particular purpose and non-infringement. 
64  ReadMe.txt
... ...
@@ -0,0 +1,64 @@
  1
+# ManagedMediaHelpers #
  2
+
  3
+## Code Quick Start ##
  4
+
  5
+If you just want to get right into the code, check out these directories
  6
+
  7
+*    MediaParsers.Desktop
  8
+*    Mp3MediaStreamSource.SL4
  9
+
  10
+Otherwise, read on for a little more detail.
  11
+
  12
+## Overview ##
  13
+
  14
+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. 
  15
+
  16
+You may wonder -- why would anyone want to do this?
  17
+
  18
+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]
  19
+
  20
+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.
  21
+
  22
+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.
  23
+
  24
+## How is this project structured ##
  25
+
  26
+This solution consists of 9 projects with varying extensions.
  27
+
  28
+You can look at these from a platform centric POV . . . 
  29
+
  30
+*    __.Desktop__ builds against .NET Framework
  31
+*    __.Phone__ builds against Windows Phone 7
  32
+*    __.SL4__ builds against Silverlight
  33
+
  34
+. . . or a purpose centric POV.
  35
+
  36
+*    __Demo__ live apps for WP7 or Silverlight showing the MediaStreamSource in action
  37
+*    __Test__ test project for the MediaParsers
  38
+*    __MediaParsers__ Utility classes, common media classes, and mp3 specific data conversion
  39
+*    __Mp3MediaStreamSource__ The core class that handles reading a media stream and parsing it as Mp3 content
  40
+
  41
+## Tools used to create the project ##
  42
+*    [Visual Studio 2010]
  43
+*    [Style Cop]
  44
+*    [Windows Phone 7 Tools]
  45
+*    [git]
  46
+
  47
+## License ##
  48
+
  49
+This code is released under the Microsoft Public License (Ms-PL).  
  50
+See License.txt for a complete copy of the license.
  51
+
  52
+(c) Copyright 2008 Larry Olson 
  53
+
  54
+Changes to support duration and streaming (i.e. non-seekable) content  
  55
+(c) Copyright 2010 Rdio.
  56
+
  57
+[Visual Studio 2010]: http://msdn.microsoft.com/en-us/vstudio/default.aspx
  58
+[Style Cop]: http://stylecop.codeplex.com/
  59
+[Windows Phone 7 Tools]: http://create.msdn.com/en-us/home/getting_started
  60
+[Silverlight]: http://www.silverlight.net
  61
+[MediaStreamSource]: http://msdn.microsoft.com/en-us/library/system.windows.media.mediastreamsource(VS.95).aspx
  62
+[IIS]: http://www.iis.net/
  63
+[SmoothStreaming]: http://www.iis.net/download/SmoothStreaming
  64
+[git]: http://git-scm.com/

0 notes on commit c0e0f54

Please sign in to comment.
Something went wrong with that request. Please try again.