Behold, Nenya, Ring of Water and repository for our media and animation related

goodies, both Java 2D and LWJGL/JME 3D.


git-svn-id: svn+ssh://src.earth.threerings.net/nenya/trunk@1 ed5b42cb-e716-0410-a449-f6a68f950b19
This commit is contained in:
Michael Bayne
2006-06-23 18:07:28 +00:00
commit c2117ee86d
570 changed files with 61913 additions and 0 deletions
@@ -0,0 +1,52 @@
//
// $Id: MediaTimer.java 4191 2006-06-13 22:42:20Z ray $
//
// Narya library - tools for developing networked games
// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
// http://www.threerings.net/code/narya/
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package com.threerings.media.timer;
/**
* Provides a pluggable mechanism for delivering high resolution timing
* information. The timers are not intended to be used by different
* threads and thus must be protected by synchronization in such
* circumstances.
*/
public interface MediaTimer
{
/**
* Resets the timer's monotonically increasing value.
*/
public void reset ();
/**
* Returns the number of milliseconds that have elapsed since the
* timer was created or last {@link #reset}. <em>Note:</em> the
* accuracy of this method is highly dependent on the timer
* implementation used.
*/
public long getElapsedMillis ();
/**
* Returns the number of microseconds that have elapsed since the
* timer was created or last {@link #reset}. <em>Note:</em> the
* accuracy of this method is highly dependent on the timer
* implementation used.
*/
public long getElapsedMicros ();
}
@@ -0,0 +1,69 @@
//
// $Id: PerfTimer.java 4191 2006-06-13 22:42:20Z ray $
//
// Narya library - tools for developing networked games
// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
// http://www.threerings.net/code/narya/
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package com.threerings.media.timer;
import sun.misc.Perf;
import com.threerings.media.Log;
/**
* A timer that uses the performance clock exposed by Sun in JDK 1.4.2.
*/
public class PerfTimer implements MediaTimer
{
public PerfTimer ()
{
_timer = Perf.getPerf();
_mfrequency = _timer.highResFrequency() / 1000;
_ufrequency = _timer.highResFrequency() / 1000000;
_startStamp = _timer.highResCounter();
Log.info("Using high performance timer [mfreq=" + _mfrequency +
", ufreq=" + _ufrequency + ", start=" + _startStamp + "].");
}
// documentation inherited from interface
public void reset ()
{
_startStamp = _timer.highResCounter();
}
// documentation inherited from interface
public long getElapsedMillis ()
{
return (_timer.highResCounter() - _startStamp) / _mfrequency;
}
// documentation inherited from interface
public long getElapsedMicros ()
{
return (_timer.highResCounter() - _startStamp) / _ufrequency;
}
/** A performance timer object. */
protected Perf _timer;
/** The time at which this timer was last reset. */
protected long _startStamp;
/** The timer frequencies. */
protected long _mfrequency, _ufrequency;
}
@@ -0,0 +1,60 @@
//
// $Id: SystemMediaTimer.java 4191 2006-06-13 22:42:20Z ray $
//
// Narya library - tools for developing networked games
// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
// http://www.threerings.net/code/narya/
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package com.threerings.media.timer;
/**
* Implements the {@link MediaTimer} interface using {@link
* System#currentTimeMillis} to obtain timing information.
*
* <p> <em>Note:</em> {@link System#currentTimeMillis} is notoriously
* inaccurate on different platforms. See <a
* href="http://developer.java.sun.com/developer/bugParade/bugs/4486109.html">
* bug report 4486109</a> for more information.
*
* <p> <em>Also note:</em> clock drift on Windows XP is especially
* pronounced and is exacerbated by the fact that WinXP periodically
* resyncs the system clock with the hardware clock, causing discontinuous
* jumps in the progression of time (usually backwards in time).
*/
public class SystemMediaTimer implements MediaTimer
{
// documentation inherited from interface
public void reset ()
{
_resetStamp = System.currentTimeMillis();
}
// documentation inherited from interface
public long getElapsedMillis ()
{
return System.currentTimeMillis() - _resetStamp;
}
// documentation inherited from interface
public long getElapsedMicros ()
{
return getElapsedMillis() * 10;
}
/** The time at which this timer was last reset. */
protected long _resetStamp = System.currentTimeMillis();
}