Back to Filament

DynamicResolutionOptions

docs/android/dokka/filament-android/com.google.android.filament/-view/-dynamic-resolution-options/index.md

1.75.03.1 KB
Original Source

//filament-android/com.google.android.filament/View/DynamicResolutionOptions

DynamicResolutionOptions

open class 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. On platforms where this is not supported, Dynamic Resolution can't be enabled unless minScale == maxScale.

See also

Renderer.FrameRateOptions

Constructors

DynamicResolutionOptions[main]
constructor()

Properties

NameSummary
enabled[main]
open var enabled: Boolean
enable or disable dynamic resolution
homogeneousScaling[main]
open var homogeneousScaling: Boolean
set to true to force homogeneous scaling
maxScale[main]
open var maxScale: Float
maximum scale factors in x and y
minScale[main]
open var minScale: Float
minimum scale factors in x and y
quality[main]
open var quality: View.QualityLevel
Upscaling quality
  • LOW: bilinear filtered blit. Fastest, poor quality - MEDIUM: Qualcomm Snapdragon Game Super Resolution (SGSR) 1.0 - HIGH: AMD FidelityFX FSR1 w/ mobile optimizations - ULTRA: AMD FidelityFX FSR1 FSR1 and SGSR require a well anti-aliased (MSAA or TAA), noise free scene. | | sharpness | [main] open var sharpness: Float sharpness when QualityLevel::MEDIUM or higher is used [0 (disabled), 1 (sharpest)] |