OPF Image Treatment
Masked Shape
Photography is clipped into a simple geometric shape to create emphasis while preserving white space.
Best Fit
Profile slides, feature callouts, editorial sections, and brand moments.
Photography Guidance
Use images with a clear central subject. Avoid complicated group shots or photos that require edge-to-edge context.
Avoid
Avoid decorative masks that crop away the subject or make the image hard to identify.
OPF Coverage Note
OPF v1 supports borderRadius but does not expose arbitrary image masks yet. Use this slug to track renderer mask support.
Treatment Practices
Use one mask shape per slide to avoid visual clutter.
Keep the mask large enough that the subject remains recognizable.
Pair with generous whitespace and restrained text.
OPF Config
image-treatments:masked-shape{
"slide": {
"layout": "image-focus",
"elements": [
{
"id": "masked-photo",
"type": "image",
"src": "https://example.com/photo.jpg",
"alt": "Masked subject photograph",
"fit": "cover",
"position": {
"x": 58,
"y": 16
},
"size": {
"width": 30,
"height": 48,
"unit": "%"
},
"mask": "hexagon"
}
]
}
}Preview this config live at pptx.dev/playground.
Related How-To Articles
Playground deep linkHow to Use Placeholders in PowerPoint Slides
Understand how pptx.dev uses PowerPoint placeholders — title, body, image, chart, and number zones — and how to fill them with your API data.
How to Place, Size, and Overlay Images in PowerPoint
Master image placement, sizing, cropping, and overlay techniques to create polished, professional presentation slides.
General Image Rules
Crop with intent
Choose fit, position, and size based on the subject and message, not just available space.
Protect readability
Text over images needs enough contrast, an intentional overlay, or a separate text surface.
Respect image truth
Avoid filters or crops that distort evidence, screenshots, charts, or compliance imagery.
Keep a system
Use a small set of image treatments consistently so photo-heavy decks still feel coherent.