GlassScope class Cost and policy

Carries one GlassLedger down the tree.

The value is the ledger's identity, which never changes, so this never notifies and a surface moving never rebuilds anything. Everything that actually changes travels through the ledger as a Listenable.

GlassHost builds one around its child, so every surface under a host registers with that host's ledger. Reading it:

final GlassLoad? load = GlassScope.maybeOf(context)?.read(
  viewSize: MediaQuery.sizeOf(context),
  model: GlassHardware.detect().surfaceCostModel,
);

See also:

• GlassLedger, what it carries.
• g1455.plugfox.dev/start/how-it-works.

Inheritance

• Object
• DiagnosticableTree
• Widget
• ProxyWidget
• InheritedWidget
• GlassScope

Constructors

GlassScope({required GlassLedger ledger, required Widget child, Key? key})

Provides ledger to child. The same ledger for the scope's whole life: a new one is a new register, and every surface below re-registers.

const

Properties

child → Widget

The widget below this widget in the tree.

final, inherited

hashCode → int

The hash code for this object.

no setter, inherited

key → Key?

Controls how one widget replaces another widget in the tree.

final, inherited

ledger → GlassLedger

The register the surfaces below this scope enter.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

createElement() → InheritedElement

Inflates this configuration to a concrete instance.

inherited

debugDescribeChildren() → List<DiagnosticsNode>

Returns a list of DiagnosticsNode objects describing this node's children.

inherited

debugFillProperties(DiagnosticPropertiesBuilder properties) → void

Add additional properties associated with the node.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode

Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.

inherited

toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String

A string representation of this object.

inherited

toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String

Returns a string representation of this node and its descendants.

inherited

toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String

Returns a one-line detailed description of the object.

inherited

toStringShort() → String

A short, textual description of this widget.

inherited

updateShouldNotify(covariant GlassScope oldWidget) → bool

Whether the framework should notify widgets that inherit from this widget.

override

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Static Methods

maybeOf(BuildContext context) → GlassLedger?

The nearest enclosing scope's ledger, or null outside any GlassHost or scope. Depends on the scope, which never notifies while its ledger stays the same.