{"version":"1.0","dimension":"image-treatments","items":[{"slug":"full-bleed","name":"Full-Bleed","description":"A single image extends to every slide edge, creating an immersive visual moment.","bestFitContentType":"Title slides, section dividers, campaign stories, and emotional proof points.","photographyGuidance":"Use a high-resolution landscape image with a clean negative-space region for text. Source at least 1920 by 1080 pixels and avoid important subjects near slide edges.","opfSupport":"native","opfGapNote":null,"preview":"full-bleed","bestPractices":["Use fit cover so the image fills the slide without letterboxing.","Reserve a quiet region for text before choosing the crop.","Add an overlay when text appears directly on the image."],"avoid":"Avoid full-bleed photos for dense analytical slides or images with important detail at every edge.","relatedArticleSlugs":["image-focused-full-bleed-layouts","images-placement-sizing-overlays","how-to-set-slide-backgrounds"],"opfSnippet":{"slide":{"layout":"image-focus","elements":[{"id":"hero-photo","type":"image","src":"https://example.com/photo.jpg","alt":"Context-setting presentation photograph","fit":"cover","position":{"x":0,"y":0},"size":{"width":100,"height":100,"unit":"%"}}]}}},{"slug":"text-overlay","name":"Text Overlay","description":"Text sits over photography with a controlled overlay layer for readability.","bestFitContentType":"Hero statements, quotes, impact statistics, and chapter openers.","photographyGuidance":"Choose imagery with low-detail space behind the headline. Add an overlay strong enough to pass contrast checks without hiding the image's subject.","opfSupport":"composed","opfGapNote":"OPF v1 composes this with an image element plus a semi-transparent shape overlay and text element.","preview":"text-overlay","bestPractices":["Keep overlay opacity consistent across a deck.","Place text away from faces, product details, and busy textures.","Use short lines and high-contrast type."],"avoid":"Avoid placing paragraph-length text over busy photography.","relatedArticleSlugs":["image-focused-full-bleed-layouts","images-placement-sizing-overlays","use-color-to-guide-attention"],"opfSnippet":{"slide":{"layout":"image-focus","elements":[{"id":"background-photo","type":"image","src":"https://example.com/photo.jpg","alt":"Background photograph","fit":"cover","position":{"x":0,"y":0},"size":{"width":100,"height":100,"unit":"%"}},{"id":"readability-overlay","type":"shape","shape":"rectangle","fill":"rgba(30, 24, 20, 0.58)","position":{"x":0,"y":0},"size":{"width":100,"height":100,"unit":"%"}},{"id":"headline","type":"text","content":{"text":"A decisive visual statement."},"position":{"x":9,"y":58},"size":{"width":52,"height":18,"unit":"%"}}]}}},{"slug":"side-by-side","name":"Side-by-Side","description":"An image and content panel share the slide, giving visual context without sacrificing explanation.","bestFitContentType":"Case studies, product explanations, before-and-after comparisons, and profile slides.","photographyGuidance":"Use a photo whose subject reads well in a vertical crop. Keep the image subject oriented toward the text side when possible.","opfSupport":"native","opfGapNote":null,"preview":"side-by-side","bestPractices":["Use a clear 50/50 or 40/60 split and align content to the same grid.","Keep the crop simple enough to scan at thumbnail size.","Match image directionality to the reading flow."],"avoid":"Avoid side-by-side treatments when the image needs panoramic scale.","relatedArticleSlugs":["images-placement-sizing-overlays","two-column-comparison-layouts","how-to-add-images-to-powerpoint-slides"],"opfSnippet":{"slide":{"layout":"image-left","elements":[{"id":"supporting-photo","type":"image","src":"https://example.com/photo.jpg","alt":"Supporting photograph","fit":"cover","position":{"x":0,"y":0},"size":{"width":46,"height":100,"unit":"%"}},{"id":"body-copy","type":"text","content":{"text":"Explain the image with a concise headline and supporting point."},"position":{"x":54,"y":24},"size":{"width":36,"height":38,"unit":"%"}}]}}},{"slug":"caption-overlay","name":"Caption Overlay","description":"A compact caption bar attaches attribution, source, or interpretation directly to an image.","bestFitContentType":"Research images, press photos, product screenshots, and data-story evidence slides.","photographyGuidance":"Keep the caption outside the subject's focal area. Use captions to clarify provenance or meaning, not to repeat the slide title.","opfSupport":"native","opfGapNote":null,"preview":"caption-overlay","bestPractices":["Treat captions as metadata, not primary copy.","Use a solid or translucent caption surface with adequate contrast.","Keep captions short enough to read in one glance."],"avoid":"Avoid captions that cover faces, product UI, or the main evidence in the image.","relatedArticleSlugs":["images-placement-sizing-overlays","how-to-add-images-to-powerpoint-slides","image-focused-full-bleed-layouts"],"opfSnippet":{"slide":{"layout":"image-focus","elements":[{"id":"evidence-image","type":"image","src":"https://example.com/evidence.jpg","alt":"Evidence image with source caption","fit":"cover","caption":"Source: field research, 2026","position":{"x":8,"y":12},"size":{"width":84,"height":72,"unit":"%"}}]}}},{"slug":"masked-shape","name":"Masked Shape","description":"Photography is clipped into a simple geometric shape to create emphasis while preserving white space.","bestFitContentType":"Profile slides, feature callouts, editorial sections, and brand moments.","photographyGuidance":"Use images with a clear central subject. Avoid complicated group shots or photos that require edge-to-edge context.","opfSupport":"gap","opfGapNote":"OPF v1 supports borderRadius but does not expose arbitrary image masks yet. Use this slug to track renderer mask support.","preview":"masked-shape","bestPractices":["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."],"avoid":"Avoid decorative masks that crop away the subject or make the image hard to identify.","relatedArticleSlugs":["images-placement-sizing-overlays","how-to-use-placeholders-in-powerpoint-slides"],"opfSnippet":{"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"}]}}},{"slug":"circular-crop","name":"Circular Crop","description":"A round crop isolates a person, logo, or object for a compact identity-focused image.","bestFitContentType":"Speaker bios, team grids, testimonials, customer quotes, and people-centered case studies.","photographyGuidance":"Use square source images with the subject centered. Leave enough headroom so the circular crop does not cut into the subject.","opfSupport":"native","opfGapNote":null,"preview":"circular-crop","bestPractices":["Use consistent crop size across repeated people or customer cards.","Center faces and keep backgrounds simple.","Pair circles with concise labels, not long paragraphs."],"avoid":"Avoid circular crops for landscape scenes, screenshots, or charts.","relatedArticleSlugs":["images-placement-sizing-overlays","how-to-add-images-to-powerpoint-slides","quote-and-highlight-slides"],"opfSnippet":{"slide":{"layout":"profile","elements":[{"id":"portrait","type":"image","src":"https://example.com/portrait.jpg","alt":"Speaker portrait","fit":"cover","borderRadius":999,"shadow":true,"position":{"x":12,"y":22},"size":{"width":22,"height":22,"unit":"%"}}]}}},{"slug":"rounded-card","name":"Rounded Card","description":"An image sits inside a rounded rectangular frame with optional shadow, giving screenshots and photos a contained surface.","bestFitContentType":"Product screenshots, app previews, feature slides, and structured comparison pages.","photographyGuidance":"Use screenshots or photos with clear internal margins. Avoid adding a heavy frame around already cluttered UI.","opfSupport":"native","opfGapNote":null,"preview":"rounded-card","bestPractices":["Use a subtle border radius and shadow rather than a heavy decorative frame.","Keep the card aligned to the same grid as surrounding content.","Use contain for screenshots when no content can be cropped."],"avoid":"Avoid stacking multiple framed images unless the layout is explicitly a comparison or gallery.","relatedArticleSlugs":["how-to-add-images-to-powerpoint-slides","images-placement-sizing-overlays","how-to-use-placeholders-in-powerpoint-slides"],"opfSnippet":{"slide":{"layout":"screenshot-walkthrough","elements":[{"id":"product-screen","type":"image","src":"https://example.com/screenshot.png","alt":"Product screenshot","fit":"contain","borderRadius":12,"shadow":true,"position":{"x":12,"y":16},"size":{"width":76,"height":60,"unit":"%"}}]}}},{"slug":"duotone","name":"Duotone","description":"An image is reduced to two brand-aligned tones so it behaves like part of the design system.","bestFitContentType":"Brand decks, section dividers, campaign stories, and consistent photo-heavy decks.","photographyGuidance":"Choose images with strong light-dark separation. Duotone works best on simple subjects and fails on detail-heavy screenshots.","opfSupport":"gap","opfGapNote":"OPF v1 does not expose image filter tokens. The gallery catalogs duotone as an intended renderer extension.","preview":"duotone","bestPractices":["Use one duotone recipe across a deck.","Preserve enough tonal contrast for the subject to remain legible.","Pair duotone imagery with neutral text surfaces."],"avoid":"Avoid duotone for product UI screenshots, compliance evidence, or images where color accuracy matters.","relatedArticleSlugs":["use-color-to-guide-attention","building-a-color-scheme","images-placement-sizing-overlays"],"opfSnippet":{"slide":{"layout":"image-focus","elements":[{"id":"duotone-photo","type":"image","src":"https://example.com/photo.jpg","alt":"Duotone brand photograph","fit":"cover","position":{"x":0,"y":0},"size":{"width":100,"height":100,"unit":"%"},"filter":{"type":"duotone","dark":"#2f241d","light":"#f28c28"}}]}}},{"slug":"background-blur","name":"Background Blur","description":"A blurred image becomes an atmospheric backdrop while a sharp panel carries the message.","bestFitContentType":"Title slides, product context, event recaps, and image-backed quote slides.","photographyGuidance":"Use a recognizable but non-essential image. The blurred version should support mood, not carry evidence.","opfSupport":"gap","opfGapNote":"OPF v1 does not expose blur filters on image elements. Use this slug to track blur support in renderers.","preview":"background-blur","bestPractices":["Use blur only on background imagery, not the core evidence image.","Add a solid text panel when blur alone does not provide enough contrast.","Keep the focal image available elsewhere if precision matters."],"avoid":"Avoid background blur for data evidence, legal screenshots, or details users need to inspect.","relatedArticleSlugs":["image-focused-full-bleed-layouts","images-placement-sizing-overlays","how-to-set-slide-backgrounds"],"opfSnippet":{"slide":{"layout":"image-focus","elements":[{"id":"blurred-background","type":"image","src":"https://example.com/context.jpg","alt":"Blurred contextual background","fit":"cover","position":{"x":0,"y":0},"size":{"width":100,"height":100,"unit":"%"},"filter":{"blur":18}}]}}},{"slug":"image-strip","name":"Image Strip","description":"A row or column of cropped images creates a fast visual survey without becoming a collage.","bestFitContentType":"Event recaps, customer proof, portfolio snapshots, and process overviews.","photographyGuidance":"Use images with similar exposure and color temperature. Crop consistently so the strip feels intentional.","opfSupport":"native","opfGapNote":null,"preview":"image-strip","bestPractices":["Keep gutters consistent and narrow.","Limit the strip to three to five images.","Use one text anchor outside the strip to explain why the images matter."],"avoid":"Avoid image strips when each image requires individual explanation.","relatedArticleSlugs":["how-to-add-images-to-powerpoint-slides","images-placement-sizing-overlays","image-focused-full-bleed-layouts"],"opfSnippet":{"slide":{"layout":"image-strip","elements":[{"id":"strip-image-1","type":"image","src":"https://example.com/photo-1.jpg","alt":"First image in strip","fit":"cover","position":{"x":8,"y":62},"size":{"width":25,"height":22,"unit":"%"}},{"id":"strip-image-2","type":"image","src":"https://example.com/photo-2.jpg","alt":"Second image in strip","fit":"cover","position":{"x":37.5,"y":62},"size":{"width":25,"height":22,"unit":"%"}},{"id":"strip-image-3","type":"image","src":"https://example.com/photo-3.jpg","alt":"Third image in strip","fit":"cover","position":{"x":67,"y":62},"size":{"width":25,"height":22,"unit":"%"}}]}}},{"slug":"collage-grid","name":"Collage Grid","description":"Multiple images are arranged in a disciplined grid to show breadth, variety, or momentum.","bestFitContentType":"Portfolio slides, social proof, campaign mood boards, and community snapshots.","photographyGuidance":"Curate images around one visual theme. Keep crop ratios consistent and avoid mixing screenshots with photography unless that contrast is the message.","opfSupport":"native","opfGapNote":null,"preview":"collage-grid","bestPractices":["Use a grid, not a scattered pile.","Balance bright and dark images across the composition.","Keep captions off the grid unless every image needs one."],"avoid":"Avoid collage grids for executive decision slides or when one image is clearly the hero.","relatedArticleSlugs":["how-to-add-images-to-powerpoint-slides","images-placement-sizing-overlays"],"opfSnippet":{"slide":{"layout":"image-grid","elements":[{"id":"grid-image-1","type":"image","src":"https://example.com/photo-1.jpg","alt":"Grid image one","fit":"cover","position":{"x":8,"y":14},"size":{"width":38,"height":30,"unit":"%"}},{"id":"grid-image-2","type":"image","src":"https://example.com/photo-2.jpg","alt":"Grid image two","fit":"cover","position":{"x":50,"y":14},"size":{"width":38,"height":30,"unit":"%"}},{"id":"grid-image-3","type":"image","src":"https://example.com/photo-3.jpg","alt":"Grid image three","fit":"cover","position":{"x":8,"y":50},"size":{"width":38,"height":30,"unit":"%"}},{"id":"grid-image-4","type":"image","src":"https://example.com/photo-4.jpg","alt":"Grid image four","fit":"cover","position":{"x":50,"y":50},"size":{"width":38,"height":30,"unit":"%"}}]}}},{"slug":"device-frame","name":"Device Frame","description":"A product screenshot is presented inside a simple device-like frame to make UI context immediately recognizable.","bestFitContentType":"SaaS demos, mobile app launches, product tours, and customer workflow slides.","photographyGuidance":"Use crisp screenshots at native resolution. Hide private data and avoid scaling small text beyond readability.","opfSupport":"composed","opfGapNote":"OPF v1 composes this with a rounded shape frame plus a contained image element.","preview":"device-frame","bestPractices":["Use the frame to clarify context, not as decoration.","Keep one primary screenshot per slide.","Use callouts only for the specific UI detail being discussed."],"avoid":"Avoid device frames when the screenshot itself is too dense to read.","relatedArticleSlugs":["how-to-add-images-to-powerpoint-slides","images-placement-sizing-overlays","how-to-use-placeholders-in-powerpoint-slides"],"opfSnippet":{"slide":{"layout":"screenshot-walkthrough","elements":[{"id":"device-frame","type":"shape","shape":"rectangle","fill":"#2f241d","cornerRadius":18,"position":{"x":20,"y":10},"size":{"width":60,"height":76,"unit":"%"}},{"id":"app-screen","type":"image","src":"https://example.com/app-screen.png","alt":"Application screen in device frame","fit":"contain","borderRadius":12,"position":{"x":23,"y":16},"size":{"width":54,"height":64,"unit":"%"}}]}}},{"slug":"cutout-subject","name":"Cutout Subject","description":"A subject is isolated from its background and placed over a clean slide surface.","bestFitContentType":"Product reveals, people-led stories, hero objects, and high-emphasis marketing slides.","photographyGuidance":"Start with a transparent PNG or cleanly removed background. Add a subtle grounding shadow so the subject does not float awkwardly.","opfSupport":"native","opfGapNote":null,"preview":"cutout-subject","bestPractices":["Use cutouts for one dominant subject, not many small objects.","Preserve realistic scale and leave room for copy.","Use transparent image assets with clean edges."],"avoid":"Avoid rough cutouts, low-resolution edges, or subjects with complex hair and transparent detail unless the source asset is high quality.","relatedArticleSlugs":["images-placement-sizing-overlays","how-to-add-images-to-powerpoint-slides","use-color-to-guide-attention"],"opfSnippet":{"slide":{"layout":"product-feature","elements":[{"id":"cutout-object","type":"image","src":"https://example.com/product-cutout.png","alt":"Cutout product subject","fit":"contain","shadow":true,"position":{"x":54,"y":12},"size":{"width":34,"height":70,"unit":"%"}}]}}},{"slug":"watermark","name":"Watermark","description":"A low-opacity image reinforces brand or confidentiality without becoming primary content.","bestFitContentType":"Internal decks, confidential briefings, appendix slides, and brand identity pages.","photographyGuidance":"Use simple logos or symbols, not detailed photos. Keep opacity low and position away from body copy.","opfSupport":"native","opfGapNote":null,"preview":"watermark","bestPractices":["Use watermarks sparingly and keep them low contrast.","Avoid placing watermarks behind small text.","Prefer vector-like transparent image assets for logos."],"avoid":"Avoid watermarks on already busy slides or where legal text requires full readability.","relatedArticleSlugs":["how-to-set-slide-backgrounds","headers-footers-slide-numbers"],"opfSnippet":{"design":{"brand":{"watermark":{"url":"https://example.com/watermark.png","opacity":0.08}}}}},{"slug":"cinematic-crop","name":"Cinematic Crop","description":"A deliberately tight crop creates drama by emphasizing scale, motion, or a single focal detail.","bestFitContentType":"Launch moments, emotional transitions, keynote openers, and story-led chapter breaks.","photographyGuidance":"Use source images with enough resolution to crop aggressively. The crop must still leave the subject readable at slide size.","opfSupport":"native","opfGapNote":null,"preview":"cinematic-crop","bestPractices":["Crop for intent, not just to fill space.","Keep the focal point aligned to a deliberate grid position.","Avoid placing body text over the tightest detail."],"avoid":"Avoid cinematic crops when the audience needs full context or when the source image is low resolution.","relatedArticleSlugs":["image-focused-full-bleed-layouts","images-placement-sizing-overlays","title-slides-and-section-dividers"],"opfSnippet":{"slide":{"layout":"image-focus","elements":[{"id":"cinematic-photo","type":"image","src":"https://example.com/photo.jpg","alt":"Cinematic cropped photograph","fit":"cover","position":{"x":0,"y":0},"size":{"width":100,"height":58,"unit":"%"}}]}}}],"name":"Image Treatments","description":"Image placement, crop, overlay, mask, caption, and filter patterns for OPF slides.","category":"image-treatments","routes":{"web":"https://www.pptx.gallery/image-treatments","api":"https://www.pptx.gallery/api/image-treatments.json"},"opfSchema":{"name":"Slide.elements[].image","url":"https://pptx.dev/schema/opf/v1#/$defs/Element"},"bestPractices":[{"title":"Crop with intent","description":"Choose fit, position, and size based on the subject and message, not just available space."},{"title":"Protect readability","description":"Text over images needs enough contrast, an intentional overlay, or a separate text surface."},{"title":"Respect image truth","description":"Avoid filters or crops that distort evidence, screenshots, charts, or compliance imagery."},{"title":"Keep a system","description":"Use a small set of image treatments consistently so photo-heavy decks still feel coherent."}],"lastResearched":"2026-04-23","note":"Image Treatments describe OPF image element patterns for placement, cropping, overlays, masks, captions, and presentation-safe photography usage. OPF v1 natively supports image src, alt, fit, position, size, borderRadius, shadow, and caption. Filter and advanced mask treatments are cataloged with OPF gap notes where renderer support is still pending."}