Release 2.5.8 · pygame-community/pygame-ce

🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙

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

🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙🕹️🎯⚡🏅📙

We are pleased to announce pygame-ce 2.5.8!

This release adds support for Python 3.15, bringing our supported range to Python 3.10 - 3.15. Implemented by @Starbuck5 in #3900.
Our optimized parallel SIMD code now runs on Windows on ARM. In pygame-ce 2.5.7, we introduced support for Windows on ARM, but our SIMD intrinsics did not work there, so in some cases it would be slower to use the native ARM version instead of emulated x86_64. @ankith26 worked with the maintainers of sse2neon to get it working on Windows on ARM, and brought it into this release in #3761. In some cases this can still be slower than emulation, but it is significantly faster than 2.5.7 for optimized workloads (e.g. blitting, some transform, some scaling).

New API

@damusss added Window.handle, exposing the native window handle for any Window rather than only through the display module, in #3219.
@DickerDackel added a pos (position) attribute to MOUSEWHEEL events in #3783.

@Starbuck5 fixed incorrect writes to certain 24 bit surfaces in transform.threshold, PixelArray.replace, and PixelArray slice assignment in #3790, then fixed transform.laplacian using the wrong surface's pixel layout when writing its result in #3791.
@Fantastair fixed the width calculation for draw.aacircle in #3699.
@Matiiss fixed a segfault in transform.solid_overlay when the given surface had a width of 0 in #3750.
New contributor @ShivamKR12 fixed a long-standing bug where the deprecated Vector3.rotate_y_ip_rad and Vector3.rotate_z_ip_rad functions both rotated around the X axis, in #3864.
@Starbuck5 fixed SysFont crashing with non string registry entries in #3760.

@Starbuck5 removed the legacy safe pickle system in #3857. Modern pickleable classes have not needed __safe_for_unpickling__ since the Python 2 days.

@itzpr3d4t0r optimized mask.from_surface for 32 bit alpha surfaces in #3785.
@Starbuck5 consolidated the degrees/radians conversion macros so the divisions constant fold at compile time instead of running per call, in #3859.

@damusss improved the pygame.event introduction documentation in #3738.
@Starbuck5 improved doc / stub content across several modules, in #3765, #3774, #3773, #3775, #3766, and #3809.
The team continued migrating docs into type stub docstrings so they will show up in code editors. Between @Starbuck5, @zoldalma999, and new contributors @mvanhorn and @SuperRedingBros, the team migrated sndarray, pixelcopy, mask, along with parts of font, scrap, and math. See #3731, #3866, #3730, #3868, #3865, #3803, #3752, and #3878.
New contributor @jryyangjy documented that surfarray.blit_array and surfarray.make_surface silently round float arrays, which has performance implications, in #3844.
@aatle improved the FRect note in the docs in #3838.
New contributor @Juni1per fixed a typo in the sndarray docstring in #3788.
@Starbuck5 added links to external tutorials in the docs in #3762, and @zoldalma999 retired the aging "red or black" tutorial in #3804.
@oddbookworm added a CONTRIBUTING.md in #3754, and @Matiiss removed the README translations in #3716.
New contributor @kristiansroberts fixed the Rect constructor overloads in our stubs to be positional only in #3826.
New contributor @MeGaurav4 fixed the Vector.__str__ NotImplementedError message calling itself repr() in #3829.

@Starbuck5 made SDL3 progress, adding new _audio and _sdl3_mixer modules to use for new functionality but also to emulate SDL2's mixer API, in #3657, #3814, #3753. New contributor @wr-web fixed a refcount error in them in #3793.
@Starbuck5 fixed SDL3 scrap and camera on Windows in #3842.
New contributor @ochderek and @ankith26 raised our minimum SDL/friends versions (see README for this info), removing compatibility code, in #3852 and #3867.
New contributor @jeevantenny and @Starbuck5 modernized our usage of Python refcount macros in C, in #3797, #3786, #3855.
@oddbookworm landed C unit testing in #3477.
@Starbuck5 made code improvements in #3763, #3853, and #3869.
@Starbuck5 removed tiny bits of obsolete code in #3811 and #3854.
@Starbuck5 kept our dependencies current, including SDL_image, SDL_mixer, C-level subdependencies, and cibuildwheel. In #3780, #3800, #3833, #3902, and #3904.
@ankith26 fixed gcc16 -Werror compile issues in #3784 and removed the mask/freetype warning suppressions in #3772.
@ankith26 hardened our GitHub Actions workflows in #3759, and @Starbuck5 taught the docs-ignoring workflows to ignore more docs changes in #3767.
New contributor @AndreyVarvar fixed render tests failing on specific MacOS versions in #3816.
New contributor @scooggins marked web as incompatible in our Briefcase metadata in #3817.

Full Changelog: 2.5.7...2.5.8