Represents the unique identifier for a reference-based component. The refId is used as a distinctive key for retrieving or linking this component within reference-dependent systems.

renderer

override val renderer: ZViewportRenderer

Provides access to the component's renderer.

viewBox

var viewBox: ZBox2D

Represents the view box used as viewport for rendering objects. The view box defines the boundaries and dimensions of the viewport.

Functions

buildRenderPassDescriptor

fun buildRenderPassDescriptor(): ZGpuRenderPassDescriptor?

Builds or refreshes the GPU render-pass descriptor for this viewport. Returns null when attachments are unavailable (e.g. zero-sized view box).

dispose

override fun dispose()

Disposes the component and releases resources. Idempotent: multiple calls are safe. Subclasses with own state to release should override internalDispose.

initialize

open override fun initialize(ctx: ZRenderingContext)

Initializes the ZComponent using the provided ZRenderingContext.

onViewportResize

open override fun onViewportResize(width: Int, height: Int)

Notifies the listener when the viewport dimensions change.

render

open override fun render()

Per-frame GPU setup for scene-graph consumers. On OpenGL this clears the framebuffer. On WebGPU this is a no-op; the renderer calls buildRenderPassDescriptor before the pass.