JSON API - addImage

CONTENTS

LAYOUTS

TEMPLATES

PPTXPATH

FORMAT CONVERSION

PPTXUTILITIES

PPTXCUSTOMIZER

customizeElementStyles

PERFORMANCE

zipStream

addImage

PREMIUM

TRIAL / ADVANCED

Inserts an image into the PowerPoint presentation.

Note

You are reading the JSON API documentation. For the PHP API method please go to addImage.

JSON data

{
    "image": "string",
    "position": {
        "coordinateX": number,
        "coordinateY": number,
        "sizeX": number,
        "sizeY": number,
        "name": "string",
        "order": number
    },
    "imageStyles": {
        "border": {
            "dash": "string",
            "color": "string",
            "width": number
        },
        "descr": "string",
        "hyperlink": "string",
        "rotation": number,
        "transparency": number
    },
    "options": {
        "mime": "string"
    }
}

Key	Description
image	Image path, Base64 string, or URL. Image formats: png, jpg, jpeg, gif, bmp, webp.
coordinateX	EMUs (English Metric Unit).
coordinateY	EMUs (English Metric Unit).
sizeX	EMUs (English Metric Unit).
sizeY	EMUs (English Metric Unit).
name	Internal name. If not set, a random name is generated.
order	Set the display order. Default after existing contents. 0 is the first order position. If the order position doesn't exist add after existing contents.
border	"dash" solid, dot, dash, lgDash, dashDot, lgDashDot, lgDashDotDot, sysDash, sysDot, sysDashDot, sysDashDotDot. "color" default as 000000. "width" EMUs (English Metric Unit). Default as 12700 (1pt).
descr	Descr value.
hyperlink	Hyperlink: external, bookmark (#firstslide, #lastslide, #nextslide, #previousslide) or slide (#slide + position).
rotation	60.000ths of a degree.
transparency	0 to 100.
mime	Forces a mime (image/jpg, image/jpeg, image/png, image/gif, image/bmp, image/webp).

Code samples

Example #1

{
    "actions": [
        {
            "action": "addImage",
            "data": {
                "image": "image.png",
                "position": {
                    "coordinateX": 1400000,
                    "coordinateY": 4500000,
                    "sizeX": 2000000,
                    "sizeY": 2000000
                }
            }
        },
        {
            "action": "addSlide",
            "data": {
                "layout": "Blank",
                "active": true
            }
        },
        {
            "action": "addImage",
            "data": {
                "image": "imageP1.png",
                "position": {
                    "coordinateX": 1500000,
                    "coordinateY": 2000000,
                    "sizeX": 2000000,
                    "sizeY": 2000000
                }
            }
        },
        {
            "action": "addImage",
            "data": {
                "image": "imageP2.png",
                "position": {
                    "coordinateX": 4000000,
                    "coordinateY": 2000000,
                    "sizeX": 2000000,
                    "sizeY": 2000000
                }
            }
        },
        {
            "action": "addImage",
            "data": {
                "image": "imageP3.png",
                "position": {
                    "coordinateX": 6500000,
                    "coordinateY": 2000000,
                    "sizeX": 2000000,
                    "sizeY": 2000000
                }
            }
        }
    ]
}

Release notes

phppptx 5.0:
- new action.