Вставляем изображение

Всем привет, как и обещал, сегодня будем добавлять изображения в док.
Итак, открываем мануал, видим всякие... странности и разности, пардоньте, не тот мануал). Скажу сразу, использовать можно только изображения типа GIF, JPEG(JPG), BMP,TIFF, PNG. Для добавления изображения используется функция addImage:

$section->addImage( $src, [$style] );

 где:

Функция addImage()
Параметры	Тип данных	Описание
$src	String	Путь к изображению на вашем web-сервере. Может быть абсолютным и относительным
$style	Array	Стиль отображения изображения

Как и в случае с текстом в предыдущем посте, существует не один способ применить стиль к изображению: создать стиль по ходу добавления изображения, выглядит так:

$section->addImage('Example.jpg', array('width'=>100, 'height'=>100, 'align'=>'right'));

а можно создать стиль и потом его просто применять к изображению:

$imageStyle = array('width'=>350, 'height'=>350, 'align'=>'center');      // создали стиль
$section->addImage('Example.jpg', $imageStyle);      //применили по назначению

Рассмотри свойства которые можно задать в стиле.

Название	Описание
Width (ширина)	Ширина изображения в пикселях
Height (высота)	Высота изображения в пикселях
Align (выравнивание)	Выравнивание изображения на странице дока, возможны три значения left (по левому краю) right (по правому краю) center (по центру)

Думаю понятно, что если вставить просто строку:

$section->addImage('Example.jpg'); //   без указания настроек отображения

то изображение вставиться в своём изначальном размере.

Кстати, уж чего не ожидал от бэта версии нашей горячо любимой библиотеки PHPWord, так это возможности вставлять в док изображение созданное с помощью GD (если вы не в курсе что это, настоятельно! советую нажать на ссылочку и почитать).

Вставить GD изображение  можно с помощью функции addMemoryImage:

$section->addMemoryImage( $link, [$style] );

Все как всегда, ничего сложного, поэтому разбираем:

Функция addMemoryImage()
Параметр	Тип данных	Описание
$link	String	Путь к PHP файлу-источнику. Путь может быть только абсолютным (например “http://localhost/image.php”)
$style	Array	Стиль изображения

Настройки стиля теже, что и при работе с обычным изображением.

Использовать можно только GIF, JPEG(JPG), PNG.

THE END ;)