Skip to main content

Interface: DynamicResolutionOptions

Dynamic resolution can be used to either reach a desired target frame rate by lowering the resolution of a View, or to increase the quality when the rendering is faster than the target frame rate.

This structure can be used to specify the minimum scale factor used when lowering the resolution of a View, and the maximum scale factor used when increasing the resolution for higher quality rendering. The scale factors can be controlled on each X and Y axis independently. By default, all scale factors are set to 1.0.

enabled: enable or disables dynamic resolution on a View

homogeneousScaling: by default the system scales the major axis first. Set this to true to force homogeneous scaling.

minScale: the minimum scale in X and Y this View should use

maxScale: the maximum scale in X and Y this View should use

quality: upscaling quality. LOW: 1 bilinear tap, Medium: 4 bilinear taps, High: 9 bilinear taps (tent)

Note

Dynamic resolution is only supported on platforms where the time to render a frame can be measured accurately. Dynamic resolution is currently only supported on Android.

See

Renderer::FrameRateOptions

Properties

enabled?

optional enabled: boolean

enable or disable dynamic resolution

Defined in

src/types/Options.ts:112


homogeneousScaling?

optional homogeneousScaling: boolean

Set to true to force homogeneous scaling

Default

false

Defined in

src/types/Options.ts:118


maxScale?

optional maxScale: [number, number]

Maximum scale factors in x and y

Default

[1.0, 1.0]

Defined in

src/types/Options.ts:130


minScale?

optional minScale: [number, number]

Minimum scale factors in x and y

Default

[0.5, 0.5]

Defined in

src/types/Options.ts:124


quality?

optional quality: QualityLevel

Upscaling quality LOW: bilinear filtered blit. Fastest, poor quality MEDIUM: AMD FidelityFX FSR1 w/ mobile optimizations HIGH: AMD FidelityFX FSR1 w/ mobile optimizations ULTRA: AMD FidelityFX FSR1 FSR1 require a well anti-aliased (MSAA or TAA), noise free scene.

Default

'LOW'

Defined in

src/types/Options.ts:149


sharpness?

optional sharpness: number

Sharpness when QualityLevel::MEDIUM or higher is used [0 (disabled), 1 (sharpest)]

Default

0.9

Defined in

src/types/Options.ts:137