From ee29eaf770d0d3627e5989dcae58a87cf27184d3 Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Mon, 16 Oct 2023 04:03:24 +0200
Subject: Bug 1472: GLMediaPlayer: Expose SCR PTS and encourage its usage,
removes user from selecting video or audio PTS.
---
.../com/jogamp/opengl/util/av/GLMediaPlayer.java | 22 ++++++++++++++++++++--
1 file changed, 20 insertions(+), 2 deletions(-)
(limited to 'src/jogl/classes/com/jogamp/opengl/util/av')
diff --git a/src/jogl/classes/com/jogamp/opengl/util/av/GLMediaPlayer.java b/src/jogl/classes/com/jogamp/opengl/util/av/GLMediaPlayer.java
index e3ef27303..740d0fda8 100644
--- a/src/jogl/classes/com/jogamp/opengl/util/av/GLMediaPlayer.java
+++ b/src/jogl/classes/com/jogamp/opengl/util/av/GLMediaPlayer.java
@@ -37,8 +37,10 @@ import java.util.List;
import com.jogamp.common.av.AudioFormat;
import com.jogamp.common.av.AudioSink;
+import com.jogamp.common.av.PTS;
import com.jogamp.common.av.TimeFrameI;
import com.jogamp.common.net.Uri;
+import com.jogamp.common.os.Clock;
import com.jogamp.opengl.util.texture.Texture;
import com.jogamp.opengl.util.texture.TextureSequence;
@@ -612,23 +614,39 @@ public interface GLMediaPlayer extends TextureSequence {
*/
public int getPresentedFrameCount();
+
+ /**
+ * Returns current System Clock Reference (SCR) presentation timestamp ({@link PTS}).
+ * <p>
+ * To retrieve the current interpolated PTS against the stored System Clock Reference (SCR), use:
+ * <pre>
+ * int pts = mPlayer.getPTS().get(Clock.currentMillis());
+ * </pre>
+ * </p>
+ **/
+ public PTS getPTS();
+
/**
- * Returns current video presentation timestamp (PTS) in milliseconds of {@link #getLastTexture()}
+ * Returns current video presentation timestamp (PTS) in milliseconds of {@link #getLastTexture()},
+ * try using {@link #getPTS()}.
* <p>
* The relative millisecond PTS since start of the presentation stored in integer
* covers a time span of 2'147'483'647 ms (see {@link Integer#MAX_VALUE}
* or 2'147'483 seconds or 24.855 days.
* </p>
+ * @see #getPTS()
**/
public int getVideoPTS();
/**
- * Returns current audio presentation timestamp (PTS) in milliseconds.
+ * Returns current audio presentation timestamp (PTS) in milliseconds,
+ * try using {@link #getPTS()}.
* <p>
* The relative millisecond PTS since start of the presentation stored in integer
* covers a time span of 2'147'483'647 ms (see {@link Integer#MAX_VALUE}
* or 2'147'483 seconds or 24.855 days.
* </p>
+ * @see #getPTS()
**/
public int getAudioPTS();
--
cgit v1.2.3