RenderQualitySettings class Rendering
Where the scene's automatic settings sit on the quality ladder, and whether the renderer may move them itself when frames run long.
tier left null resolves by platform (web and Linux desktop render
through OpenGL ES class backends and start at RenderQualityTier.medium,
everything else at RenderQualityTier.high). With adaptive on, the
scene measures its own frame period and, when frames overrun
targetFrameRate, lowers the render scale toward minRenderScale and
then, if adaptiveTiers allows, steps the tier down; both recover when
frames come in well under budget. The adaptive scale multiplies
Scene.renderScale, so an explicit scale stays the ceiling.
Frame period is measured on the UI thread, which a GPU-bound frame stalls the same way, so no GPU timer is needed; it cannot see headroom below the display refresh, so recovery only climbs while frames keep their budget.
Constructors
- RenderQualitySettings({RenderQualityTier? tier, bool adaptive = false, double targetFrameRate = 60.0, double minRenderScale = 0.5, double maxRenderScale = 1.0, bool adaptiveTiers = true})
Properties
- adaptive ↔ bool
-
Whether the renderer adjusts the render scale (and tier) from measured
frame periods.
getter/setter pair
- adaptiveTiers ↔ bool
-
Whether the adaptive controller may step the tier below the resolved
tier once the render scale has bottomed out.
getter/setter pair
- hashCode → int
-
The hash code for this object.
no setterinherited
- maxRenderScale ↔ double
-
Highest render scale the adaptive controller may apply (its resting
value while frames keep their budget).
getter/setter pair
- minRenderScale ↔ double
-
Lowest render scale the adaptive controller may apply.
getter/setter pair
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- targetFrameRate ↔ double
-
Frames per second the adaptive controller tries to hold.
getter/setter pair
- tier ↔ RenderQualityTier?
-
The tier automatic settings resolve against, or null for the platform
default (see the class docs).
getter/setter pair
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Properties
- platformDefaultTier → RenderQualityTier
-
The tier the platform starts at when tier is null.
no setter