Pyglet

Changes and Improvements
------------------------
- shader: add support for OpenGL structures in UBO's (1212)
- win32.com: get libs/win32/com.py ready for incoming 3.13 changes 1199
- docs: fix various typos, and example code to align with docs 1200, 1201
- text.document: add new AbstractDocument.append_text method for more efficient end-of-text additions 1182
- tests: fix issues with broken tests on macOS.
- input.macos: add missing axis alias for modern controllers (Stadia, newer XBOX One)
- gui.NinePatch: Add a new NinePatch.create_around_layout class method
- typing: add py.typed file 1205

Bugfixes
--------
- shader: fix matrix uniform assignment 1194
- text: fix missing caret top level import
- text.layout: fix updating anchor on the X axis 1213
- text.layout: move get_line_count function into the base TextLayout class
- window.macos: fix blinking cursor in bottom left of window 1204
- examples: fix rectangle not appearing in text_input example
- macos: fix missing dealloc for text view.
- macos: fix some deallocation issues when creating multiple windows.
- macos: fix event loop termination exiting the entire app.
- macos: fix focus being stolen by other apps during launch. (1211)
- macos: fix error about pygletUpdate when closing a window. (1219)
- macos: fix function keys not registering. (1220)
- docs: move check for `sys.modules['sphinx']` into doc/conf.py to prevent conflicts with jupyter 1215

Changes and Improvements
------------------------
- image: Use dedicated shader for blitting to fix blending issues. (1170)
- shapes: Add a way to set blend mode on initialization and after.
- shapes: Add a get_shape_group function.
- shapes: Add a way to change shape shader program.
- pyglet.experimental: Add multi-texture sprite support. (1166)
- graphics.vertexbuffer: (internal) Rename buffer object `sub_data` to `commit` to better reflect it's usage. (1186)
- gui: Add on_mouse_enter/leave event handler to WidgetBase and use it in Buttons (1190)
- graphics.vertexdomain: Update program migration to its own function: update_shader.
- graphics.vertexdomain: Changing programs no longer requires batch, as that doesn't change with a program change.
- graphics.vertexdomain: Allow migration of shaders through deleting vertex lists.
- graphics.vertexdomain: Remove `isinstance` check for VertexList and go off the class variable that is set.

Bugfixes
--------
- image: Fix Texture3D.create_for_images method.
- typing: Fix pyglet.options type checking.
- shader: Fix UBO arrays. (1168)
- sprite: Fix paused animation frame index. (1180)
- window: win32: Fix Window.set_icon.best_icon. (1183)
- options: Fix audio and vsync env vars. (1185)
- audio: Remove `PreciseStreamingSource`; Move audio buffering back into Players. (1175)

Changes and Improvements
------------------------
- library-wide overhaul of docstrings, and addition of type hints. (1084)
- sprite: Add `blend_mode` property to change BLEND_MODE without needing to re-create the Sprite.
- sprite: Deprecate `AdvancedSprite`, and merge functionality into default `Sprite` class.
- sprite: Add `get_sprite_group` method, allowing easy usage of custom SpriteGroups in subclasses.
- image: Code for `Texture.blit` has been inlined. (1109)
- shapes: Concave polygon can be drawn by earcutting a polygon. (1121)
- shapes: Add Rounded Rectangle shape. (1131)
- shapes: Add `thickness` property to `Box` shapes.
- libs: Add `pyglet.libs.ioctl` module, to consolidate shared code on Linux.
- gui: Add a pseudo "nine-path" Sprite-like class for variable sized windows.
- math: Add `match` statement support to Vec classes.
- graphics: Don't re-create a Shader each call to `draw` or `draw_indexed`.
- graphics: Greatly improve Uniform Buffer Objects and Buffer Object binding behavior.
- pyglet.options: Add `shader_bind_management` option for users who want to have more control over UBO binding behavior.
- pyglet.options: Add runtime typing enforcement to user-set options.
- pyglet.experimental: Add simple GPU-based particle system in `particles` module.
- text.layout: Update `on_style_text` to be more efficient.

Bugfixes
--------
- window.macos: Fix constant appearance of blinking caret on M1 based Macs. (1160)
- window.xlib: Avoid XSet/UnsetICFocus calls when _have_utf8 is False. (1049)
- window.win32: Fix application not updating timers and redrawing during moves. (1125)
- shapes: Add missing `thickness` property to Box.
- shapes: Add missing docstrings to `Arc` `thickness` property.
- shapes: Fix ShapeBase.group setter to only migrate batch when batch is not None. (1090)
- shapes: BezierCurve: fix miter artifacts from 1134. (1155)
- examples: Fix "more" button outline in soundspace example. (1085)
- tests: Fix a rarely-failing audio time test. (1092)
- input.controller: Fix accidentially missed mappings.
- graphics.shader: Add missing parent program reference in Uniforms (1103)
- graphics.domain: Fix VertexList.resize method.
- text.directwrite: Fix crash with dw_legacy_naming. Check if a custom collection exists before find a font with it.

Changes and Improvements
------------------------
- font: Clean up win32 legacy font renderer to remove unused or outdated code.
- font: Boxes are now primary update method for TextLayout instead of relying on the vertex_list of the TextLayout.
- font: More typing additions.
- gui.widgets: Add _set_enabled hook (1073)
- shapes: Add missing BezierCurve thickness property.
- graphics: Re-raise error for attributes during shader creation with better error descriptions. (1076)
- docs: Start adding GUI section to the programming guide.
- typing: Add stub file for init package to workaround IDE inspection/completion issues with lazy loading modules. (1077)
- examples: Add more visual feedback to the Controller example

Bugfixes
--------
- Xaudio2: Fix missing `)` to POINTER which causes XAudio2 to fail to be imported. (1068)
- font.caret: Fix caret positioning and moving the cursor during cursor selection. (932)
- input.controller: User added mappings should take higher priority over default mappings.
- input.controller: Properly handle inverted axis as dpad (1078)
- shapes: Added a None check to ShapeBase.delete (1075)
- shapes: Fix Line being off-centered when setting thickness 1083
- image: Fix BufferManager.get_depth_buffer() for GL3+.

Changes and Improvements
------------------------
- shapes: Add new MultiLine shape. (1057)
- font: Enhance UserDefinedFonts to allow using custom font mapping functions (1067)
- typing: Improve Xaudio2 COM type hints (1062)
- text: Raise Exception when attempting to change IncrementalTextLayout.rotation, as it's not supported.
- tests.integration: Add simple sanity tests for creation of all Label, Document, and Layout objects.

Bugfixes
--------
- input.win32: Fix broken xinput get_devices and get_controllers methods (1060)
- shapes: Fix incorrect BezierCurve positioning, and Line rotation. (1084)
- app: Fix CFSTR.release() bugs in macOS event loop. (1059)
- font: Fix missing annotation import causing a crash for GDI.
- text.caret: Caret now properly works with other Layout content valigns other than top.
- text.layout: Ensure all TextLayouts have consistent argument ordering.
- text.layout: Fix left, right, bottom, top Layout parameters not being correct.
- text.layout: Fix changing anchor not updating the translation.
- text.layout: Fix for lines getting garbled in an IncrementalTextLayout when using a content-valign other than top.
- text.layout: Fix IncrementalTextLayout setting visible line count instead of total line count.
- text.layout: Fix translation sometimes not updating all of the GlyphBoxes.
- text.layout: Fix _update_anchor not updating vertex lists of IncrementalTextLayout.
- text.layout: Fix _update_flow_glyphs not updating line count when it breaks it's loop.
- text.layout: Fix deleting lines at the end of a multilined IncrementalTextLayout not reducing view size.
- text.layout: Fix shader to conform to new anchors.
- text.layout: Rotation no longer requires destroying the whole layout, it now just updates attributes.
- text.layout: Anchor bottom fix for Scrollable/Incremental.

Note: This version is a quick bugfix release that superceeds v2.0.11.
The previous release contained a bug that broke Batch/Group migration, which has now been fixed (and a unit test added for).

Changes and Improvements
------------------------
- media: major internal audio cleanup, bugfixes, and improvements on all platforms.
- various typing and documentation improvements.
- math: add Quaternion class with common methods.
- shader: add support for setting and getting arrays in a Uniform via wrapper. (1005)
- shapes: add radius property get and set to Arc class. (1013)
- sprite, shapes: Avoid extra step of updating vertex list after creation. (1016)
- shapes: allow setting the line thickness of Arc and BezierCurve shapes. (1028, 1030)
- text: add Caret.select_all method.
- text: performance improvements on instantiation, visibility, anchors, positions. (1004)
- text: add left, right, bottom, top attributes. (1004)
- text: add program argument for custom shaders. (1037)
- text: add get_as_texture function to render text to a new texture. (1037)
- font: skip pre-parsing all system fonts to improve speed. Check only when needed.

Bugfixes
--------
- macOS: prevent crash when scanning for Controllers if device.transport is None. (995)
- input: avoid crash when encountering controls with invalid min/max values. (986)
- xlib: fix missed argument in window drag.
- media: fix bad behavior when clearing XAudio2AudioPlayer. (1011)
- pyglet.__init__: don't install debug_trace until after module proxies 1046
- media: numerous fixes to race conditions and deadlocks across all backends.
- experimental: Fix incorrect texture UVs and final positioning for GeometryShader Sprite.
- image: add missing binding calls for blit_to/texture methods.