21.2.1

Deployment

• PyPy wheels switched from PyPy 3.10 to PyPy 3.11.
• Experimental Pyodide wheels are now uploaded to PyPI.

Fixed

• tcod.sdl.joystick.get_joysticks, get_controllers, and related enumeration passed device indices to SDL3 functions expecting instance IDs, so enumeration could fail or open the wrong device after a joystick was reconnected.

21.2.0

Added

• tcod.event.MouseWheel now has which, window_id, position and integer_position attributes.

Fixed

• tcod.event.convert_coordinates_from_window was not converting all types of mouse events.

21.1.0

Added

• MouseButtonEvent.integer_position property.

Fixed

• integer_position was missing from mouse button events.

21.0.0

Added

• tcod.sdl.video.Window now accepts an SDL WindowID.
• tcod.event:
  • MouseState.integer_position and MouseMotion.integer_motion to handle cases where integer values are preferred.
  • ClipboardUpdate event.
  • Drop event.
  • KeyboardEvent.pressed, KeyboardEvent.which, KeyboardEvent.window_id attributes.
  • WindowEvent.data and WindowEvent.window_id attributes and added missing SDL3 window events.
  • which and window_id attributes for mouse events.
  • Events now have Event.timestamp and Event.timestamp_ns which use SDL's timer at tcod.event.time and tcod.event.time_ns.

Changed

• Event classes are now more strict with attribute types
• Event class initializers are keyword-only and no longer take a type parameter, with exceptions.
  Generally event class initialization is an internal process.
• MouseButtonEvent no longer a subclass of MouseState.
• tcod.event.Point is now a generic type containing int or float values depending on the context.
• When converting mouse events to tiles:
  MouseState.position and MouseMotion.motion refers to sub-tile coordinates.
  MouseState.integer_position and MouseMotion.integer_motion refers to integer tile coordinates.

Deprecated

• Event.type is deprecated except for special cases such as ControllerDevice, WindowEvent, etc.
• MouseButtonEvent.state is deprecated, replaced by the existing .button attribute.

Fixed

• Fixed incorrect C FFI types inside tcod.event.get_mouse_state.
• Fixed regression in mouse event tile coordinates being float instead of int.
  convert_coordinates_from_window can be used if sub-tile coordinates were desired.
• Fixed regression in libtcodpy.bsp_split_recursive not accepting 0.

20.1.0

Added

• Tileset now supports MutableMapping semantics.
  Can get, set, or iterate over tiles as if it were a dictionary containing tile glyph arrays.
  Also supports +, |, +=, and |= with other tilesets or mappings to merge them into a single Tileset.
• tcod.tileset.procedural_block_elements can take a tile shape and return a tileset.

Deprecated

• Tileset.set_tile(codepoint, tile) was replaced with tileset[codepoint] = tile syntax.
• Tileset.get_tile(codepoint) was soft replaced with tileset[codepoint] syntax.
• tcod.tileset.procedural_block_elements should be used with dictionary semantics instead of passing in a tileset.

20.0.0

Added

• Now supports free-threaded Python, deploys with cp314t wheels.
• Added methods: Renderer.coordinates_from_window and Renderer.coordinates_to_window
• Added tcod.event.convert_coordinates_from_window.

Changed

• Renderer.logical_size now returns None instead of (0, 0) when logical size is unset.

19.6.3

Fix missing deployment

19.6.2

Changed

• Update to libtcod 2.2.2

Fixed

• Mouse coordinate to tile conversions now support SDL renderer logical size and scaling.

19.6.1

Fixed

• tcod.event.add_watch was crashing due to a cdef type mismatch.

19.6.0

Added

• Alternative syntax for number symbols with KeySym, can now specify KeySym["3"], etc.
  Only available on Python 3.13 or later.

Fixed

• Fixed regression with lowercase key symbols with tcod.event.K_* and KeySym.* constants, these are still deprecated.
  Event constants are only fixed for tcod.event.K_*, not the undocumented tcod.event_constants module.
  Lowercase KeySym.* constants are only available on Python 3.13 or later.
• BSP.split_recursive did not accept a Random class as the seed. #168