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

JavaCvVideoTexture

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

JVM video texture driven by JavaCV's high-level FFmpegFrameGrabber. A worker thread loops on grabImage(), copies the BGRA frame bytes out, and pushes them to the CallbackVideoTexture base for GL-thread upload.

Compared to the raw FFmpeg path (FFmpegVideoTexture), this is far shorter — the grabber handles demuxing, decoding, and pixel-format conversion. Tradeoff: less control over codec selection, hardware acceleration, and the exact pixel format.

Runtime requirement: FFmpeg natives via org.bytedeco:javacv-platform.

Pacing: the loop sleeps to roughly match the source frame rate. Without it, decode runs at I/O speed and most frames are dropped at the GL upload (which only refreshes once per render tick).

Constructors

JavaCvVideoTexture

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.

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.