Fix for Bug338162

[deliverable/tracecompass.git] / org.eclipse.linuxtools.tmf / src / org / eclipse / linuxtools / tmf / trace / ITmfTrace.java

diff --git a/org.eclipse.linuxtools.tmf/src/org/eclipse/linuxtools/tmf/trace/ITmfTrace.java b/org.eclipse.linuxtools.tmf/src/org/eclipse/linuxtools/tmf/trace/ITmfTrace.java
index 6afae45b7f1acc7b75878b95fb78b3efb45a076b..5a3de536de077dae6babcc38c59c5200e85433de 100644 (file)
--- a/org.eclipse.linuxtools.tmf/src/org/eclipse/linuxtools/tmf/trace/ITmfTrace.java
+++ b/org.eclipse.linuxtools.tmf/src/org/eclipse/linuxtools/tmf/trace/ITmfTrace.java
@@ -67,6 +67,26 @@ public interface ITmfTrace extends ITmfComponent {
     public TmfContext seekEvent(TmfTimestamp timestamp);
     public TmfContext seekEvent(long rank);
 
+    /**
+     * Positions the trace at the event located at the specified ratio.
+     * 
+     * Returns a context which can later be used to read the event.
+     * 
+     * @param ratio a floating-point number between 0.0 (beginning) and 1.0 (end)
+     * @return a context object for subsequent reads
+     */
+    public TmfContext seekLocation(double ratio);
+    
+    /**
+     * Returns the ratio corresponding to the specified location.
+     * 
+     * @param location a trace location
+     * @return a floating-point number between 0.0 (beginning) and 1.0 (end)
+     */
+    public double getLocationRatio(ITmfLocation<?> location);
+    
+    public ITmfLocation<?> getCurrentLocation();
+
     /**
      * Returns the rank of the first event with the requested timestamp.
      * If none, returns the index of the next event (if any).