Images

Image embedding, fit modes, alignment, and transparency

Image Embedding

Embed PNG and JPEG images inline or side-by-side in grid columns.

::pdf-example{pdf="/pdfs/examples/10_image.pdf"}

{
    "page": {"size": "A4", "margins": "20mm"},
    "body": [
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Image Examples", "style": {"size": 18, "bold": true}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "PNG image (blue):"},
                {"type": "spacer", "height": "2mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,..."}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "JPEG image (red):"},
                {"type": "spacer", "height": "2mm"},
                {"type": "image", "image": {"src": "data:image/jpeg;base64,..."}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Images side by side in grid columns:"},
                {"type": "spacer", "height": "2mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 6, "elements": [
                {"type": "text", "content": "Green PNG"},
                {"type": "image", "image": {"src": "data:image/png;base64,..."}}
            ]},
            {"span": 6, "elements": [
                {"type": "text", "content": "Yellow PNG"},
                {"type": "image", "image": {"src": "data:image/png;base64,..."}}
            ]}
        ]}}
    ]
}

::


Image Fit Modes

Control how images are sized within their container.

::pdf-example{pdf="/pdfs/examples/11_image_fit.pdf"}

{
    "page": {"size": "A4", "margins": "20mm"},
    "body": [
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Image Fit Options", "style": {"size": 18, "bold": true}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "FitWidth(80mm):"},
                {"type": "spacer", "height": "2mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "80mm"}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "FitHeight(30mm):"},
                {"type": "spacer", "height": "2mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "height": "30mm"}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Default (no fit options):"},
                {"type": "spacer", "height": "2mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,..."}}
            ]}
        ]}}
    ]
}

::


Advanced Image Features

FitMode comparison, image alignment, PNG transparency, and file path loading.

::pdf-example{pdf="/pdfs/examples/30_image_advanced.pdf"}

{
    "page": {"size": "A4", "margins": "20mm"},
    "body": [
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Advanced Image Features", "style": {"size": 18, "bold": true}},
                {"type": "spacer", "height": "5mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "FitMode Comparison", "style": {"size": 14, "bold": true}},
                {"type": "spacer", "height": "3mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 6, "elements": [
                {"type": "text", "content": "FitContain (default):", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "60mm", "height": "30mm", "fit": "contain"}}
            ]},
            {"span": 6, "elements": [
                {"type": "text", "content": "FitStretch:", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "60mm", "height": "30mm", "fit": "stretch"}}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "spacer": "3mm"}
        ]}},
        {"row": {"cols": [
            {"span": 6, "elements": [
                {"type": "text", "content": "FitOriginal:", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "fit": "original"}}
            ]},
            {"span": 6, "elements": [
                {"type": "text", "content": "FitCover:", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "60mm", "height": "30mm", "fit": "cover"}}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "spacer": "5mm"}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Image Alignment", "style": {"size": 14, "bold": true}},
                {"type": "spacer", "height": "3mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 4, "elements": [
                {"type": "text", "content": "AlignLeft", "style": {"size": 9}},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "30mm", "align": "left"}}
            ]},
            {"span": 4, "elements": [
                {"type": "text", "content": "AlignCenter", "style": {"size": 9}},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "30mm", "align": "center"}}
            ]},
            {"span": 4, "elements": [
                {"type": "text", "content": "AlignRight", "style": {"size": 9}},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "30mm", "align": "right"}}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "spacer": "5mm"}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "PNG Transparency (Alpha Channel)", "style": {"size": 14, "bold": true}},
                {"type": "spacer", "height": "3mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 6, "elements": [
                {"type": "text", "content": "Checkerboard alpha:", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "60mm"}}
            ]},
            {"span": 6, "elements": [
                {"type": "text", "content": "Gradient alpha:", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "60mm"}}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "spacer": "5mm"}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "File Path Loading", "style": {"size": 14, "bold": true}},
                {"type": "spacer", "height": "3mm"}
            ]}
        ]}},
        {"row": {"cols": [
            {"span": 12, "elements": [
                {"type": "text", "content": "Image loaded from file path:", "style": {"size": 9}},
                {"type": "spacer", "height": "1mm"},
                {"type": "image", "image": {"src": "data:image/png;base64,...", "width": "50mm"}}
            ]}
        ]}}
    ]
}

::

Something unclear or missing on this page?