arcade 3.0.0.dev41__tar.gz → 3.0.0.dev42__tar.gz

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: arcade
-Version: 3.0.0.dev41
+Version: 3.0.0.dev42
 Summary: Arcade Game Development Library
 Author-email: Paul Vincent Craven <paul@cravenfamily.com>
 License: License

arcade-3.0.0.dev42/arcade/VERSION

@@ -0,0 +1 @@
+3.0.0-dev.42

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/camera/camera_2d.py

@@ -135,9 +135,10 @@ class Camera2D:
                 f"projection depth is 0 due to equal {near=}" f"and {far=} values"
             )
 
-        _pos = position or (half_width, half_height)
+        pos_x = position[0] if position is not None else half_width
+        pos_y = position[1] if position is not None else half_height
         self._camera_data = CameraData(
-            position=(_pos[0], _pos[1], 0.0),
+            position=(pos_x, pos_y, 0.0),
             up=(up[0], up[1], 0.0),
             forward=(0.0, 0.0, -1.0),
             zoom=zoom,
@@ -240,9 +241,9 @@ class Camera2D:
             render_target=render_target, window=window, viewport=viewport, scissor=scissor
         )
 
-        if camera_data:
+        if camera_data is not None:
             new_camera._camera_data = camera_data
-        if projection_data:
+        if projection_data is not None:
             new_camera._projection_data = projection_data
 
         return new_camera

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/examples/drawing_text.py

@@ -12,8 +12,9 @@ WINDOW_TITLE = "Drawing Text Example"
 DEFAULT_LINE_HEIGHT = 45
 DEFAULT_FONT_SIZE = 20
 
-# Load fonts bumbled with Arcade such as the Kenney fonts
+# Load fonts bundled with Arcade such as the Kenney fonts
 arcade.resources.load_kenney_fonts()
+arcade.resources.load_liberation_fonts()
 
 
 class GameView(arcade.View):
@@ -158,7 +159,8 @@ class GameView(arcade.View):
                          font_name=(
                              "Times New Roman",  # Comes with Windows
                              "Times",  # MacOS may sometimes have this variant
-                             "Liberation Serif"  # Common on Linux systems
+                             # Common on Linux systems + we ship it with Arcade
+                             "Liberation Serif"
                          ))
 
         start_y -= DEFAULT_LINE_HEIGHT

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/examples/drawing_text_objects.py

@@ -13,8 +13,9 @@ WINDOW_TITLE = "Drawing Text Example"
 DEFAULT_LINE_HEIGHT = 45
 DEFAULT_FONT_SIZE = 20
 
-# Load fonts bumbled with Arcade such as the Kenney fonts
+# Load fonts bundled with Arcade such as the Kenney fonts
 arcade.resources.load_kenney_fonts()
+arcade.resources.load_liberation_fonts()
 
 
 class GameView(arcade.View):
@@ -171,7 +172,8 @@ class GameView(arcade.View):
             font_name=(
                 "Times New Roman",  # Comes with Windows
                 "Times",  # MacOS may sometimes have this variant
-                "Liberation Serif"  # Common on Linux systems
+                # Common on Linux systems + we ship it with Arcade
+                "Liberation Serif"
             )
         )
 

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/examples/drawing_text_objects_batch.py

@@ -15,8 +15,9 @@ python -m arcade.examples.drawing_text_objects_batch
 import arcade
 from pyglet.graphics import Batch
 
-# Load fonts bumbled with Arcade such as the Kenney fonts
+# Load fonts bundled with Arcade such as the Kenney fonts
 arcade.resources.load_kenney_fonts()
+arcade.resources.load_liberation_fonts()
 
 WINDOW_WIDTH = 1280  # Window width in pixels
 WINDOW_HEIGHT = 800  # Window height in pixels
@@ -193,7 +194,8 @@ class GameView(arcade.View):
             font_name=(
                 "Times New Roman",  # Comes with Windows
                 "Times",  # MacOS may sometimes have this variant
-                "Liberation Serif"  # Common on Linux systems
+                # Common on Linux systems + we ship it with Arcade
+                "Liberation Serif"
             ),
             batch=self.batch,
         )

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/examples/threaded_loading.py

@@ -29,7 +29,7 @@ python -m arcade.examples.threaded_loading
 from __future__ import annotations
 
 import sys
-import time
+from time import sleep
 
 # Python's threading module has proven tools for working with threads, and
 # veteran developers may want to explore 3.13's new 'No-GIL' concurrency.
@@ -104,7 +104,7 @@ class LevelLoader:
             with self._interaction_lock:
                 self._current_level = level
 
-            time.sleep(ARTIFICIAL_DELAY)  # "Slow" down (delete this line before use)
+            sleep(ARTIFICIAL_DELAY)  # "Slow" down (delete this line before use)
 
             # Since unhandled exceptions "kill" threads, we catch the only major
             # exception we expect. Level 4 is intentionally missing to test cases

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/gui/widgets/text.py

@@ -87,7 +87,7 @@ class UILabel(UIWidget):
         font_name=("calibri", "arial"),
         font_size: float = 12,
         text_color: RGBOrA255 = arcade.color.WHITE,
-        bold=False,
+        bold: str | bool = False,
         italic=False,
         align="left",
         multiline: bool = False,
@@ -235,7 +235,9 @@ class UILabel(UIWidget):
                 success.
             font_size: Font size of font.
             font_color: Color of the text.
-            bold: If enabled, the label's text will be in a **bold** style.
+            bold: May be any value in :py:obj:`pyglet.text.Weight`,
+                ``True`` (converts to ``"bold"``), or ``False``
+                (converts to ``"regular"``).
             italic: If enabled, the label's text will be in an *italic*
         """
         font_name = font_name or self._label.font_name

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/resources/__init__.py

@@ -6,9 +6,16 @@ from arcade.exceptions import warning, ReplacementWarning
 
 #: The absolute path to this directory
 RESOURCE_DIR = Path(__file__).parent.resolve()
+
+# The "system" resources common to Arcade
 SYSTEM_PATH = RESOURCE_DIR / "system"
+FONTS_PATH = SYSTEM_PATH / "fonts"
+TTF_PATH = FONTS_PATH / "ttf"
+
+# Basic resources in the :assets: handle
 ASSET_PATH = RESOURCE_DIR / "assets"
 
+
 handles: dict[str, list[Path]] = {
     "resources": [SYSTEM_PATH, ASSET_PATH],
     "assets": [ASSET_PATH],
@@ -212,32 +219,91 @@ def list_built_in_assets(
 
 
 def load_kenney_fonts() -> None:
-    """Loads all the fonts in arcade's system directory.
-
-    Currently, this is only the Kenney fonts::
-
-        Kenney_Blocks.ttf          - Kenney Blocks
-        Kenney_Future.ttf          - Kenney Future
-        Kenney_Future_Narrow.ttf   - Kenney Future Narrow
-        Kenney_High.ttf            - Kenney High
-        Kenney_High_Square.ttf     - Kenney High Square
-        Kenney_Mini.ttf            - Kenney Mini
-        Kenney_Mini_Square.ttf     - Kenney Mini Square
-        Kenney_Pixel.ttf           - Kenney Pixel
-        Kenney_Pixel_Square.ttf    - Kenney Pixel Square
-        Kenney_Rocket.ttf          - Kenney Rocket
-        Kenney_Rocket_Square.ttf   - Kenney Rocket Square
+    """Loads all the Kenney.nl fonts bundled with Arcade.
+
+    .. tip:: This function is best for prototyping and experimenting!
+
+         For best performance, you may want to switch to
+         :py:class:`arcade.load_font` before release.
+
+    Please see :ref:`resources-fonts-kenney` for previews and
+    license information. The filename to load and ``font_name`` to use
+    when drawing text are summarized below:
+
+    .. might swap to this style for the resources listing once I figure out how to
+    .. cleanly modify the file to use it.
+
+    =========================================  =========================================================================
+    ``font_name`` for :py:class:`arcade.Text`  :ref:`Resource handle <resource_handles>` for :py:func:`arcade.load_font`
+    =========================================  =========================================================================
+    ``"Kenney Blocks"``                        ``:resources:fonts/ttf/Kenney/Kenney_Blocks.ttf``
+    ``"Kenney Future"``                        ``:resources:fonts/ttf/Kenney/Kenney_Future.ttf``
+    ``"Kenney Future Narrow"``                 ``:resources:fonts/ttf/Kenney/Kenney_Future_Narrow.ttf``
+    ``"Kenney High"``                          ``:resources:fonts/ttf/Kenney/Kenney_High.ttf``
+    ``"Kenney High Square"``                   ``:resources:fonts/ttf/Kenney/Kenney_High_Square.ttf``
+    ``"Kenney Mini"``                          ``:resources:fonts/ttf/Kenney/Kenney_Mini.ttf``
+    ``"Kenney Mini Square"``                   ``:resources:fonts/ttf/Kenney/Kenney_Mini_Square.ttf``
+    ``"Kenney Pixel"``                         ``:resources:fonts/ttf/Kenney/Kenney_Pixel.ttf``
+    ``"Kenney Pixel Square"``                  ``:resources:fonts/ttf/Kenney/Kenney_Pixel_Square.ttf``
+    ``"Kenney Rocket"``                        ``:resources:fonts/ttf/Kenney/Kenney_Rocket.ttf``
+    ``"Kenney Rocket Square"``                 ``:resources:fonts/ttf/Kenney/Kenney_Rocket_Square.ttf``
+    =========================================  =========================================================================
+
+    """  # noqa: E501  # Silence ruff  # pending: better generation
+    from arcade.text import load_font
+
+    load_font(":system:fonts/ttf/Kenney/Kenney_Blocks.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Future.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Future_Narrow.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_High.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_High_Square.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Mini.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Mini_Square.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Pixel.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Pixel_Square.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Rocket.ttf")
+    load_font(":system:fonts/ttf/Kenney/Kenney_Rocket_Square.ttf")
+
+
+def load_liberation_fonts() -> None:
+    """Loads all styles for generic Arial, Courier, and Times New Roman replacements.
+
+    .. tip:: This function is best for prototyping and experimenting!
+
+             For best performance, you may want to switch to
+             :py:class:`arcade.load_font` before release.
+
+    The Liberation fonts are proven, permissively-licensed fonts.[
+    For previews and additional information, please see
+    :ref:`resources-fonts-liberation`.
+
+    .. list-table:: ``font_name`` values for :py:class:`arcade.Text`
+       :header-rows: 1
+
+       * - Proprietary Font(s)
+         - Liberation Replacemetn
+
+       * - ``"Courier"``
+         - ``"Liberation Mono"``
+
+       * - ``"Times New Roman"``, ``"Times"``
+         - ``"Liberation Serif"``
+
+       * - ``"Arial"``
+         - ``"Liberation Sans"``
+
     """
     from arcade.text import load_font
 
-    load_font(":system:fonts/ttf/Kenney_Blocks.ttf")
-    load_font(":system:fonts/ttf/Kenney_Future.ttf")
-    load_font(":system:fonts/ttf/Kenney_Future_Narrow.ttf")
-    load_font(":system:fonts/ttf/Kenney_High.ttf")
-    load_font(":system:fonts/ttf/Kenney_High_Square.ttf")
-    load_font(":system:fonts/ttf/Kenney_Mini.ttf")
-    load_font(":system:fonts/ttf/Kenney_Mini_Square.ttf")
-    load_font(":system:fonts/ttf/Kenney_Pixel.ttf")
-    load_font(":system:fonts/ttf/Kenney_Pixel_Square.ttf")
-    load_font(":system:fonts/ttf/Kenney_Rocket.ttf")
-    load_font(":system:fonts/ttf/Kenney_Rocket_Square.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Mono_BoldItalic.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Mono_Bold.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Mono_Italic.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Mono_Regular.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Sans_BoldItalic.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Sans_Bold.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Sans_Italic.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Sans_Regular.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Serif_BoldItalic.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Serif_Bold.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Serif_Italic.ttf")
+    load_font(":system:fonts/ttf/Liberation/Liberation_Serif_Regular.ttf")

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade/sections.py

@@ -64,8 +64,8 @@ class Section:
         name: str | None = None,
         accept_keyboard_keys: bool | Iterable = True,
         accept_mouse_events: bool | Iterable = True,
-        prevent_dispatch: Iterable | None = None,
-        prevent_dispatch_view: Iterable | None = None,
+        prevent_dispatch: Iterable | bool | None = None,
+        prevent_dispatch_view: Iterable | bool | None = None,
         local_mouse_coordinates: bool = False,
         enabled: bool = True,
         modal: bool = False,
@@ -96,10 +96,18 @@ class Section:
         self.accept_mouse_events: bool | Iterable = accept_mouse_events
         """Arcade mouse events to accept."""
 
-        self.prevent_dispatch: Iterable = prevent_dispatch or {True}
+        if isinstance(prevent_dispatch, bool):
+            prevent_dispatch = {prevent_dispatch}
+        self.prevent_dispatch: Iterable = {True} if prevent_dispatch is None else prevent_dispatch
+        assert isinstance(self.prevent_dispatch, Iterable)
         """prevents events to propagate"""
 
-        self.prevent_dispatch_view: Iterable = prevent_dispatch_view or {True}
+        if isinstance(prevent_dispatch_view, bool):
+            prevent_dispatch_view = {prevent_dispatch_view}
+        self.prevent_dispatch_view: Iterable = (
+            {True} if prevent_dispatch_view is None else prevent_dispatch_view
+        )
+        assert isinstance(self.prevent_dispatch_view, Iterable)
         """prevents events to propagate to the view"""
 
         self.local_mouse_coordinates: bool = local_mouse_coordinates

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: arcade
-Version: 3.0.0.dev41
+Version: 3.0.0.dev42
 Summary: Arcade Game Development Library
 Author-email: Paul Vincent Craven <paul@cravenfamily.com>
 License: License

{arcade-3.0.0.dev41 → arcade-3.0.0.dev42}/arcade.egg-info/SOURCES.txt

@@ -1090,17 +1090,29 @@ arcade/resources/assets/video/earth.mp4
 arcade/resources/assets/video/readme.txt
 arcade/resources/system/gamecontrollerdb.txt
 arcade/resources/system/logo.png
-arcade/resources/system/fonts/ttf/Kenney_Blocks.ttf
-arcade/resources/system/fonts/ttf/Kenney_Future.ttf
-arcade/resources/system/fonts/ttf/Kenney_Future_Narrow.ttf
-arcade/resources/system/fonts/ttf/Kenney_High.ttf
-arcade/resources/system/fonts/ttf/Kenney_High_Square.ttf
-arcade/resources/system/fonts/ttf/Kenney_Mini.ttf
-arcade/resources/system/fonts/ttf/Kenney_Mini_Square.ttf
-arcade/resources/system/fonts/ttf/Kenney_Pixel.ttf
-arcade/resources/system/fonts/ttf/Kenney_Pixel_Square.ttf
-arcade/resources/system/fonts/ttf/Kenney_Rocket.ttf
-arcade/resources/system/fonts/ttf/Kenney_Rocket_Square.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Blocks.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Future.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Future_Narrow.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_High.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_High_Square.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Mini.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Mini_Square.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Pixel.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Pixel_Square.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Rocket.ttf
+arcade/resources/system/fonts/ttf/Kenney/Kenney_Rocket_Square.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Mono_Bold.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Mono_BoldItalic.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Mono_Italic.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Mono_Regular.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Sans_Bold.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Sans_BoldItalic.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Sans_Italic.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Sans_Regular.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Serif_Bold.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Serif_BoldItalic.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Serif_Italic.ttf
+arcade/resources/system/fonts/ttf/Liberation/Liberation_Serif_Regular.ttf
 arcade/resources/system/gui_basic_assets/button/red_disabled.png
 arcade/resources/system/gui_basic_assets/button/red_hover.png
 arcade/resources/system/gui_basic_assets/button/red_normal.png

arcade-3.0.0.dev41/arcade/VERSION

@@ -1 +0,0 @@
-3.0.0-dev.41