Practical phppptx

Images, audios and videos

Introduction

Images, audios and videos can be added to presentations by calling their respective methods, stating the position and size for each content. Every method counts with specific options in order to apply styles to the new contents.

Adding images

The method for adding new images in the internal active slide is addImage:

public function addImage($image, $position, $imageStyles = array(), $options = array())

This method includes the following parameters:

$image: image path, base64, stream or GdImage.
$position: a new shape is generated to add the content. Coordinate and size values must be set.
$imageStyles: image styles and additional attributes such as borders, hyperlinks, altText value and rotation.
$options: extra options.

The following sample code adds a new image:

$position = array(
    'coordinateX' => 1400000,
    'coordinateY' => 4500000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$pptx->addImage('image.png', $position);

SVG contents can be added using addSvg.

Adding audios

The addAudio method inserts a new audio:

public function addAudio($audio, $position, $audioStyles = array(), $options = array())

The following sample code adds an audio:

$position = array(
    'coordinateX' => 1400000,
    'coordinateY' => 4500000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$pptx->addAudio('audio.mp3', $position);

Adding videos

The addVideo method inserts a new video:

public function addVideo($video, $position, $videoStyles = array(), $options = array())

The following sample code adds a video:

$position = array(
    'coordinateX' => 1400000,
    'coordinateY' => 4500000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$pptx->addVideo('video.mp4', $position);

Backgrounds

If instead of inserting an image in the active slide you want to place it as background, use addBackgroundImage:

public function addBackgroundImage($image, $options = array())

You have to indicate the image in it. For example:

$pptx->addBackgroundImage('image.png', array('transparency' => 60));

Replacing images, audios and videos in a template

As explained on Working with templates, phppptx includes methods to replace and remove images, audios and videos in templates.

Tips and tricks

When inserting audios and videos, you may place a predefined image added in phppptx as preview or use a custom image.

Coordinates, sizes and other options included in phppptx are shown in EMUs. Measure units such as PT or PX can be easily converted to EMUs. For more information on this matter, check the page EMUs measuring unit.

Next - Charts