Added

• Added text input support totcod.sdl.video.Window which was missing since the SDL3 update.
  After creating a context useassert context.sdl_window orif context.sdl_window: to verify that an SDL window exists then usecontext.sdl_window.start_text_input to enable text input events.
  Keep in mind that this can open an on-screen keyboard.

Resolve wheel deployment issue.

Fixed

• Console.print methods usingstring keyword were marked as invalid instead of deprecated.

Finished port to SDL3, this has caused several breaking changes from SDL such as lowercase key constants now being uppercase and mouse events returningfloat instead ofint.
Be sure to runMypy on your projects to catch any issues from this update.

Changed

• Updated libtcod to 2.1.1
• Updated SDL to 3.2.16
  This will cause several breaking changes such as the names of keyboard constants and other SDL enums.
• tcod.sdl.video.Window.grab has been split into.mouse_grab and.keyboard_grab attributes.
• tcod.event.KeySym single letter symbols are now all uppercase.
• Relative mouse mode is set viatcod.sdl.video.Window.relative_mouse_mode instead oftcod.sdl.mouse.set_relative_mode.
• tcod.sdl.render.new_renderer: Removedsoftware andtarget_textures parameters,vsync takesint,driver takesstr instead ofint.
• tcod.sdl.render.Renderer:integer_scaling andlogical_size are now set withset_logical_presentation method.
• tcod.sdl.render.Renderer.geometry now takes float values forcolor instead of 8-bit integers.
• tcod.event.Point and other mouse/tile coordinate types now usefloat instead ofint.
  SDL3 has decided that mouse events have subpixel precision.
  If you see any usualfloat types in your code then this is why.
• tcod.sdl.audio has been affected by major changes to SDL3.
  • tcod.sdl.audio.open has new behavior due to SDL3 and should be avoided.
  • Callbacks which were assigned toAudioDevice's must now be applied toAudioStream's instead.
  • AudioDevice's are now opened using references to existing devices.
  • Sound queueing methods were moved fromAudioDevice to a newAudioStream class.
  • BasicMixer may require manually specifyingfrequency andchannels to replicate old behavior.
  • get_devices andget_capture_devices now returndict[str, AudioDevice].
• TextInput events are no longer enabled by default.

Deprecated

• tcod.sdl.audio.open was replaced with a newer API, get a default device withtcod.sdl.audio.get_default_playback().open().
• tcod.sdl.audio.BasicMixer should be replaced withAudioStream's.
• Should no longer usetcod.sdl.audio.AudioDevice in a context, usecontextlib.closing for the old behavior.

Removed

• Support dropped for Python 3.8 and 3.9.
• RemovedJoystick.get_current_power due to SDL3 changes.
• WindowFlags.FULLSCREEN_DESKTOP is now justWindowFlags.FULLSCREEN
• tcod.sdl.render.Renderer.integer_scaling removed.
• Removedcallback,spec,queued_samples,queue_audio, anddequeue_audio attributes fromtcod.sdl.audio.AudioDevice.

Fixed

• Joystick.get_ball was broken.

Added

• tcod.path.path2d to compute paths for the most basic cases.

Fixed

• tcod.noise.grid would raiseTypeError when given a plain integer for scale.

Changed

• Console.print now acceptsheight andwidth keywords and has renamedstring totext.
• Text printed withConsole.print using right-alignment has been shifted to the left by 1-tile.

Deprecated

• In general thefg,bg, andbg_blend keywords are too hard to keep track of as positional arguments so they must be replaced with keyword arguments instead.
• Console.print: deprecatedstring,fg,bg, andbg_blend being given as positional arguments.
  Thestring parameter has been renamed totext.
• Console.print_box has been replaced byConsole.print.
• Console.draw_frame: deprecatedclear,fg,bg, andbg_blend being given as positional arguments.
• Console.draw_rect: deprecatedfg,bg, andbg_blend being given as positional arguments.
• TheEventDispatch class is now deprecated.
  This class was made before Python supported protocols and structural pattern matching,
  now the class serves little purpose and its usage can create a minor technical burden.

Added

• SDL renderer primitive drawing methods now support sequences of tuples.

Fixed

• tcod.sdl.Renderer.draw_lines type hint was too narrow.
• Fixed crash intcod.sdl.Renderer.geometry.

Changed

• EventDispatch's on event methods are now defined as positional parameters, so renaming theevent parameter is now valid in subclasses.

Deprecated

• Keyboard bitmask modifierstcod.event.KMOD_* have been replaced bytcod.event.Modifier.

Fixed

• Suppressed internalmouse.tile_motion deprecation warning.
• Fixed SDL renderer primitive drawing methods.#159

Fixed

• Fixed access violation when events are polled before SDL is initialized.
• Fixed access violation when libtcod images fail to load.
• Verify input files exist when callinglibtcodpy.parser_run,libtcodpy.namegen_parse,tcod.image.load.

Fixed

• Ignore the locale when encoding file paths outside of Windows.
• Fix performance when calling joystick functions.