root/trunk/RBRapier/RBRapier/Tools/Animation/__init__.py

#!/usr/bin/env python
##~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
##~ License 
##~ 
##- The RuneBlade Foundation library is intended to ease some 
##- aspects of writing intricate Jabber, XML, and User Interface (wxPython, etc.) 
##- applications, while providing the flexibility to modularly change the 
##- architecture. Enjoy.
##~ 
##~ Copyright (C) 2002  TechGame Networks, LLC.
##~ 
##~ This library is free software; you can redistribute it and/or
##~ modify it under the terms of the BSD style License as found in the 
##~ LICENSE file included with this distribution.
##~ 
##~ TechGame Networks, LLC can be reached at:
##~ 3578 E. Hartsel Drive #211
##~ Colorado Springs, Colorado, USA, 80920
##~
##~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#~ Imports 
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

import time

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#~ Definitions 
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

class BlendBase(object):
    pass

class TimeBlendBase(BlendBase):
    def now(klass):
        return time.clock()
    now = classmethod(now)

    def __call__(self):
        return 0.

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

class TimeBlend(TimeBlendBase):
    def __init__(self, start, end):
        self.SetRange(start, end)

    def __call__(self):
        (s, e), n = self.timespan, self.now()
        value = (n-s)/(e-s)
        return max(min(value, 1.), 0.)

    def SetSpan(self, span):
        s = self.timespan[0]
        self.timespan = s, s+span
    def fromSpan(klass, span):
        n = klass.now()
        return klass(n, n+span)
    fromSpan = classmethod(fromSpan)

    def SetRange(self, start, end, relative=False):
        if relative: 
            now = self.now()
            start += now
            end += now
        self.timespan = start, end
    def fromTimeRange(klass, start, end, relative=False):
        if relative: 
            now = klass.now()
            start += now
            end += now
        return klass(start, end)
    fromTimeRange = classmethod(fromTimeRange)

    def SetTimeSpan(self, start, end, relative=False):
        if relative: 
            start += self.now()
        self.timespan = start, start+span
    def fromTimeSpan(klass, start, span, relative=False):
        if relative: 
            start += klass.now()
        return klass(start, start+span)
    fromTimeSpan = classmethod(fromTimeSpan)

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

class TimeOscillation(TimeBlendBase):
    def __init__(self, period=1, start=None):
        self.SetOscillation(period, start)

    def __call__(self):
        s, p, n = self.start, self.period, self.now()
        value = abs(((n-s)%p)/(.5*p) - 1.)
        return max(min(value, 1.), 0.)

    def SetOscillation(self, period=1., start=None):
        self.SetPeriod(period)
        self.SetStart(start)

    def SetStart(self, start=None):
        if start is None:
            self.start = self.now()
        else: self.start = start

    def SetPeriod(self, period=1.):
        self.period = period