news.rst

Release News

This describes the latest changes between the PySDL2 releases.

0.9.17 (Unreleased)

New Features:

• Updated to wrap new function added in SDL_image 2.8.0 (PR #274).
• Updated to wrap new hints added in SDL 2.28.2 and 2.28.5 (PR #274).
• Added a new function :func:`~sdl2.ext.get_key_state` for checking if a given key is currently down or up independently of the SDL event queue.

Fixed Bugs:

• Fixed proper exporting of controller enum constants for the NVidia Shield and Joycon controllers.

0.9.16

Released on 2023-06-28.

New Features:

• Updated to wrap new functions and constants in SDL2 2.28.0 (PR #266).
• Added a new method :meth:`~sdl2.ext.Renderer.rcopy` for copying textures to a Renderer by aligning a given point on the texture to a given location on the rendering context. Useful for centering textures in the renderer.
• Added a new function :func:`~sdl2.ext.key_pressed` for easily checking if a given key has been pressed (or released).
• Added a new function :func:`~sdl2.ext.mouse_clicked` for easily checking if a mouse button has been pressed (or released), as well as a :func:`~sdl2.ext.get_clicks` function for retrieving the pixel coordinates of any mouse clicks.
• Added a new function :func:`~sdl2.ext.get_text_input` for returning text input as a unicode string, as well as :func:`~sdl2.ext.start_text_input`, :func:`~sdl2.ext.stop_text_input`, and :func:`~sdl2.ext.text_input_enabled` functions for toggling and querying whether SDL text input events are enabled.
• Added a new function :func:`~sdl2.ext.quit_requested` for easily checking :func:`~sdl2.ext.get_events` output for quit requests.

0.9.15

Released on 2023-01-08.

New Features:

• Added a series of new functions :func:`~sdl2.ext.show_cursor`, :func:`~sdl2.ext.hide_cursor`, and :func:`~sdl2.ext.cursor_hidden` for changing and querying the visibility of the mouse cursor.
• Added new functions :func:`~sdl2.ext.mouse_coords` and :func:`~sdl2.ext.warp_mouse` for getting and setting the current position of the mouse cursor.
• Added a new function :func:`~sdl2.ext.mouse_delta` for checking the relative movement of the mouse cursor since last checked.
• Added a new function :func:`~sdl2.ext.mouse_button_state` and corresponding class :class:`~sdl2.ext.ButtonState` for easily checking the current state of the mouse buttons.
• Added indexing support for :class:`sdl2.SDL_Point` and :class:`sdl2.SDL_Rect` to allow easier unpacking in Python (e.g. x, y, w, h = rect).
• Cache :class:`sdl2.ext.Texture` sizes for faster retrieval, improving render performance in some cases.
• Updated to wrap new functions and constants in SDL2 2.26.0 (PR #252 & #253).
• :meth:`~sdl2.ext.SpriteFactory.from_image` now accepts PIL.Image.Image objects directly in addition to image filepaths (PR #255 & #256).

Fixed Bugs:

• Fixed bug preventing SDL Points and Rects from being used as srcrect or dstrect for :meth:`~sdl2.ext.Renderer.copy`.
• Added a binding for SDL_ResetHint, which was added in SDL 2.24.0 but got missed in PR #246.

0.9.14

Released on 2022-09-03.

New Features:

• Added a new function :func:`~sdl2.ext.get_displays` and class :class:`~sdl2.ext.DisplayInfo` to provide an easier and more Pythonic API for getting information about the names, locations, and supported video modes of the connected displays.
• Extended :func:`~sdl2.ext.init` to allow initializing all SDL2 subsystems individually using keyword arguments (e.g. sdl2.ext.init(audio=True) to initialize the audio subsystem as well as the default video subsystem). Previously, this function only initailized the video subsystem.
• Updated to wrap new functions and constants in SDL2 2.24.0 (PR #246).
• Added the error-handling :func:`sdl2.ext.raise_sdl_err` function to the public API.
• Added informative exceptions when trying perform operations (e.g. show, hide, minimize) on a closed :obj:`sdl2.ext.Window`, and generally improved memory safety of the Window class.

Fixed Bugs:

• Fixed broken behaviour (and potential segfaults) with usage of :func:`sdl2.SDL_GUIDToString` on Python 3.6 and older (PR #246).
• Fixed :func:`sdl2.ext.draw` when drawing on 1bpp surfaces (PR #242).

API Changes:

• Moved :class:`sdl2.ext.SDLError` and :func:`sdl2.ext.raise_sdl_err` internally to a new submodule :mod:`sdl2.ext.err`.
• :obj:`sdl2.ext.Window` objects can now be repositioned when closed (would previously raise an SDLError exception).

0.9.13

Released on 2022-07-26.

New Features:

• Updated to wrap new functions and constants in SDL2_ttf 2.20.0 (PR #236).
• Updated to wrap new functions and constants in SDL2_mixer 2.6.0 (PR #237).
• Updated to wrap new functions and constants in SDL2_image 2.6.0 (PR #238).
• Added a new function :func:`sdl2.ext.load_svg` that allows loading simple SVG images at arbitrary resolutions with SDL2_image 2.6.0 or later (PR #238).
• Added experimental bindings for the new functions and constants in the SDL2 2.23.1 pre-release (PR #240).

0.9.12

Released on 2022-07-18.

New Features:

• Updated to wrap new functions and constants in SDL2 2.0.22 (PR #226)
• Added a new stable API for accessing the raw ctypes function bindings for each submodule. Each submodule (e.g. sdl2.sdlttf, sdl2.video) now contains a _ctypes object through which the raw ctypes function objects can be accessed by attribute or dict key (e.g. sdlttf._ctypes.TTF_Linked_Version or sdl2.timer._ctypes["SDL_GetTicks"]). This new API allows proper access to the ctypes function objects for the sdlttf, sdlmixer, sdlimage, and sdlgfx modules (which have been migrated to thin Python function wrappers around the ctypes bindings), and also allows developers to write code that will not break when other SDL2 modules are eventually migrated to similar Python-wrapped bindings.

Fixed Bugs:

• Fixed a bug in :func:`~sdl2.rw_from_object` where calling :func:`~sdl2.SDL_RWsize` on the resulting object would change the RWops' current byte position unexpectedly.
• Fixed the type of the datasize argument for :func:`~sdl2.SDL_LoadFile` to be a pointer to a c_size_t (was previously just c_size_t).
• Fixed namespace export for :func:`~sdl2.SDL_RenderSetVSync` (issue #219)
• Re-added direction field for :obj:`~sdl2.SDL_MouseWheelEvent` events, which was accidentally removed in PySDL2 0.9.10 (issue #217)
• Fixed namespace export for AUDIO_F32MSB and :obj:`~sdl2.SDL_AudioDeviceEvent`.
• Fixed :func:`~sdl2.SDL_LoadFile` with Python 3 and old versions of SDL2 (2.0.9 and older).
• Fixed a bug in :class:`~sdl2.ext.FontTTF` that prevented rendering text with empty lines.
• Fixed a bug in :class:`~sdl2.ext.Renderer` that prevented users from requesting a renderer backend by name (PR #224)
• Changed :func:`~sdl2.SDL_abs` to be an actual ctypes binding instead of an alias for Python's built-in abs function.
• Renamed the SDL_Blit ctypes function definition to SDL_blit to match the SDL2 headers.
• Fixed export of SDL_TIMER_RESOLUTION hint (was previously not accessable through the sdl2 namespace).
• Updated sdl2.dll.version to better handle SDL2's new versioning format and fixed unit tests accordingly (issue #228).
• Fixed various unit tests on big-endian platforms (PR #232).
• Fixed 32-bit wraparound behaviour for SDL_TICKS_PASSED (PR #235).
• Fixed SDL_MUSTLOCK to allow checking surface pointers in addition to surfaces.

0.9.11

Released on 2022-01-27.

New Features:

• Updated to wrap new functions and constants in SDL2 2.0.20 (PR #214)
• Updated to wrap new functions and constants in SDL2_ttf 2.0.18 (PR #216)

0.9.10

Released on 2022-01-11.

New Features:

• Updated the :mod:`~sdl2.sdlttf`, :mod:`~sdl2.sdlimage`, :mod:`~sdl2.sdlmixer`, and :mod:`~sdl2.sdlgfx` modules to use a new method of ctypes wrapping that allows functions to support kwargs (i.e. using function arguments by name), inline documentation, and more flexible handling of argument types and SDL errors (PR #199)
• Updated to wrap new functions and constants in SDL2 2.0.18 (PR #197)
• Added full inline documentation for the :mod:`~sdl2.sdlttf`, :mod:`~sdl2.sdlimage`, and :mod:`~sdl2.sdlgfx` modules, as well as partial inline documentation for the :mod:`~sdl2.sdlmixer` modlue. In addition to Python-specific argument and return types, the new docstrings also include including code examples and documentation of Python-specific quirks (PR #200)
• Update bindings to allow for experimental SDL 2.0.3 support. Versions of SDL2 this old are not officially supported, but this should allow for basic PySDL2 support on old PowerPC macs (PR #202)
• Added new :func:`~sdl2.ext.isiterable` and :func:`~sdl2.ext.utf8` Python 2/3 compatibility functions to the :mod:`~sdl2.ext.compat` module for checking if an object is a non-string iterable and for converting input to a UTF-8 unicode string, respectively (PR #204)
• The :func:`sdl2.ext.subsurface` function has been re-documented and rewritten to have improved input handling and type checking (PR #204)
• Improved inference of compression format for .tar archives in the :mod:`sdl2.ext.resources` submodule (PR #204)
• Added a new function :func:`sdl2.ext.surface_to_ndarray` that returns a non-transposed copy of a given SDL surface as a 2D or 3D Numpy array (PR #204)
• Added new functions :func:`sdl2.ext.load_bmp` and :func:`sdl2.ext.load_img` for importing image files using SDL2 and SDL_image, respectively. Both new functions automatically convert the obtained surfaces to the ARGB8888 pixel format by default (PR #205)
• Added a new function :func:`sdl2.ext.save_bmp` for saving SDL surfaces to BMP files (PR #205)
• Added a new function :func:`sdl2.ext.pillow_to_surface` for converting :obj:`PIL.Image.Image` objects from the Pillow library to SDL surfaces (PR #205)
• Added a new class :class:`sdl2.ext.Texture` for creating renderer textures from SDL surfaces, as a basic wrapper for the :obj:`sdl2.SDL_Texture` structure (PR #207)
• Added a new function :func:`sdl2.ext.set_texture_scale_quality` that globally sets the scaling method (nearest-neighbour, linear filtering, or anisotropic filtering) to use for new SDL textures (PR #207)
• Added a new method :meth:`sdl2.ext.Renderer.reset_logical_size` to reset a Renderer's logical size to its original value (PR #207)
• Added a new method :meth:`sdl2.ext.Renderer.destroy` to safely destroy and free memory associated with a Renderer after it is no longer needed (PR #207)
• Added support for subpixel precision (i.e. using float coordinates) with the drawing and copying methods of the :class:`~sdl2.ext.Renderer` class when using SDL2 2.0.10 or newer (PR #207)
• Added :meth:`sdl2.ext.Renderer.blit` as an alias for the :meth:`sdl2.ext.Renderer.copy` method (PR #207)
• Added a new method :meth:`~sdl2.ext.BitmapFont.remap` to the :obj:`~sdl2.ext.BitmapFont` class to allow specifying custom character widths and heights for each mapped character in a bitmap font (PR #208)
• Added a new argument line_h to :meth:`sdl2.ext.BitmapFont.render_on` to allow specifying custom line heights (PR #208)
• Added the :class:`~sdl2.ext.FontTTF` class, providing a new and flexible Pythonic wrapper around the :mod:`~sdl2.sdlttf` module for opening and rendering text with TrueType and OpenType fonts. New features include custom line heights for multi-line text, left/right/center justification operations for multiline text, and specifying font sizes in units of pixels in addition to pt (PR #210)
• Updated PySDL2 to automatically find and use Homebrew SDL2 binaries on Apple Silicon macs if no other usable binaries can be found.

Fixed Bugs:

• Fixed a typo in the :mod:`~sdl2.sdlttf` bindings where an alias for the :func:`~sdl2.sdlttf.TTF_RenderUTF8_Shaded` function was incorrectly bound to TTF_RenderUTF instead of TTF_RenderUTF8.
• Fixed a bug introduced in 0.9.9 where the SDL_WINDOW_INPUT_GRABBED constant was no longer exported.
• :class:`~sdl2.ext.MemoryView` and :class:`~sdl2.ext.PixelAccess` objects now support negative indexing (e.g. arr[-1][-1] for accessing the last element in a 2D array). In previous versions, negative indices would retrieve values from undefined sections of memory outside the surface (PR #204)
• Changed the functions in the :mod:`sdl2.ext.pixelaccess` module to no longer try to unlock RLE surfaces once their corresponding view objects are deleted. This prevents a segmentation fault when a view is garbage-collected but the surface has already been freed (PR #204)
• Fixed a bug where the rectangle returned by :meth:`sdl2.ext.BitmapFont.render_on` would overestimate the size of the rendered text by one character in both width and height (PR #208)
• :meth:`sdl2.ext.BitmapFont.contains` no longer assumes that the font map contains a space (PR #208)
• Rendering multiline text with the :class:`sdl2.ext.BitmapFont` class now always splits lines using the newline (\n) character. Previously on Windows, it would only split on Windows-style line endings (\r\n) (PR #208)

API Changes:

• Updated and redocumented the :func:`~sdl2.ext.stringify` and :func:`~sdl2.ext.byteify` Python 2/3 compatibility functions to better handle bytes encoding/decoding and no longer require specifying an encoding type (defaults to UTF-8 if not manually specified) (PR #204)
• The :func:`~sdl2.ext.subsurface` function now allows subsurface areas to be specified using :obj:`~sdl2.SDL_Rect` objects and surfaces to be passed either directly or as a pointer (PR #204)
• The :func:`sdl2.ext.pixels2d` and :func:`sdl2.ext.pixels3d` functions no longer raise an ExperimentalWarning (PR #204)
• Updated the :meth:`~sdl2.ext.Renderer.draw_line` and :meth:`~sdl2.ext.Renderer.draw_point` methods of the :class:`~sdl2.ext.Renderer` class to accept coordinates as lists of (x, y) tuples or :obj:`~sdl2.SDL_Point` in addition to flat [x, y, x, y, x, y] lists (PR #207)
• Updated the :meth:`~sdl2.ext.Renderer.draw_rect` and :meth:`~sdl2.ext.Renderer.fill` methods of the :class:`~sdl2.ext.Renderer` class to accept coordinates as lists of :obj:`~sdl2.SDL_Rect` in addition to lists of (x, y, w, h) tuples (PR #207)
• Updated the :meth:`~sdl2.ext.Renderer.copy` method of the :class:`~sdl2.ext.Renderer` class to accept an (x, y) tuple as a destination, inferring the destination width and height from the dimensions of the copied texture (PR #207)
• Changed the index argument for the :class:`~sdl2.ext.Renderer` class to take the name of the reqested rendering back end as a string instead of an index for better clarity and cross-platform consistency (PR #207)

Deprecation Notices:

• The :func:`sdl2.ext.open_url` function has been deprecated (PR #204)
• The :func:`sdl2.ext.load_image` function has been deprecated, as it unexpectedly produces different surface formats depending on the backend used. New projects should use the new :func:`sdl2.ext.load_img`, :func:`sdl2.ext.load_bmp`, and/or :func:`sdl2.ext.pillow_to_surface` functions instead (PR #205)
• The :func:`sdl2.ext.get_image_formats` function has been deprecated, as it gives inaccurate results in most cases (PR #205)
• The :meth:`sdl2.ext.BitmapFont.can_render` method has been deprecated (PR #208)
• The :meth:`sdl2.ext.BitmapFont.render` method has been deprecated in favor of :meth:`sdl2.ext.BitmapFont.render_text`, which returns an SDL surface instead of a SoftwareSprite and ensures the output surface is in ARGB8888 format by default (PR #208)
• The :class:`~sdl2.ext.UIFactory` and :class:`~sdl2.ext.UIProcessor` classes have been deprecated due to their complexity and maintenance burden. New functions and classes for creating GUIs with PySDL2 may be introduced in a future release (PR #209)
• The :class:`~sdl2.ext.FontManager` class has been deprecated in favor of the new and more flexible :class:`~sdl2.ext.FontTTF` class (PR #210)

0.9.9

Released on 2021-09-02.

New Features:

• Updated to wrap new functions and constants in SDL2 2.0.16 (PR #190)

Fixed bugs:

• Reverted the fix for (issue #139), which inadvertantly caused a serious bug that prevented usage of any non-software renderer with windows created using :obj:`~sdl2.ext.Window` objects.

0.9.8

Released on 2021-08-06.

New Features:

• Updated to wrap new functions and constants introduced in SDL2 2.0.12 and 2.0.14 (PR #163 & PR #181)
• Fixed DLL loading issues with Python installed from the Microsoft Store on Windows (PR #185)
• Added informative errors for when the newest SDL2 binaries found on the system are too old to be used by PySDL2 (issue #165)
• Added support for passing SDL_Rect objects to :func:`sdl2.ext.draw.fill` (issue #169)
• Added support for passing SDL_Surface pointers directly to many sdl2.ext functions, removing the need to explicitly use the .contents attribute.
• Added :obj:`sdl2.ext.MessageBox`, :func:`sdl2.ext.show_messagebox`, and :func:`sdl2.ext.show_alert` as Pythonic wrappers around the SDL2 MessageBox API (PR #188)

Fixed bugs:

• Fixed NameError when calling SDL_SetColorKey, by @mgorny (PR #166)
• Improved detection of SDL2 binaries on macOS, by @pvallet (PR #177 & PR #178)
• Fixed a bug preventing sdl2.ext.font.BitmapFont from being able to render, by @namelivia (PR #181)
• Fixed sdl2.ext.Window.show behaviour under Wayland (issue #139)
• Fixed a minor bug with the helloworld.py example (issue #174)
• Fixed a bug that prevented the line clipping functions in :mod:`sdl2.ext.algorithms` from working if top and bottom arguments were specified backwards (issue #101)

0.9.7

Released on 2020-02-15.

• The minimum required SDL version is 2.0.5
• The minimum required SDL_ttf version is 2.0.14
• The minimum required SDL_mixer version is 2.0.1
• The minimum required SDL_image version is 2.0.1
• Improved compatibility with older SDL2 releases by raising informative exceptions whenever a function requiring a newer SDL2 binary is called
• added support for loading SDL2 .framework binaries on macOS
• added built-in support for pip installation of SDL2 binaries on macOS and Windows using pysdl2-dll
• fixed issue #75: :func:`sdl2.SDL_JoystickGetGUIDString()` and :func:`sdl2.SDL_GameControllerMappingForGUID()` no longer cause a segfault on Python < 3.8
• fixed bug preventing use of background color with wrapped text using :meth:`sdl2.ext.FontManager.render()` (PR #134)
• fixed issue #112: allow easy moving and resizing of :obj:`sdl2.ext.Window()` objects through 'position' and 'size' attributes, added 'open' and 'close' methods to Window objects
• fixed issue #126: the write method for RW objects created with :func:`sdl2.rw_from_object()` now returns the correct value
• fixed issue #130: SDL_RW* functions now accept pointers to RW objects
• fixed issue #135: :func:`sdl2.SDL_GetPrefPath()` and :func:`sdl2.SDL_GetPrefPath()` now return bytestrings instead of pointers to strings.
• fixed issue #136: :class:`sdl2.SysWMmsg` now properly defined and accessable for syswm events.
• fixed issue #148: added support for loading SDL2 .so binaries with numeric suffixes on Unix-like OSes (e.g. 'libSDL2.so.2')
• fixed issue #152: restored compatibility with recent versions of PyPy
• fixed transparency issues with pallete indexed PNGs (PR #159)
• updated :mod:`sdl2` to include the latest changes of SDL2 (release 2.0.10)
• updated :mod:`sdl2.sdlttf` to include the latest changes of SDL2_ttf (release 2.0.15)
• updated :mod:`sdl2.sdlmixer` to include the latest changes of SDL2_mixer (release 2.0.4)
• updated :mod:`sdl2.sdlimage` to include the latest changes of SDL2_image (release 2.0.5)

Big thanks to all the GitHub users who filed bug reports and submitted pull requests for this release.

0.9.6

Released on 2017-09-30.

• updated :mod:`sdl2` to include the latest changes of SDL2 (release 2.0.6)
• fixed issue #98: wrap :func:`sdl2.SDL_GetHintBoolean()` correctly
• fixed issue #99: wrap :func:`sdl2.sdlmixer.Mix_PausedMusic()` correctly
• fixed issue #104: :meth:`sdl2.ext.Resources.scan()` shows the correct path on errors now
• fixed issue #106: fix :meth:`TextureSprite.__repr__()` for an unset center property
• fixed some minor GC issues in :mod:`sdl2.ext.sprite` and :mod:`sdl2.ext.font`
• fixed the __getattr__ implementation for :class:`sdl2.ext.ebs.Entity`
• fixed background colour handling for multiline text surfaces

0.9.5

Released on 2016-10-20.

• updated :mod:`sdl2` to include the latest changes of SDL2 (release 2.0.5)
• fixed issue #94: added support for TrueType font collection (TTC) files
• fixed issue #80: added flip and rotation support for TextureSprite objects
• renamed :attr:`sdl2.ext.Renderer.renderer` attribute to :attr:`sdl2.ext.Renderer.sdlrenderer`. The renderer attribute is deprecated and will be removed in a later version.

0.9.4

Released on 2016-07-07.

• updated :mod:`sdl2` to include the latest changes of SDL2 (release 2.0.4)
• updated :mod:`sdl2.sdlttf` to include the latest changes of SDL_ttf (release 2.0.14)
• new :attr:`sdl2.ext.Renderer.logical_size` attribute to set or retrieve the logical pixel size of a renderer
• fixed issue #48: be more noisy about DLL loading issues
• fixed issue #65: misleading documentation for :meth:`sdl2.ext.Renderer.draw_line()`
• fixed issue #67: Return a proper error code, when unittests running as subprocesses fail
• fixed issue #72: :func:`sdl2.video.SDL_GL_DrawableSize()` not available on import
• fixed issue #76: define missing SDL_PRESSED and SDL_RELEASED constants
• fixed issue #82: examples/gui.py fails due to an attribute error
• fixed issue #83: fix compatibility with newer PIL versions in :func:`sdl2.ext.image.load_image()`
• fixed issue #84: The setter of :attr:`sdl2.ext.Renderer.scale` works properly now
• fixed issue #85: fix environment-dependent unit tests
• fixed issue #87: fix incorrect MIX_INIT_* constants in :mod:`sdl2.sdlmixer`
• fixed issue #88: use PILs Image.tobytes() instead of the deprecated Image.tostring()
• fixed horizontical and vertical line drawing in :func:`sdl2.ext.line()`
• fixed a bug in :meth:`sdl2.ext.Renderer.draw_line()` for odd numbers of points
• dropped IronPython support

0.9.3

Released on 2014-07-08.

• updated :mod:`sdl2` to include the latest changes of SDL2 (HG)
• new :attr:`sdl2.ext.Renderer.scale` attribute, which denotes the horizontal and vertical drawing scale
• new :func:`sdl2.ext.point_on_line()` function to test, if a point lies on a line segment
• PYSDL2_DLL_PATH can contain multiple paths separated by :attr:`os.pathsep` to search for the libraries now
• :func:`sdl2.ext.get_image_formats()` only returns BMP image support now, if SDL2_image and PIL are not found
• :func:`sdl2.ext.load_image()` tries to use :func:`sdl2.SDL_LoadBMP()` now, if SDL2_image and PIL are not found
• fixed issue #55: :meth:`sdl2.SDL_GameControllerAddMappingsFromFile()` does not raise a TypeError for Python 3.x anymore
• fixed issue #56: :meth:`sdl2.ext.Renderer.draw_line()` and :func:`sdl2.ext.Renderer.draw_point()` handle multiple lines (or points) as arguments properly now
• fixed issue #57: if SDL2_image is not installed and PIL is used, the loaded pixel buffer of the image file is not referenced anymore after returning from :func:`sdl2.ext.load_image()`, causing random segmentation faults
• fixed issue #58: raise a proper error, if :meth:`sdl2.ext.FontManager.render()` could not render a text surface
• fixed issue #59: The :attr:`sdl2.ext.TextureSpriteRenderSystem.sdlrenderer` attribute is correctly documented now
• fixed a local variable and module name collision in :meth:`sdl2.ext.FontManager.render()`

Thanks to Filip M. Nowak for the PYSDL2_DLL_PATH improvement.

0.9.2

Released on 2014-04-13.

• fixed issue #32: the line clipping algorithms do not run into precision errors anymore
• fixed issue #53 (again): :func:`sdl2.video.SDL_GL_ResetAttributes()` is properly wrapped now to retain backwards compatibility with previous SDL2 releases
• fixed issue #54: text input is correctly converted for the text entry component
• updated the example BMP files, which could not be loaded properly on some systems with SDL2_image and PIL

0.9.1

Released on 2014-04-05.

• fixed issue #50: corrected the :func:`sdl2.ext.load_image()` documentation
• fixed issue #52: :meth:`sdl2.ext.Renderer.fill()`, :meth:`sdl2.ext.Renderer.draw_rect()` and :meth:`sdl2.ext.Renderer.draw_point()` convert sequences correctly now
• fixed issue #53: provide backwards compatibility for previous SDL2 releases by adding a wrapper func for :func:`sdl2.cpuinfo.SDL_HasAVX()`

0.9.0

Released on 2014-03-23.

IMPORTANT: This release breaks backwards-compatibility. See the notes for the issues #36 and #39.

• updated :mod:`sdl2` to include the latest changes of SDL2 (release 2.0.3)
• new :func:`sdl2.ext.subsurface()` function to create subsurfaces from :class:`sdl2.SDL_Surface` objects
• new :func:`sdl2.ext.SoftwareSprite.subsprite()` method to create :class:`sdl2.ext.SoftwarSprite` objects sharing pixel data
• the unit test runner features a --logfile argument now to safe the unit test output to a file
• issues #36, #39: the different render classes of sdl2.ext.sprite were renamed
  • the sdl2.ext.RenderContext class was renamed to :class:`sdl2.ext.Renderer` to be consistent with with SDL2's naming scheme
  • sdl2.ext.SpriteRenderer was renamed to :class:`sdl2.ext.SpriteRenderSystem`
  • sdl2.ext.SoftwareSpriteRenderer was renamed to :class:`sdl2.ext.SoftwareSpriteRenderSystem`
  • sdl2.ext.TextureSpriteRenderer was renamed to :class:`sdl2.ext.TextureSpriteRenderSystem`
  • sdl2.ext.SpriteFactory.create_sprite_renderer() was renamed to :meth:`sdl2.ext.SpriteFactory.create_sprite_render_system()`
• fixed :func:`sdl2.audio.SDL_LoadWAV()` macro to provide the correct arguments
• fixed issue #44: use a slightly less confusing ValueError, if a renderer argument for the :class:`sdl2.ext.SpriteFactory` is not provided
• fixed issue #43: improved the code reference for the improved bouncing section in the docs
• fixed issue #40: typo in a RuntimeWarning message on loading the SDL2 libraries
• fixed issue #38: the points arguments of :meth:`sdl2.ext.Renderer.draw_points()` are properly documented now
• fixed issue #37: :func:`sdl2.SDL_GetRendererOutputSize()` is now acccessible via a wildcard import
• fixed issue #35: download location is now mentioned in the docs
• fixed issue #12: remove confusing try/except on import in the examples

0.8.0

Released on 2013-12-30.

• updated PD information to include the CC0 dedication, since giving software away is not enough anymore
• updated :mod:`sdl2` to include the latest changes of SDL2 (HG)
• fixed a wrong C mapping of :func:`sdl2.rwops.SDL_FreeRW()`
• fixed various issues within the :class:`sdl2.ext.BitmapFont` class
• issue #26: :attr:`sdl2.SDL_AudioSpec.callback` is a :func:`SDL_AudioCallBack` now
• issue #30: the SDL_Add/DelHintCallback() unittest works with PyPy now
• issue #31: :func:`sdl2.sdlmixer.SDL_MIXER_VERSION()` returns the proper version now

Thanks to Sven Eckelmann, Marcel Rodrigues, Michael McCandless, Andreas Schiefer and Franz Schrober for providing fixes and improvements.

0.7.0

Released on 2013-10-27.

• updated :mod:`sdl2` to include the latest changes of SDL2 (release 2.0.1)
• fixed a bug in :meth:`sdl2.ext.FontManager.render()`, which did not apply the text color correctly
• issue #14: improved the error messages on failing DLL imports
• issue #19: the :meth:`sdl2.ext.TextureSpriteRenderer.render()` and :meth:`sdl2.ext.SoftwareSpriteRenderer.render()` methods do not misinterpret x and y arguments anymore, if set to 0
• issue #21: :func:`sdl2.ext.load_image()` raises a proper :exc:`UnsupportedError`, if neither SDL_image nor PIL are usable

Thanks to Marcel Rodrigues, Roger Flores and otus for providing fixes and improvement ideas.

0.6.0

Released on 2013-09-01.

• new :attr:`sdl2.ext.FontManager.size` attribute, which gives a default size to be used for adding fonts or rendering text
• updated :mod:`sdl2` to include the latest changes of SDL2
• :meth:`sdl2.ext.RenderContext.copy()` accepts any 4-value sequence as source or destination rectangle now
• issue #11: throw an :exc:`ImportError` instead of a :exc:`RuntimeError`, if a third-party DLL could not be imported properly
• fixed a bug in the installation code, which caused :mod:`sdl2.examples` not to install the required resources

Thanks to Steven Johnson for his enhancements to the FontManager class. Thanks to Marcel Rodrigues for the improvements to RenderContext.copy().

0.5.0

Released on 2013-08-14.

• new :class:`sdl2.ext.FontManager` class, which provides simple TTF font rendering.
• new :meth:`sdl2.ext.SpriteFactory.from_text()` method, which creates text sprites
• put the SDL2 dll path at the beginning of PATH, if a PYSDL2_DLL_PATH is provided to avoid loading issues for third party DLLs on Win32 platforms
• minor documentation fixes

Thanks to Dan Gillett for providing the FontManager and from_text() enhancements and his patience regarding all the small change requests. Thanks to Mihail Latyshov for providing fixes to the documentation.

0.4.1

Released on 2013-07-26.

• updated :mod:`sdl2` to include the latest changes of SDL2
• improved DLL detection for DLLs not being in a library path
• fixed a bug in :meth:`sdl2.ext.RenderContext.draw_rect()` for drawing a single rect
• fixed a bug in the :func:`repr` call for :class:`sdl2.ext.SoftwareSprite`
• issue #4: fixed a bug in :meth:`sdl2.ext.RenderContext.fill()` for filling a single rect
• issue #5: fixed pip installation support
• issue #6: fixed a bug in :func:`sdl2.ext.get_events()`, which did not handle more than 10 events in the queue correctly
• issue #8: :meth:`sdl2.ext.SpriteFactory.create_texture_sprite` can create sprites to be used as rendering targets now
• issue #9: improved error messages on trying to bind non-existent library functions via ctypes
• minor documentation fixes

Thanks to Steven Johnson, Todd Rovito, Bil Bas and Dan McCombs for providing fixes and improvements.

0.4.0

Released on 2013-06-08.

• new :mod:`sdl2.sdlmixer` module, which provides access to the SDL2_mixer library
• issue #1: fixed libc loading for cases where libc.so is a ld script
• updated :mod:`sdl2` and :mod:`sdl2.sdlimage` to include the latest changes of the libraries, they wrap

0.3.0

Released on 2013-05-07.

• new :mod:`sdl2.sdlgfx` module, which provides access to the SDL2_gfx library
• new :mod:`sdl2.ext.UIFactory.from_color` method; it creates UI-supportive sprites from a color
• fixed color argument bugs in :class:`sdl2.ext.RenderContext` methods
• fixed a module namespace issues in :mod:`sdl2.ext.pixelaccess`
• :mod:`sdl2.ext.SpriteFactory` methods do not use a default size argument anymore; it has to provided by the caller

0.2.0

Released on 2013-05-03.

• removed sdl2.ext.scene; it now lives in python-utils
• fixed :mod:`sdl2.haptic` module usage for Python 3
• fixed :func:`sdl2.SDL_WindowGetData` and :func:`sdl2.SDL_WindowSetData` wrappers
• fixed :meth:`sdl2.ext.RenderContext.copy`
• fixed :mod:`sdl2.ext.font` module usage for Python 3
• fixed :func:`sdl2.ext.line`
• :mod:`sdl2` imports all submodules now
• improved documentation

0.1.0

Released on 2013-04-23.

• Initial Release