Merge branch 'development' into gui/improvements

Author: eruvanos

.pre-commit-config.yaml

@@ -1,5 +1,5 @@
 default_language_version:
-  python: python3.10
+  python: python3.13
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks

CHANGELOG.md

@@ -3,18 +3,47 @@
 You can grab pre-release versions from PyPi. See the available versions from the
 Arcade [PyPi Release History](https://pypi.org/project/arcade/#history) page.
 
-## Unreleased
+## 3.3.0
 
 - Fixed an issue causing a crash when closing the window
-- Added `Window.close` (bool) attribute indicating if the window is closed
+- Added `Window.closed` (bool) attribute indicating if the window is closed
+- Fixed an issue where `on_draw` could be dispatched after the window was closed
+- Added `PymunkPhysicsEngine.update_sprite` for manually updating a sprite's shape
+  to synchronize sprite hit boxes with the physics engine
+- Fixed an issue causing `on_mouse_leave` to be called from disabled `Section`s
+- Various documentation fixes and improvements
+- Scene
+  - `Scene.add_sprite` now returns the added sprite
+  - `Scene.add_sprite_list` now returns the added sprite list
+  - `Scene.add_sprite_before` now returns the added sprite list
+  - `Scene.move_sprite_list_before` now returns the moved sprite list
+  - `Scene.remove_sprite_list_by_index` now returns the removed sprite list
+  - `Scene.remove_sprite_list_by_name` now returns the removed sprite list
 - GUI
+  - Fix `UILabel` with enabled multiline sometimes cut off text
+  - Improved `UIWidget` usability for resizing and positioning:
+    - Added property setters for `width`, `height`, and `size` that ensure positive values
+    - Added property setters for `center_x` and `center_y`
+    - Added property setters for `left`, `right`, `top`, and `bottom`
+    - Users can now set widget position and size more intuitively without needing to access the `rect` property
   - Property listener can now receive:
     - no args
     - instance
     - instance, value
     - instance, value, old value
     > Listener accepting `*args` receive `instance, value` like in previous versions.
 
+- Rendering:
+  - The `arcade.gl` package was restructured to be more modular in preparation for
+    other backends such as WebGL and WebGPU
+  - Rewrote many shader programs to not use geometry shaders, which are not supported in WebGL
+    and some other rendering backends
+  - Fixed a few instances og exceptions not being raised properly in edge cases
+  - **BREAKING CHANGE**: `SpriteList` now has multiple rendering systems supporting both WebGL and Desktop GL.
+    If you have customized spritelist rendering you now need to modify the `SpriteListData` instance
+    on the spritelist accessed through `SpriteList.data`. This instance holds all the GPU-related
+    resources for the spritelist such as buffers, textures, geometry and shader program.
+
 ## Version 3.2
 
 - GUI

CONTRIBUTING.md

@@ -254,10 +254,10 @@ language.
 On Linux distros based on Debian and Ubuntu, you may need to install
 the following packages to build PDFs:
 
-``console
+```console
 sudo apt install latexmk
 sudo apt install texlive-latex-extra
-``
+```
 To reduce the large (300 MB+) install size of the second package, you
 may be able to use the `--no-install-recommends` flag.
 

README.md

@@ -1,4 +1,4 @@
-# Welcome to The Arcade Library!
+# Welcome to The Arcade Library
 
 <p align="center">
     <a href="https://img.shields.io/pypi/l/arcade">
@@ -40,29 +40,29 @@ for example game jam entries and more.
 
 ## Stable Documentation
 
-Read the stable documentation at https://api.arcade.academy.
+Read the stable documentation at <https://api.arcade.academy>.
 
 ## Development Previews
 
-Preview the next release at https://api.arcade.academy/en/development/.
+Preview the next release at <https://api.arcade.academy/en/development/>.
 
 ## Citation
 
 ```
-    @Online{PythonArcade,
-       author = {Paul Vincent Craven},
-       title = {Easy to use Python library for creating 2D Arcade games.},
-       date = {2023-01-01},
-       publisher = {GitHub},
-       journal = {GitHub repository},
-       howpublished = {\url{https://github.com/pythonarcade/arcade}},
-       commit = {<insert hash if needed>}
-    }
+@Online{PythonArcade,
+    author = {Paul Vincent Craven},
+    title = {Easy to use Python library for creating 2D Arcade games.},
+    date = {2025-01-01},
+    publisher = {GitHub},
+    journal = {GitHub repository},
+    howpublished = {\url{https://github.com/pythonarcade/arcade}},
+    commit = {<insert hash if needed>}
+}
 ```
 
 ## Contact the Maintainers
 
 The best way to contact and chat with the maintainers is on the
 [Arcade Discord Server][].
 
-[email protected]
+<[email protected]>

arcade/VERSION

@@ -1 +1 @@
-3.2.0
+3.3.0

arcade/application.py

@@ -22,8 +22,9 @@
 from arcade.clock import GLOBAL_CLOCK, GLOBAL_FIXED_CLOCK, _setup_clock, _setup_fixed_clock
 from arcade.color import BLACK
 from arcade.context import ArcadeContext
+from arcade.gl.provider import get_arcade_context, set_provider
 from arcade.types import LBWH, Color, Rect, RGBANormalized, RGBOrA255
-from arcade.utils import is_raspberry_pi
+from arcade.utils import is_pyodide, is_raspberry_pi
 from arcade.window_commands import get_display_size, set_window
 
 if TYPE_CHECKING:
@@ -157,7 +158,7 @@ def __init__(
         center_window: bool = False,
         samples: int = 4,
         enable_polling: bool = True,
-        gl_api: str = "gl",
+        gl_api: str = "opengl",
         draw_rate: float = 1 / 60,
         fixed_rate: float = 1.0 / 60.0,
         fixed_frame_cap: int | None = None,
@@ -167,10 +168,17 @@ def __init__(
         if os.environ.get("REPL_ID"):
             antialiasing = False
 
+        desired_gl_provider = "opengl"
+        if is_pyodide():
+            gl_api = "webgl"
+
+        if gl_api == "webgl":
+            desired_gl_provider = "webgl"
+
         # Detect Raspberry Pi and switch to OpenGL ES 3.1
         if is_raspberry_pi():
             gl_version = 3, 1
-            gl_api = "gles"
+            gl_api = "opengles"
 
         self.closed = False
         """Indicates if the window was closed"""
@@ -184,7 +192,7 @@ def __init__(
                 config = gl.Config(
                     major_version=gl_version[0],
                     minor_version=gl_version[1],
-                    opengl_api=gl_api,  # type: ignore  # pending: upstream fix
+                    opengl_api=gl_api.replace("open", ""),  # type: ignore  # pending: upstream fix
                     double_buffer=True,
                     sample_buffers=1,
                     samples=samples,
@@ -208,7 +216,7 @@ def __init__(
             config = gl.Config(
                 major_version=gl_version[0],
                 minor_version=gl_version[1],
-                opengl_api=gl_api,  # type: ignore  # pending: upstream fix
+                opengl_api=gl_api.replace("open", ""),  # type: ignore  # pending: upstream fix
                 double_buffer=True,
                 depth_size=24,
                 stencil_size=8,
@@ -277,7 +285,9 @@ def __init__(
 
         self.push_handlers(on_resize=self._on_resize)
 
-        self._ctx: ArcadeContext = ArcadeContext(self, gc_mode=gc_mode, gl_api=gl_api)
+        set_provider(desired_gl_provider)
+        self._ctx: ArcadeContext = get_arcade_context(self, gc_mode=gc_mode, gl_api=gl_api)
+        # self._ctx: ArcadeContext = ArcadeContext(self, gc_mode=gc_mode, gl_api=gl_api)
         self._background_color: Color = BLACK
 
         self._current_view: View | None = None