diff options
Diffstat (limited to 'pilas/interpolaciones.py')
-rw-r--r-- | pilas/interpolaciones.py | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/pilas/interpolaciones.py b/pilas/interpolaciones.py new file mode 100644 index 0000000..4f52973 --- /dev/null +++ b/pilas/interpolaciones.py @@ -0,0 +1,86 @@ +# -*- encoding: utf-8 -*- +# Pilas engine - A video game framework. +# +# Copyright 2010 - Hugo Ruscitti +# License: LGPLv3 (see http://www.gnu.org/licenses/lgpl.html) +# +# Website - http://www.pilas-engine.com.ar + +class Interpolacion(object): + """Representa una interpolacion, que pasa por varios puntos clave. + + Las interpolacione se utilizan para realizar movimientos de + actores en la pantalla. O simplemente para cambiar el + estado de un actor de un punto a otro, por ejemplo, de 0 a 360 + grados de manera gradual. + + Todo objeto de interpolaciones se puede asignar directamente a + una propiedad de un actor. Por ejemplo: + + actor.rotation = pilas.interpolations.Lineal(400) + + note que hay un atajo para usar estos objetos, es mejor + utilizar directamente una sentencias como la que sigue:: + + actor.rotation = pilas.interpolate(360) + """ + pass + + +class Lineal(Interpolacion): + "Representa una interpolación lineal." + + def __init__(self, values, duration, delay): + """Inicializa la interpolación. + + ``values`` tiene que ser una lista con todos los puntos + por los que se quiere adoptar valores y ``duration`` es la cantidad + de segundos que deben tomarse para realizar la interpolación. + """ + self.values = values + self.duration = duration + self.delay = delay + + def __neg__(self): + "Retorna la interpolación inversa a la original." + new_values = list(self.values) + new_values.reverse() + return Lineal(new_values, self.duration, self.delay) + + def apply(self, target, function): + """Aplica la interpolación a un actor usando un método. + + Esta funcionalidad se utiliza para que toda interpolación + se pueda acoplar a un actor. + + La idea es contar con la interpolación, un actor y luego + ponerla en funcionamiento:: + + mi_interpolacion.apply(mono, set_rotation) + + de esta forma los dos objetos están y seguirán estando + desacoplados.""" + + import pilas + + # Tiempo que se debe invertir para hacer cada interpolacion + # individual. + step = self.duration / float(len(self.values)) + step *= 1000.0 + + # En base a la funcion busca el getter que le dara + # el valor inicial. + getter = function.replace('set_', 'get_') + function_to_get_value = getattr(target, getter) + fist_value = function_to_get_value() + + # Le indica al objeto que tiene que hacer para cumplir + # con cada paso de la interpolacion. + for index, value in enumerate(self.values): + pilas.mundo.tweener.addTweenNoArgs(target, function=function, + initial_value=fist_value, + value=value, + tweenDelay=self.delay * 1000.0 + (index * step), + tweenTime=step) + # El siguiente valor inicial sera el que ha alcanzado. + fist_value = value |