WorldWind Kotlin/earth.worldwind.render.video/JavaFxVideoTexture

JavaFxVideoTexture

class JavaFxVideoTexture(val mediaUrl: String, width: Int, height: Int) : CallbackVideoTexture, VideoPlayback

JVM video texture driven by JavaFX MediaPlayer. JavaFX has no per-frame callback API, so we host the MediaView in an off-screen Scene (no javafx.stage.Stage attached) and snapshot the view on every JavaFX AnimationTimer pulse — that's the standard idiom for "give me the current video frame as pixels".

The snapshot returns a WritableImage; we read its pixels in PixelFormat.getByteBgraInstance format into a heap byte array and forward to the CallbackVideoTexture base. The GL thread uploads on the next bind.

Runtime requirement: OpenJFX 21+ runtime JARs (javafx-base, javafx-graphics, javafx-media, javafx-swing) with the host platform classifier on the module path — JavaFX rejects classpath loads since JDK 9.

Constructors

JavaFxVideoTexture

constructor(mediaUrl: String, width: Int, height: Int)

Properties

byteCount

val byteCount: Int

coordTransform

val coordTransform: Matrix3

generateMipmaps

var generateMipmaps: Boolean

Caller opt-out for mipmap generation.

height

val height: Int

mediaUrl

val mediaUrl: String

Filesystem path or URL to the media. A bare path is wrapped via File.toURI.

target

val target: Int

timeMs

open override val timeMs: Long

Current playback time in milliseconds since playback started.

width

val width: Int

Functions

bindTexture

open override fun bindTexture(dc: DrawContext): Boolean

getTexParameter

fun getTexParameter(name: Int): Int

getTextureName

fun getTextureName(dc: DrawContext): KglTexture

pause

open override fun pause()

Pause playback. The current frame stays on the texture; resumable via play.

play

open override fun play()

Start (or resume) playback. Re-entrant — calling on an already-running player is a no-op.

release

open override fun release(dc: DrawContext)

Frees any resources associated with this instance. After this method returns the rendering resource is invalid, and any associated GL object is deleted.

open override fun release()

Free decoder + native resources. After release the texture is unusable.

setTexParameter

fun setTexParameter(name: Int, param: Int)

stop

open override fun stop()

Stop playback and rewind to the start.