Skip to content
Port OS

GenerativeUiDisplay

HTTP API schema

The screen a surface is drawn on, so an agent designs for it. The layout size is `widthDp` by `heightDp` (960 by 540 on a 1080p TV): design for that size at ten-foot viewing distance, with large text and few items, and keep content inside `safeAreaInsetDp`.

GenerativeUiDisplay fields

widthPxintegerRequired

Width in pixels of the panel the app renders to.

minimum: 1

heightPxintegerRequired

Height in pixels of the panel the app renders to.

minimum: 1

widthDpintegerRequired

Layout width in density-independent pixels after the TV scale. 960 on a 1080p TV.

minimum: 1

heightDpintegerRequired

Layout height in density-independent pixels after the TV scale. 540 on a 1080p TV.

minimum: 1

densitynumberRequired

Pixels per dp.

minimum: 0.1

safeAreaInsetDpintegerRequired

The overscan margin, in dp, that the renderer keeps clear on every edge.

minimum: 0

viewingDistancestringRequired

How far the viewer sits. TEN_FOOT means a sofa, so text must be large and screens sparse.

Allowed values

  • TEN_FOOT
View source specification ↗