api/dev.s7a.strata.component/TiledImage

TiledImage

@JvmName(name = "TiledImageState06558dbd1f3e_1")

fun UiScope.TiledImage(source: StateSource<TiledImageSource>, state: PanZoomState, size: IntSize, fit: PanZoomFit = PanZoomFit.Contain, cachePolicy: TiledImageCachePolicy = TiledImageCachePolicy.Default, modifier: Modifier = Modifier.Empty, key: ElementKey<*>? = null, content: TiledImageScope.() -> Unit = {})(source)

Observes source for TiledImage at the next owner-thread frame cutoff.

Retain caller-owned sources and editing state outside reevaluation. See Observe for shared snapshots, equal-value suppression, and cleanup; literal arguments follow TiledImage. Modifiers and parent data apply to the actual component, while the binding owns its sibling key.

fun UiScope.TiledImage(source: TiledImageSource, state: PanZoomState, size: IntSize, fit: PanZoomFit = PanZoomFit.Contain, cachePolicy: TiledImageCachePolicy = TiledImageCachePolicy.Default, modifier: Modifier = Modifier.Empty, key: ElementKey<*>? = null, content: TiledImageScope.() -> Unit = {})(source)

Emits one fixed viewport over a logical raster assembled from independently revisioned image tiles.

The component subscribes only to a bounded visible, overscan, and coarser-fallback working set and emits nearest-sampled portable image commands from coarsest to finest, in deterministic row-major order within each level. Pan, zoom, and resize replace only the current placement plan; unchanged immutable tile images remain source-owned and are never joined or copied by this component. Direct children keep fixed logical sizes, paint after the tile layer, and must use TiledImageScope.atContentPosition with either a fixed coordinate or an independently revisioned position source to share its content transform. Pointer navigation is composed independently with Modifier.panZoom; this component consumes no input itself. Retained attachment, measurement, source observation, and release failures propagate through the owning UI session; the component closes its observations but never closes source, its returned state sources, or state.

Receiver

active owner-thread screen scope.

Parameters

source

externally owned immutable source generation, replaced by identity when geometry or generation changes.

state

caller-owned pan-and-zoom transform used by exactly one live viewport geometry owner.

size

exact positive logical viewport size admitted by its parent constraints.

fit

base transform used at zoom one.

cachePolicy

bounded attachment-owned tile working-set policy.

modifier

active behavior applied around the complete clipped viewport.

key

optional stable sibling identity.

content

fixed-size overlay children in source content coordinates.

Throws

IllegalArgumentException

when size, exactly representable source bounds, levels, alignment, or cache limits are invalid.

ArithmeticException

when source grid extents or edge-tile envelopes exceed the Long coordinate space.

IllegalStateException

when either callback scope has escaped its callback or constructing thread.

Throwable

when content or a source geometry getter fails; retained session work may later propagate state observer, tile subscription, or observation-release failures.