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

VlcjVideoTexture

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

JVM video texture driven by VLCJ (libVLC bindings). VLCJ's CallbackVideoSurface decodes frames in BGRA (RV32) into a native ByteBuffer; on every render callback we copy them into the CallbackVideoTexture base and the GL thread uploads on bind.

Runtime requirement: VLC 3.0+ installed and discoverable by VLCJ (system-wide install is simplest; VLCJ also accepts -Djna.library.path=…). Without VLC, MediaPlayerFactory construction fails — the tutorial wraps that in try/catch.

Constructors

VlcjVideoTexture

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

isPlaying

val isPlaying: Boolean

True once libVLC has parsed the media and is decoding.

mediaUrl

val mediaUrl: String

URL or filesystem path to the media (e.g. "C:/.../drone.mp4").

target

val target: Int

timeMs

open override val timeMs: Long

Current playback time in milliseconds, or -1 when no media is loaded.

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: the first call prepares the media and starts playing; subsequent calls just resume after pause.

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.