PhpPresentation::setAllMasterSlides() - Code Metrics - Inspection of "Prepend to CreateSlide" - PHPOffice/PHPPresentation - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#597)

unknown

created 2020-09-30 20:24 UTC

PhpPresentation::setAllMasterSlides() A

↳ Parent: PhpPresentation

Complexity

Conditions	3
Paths	2

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	4
CRAP Score	3

Importance

Changes

Metric	Value
dl	0
loc	7
ccs	4
cts	4
cp	1
rs	10
c	0
b	0
f	0
cc	3
nc	2
nop	1
crap	3

<?php
/**
 * This file is part of PHPPresentation - A pure PHP library for reading and writing
 * presentations documents.
 *
 * PHPPresentation is free software distributed under the terms of the GNU Lesser
 * General Public License version 3 as published by the Free Software Foundation.
 *
 * For the full copyright and license information, please read the LICENSE
 * file that was distributed with this source code. For the full list of
 * contributors, visit https://github.com/PHPOffice/PHPPresentation/contributors.
 *
 * @link        https://github.com/PHPOffice/PHPPresentation
 * @copyright   2009-2015 PHPPresentation contributors
 * @license     http://www.gnu.org/licenses/lgpl.txt LGPL version 3
 */

namespace PhpOffice\PhpPresentation;

use PhpOffice\PhpPresentation\Slide;
use PhpOffice\PhpPresentation\Slide\Iterator;
use PhpOffice\PhpPresentation\Slide\SlideMaster;

/**
 * PhpPresentation
 */
class PhpPresentation
{
    /**
     * Document properties
     *
     * @var \PhpOffice\PhpPresentation\DocumentProperties
     */
    protected $documentProperties;

    /**
     * Presentation properties
     *
     * @var \PhpOffice\PhpPresentation\PresentationProperties
     */
    protected $presentationProps;

    /**
     * Document layout
     *
     * @var \PhpOffice\PhpPresentation\DocumentLayout
     */
    protected $layout;

    /**
     * Collection of Slide objects
     *
     * @var \PhpOffice\PhpPresentation\Slide[]
     */
    protected $slideCollection = array();

    /**
     * Active slide index
     *
     * @var int
     */
    protected $activeSlideIndex = 0;

    /**
     * Collection of Master Slides
     * @var \ArrayObject|\PhpOffice\PhpPresentation\Slide\SlideMaster[]
     */
    protected $slideMasters;

    /**
     * Create a new PhpPresentation with one Slide
     */
    public function __construct()
    {
        // Set empty Master & SlideLayout
        $this->createMasterSlide()->createSlideLayout();

        // Initialise slide collection and add one slide
        $this->createSlide();
        $this->setActiveSlideIndex();

        // Set initial document properties & layout
        $this->setDocumentProperties(new DocumentProperties());
        $this->setPresentationProperties(new PresentationProperties());
        $this->setLayout(new DocumentLayout());
    }

    /**
     * Get properties
     *
     * @return \PhpOffice\PhpPresentation\DocumentProperties
     * @deprecated for getDocumentProperties
     */
    public function getProperties()
    {
        return $this->getDocumentProperties();
    }

    /**
     * Set properties
     *
     * @param  \PhpOffice\PhpPresentation\DocumentProperties $value
     * @deprecated for setDocumentProperties
     * @return PhpPresentation
     */
    public function setProperties(DocumentProperties $value)
    {
        return $this->setDocumentProperties($value);
    }

    /**
     * Get properties
     *
     * @return \PhpOffice\PhpPresentation\DocumentProperties
     */
    public function getDocumentProperties()
    {
        return $this->documentProperties;
    }

    /**
     * Set properties
     *
     * @param  \PhpOffice\PhpPresentation\DocumentProperties $value
     * @return PhpPresentation
     */
    public function setDocumentProperties(DocumentProperties $value)
    {
        $this->documentProperties = $value;

        return $this;
    }

    /**
     * Get presentation properties
     *
     * @return \PhpOffice\PhpPresentation\PresentationProperties
     */
    public function getPresentationProperties()
    {
        return $this->presentationProps;
    }

    /**
     * Set presentation properties
     *
     * @param  \PhpOffice\PhpPresentation\PresentationProperties $value
     * @return PhpPresentation
     */
    public function setPresentationProperties(PresentationProperties $value)
    {
        $this->presentationProps = $value;
        return $this;
    }

    /**
     * Get layout
     *
     * @return \PhpOffice\PhpPresentation\DocumentLayout
     */
    public function getLayout()
    {
        return $this->layout;
    }

    /**
     * Set layout
     *
     * @param  \PhpOffice\PhpPresentation\DocumentLayout $value
     * @return PhpPresentation
     */
    public function setLayout(DocumentLayout $value)
    {
        $this->layout = $value;

        return $this;
    }

    /**
     * Get active slide
     *
     * @return \PhpOffice\PhpPresentation\Slide
     */
    public function getActiveSlide()
    {
        return $this->slideCollection[$this->activeSlideIndex];
    }

    /**
     * Create slide and add it to this presentation
     *
     * @return \PhpOffice\PhpPresentation\Slide
     * @throws \Exception
     */
    public function createSlide($prepend=false)
    {
        $newSlide = new Slide($this);
        if ($prepend) {
            $this->prependSlide($newSlide);
        } else {
            $this->addSlide($newSlide);
        }
        return $newSlide;
    }
    
    /**
     * Add slide
     *
     * @param  \PhpOffice\PhpPresentation\Slide $slide
     * @throws \Exception
     * @return \PhpOffice\PhpPresentation\Slide
     */
    public function prependSlide(Slide $slide = null)
    {
        array_unshift($this->slideCollection, $slide);
        return $slide;
    }

    /**
     * Add slide
     *
     * @param  \PhpOffice\PhpPresentation\Slide $slide
     * @throws \Exception
     * @return \PhpOffice\PhpPresentation\Slide
     */
    public function addSlide(Slide $slide = null)
    {
        $this->slideCollection[] = $slide;

        return $slide;
    }

    /**
     * Remove slide by index
     *
     * @param  int $index Slide index
     * @throws \Exception
     * @return PhpPresentation
     */
    public function removeSlideByIndex($index = 0)
    {
        if ($index > count($this->slideCollection) - 1) {
            throw new \Exception("Slide index is out of bounds.");
        }
        array_splice($this->slideCollection, $index, 1);

        return $this;
    }

    /**
     * Get slide by index
     *
     * @param  int $index Slide index
     * @return \PhpOffice\PhpPresentation\Slide
     * @throws \Exception
     */
    public function getSlide($index = 0)
    {
        if ($index > count($this->slideCollection) - 1) {
            throw new \Exception("Slide index is out of bounds.");
        }
        return $this->slideCollection[$index];
    }

    /**
     * Get all slides
     *
     * @return \PhpOffice\PhpPresentation\Slide[]
     */
    public function getAllSlides()
    {
        return $this->slideCollection;
    }

    /**
     * Get index for slide
     *
     * @param  \PhpOffice\PhpPresentation\Slide\AbstractSlide $slide
     * @return int
     * @throws \Exception
     */
    public function getIndex(Slide\AbstractSlide $slide)
    {
        $index = null;
        foreach ($this->slideCollection as $key => $value) {
            if ($value->getHashCode() == $slide->getHashCode()) {
                $index = $key;
                break;
            }
        }
        return $index;
    }

    /**
     * Get slide count
     *
     * @return int
     */
    public function getSlideCount()
    {
        return count($this->slideCollection);
    }

    /**
     * Get active slide index
     *
     * @return int Active slide index
     */
    public function getActiveSlideIndex()
    {
        return $this->activeSlideIndex;
    }

    /**
     * Set active slide index
     *
     * @param  int $index Active slide index
     * @throws \Exception
     * @return \PhpOffice\PhpPresentation\Slide
     */
    public function setActiveSlideIndex($index = 0)
    {
        if ($index > count($this->slideCollection) - 1) {
            throw new \Exception("Active slide index is out of bounds.");
        }
        $this->activeSlideIndex = $index;

        return $this->getActiveSlide();
    }

    /**
     * Add external slide
     *
     * @param  \PhpOffice\PhpPresentation\Slide $slide External slide to add
     * @throws \Exception
     * @return \PhpOffice\PhpPresentation\Slide
     */
    public function addExternalSlide(Slide $slide)
    {
        $slide->rebindParent($this);

        $this->addMasterSlide($slide->getSlideLayout()->getSlideMaster());

        return $this->addSlide($slide);
    }

    /**
     * Get slide iterator
     *
     * @return \PhpOffice\PhpPresentation\Slide\Iterator
     */
    public function getSlideIterator()
    {
        return new Iterator($this);
    }

    /**
     * Create a masterslide and add it to this presentation
     *
     * @return \PhpOffice\PhpPresentation\Slide\SlideMaster
     * @throws \Exception
     */
    public function createMasterSlide()
    {
        $newMasterSlide = new SlideMaster($this);
        $this->addMasterSlide($newMasterSlide);
        return $newMasterSlide;
    }

    /**
     * Add masterslide
     *
     * @param  \PhpOffice\PhpPresentation\Slide\SlideMaster $slide
     * @return \PhpOffice\PhpPresentation\Slide\SlideMaster
     * @throws \Exception
     */
    public function addMasterSlide(SlideMaster $slide = null)
    {
        $this->slideMasters[] = $slide;

        return $slide;
    }

    /**
     * Copy presentation (!= clone!)
     *
     * @return PhpPresentation
     * @throws \Exception
     */
    public function copy()
    {
        $copied = clone $this;

        $slideCount = count($this->slideCollection);
        for ($i = 0; $i < $slideCount; ++$i) {
            $this->slideCollection[$i] = $this->slideCollection[$i]->copy();
            $this->slideCollection[$i]->rebindParent($this);
        }

        return $copied;
    }

    /**
     * Mark a document as final
     * @param bool $state
     * @return PresentationProperties
     * @deprecated for getPresentationProperties()->markAsFinal()
     */
    public function markAsFinal($state = true)
    {
        return $this->getPresentationProperties()->markAsFinal($state);
    }

    /**
     * Return if this document is marked as final
     * @return bool
     * @deprecated for getPresentationProperties()->isMarkedAsFinal()
     */
    public function isMarkedAsFinal()
    {
        return $this->getPresentationProperties()->isMarkedAsFinal();
    }

    /**
     * Set the zoom of the document (in percentage)
     * @param float $zoom
     * @return PresentationProperties
     * @deprecated for getPresentationProperties()->setZoom()
     */
    public function setZoom($zoom = 1.0)
    {
        return $this->getPresentationProperties()->setZoom($zoom);
    }

    /**
     * Return the zoom (in percentage)
     * @return float
     * @deprecated for getPresentationProperties()->getZoom()
     */
    public function getZoom()
    {
        return $this->getPresentationProperties()->getZoom();
    }

    /**
     * @return \ArrayObject|Slide\SlideMaster[]
     */
    public function getAllMasterSlides()
    {
        return $this->slideMasters;
    }

    /**
     * @param \ArrayObject|Slide\SlideMaster[] $slideMasters
     * @return $this
     */
    public function setAllMasterSlides($slideMasters = array())
    {
        if ($slideMasters instanceof \ArrayObject || is_array($slideMasters)) {
            $this->slideMasters = $slideMasters;
        }
        return $this;
    }
}


1		<?php
2		/**
3		* This file is part of PHPPresentation - A pure PHP library for reading and writing
4		* presentations documents.
5		*
6		* PHPPresentation is free software distributed under the terms of the GNU Lesser
7		* General Public License version 3 as published by the Free Software Foundation.
8		*
9		* For the full copyright and license information, please read the LICENSE
10		* file that was distributed with this source code. For the full list of
11		* contributors, visit https://github.com/PHPOffice/PHPPresentation/contributors.
12		*
13		* @link https://github.com/PHPOffice/PHPPresentation
14		* @copyright 2009-2015 PHPPresentation contributors
15		* @license http://www.gnu.org/licenses/lgpl.txt LGPL version 3
16		*/
17
18		namespace PhpOffice\PhpPresentation;
19
20		use PhpOffice\PhpPresentation\Slide;
21		use PhpOffice\PhpPresentation\Slide\Iterator;
22		use PhpOffice\PhpPresentation\Slide\SlideMaster;
23
24		/**
25		* PhpPresentation
26		*/
27		class PhpPresentation
28		{
29		/**
30		* Document properties
31		*
32		* @var \PhpOffice\PhpPresentation\DocumentProperties
33		*/
34		protected $documentProperties;
35
36		/**
37		* Presentation properties
38		*
39		* @var \PhpOffice\PhpPresentation\PresentationProperties
40		*/
41		protected $presentationProps;
42
43		/**
44		* Document layout
45		*
46		* @var \PhpOffice\PhpPresentation\DocumentLayout
47		*/
48		protected $layout;
49
50		/**
51		* Collection of Slide objects
52		*
53		* @var \PhpOffice\PhpPresentation\Slide[]
54		*/
55		protected $slideCollection = array();
56
57		/**
58		* Active slide index
59		*
60		* @var int
61		*/
62		protected $activeSlideIndex = 0;
63
64		/**
65		* Collection of Master Slides
66		* @var \ArrayObject\|\PhpOffice\PhpPresentation\Slide\SlideMaster[]
67		*/
68		protected $slideMasters;
69
70		/**
71		* Create a new PhpPresentation with one Slide
72		*/
73	222	public function __construct()
74		{
75		// Set empty Master & SlideLayout
76	222	$this->createMasterSlide()->createSlideLayout();
77
78		// Initialise slide collection and add one slide
79	222	$this->createSlide();
80	222	$this->setActiveSlideIndex();
81
82		// Set initial document properties & layout
83	222	$this->setDocumentProperties(new DocumentProperties());
84	222	$this->setPresentationProperties(new PresentationProperties());
85	222	$this->setLayout(new DocumentLayout());
86	222	}
87
88		/**
89		* Get properties
90		*
91		* @return \PhpOffice\PhpPresentation\DocumentProperties
92		* @deprecated for getDocumentProperties
93		*/
94	1	public function getProperties()
95		{
96	1	return $this->getDocumentProperties();
97		}
98
99		/**
100		* Set properties
101		*
102		* @param \PhpOffice\PhpPresentation\DocumentProperties $value
103		* @deprecated for setDocumentProperties
104		* @return PhpPresentation
105		*/
106	1	public function setProperties(DocumentProperties $value)
107		{
108	1	return $this->setDocumentProperties($value);
109		}
110
111		/**
112		* Get properties
113		*
114		* @return \PhpOffice\PhpPresentation\DocumentProperties
115		*/
116	186	public function getDocumentProperties()
117		{
118	186	return $this->documentProperties;
119		}
120
121		/**
122		* Set properties
123		*
124		* @param \PhpOffice\PhpPresentation\DocumentProperties $value
125		* @return PhpPresentation
126		*/
127	222	public function setDocumentProperties(DocumentProperties $value)
128		{
129	222	$this->documentProperties = $value;
130
131	222	return $this;
132		}
133
134		/**
135		* Get presentation properties
136		*
137		* @return \PhpOffice\PhpPresentation\PresentationProperties
138		*/
139	183	public function getPresentationProperties()
140		{
141	183	return $this->presentationProps;
142		}
143
144		/**
145		* Set presentation properties
146		*
147		* @param \PhpOffice\PhpPresentation\PresentationProperties $value
148		* @return PhpPresentation
149		*/
150	222	public function setPresentationProperties(PresentationProperties $value)
151		{
152	222	$this->presentationProps = $value;
153	222	return $this;
154		}
155
156		/**
157		* Get layout
158		*
159		* @return \PhpOffice\PhpPresentation\DocumentLayout
160		*/
161	179	public function getLayout()
162		{
163	179	return $this->layout;
164		}
165
166		/**
167		* Set layout
168		*
169		* @param \PhpOffice\PhpPresentation\DocumentLayout $value
170		* @return PhpPresentation
171		*/
172	222	public function setLayout(DocumentLayout $value)
173		{
174	222	$this->layout = $value;
175
176	222	return $this;
177		}
178
179		/**
180		* Get active slide
181		*
182		* @return \PhpOffice\PhpPresentation\Slide
183		*/
184	222	public function getActiveSlide()
185		{
186	222	return $this->slideCollection[$this->activeSlideIndex];
187		}
188
189		/**
190		* Create slide and add it to this presentation
191		*
192		* @return \PhpOffice\PhpPresentation\Slide
193		* @throws \Exception
194		*/
195	222	public function createSlide($prepend=false)
196		{
197	222	$newSlide = new Slide($this);
198	222	if ($prepend) {
199		$this->prependSlide($newSlide);
200		} else {
201	222	$this->addSlide($newSlide);
202		}
203	222	return $newSlide;
204		}
205
206		/**
207		* Add slide
208		*
209		* @param \PhpOffice\PhpPresentation\Slide $slide
210		* @throws \Exception
211		* @return \PhpOffice\PhpPresentation\Slide
212		*/
213		public function prependSlide(Slide $slide = null)
214		{
215		array_unshift($this->slideCollection, $slide);
216		return $slide;
217		}
218
219		/**
220		* Add slide
221		*
222		* @param \PhpOffice\PhpPresentation\Slide $slide
223		* @throws \Exception
224		* @return \PhpOffice\PhpPresentation\Slide
225		*/
226	222	public function addSlide(Slide $slide = null)
227		{
228	222	$this->slideCollection[] = $slide;
229
230	222	return $slide;
231		}
232
233		/**
234		* Remove slide by index
235		*
236		* @param int $index Slide index
237		* @throws \Exception
238		* @return PhpPresentation
239		*/
240	16	public function removeSlideByIndex($index = 0)
241		{
242	16	if ($index > count($this->slideCollection) - 1) {
243	1	throw new \Exception("Slide index is out of bounds.");
244		}
245	15	array_splice($this->slideCollection, $index, 1);
246
247	15	return $this;
248		}
249
250		/**
251		* Get slide by index
252		*
253		* @param int $index Slide index
254		* @return \PhpOffice\PhpPresentation\Slide
255		* @throws \Exception
256		*/
257	193	public function getSlide($index = 0)
258		{
259	193	if ($index > count($this->slideCollection) - 1) {
260	1	throw new \Exception("Slide index is out of bounds.");
261		}
262	192	return $this->slideCollection[$index];
263		}
264
265		/**
266		* Get all slides
267		*
268		* @return \PhpOffice\PhpPresentation\Slide[]
269		*/
270	184	public function getAllSlides()
271		{
272	184	return $this->slideCollection;
273		}
274
275		/**
276		* Get index for slide
277		*
278		* @param \PhpOffice\PhpPresentation\Slide\AbstractSlide $slide
279		* @return int
280		* @throws \Exception
281		*/
282	115	public function getIndex(Slide\AbstractSlide $slide)
283		{
284	115	$index = null;
285	115	foreach ($this->slideCollection as $key => $value) {
286	115	if ($value->getHashCode() == $slide->getHashCode()) {
287	115	$index = $key;
288	115	break;
289		}
290		}
291	115	return $index;
292		}
293
294		/**
295		* Get slide count
296		*
297		* @return int
298		*/
299	196	public function getSlideCount()
300		{
301	196	return count($this->slideCollection);
302		}
303
304		/**
305		* Get active slide index
306		*
307		* @return int Active slide index
308		*/
309	1	public function getActiveSlideIndex()
310		{
311	1	return $this->activeSlideIndex;
312		}
313
314		/**
315		* Set active slide index
316		*
317		* @param int $index Active slide index
318		* @throws \Exception
319		* @return \PhpOffice\PhpPresentation\Slide
320		*/
321	222	public function setActiveSlideIndex($index = 0)
322		{
323	222	if ($index > count($this->slideCollection) - 1) {
324	1	throw new \Exception("Active slide index is out of bounds.");
325		}
326	222	$this->activeSlideIndex = $index;
327
328	222	return $this->getActiveSlide();
329		}
330
331		/**
332		* Add external slide
333		*
334		* @param \PhpOffice\PhpPresentation\Slide $slide External slide to add
335		* @throws \Exception
336		* @return \PhpOffice\PhpPresentation\Slide
337		*/
338	1	public function addExternalSlide(Slide $slide)
339		{
340	1	$slide->rebindParent($this);
341
342	1	$this->addMasterSlide($slide->getSlideLayout()->getSlideMaster());
343
344	1	return $this->addSlide($slide);
345		}
346
347		/**
348		* Get slide iterator
349		*
350		* @return \PhpOffice\PhpPresentation\Slide\Iterator
351		*/
352	1	public function getSlideIterator()
353		{
354	1	return new Iterator($this);
355		}
356
357		/**
358		* Create a masterslide and add it to this presentation
359		*
360		* @return \PhpOffice\PhpPresentation\Slide\SlideMaster
361		* @throws \Exception
362		*/
363	222	public function createMasterSlide()
364		{
365	222	$newMasterSlide = new SlideMaster($this);
366	222	$this->addMasterSlide($newMasterSlide);
367	222	return $newMasterSlide;
368		}
369
370		/**
371		* Add masterslide
372		*
373		* @param \PhpOffice\PhpPresentation\Slide\SlideMaster $slide
374		* @return \PhpOffice\PhpPresentation\Slide\SlideMaster
375		* @throws \Exception
376		*/
377	222	public function addMasterSlide(SlideMaster $slide = null)
378		{
379	222	$this->slideMasters[] = $slide;
380
381	222	return $slide;
382		}
383
384		/**
385		* Copy presentation (!= clone!)
386		*
387		* @return PhpPresentation
388		* @throws \Exception
389		*/
390	1	public function copy()
391		{
392	1	$copied = clone $this;
393
394	1	$slideCount = count($this->slideCollection);
395	1	for ($i = 0; $i < $slideCount; ++$i) {
396	1	$this->slideCollection[$i] = $this->slideCollection[$i]->copy();
397	1	$this->slideCollection[$i]->rebindParent($this);
398		}
399
400	1	return $copied;
401		}
402
403		/**
404		* Mark a document as final
405		* @param bool $state
406		* @return PresentationProperties
407		* @deprecated for getPresentationProperties()->markAsFinal()
408		*/
409	1	public function markAsFinal($state = true)
410		{
411	1	return $this->getPresentationProperties()->markAsFinal($state);
412		}
413
414		/**
415		* Return if this document is marked as final
416		* @return bool
417		* @deprecated for getPresentationProperties()->isMarkedAsFinal()
418		*/
419	1	public function isMarkedAsFinal()
420		{
421	1	return $this->getPresentationProperties()->isMarkedAsFinal();
422		}
423
424		/**
425		* Set the zoom of the document (in percentage)
426		* @param float $zoom
427		* @return PresentationProperties
428		* @deprecated for getPresentationProperties()->setZoom()
429		*/
430	1	public function setZoom($zoom = 1.0)
431		{
432	1	return $this->getPresentationProperties()->setZoom($zoom);
433		}
434
435		/**
436		* Return the zoom (in percentage)
437		* @return float
438		* @deprecated for getPresentationProperties()->getZoom()
439		*/
440	1	public function getZoom()
441		{
442	1	return $this->getPresentationProperties()->getZoom();
443		}
444
445		/**
446		* @return \ArrayObject\|Slide\SlideMaster[]
447		*/
448	222	public function getAllMasterSlides()
449		{
450	222	return $this->slideMasters;
451		}
452
453		/**
454		* @param \ArrayObject\|Slide\SlideMaster[] $slideMasters
455		* @return $this
456		*/
457	4	public function setAllMasterSlides($slideMasters = array())
458		{
459	4	if ($slideMasters instanceof \ArrayObject \|\| is_array($slideMasters)) {
460	4	$this->slideMasters = $slideMasters;
461		}
462	4	return $this;
463		}
464		}
465

PHPOffice / PHPPresentation

Pull Request — master (#597)

PhpPresentation::setAllMasterSlides() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like