Add support for ASF

git-svn-id: http://php-reader.googlecode.com/svn/trunk@4 51a70ab9-7547-0410-9469-37e369ee0574
2008-03-03 11:48:28 +00:00
parent 16dd117216
commit 906e2dc59d
6 changed files with 817 additions and 0 deletions
--- a/src/ASF.php
+++ b/src/ASF.php
@@ -0,0 +1,119 @@
+<?php
+/**
+ * $Id$
+ *
+ *
+ * Copyright (C) 2006, 2007 The Bearpaw Project Work Group. All Rights Reserved.
+ * Copyright (C) 2007, 2008 BEHR Software Systems. All Rights Reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ *  - Redistributions of source code must retain the above copyright notice,
+ *    this list of conditions and the following disclaimer.
+ *  - Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the documentation
+ *    and/or other materials provided with the distribution.
+ *  - Neither the name of the BEHR Software Systems nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @package   php-reader
+ */
+
+/**#@+ @ignore */
+require_once("Reader.php");
+require_once("ASF/Object.php");
+require_once("ASF/HeaderObject.php");
+require_once("ASF/ContentDescriptionObject.php");
+require_once("ASF/ExtendedContentDescriptionObject.php");
+require_once("ASF/FilePropertiesObject.php");
+/**#@-*/
+
+/**
+ * This class represents a file in Advanced Systems Format (ASF) as described in
+ * {@link http://go.microsoft.com/fwlink/?LinkId=31334 The Advanced Systems
+ * Format (ASF) Specification}. It is a file format that can contain various
+ * types of information ranging from audio and video to script commands and
+ * developer defined custom streams.
+ *
+ * This is hardly a full implementation of a ASF reader but provides you with
+ * the ability to read metadata out of an ASF based file (WMA, WMV, etc).
+ * 
+ * The ASF file consists of code blocks that are called content objects. Each
+ * of these objects have a format of their own. They may contain other objects
+ * or other specific data. Each supported object has been implemented as their
+ * own classes to ease the correct use of the information.
+ * 
+ * @package   php-reader
+ * @author    Sven Vollbehr <sven.vollbehr@behrss.eu>
+ * @copyright 2006, 2007 The Bearpaw Project Work Group
+ * @copyright 2007, 2008 BEHR Software Systems
+ * @license   http://www.opensource.org/licenses/bsd-license.php New BSD License
+ * @version   $Rev$
+ */
+class ASF
+{
+  /** @var Reader The Reader object */
+  private $_reader;
+  
+  /**
+   * The default constructor. Initiates the reader for the given file.
+   */
+  public function __construct($filename)
+  {
+    $this->_reader = new Reader($filename);
+  }
+  
+  /**
+   * Checks whether the reader was successfully initiated and whether there are
+   * objects left in the stream.
+   * 
+   * @return  Boolean value corresponding whether there is more to read.
+   */
+  public function hasObjects()
+  {
+    return $this->_reader->available();
+  }
+  
+  /**
+   * Returns the next ASF object or false if end of stream has been reached.
+   * 
+   * @todo   Only the ASF_Header_Object top level object is regognized. 
+   * @return ASFObject Returns the appropriate object. Returned objects are of
+   *         the type ASFObject or of any of the other object types that inherit
+   *         from that base class.
+   */
+  public function nextObject()
+  {
+    $object = false;
+    if ($this->hasObjects()) {
+      $guid = $this->_reader->getGUID();
+      $size = $this->_reader->getInt64LE();
+      $offset = $this->_reader->getOffset();
+
+      switch ($guid) {
+      case "75b22630-668e-11cf-a6d9-00aa0062ce6c": /* ASF_Header_Object */
+        $object = new ASF_HeaderObject($this->_reader, $guid, $size);
+        break;
+      default:
+        $object = new ASF_Object($this->_reader, $guid, $size);
+      }
+
+      $this->_reader->setOffset($offset - 24 + $size);
+    }
+    return $object;
+  }
+}