isometric-compose/io.github.jayteealao.isometric.compose.runtime/IsometricRenderer

IsometricRenderer

class IsometricRenderer(engine: SceneProjector, enablePathCaching: Boolean = false, enableSpatialIndex: Boolean = true, spatialIndexCellSize: Double = DEFAULT_SPATIAL_INDEX_CELL_SIZE) : Closeable

Renderer that converts the isometric node tree to visual output using a SceneProjector for projection and depth sorting.

Coordinates between focused collaborators:

SceneCache — prepared-scene caching and invalidation
HitTestResolver — spatial indexing and command-to-node hit-test resolution
NativeSceneRenderer — Android-native rendering backend
Shared extensions: toComposePath and toComposeColor

Platform notes:

DrawScope.render uses Compose DrawScope APIs and is cross-platform compatible.
DrawScope.renderNative uses android.graphics.Canvas directly and is Android-only. It provides ~2x faster rendering but will throw NoClassDefFoundError on non-Android platforms.

Constructors

IsometricRenderer

constructor(engine: SceneProjector, enablePathCaching: Boolean = false, enableSpatialIndex: Boolean = true, spatialIndexCellSize: Double = DEFAULT_SPATIAL_INDEX_CELL_SIZE)

Types

Companion

object Companion

Properties

benchmarkHooks

var benchmarkHooks: RenderBenchmarkHooks?

Optional benchmark hooks for instrumentation. Set via IsometricScene's DisposableEffect from LocalBenchmarkHooks. Null in production (zero overhead).

forceRebuild

var forceRebuild: Boolean

When true, forces a cache rebuild every frame (disables PreparedScene caching). Used by benchmarks to measure projectScene() cost independently of caching.

onRenderError

var onRenderError: (commandId: String, error: Throwable) -> Unit?

Optional callback invoked when a render command fails to draw. Receives the command ID and the exception. The command is skipped. Null in production (errors are silently skipped).

Functions

clearCache

fun clearCache()

Invalidate cache (call when render options change).

open override fun close()

Release all cached resources. Idempotent — safe to call multiple times. After close(), the renderer must not be used for rendering; any attempt will throw IllegalStateException.

hitTest

fun hitTest(rootNode: GroupNode, x: Double, y: Double, context: RenderContext, width: Int, height: Int): IsometricNode?

Perform hit testing with optional spatial indexing.

render

fun DrawScope.render(rootNode: GroupNode, context: RenderContext, strokeStyle: StrokeStyle = StrokeStyle.FillAndStroke())

Render the node tree to a DrawScope with path caching.

renderNative

fun DrawScope.renderNative(rootNode: GroupNode, context: RenderContext, strokeStyle: StrokeStyle = StrokeStyle.FillAndStroke())

Render using native Android canvas (2x faster, Android-only).