#123 : Support for Video (Documentation)

Author: Progi1984

docs/index.rst

@@ -34,6 +34,7 @@ PHPPresentation is a library written in pure PHP that provides a set of classes
 
    shapes_chart
    shapes_comment
+   shapes_media
    shapes_richtext
    shapes_table
 

docs/shapes.rst

@@ -27,25 +27,11 @@ Example:
 		->setOffsetX(170)
 		->setOffsetY(180);
 
-Rich text
----------
-
-The Rich text has :ref:`its own page <shapes_richtext>`.
-
 Line
 ----
 
 To create a line, use `createLineShape` method of slide.
 
-Chart
------
-
-The Chart has :ref:`its own page <shapes_chart>`.
-
-Comment
--------
-
-The Comment has :ref:`its own page <shapes_comment>`.
 
 Drawing
 -------
@@ -58,8 +44,3 @@ To create a drawing, use `createDrawingShape` method of slide.
 	$drawing->setName('Unique name')
 		->setDescription('Description of the drawing')
 		->setPath('/path/to/drawing.filename');
-		
-Table
------
-
-The Table has :ref:`its own page <shapes_table>`.

docs/shapes_media.rst

@@ -0,0 +1,36 @@
+.. _shapes_table:
+
+Media
+=====
+
+To create a video, create an object `Media`.
+
+Example:
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Media;
+
+    $oMedia = new Media();
+    $oMedia->setPath('file.mp4');
+    // $oMedia->setPath('file.ogv');
+    $oSlide->addShape($oMedia);
+
+You can define text and date with setters.
+
+Example:
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Media;
+
+    $oMedia = new Media();
+    $oMedia->setName('Name of the Media');
+    $oSlide->addShape($oMedia);
+
+
+Quirks
+------
+
+For PowerPoint2007 Writer, the prefered file format is MP4.
+For ODPresentation Writer, the prefered file format is OGV.