Added SimTime.getUnlockedTime() for those rare occasions

when code needs to know the "real" time and not the current
frame time.

Author: pspeed42

build.gradle

@@ -14,7 +14,7 @@ buildscript {
 apply plugin: 'java'
 apply plugin: 'maven'
 
-version='1.2.0'
+version='1.2.0-SNAPSHOT'
 group='com.simsilica'
 
 ext.jmeVersion = "3.2.1-stable" 

release-notes.md

@@ -1,5 +1,5 @@
 
-Version 1.2.0 (latest)
+Version 1.2.0 (unreleased)
 --------------
 * Fixed a SimTime initialization problem where the first tpf would be
     huge.
@@ -30,6 +30,8 @@ Version 1.2.0 (latest)
     that game time begins counting from the first frame.
 * Fixed an NPE in CompositeAppState.addChild() when called after the outer state is
     attached but before it was initialized.  See PR #5.
+* Added SimTime.getUnlockedTime() which will return a SimTime-translated time
+    between frames, ie: not frame locked.    
 * Set sourceCompatibility to 1.7 and turned on detailed 'unchecked' warnings
 * Suppressed 'unchecked' warnings in some methods of EntityContainer, EventBus,
     and DecaySystem where it is known that the operations are safe or safe-ish,

src/main/java/com/simsilica/sim/SimTime.java

@@ -64,6 +64,19 @@ public void update( long time ) {
         this.time = time;
     }
 
+    /**
+     *  Returns the SimTime version of the specified timestamp that
+     *  is compatible with what would normally be provided to update().
+     *  SimTime.getTime() will provide 'frame locked' timestamps that will
+     *  not update during a frame which is what the systems will want 99.99%
+     *  of the time.  Rarely it is desirable to get a "real" timestamp that 
+     *  is not locked to frames, usually as part of providing matching accurate
+     *  timesource information to something else that is trying to synch.
+     */   
+    public long getUnlockedTime( long time ) {
+        return time - baseTime;
+    }
+ 
     public long toSimTime( double seconds ) {
         return (long)(seconds * invTimeScale);
     }