Font: New scale, spacing, and kerning property of font style

Author: ivanlanin

CHANGELOG.md

@@ -7,6 +7,7 @@ This is the changelog between releases of PHPWord. Releases are listed in revers
 ### Features
 
 - Element: Ability to add drawing shapes (arc, curve, line, polyline, rect, oval) using new `Shape` element - @ivanlanin GH-123
+- Font: New `scale`, `spacing`, and `kerning` property of font style - @ivanlanin
 
 ### Bugfixes
 

samples/Sample_01_SimpleText.php

@@ -23,22 +23,43 @@
 $section->addText('I am styled by a paragraph style definition.', null, 'pStyle');
 $section->addText('I am styled by both font and paragraph style.', 'rStyle', 'pStyle');
 
-$section->addPageBreak();
+$section->addTextBreak();
 
 // Inline font style
 $fontStyle['name'] = 'Times New Roman';
 $fontStyle['size'] = 20;
-$fontStyle['bold'] = true;
-$fontStyle['italic'] = true;
-$fontStyle['underline'] = 'dash';
-$fontStyle['strikethrough'] = true;
-$fontStyle['superScript'] = true;
-$fontStyle['color'] = 'FF0000';
-$fontStyle['fgColor'] = 'yellow';
-$fontStyle['smallCaps'] = true;
-$section->addText('I am inline styled.', $fontStyle);
 
-$section->addTextBreak();
+$textrun = $section->addTextRun();
+$textrun->addText('I am inline styled ', $fontStyle);
+$textrun->addText('with ');
+$textrun->addText('color', array('color' => '996699'));
+$textrun->addText(', ');
+$textrun->addText('bold', array('bold' => true));
+$textrun->addText(', ');
+$textrun->addText('italic', array('italic' => true));
+$textrun->addText(', ');
+$textrun->addText('underline', array('underline' => 'dash'));
+$textrun->addText(', ');
+$textrun->addText('strikethrough', array('strikethrough' => true));
+$textrun->addText(', ');
+$textrun->addText('doubleStrikethrough', array('doubleStrikethrough' => true));
+$textrun->addText(', ');
+$textrun->addText('superScript', array('superScript' => true));
+$textrun->addText(', ');
+$textrun->addText('subScript', array('subScript' => true));
+$textrun->addText(', ');
+$textrun->addText('smallCaps', array('smallCaps' => true));
+$textrun->addText(', ');
+$textrun->addText('allCaps', array('allCaps' => true));
+$textrun->addText(', ');
+$textrun->addText('fgColor', array('fgColor' => 'yellow'));
+$textrun->addText(', ');
+$textrun->addText('scale', array('scale' => 200));
+$textrun->addText(', ');
+$textrun->addText('spacing', array('spacing' => 120));
+$textrun->addText(', ');
+$textrun->addText('kerning', array('kerning' => 10));
+$textrun->addText('. ');
 
 // Link
 $section->addLink('http://www.google.com', 'Google');

src/PhpWord/IOFactory.php

@@ -75,6 +75,7 @@ private static function createObject($type, $name, $phpWord = null)
      */
     public static function load($filename, $readerName = 'Word2007')
     {
+        /** @var \PhpOffice\PhpWord\Reader\ReaderInterface $reader */
         $reader = self::createReader($readerName);
 
         return $reader->load($filename);

src/PhpWord/Style/AbstractStyle.php

@@ -126,6 +126,24 @@ public function setAuto($value = true)
         return $this;
     }
 
+    /**
+     * Return style value of child style object, e.g. `left` from `Indentation` child style of `Paragraph`
+     *
+     * @param \PhpOffice\PhpWord\Style\AbstractStyle $substyleObject
+     * @param string $substyleProperty
+     * @return mixed
+     * @since 0.12.0
+     */
+    public function getChildStyleValue($substyleObject, $substyleProperty)
+    {
+        if ($substyleObject !== null) {
+            $method = "get{$substyleProperty}";
+            return $substyleObject->$method();
+        } else {
+            return null;
+        }
+    }
+
     /**
      * Set style value template method
      *
@@ -296,6 +314,24 @@ protected function setObjectVal($value, $styleName, &$style)
         return $style;
     }
 
+    /**
+     * Set $property value and set $pairProperty = false when $value = true
+     *
+     * @param bool $property
+     * @param bool $pairProperty
+     * @param bool $value
+     * @return self
+     */
+    protected function setPairedVal(&$property, &$pairProperty, $value)
+    {
+        $property = $this->setBoolVal($value, $property);
+        if ($value == true) {
+            $pairProperty = false;
+        }
+
+        return $this;
+    }
+
     /**
      * Set style using associative array
      *