Pygame v2.0.0 Release Notes

Release Date: 2020-10-28 // 12 months ago
  • ๐Ÿš€ The 28th of October 2020 is the pygame 2.0 release date, because pygame turns 20 years of age.


     ,--. | oo| | ~~| ooooooooooooo|/\/\| python3 -m pip install pygame==2.0.0
    

    What's the best feature of pygame 2? Maybe it's " backwards compatibility". For many, many apps pygame 2 is backwards compatible. Have an pygame app from the year 2000? It will probably work. We still have some known issues and open backwards compatibility issues(see below), but a lot of things work just as they did before. Yes, we still have python 2 support.

    How does one summarize the 3306 changes since we started the pygame 2 series in July of 2018 based on patches going back to 2012 and even earlier?

    • ๐Ÿ‘Œ Support for Metal, Direct 3d, Vulkan, OpenGL 3.0+ in various profiles (core, compatibility, debug, robust, etc), OpenGL ES, and other modern hardware accelerated video APIs across many platforms.
    • SSE2/Neon assembly image drawing. Much faster drawing routines, image loading, and alpha blending.
    • Type Hints, for code completion (and to help you make the squiggly lines disappear) in editors and IDEs.
    • Code cleanup, using lots of code robustness tools like static analyzers, and automated CI/CD. We've been able to help dozens of people new to community projects contribute. We have lots of work to go on code quality, but we're currently the highest rated Python and highest rate C large project on LGTM.
    • ๐Ÿ›  Many, many bug fixes including in our pygame.draw routines, pygame.math(for vectors), and pygame.mask for pixel perfect collision detection.
    • ๐Ÿ‘ better support for PyPy (the fast JIT based implementation of python). See our milestone Are we pypy yet? No. for our progress on making PyPy the best python for games.
    • ๐Ÿšš libsdl version 2 support. Technically pygame 2.0 still works with SDL 1, but we recommend SDL2 which is vastly improved over SDL1 for most use cases. Probably we will remove SDL 1 support starting pygame 2.1.
    • ๐Ÿ‘ Touch support (multitouch, gestures, etc)
    • ๐Ÿ‘ Audio input support (make games with your microphone!).
    • Message alert boxes (Press OK, or Cancel).
    • ๐Ÿ‘ Better keyboard support. Proper unicode input and IME support.
    • ๐Ÿ‘ Much improved game controller support.
    • ๐Ÿ‘ Better image and audio format support. Including: webp, 32bit wav files, and much more reliable mp3 support.
    • ๐Ÿ‘ Multiple display support, and multiple window support (multi window support is still experimental, more will come in pygame 2.1).
    • ๐Ÿ“š Android support through python for android (fork of pygame subset for android). Better documentation, and better support will come in future releases.
    • to make distributing your apps easier, a built in "pyinstaller hook"and compatibility with cxfreeze.
    • โœ… binary "wheels" on many platforms and versions of python from the old python 2.7 - to the latest python 3.9 (and with pypy!).
    • ๐Ÿ‘ lots of quality of life improvements like Surface.fill('black') instead of Surface.fill(pygame.Color(0, 0, 0)). Also keywords are supported for many more function arguments. You can draw rounded corners on rects.
    • plenty of new examples, like python3 -m pygame.examples.font_viewer, and python3 -m pygame.examples.music_drop_fade. Additionally the example source code has been cleaned up a lot to follow a more current python style.
    • ๐Ÿ“š Hundreds of documentation improvements, include a new Korean tutorial.
    • ๐ŸŒ a special SCALED mode which takes low pixel games and automatically translates them to a larger window. Imagine your 320x200 resolution game of glorious pixel art... on modern screens that would be a very tiny windows. Now with SCALED it shows up big on a Full HD screen, or even a 4K/8K screen and the translation of mouse coordinates and up-scaling of pixels is done for you (hardware accelerated of course).

    ๐Ÿš€ That was a summary of some of the goodies in pygame 2. We will be releasing more articles and tutorials on new features as time goes on. You can also look at the previous release notes for more info (see end of this post).

    ๐Ÿฑ thank you ๐ŸŽ‰

    ๐Ÿšš Probably one of the better realizations thinking about pygame on its 20th birthday is that there is a much larger group of people who have contributed to crafting pygame in recent years. Some have moved onto other things like jobs, family or writing cookbooks in the Canadian wilderness. Much respect for volunteering time to a community project like pygame.

    Firstly thanks to the pygame team members who contributed to the pygame 2 series, new and old...

    ๐Ÿ‘ท David Lรถnnhager (@dlon) | Renรฉ Dudfield (@illume) | Charles (@charlesej) | Dan Lawrence (@MyreMylar) | Ankith (@ankith26) | Niels Thykier (@nthykier) | Lenard Lindstrom (@llindstrom) | Sigurรฐur Sveinn Halldรณrsson (@siggisv) | @robertpfeiffer | Josip Komljenoviฤ‡ (@MightyJosip) | Travis Chang (@Reminisque) | xFly_Dragon (@husano896) | Adam Andrews (@adamandrews1) | (@galexandreg) | Thiago Jobson (@thiagojobson) | (@mcpalmer1980) | @charlesoblack | Daniel Pope (@lordmauve) | Thomas Kluyver (@takluyver) | @e1000 | Andy Nguyen (@anguye13) | @Starbuck5 | Ian Mallett (@imallett)

    Equally important thank you go out to all the other contributors, some of which contributed to a community project for the first time.

    ๐Ÿ‘€ Pedro de la Peรฑa @pedrodelapena | @lkito | @khuang0312 | @tsadama | @Bottersnike | @alphaCTzo7G | Amos Bastian (@amosbastian) | Andrey Lopukhov (@andreyx86) | Augusto Noronha (@augusto2112) | Bernardo Sulzbach (@bernardosulzbach) | (@Bottersnike) | Cai Q.T. (@CAIQT) | (@Cerealdragon) | (@ChrisWeissNike) | (@cmtrapp02) | Daniel Molina (@daniel-molina) | David Caughell (@DavidCaughell) | (@dr0id) | burmer (@dtschirmer) | (@IchMageBaume) | (@LambdaGoblin) | Franรงois Magimel (@Linkid) | (@LiquidFenrir) | Mark Hurley (@markph0204) | Marius Gedminas (@mgedmin) | (@metulburr) | Michael Farrell (@micolous) | Dominik George (@Natureshadow) | Nik (@nikolas) | Nunu-Willump (@Nunu-Willump) | (@pleboulanger) | Rebecca Chen (@rchen152) | (@robertpfeiffer) | Sett (@sw00) | @seenemikk | Nguyแป…n Gia Phong (@McSinyx)| Sebastian Henz | @BastiHz | Alice Lia Stapleton (@slimelia)

    raphacosta27 (@raphacosta27) | Bill (@AdditionalPylons) | Gabriel Moreira (@gabsmoreira) | zoldalma999 (@zoldalma999) | amipy (@amipy) | DGMcKenney (@DGMcKenney) | Grigoris Tsopouridis ((@gtsopus)) | Ilia Gogotchuri (@Gogotchuri) | Jim Quach (@jiquach) | Aaron Li (@AaronLi) | Clark Seanor (@cruxicheiros) | K Duggan (@kduggan15) | Michaล‚ Gรณrny (@mgorny) | Clark Seanor (@cruxicheiros) | jtoloff (@jtoloff) | 41aaronb (@41aaronb) | Prasanna Venkatesh (@hanzohasashi33) | zoldalma999 (@zoldalma999) | Nihal Mittal (@codescientist703) | leopoldwe (@leopoldwe) | Scott Noyes (@snoyes)

    Vicente Gonzรกlez Ruiz (@vicente-gonzalez-ruiz)| Douglas (@douglas-cpp) | wuzh07 (@wuzh07) | Gerardo Antonio Hagad (@ginohagad) | Evan Kanter (@evank28) | Inada Naoki (@methane) | Jani Tiainen (@jtiaicomparison) | Christian Clauss (@cclauss) | Gosha Zacharov (@Gosha) | Steven Chua (@Graphcalibur) | K Duggan (@kduggan15) | PeanutbutterWarrior (@PeanutbutterWarrior) | Nachiket Naganure (@NachiketUN) | Pierre Haou (@pierrehaou) | Daniel Gillet (@dangillet) | Stefano Rivera (@stefanor) | Andre Miras (@AndreMiras) | glennmackintosh (@glennmackintosh) | Vilhelm Prytz (@vilhelmprytz) | DotMars (@DotMars) | Gabriel Duque (@zuh0) | Mark Hurley (@markph0204) | Henrik Petersson (@hnrkcode) | Grigoriy (@flaambe) | Matt Sheppard (@mampersat) | s0lst1ce (@s0lst1ce) | Norman Packard (@nhpackard) | peanutbutterandcrackers (@peanutbutterandcrackers)

    ๐Ÿฑ A special thanks to all the people who help out others. From making videos, to answering questions, to writing guides (and even whole books). MyreMylar, MichaelCPalmer, jtiai, claudeb, DaFluffyPotato, Rabbid76, The Big Kahuna, sloth, Kingsley, ... and lots of other people. Thanks to the mods on forums, chat rooms and Q&A sites. Special thanks to Zireael07 for cheering on pull requests that people make ๐ŸŽ‰ Thanks to people adding support and integration to libraries and tools like pgzero(lordmauve and co), Mu Editor (Nicholas and team), and pymunk (Victor Blomqvist). Very many people have contributed by reporting issues. This is fantastic help for people ๐Ÿ‘ ๐Ÿ‘ ๐Ÿ‘ Without these issue reports and help in testing bugs and new features many parts simply wouldn't work. Thanks to the SDL folk, to the fluidsynth crew, to numpy devs (Matti and co), python for android, pypy project, and the python community at large. Thanks to the folks running game jams like ludumdare(Mike), pyweek(lordmauve), and alakajam. Thanks to renpytom for pygame subset for android and pygame_sdl2, thanks to Marcus von Appen for pysdl2. Thanks to people sharing your work with others on the pygame website, or on places like the pygame reddit, discord, or youtube. Thanks to the kind folk who work on packaging pygame from Debian, Ubuntu, Arch, FreeBSD, and piwheels (@bennuttall). Thanks for the people teaching and learning with pygame all over the world. Last but not least... a very special thanks to everyone we've missed that should be listed here.

    Really. Thank you (you). Thanks.

    Known issues

    We have an up to date list of issues marked with the Compatibility Python 2 label. These are compatibility issues where something worked in pygame 1, but doesn't work in pygame 2.

    At the time of writing this included:

    • ๐Ÿ“ฆ the pygame.cdrom package not being there (mainly because it isn't in SDL2 anymore).
    • โœ… pygame.scrap is only working with text, not images (needs some porting and testing done).
    • pygame.event.post is having issues with some event types.
    • pygame.display.set_palette is not implemented (not in SDL2).
    • display.set_mode() ignores depth value. It just returns one it thinks is appropriate.

    ๐Ÿšง We've already investigated many of these issues, and even have some work in progress on some of them. If you're particularly interested in one of them please let us know. Also if you have any issues with your existing apps, we are very interested in finding out.

    ๐Ÿฑ ๐ŸŒบ๐ŸŒป๐ŸŒน๐Ÿฅ€๐ŸŒท๐ŸŒผ๐ŸŒธ๐Ÿ’๐Ÿ’ฎ๐ŸŒบ๐ŸŒป๐ŸŒน๐Ÿฅ€๐ŸŒท๐ŸŒผ๐ŸŒธ๐Ÿ’๐Ÿ’ฎ๐ŸŒบ๐ŸŒป
    ๐Ÿฑ ๐ŸŒผ๐ŸŒธ python3 -m pip install pygame==2.0.0
    ๐Ÿฑ ๐ŸŒบ๐ŸŒป๐ŸŒน๐Ÿฅ€๐ŸŒท๐ŸŒผ๐ŸŒธ๐Ÿ’๐Ÿ’ฎ๐ŸŒบ๐ŸŒป๐ŸŒน๐Ÿฅ€๐ŸŒท๐ŸŒผ๐ŸŒธ๐Ÿ’๐Ÿ’ฎ๐ŸŒบ๐ŸŒป

    ๐Ÿฑ Happy pygame 20th birthday all! ๐ŸŽ‰ ๐Ÿฐ ๐Ÿฅณ



Previous changes from v2.0.0.dev24

  • python3 -m pip install pygame=2.0.0.dev24
    

    ๐Ÿš€ A bunch of fixes and speedups before the release.
    0๏ธโƒฃ Now the default branch on the pygame repo is main.

    @MyreMylar Dan Lawrence

    • Sets SDL Hint for hidden mouse cursor at window edges when full screen #2254
    • Documents that integers underlying key code constants differ between Pygame 1 & 2 #2253
    • โšก๏ธ Updates the joystick docs to include controller mappings for X360 & PS4 controllers #2252
    • โšก๏ธ Updates the docs for toggle_fullscreen() #2251
    • ๐Ÿ†• New Alpha blitter - fixes and speed ups #2243

    @siggisv Sigurรฐur Sveinn Halldรณrsson

    • โž• Add to test/draw_test.py some unit tests for draw.line() #2247

    Ankith @ankith26

    • A small little deletion of obsolete file #2256
    • Do MOUSEBUTTONUP event on MOUSEWHEEL #2242
    • ๐Ÿ›  Fix event.post KEYDOWN/KEYUP #2244