All Superinterfaces:: TextureSequence

public interface GLMediaPlayer extends TextureSequence

GLMediaPlayer interface specifies a TextureSequence state machine using a multiplexed audio/video stream as it's source.

Audio maybe supported and played back internally or via an AudioSink implementation.

Audio and video streams can be selected or muted via initStream(Uri, int, int, int) using the appropriate stream id's.

Camera input can be selected using the CameraInputScheme Uri.

StreamWorker Decoding Thread

Most of the stream processing is performed on the decoding thread, a.k.a. StreamWorker:

Stream initialization triggered by initStream(..) - User gets notified whether the stream has been initialized or not via attributesChanges(..).
Stream decoding - User gets notified of a new frame via newFrameAvailable(...).
Caught exceptions on the decoding thread are delivered as GLMediaPlayer.StreamExceptions.

StreamWorker generates it's own GLContext, shared with the one passed to initGL(GL). The shared GLContext allows the decoding thread to push the video frame data directly into the designated TextureSequence.TextureFrame, later returned via getNextTexture(GL) and used by the user.

StreamWorker Error Handling

Caught exceptions on StreamWorker are delivered as GLMediaPlayer.StreamExceptions, which either degrades the GLMediaPlayer.State to GLMediaPlayer.State.Uninitialized or GLMediaPlayer.State.Paused.

An occurring GLMediaPlayer.StreamException triggers a EVENT_CHANGE_ERR event, which can be listened to via GLMediaPlayer.GLMediaEventListener.attributesChanged(GLMediaPlayer, int, long).

An occurred GLMediaPlayer.StreamException can be read via getStreamException().

GLMediaPlayer Lifecycle

Action	`GLMediaPlayer.State` Before	`GLMediaPlayer.State` After	`Event`
`initStream(Uri, int, int, int)`	`Uninitialized`	`Initialized`¹, `Uninitialized`	`EVENT_CHANGE_INIT` or ( `EVENT_CHANGE_ERR` + `EVENT_CHANGE_UNINIT` )
`initGL(GL)`	`Initialized`	`Paused`, , `Uninitialized`	`EVENT_CHANGE_PAUSE` or ( `EVENT_CHANGE_ERR` + `EVENT_CHANGE_UNINIT` )
`play()`	`Paused`	`Playing`	`EVENT_CHANGE_PLAY`
`pause(boolean)`	`Playing`	`Paused`	`EVENT_CHANGE_PAUSE`
`seek(int)`	`Paused`, `Playing`	`Paused`, `Playing`	none
`getNextTexture(GL)`	`Paused`, `Playing`	`Paused`, `Playing`	none
`getLastTexture()`	`Paused`, `Playing`	`Paused`, `Playing`	none
`END_OF_STREAM`	`Playing`	`Paused`	`EVENT_CHANGE_EOS` + `EVENT_CHANGE_PAUSE`
`GLMediaPlayer.StreamException`	ANY	`Paused`, `Uninitialized`	`EVENT_CHANGE_ERR` + ( `EVENT_CHANGE_PAUSE` or `EVENT_CHANGE_UNINIT` )
`destroy(GL)`	ANY	`Uninitialized`	`EVENT_CHANGE_UNINIT`

Audio and video Stream IDs

value	request	get
`STREAM_ID_NONE`	mute	not available
`STREAM_ID_AUTO`	auto	unspecified
≥0	specific stream	specific stream

Current implementations (check each API doc link for details):

NullGLMediaPlayer
OMXGLMediaPlayer
FFMPEGMediaPlayer
AndroidGLMediaPlayerAPI14

Implementations of this interface must implement:

    public static final boolean isAvailable();

to be properly considered by GLMediaPlayerFactory.create(ClassLoader, String) and GLMediaPlayerFactory.createDefault().

Timestamp Accuracy

Timestamp type and value range has been chosen to suit embedded CPUs and characteristics of audio and video streaming. See TimeFrameI.

Audio and video synchronization

The class follows a passive A/V synchronization pattern. Audio is being untouched, while getNextTexture(GL) delivers a new video frame only, if its timestamp is less than MAXIMUM_VIDEO_ASYNC ahead of time. If its timestamp is more than MAXIMUM_VIDEO_ASYNC ahead of time, the previous frame is returned. If its timestamp is more than MAXIMUM_VIDEO_ASYNC after time, the frame is dropped and the next frame is being fetched.

https://en.wikipedia.org/wiki/Audio_to_video_synchronization

   d_av = v_pts - a_pts;

Recommendation of audio/video pts time lead/lag at production:

Overall: +40ms and -60ms audio ahead video / audio after video
Each stage: +5ms and -15ms. audio ahead video / audio after video

Recommendation of av pts time lead/lag at presentation:

TV: +15ms and -45ms. audio ahead video / audio after video.
Film: +22ms and -22ms. audio ahead video / audio after video.

Test Streams

<!--

Big Buck Bunny 24f 16:9
Big Buck Bunny	320p	h264	aac 48000Hz 2 chan	http://download.blender.org/peach/bigbuckbunny_movies/BigBuckBunny_320x180.mp4
Big Buck Bunny	240p	h264	aac 48000Hz 2 chan	http://archive.org/download/BigBuckBunny_328/BigBuckBunny_512kb.mp4
Big Buck Bunny	720p	mpeg4	ac3 48000Hz 5.1 chan	http://download.blender.org/peach/bigbuckbunny_movies/big_buck_bunny_720p_surround.avi
Big Buck Bunny	720p	msmpeg4v2	mp3 48000Hz 2 chan	http://download.blender.org/peach/bigbuckbunny_movies/big_buck_bunny_720p_stereo.avi
Big Buck Bunny	720p	theora	vorbis 48000Hz 2 chan	http://download.blender.org/peach/bigbuckbunny_movies/big_buck_bunny_720p_stereo.ogg
Big Buck Bunny	1080p	mpeg4	ac3 48000Hz 5.1 chan	http://download.blender.org/peach/bigbuckbunny_movies/big_buck_bunny_1080p_surround.avi
WebM/Matroska (vp8/vorbis)
Big Buck Bunny Trailer	640p	vp8	vorbis 44100Hz 1 chan	http://video.webmfiles.org/big-buck-bunny_trailer.webm
Elephants Dream	540p	vp8	vorbis 44100Hz 1 chan	http://video.webmfiles.org/elephants-dream.webm
You Tube http/rtsp
Sintel	http://www.youtube.com/watch?v=eRsGyueVLvQ			rtsp://v3.cache1.c.youtube.com/CiILENy73wIaGQn0LpXnygYbeRMYDSANFEgGUgZ2aWRlb3MM/0/0/0/video.3gp
Audio/Video Sync
Five-minute-sync-test1080p	https://www.youtube.com/watch?v=szoOsG9137U			rtsp://v7.cache8.c.youtube.com/CiILENy73wIaGQm133VvsA46sxMYDSANFEgGUgZ2aWRlb3MM/0/0/0/video.3gp
Audio-Video-Sync-Test-Calibration-23.98fps-24fps	https://www.youtube.com/watch?v=cGgf_dbDMsw
sound_in_sync_test	https://www.youtube.com/watch?v=O-zIZkhXNLE
title	url1			url2

Since 2.3.0 this interface uses Uri instead of URI.

Nested Class Summary

Nested Classes

Modifier and Type

Interface

Description

static interface

GLMediaPlayer.GLMediaEventListener

static enum

GLMediaPlayer.State

See Lifecycle.

static class

GLMediaPlayer.StreamException

A StreamException encapsulates a caught exception in the decoder thread, a.k.a StreamWorker, see See StreamWorker Error Handling.

Nested classes/interfaces inherited from interface com.jogamp.opengl.util.texture.TextureSequence
TextureSequence.TexSeqEventListener<T extends TextureSequence>, TextureSequence.TextureFrame
Field Summary

Fields

Modifier and Type

Field

Description

static final com.jogamp.common.net.Uri.Encoded

CameraInputScheme

Uri scheme name for camera input.

static final String

CameraPropHeight

Camera property "height".

static final String

CameraPropRate

Camera property "rate".

static final String

CameraPropSizeS

Camera property "size", size as string, e.g.

static final String

CameraPropWidth

Camera property "width".

static final boolean

DEBUG

static final boolean

DEBUG_NATIVE

static final int

MAXIMUM_VIDEO_ASYNC

Maximum video frame async of 22 milliseconds.

static final int

STREAM_ID_AUTO

Constant -1 for auto or unspecified.

static final int

STREAM_ID_NONE

Constant -2 for mute or not available.

static final int

TEXTURE_COUNT_DEFAULT

Default texture count, value 4.

static final int

TEXTURE_COUNT_MIN

Minimum texture count, value 1.

Fields inherited from interface com.jogamp.opengl.util.texture.TextureSequence
sampler2D, samplerExternalOES
Method Summary

Modifier and Type

Method

Description

void

addEventListener(GLMediaPlayer.GLMediaEventListener l)

Adds a GLMediaPlayer.GLMediaEventListener to this player.

Object

attachObject(String name, Object obj)

Attaches the user object for the given name.

GLMediaPlayer.State

destroy(GL gl)

Releases the GL, stream and other resources, including attached user objects.

Object

detachObject(String name)

Detaches the user object for the given name.

int

getAID()

Return the audio stream id, see audio and video Stream IDs.

Object

getAttachedObject(String name)

Returns the attached user object for the given name.

int

getAudioBitrate()

Warning: Optional information, may not be supported by implementation.

String

getAudioCodec()

Warning: Optional information, may not be supported by implementation.

int

getAudioFrames()

Warning: Optional information, may not be supported by implementation.

int

getAudioPTS()

AudioSink

getAudioSink()

If implementation uses a AudioSink, it's instance will be returned.

float

getAudioVolume()

Returns the audio volume.

int

getDecodedFrameCount()

int

getDuration()

GLMediaPlayer.GLMediaEventListener[]

getEventListeners()

Return all GLMediaPlayer.GLMediaEventListener of this player.

float

getFramerate()

Warning: Optional information, may not be supported by implementation.

int

getHeight()

Returns the height of the video.

TextureSequence.TextureFrame

getLastTexture()

Returns the last updated texture.

TextureSequence.TextureFrame

getNextTexture(GL gl)

Returns the next texture to be rendered.

String

getPerfString()

Returns a string represantation of this player's performance values.

float

getPlaySpeed()

Returns the playback speed.

int

getPresentedFrameCount()

GLMediaPlayer.State

getState()

See Lifecycle.

long

getStreamBitrate()

Warning: Optional information, may not be supported by implementation.

GLMediaPlayer.StreamException

getStreamException()

Returns the GLMediaPlayer.StreamException caught in the decoder thread, or null if none occured.

int

getTextureCount()

com.jogamp.common.net.Uri

getUri()

Return the stream location, as set by initStream(Uri, int, int, int).

int

getVID()

Return the video stream id, see audio and video Stream IDs.

int

getVideoBitrate()

Warning: Optional information, may not be supported by implementation.

String

getVideoCodec()

Warning: Optional information, may not be supported by implementation.

int

getVideoFrames()

Warning: Optional information, may not be supported by implementation.

int

getVideoPTS()

int

getWidth()

Returns the width of the video.

void

initGL(GL gl)

Initializes OpenGL related resources.

void

initStream(com.jogamp.common.net.Uri streamLoc, int vid, int aid, int textureCount)

Issues asynchronous stream initialization.

boolean

isGLOriented()

Returns true if the video frame is oriented in OpenGL's coordinate system, origin at bottom left.

GLMediaPlayer.State

pause(boolean flush)

Pauses the StreamWorker decoding thread.

GLMediaPlayer.State

play()

Starts or resumes the StreamWorker decoding thread.

void

removeEventListener(GLMediaPlayer.GLMediaEventListener l)

Removes a GLMediaPlayer.GLMediaEventListener to this player.

int

seek(int msec)

Seeks to the new absolute position.

boolean

setAudioVolume(float v)

Sets the audio volume, [0f..1f].

boolean

setPlaySpeed(float rate)

Sets the playback speed.

void

setTextureMinMagFilter(int[] minMagFilter)

Sets the texture min-mag filter, defaults to GL.GL_NEAREST.

void

setTextureUnit(int u)

Sets the texture unit.

void

setTextureWrapST(int[] wrapST)

Sets the texture min-mag filter, defaults to GL.GL_CLAMP_TO_EDGE.

String

toString()

Returns a string represantation of this player, incl.

Methods inherited from interface com.jogamp.opengl.util.texture.TextureSequence
getRequiredExtensionsShaderStub, getTextureFragmentShaderHashCode, getTextureLookupFragmentShaderImpl, getTextureLookupFunctionName, getTextureMinMagFilter, getTextureSampler2DType, getTextureTarget, getTextureUnit, getTextureWrapST, isTextureAvailable

Field Details
- DEBUG
  
  static final boolean DEBUG
- DEBUG_NATIVE
  
  static final boolean DEBUG_NATIVE
- TEXTURE_COUNT_DEFAULT
  
  static final int TEXTURE_COUNT_DEFAULT
  
  Default texture count, value 4.
  See Also:
  
  Constant Field Values
- TEXTURE_COUNT_MIN
  
  static final int TEXTURE_COUNT_MIN
  
  Minimum texture count, value 1. Using the minimum texture count disables multi-threaded decoding.
  See Also:
  
  Constant Field Values
- STREAM_ID_NONE
  
  static final int STREAM_ID_NONE
  
  Constant -2 for mute or not available. See Audio and video Stream IDs.
  See Also:
  
  Constant Field Values
- STREAM_ID_AUTO
  
  static final int STREAM_ID_AUTO
  
  Constant -1 for auto or unspecified. See Audio and video Stream IDs.
  See Also:
  
  Constant Field Values
- CameraInputScheme
  
  static final com.jogamp.common.net.Uri.Encoded CameraInputScheme
  Uri scheme name for camera input. E.g. camera:/0 for the 1st camera device.
  The Uri path is being used to identify the camera (<id>), where the root fwd-slash is being cut-off.
  
  The <id> is usually an integer value indexing the camera ranging from [0..max-number].
  
  The <somewhere> is usually empty, since it would imply a networking camera protocol.
  
  The Uri query is used to pass options to the camera using ; as the separator. The latter avoids trouble w/ escaping.
  
  camera:/<id> camera:/<id>?width=640;height=480;rate=15 camera:/<id>?size=640x480;rate=15 camera://<somewhere>/<id> camera://<somewhere>/<id>?width=640;height=480;rate=15 camera://<somewhere>/<id>?size=640x480;rate=15 camera:///<id>?width=640;height=480;rate=15 camera:///<id>?size=640x480;rate=15
  
  Uri: [scheme:][//authority][path][?query][#fragment] w/ authority: [user-info@]host[:port] Note: 'path' starts w/ fwd slash
- CameraPropSizeS
  
  static final String CameraPropSizeS
  
  Camera property "size", size as string, e.g. 1280x720, hd720. May not be supported on all platforms. See CameraInputScheme.
  See Also:
  
  Constant Field Values
- CameraPropWidth
  
  static final String CameraPropWidth
  
  Camera property "width". See CameraInputScheme.
  See Also:
  
  Constant Field Values
- CameraPropHeight
  
  static final String CameraPropHeight
  
  Camera property "height". See CameraInputScheme.
  See Also:
  
  Constant Field Values
- CameraPropRate
  
  static final String CameraPropRate
  
  Camera property "rate". See CameraInputScheme.
  See Also:
  
  Constant Field Values
- MAXIMUM_VIDEO_ASYNC
  
  static final int MAXIMUM_VIDEO_ASYNC
  
  Maximum video frame async of 22 milliseconds.
  See Also:
  
  Constant Field Values
Method Details
- getTextureCount
  
  int getTextureCount()
- setTextureUnit
  
  void setTextureUnit(int u)
  
  Sets the texture unit. Defaults to 0.
- setTextureMinMagFilter
  
  void setTextureMinMagFilter(int[] minMagFilter)
  
  Sets the texture min-mag filter, defaults to GL.GL_NEAREST.
- setTextureWrapST
  
  void setTextureWrapST(int[] wrapST)
  
  Sets the texture min-mag filter, defaults to GL.GL_CLAMP_TO_EDGE.
- initStream
  
  void initStream(com.jogamp.common.net.Uri streamLoc, int vid, int aid, int textureCount) throws IllegalStateException, IllegalArgumentException
  
  Issues asynchronous stream initialization.
  Lifecycle: GLMediaPlayer.State.Uninitialized -> GLMediaPlayer.State.Initialized¹ or GLMediaPlayer.State.Uninitialized
  
  GLMediaPlayer.State.Initialized is reached asynchronous, i.e. user gets notified via attributesChanges(..).
  
  A possible caught asynchronous GLMediaPlayer.StreamException while initializing the stream off-thread will be thrown at initGL(GL).
  
  Muted audio can be achieved by passing STREAM_ID_NONE to aid.
  
  Muted video can be achieved by passing STREAM_ID_NONE to vid, in which case textureCount is ignored as well as the passed GL object of the subsequent initGL(GL) call.
  
  Parameters:
  
  streamLoc - the stream location
  
  vid - video stream id, see audio and video Stream IDs
  
  aid - video stream id, see audio and video Stream IDs
  
  textureCount - desired number of buffered textures to be decoded off-thread, will be validated by implementation. The minimum value is TEXTURE_COUNT_DEFAULT. Ignored if video is muted.
  
  Throws:
  
  IllegalStateException - if not invoked in GLMediaPlayer.State.Uninitialized
  
  IllegalArgumentException - if arguments are invalid
  
  Since:
  
  2.3.0
- getStreamException
  
  GLMediaPlayer.StreamException getStreamException()
  
  Returns the GLMediaPlayer.StreamException caught in the decoder thread, or null if none occured.
  Method clears the cached GLMediaPlayer.StreamException, hence an immediate subsequent call will return null.
  See Also:
  
  GLMediaPlayer.GLMediaEventListener.EVENT_CHANGE_ERR
  
  GLMediaPlayer.StreamException
- initGL
  
  void initGL(GL gl) throws IllegalStateException, GLMediaPlayer.StreamException, GLException
  
  Initializes OpenGL related resources.
  Lifecycle: GLMediaPlayer.State.Initialized -> GLMediaPlayer.State.Paused or GLMediaPlayer.State.Initialized
  Argument gl is ignored if video is muted, see initStream(Uri, int, int, int).
  
  Parameters:
  
  gl - current GL object. Maybe null, for audio only.
  
  Throws:
  
  IllegalStateException - if not invoked in GLMediaPlayer.State.Initialized.
  
  GLMediaPlayer.StreamException - forwarded from the off-thread stream initialization
  
  GLException - in case of difficulties to initialize the GL resources
- getAudioSink
  
  AudioSink getAudioSink()
  
  If implementation uses a AudioSink, it's instance will be returned.
  The AudioSink instance is available after initStream(Uri, int, int, int), if used by implementation.
- destroy
  
  GLMediaPlayer.State destroy(GL gl)
  
  Releases the GL, stream and other resources, including attached user objects.
  Lifecycle: ANY -> GLMediaPlayer.State.Uninitialized
- setPlaySpeed
  
  boolean setPlaySpeed(float rate)
  Sets the playback speed.
  To simplify test, play speed is normalized, i.e.
  
  1.0f: if Math.abs(1.0f - rate) < 0.01f
  Returns:
  
  true if successful, otherwise false, i.e. due to unsupported value range of implementation.
- getPlaySpeed
  
  float getPlaySpeed()
  
  Returns the playback speed.
- setAudioVolume
  
  boolean setAudioVolume(float v)
  Sets the audio volume, [0f..1f].
  To simplify test, volume is normalized, i.e.
  
  0.0f: if Math.abs(v) < 0.01f
  
  1.0f: if Math.abs(1.0f - v) < 0.01f
  Returns:
  
  true if successful, otherwise false, i.e. due to unsupported value range of implementation.
- getAudioVolume
  
  float getAudioVolume()
  
  Returns the audio volume.
- play
  
  GLMediaPlayer.State play()
  
  Starts or resumes the StreamWorker decoding thread.
  Lifecycle: GLMediaPlayer.State.Paused -> GLMediaPlayer.State.Playing
- pause
  
  GLMediaPlayer.State pause(boolean flush)
  
  Pauses the StreamWorker decoding thread.
  Lifecycle: GLMediaPlayer.State.Playing -> GLMediaPlayer.State.Paused
  
  If a new frame is desired after the next play() call, e.g. to make a snapshot of a camera input stream, flush shall be set to true.
  
  Parameters:
  
  flush - if true flushes the video and audio buffers, otherwise keep them intact.
- seek
  
  int seek(int msec)
  
  Seeks to the new absolute position. The StreamWorker decoding thread is paused while doing so and the A/V buffers are flushed.
  Allowed in state GLMediaPlayer.State.Playing and GLMediaPlayer.State.Paused, otherwise ignored, see Lifecycle.
  
  Parameters:
  
  msec - absolute desired time position in milliseconds
  
  Returns:
  
  time current position in milliseconds, after seeking to the desired position
- getState
  
  GLMediaPlayer.State getState()
  
  See Lifecycle.
  
  Returns:
  
  the current state, either GLMediaPlayer.State.Uninitialized, GLMediaPlayer.State.Initialized, GLMediaPlayer.State.Playing or GLMediaPlayer.State.Paused
- getVID
  
  int getVID()
  
  Return the video stream id, see audio and video Stream IDs.
- getAID
  
  int getAID()
  
  Return the audio stream id, see audio and video Stream IDs.
- getDecodedFrameCount
  
  int getDecodedFrameCount()
  
  Returns:
  
  the current decoded frame count since play() and seek(int) as increased by getNextTexture(GL) or the decoding thread.
- getPresentedFrameCount
  
  int getPresentedFrameCount()
  
  Returns:
  
  the current presented frame count since play() and seek(int) as increased by getNextTexture(GL) for new frames.
- getVideoPTS
  
  int getVideoPTS()
  
  Returns:
  
  current video presentation timestamp (PTS) in milliseconds of getLastTexture()
- getAudioPTS
  
  int getAudioPTS()
  
  Returns:
  
  current audio presentation timestamp (PTS) in milliseconds.
- getLastTexture
  
  TextureSequence.TextureFrame getLastTexture() throws IllegalStateException
  
  Returns the last updated texture.
  In case the instance is just initialized, it shall return a TextureFrame object with valid attributes. The texture content may be undefined until the first call of TextureSequence.getNextTexture(GL).
  
  Not blocking.
  See audio and video synchronization.
  
  Specified by:
  
  getLastTexture in interface TextureSequence
  
  Throws:
  
  IllegalStateException - if not invoked in GLMediaPlayer.State.Paused or GLMediaPlayer.State.Playing
- getNextTexture
  
  TextureSequence.TextureFrame getNextTexture(GL gl) throws IllegalStateException
  
  Returns the next texture to be rendered.
  Implementation shall return the next frame if available, may block if a next frame may arrive soon. Otherwise implementation shall return the last frame.
  
  Shall return null in case no next or last frame is available.
  
  In case the current state is not GLMediaPlayer.State.Playing, getLastTexture() is returned.
  
  See audio and video synchronization.
  Specified by:
  
  getNextTexture in interface TextureSequence
  
  Throws:
  
  IllegalStateException - if not invoked in GLMediaPlayer.State.Paused or GLMediaPlayer.State.Playing
  
  See Also:
  
  addEventListener(GLMediaEventListener)
  
  GLMediaEventListener#newFrameAvailable(GLMediaPlayer, TextureFrame, long)
- getUri
  
  com.jogamp.common.net.Uri getUri()
  
  Return the stream location, as set by initStream(Uri, int, int, int).
  
  Since:
  
  2.3.0
- getVideoCodec
  
  String getVideoCodec()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the code of the video stream, if available
- getAudioCodec
  
  String getAudioCodec()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the code of the audio stream, if available
- getVideoFrames
  
  int getVideoFrames()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the total number of video frames
- getAudioFrames
  
  int getAudioFrames()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the total number of audio frames
- getDuration
  
  int getDuration()
  
  Returns:
  
  total duration of stream in msec.
- getStreamBitrate
  
  long getStreamBitrate()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the overall bitrate of the stream.
- getVideoBitrate
  
  int getVideoBitrate()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  video bitrate
- getAudioBitrate
  
  int getAudioBitrate()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the audio bitrate
- getFramerate
  
  float getFramerate()
  
  Warning: Optional information, may not be supported by implementation.
  
  Returns:
  
  the framerate of the video
- isGLOriented
  
  boolean isGLOriented()
  
  Returns true if the video frame is oriented in OpenGL's coordinate system, origin at bottom left.
  Otherwise returns false, i.e. video frame is oriented origin at top left.
  
  false is the default assumption for videos, but user shall not rely on.
  
  false GL orientation leads to Texture.getMustFlipVertically() == true, as reflected by all TextureSequence.TextureFrame's Textures retrieved via getLastTexture() or getNextTexture(GL).
- getWidth
  
  int getWidth()
  
  Returns the width of the video.
- getHeight
  
  int getHeight()
  
  Returns the height of the video.
- toString
  
  String toString()
  
  Returns a string represantation of this player, incl. state and audio/video details.
  
  Overrides:
  
  toString in class Object
- getPerfString
  
  String getPerfString()
  
  Returns a string represantation of this player's performance values.
- addEventListener
  
  void addEventListener(GLMediaPlayer.GLMediaEventListener l)
  
  Adds a GLMediaPlayer.GLMediaEventListener to this player.
- removeEventListener
  
  void removeEventListener(GLMediaPlayer.GLMediaEventListener l)
  
  Removes a GLMediaPlayer.GLMediaEventListener to this player.
- getEventListeners
  
  GLMediaPlayer.GLMediaEventListener[] getEventListeners()
  
  Return all GLMediaPlayer.GLMediaEventListener of this player.
- getAttachedObject
  
  Object getAttachedObject(String name)
  
  Returns the attached user object for the given name.
- attachObject
  
  Object attachObject(String name, Object obj)
  
  Attaches the user object for the given name. Returns the previously set object, may be null.
- detachObject
  
  Object detachObject(String name)
  
  Detaches the user object for the given name. Returns the previously set object, may be null.

Interface GLMediaPlayer

StreamWorker Decoding Thread

GLMediaPlayer Lifecycle

Audio and video Stream IDs

Timestamp Accuracy

Audio and video synchronization

Test Streams

Nested Class Summary

Nested classes/interfaces inherited from interface com.jogamp.opengl.util.texture.TextureSequence

Field Summary

Fields inherited from interface com.jogamp.opengl.util.texture.TextureSequence

Method Summary

Methods inherited from interface com.jogamp.opengl.util.texture.TextureSequence

Field Details

DEBUG

DEBUG_NATIVE

TEXTURE_COUNT_DEFAULT

TEXTURE_COUNT_MIN

STREAM_ID_NONE

STREAM_ID_AUTO

CameraInputScheme

CameraPropSizeS

CameraPropWidth

CameraPropHeight

CameraPropRate

MAXIMUM_VIDEO_ASYNC

Method Details

getTextureCount

setTextureUnit

setTextureMinMagFilter

setTextureWrapST

initStream

getStreamException

initGL

getAudioSink

destroy

setPlaySpeed

getPlaySpeed

setAudioVolume

getAudioVolume

play

pause

seek

getState

getVID

getAID

getDecodedFrameCount

getPresentedFrameCount

getVideoPTS

getAudioPTS

getLastTexture

getNextTexture

getUri

getVideoCodec

getAudioCodec

getVideoFrames

getAudioFrames

getDuration

getStreamBitrate

getVideoBitrate

getAudioBitrate

getFramerate

isGLOriented

getWidth

getHeight

toString

getPerfString

addEventListener

removeEventListener

getEventListeners

getAttachedObject

attachObject

detachObject