Module simple_3dviz.behaviours.movements

Expand source code
import numpy as np

from . import Behaviour


class RotateModel(Behaviour):
    """Rotate all the models around an axis with a given speed (radians per
    tick).
    
    Arguments
    ---------
        axis: {'x', 'y', 'z'}
        speed: float, radians per tick
    """
    def __init__(self, axis='z', speed=np.pi/90):
        self._function = dict(
            x=lambda s, a: s.rotate_x(a),
            y=lambda s, a: s.rotate_y(a),
            z=lambda s, a: s.rotate_z(a)
        )[axis]
        self._speed = speed

    def behave(self, params):
        self._function(params.scene, self._speed)
        params.refresh = True


class LocalModelRotation(Behaviour):
    """Use a per renderable model matrix to rotate the models if available.
    
    Arguments
    ---------
        axis: array-like (3,) the axis around which to rotate
        speed: float, radians per tick
    """
    def __init__(self, axis=[0, 0, 1.], speed=np.pi/90):
        self._axis = axis
        self._speed = speed

    def behave(self, params):
        refresh = False
        for r in params.scene.renderables:
            if hasattr(r, "rotate_axis"):
                r.rotate_axis(self._axis, self._speed)
                refresh = True
        params.refresh = refresh


class RotateRenderables(Behaviour):
    """Rotate specific renderables in the scene.

    Arguments
    ---------
        renderables: List of renderables to be rotated
        axis: array-like (3,) the axis around which to rotate
        speed: float, radians per tick
    """
    def __init__(self, renderables, axis=[0, 0, 1.], speed=np.pi/90):
        self.renderables = renderables
        self._axis = axis
        self._speed = speed

    def behave(self, params):
        for r in self.renderables:
            r.rotate_axis(self._axis, self._speed)
        params.refresh = True


class _TrajectoryMovement(Behaviour):
    """Abstract class that implements adjusting a quantity based on a passed
    trajectory.

    Arguments
    ---------
        trajectory: The Trajectory object that provides values
        speed: percentage of completion per tick
    """
    def __init__(self, trajectory, speed=0.01):
        self._trajectory = trajectory
        self._speed = speed
        self._t = 0.0

    def behave(self, params):
        v = self._trajectory.get_value(self._t)
        self._t += self._speed
        self._adjust(params, v)

    def _adjust(self, params, v):
        raise NotImplementedError()


class RenderableOffset(_TrajectoryMovement):
    """Move a renderable by adjusting their offset property.

    Arguments
    ---------
        renderable: A renderable to be moved
        trajectory: The Trajectory object that provides values
        speed: percentage of completion per tick
    """
    def __init__(self, renderable, trajectory, speed=0.01):
        super().__init__(trajectory, speed)
        self.renderable = renderable

    def _adjust(self, params, v):
        self.renderable.offset = v
        params.refresh = True


class CameraTrajectory(_TrajectoryMovement):
    """Move the camera along a trajectory."""
    def _adjust(self, params, v):
        params.scene.camera_position = v
        params.refresh = True


class CameraTargetTrajectory(_TrajectoryMovement):
    """Move the camera target along a trajectory."""
    def _adjust(self, params, v):
        params.scene.camera_target = v
        params.refresh = True


class LightTrajectory(_TrajectoryMovement):
    """Move the light along a trajectory."""
    def _adjust(self, params, v):
        params.scene.light = v
        params.refresh = True

Classes

class CameraTargetTrajectory (trajectory, speed=0.01)

Move the camera target along a trajectory.

Expand source code
class CameraTargetTrajectory(_TrajectoryMovement):
    """Move the camera target along a trajectory."""
    def _adjust(self, params, v):
        params.scene.camera_target = v
        params.refresh = True

Ancestors

  • simple_3dviz.behaviours.movements._TrajectoryMovement
  • Behaviour

Inherited members

class CameraTrajectory (trajectory, speed=0.01)

Move the camera along a trajectory.

Expand source code
class CameraTrajectory(_TrajectoryMovement):
    """Move the camera along a trajectory."""
    def _adjust(self, params, v):
        params.scene.camera_position = v
        params.refresh = True

Ancestors

  • simple_3dviz.behaviours.movements._TrajectoryMovement
  • Behaviour

Inherited members

class LightTrajectory (trajectory, speed=0.01)

Move the light along a trajectory.

Expand source code
class LightTrajectory(_TrajectoryMovement):
    """Move the light along a trajectory."""
    def _adjust(self, params, v):
        params.scene.light = v
        params.refresh = True

Ancestors

  • simple_3dviz.behaviours.movements._TrajectoryMovement
  • Behaviour

Inherited members

class LocalModelRotation (axis=[0, 0, 1.0], speed=0.03490658503988659)

Use a per renderable model matrix to rotate the models if available.

Arguments

axis: array-like (3,) the axis around which to rotate
speed: float, radians per tick
Expand source code
class LocalModelRotation(Behaviour):
    """Use a per renderable model matrix to rotate the models if available.
    
    Arguments
    ---------
        axis: array-like (3,) the axis around which to rotate
        speed: float, radians per tick
    """
    def __init__(self, axis=[0, 0, 1.], speed=np.pi/90):
        self._axis = axis
        self._speed = speed

    def behave(self, params):
        refresh = False
        for r in params.scene.renderables:
            if hasattr(r, "rotate_axis"):
                r.rotate_axis(self._axis, self._speed)
                refresh = True
        params.refresh = refresh

Ancestors

Inherited members

class RenderableOffset (renderable, trajectory, speed=0.01)

Move a renderable by adjusting their offset property.

Arguments

renderable: A renderable to be moved
trajectory: The Trajectory object that provides values
speed: percentage of completion per tick
Expand source code
class RenderableOffset(_TrajectoryMovement):
    """Move a renderable by adjusting their offset property.

    Arguments
    ---------
        renderable: A renderable to be moved
        trajectory: The Trajectory object that provides values
        speed: percentage of completion per tick
    """
    def __init__(self, renderable, trajectory, speed=0.01):
        super().__init__(trajectory, speed)
        self.renderable = renderable

    def _adjust(self, params, v):
        self.renderable.offset = v
        params.refresh = True

Ancestors

  • simple_3dviz.behaviours.movements._TrajectoryMovement
  • Behaviour

Inherited members

class RotateModel (axis='z', speed=0.03490658503988659)

Rotate all the models around an axis with a given speed (radians per tick).

Arguments

axis: {'x', 'y', 'z'}
speed: float, radians per tick
Expand source code
class RotateModel(Behaviour):
    """Rotate all the models around an axis with a given speed (radians per
    tick).
    
    Arguments
    ---------
        axis: {'x', 'y', 'z'}
        speed: float, radians per tick
    """
    def __init__(self, axis='z', speed=np.pi/90):
        self._function = dict(
            x=lambda s, a: s.rotate_x(a),
            y=lambda s, a: s.rotate_y(a),
            z=lambda s, a: s.rotate_z(a)
        )[axis]
        self._speed = speed

    def behave(self, params):
        self._function(params.scene, self._speed)
        params.refresh = True

Ancestors

Inherited members

class RotateRenderables (renderables, axis=[0, 0, 1.0], speed=0.03490658503988659)

Rotate specific renderables in the scene.

Arguments

renderables: List of renderables to be rotated
axis: array-like (3,) the axis around which to rotate
speed: float, radians per tick
Expand source code
class RotateRenderables(Behaviour):
    """Rotate specific renderables in the scene.

    Arguments
    ---------
        renderables: List of renderables to be rotated
        axis: array-like (3,) the axis around which to rotate
        speed: float, radians per tick
    """
    def __init__(self, renderables, axis=[0, 0, 1.], speed=np.pi/90):
        self.renderables = renderables
        self._axis = axis
        self._speed = speed

    def behave(self, params):
        for r in self.renderables:
            r.rotate_axis(self._axis, self._speed)
        params.refresh = True

Ancestors

Inherited members