Imágenes

Embebe imágenes raster y vectoriales en tus PDFs usando los métodos fluent image() e imageSvg(), con control total sobre posición y tamaño.

Ejemplo completo

<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use TcpdfNext\Document;

Document::create()
    ->setTitle('Image Examples')
    ->addPage()

    // -- Título -----------------------------------------------------------
    ->setFont('helvetica', style: 'B', size: 18)
    ->cell(0, 12, 'Embedding Images', newLine: true)

    // -- 1. JPEG (modo flujo) --------------------------------------------
    ->setFont('helvetica', style: 'B', size: 13)
    ->cell(0, 10, '1. JPEG -- auto height', newLine: true)
    ->image(
        file:   __DIR__ . '/assets/photo.jpg',
        x:      null,                         // X actual
        y:      null,                         // Y actual
        width:  60,                           // 60 mm de ancho
        height: null,                         // auto (preservar ratio)
    )

    // -- 2. PNG con transparencia ---------------------------------------
    ->setFont('helvetica', style: 'B', size: 13)
    ->cell(0, 10, '2. PNG with alpha channel', newLine: true)
    ->image(
        file:   __DIR__ . '/assets/logo.png',
        x:      null,
        y:      null,
        width:  40,
        height: null,
    )

    // -- 3. Gráfico vectorial SVG ------------------------------------------
    ->setFont('helvetica', style: 'B', size: 13)
    ->cell(0, 10, '3. SVG vector image', newLine: true)
    ->imageSvg(
        file:   __DIR__ . '/assets/diagram.svg',
        x:      null,
        y:      null,
        width:  80,
        height: 50,
    )

    // -- 4. Posicionamiento absoluto ----------------------------------------
    ->image(
        file:   __DIR__ . '/assets/badge.png',
        x:      150,                          // 150 mm desde el borde izquierdo
        y:      10,                           // 10 mm desde arriba
        width:  30,
        height: 30,
    )

    ->save(__DIR__ . '/images.pdf');

echo 'PDF created.' . PHP_EOL;

Modos de posicionamiento

Modo flujo

Pasa null para x e y. La imagen se coloca en la posición actual del cursor y el cursor avanza hacia abajo:

->image(file: 'photo.jpg', x: null, y: null, width: 60, height: null)

Modo absoluto

Pasa coordenadas explícitas. El cursor no se mueve -- ideal para logos, insignias u overlays de marca de agua:

->image(file: 'badge.png', x: 150, y: 10, width: 30, height: 30)

Comportamiento de escalado

width	height	Resultado
60	null	Ancho fijo, alto automático (ratio de aspecto preservado)
null	40	Ancho automático, alto fijo (ratio de aspecto preservado)
60	40	Dimensiones exactas (puede estirar)
null	null	Tamaño original en píxeles convertido a mm a 96 DPI

Formatos soportados

Formato	Notas
JPEG	Baseline y progresivo; espacio de color CMYK soportado
PNG	8-bit, 24-bit y 32-bit con transparencia alpha completa
SVG	Via imageSvg() -- renderiza paths, texto y CSS básico

Ajuste de texto alrededor de una imagen

Usa posicionamiento absoluto para la imagen y restringe el ancho de multiCell() para evitar superposición:

Document::create()
    ->setTitle('Text Wrap')
    ->addPage()
    ->image(file: 'photo.jpg', x: 140, y: 30, width: 50, height: null)
    ->setFont('helvetica', size: 11)
    ->setXY(10, 30)
    ->multiCell(width: 125, height: 6, text: 'Your paragraph text here...')
    ->save('text-wrap.pdf');

Salida

El ejemplo completo produce una página con una foto JPEG, un logo PNG transparente, un diagrama SVG y una insignia posicionada absolutamente en la esquina superior derecha.