image

abstract fun image(resource: ResourceId): DrawImage(source)

Resolves one resource-pack image through the active resource manager.

The host may reuse an admitted successful result for structurally equal identifiers, so adapters must not depend on a call for every declarative use. Resolution failures and results beyond the host's admission limits are not retained and may be retried during the same host lifetime.

Return

detached immutable pixels reflecting the currently active pack stack.

Parameters

resource

platform-neutral resource identifier.

Throws

when the resource is missing or cannot be decoded as an image.

when called from another thread or after platform close.