3D canvas

whitecanvas/__init__.py

@@ -1,9 +1,10 @@
-__version__ = "0.2.7"
+__version__ = "0.3.0.dev0"
 
 from whitecanvas import theme
 from whitecanvas.canvas import link_axes
 from whitecanvas.core import (
     new_canvas,
+    new_canvas_3d,
     new_col,
     new_grid,
     new_jointgrid,
@@ -13,6 +14,7 @@
 
 __all__ = [
     "new_canvas",
+    "new_canvas_3d",
     "new_col",
     "new_grid",
     "new_row",
@@ -21,31 +23,3 @@
     "theme",
     "link_axes",
 ]
-
-
-def __getattr__(name: str):  # pragma: no cover
-    import warnings
-
-    if name in ("grid", "grid_nonuniform"):
-        warnings.warn(
-            f"{name!r} is deprecated. Use `new_grid` instead",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return new_grid
-    elif name in ("vgrid", "vgrid_nonuniform"):
-        warnings.warn(
-            f"{name!r} is deprecated. Use `new_col` instead",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return new_col
-    elif name in ("hgrid", "hgrid_nonuniform"):
-        warnings.warn(
-            f"{name!r} is deprecated. Use `new_row` instead",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return new_row
-    else:
-        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

whitecanvas/backend/_instance.py

@@ -72,6 +72,17 @@
             raise RuntimeError(f"Backend {self._name!r} does not implement {attr!r}")
         return out
 
+    def get_submodule(self, attr: str):
+        """Get a submodule from the current backend."""
+        import importlib
+
+        if self.is_dummy():
+            return _dummy_backend_module
+        out = importlib.import_module(f"whitecanvas.backend.{self._name}.{attr}")
+        if out is None:
+            raise RuntimeError(f"Backend {self._name!r} does not implement {attr!r}")
+        return out
+
     def is_dummy(self) -> bool:
         """True is the backend is a dummy backend."""
         return self.name.startswith(".")
@@ -87,7 +98,7 @@
         self.Canvas = DummyObject
 
     def __getattr__(self, key):
-        raise RuntimeError(f"Cannot install {key!r} before finishing layouting.")
+        return DummyObject
 
 
 _dummy_backend_module = DummyBackendModule()

whitecanvas/backend/_not_implemented.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import numpy as np
+
 from whitecanvas.types import Hatch, LineStyle
 
 
@@ -27,25 +29,47 @@
     return _getter, _setter
 
 
-def face_pattern():
+def edge_width():
+    def _getter(self):
+        return getattr(self, "__edge_width_value", 1.0)
+
+    def _setter(self, value: float):
+        setattr(self, "__edge_width_value", value)
+
+    return _getter, _setter
+
+
+def edge_color():
+    def _getter(self):
+        return getattr(
+            self, "__edge_color_value", np.array([0, 0, 0, 255], dtype=np.float32)
+        )
+
+    def _setter(self, value: float):
+        setattr(self, "__edge_color_value", value)
+
+    return _getter, _setter
+
+
+def face_hatch():
     def _getter(self):
-        return getattr(self, "__face_pattern_value", Hatch.SOLID)
+        return getattr(self, "__face_hatch_value", Hatch.SOLID)
 
     def _setter(self, value: Hatch):
-        setattr(self, "__face_pattern_value", value)
+        setattr(self, "__face_hatch_value", value)
 
     return _getter, _setter
 
 
-def face_patterns():
+def face_hatches():
     def _getter(self):
         return getattr(
-            self, "__face_pattern_value", [Hatch.SOLID] * self._plt_get_ndata()
+            self, "__face_hatch_value", [Hatch.SOLID] * self._plt_get_ndata()
         )
 
     def _setter(self, value: Hatch | list[Hatch]):
         if isinstance(value, Hatch):
             value = [value] * self._plt_get_ndata()
-        setattr(self, "__face_pattern_value", value)
+        setattr(self, "__face_hatch_value", value)
 
     return _getter, _setter

whitecanvas/backend/matplotlib/__init__.py

@@ -6,3 +6,4 @@
 from whitecanvas.backend.matplotlib.line import MonoLine, MultiLine
 from whitecanvas.backend.matplotlib.markers import Markers
 from whitecanvas.backend.matplotlib.text import Texts
+from whitecanvas.backend.matplotlib.vectors import Vectors

whitecanvas/backend/matplotlib/_base.py

@@ -22,6 +22,12 @@
         self.set_zorder(zorder)
 
 
+class FakeAxes:
+    def __init__(self):
+        self.transData = None
+        self.transAxes = None
+
+
 def symbol_to_path(symbol: Symbol):
     marker_obj = mmarkers.MarkerStyle(symbol.value)
     return marker_obj.get_path().transformed(marker_obj.get_transform())