initialQuality property

GlassQuality? initialQuality
final

The quality tier to start at, bypassing Phase 2 (the warm-up benchmark).

When non-null, start skips the warm-up benchmark and jumps directly to Phase 3 (runtime hysteresis) using this quality as the starting point.

Two use cases:

  • Developer-provided persistence — restore a quality previously saved to SharedPreferences so repeat launches skip warmup jank entirely.
  • In-session cache — the static session cache is checked automatically if this field is null, so scopes remounted within the same app process skip Phase 2 without any extra code.

Implementation

final GlassQuality? initialQuality;