Merge pull request #207 from Progi1984/issue192

#192 : Image Adapter

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_drawing
    shapes_media
    shapes_richtext
    shapes_table

docs/shapes.rst

@@ -31,16 +31,3 @@ Line
 ----
 
 To create a line, use `createLineShape` method of slide.
-
-
-Drawing
--------
-
-To create a drawing, use `createDrawingShape` method of slide.
-
-.. code-block:: php
-
-	$drawing = $slide->createDrawingShape();
-	$drawing->setName('Unique name')
-		->setDescription('Description of the drawing')
-		->setPath('/path/to/drawing.filename');

docs/shapes_drawing.rst

@@ -0,0 +1,75 @@
+.. _shapes_drawing:
+
+Drawing
+=======
+
+To create a drawing, you have four sources : File, GD, Base64 and ZipFile.
+
+File
+----
+
+To create a drawing, use `createDrawingShape` method of slide.
+
+.. code-block:: php
+
+	$oShape = $oSlide->createDrawingShape();
+	$oShape->setName('Unique name')
+		->setDescription('Description of the drawing')
+		->setPath('/path/to/drawing.filename');
+
+It's an alias for :
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Drawing\File;
+
+    $oShape = new File();
+	$oShape->setName('Unique name')
+		->setDescription('Description of the drawing')
+		->setPath('/path/to/drawing.filename');
+    $oSlide->addShape($oShape);
+
+GD
+--
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Drawing\Gd;
+
+    $gdImage = @imagecreatetruecolor($width, $height);
+
+    $oShape = new Gd();
+    $oShape->setName('Sample image')
+        ->setDescription('Sample image')
+        ->setImageResource($gdImage)
+        ->setRenderingFunction(Drawing\Gd::RENDERING_JPEG)
+        ->setMimeType(Drawing\Gd::MIMETYPE_DEFAULT);
+    $oSlide->addShape($oShape);
+
+
+Base64
+------
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Drawing\Base64;
+
+    $oShape = new Base64();
+    $oShape->setName('Sample image')
+        ->setDescription('Sample image')
+        ->setImageResource($gdImage)
+        ->setData('data:image/jpeg;base64,..........');
+    $oSlide->addShape($oShape);
+
+ZipFile
+-------
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Drawing\ZipFile;
+
+    $oShape = new ZipFile();
+    $oShape->setName('Sample image')
+        ->setDescription('Sample image')
+        ->setPath('zip://myzipfile.zip#path/in/zip/img.ext')
+    $oSlide->addShape($oShape);

docs/shapes_media.rst

@@ -12,7 +12,7 @@ Example:
     use PhpOffice\PhpPresentation\Shape\Media;
 
     $oMedia = new Media();
-    $oMedia->setPath('file.mp4');
+    $oMedia->setPath('file.wmv');
     // $oMedia->setPath('file.ogv');
     $oSlide->addShape($oMedia);
 
@@ -32,5 +32,5 @@ Example:
 Quirks
 ------
 
-For PowerPoint2007 Writer, the prefered file format is MP4.
-For ODPresentation Writer, the prefered file format is OGV.
+For Windows readers, the prefered file format is WMV.
+For Linux readers, the prefered file format is OGV.

samples/Sample_01_Simple.php

@@ -11,48 +11,48 @@
 $objPHPPresentation = new PhpPresentation();
 
 // Set properties
-echo date('H:i:s') . ' Set properties'.EOL;
-$objPHPPresentation->getProperties()->setCreator('PHPOffice')
-                                  ->setLastModifiedBy('PHPPresentation Team')
-                                  ->setTitle('Sample 01 Title')
-                                  ->setSubject('Sample 01 Subject')
-                                  ->setDescription('Sample 01 Description')
-                                  ->setKeywords('office 2007 openxml libreoffice odt php')
-                                  ->setCategory('Sample Category');
+echo date('H:i:s') . ' Set properties' . EOL;
+$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
+    ->setLastModifiedBy('PHPPresentation Team')
+    ->setTitle('Sample 01 Title')
+    ->setSubject('Sample 01 Subject')
+    ->setDescription('Sample 01 Description')
+    ->setKeywords('office 2007 openxml libreoffice odt php')
+    ->setCategory('Sample Category');
 
 // Create slide
-echo date('H:i:s') . ' Create slide'.EOL;
+echo date('H:i:s') . ' Create slide' . EOL;
 $currentSlide = $objPHPPresentation->getActiveSlide();
 
 // Create a shape (drawing)
-echo date('H:i:s') . ' Create a shape (drawing)'.EOL;
+echo date('H:i:s') . ' Create a shape (drawing)' . EOL;
 $shape = $currentSlide->createDrawingShape();
 $shape->setName('PHPPresentation logo')
-      ->setDescription('PHPPresentation logo')
-      ->setPath('./resources/phppowerpoint_logo.gif')
-      ->setHeight(36)
-      ->setOffsetX(10)
-      ->setOffsetY(10);
+    ->setDescription('PHPPresentation logo')
+    ->setPath('./resources/phppowerpoint_logo.gif')
+    ->setHeight(36)
+    ->setOffsetX(10)
+    ->setOffsetY(10);
 $shape->getShadow()->setVisible(true)
-                   ->setDirection(45)
-                   ->setDistance(10);
+    ->setDirection(45)
+    ->setDistance(10);
 $shape->getHyperlink()->setUrl('https://github.com/PHPOffice/PHPPresentation/')->setTooltip('PHPPresentation');
 
 // Create a shape (text)
-echo date('H:i:s') . ' Create a shape (rich text)'.EOL;
+echo date('H:i:s') . ' Create a shape (rich text)' . EOL;
 $shape = $currentSlide->createRichTextShape()
-      ->setHeight(300)
-      ->setWidth(600)
-      ->setOffsetX(170)
-      ->setOffsetY(180);
-$shape->getActiveParagraph()->getAlignment()->setHorizontal( Alignment::HORIZONTAL_CENTER );
+    ->setHeight(300)
+    ->setWidth(600)
+    ->setOffsetX(170)
+    ->setOffsetY(180);
+$shape->getActiveParagraph()->getAlignment()->setHorizontal(Alignment::HORIZONTAL_CENTER);
 $textRun = $shape->createTextRun('Thank you for using PHPPresentation!');
 $textRun->getFont()->setBold(true)
-                   ->setSize(60)
-                   ->setColor( new Color( 'FFE06B20' ) );
+    ->setSize(60)
+    ->setColor(new Color('FFE06B20'));
 
 // Save file
 echo write($objPHPPresentation, basename(__FILE__, '.php'), $writers);
 if (!CLI) {
-	include_once 'Sample_Footer.php';
+    include_once 'Sample_Footer.php';
 }

samples/Sample_03_Image.php

@@ -43,7 +43,7 @@
 $pageTitle .= 'PHPPresentation';
 $pageHeading = IS_INDEX ? '' : "<h1>{$pageHeading}</h1>";
 
-$oShapeDrawing = new Drawing();
+$oShapeDrawing = new Drawing\File();
 $oShapeDrawing->setName('PHPPresentation logo')
     ->setDescription('PHPPresentation logo')
     ->setPath('./resources/phppowerpoint_logo.gif')
@@ -241,14 +241,18 @@ protected function displayPhpPresentation(PhpPresentation $oPHPPpt)
 
     protected function displayShape(AbstractShape $shape)
     {
-        if($shape instanceof MemoryDrawing) {
-            $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "MemoryDrawing"</span></li>');
-        } elseif($shape instanceof Drawing) {
-            $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "Drawing"</span></li>');
+        if($shape instanceof Drawing\Gd) {
+            $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "Drawing\Gd"</span></li>');
+        } elseif($shape instanceof Drawing\File) {
+            $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "Drawing\File"</span></li>');
+        } elseif($shape instanceof Drawing\Base64) {
+            $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "Drawing\Base64"</span></li>');
+        } elseif($shape instanceof Drawing\Zip) {
+            $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "Drawing\Zip"</span></li>');
         } elseif($shape instanceof RichText) {
             $this->append('<li><span class="shape" id="div'.$shape->getHashCode().'">Shape "RichText"</span></li>');
         } else {
-            var_export($shape);
+            var_dump($shape);
         }
     }