vispy 0.15.0__cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

vispy/app/timer.py

@@ -0,0 +1,174 @@
+# -*- 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 ..util.event import Event, EmitterGroup
+from ..util.ptime import time as precision_time
+from .base import BaseTimerBackend as TimerBackend  # noqa
+from . import use_app, Application
+
+
+class Timer(object):
+    """Timer used to schedule events in the future or on a repeating schedule.
+
+    Parameters
+    ----------
+    interval : float | 'auto'
+        Time between events in seconds. The default is 'auto', which
+        attempts to find the interval that matches the refresh rate of
+        the current monitor. Currently this is simply 1/60.
+    connect : function | None
+        The function to call.
+    iterations : int
+        Number of iterations. Can be -1 for infinite.
+    start : bool
+        Whether to start the timer.
+    app : instance of vispy.app.Application
+        The application to attach the timer to.
+    """
+
+    def __init__(self, interval='auto', connect=None, iterations=-1,
+                 start=False, app=None):
+        """Initiallize timer method."""
+        self.events = EmitterGroup(source=self,
+                                   start=Event,
+                                   stop=Event,
+                                   timeout=Event)
+        # self.connect = self.events.timeout.connect
+        # self.disconnect = self.events.timeout.disconnect
+
+        # Get app instance
+        if app is None:
+            self._app = use_app(call_reuse=False)
+        elif isinstance(app, Application):
+            self._app = app
+        elif isinstance(app, str):
+            self._app = Application(app)
+        else:
+            raise ValueError('Invalid value for app %r' % app)
+
+        # Ensure app has backend app object
+        self._app.native
+
+        # Instantiate the backed with the right class
+        self._backend = self._app.backend_module.TimerBackend(self)
+
+        if interval == 'auto':
+            interval = 1.0 / 60
+        self._interval = float(interval)
+        self._running = False
+        self._first_emit_time = None
+        self._last_emit_time = None
+        self.iter_count = 0
+        self.max_iterations = iterations
+        if connect is not None:
+            self.connect(connect)
+        if start:
+            self.start()
+
+    @property
+    def app(self):
+        """Timer is based on this vispy Application instance."""
+        return self._app
+
+    @property
+    def interval(self):
+        return self._interval
+
+    @interval.setter
+    def interval(self, val):
+        self._interval = val
+        if self.running:
+            self.stop()
+            self.start()
+
+    @property
+    def elapsed(self):
+        return precision_time() - self._first_emit_time
+
+    @property
+    def running(self):
+        return self._running
+
+    def start(self, interval=None, iterations=None):
+        """Start the timer.
+
+        A timeout event will be generated every *interval* seconds.
+        If *interval* is None, then self.interval will be used.
+
+        If *iterations* is specified, the timer will stop after
+        emitting that number of events. If unspecified, then
+        the previous value of self.iterations will be used. If the value is
+        negative, then the timer will continue running until stop() is called.
+
+        If the timer is already running when this function is called, nothing
+        happens (timer continues running as it did previously, without
+        changing the interval, number of iterations, or emitting a timer
+        start event).
+        """
+        if self.running:
+            return  # don't do anything if already running
+        self.iter_count = 0
+        if interval is not None:
+            self.interval = interval
+        if iterations is not None:
+            self.max_iterations = iterations
+        self._backend._vispy_start(self.interval)
+        self._running = True
+        self._first_emit_time = precision_time()
+        self._last_emit_time = precision_time()
+        self.events.start(type='timer_start')
+
+    def stop(self):
+        """Stop the timer."""
+        self._backend._vispy_stop()
+        self._running = False
+        self.events.stop(type='timer_stop')
+
+    # use timer.app.run() and .quit() instead.
+    # def run_event_loop(self):
+        # """Execute the event loop for this Timer's backend.
+        # """
+        # return self._backend._vispy_run()
+
+    # def quit_event_loop(self):
+        # """Exit the event loop for this Timer's backend.
+        # """
+        # return self._backend._vispy_quit()
+
+    @property
+    def native(self):
+        """Timer is based on this native timer"""
+        return self._backend._vispy_get_native_timer()
+
+    def _timeout(self, *args):
+        # called when the backend timer has triggered.
+        if not self.running:
+            return
+        if self.max_iterations >= 0 and self.iter_count >= self.max_iterations:
+            self.stop()
+            return
+
+        # compute dt since last event
+        now = precision_time()
+        dt = now - self._last_emit_time
+        elapsed = now - self._first_emit_time
+        self._last_emit_time = now
+
+        self.events.timeout(
+            type='timer_timeout',
+            iteration=self.iter_count,
+            elapsed=elapsed,
+            dt=dt,
+            count=self.iter_count)
+        self.iter_count += 1
+
+    def connect(self, callback):
+        """Alias for self.events.timeout.connect()."""
+        return self.events.timeout.connect(callback)
+
+    def disconnect(self, callback=None):
+        """Alias for self.events.timeout.disconnect()."""
+        return self.events.timeout.disconnect(callback)

vispy/color/__init__.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) Vispy Development Team. All Rights Reserved.
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+"""
+Convience interfaces to manipulate colors.
+
+This module provides support for manipulating colors.
+"""
+
+from ._color_dict import get_color_names, get_color_dict  # noqa
+from .color_array import Color, ColorArray
+from .colormap import (Colormap, BaseColormap,  # noqa
+                       get_colormap, get_colormaps)  # noqa
+
+__all__ = ['Color', 'ColorArray', 'Colormap', 'BaseColormap',
+           'get_colormap', 'get_colormaps',
+           'get_color_names', 'get_color_dict']

vispy/color/_color_dict.py

@@ -0,0 +1,193 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) Vispy Development Team. All Rights Reserved.
+# Distributed under the (new) BSD License. See LICENSE.txt for more info.
+
+
+def get_color_names():
+    """Get the known color names
+
+    Returns
+    -------
+    names : list
+        List of color names known by Vispy.
+    """
+    names = sorted(_color_dict.keys())
+    return names
+
+
+def get_color_dict():
+    """Get the known colors
+
+    Returns
+    -------
+    color_dict : dict
+        Dict of colors known by Vispy {name: #rgb}.
+    """
+    return _color_dict.copy()
+
+
+# This is used by color functions to translate user strings to colors
+# For now, this is web colors, and all in hex. It will take some simple
+# but annoying refactoring to deal with non-hex entries if we want them.
+
+# Add the CSS colors, courtesy MIT-licensed code from Dave Eddy:
+# github.com/bahamas10/css-color-names/blob/master/css-color-names.json
+
+_color_dict = {
+    "k": '#000000',
+    "w": '#FFFFFF',
+    "r": '#FF0000',
+    "g": '#00FF00',
+    "b": '#0000FF',
+    "y": '#FFFF00',
+    "m": '#FF00FF',
+    "c": '#00FFFF',
+    "aqua": "#00ffff",
+    "aliceblue": "#f0f8ff",
+    "antiquewhite": "#faebd7",
+    "black": "#000000",
+    "blue": "#0000ff",
+    "cyan": "#00ffff",
+    "darkblue": "#00008b",
+    "darkcyan": "#008b8b",
+    "darkgreen": "#006400",
+    "darkturquoise": "#00ced1",
+    "deepskyblue": "#00bfff",
+    "green": "#008000",
+    "lime": "#00ff00",
+    "mediumblue": "#0000cd",
+    "mediumspringgreen": "#00fa9a",
+    "navy": "#000080",
+    "springgreen": "#00ff7f",
+    "teal": "#008080",
+    "midnightblue": "#191970",
+    "dodgerblue": "#1e90ff",
+    "lightseagreen": "#20b2aa",
+    "forestgreen": "#228b22",
+    "seagreen": "#2e8b57",
+    "darkslategray": "#2f4f4f",
+    "darkslategrey": "#2f4f4f",
+    "limegreen": "#32cd32",
+    "mediumseagreen": "#3cb371",
+    "turquoise": "#40e0d0",
+    "royalblue": "#4169e1",
+    "steelblue": "#4682b4",
+    "darkslateblue": "#483d8b",
+    "mediumturquoise": "#48d1cc",
+    "indigo": "#4b0082",
+    "darkolivegreen": "#556b2f",
+    "cadetblue": "#5f9ea0",
+    "cornflowerblue": "#6495ed",
+    "mediumaquamarine": "#66cdaa",
+    "dimgray": "#696969",
+    "dimgrey": "#696969",
+    "slateblue": "#6a5acd",
+    "olivedrab": "#6b8e23",
+    "slategray": "#708090",
+    "slategrey": "#708090",
+    "lightslategray": "#778899",
+    "lightslategrey": "#778899",
+    "mediumslateblue": "#7b68ee",
+    "lawngreen": "#7cfc00",
+    "aquamarine": "#7fffd4",
+    "chartreuse": "#7fff00",
+    "gray": "#808080",
+    "grey": "#808080",
+    "maroon": "#800000",
+    "olive": "#808000",
+    "purple": "#800080",
+    "lightskyblue": "#87cefa",
+    "skyblue": "#87ceeb",
+    "blueviolet": "#8a2be2",
+    "darkmagenta": "#8b008b",
+    "darkred": "#8b0000",
+    "saddlebrown": "#8b4513",
+    "darkseagreen": "#8fbc8f",
+    "lightgreen": "#90ee90",
+    "mediumpurple": "#9370db",
+    "darkviolet": "#9400d3",
+    "palegreen": "#98fb98",
+    "darkorchid": "#9932cc",
+    "yellowgreen": "#9acd32",
+    "sienna": "#a0522d",
+    "brown": "#a52a2a",
+    "darkgray": "#a9a9a9",
+    "darkgrey": "#a9a9a9",
+    "greenyellow": "#adff2f",
+    "lightblue": "#add8e6",
+    "paleturquoise": "#afeeee",
+    "lightsteelblue": "#b0c4de",
+    "powderblue": "#b0e0e6",
+    "firebrick": "#b22222",
+    "darkgoldenrod": "#b8860b",
+    "mediumorchid": "#ba55d3",
+    "rosybrown": "#bc8f8f",
+    "darkkhaki": "#bdb76b",
+    "silver": "#c0c0c0",
+    "mediumvioletred": "#c71585",
+    "indianred": "#cd5c5c",
+    "peru": "#cd853f",
+    "chocolate": "#d2691e",
+    "tan": "#d2b48c",
+    "lightgray": "#d3d3d3",
+    "lightgrey": "#d3d3d3",
+    "thistle": "#d8bfd8",
+    "goldenrod": "#daa520",
+    "orchid": "#da70d6",
+    "palevioletred": "#db7093",
+    "crimson": "#dc143c",
+    "gainsboro": "#dcdcdc",
+    "plum": "#dda0dd",
+    "burlywood": "#deb887",
+    "lightcyan": "#e0ffff",
+    "lavender": "#e6e6fa",
+    "darksalmon": "#e9967a",
+    "palegoldenrod": "#eee8aa",
+    "violet": "#ee82ee",
+    "azure": "#f0ffff",
+    "honeydew": "#f0fff0",
+    "khaki": "#f0e68c",
+    "lightcoral": "#f08080",
+    "sandybrown": "#f4a460",
+    "beige": "#f5f5dc",
+    "mintcream": "#f5fffa",
+    "wheat": "#f5deb3",
+    "whitesmoke": "#f5f5f5",
+    "ghostwhite": "#f8f8ff",
+    "lightgoldenrodyellow": "#fafad2",
+    "linen": "#faf0e6",
+    "salmon": "#fa8072",
+    "oldlace": "#fdf5e6",
+    "bisque": "#ffe4c4",
+    "blanchedalmond": "#ffebcd",
+    "coral": "#ff7f50",
+    "cornsilk": "#fff8dc",
+    "darkorange": "#ff8c00",
+    "deeppink": "#ff1493",
+    "floralwhite": "#fffaf0",
+    "fuchsia": "#ff00ff",
+    "gold": "#ffd700",
+    "hotpink": "#ff69b4",
+    "ivory": "#fffff0",
+    "lavenderblush": "#fff0f5",
+    "lemonchiffon": "#fffacd",
+    "lightpink": "#ffb6c1",
+    "lightsalmon": "#ffa07a",
+    "lightyellow": "#ffffe0",
+    "magenta": "#ff00ff",
+    "mistyrose": "#ffe4e1",
+    "moccasin": "#ffe4b5",
+    "navajowhite": "#ffdead",
+    "orange": "#ffa500",
+    "orangered": "#ff4500",
+    "papayawhip": "#ffefd5",
+    "peachpuff": "#ffdab9",
+    "pink": "#ffc0cb",
+    "red": "#ff0000",
+    "seashell": "#fff5ee",
+    "snow": "#fffafa",
+    "tomato": "#ff6347",
+    "white": "#ffffff",
+    "yellow": "#ffff00",
+    "transparent": "#00000000",
+}