pythonarcade
diff --git a/‎CHANGELOG.md‎
Lines changed: 14 additions & 1 deletion b/‎CHANGELOG.md‎
Lines changed: 14 additions & 1 deletion
diff --git a/‎arcade/VERSION‎
Lines changed: 1 addition & 1 deletion b/‎arcade/VERSION‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎arcade/__init__.py‎
Lines changed: 2 additions & 0 deletions b/‎arcade/__init__.py‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎arcade/application.py‎
Lines changed: 2 additions & 68 deletions b/‎arcade/application.py‎
Lines changed: 2 additions & 68 deletions
diff --git a/‎arcade/camera/default.py‎
Lines changed: 14 additions & 13 deletions b/‎arcade/camera/default.py‎
Lines changed: 14 additions & 13 deletions
diff --git a/‎arcade/clock.py‎
Lines changed: 1 addition & 1 deletion b/‎arcade/clock.py‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎arcade/examples/gui/0_basic_setup.py‎
Lines changed: 111 additions & 0 deletions b/‎arcade/examples/gui/0_basic_setup.py‎
Lines changed: 111 additions & 0 deletions
@@ -67,7 +67,14 @@ API in a way that is not compatible with how it was used in 2.6.
   * Removed `arcade.gui.widgets.UIPadding` this is now general available in `arcade.gui.widgets.UIWidget`
   * Removed `arcade.gui.widgets.UITexturePane` this is now general available in `arcade.gui.widgets.UIWidget`
   * Removed `arcade.gui.widgets.UIAnchorWidget` replaced by `arcade.gui.widgets.UIAnchorLayout`
-
+* Resources
+  * removed unsused resources from `resources/gui_basic_assets`
+    * `items/shield_gold.png`
+    * `items/sword_gold.png`
+    * `slider_thumb.png`
+    * `slider_track.png`
+    * `toggle/switch_green.png`
+    * `toggle/switch_red.png`
 ### Featured Updates
 
 * The texture atlas has been heavily reworked to be more efficient.
@@ -131,6 +138,10 @@ API in a way that is not compatible with how it was used in 2.6.
   * Update and add example code.
   * Iterable (providing direct children)
 
+* Updated widgets
+  * `arcade.gui.widgets.text.UIInputText` emits `on_change` event when new text input or set
+  * `arcade.gui.widgets.slider.UITextureSlider` texture names changed to fit general naming pattern
+
 * New widgets:
 
   * `arcade.gui.widgets.dropdown.UIDropdown`
@@ -152,6 +163,8 @@ API in a way that is not compatible with how it was used in 2.6.
   * `arcade.gui.UIAnchorLayout`
   * `arcade.gui.UIGridLayout` [PR1478](https://github.com/pythonarcade/arcade/pull/1478)
 
+* Added color consistent assets to `arcade.resources.gui_basic_assets`
+* Provide GUI friendly color constants in `arcade.uicolor`
 * Replace deprecated usage of `arcade.draw_text`
 
 ### Misc Changes
 
@@ -1 +1 @@
-3.0.0-dev.33
+3.0.0-dev.36
@@ -228,6 +228,7 @@ def configure_logging(level: int | None = None):
 # Module imports
 from arcade import color as color
 from arcade import csscolor as csscolor
+from arcade import uicolor as uicolor
 from arcade import camera as camera
 from arcade import key as key
 from arcade import resources as resources
@@ -387,6 +388,7 @@ def configure_logging(level: int | None = None):
     "rect",
     "color",
     "csscolor",
+    "uicolor",
     "key",
     "resources",
     "types",
 
@@ -20,7 +20,6 @@
 from arcade.clock import GLOBAL_CLOCK, GLOBAL_FIXED_CLOCK, _setup_clock, _setup_fixed_clock
 from arcade.color import TRANSPARENT_BLACK
 from arcade.context import ArcadeContext
-from arcade.sections import SectionManager
 from arcade.types import LBWH, Color, Rect, RGBANormalized, RGBOrA255
 from arcade.utils import is_raspberry_pi
 from arcade.window_commands import get_display_size, set_window
@@ -979,37 +978,21 @@ def show_view(self, new_view: View) -> None:
         # remove previously shown view's handlers
         if self._current_view is not None:
             self._current_view.on_hide_view()
-            if self._current_view.has_sections:
-                self.remove_handlers(self._current_view.section_manager)
             self.remove_handlers(self._current_view)
 
         # push new view's handlers
         self._current_view = new_view
-        if new_view.has_sections:
-            section_manager_managed_events = new_view.section_manager.managed_events
-            section_handlers = {
-                event_type: getattr(new_view.section_manager, event_type, None)
-                for event_type in section_manager_managed_events
-            }
-            if section_handlers:
-                self.push_handlers(**section_handlers)
-        else:
-            section_manager_managed_events = set()
 
         # Note: Excluding on_show because this even can trigger multiple times.
         #       It should only be called once when the view is shown.
         view_handlers = {
             event_type: getattr(new_view, event_type, None)
             for event_type in self.event_types
-            if event_type != "on_show"
-            and event_type not in section_manager_managed_events
-            and hasattr(new_view, event_type)
+            if event_type != "on_show" and hasattr(new_view, event_type)
         }
         if view_handlers:
             self.push_handlers(**view_handlers)
         self._current_view.on_show_view()
-        if self._current_view.has_sections:
-            self._current_view.section_manager.on_show_view()
 
         # Note: After the View has been pushed onto pyglet's stack of event handlers
         # (via push_handlers()), pyglet
@@ -1028,18 +1011,9 @@ def hide_view(self) -> None:
             return
 
         self._current_view.on_hide_view()
-        if self._current_view.has_sections:
-            self._current_view.section_manager.on_hide_view()
-            self.remove_handlers(self._current_view.section_manager)
         self.remove_handlers(self._current_view)
         self._current_view = None
 
-    # def _create(self) -> None:
-    #     super()._create()
-
-    # def _recreate(self, changes) -> None:
-    #     super()._recreate(changes)
-
     def flip(self) -> None:
         """
         Present the rendered content to the screen.
@@ -1249,7 +1223,7 @@ class View:
     Subclassing the window is very inflexible since you can't easily switch
     your update and draw logic.
 
-    A view is a way to encapsulate that logic so you can easily switch between
+    A view is a way to encapsulate that logic, so you can easily switch between
     different parts of your game. Maybe you have a title screen, a game screen,
     and a game over screen. Each of these could be a different view.
 
@@ -1261,46 +1235,6 @@ class View:
 
     def __init__(self, window: Window | None = None) -> None:
         self.window = arcade.get_window() if window is None else window
-        self.key: int | None = None
-        self._section_manager: SectionManager | None = None
-
-    @property
-    def section_manager(self) -> SectionManager:
-        """The section manager for this view.
-
-        If the view has section manager one will be created.
-        """
-        if self._section_manager is None:
-            self._section_manager = SectionManager(self)
-        return self._section_manager
-
-    @property
-    def has_sections(self) -> bool:
-        """Returns ``True`` if this view has sections."""
-        if self._section_manager is None:
-            return False
-        else:
-            return self.section_manager.has_sections
-
-    def add_section(
-        self,
-        section: arcade.Section,
-        at_index: int | None = None,
-        at_draw_order: int | None = None,
-    ) -> None:
-        """
-        Adds a section to the view Section Manager.
-
-        Args:
-            section:
-                The section to add to this section manager
-            at_index (optional):
-                The index to insert the section for event capture and
-                update events. If ``None`` it will be added at the end.
-            at_draw_order (optional):
-                Inserts the section in a specific draw order. Overwrites section.draw_order
-        """
-        self.section_manager.add_section(section, at_index, at_draw_order)
 
     def clear(
         self,
 
@@ -6,7 +6,7 @@
 from pyglet.math import Mat4, Vec2, Vec3
 from typing_extensions import Self
 
-from arcade.types import Point
+from arcade.types import LBWH, Point, Rect
 from arcade.window_commands import get_window
 
 if TYPE_CHECKING:
@@ -29,28 +29,28 @@ class ViewportProjector:
 
     def __init__(
         self,
-        viewport: tuple[int, int, int, int] | None = None,
+        viewport: Rect | None = None,
         *,
         context: ArcadeContext | None = None,
     ):
-        self._ctx = context or get_window().ctx
-        self._viewport = viewport or self._ctx.viewport
+        self._ctx: ArcadeContext = context or get_window().ctx
+        self._viewport: Rect = viewport or LBWH(*self._ctx.viewport)
         self._projection_matrix: Mat4 = Mat4.orthogonal_projection(
-            0.0, self._viewport[2], 0.0, self._viewport[3], -100, 100
+            0.0, self._viewport.width, 0.0, self._viewport.height, -100, 100
         )
 
     @property
-    def viewport(self) -> tuple[int, int, int, int]:
+    def viewport(self) -> Rect:
         """
         The viewport use to derive projection and view matrix.
         """
         return self._viewport
 
     @viewport.setter
-    def viewport(self, viewport: tuple[int, int, int, int]) -> None:
+    def viewport(self, viewport: Rect) -> None:
         self._viewport = viewport
         self._projection_matrix = Mat4.orthogonal_projection(
-            0, viewport[2], 0, viewport[3], -100, 100
+            0, viewport.width, 0, viewport.height, -100, 100
         )
 
     def use(self) -> None:
@@ -60,7 +60,7 @@ def use(self) -> None:
         """
         self._ctx.current_camera = self
 
-        self._ctx.viewport = self._viewport
+        self._ctx.viewport = self.viewport.viewport  # get the integer 4-tuple LBWH
 
         self._ctx.view_matrix = Mat4()
         self._ctx.projection_matrix = self._projection_matrix
@@ -121,18 +121,19 @@ def use(self) -> None:
         cache's the window viewport to determine the projection matrix.
         """
 
+        viewport = self.viewport.viewport
         # If the viewport is correct and the default camera is in use,
         # then don't waste time resetting the view and projection matrices
-        if self._ctx.viewport == self.viewport and self._ctx.current_camera == self:
+        if self._ctx.viewport == viewport and self._ctx.current_camera == self:
             return
 
         # If the viewport has changed while the default camera is active then the
         # default needs to update itself.
         # If it was another camera's viewport being used the default camera should not update.
-        if self._ctx.viewport != self.viewport and self._ctx.current_camera == self:
-            self.viewport = self._ctx.viewport
+        if self._ctx.viewport != viewport and self._ctx.current_camera == self:
+            self.viewport = LBWH(*self._ctx.viewport)
         else:
-            self._ctx.viewport = self.viewport
+            self._ctx.viewport = viewport
 
         self._ctx.current_camera = self
 
 
@@ -124,7 +124,7 @@ class FixedClock(Clock):
 
     Args:
         sibling: The unfixed clock which this clock will sync with.
-        fixed_tick_rate (float, optional): The fixed number of seconds that pass
+        fixed_tick_rate: The fixed number of seconds that pass
             for this clock every tick. Defaults to ``1.0 / 60.0``.
     """
 
 
@@ -0,0 +1,111 @@
+"""Demonstrates general setup.
+
+If arcade and Python are properly installed, you can run this example with:
+python -m arcade.examples.gui.0_basic_setup
+
+Content:
+- create a view manually creating UIManager and adding widgets
+- create a second view extending UIView and adding widgets
+
+"""
+
+import arcade
+from arcade.gui import (
+    UIManager,
+    UITextureButton,
+    UIAnchorLayout,
+)
+
+# Preload textures, because they are mostly used multiple times, so they are not
+# loaded multiple times
+TEX_RED_BUTTON_NORMAL = arcade.load_texture(":resources:gui_basic_assets/button/red_normal.png")
+TEX_RED_BUTTON_HOVER = arcade.load_texture(":resources:gui_basic_assets/button/red_hover.png")
+TEX_RED_BUTTON_PRESS = arcade.load_texture(":resources:gui_basic_assets/button/red_press.png")
+
+
+class GreenView(arcade.View):
+    """Uses the arcade.View and shows how to integrate UIManager."""
+
+    def __init__(self):
+        super().__init__()
+
+        # Create a UIManager
+        self.ui = UIManager()
+
+        # Create a anchor layout, which can be used to position widgets on screen
+        anchor = self.ui.add(UIAnchorLayout())
+
+        # Add a button switch to the other View.
+        button = anchor.add(
+            UITextureButton(
+                text="Switch to blue view",
+                texture=TEX_RED_BUTTON_NORMAL,
+                texture_hovered=TEX_RED_BUTTON_HOVER,
+                texture_pressed=TEX_RED_BUTTON_PRESS,
+                on_click=lambda: self.window.show_view(self.window.views["other"]),
+            )
+        )
+
+        # add a button to switch to the blue view
+        @button.event("on_click")
+        def on_click(event):
+            self.window.show_view(BlueView())
+
+    def on_show_view(self) -> None:
+        self.ui.enable()
+
+    def on_hide_view(self) -> None:
+        self.ui.disable()
+
+    def on_draw(self):
+        # Clear the screen
+        self.clear(color=arcade.uicolor.GREEN_EMERALD)
+
+        # Add draw commands that should be below the UI
+        # ...
+
+        self.ui.draw()
+
+        # Add draw commands that should be on top of the UI (uncommon)
+        # ...
+
+
+class BlueView(arcade.gui.UIView):
+    """Uses the arcade.gui.UIView which takes care about the UIManager setup."""
+
+    def __init__(self):
+        super().__init__()
+        self.background_color = arcade.uicolor.BLUE_PETER_RIVER
+
+        # Create a anchor layout, which can be used to position widgets on screen
+        anchor = self.add_widget(UIAnchorLayout())
+
+        # Add a button switch to the other View.
+        button = anchor.add(
+            UITextureButton(
+                text="Switch to green view",
+                texture=TEX_RED_BUTTON_NORMAL,
+                texture_hovered=TEX_RED_BUTTON_HOVER,
+                texture_pressed=TEX_RED_BUTTON_PRESS,
+                on_click=lambda: self.window.show_view(self.window.views["my"]),
+            )
+        )
+
+        # add a button to switch to the green view
+        @button.event("on_click")
+        def on_click(event):
+            self.window.show_view(GreenView())
+
+    def on_draw_before_ui(self):
+        # Add draw commands that should be below the UI
+        pass
+
+    def on_draw_after_ui(self):
+        # Add draw commands that should be on top of the UI (uncommon)
+        pass
+
+
+if __name__ == "__main__":
+    window = arcade.Window(title="GUI Example: Basic Setup")
+    window.show_view(GreenView())
+    window.run()