vispy 0.15.0__cp313-cp313-macosx_10_13_x86_64.whl

vispy/visuals/collections/agg_path_collection.py

@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+# -----------------------------------------------------------------------------
+# Copyright (c) 2014, Nicolas P. Rougier
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+# -----------------------------------------------------------------------------
+"""
+Antigrain Geometry Path Collection
+
+This collection provides antialiased and accurate paths with caps and joins. It
+is memory hungry (x8) and slow (x.25) so it is to be used sparingly, mainly for
+thick paths where quality is critical.
+"""
+import numpy as np
+from ... import glsl
+from ... import gloo
+from . collection import Collection
+from ..transforms import NullTransform
+
+
+class AggPathCollection(Collection):
+    """
+    Antigrain Geometry Path Collection
+
+    This collection provides antialiased and accurate paths with caps and
+    joins. It is memory hungry (x8) and slow (x.25) so it is to be used
+    sparingly, mainly for thick paths where quality is critical.
+    """
+
+    def __init__(self, user_dtype=None, transform=None,
+                 vertex=None, fragment=None, **kwargs):
+        """
+        Initialize the collection.
+
+        Parameters
+        ----------
+        user_dtype: list
+            The base dtype can be completed (appended) by the used_dtype. It
+            only make sense if user also provide vertex and/or fragment shaders
+
+        transform : Transform instance
+            Used to define the transform(vec4) function
+
+        vertex: string
+            Vertex shader code
+
+        fragment: string
+            Fragment  shader code
+
+        caps : string
+            'local', 'shared' or 'global'
+
+        join : string
+            'local', 'shared' or 'global'
+
+        color : string
+            'local', 'shared' or 'global'
+
+        miter_limit : string
+            'local', 'shared' or 'global'
+
+        linewidth : string
+            'local', 'shared' or 'global'
+
+        antialias : string
+            'local', 'shared' or 'global'
+        """
+        base_dtype = [('p0', (np.float32, 3), '!local', (0, 0, 0)),
+                      ('p1', (np.float32, 3), '!local', (0, 0, 0)),
+                      ('p2', (np.float32, 3), '!local', (0, 0, 0)),
+                      ('p3', (np.float32, 3), '!local', (0, 0, 0)),
+                      ('uv', (np.float32, 2), '!local', (0, 0)),
+
+                      ('caps', (np.float32, 2), 'global', (0, 0)),
+                      ('join', (np.float32, 1), 'global', 0),
+                      ('color', (np.float32, 4), 'global', (0, 0, 0, 1)),
+                      ('miter_limit', (np.float32, 1), 'global', 4),
+                      ('linewidth', (np.float32, 1), 'global', 1),
+                      ('antialias', (np.float32, 1), 'global', 1),
+                      ('viewport', (np.float32, 4), 'global', (0, 0, 512, 512))]  # noqa
+
+        dtype = base_dtype
+        if user_dtype:
+            dtype.extend(user_dtype)
+
+        if vertex is None:
+            vertex = glsl.get('collections/agg-path.vert')
+        if transform is None:
+            transform = NullTransform()
+        self.transform = transform
+        if fragment is None:
+            fragment = glsl.get('collections/agg-path.frag')
+
+        Collection.__init__(self, dtype=dtype, itype=np.uint32,  # 16 for WebGL
+                            mode="triangles",
+                            vertex=vertex, fragment=fragment, **kwargs)
+        self._programs[0].vert['transform'] = self.transform
+
+    def append(self, P, closed=False, itemsize=None, **kwargs):
+        """
+        Append a new set of vertices to the collection.
+
+        For kwargs argument, n is the number of vertices (local) or the number
+        of item (shared)
+
+        Parameters
+        ----------
+        P : np.array
+            Vertices positions of the path(s) to be added
+
+        closed: bool
+            Whether path(s) is/are closed
+
+        itemsize: int or None
+            Size of an individual path
+
+        caps : list, array or 2-tuple
+           Path start /end cap
+
+        join : list, array or float
+           path segment join
+
+        color : list, array or 4-tuple
+           Path color
+
+        miter_limit : list, array or float
+           Miter limit for join
+
+        linewidth : list, array or float
+           Path linewidth
+
+        antialias : list, array or float
+           Path antialias area
+        """
+        itemsize = int(itemsize or len(P))
+        itemcount = len(P) // itemsize
+
+        # Computes the adjacency information
+        n, p = len(P), P.shape[-1]
+        Z = np.tile(P, 2).reshape(2 * len(P), p)
+        V = np.empty(n, dtype=self.vtype)
+
+        V['p0'][1:-1] = Z[0::2][:-2]
+        V['p1'][:-1] = Z[1::2][:-1]
+        V['p2'][:-1] = Z[1::2][+1:]
+        V['p3'][:-2] = Z[0::2][+2:]
+
+        # Apply default values on vertices
+        for name in self.vtype.names:
+            if name not in ['collection_index', 'p0', 'p1', 'p2', 'p3']:
+                V[name] = kwargs.get(name, self._defaults[name])
+
+        # Extract relevant segments only
+        V = (V.reshape(n // itemsize, itemsize)[:, :-1])
+        if closed:
+            V['p0'][:, 0] = V['p2'][:, -1]
+            V['p3'][:, -1] = V['p1'][:, 0]
+        else:
+            V['p0'][:, 0] = V['p1'][:, 0]
+            V['p3'][:, -1] = V['p2'][:, -1]
+        V = V.ravel()
+
+        # Quadruple each point (we're using 2 triangles / segment)
+        # No shared vertices between segment because of joins
+        V = np.repeat(V, 4, axis=0).reshape((len(V), 4))
+        V['uv'] = (-1, -1), (-1, +1), (+1, -1), (+1, +1)
+        V = V.ravel()
+
+        n = itemsize
+        if closed:
+            # uint16 for WebGL
+            idxs = np.resize(
+                np.array([0, 1, 2, 1, 2, 3], dtype=np.uint32), n * 2 * 3)
+            idxs += np.repeat(4 * np.arange(n, dtype=np.uint32), 6)
+            idxs[-6:] = 4 * n - 6, 4 * n - 5, 0, 4 * n - 5, 0, 1
+        else:
+            idxs = np.resize(
+                np.array([0, 1, 2, 1, 2, 3], dtype=np.uint32), (n - 1) * 2 * 3)
+            idxs += np.repeat(4 * np.arange(n - 1, dtype=np.uint32), 6)
+        idxs = idxs.ravel()
+
+        # Uniforms
+        if self.utype:
+            U = np.zeros(itemcount, dtype=self.utype)
+            for name in self.utype.names:
+                if name not in ["__unused__"]:
+                    U[name] = kwargs.get(name, self._defaults[name])
+        else:
+            U = None
+
+        Collection.append(self, vertices=V, uniforms=U,
+                          indices=idxs, itemsize=itemsize * 4 - 4)
+
+    def draw(self, mode="triangles"):
+        """Draw collection"""
+        gloo.set_depth_mask(0)
+        Collection.draw(self, mode)
+        gloo.set_depth_mask(1)

vispy/visuals/collections/agg_point_collection.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+# -----------------------------------------------------------------------------
+# Copyright (c) 2014, Nicolas P. Rougier
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+# -----------------------------------------------------------------------------
+"""
+Antigrain Geometry Point Collection
+
+This collection provides fast points. Output quality is perfect.
+"""
+from ... import glsl
+from . raw_point_collection import RawPointCollection
+
+
+class AggPointCollection(RawPointCollection):
+    """
+    Antigrain Geometry Point Collection
+
+    This collection provides fast points. Output quality is perfect.
+    """
+
+    def __init__(self, user_dtype=None, transform=None,
+                 vertex=None, fragment=None, **kwargs):
+        """
+        Initialize the collection.
+
+        Parameters
+        ----------
+        user_dtype: list
+            The base dtype can be completed (appended) by the used_dtype. It
+            only make sense if user also provide vertex and/or fragment shaders
+
+        vertex: string
+            Vertex shader code
+
+        fragment: string
+            Fragment  shader code
+
+        transform : Transform instance
+            Used to define the GLSL transform(vec4) function
+
+        color : string
+            'local', 'shared' or 'global'
+        """
+        if vertex is None:
+            vertex = glsl.get("collections/agg-point.vert")
+        if fragment is None:
+            fragment = glsl.get("collections/agg-point.frag")
+
+        RawPointCollection.__init__(self, user_dtype=user_dtype,
+                                    transform=transform,
+                                    vertex=vertex, fragment=fragment, **kwargs)

vispy/visuals/collections/agg_segment_collection.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+# -----------------------------------------------------------------------------
+# Copyright (c) 2014, Nicolas P. Rougier
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+# -----------------------------------------------------------------------------
+"""
+Antigrain Geometry Segment Collection
+
+This collection provides antialiased and accurate segments with caps. It
+consume x2 more memory than regular lines and is a bit slower, but the quality
+of the output is worth the cost.
+"""
+import numpy as np
+from ... import glsl
+from . collection import Collection
+from ..transforms import NullTransform
+
+
+class AggSegmentCollection(Collection):
+    """
+    Antigrain Geometry Segment Collection
+
+    This collection provides antialiased and accurate segments with caps. It
+    consume x2 more memory than regular lines and is a bit slower, but the
+    quality of the output is worth the cost.
+    """
+
+    def __init__(self, user_dtype=None, transform=None,
+                 vertex=None, fragment=None, **kwargs):
+        """
+        Initialize the collection.
+
+        Parameters
+        ----------
+        user_dtype: list
+            The base dtype can be completed (appended) by the used_dtype. It
+            only make sense if user also provide vertex and/or fragment shaders
+
+        transform : string
+            GLSL Transform code defining the vec4 transform(vec3) function
+
+        vertex: string
+            Vertex shader code
+
+        fragment: string
+            Fragment  shader code
+
+        caps : string
+            'local', 'shared' or 'global'
+
+        color : string
+            'local', 'shared' or 'global'
+
+        linewidth : string
+            'local', 'shared' or 'global'
+
+        antialias : string
+            'local', 'shared' or 'global'
+        """
+        base_dtype = [('P0', (np.float32, 3), '!local', (0, 0, 0)),
+                      ('P1', (np.float32, 3), '!local', (0, 0, 0)),
+                      ('index', (np.float32, 1), '!local', 0),
+                      ('color', (np.float32, 4), 'shared', (0, 0, 0, 1)),
+                      ('linewidth', (np.float32, 1), 'shared', 1),
+                      ('antialias', (np.float32, 1), 'shared', 1),
+                      ('viewport', (np.float32, 4), 'global', (0, 0, 512, 512))]  # noqa
+
+        dtype = base_dtype
+        if user_dtype:
+            dtype.extend(user_dtype)
+
+        if vertex is None:
+            vertex = glsl.get('collections/agg-segment.vert')
+        if transform is None:
+            transform = NullTransform()
+        self.transform = transform        
+        if fragment is None:
+            fragment = glsl.get('collections/agg-segment.frag')
+
+        Collection.__init__(self, dtype=dtype, itype=np.uint32,
+                            mode="triangles",
+                            vertex=vertex, fragment=fragment, **kwargs)
+        self._programs[0].vert['transform'] = self.transform
+
+    def append(self, P0, P1, itemsize=None, **kwargs):
+        """
+        Append a new set of segments to the collection.
+
+        For kwargs argument, n is the number of vertices (local) or the number
+        of item (shared)
+
+        Parameters
+        ----------
+        P : np.array
+            Vertices positions of the path(s) to be added
+
+        itemsize: int or None
+            Size of an individual path
+
+        caps : list, array or 2-tuple
+           Path start /end cap
+
+        color : list, array or 4-tuple
+           Path color
+
+        linewidth : list, array or float
+           Path linewidth
+
+        antialias : list, array or float
+           Path antialias area
+        """
+        itemsize = itemsize or 1
+        itemcount = len(P0) // itemsize
+
+        V = np.empty(itemcount, dtype=self.vtype)
+
+        # Apply default values on vertices
+        for name in self.vtype.names:
+            if name not in ['collection_index', 'P0', 'P1', 'index']:
+                V[name] = kwargs.get(name, self._defaults[name])
+
+        V['P0'] = P0
+        V['P1'] = P1
+        V = V.repeat(4, axis=0)
+        V['index'] = np.resize([0, 1, 2, 3], 4 * itemcount * itemsize)
+
+        idxs = np.ones((itemcount, 6), dtype=int)
+        idxs[:] = 0, 1, 2, 0, 2, 3
+        idxs[:] += 4 * np.arange(itemcount)[:, np.newaxis]
+        idxs = idxs.ravel()
+
+        # Uniforms
+        if self.utype:
+            U = np.zeros(itemcount, dtype=self.utype)
+            for name in self.utype.names:
+                if name not in ["__unused__"]:
+                    U[name] = kwargs.get(name, self._defaults[name])
+        else:
+            U = None
+
+        Collection.append(
+            self, vertices=V, uniforms=U, indices=idxs, itemsize=4 * itemcount)