vispy 0.15.0__cp313-cp313-macosx_11_0_arm64.whl

vispy/visuals/transforms/chain.py

@@ -0,0 +1,300 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) Vispy Development Team. All Rights Reserved.
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+
+from __future__ import division
+
+from ..shaders import FunctionChain
+from .base_transform import BaseTransform
+from .linear import NullTransform
+
+
+class ChainTransform(BaseTransform):
+    """
+    BaseTransform subclass that performs a sequence of transformations in
+    order. Internally, this class uses shaders.FunctionChain to generate
+    its glsl_map and glsl_imap functions.
+
+    Parameters
+    ----------
+    transforms : list of BaseTransform instances
+        See ``transforms`` property.
+    """
+
+    glsl_map = None
+    glsl_imap = None
+
+    Linear = False
+    Orthogonal = False
+    NonScaling = False
+    Isometric = False
+
+    def __init__(self, *transforms):
+        super(ChainTransform, self).__init__()
+        self._transforms = []
+        self._simplified = None
+        self._null_transform = NullTransform()
+        nmap = self._null_transform.shader_map()
+
+        # ChainTransform does not have shader maps
+        self._shader_map = FunctionChain("transform_map_chain", [nmap])
+        self._shader_imap = FunctionChain("transform_imap_chain", [nmap])
+
+        # Set input transforms
+        trs = []
+        for tr in transforms:
+            if isinstance(tr, (tuple, list)):
+                trs.extend(tr)
+            else:
+                trs.append(tr)
+        self.transforms = trs
+
+    @property
+    def transforms(self):
+        """The list of transform that make up the transform chain.
+
+        The order of transforms is given such that the last transform in the 
+        list is the first to be invoked when mapping coordinates through 
+        the chain. 
+
+        For example, the following two mappings are equivalent::
+
+            # Map coordinates through individual transforms:
+            trans1 = STTransform(scale=(2, 3), translate=(0, 1))
+            trans2 = PolarTransform()
+            mapped = trans1.map(trans2.map(coords))
+
+            # Equivalent mapping through chain:
+            chain = ChainTransform([trans1, trans2])
+            mapped = chain.map(coords)
+        """
+        return self._transforms
+
+    @transforms.setter
+    def transforms(self, tr):
+        if isinstance(tr, BaseTransform):
+            tr = [tr]
+        if not isinstance(tr, list):
+            raise TypeError("Transform chain must be a list")
+
+        # Avoid extra effort if we already have the correct chain
+        if len(tr) == len(self._transforms):
+            changed = False
+            for i in range(len(tr)):
+                if tr[i] is not self._transforms[i]:
+                    changed = True
+                    break
+            if not changed:
+                return
+
+        for t in self._transforms:
+            t.changed.disconnect(self._subtr_changed)
+        self._transforms = tr
+        for t in self._transforms:
+            t.changed.connect(self._subtr_changed)
+        self._rebuild_shaders()
+        self.update()
+
+    @property
+    def simplified(self):
+        """A simplified representation of the same transformation."""
+        if self._simplified is None:
+            self._simplified = SimplifiedChainTransform(self)
+        return self._simplified
+
+    @property
+    def Linear(self):
+        b = True
+        for tr in self._transforms:
+            b &= tr.Linear
+        return b
+
+    @property
+    def Orthogonal(self):
+        b = True
+        for tr in self._transforms:
+            b &= tr.Orthogonal
+        return b
+
+    @property
+    def NonScaling(self):
+        b = True
+        for tr in self._transforms:
+            b &= tr.NonScaling
+        return b
+
+    @property
+    def Isometric(self):
+        b = True
+        for tr in self._transforms:
+            b &= tr.Isometric
+        return b
+
+    def map(self, coords):
+        """Map coordinates
+
+        Parameters
+        ----------
+        coords : array-like
+            Coordinates to map.
+
+        Returns
+        -------
+        coords : ndarray
+            Coordinates.
+        """
+        for tr in reversed(self.transforms):
+            coords = tr.map(coords)
+        return coords
+
+    def imap(self, coords):
+        """Inverse map coordinates
+
+        Parameters
+        ----------
+        coords : array-like
+            Coordinates to inverse map.
+
+        Returns
+        -------
+        coords : ndarray
+            Coordinates.
+        """
+        for tr in self.transforms:
+            coords = tr.imap(coords)
+        return coords
+
+    def shader_map(self):
+        return self._shader_map
+
+    def shader_imap(self):
+        return self._shader_imap
+
+    def _rebuild_shaders(self):
+        trs = self.transforms
+        if len(trs) == 0:
+            trs = [self._null_transform]
+        self._shader_map.functions = [tr.shader_map() for tr in reversed(trs)]
+        self._shader_imap.functions = [tr.shader_imap() for tr in trs]
+
+    def append(self, tr):
+        """
+        Add a new transform to the end of this chain.
+
+        Parameters
+        ----------
+        tr : instance of Transform
+            The transform to use.
+        """
+        self.transforms.append(tr)
+        tr.changed.connect(self._subtr_changed)
+        self._rebuild_shaders()
+        self.update()
+
+    def prepend(self, tr):
+        """
+        Add a new transform to the beginning of this chain.
+
+        Parameters
+        ----------
+        tr : instance of Transform
+            The transform to use.
+        """
+        self.transforms.insert(0, tr)
+        tr.changed.connect(self._subtr_changed)
+        self._rebuild_shaders()
+        self.update()
+
+    def _subtr_changed(self, ev):
+        """One of the internal transforms changed; propagate the signal."""
+        self.update(ev)
+
+    def __setitem__(self, index, tr):
+        self._transforms[index].changed.disconnect(self._subtr_changed)
+        self._transforms[index] = tr
+        tr.changed.connect(self.subtr_changed)
+        self._rebuild_shaders()
+        self.update()
+
+    def __mul__(self, tr):
+        if isinstance(tr, ChainTransform):
+            trs = tr.transforms
+        else:
+            trs = [tr]
+        return ChainTransform(self.transforms+trs)
+
+    def __rmul__(self, tr):
+        if isinstance(tr, ChainTransform):
+            trs = tr.transforms
+        else:
+            trs = [tr]
+        return ChainTransform(trs+self.transforms)
+
+    def __str__(self):
+        names = [tr.__class__.__name__ for tr in self.transforms]
+        return "<ChainTransform [%s] at 0x%x>" % (", ".join(names), id(self))
+
+    def __repr__(self):
+        tr = ",\n                 ".join(map(repr, self.transforms))
+        return "<ChainTransform [%s] at 0x%x>" % (tr, id(self))
+
+    def __del__(self):
+        # remove all the children transforms from our callback, since we are
+        # being deleted.  (But we do *not* want to remove children from other
+        # callbacks)
+        for t in self._transforms:
+            t.changed.disconnect(self._subtr_changed)
+        self.changed.disconnect()
+
+
+class SimplifiedChainTransform(ChainTransform):
+    def __init__(self, chain):
+        ChainTransform.__init__(self)
+        self._chain = chain
+        chain.changed.connect(self.source_changed)
+        self.source_changed(None)
+
+    def source_changed(self, event):
+        """Generate a simplified chain by joining adjacent transforms."""
+        # bail out early if the chain is empty
+        transforms = self._chain.transforms[:]
+        if len(transforms) == 0:
+            self.transforms = []
+            return
+
+        # If the change signal comes from a transform that already appears in
+        # our simplified transform list, then there is no need to re-simplify.
+        if event is not None:
+            for source in event.sources[::-1]:
+                if source in self.transforms:
+                    self.update(event)
+                    return
+
+        # First flatten the chain by expanding all nested chains
+        new_chain = []
+        while len(transforms) > 0:
+            tr = transforms.pop(0)
+            if isinstance(tr, ChainTransform) and not tr.dynamic:
+                transforms = tr.transforms[:] + transforms
+            else:
+                new_chain.append(tr)
+
+        # Now combine together all compatible adjacent transforms
+        cont = True
+        tr = new_chain
+        while cont:
+            new_tr = [tr[0]]
+            cont = False
+            for t2 in tr[1:]:
+                t1 = new_tr[-1]
+                pr = t1 * t2
+                if (not t1.dynamic and not t2.dynamic and not 
+                        isinstance(pr, ChainTransform)):
+                    cont = True
+                    new_tr.pop()
+                    new_tr.append(pr)
+                else:
+                    new_tr.append(t2)
+            tr = new_tr
+
+        self.transforms = tr

vispy/visuals/transforms/interactive.py

@@ -0,0 +1,98 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) Vispy Development Team. All Rights Reserved.
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+from __future__ import division
+
+import numpy as np
+from .linear import STTransform
+
+
+class PanZoomTransform(STTransform):
+    """Pan-zoom transform
+
+    Parameters
+    ----------
+    canvas : instance of Canvas | None
+        The canvas to attch to.
+    aspect : float | None
+        The aspect ratio to apply.
+    **kwargs : dict
+        Keyword arguments to pass to the underlying `STTransform`.
+    """
+
+    def __init__(self, canvas=None, aspect=None, **kwargs):
+        self._aspect = aspect
+        self.attach(canvas)
+        STTransform.__init__(self, **kwargs)
+        self.on_resize(None)
+
+    def attach(self, canvas):
+        """Attach this tranform to a canvas
+
+        Parameters
+        ----------
+        canvas : instance of Canvas
+            The canvas.
+        """
+        self._canvas = canvas
+        canvas.events.resize.connect(self.on_resize)
+        canvas.events.mouse_wheel.connect(self.on_mouse_wheel)
+        canvas.events.mouse_move.connect(self.on_mouse_move)
+
+    @property
+    def canvas_tr(self):
+        return STTransform.from_mapping(
+            [(0, 0), self._canvas.size],
+            [(-1, 1), (1, -1)])
+
+    def on_resize(self, event):
+        """Resize handler
+
+        Parameters
+        ----------
+        event : instance of Event
+            The event.
+        """
+        if self._aspect is None:
+            return
+        w, h = self._canvas.size
+        aspect = self._aspect / (w / h)
+        self.scale = (self.scale[0], self.scale[0] / aspect)
+        self.shader_map()
+
+    def on_mouse_move(self, event):
+        """Mouse move handler
+
+        Parameters
+        ----------
+        event : instance of Event
+            The event.
+        """
+        if event.is_dragging:
+            dxy = event.pos - event.last_event.pos
+            button = event.press_event.button
+
+            if button == 1:
+                dxy = self.canvas_tr.map(dxy)
+                o = self.canvas_tr.map([0, 0])
+                t = dxy - o
+                self.move(t)
+            elif button == 2:
+                center = self.canvas_tr.map(event.press_event.pos)
+                if self._aspect is None:
+                    self.zoom(np.exp(dxy * (0.01, -0.01)), center)
+                else:
+                    s = dxy[1] * -0.01
+                    self.zoom(np.exp(np.array([s, s])), center)
+
+            self.shader_map()
+
+    def on_mouse_wheel(self, event):
+        """Mouse wheel handler
+
+        Parameters
+        ----------
+        event : instance of Event
+            The event.
+        """
+        self.zoom(np.exp(event.delta * (0.01, -0.01)), event.pos)