Pygame-ce

🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗

pip uninstall pygame (if previously installed, to avoid package conflicts)
pip install pygame-ce --upgrade

🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗🐉🛡️🔥🥇📗

Hello all! We are pleased to announce the first pygame-ce release of 2025.

Since last release, our underlying library SDL (Simple DirectMedia Layer) has released SDL3, with tons of shiny new features and lots of breaking changes. Our goal is to get our existing API fully working on top of SDL3, then focus on a pygame-ce 3.0 release with SDL3 + cool SDL3 features + a few minor backwards compatibility tweaks-- nothing crazy but more than we would feel comfortable changing in a release normally. See https://github.com/pygame-community/pygame-ce/issues/2760 for a discussion of potential pygame-ce 3.0 API changes. To that end, significant effort this release went to getting things more ready for SDL3, but we still have a ways to go. And this plan may change, just wanted to share what we're thinking.

Before we get into the meat of the changes,

* This release drops support for Python 3.8, as it is end of life. (Contributed by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3143)
* This release raises the minimum SDL2 version to 2.0.14 (Contributed by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3213)

Enhancements
* gresm added an option for `pygame.Window`s to not show up in the taskbar, for "utility windows". `pygame.Window(utility=True)`. Added in https://github.com/pygame-community/pygame-ce/pull/3226.
* damusss Added "erase" and "repeat" options for [`Surface.scroll`](https://pyga.me/docs/ref/surface.html#pygame.Surface.scroll) in https://github.com/pygame-community/pygame-ce/pull/2855.
* damusss Expanded color type support (not just tuples, but also color strings like other APIs accept) for mask.from_threshold. He also fixed the type stubs for PixelArray methods to correctly indicate they don't have the expanded color type support. See https://github.com/pygame-community/pygame-ce/pull/3164.
* MrRedstone058 added `Line` methods and `length` attribute to the experimental geometry module in https://github.com/pygame-community/pygame-ce/pull/3179.


Bugfixes
* Matiiss Added runtime support for type hinting sprite Groups like other Python containers. E.g. `group: pygame.sprite.Group[MySpriteClass] = pygame.sprite.Group()` tells type hinters that this is a sprite group of MySpriteClass instances. Contributed in https://github.com/pygame-community/pygame-ce/pull/3053.
* ankith26 Fixed a bug in saving Surfaces as TGA images, where they could overrun allocated memory and crash, in https://github.com/pygame-community/pygame-ce/pull/3169.
* yunline Added the missing BLENDMODE_MUL (relevant to the experimental _sdl2.video module) in https://github.com/pygame-community/pygame-ce/pull/3258.
* ankith26, MyreMylar, and zoldalma999 all worked together (we love to see it) to straighten out event.peek behavior between implementation, type hints, and documentation, in https://github.com/pygame-community/pygame-ce/pull/3283. Classifying this as a bugfix because the previous behavior was a mistake and has been fixed.


Peformance improvements
* Starbuck5 removed unnecessary calls to PyNumber_Index, PyLong_Check-- speeding up `x = rect[0]` and `rect[0] = x` 7-9% percent-- in https://github.com/pygame-community/pygame-ce/pull/3242.
* Starbuck5 optimized an internal function that converts pairs of Python numbers into C integers or floats. This function is used all over the place, but is only significant for functions that were pretty quick anyways. Rect.move_ip and Rect.collidepoint were tested to be 19% and 17% faster, respectively. Contributed in https://github.com/pygame-community/pygame-ce/pull/3214.
* ankith26 and damusss improved the speed of color parsing for color names (e.g `"green"`) and string hex values (e.g. `"FF00FF"`) by more than 2x, by adding a fast path before stranger arguments are considered. Contributed in https://github.com/pygame-community/pygame-ce/pull/3297 and https://github.com/pygame-community/pygame-ce/pull/3302.


Deprecations
* ankith26 deprecated `Window`'s `foreign` kwarg and `Window.focus`'s `input_only` kwarg in https://github.com/pygame-community/pygame-ce/pull/3234
* Starbuck5 marked old type aliases as deprecated (SurfaceType, RectType --- just use Surface and Rect!) https://github.com/pygame-community/pygame-ce/pull/3288


Docs and Types
* zoldalma999 began implementation of a new documentation system where we generate the docs from a unified representation in the type hints. This will allow editors to see and display the documentation of each function as the user uses it. Currently this is only implemented for the time and cursors modules, it is planned to roll out to other modules in future releases. See https://github.com/pygame-community/pygame-ce/pull/3188.

<p align="center">
<img src="https://github.com/user-attachments/assets/ab7ce39e-3aa0-4628-a20e-705a0ce22033" alt="An example before/after with docs in the type hints" width="800"/>
</p>

* aatle improved the type hints, especially around Color, Rect, display, and geometry. See https://github.com/pygame-community/pygame-ce/pull/3172, https://github.com/pygame-community/pygame-ce/pull/3183, https://github.com/pygame-community/pygame-ce/pull/3248, and https://github.com/pygame-community/pygame-ce/pull/3264.
* gavinmorrow fixed a grammar mistake in the Window docs in https://github.com/pygame-community/pygame-ce/pull/3194.
* Starbuck5 corrected some older docs content and some recent invalid formatting that got through, in https://github.com/pygame-community/pygame-ce/pull/3204, https://github.com/pygame-community/pygame-ce/pull/3205, https://github.com/pygame-community/pygame-ce/pull/3266, https://github.com/pygame-community/pygame-ce/pull/3272, and https://github.com/pygame-community/pygame-ce/pull/3316.
* ankith26 improved the type hints around the experimental geometry and _sdl2 modules, as well as the freetype module, in https://github.com/pygame-community/pygame-ce/pull/3212, https://github.com/pygame-community/pygame-ce/pull/3300, https://github.com/pygame-community/pygame-ce/pull/3301.
* damusss expanded the type hints for `pygame.Window` init keyword arguments to make them easier to discover in editors/IDEs, see https://github.com/pygame-community/pygame-ce/pull/3295.
* XORandom and noahcse worked on Russian and Traditional Chinese readmes, respectively, in https://github.com/pygame-community/pygame-ce/pull/3138 and https://github.com/pygame-community/pygame-ce/pull/3113.
* GabrieleLS added a note to the mixer documentation about different meanings of the word "channel" in https://github.com/pygame-community/pygame-ce/pull/3228.
* JovialKnoll did a grammar fix and removed incorrect information from the Surface docs in https://github.com/pygame-community/pygame-ce/pull/3231 and https://github.com/pygame-community/pygame-ce/pull/3263
* yunline fixed a formatting mistake in sndarray.rst and cursors.rst in https://github.com/pygame-community/pygame-ce/pull/3257
* Matiiss documented how volume is stored internally for `(get|set)_volume` functions/methods (129-value scale) in https://github.com/pygame-community/pygame-ce/pull/3091


Tests and Examples
* damusss Added `__name__ == "__main__"` guards to the examples, so they can't be accidentally run on import. People occasionally import them on accident, like in [this case](https://www.reddit.com/r/pygame/comments/1f8q8x4/someone_please_explain_to_me_what_this_is/). Contributed in https://github.com/pygame-community/pygame-ce/pull/3181.
* Akaracy added a test for draw.arc in https://github.com/pygame-community/pygame-ce/pull/3230.
* MyreMylar renamed TestTags so it doesn't get confused for a test in https://github.com/pygame-community/pygame-ce/pull/3276.
* MyreMylar fixed *most of* the Deprecation Warnings in surfarray_test in https://github.com/pygame-community/pygame-ce/pull/3274.


SDL 3 porting
* Starbuck5 put in several PRs to getting modules compiling or get modules closer to compiling, focusing on modules failing because of SDL3's pixelformat changes. See https://github.com/pygame-community/pygame-ce/pull/3166, https://github.com/pygame-community/pygame-ce/pull/3171, https://github.com/pygame-community/pygame-ce/pull/3278, https://github.com/pygame-community/pygame-ce/pull/3294, https://github.com/pygame-community/pygame-ce/pull/3308, https://github.com/pygame-community/pygame-ce/pull/3307.
* ankith26 put in a bunch of PRs as well, getting time, surflock, constants, event, imageext, window, key, and mouse all compiling for SDL3. See https://github.com/pygame-community/pygame-ce/pull/3206, https://github.com/pygame-community/pygame-ce/pull/3217, https://github.com/pygame-community/pygame-ce/pull/3262, https://github.com/pygame-community/pygame-ce/pull/3251, https://github.com/pygame-community/pygame-ce/pull/3207.


Maintenance
* ankith26 added a new `dev.py` file to help pygame-ce devs run necessary commands and do editable builds very smoothly, as a spiritual successor to `setup.py` which is seemingly being phased out in the Python packaging ecosystem. See https://github.com/pygame-community/pygame-ce/pull/3128.
* ankith26 and Starbuck5 kept us up to date with SDL2 (and SDL3 releases/prereleases for our experimental support). We've pulled in the new SDL 2.30.12, SDL_image 2.8.4, and SDL_ttf 2.24.0. Contributed in https://github.com/pygame-community/pygame-ce/pull/3203, https://github.com/pygame-community/pygame-ce/pull/3261, https://github.com/pygame-community/pygame-ce/pull/3271, https://github.com/pygame-community/pygame-ce/pull/3286, https://github.com/pygame-community/pygame-ce/pull/3304, https://github.com/pygame-community/pygame-ce/pull/3279, and https://github.com/pygame-community/pygame-ce/pull/3322.
* ankith26 kept our transitive dependencies up to date on Linux in https://github.com/pygame-community/pygame-ce/pull/3322.
* ankith26 bumped build dependencies and used `dev.py` on msys2/multiarch CI in https://github.com/pygame-community/pygame-ce/pull/3211.
* ankith26 fixed latest SDL3 and MSYS2 fails in https://github.com/pygame-community/pygame-ce/pull/3201.
* bilhox implemented a better meson error on Windows when library versions are not correct in https://github.com/pygame-community/pygame-ce/pull/3178.
* ankith26 added ignores for new new gcc version mask array bounds warning in https://github.com/pygame-community/pygame-ce/pull/3186.
* Starbuck5 Batched memory allocations and adding some missing error checks in https://github.com/pygame-community/pygame-ce/pull/3224.
* ankith26 fixed SDL3 CI apt issues in https://github.com/pygame-community/pygame-ce/pull/3233.
* sonotopes updated 'in' operator for sys.platform linux check in pygame.camera in https://github.com/pygame-community/pygame-ce/pull/3246.
* ankith26 dropped circleci, moved us to GitHub Actions for ARM manylinux in https://github.com/pygame-community/pygame-ce/pull/3293.
* Starbuck5 removed an unnecessary lock in gfxdraw in https://github.com/pygame-community/pygame-ce/pull/3280.
* MightyJosip moved the get_rect helper to c_api in https://github.com/pygame-community/pygame-ce/pull/3303.
* MyreMylar pinned mypy to 1.13.0 to avoid `__all__` duplication in https://github.com/pygame-community/pygame-ce/pull/3277.

New Contributors

* gavinmorrow made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3194
* XORandom made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3138
* GabrieleLS made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3228
* JovialKnoll made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3231
* sonotopes made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3246
* Akaracy made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3230
* noahcse made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3113

Community Shoutouts
* The Hooman library ("pygame for humans") now supports pygame-ce, by not explicitly requiring pygame. Check it out: https://github.com/Abdur-rahmaanJ/hooman
* "My Keyboard is Full of Ants!" won [1st place in the Ludum Dare 56 Compo](https://bsky.app/profile/ludumdare.com/post/3l7h7lxkvrv2n), using pygame-ce and pygbag to be playable on the web. Check it out: https://plasmastarfish.itch.io/my-keyboard-is-full-of-ants

Hello! This is a preview release for 2.5.3, which should be out in a week or so. Included are the GitHub autogenerated release notes, for the full release we will clean these up to be more human readable.

What's Changed
* 2.5.2.dev2 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3173
* Start 2.5.3.dev1 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3174
* Fix TGA save bug, add test by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3169
* Bump actions/checkout from 4.2.0 to 4.2.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3175
* Bump actions/cache from 4.1.0 to 4.1.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3176
* Minor fixes and changes to `geometry.pyi` stub file by aatle in https://github.com/pygame-community/pygame-ce/pull/3172
* Better meson error on windows when libraries versions are not correct by bilhox in https://github.com/pygame-community/pygame-ce/pull/3178
* Image module SDL3 support by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3166
* Allow erasing pixels in pygame.Surface.scroll and add repeat functionality by damusss in https://github.com/pygame-community/pygame-ce/pull/2855
* Include the explicit type in `ColorLike` and `RectLike` by aatle in https://github.com/pygame-community/pygame-ce/pull/3183
* Add main guard to examples (+ incredibly small fixes) by damusss in https://github.com/pygame-community/pygame-ce/pull/3181
* Bump uraimo/run-on-arch-action from 2.7.2 to 2.8.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3200
* Bump actions/cache from 4.1.1 to 4.1.2 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3198
* Fix latest SDL3 and MSYS2 fails by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3201
* Bump actions/checkout from 4.2.1 to 4.2.2 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3199
* Ignore new gcc version mask array bounds warning by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3186
* Fix grammar and formatting in Window docs by gavinmorrow in https://github.com/pygame-community/pygame-ce/pull/3194
* Start getting base module ready for SDL3 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3171
* Bump SDL2 to 2.30.9 and SDL3 to 3.1.6 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3203
* Correct draw.aaline docs by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3204
* Fix window docs by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3205
* Add `dev.py` implementing dev command shorthands by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3128
* Port time, surflock and constants to SDL3 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3206
* Add Russian readme by XORandom in https://github.com/pygame-community/pygame-ce/pull/3138
* Raise minimum supported SDL2 to 2.0.14 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3213
* Bump actions/attest-build-provenance from 1.4.3 to 1.4.4 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3220
* Use SequenceLike in geometry stubs by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3212
* Port event.c to SDL3 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3217
* Allow all color types mask.from_threshold and fix typing for PixelArray methods by damusss in https://github.com/pygame-community/pygame-ce/pull/3164
* Batch and error check allocations by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3224
* Update mixer documentation by GabrieleLS in https://github.com/pygame-community/pygame-ce/pull/3228
* fixing grammar by JovialKnoll in https://github.com/pygame-community/pygame-ce/pull/3231
* Fix SDL3 CI apt issues by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3233
* Utility Window implementation. by gresm in https://github.com/pygame-community/pygame-ce/pull/3226
* Drop python 3.8 support by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3143
* Bump docker/metadata-action from 5.5.1 to 5.6.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3241
* Bump pypa/cibuildwheel from 2.21.3 to 2.22.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3240
* Remove unnecessary calls to PyNumber_Index, PyLong_Checks by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3242
* updated 'in' operator for sys.platform linux check by sonotopes in https://github.com/pygame-community/pygame-ce/pull/3246
* Draw arc test in draw_test.py by Akaracy in https://github.com/pygame-community/pygame-ce/pull/3230
* Bump build dependencies and use `dev.py` on msys2/multiarch CI by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3211
* Added Line methods and length attribute by MrRedstone058 in https://github.com/pygame-community/pygame-ce/pull/3179
* Fix failing tests: change `Tuple[float, float]` to `Point` in `geometry.pyi` by aatle in https://github.com/pygame-community/pygame-ce/pull/3248
* Bump docker/build-push-action from 6.9.0 to 6.10.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3250
* Deprecate `Window` `foreign` kwarg and `Window.focus` `input_only` kwarg by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3234
* Add missing newline in sndarray.rst and cursors.rst by yunline in https://github.com/pygame-community/pygame-ce/pull/3257
* Bump actions/cache from 4.1.2 to 4.2.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3259
* Bump actions/attest-build-provenance from 1.4.4 to 2.0.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3260
* Add BLENDMODE_MUL to constants by yunline in https://github.com/pygame-community/pygame-ce/pull/3258
* this statement seems to be false, removing by JovialKnoll in https://github.com/pygame-community/pygame-ce/pull/3263
* Bump SDL2 to 2.30.10 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3261
* Optimize pg_Two(Ints/Floats)FromObj by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3214
* Bump actions/attest-build-provenance from 2.0.1 to 2.1.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3267
* Typo fixes by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3266
* Correct `pygame.display` stubs by aatle in https://github.com/pygame-community/pygame-ce/pull/3264
* Docs updates (mainly to mixer) by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3272
* Bump SDL2_image to 2.8.3 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3271
* Fix mypy to 1.13.0 to avoid __all__ duplication by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/3277
* Rename TestTags so it doesn't get confused for a test by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/3276
* Fix *most of* the Deprecation Warnings in surfarray_test by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/3274
* add and modified readme for Traditional Chinese. by noahcse in https://github.com/pygame-community/pygame-ce/pull/3113
* Port imageext.c to SDL3(_image) by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3262
* Add runtime support for `pygame.sprite.AbstractGroup` subscripts by Matiiss in https://github.com/pygame-community/pygame-ce/pull/3053
* Generate reST/ref docs from python or stub files, move time and cursors docs by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/3188
* Document how volume is stored internally for `(get|set)_volume` functions and methods by Matiiss in https://github.com/pygame-community/pygame-ce/pull/3091
* Bump SDL to 2.30.11 and SDL_ttf to 2.24.0 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3279
* Remove unnecessary lock in gfxdraw by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3280
* event.peek return bool, minor doc/stub fixes by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3283
* SDL3: restructure cliprect handling in draw.c by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3278
* Bump SDL2_image and SDL3 prerelease by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3286
* Bump docker/build-push-action from 6.10.0 to 6.11.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3290
* Port key and mouse to SDL3 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3207
* Introduce PG_SURF_FORMATENUM macro (SDL3 compat) by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3294
* Drop circleci, use gh actions for arm manylinux by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3293
* Fix/improve _sdl2 stubs by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3300
* Bump docker/build-push-action from 6.11.0 to 6.12.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3299
* Expand __init__ parameters for `Window` by damusss in https://github.com/pygame-community/pygame-ce/pull/3295
* Optimize correct colordict entries by damusss in https://github.com/pygame-community/pygame-ce/pull/3297
* Port window.c to SDL3 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3251
* Move get_rect helper to c_api by MightyJosip in https://github.com/pygame-community/pygame-ce/pull/3303
* Optimize for str hex color values by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3302
* Bump SDL3 / SDL3_image prebuilts by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3304
* Mask SDL3 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3307
* Freetype typing fixes, enhancements to dict/tuple/ellipsis typing by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3301
* Pixelcopy SDL3 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3308
* Bump actions/attest-build-provenance from 2.1.0 to 2.2.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3313
* Bump docker/build-push-action from 6.12.0 to 6.13.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3312
* Mark old xType aliases as deprecated by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3288
* Docs fix for time, weird generation in c api by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3316
* General maintenance: Minor dev.py fixes, SDL(2+3) and deps updates by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3322

New Contributors
* gavinmorrow made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3194
* XORandom made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3138
* GabrieleLS made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3228
* JovialKnoll made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3231
* sonotopes made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3246
* Akaracy made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3230
* noahcse made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3113

**Full Changelog**: https://github.com/pygame-community/pygame-ce/compare/2.5.2.dev2...2.5.3.dev2

☀️🎃👻🕸️🕷️🧛🧟‍♂️🧙‍♀️🧙‍♂️🕯️🪦🍬🍭🍫☠️⚰️🔮🧹🌕🐈‍⬛🦇🌌
`pip uninstall pygame` (if previously installed, to avoid package conflicts)
`pip install pygame-ce --upgrade`
☀️🎃👻🕸️🕷️🧛🧟‍♂️🧙‍♀️🧙‍♂️🕯️🪦🍬🍭🍫☠️⚰️🔮🧹🌕🐈‍⬛🦇🌌

We're pumped to drop another pygame-ce release, thanks to the awesome efforts of 30+ contributors in this release! In the last couple of months, we've together made 286 commits, updated 281 files, and merged 85 pull requests.

Now, let's dive into what's new!

New and improved API

* [`pygame.Window`](https://pyga.me/docs/ref/window.html) has left experimental status and now been declared public API (contributed by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3170). damusss further enhanced the API by adding the `Window.flash` method and `Window.focused` property in https://github.com/pygame-community/pygame-ce/pull/3054 and https://github.com/pygame-community/pygame-ce/pull/3079 respectively.

* damusss added a new module, [`pygame.typing`](https://pyga.me/docs/ref/typing.html), in https://github.com/pygame-community/pygame-ce/pull/3002 that exports commonly used type aliases for use in type hinting.
- New contributor aatle made many nice changes and cleanups to get this module ready for the release in https://github.com/pygame-community/pygame-ce/pull/3080, https://github.com/pygame-community/pygame-ce/pull/3086, and https://github.com/pygame-community/pygame-ce/pull/3139
- Starbuck5 and ankith26 also put in some work to get this module ready for the release in https://github.com/pygame-community/pygame-ce/pull/3102 and https://github.com/pygame-community/pygame-ce/pull/3150 respectively.

* The experimental `pygame.geometry` module saw more API porting from its development repository in this release. A big thanks to all `geometry` project contributors: novialriptide, Emc2356, itzpr3d4t0r, ScriptLineStudios, avaxar, Matiiss, newpaxonian, maqa41, blankRiot96, gresm
- New contributor MrRedstone058 added additional `Circle` attributes in https://github.com/pygame-community/pygame-ce/pull/3127
- itzpr3d4t0r added the `Circle.intersect` method and the base for the `Line` class in https://github.com/pygame-community/pygame-ce/pull/3071 and https://github.com/pygame-community/pygame-ce/pull/3131 respectively.
- damusss added the `Circle.collidelist(all)` method in https://github.com/pygame-community/pygame-ce/pull/2880

* ScriptLineStudios added the `transform.solid_overlay` function in https://github.com/pygame-community/pygame-ce/pull/2304 making it easier to create a single color version of an alpha possessing surface.

* damusss added the `desktop` argument to `mouse.get_pos` and `mouse.get_pressed` in https://github.com/pygame-community/pygame-ce/pull/3105 so you can get the position of the mouse outside of the pygame window, where this is supported by the OS.

* damusss added the `pygame.Sound` alias to denote `pygame.mixer.Sound` in https://github.com/pygame-community/pygame-ce/pull/3063. That should save a few precious characters of typing.


Bugfixes

* Starbuck5 fixed an OpenGL issue in `Window` init in https://github.com/pygame-community/pygame-ce/pull/3059

* oddbookworm fixed a break when the OS resizes the window in `set_mode` in https://github.com/pygame-community/pygame-ce/pull/2992

* bilhox fixed segfault with antialiased draw functions with a depth different than 32bits in https://github.com/pygame-community/pygame-ce/pull/3008

* pmp-p did some fixes for improved wasm support in https://github.com/pygame-community/pygame-ce/pull/3137 and https://github.com/pygame-community/pygame-ce/pull/3163

* MyreMylar fixed midi timer reset when quit in https://github.com/pygame-community/pygame-ce/pull/3018

* mzivic7
- Fixed aalines overlap issue in https://github.com/pygame-community/pygame-ce/pull/2912
* Fixed missing pixels in `aalines` when using integer coordinates in https://github.com/pygame-community/pygame-ce/pull/3144

* ankith26
- Fixed `(F)Rect.scale_by(_ip)` handling of the `scale_by` parameter in https://github.com/pygame-community/pygame-ce/pull/3078
- Updated `FRect` repr to handle larger values in https://github.com/pygame-community/pygame-ce/pull/3077
- Fixed pygame-ce editable install on windows in https://github.com/pygame-community/pygame-ce/pull/3117

General Enhancements

* oddbookworm improved `Vector{2,3}.__delattr__` messaging when deleting `x, y, {z}` and removed `Vector4` zombies in https://github.com/pygame-community/pygame-ce/pull/3069, and ankith26 applied some more related updates in https://github.com/pygame-community/pygame-ce/pull/3087
* bilhox made it so that too many arguments to `Color.from_{colorspace}` style methods now raise errors in https://github.com/pygame-community/pygame-ce/pull/3125
* damusss added handling for all color types in `transform.threshold` in https://github.com/pygame-community/pygame-ce/pull/3156

Performance Enhancements

* Starbuck5 updated more places in `rect` code to use `PyObject_Vectorcall` in https://github.com/pygame-community/pygame-ce/pull/3048. The affected methods therefore see 15-22% improvements in speed.

* itzpr3d4t0r
- Optimized `Rect.clipline()` in https://github.com/pygame-community/pygame-ce/pull/3067. The performance is up by upto 50% in some of our test cases.
- Optimized tuple creation for `Rect` getters in https://github.com/pygame-community/pygame-ce/pull/3072

Docs and Type Hints

* New contributor MrValdez added example on how `Window` behaves with `WINDOWCLOSE` and `QUIT` events in https://github.com/pygame-community/pygame-ce/pull/3115

* New contributor datapythonista clarified how `Rect` and positions relate in the intro tutorial in https://github.com/pygame-community/pygame-ce/pull/3111

* New contributor hisa10 added a Japanese README in https://github.com/pygame-community/pygame-ce/pull/3114

* oddbookworm fixed a couple of versionadded tags that should have been versionaddedold in `display` docs in https://github.com/pygame-community/pygame-ce/pull/3046

* itzpr3d4t0r improved `geometry` docs in https://github.com/pygame-community/pygame-ce/pull/3043

* Starbuck5 fixed `transform.average_color` docs and stubs to match implementation in https://github.com/pygame-community/pygame-ce/pull/3076

* yunline updated the dependency section of zh-cn README in https://github.com/pygame-community/pygame-ce/pull/3119

* zoldalma999 fix stubcheck typing error on windows in https://github.com/pygame-community/pygame-ce/pull/3147

* bilhox
- Made it so that some experimental API is not hidden in the docs anymore in https://github.com/pygame-community/pygame-ce/pull/3068
- Polished and reviewed french readme + note of when it was last reviewed in https://github.com/pygame-community/pygame-ce/pull/3142

* damusss
- Enhanced `pygame.mouse.get_pressed` docs in https://github.com/pygame-community/pygame-ce/pull/3084
- Made `copy` methods explicit for linting in https://github.com/pygame-community/pygame-ce/pull/3129
- Added Italian README in https://github.com/pygame-community/pygame-ce/pull/3120
- Improved color notation in the docs in https://github.com/pygame-community/pygame-ce/pull/3165

Examples and Unit Tests

* New contributor avpai-dinosaur fixed `test_inflate_ip__larger` unit test in https://github.com/pygame-community/pygame-ce/pull/3098

* damusss added 9-patch to examples in https://github.com/pygame-community/pygame-ce/pull/2985

Code Quality and General Maintenance

* New contributor raspofabs migrated `pkgdata` code to importlib to resolve warning about `pkg_resources` in https://github.com/pygame-community/pygame-ce/pull/3061

* zoldalma999 ported the controller module to C in https://github.com/pygame-community/pygame-ce/pull/2056

* oddbookworm added code coverage CI in https://github.com/pygame-community/pygame-ce/pull/2990

* ankith26
- Switched code to use `PyObject_CallOneArg` where applicable in https://github.com/pygame-community/pygame-ce/pull/3023
- Drop MSYS2 clang32 from our CI in https://github.com/pygame-community/pygame-ce/pull/3116
- Fix whitespace and eof formatting with pre-commit in https://github.com/pygame-community/pygame-ce/pull/3104
- Fix a compiler warning in debug mode in https://github.com/pygame-community/pygame-ce/pull/3124
- Made sure our CI and build dependency versions are all up to date in https://github.com/pygame-community/pygame-ce/pull/3123, https://github.com/pygame-community/pygame-ce/pull/3100 and https://github.com/pygame-community/pygame-ce/pull/3118

* ankith26 and Starbuck5 continued on the work to get pygame-ce compiling with the latest SDL3 prerelease in https://github.com/pygame-community/pygame-ce/pull/3141, https://github.com/pygame-community/pygame-ce/pull/2975, https://github.com/pygame-community/pygame-ce/pull/3145, https://github.com/pygame-community/pygame-ce/pull/2933, https://github.com/pygame-community/pygame-ce/pull/3146, and https://github.com/pygame-community/pygame-ce/pull/3160

* oddbookworm and Starbuck5 kept our SDL dependency updated in https://github.com/pygame-community/pygame-ce/pull/3094 and https://github.com/pygame-community/pygame-ce/pull/3168 respectively

* ankith26 and Starbuck5 kept the dev release process running in https://github.com/pygame-community/pygame-ce/pull/3042 and https://github.com/pygame-community/pygame-ce/pull/3173 respectively

* dependabot kept our CI dependencies updated in https://github.com/pygame-community/pygame-ce/pull/3065, https://github.com/pygame-community/pygame-ce/pull/3095, https://github.com/pygame-community/pygame-ce/pull/3051, https://github.com/pygame-community/pygame-ce/pull/3050, https://github.com/pygame-community/pygame-ce/pull/3081, https://github.com/pygame-community/pygame-ce/pull/3103, https://github.com/pygame-community/pygame-ce/pull/3112, https://github.com/pygame-community/pygame-ce/pull/3135, https://github.com/pygame-community/pygame-ce/pull/3136, https://github.com/pygame-community/pygame-ce/pull/3151, https://github.com/pygame-community/pygame-ce/pull/3153, and https://github.com/pygame-community/pygame-ce/pull/3161

New Contributors

* aatle made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3080
* raspofabs made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3061
* avpai-dinosaur made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3098
* hisa10 made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3114
* MrValdez made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3115
* MrRedstone058 made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3127
* datapythonista made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3111

Thanks all

A huge thank you to everyone who's been part of this journey! This goes beyond code contributors; we are grateful to the whole community - issue reporters, PR reviewers, tutorial creators, folks helping out on different platforms, developers of supporting libraries, and most importantly, all our users (yes, that also includes you, who is reading this!).

If you notice any mistakes in these notes, please let us know so we can fix them up.

Take care, and happy pygaming!

**Full Changelog**: https://github.com/pygame-community/pygame-ce/compare/2.5.1...2.5.2

Pre release version of 2.5.2 for testing, we appreciate everyone who tests out our dev releases!

Release highlights
- Promoted [pygame.Window](https://pyga.me/docs/ref/window.html) to public API. Allows use of multiple windows at once, new window operations.
- Various rect optimizations
- Dependency updates: SDL and lower level C libraries
- New module [pygame.typing](https://pyga.me/docs/ref/typing.html)
- Fixed segfault in antialiased draw functions with non 32 bit surfaces

What's Changed
* 2.5.2.dev1 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3042
* Fixed a couple of versionadded tags that should have been versionaddedold in `display` docs by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/3046
* Bump docker/build-push-action from 6.5.0 to 6.6.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3051
* Bump actions/attest-build-provenance from 1.4.0 to 1.4.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3050
* Improved geometry docs by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/3043
* Fix imposter opengl by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3059
* Add `Window.flash(operation)` by damusss in https://github.com/pygame-community/pygame-ce/pull/3054
* Add pygame.typing module by damusss in https://github.com/pygame-community/pygame-ce/pull/3002
* Use PyObject_Vectorcall in rect by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3048
* Version-getters SDL2/SDL3 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2975
* Coverage CI created, hopefully it works first time lol by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2990
* Bump docker/build-push-action from 6.6.1 to 6.7.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3065
* Optimized `Rect.clipline()` by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/3067
* Optimized tuple creation for Rect getters by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/3072
* Update `FRect` repr to handle larger values by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3077
* Bump actions/attest-build-provenance from 1.4.1 to 1.4.2 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3081
* Fix average_color docs and stubs to match implementation by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3076
* Fix and improve `pygame.typing` module by aatle in https://github.com/pygame-community/pygame-ce/pull/3080
* Add `Window.focused` by damusss in https://github.com/pygame-community/pygame-ce/pull/3079
* Add alias `pygame.Sound` by damusss in https://github.com/pygame-community/pygame-ce/pull/3063
* Port the controller module to C. by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/2056
* Fix break when the OS resizes our window in `set_mode` by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2992
* Make experimental API not hidden in the docs anymore by bilhox in https://github.com/pygame-community/pygame-ce/pull/3068
* `Vector{2,3}.__delattr__` messaging fixed when deleting `x, y, {z}` and removed `Vector4` zombies by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/3069
* Use PyObject_CallOneArg where applicable by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3023
* migrate importlib to resolve warning about pkg_resources by raspofabs in https://github.com/pygame-community/pygame-ce/pull/3061
* Make `pygame.typing.PathLike` internal/private by aatle in https://github.com/pygame-community/pygame-ce/pull/3086
* Updated SDL version to 2.30.7 by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/3094
* Fix test_inflate_ip__larger. by avpai-dinosaur in https://github.com/pygame-community/pygame-ce/pull/3098
* Bump actions/attest-build-provenance from 1.4.2 to 1.4.3 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3095
* Add `Circle.intersect()` by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/3071
* Remove RGBATuple by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3102
* Fix component bounds checking by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3087
* Bump build dependencies by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3100
* Enhance `pygame.mouse.get_pressed` docs by damusss in https://github.com/pygame-community/pygame-ce/pull/3084
* Bump pypa/cibuildwheel from 2.20.0 to 2.21.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3103
* Bump pypa/cibuildwheel from 2.21.0 to 2.21.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3112
* Drop MSYS2 clang32 from our CI by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3116
* Fix whitespace and eof formatting with pre-commit by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3104
* Fix segfault with antialiased draw functions with a depth different than 32bits by bilhox in https://github.com/pygame-community/pygame-ce/pull/3008
* Add japanese readme by hisa10 in https://github.com/pygame-community/pygame-ce/pull/3114
* Update the dependency section of zh-cn README by yunline in https://github.com/pygame-community/pygame-ce/pull/3119
* Add `desktop` argument to `mouse.get_pos` and `mouse.get_pressed` by damusss in https://github.com/pygame-community/pygame-ce/pull/3105
* added example on how Window behaves with WINDOWCLOSE and QUIT events by MrValdez in https://github.com/pygame-community/pygame-ce/pull/3115
* Fix editable install on windows by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3117
* Add `Circle.collidelist/collidelistall()` by damusss in https://github.com/pygame-community/pygame-ce/pull/2880
* Fix midi timer reset when quit by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/3018
* Make `copy` methods explicit for linting by damusss in https://github.com/pygame-community/pygame-ce/pull/3129
* Fix a compiler warning in debug mode by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3124
* Set error when too many numbers of argument in ``pygame.Color.from_colorspace`` by bilhox in https://github.com/pygame-community/pygame-ce/pull/3125
* Bump actions/checkout from 4.1.7 to 4.2.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3135
* Bump docker/build-push-action from 6.7.0 to 6.8.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3136
* Added additional circle attributes by MrRedstone058 in https://github.com/pygame-community/pygame-ce/pull/3127
* Bump ubuntu to 24.04 on CI, fix cppcheck by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3123
* Clarify how Rect and positions relate in the intro tutorial by datapythonista in https://github.com/pygame-community/pygame-ce/pull/3111
* Fix aalines overlap by mzivic7 in https://github.com/pygame-community/pygame-ce/pull/2912
* wasm: controller is not multiphase init + workaround for wasm 313t by pmp-p in https://github.com/pygame-community/pygame-ce/pull/3137
* Rename `pygame.typing.Coordinate` to `Point`, fix related grammar by aatle in https://github.com/pygame-community/pygame-ce/pull/3139
* Fix `(F)Rect.scale_by(_ip)` handling of the `scale_by` parameter by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3078
* Add 9-patch to examples by damusss in https://github.com/pygame-community/pygame-ce/pull/2985
* transform.solid_overlay by ScriptLineStudios in https://github.com/pygame-community/pygame-ce/pull/2304
* Add draw.aaline width argument by mzivic7 in https://github.com/pygame-community/pygame-ce/pull/3140
* New up-to-date review of french readme + note of when it was last reviewed by bilhox in https://github.com/pygame-community/pygame-ce/pull/3142
* Missing pixels in `aalines` when using integer coordinates by mzivic7 in https://github.com/pygame-community/pygame-ce/pull/3144
* Add meson flag for compiling with SDL3 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3141
* SDL3: compile rect, bufferproxy, math, newbuffer, geometry by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3145
* Fixes for rwobject (now iostream) SDL3 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2933
* SDL3 support for pygame.system by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3146
* Fix stubcheck error on windows, mark typealiases as such in typing by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/3147
* Bump docker/build-push-action from 6.8.0 to 6.9.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3151
* Bump actions/cache from 4.0.2 to 4.1.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3153
* Add Italian README by damusss in https://github.com/pygame-community/pygame-ce/pull/3120
* Bump pypa/cibuildwheel from 2.21.1 to 2.21.3 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3161
* Adjust pg_MappedColorFromObj API for SDL3-porting by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3160
* Fix handling all color types in `pygame.transform.threshold` by damusss in https://github.com/pygame-community/pygame-ce/pull/3156
* Improve color notation in the docs by damusss in https://github.com/pygame-community/pygame-ce/pull/3165
* SDL 2.30.8 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3168
* Add basic pygame.typing unit test, remove problematic TypeAlias usage by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3150
* Added `geometry.Line` base by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/3131
* wasm: better wasm fencing by pmp-p in https://github.com/pygame-community/pygame-ce/pull/3163
* Publicize window docs by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3170
* mac/manylinux deps updates 2024 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3118

New Contributors
* aatle made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3080
* raspofabs made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3061
* avpai-dinosaur made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3098
* hisa10 made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3114
* MrValdez made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3115
* MrRedstone058 made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3127
* datapythonista made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3111

**Full Changelog**: https://github.com/pygame-community/pygame-ce/compare/2.5.1...2.5.2.dev2

☀️🌊🏖️😎🏄🐚🌈🏝️🍹☀️🌊🏖️🎉
`pip uninstall pygame` (if previously installed, to avoid package conflicts)
`pip install pygame-ce --upgrade`
☀️🌊🏖️😎🏄🐚🌈🏝️🍹☀️🌊🏖️🎉

We are pleased to do yet another release of pygame-ce, and this has been possible due to the efforts of over 20 code contributors. Together, we have made 193 commits across 139 files via 80 pull requests in the last 2 months since the previous release!

Now, onto the highlights!

Highlights

* Added Python 3.13 (just standard 3.13, no free threading yet) and PyPy for apple silicon support.

* We have a new logo!

<img src="https://raw.githubusercontent.com/pygame-community/pygame-ce/2.5.1/docs/reST/_static/pygame_ce_logo.svg" alt="pygame-ce logo" width="40%"/>

* We haven't run out of optimization ideas yet :sweat_smile:, we've managed to cram a few more in this release.

New API

* There is now a default destination position `(0, 0)` for `Surface.blit`, thanks to damusss in https://github.com/pygame-community/pygame-ce/pull/2936.
* itzpr3d4t0r added a new function `Surface.premul_alpha_ip` to premultiply alpha faster by operating in place instead of needing to allocate a new Surface. Matiiss also helped with documentation. See https://github.com/pygame-community/pygame-ce/pull/2899, https://github.com/pygame-community/pygame-ce/pull/2972, and https://github.com/pygame-community/pygame-ce/pull/2980.

Bugfixes

* Matiiss fixed passing `parent_window=None` to `display.message_box` in https://github.com/pygame-community/pygame-ce/pull/2723.
* itzpr3d4t0r fixed an issue `transform.hsl` not working on certain pixel formats in https://github.com/pygame-community/pygame-ce/pull/2948.
* oddbookworm fixed a `Surface.fill` where rects with negative positions would slide to `(0, 0)` and then fill, instead of only filling part of the `Rect`. See https://github.com/pygame-community/pygame-ce/pull/2939 for details.
* ankith26 fixed using `SCALED` after not using `SCALED` in `display` in https://github.com/pygame-community/pygame-ce/pull/2925.
* damusss fixed using OpenGL with a resizable `pygame.Window`, see https://github.com/pygame-community/pygame-ce/pull/2915.

General Enhancements

* MyreMylar added a SIMD printout (SSE2, AVX2 & NEON) to `pygame.print_debug_info()` in https://github.com/pygame-community/pygame-ce/pull/2897. This will help us debug any SIMD-backend specific bugs submitted by users.
* damusss added support for `radius = 0` circles to the experimental `geometry` module, see https://github.com/pygame-community/pygame-ce/pull/2913.
* zoldalma999 added new `"ABGR"` format support to `image.frombytes` and `image.tobytes` in https://github.com/pygame-community/pygame-ce/pull/2951.
* zoldalma999 made the experimental `Window` class subclassable in https://github.com/pygame-community/pygame-ce/pull/2950.
* ankith26 added support for iterables in `display.update`, see https://github.com/pygame-community/pygame-ce/pull/2987.
* Starbuck5 and ankith26 added Python 3.13 support in https://github.com/pygame-community/pygame-ce/pull/2994 and https://github.com/pygame-community/pygame-ce/pull/3030.

Performance Enhancements

* itzpr3d4t0r continued his quest to optimize all the things, merging improvements to `PixelArray.make_surface`, `transform.scale2x`, `Surface.fblits` (a fix for a performance regression), `mask.from_surface` and `(F)Rect` methods. See https://github.com/pygame-community/pygame-ce/pull/2953, https://github.com/pygame-community/pygame-ce/pull/2859, https://github.com/pygame-community/pygame-ce/pull/2978, https://github.com/pygame-community/pygame-ce/pull/2895, and https://github.com/pygame-community/pygame-ce/pull/2908 for more details.
* mzivic7 got a 5-6% boost out of `draw.aacircle` (new in pygame-ce 2.5.0) in https://github.com/pygame-community/pygame-ce/pull/3012.
* Starbuck5 boosted the performance of some `draw` operations on 24-bit surfaces, with a 20% improvement on single-pixel line drawing, see https://github.com/pygame-community/pygame-ce/pull/3021.

Deprecations and Removals

No new deprecations this release, but-
* ankith26 added deprecation warnings to some already-deprecated API (`freetype.was_init`, `scrap.lost`) in https://github.com/pygame-community/pygame-ce/pull/3001.

Docs and Type Hints

* Mega-JC created a new logo and added it to the docs (in collaboration with kadir014 on the design), in https://github.com/pygame-community/pygame-ce/pull/2965. This is great for us to express our own identity as a project.
* REX2626, whangho, Mic-lab, and damusss made grammar and wording improvements to docs content. See https://github.com/pygame-community/pygame-ce/pull/2907, https://github.com/pygame-community/pygame-ce/pull/2919, https://github.com/pygame-community/pygame-ce/pull/2911, https://github.com/pygame-community/pygame-ce/pull/3004, and https://github.com/pygame-community/pygame-ce/pull/2901.
* damusss made it so deprecated functions are marked with the deprecated decorator in https://github.com/pygame-community/pygame-ce/pull/2984. This allows editors to show users that a function is deprecated very neatly. They also made some smaller enhancements to the type stubs in https://github.com/pygame-community/pygame-ce/pull/2918 and https://github.com/pygame-community/pygame-ce/pull/2926.
* ankith26 modernized the stubs to use python-3.8-isms in https://github.com/pygame-community/pygame-ce/pull/2995
* MrF1ow added a Contribution Section to README to help out new contributors in https://github.com/pygame-community/pygame-ce/pull/2910.
* MyreMylar added license identifier to README in https://github.com/pygame-community/pygame-ce/pull/2890.
* oddbookworm changed dark theme slightly to make code more readable in some cases in https://github.com/pygame-community/pygame-ce/pull/2960.

Examples and Unit Tests

* bilhox made some general example changes and enhancements in https://github.com/pygame-community/pygame-ce/pull/2581.
* ankith26 and MyreMylar enhanced our unit tests and ensured sure they keep passing in https://github.com/pygame-community/pygame-ce/pull/3031, https://github.com/pygame-community/pygame-ce/pull/3017, https://github.com/pygame-community/pygame-ce/pull/2934, https://github.com/pygame-community/pygame-ce/pull/2885, and https://github.com/pygame-community/pygame-ce/pull/2966.

Code Quality and General Maintenance

* Notenlish got rid of unneeded `docscomments.js` usage in docs in https://github.com/pygame-community/pygame-ce/pull/2959.
* ankith26 added support for macOS arm64 PyPy in our releases in https://github.com/pygame-community/pygame-ce/pull/2945. He also improved our buildconfig/CI by making it more robust and secure in https://github.com/pygame-community/pygame-ce/pull/2971, https://github.com/pygame-community/pygame-ce/pull/2977, https://github.com/pygame-community/pygame-ce/pull/3015, https://github.com/pygame-community/pygame-ce/pull/2941, and https://github.com/pygame-community/pygame-ce/pull/3040.
* Starbuck5 helped keep our codebase modern and tidy in https://github.com/pygame-community/pygame-ce/pull/2922, https://github.com/pygame-community/pygame-ce/pull/2940, https://github.com/pygame-community/pygame-ce/pull/2928, https://github.com/pygame-community/pygame-ce/pull/3014, https://github.com/pygame-community/pygame-ce/pull/2973, https://github.com/pygame-community/pygame-ce/pull/2974, and https://github.com/pygame-community/pygame-ce/pull/3020.
* oddbookworm made some ease-of-use changes to doc generation in https://github.com/pygame-community/pygame-ce/pull/2942 and https://github.com/pygame-community/pygame-ce/pull/2989.
* zoldalma999 updated the codebase to use the `SDL_TTF_VERSION_ATLEAST` macro in https://github.com/pygame-community/pygame-ce/pull/3003.
* ankith26 and zoldalma999 made some changes to better support development "editable" builds in https://github.com/pygame-community/pygame-ce/pull/2996 and https://github.com/pygame-community/pygame-ce/pull/2952.
* Matiiss and oddbookworm ensured our SDL dependency is kept updated in https://github.com/pygame-community/pygame-ce/pull/2949, https://github.com/pygame-community/pygame-ce/pull/2969, and https://github.com/pygame-community/pygame-ce/pull/3034.
* dependabot kept all our CI dependencies updated in https://github.com/pygame-community/pygame-ce/pull/2906, https://github.com/pygame-community/pygame-ce/pull/2932, https://github.com/pygame-community/pygame-ce/pull/2931, https://github.com/pygame-community/pygame-ce/pull/2930, https://github.com/pygame-community/pygame-ce/pull/2955, https://github.com/pygame-community/pygame-ce/pull/2963, https://github.com/pygame-community/pygame-ce/pull/2964, https://github.com/pygame-community/pygame-ce/pull/2983, https://github.com/pygame-community/pygame-ce/pull/2982, https://github.com/pygame-community/pygame-ce/pull/3013, https://github.com/pygame-community/pygame-ce/pull/3025, and https://github.com/pygame-community/pygame-ce/pull/3024.
* Starbuck5 and ankith26 worked on making intermediate dev releases possible in https://github.com/pygame-community/pygame-ce/pull/2905, https://github.com/pygame-community/pygame-ce/pull/3038, and https://github.com/pygame-community/pygame-ce/pull/3039.

New Contributors

* REX2626 made their first contribution in https://github.com/pygame-community/pygame-ce/pull/2907.
* MrF1ow made their first contribution in https://github.com/pygame-community/pygame-ce/pull/2910.
* whangho made their first contribution in https://github.com/pygame-community/pygame-ce/pull/2919.
* Mic-lab made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3004.

Thanks all

A heartfelt thank you to everyone involved! This includes not just code contributors, but also the wider community - issue reporters, PR reviewers, tutorial creators, helpers on various media platforms, developers of supporting libraries, and most importantly - all our users (including you, the reader of these notes)!

If you spot any errors in these notes, please let us know so we can correct them.

Take care and happy pygaming!

**Full Changelog**: https://github.com/pygame-community/pygame-ce/compare/2.5.0...2.5.1

A pre-release before the final release, please help us by testing this!

Release highlights

This is mostly a bug-fixes-and-enhancements release, but we do have a few cool new stuff to showcase!

- We now support and distribute wheels for CPython 3.13 and PyPy for apple silicon.
- The experimental `Window` class is now subclass-able.
- Added new method `Surface.premul_alpha_ip`
- The `dst` argument of `Surface.blit` now has a default value: `(0, 0)`. This means you can skip this argument if you are blitting a surface at the origin (top-left) of the window.

What's Changed
* 2.5.0.dev5 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2904
* Start 2.5.1 by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2905
* Bump docker/login-action from 3.1.0 to 3.2.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2906
* Update docs of `Surface.get_(f)rect()` and `(F)Rect.move_to()` by damusss in https://github.com/pygame-community/pygame-ce/pull/2901
* Fixed missing comma in README by REX2626 in https://github.com/pygame-community/pygame-ce/pull/2907
* Add SSE2, AVX2 & NEON support to `pygame.print_debug_info()` by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/2897
* Use github download links to get SDL dependencies by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2916
* Update transform.get/set_smoothscale_backend typehint from str to Literal by damusss in https://github.com/pygame-community/pygame-ce/pull/2918
* Contribution Section Added to README.rst by MrF1ow in https://github.com/pygame-community/pygame-ce/pull/2910
* Update punctuation in some docs by whangho in https://github.com/pygame-community/pygame-ce/pull/2919
* More SDL3 compat: Surface things by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2922
* Very small typehint fix for pygame.Mask by damusss in https://github.com/pygame-community/pygame-ce/pull/2926
* Remove SDL v1.2.10 checks in display.c by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2928
* pygame.Surface docs improvements by REX2626 in https://github.com/pygame-community/pygame-ce/pull/2911
* Bump docker/build-push-action from 5.3.0 to 5.4.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2932
* Fix failing tests based on numpy v2 by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2934
* Bump actions/checkout from 4.1.6 to 4.1.7 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2931
* Bump pypa/cibuildwheel from 2.18.1 to 2.19.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2930
* EventState SDL3 compat by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2940
* Try re-enabling tests disabled since SDL 2.0.18 by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/2885
* Fix passing `parent_window=None` to `message_box` by Matiiss in https://github.com/pygame-community/pygame-ce/pull/2723
* Improve security of releases by adding hash checks by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2941
* Updated SDL to 2.30.4 by Matiiss in https://github.com/pygame-community/pygame-ce/pull/2949
* Fix transform.hsl() to work on any Surface by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2948
* Bump docker/build-push-action from 5.4.0 to 6.1.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2955
* Allow degenerate circles (radius = 0) by damusss in https://github.com/pygame-community/pygame-ce/pull/2913
* Improve `PixelArray.make_surface()` performance by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2953
* Fix `Surface.fill` with rects with negative positions that overlap the surface by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2939
* Add ABGR format to frombytes and tobytes by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/2951
* Make window subclassable by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/2950
* Optimized `transform.scale2x()` by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2859
* Use static inline instead of inline by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/2952
* Add default dest (0, 0) to Surface.blit by damusss in https://github.com/pygame-community/pygame-ce/pull/2936
* Docs generation is now `python -m buildconfig docs` and `python -m buildconfig docs full_generation` by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2942
* Bump docker/build-push-action from 6.1.0 to 6.2.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2963
* Bump robinraju/release-downloader from 1.10 to 1.11 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2964
* Add `Surface.premul_alpha_ip()` by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2899
* SDL 2.30.5 by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2969
* Make pyproject license consistent with `setup.py` by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2971
* Fix `premul_alpha_ip` doc indentation issue by Matiiss in https://github.com/pygame-community/pygame-ce/pull/2972
* Add new official logos for pygame - Community Edition by Mega-JC in https://github.com/pygame-community/pygame-ce/pull/2965
* Fix homepage and release notes link in pypi urls by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2977
* Use PyObject_CallMethod in resource loaders by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2974
* Get rid of docscomments.js from docs by Notenlish in https://github.com/pygame-community/pygame-ce/pull/2959
* Remove obsolete surflock functions by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2973
* Bump docker/build-push-action from 6.2.0 to 6.3.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2983
* Ensure `.premul_alpha_ip()` works with zero sized Surfaces by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2980
* Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 by dependabot in https://github.com/pygame-community/pygame-ce/pull/2982
* Restore inlining for `.fblits()` internal functionality by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2978
* Optimized `mask.from_surface()` when converting an alpha surface. by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2895
* Fix scaled-after-non-scaled usage by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2925
* Optimized all `Rect/FRect` methods via `pgRect_FromObject` by itzpr3d4t0r in https://github.com/pygame-community/pygame-ce/pull/2908
* General example changes by bilhox in https://github.com/pygame-community/pygame-ce/pull/2581
* python -m buildconfig now works again... by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2989
* Use python 3.8 isms in the type stubs by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2995
* Add license identifier to readme by MyreMylar in https://github.com/pygame-community/pygame-ce/pull/2890
* Polish stubs with deprecated decorator by damusss in https://github.com/pygame-community/pygame-ce/pull/2984
* Make deprecated API raise deprecation warnings by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3001
* Use `SDL_TTF_VERSION_ATLEAST` by zoldalma999 in https://github.com/pygame-community/pygame-ce/pull/3003
* Make blend flag docs more accurate by Mic-lab in https://github.com/pygame-community/pygame-ce/pull/3004
* Fix editable install test fixtures logic by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2996
* Support iterable in `display.update` by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2987
* 3.13 source support (removes deprecated functions) by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/2994
* Centralize CI config and make it more uniform (Adds macOS arm64 pypy CI) by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2945
* Optimize draw.aacircle and fix typo by mzivic7 in https://github.com/pygame-community/pygame-ce/pull/3012
* Pin all build dependencies by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3015
* Bump docker/build-push-action from 6.3.0 to 6.4.1 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3013
* Skip flaky window tests on pypy by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3017
* Adjust tobytes premul formula by ankith26 in https://github.com/pygame-community/pygame-ce/pull/2966
* Update OpenGL Viewport when Window resizes by damusss in https://github.com/pygame-community/pygame-ce/pull/2915
* Use PyObject_CallNoArgs where applicable by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3020
* Changed dark theme slightly to make code more readable in some cases by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/2960
* Remove unnecessary pixeloffset member of subsurface data by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3014
* draw.c: better strategy for 24bpp writes by Starbuck5 in https://github.com/pygame-community/pygame-ce/pull/3021
* Bump docker/login-action from 3.2.0 to 3.3.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3025
* Bump docker/build-push-action from 6.4.1 to 6.5.0 by dependabot in https://github.com/pygame-community/pygame-ce/pull/3024
* Update SDL to 2.30.6 by oddbookworm in https://github.com/pygame-community/pygame-ce/pull/3034
* Skip yet another flaky pypy test by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3031
* Add python 3.13 wheel support by ankith26 in https://github.com/pygame-community/pygame-ce/pull/3030

New Contributors
* REX2626 made their first contribution in https://github.com/pygame-community/pygame-ce/pull/2907
* MrF1ow made their first contribution in https://github.com/pygame-community/pygame-ce/pull/2910
* whangho made their first contribution in https://github.com/pygame-community/pygame-ce/pull/2919
* Mic-lab made their first contribution in https://github.com/pygame-community/pygame-ce/pull/3004

**Full Changelog**: https://github.com/pygame-community/pygame-ce/compare/2.5.0.dev4...2.5.1.dev2