Improve Sections (#1392)

* Complete and improved docstrings with params
Section.draw_order can now be smaller than zero
Breaking change: Section.mouse_is_on_top now only checks for the section dimensions and not the event capture area. To check if a section should capture an event use Section.should_receive_mouse_event
Event capture properties removed and set as attributes that are automatically set
Improved some attribute access
Improved SectionManager.get_section_by_name
SectionManager.clear_sections will now call Section.on_hide_section on each one
Improved SectionManager.get_sections with a generator expression
Added event_capture param to SectionManager get_first_section and get_sections to allow to get sections based on event capture dimensions or on draw dimensions

* fix unexpected identation complain

* fix arcade.Camera: Vec2 now operates multiplication on scalar values and not on other Vec2

* fix docstrings

* fix docstrings ...

* fix docstrings ...

* fix docstrings ...

* fix docstrings ...

Author: Alejandro Casanovas

arcade/camera.py

@@ -489,7 +489,7 @@ def update(self) -> None:
 
             # Come up with a new velocity, pulled by opposite vector and damped
             self.shake_velocity += opposite_vector
-            self.shake_velocity *= Vec2(self.shake_damping, self.shake_damping)
+            self.shake_velocity *= self.shake_damping
 
             update_view_matrix = True
 

arcade/examples/sections_demo_3.py

@@ -259,9 +259,9 @@ def __init__(self):
 
         # create and store the modal, so we can set
         # self.modal_section.enabled = True to show it
-        self.modal_section = ModalSection(self.window.width / 3,
+        self.modal_section = ModalSection((self.window.width / 2) - 150,
                                           (self.window.height / 2) - 100,
-                                          400, 200)
+                                          300, 200)
 
         # we set accept_keyboard_events to False (default to True)
         self.info_bar = InfoBar(0, self.window.height - INFO_BAR_HEIGHT, self.window.width, INFO_BAR_HEIGHT,