Output Formats
Control output dimensions, DPR, file format, quality, transparency, and CDN usage.
ScreenFramed stores renders and returns a CDN URL. Use output to control file format and final dimensions.
Format
json{ "output": { "format": "webp" }}
| Format | Best for |
|---|---|
png | Crisp UI, transparency, docs screenshots, archival quality. |
webp | Smaller marketing images and galleries. |
jpg | Photo-heavy backgrounds where alpha is not needed. |
Size
json{ "aspect_ratio": "16:9", "output": { "width": 1600, "height": 900 }}
output.width and output.height can be set up to 6144. If omitted, ScreenFramed resolves dimensions from the viewport, device, or aspect_ratio.
DPR
json{ "output": { "dpr": 2 }}
Use higher DPR when you need sharper output at the same CSS layout size. Valid values are 1, 2, and 3.
Transparency
json{ "background_style": "transparent", "output": { "format": "png" }}
Transparent renders require PNG or WebP.
CDN URLs
Responses return URLs like:
txthttps://cdn.screenframed.com/r/cap_01KNS1WNPW9FCHZSK4XNTHMB0H.png
Use the returned URL directly in docs, product pages, CMS fields, social schedulers, or asset manifests.