pyprocgame 0.9 Release Notes

The following change notes are a summary of changes between git hash 8482d6009a3b81f8624e and 8a769c077d1c184f5dcd:

General & Game

• Reorganized pyprocgame module source into separate files but consolidated submodules. Most classes are still at the same module path externally, but the following have moved:

  • procgame.scoredisplay.ScoreDisplay moved to procgame.modes.ScoreDisplay
  • procgame.trough.Trough moved to procgame.modes.Trough
  • procgame.ballsave.BallSave moved to procgame.modes.BallSave
  • procgame.ballsearch.BallSearch moved to procgame.modes.BallSearch
  • procgame.replay.Replay moved to procgame.modes.Replay
  • procgame.highscoreentry.HighScoreEntry moved to procgame.modes.HighScoreEntry

  Most of the changes can be seen in commit c06a031d1505c30a86b4.

• Mode switch handlers should now return procgame.game.SwitchStop or SwitchContinue, instead of True or False. Although the values are the same the meaning is much clearer.

• Added procgame.game.BasicGame, a new subclass of procgame.game.GameController that comes with helpful classes like procgame.modes.ScoreDisplay already installed. Recommended for new game development.

• Added procgame.config module to facilitate system-wide configuration such as the path to DMD files (used to populate procgame.dmd.font_path and used within procgame.dmd.font_named()).

• Added procgame.desktop.Desktop which provides a virtual DMD and incorporates keyboard-to-event features previously in procgame.keyboard. Both are demonstrated in the source code to procgame.game.BasicGame.

• Removed procgame.game.Player.info_record. Devs should use a game-specific subclass of Player with the new method procgame.game.GameController.create_player().

• Added procgame.fakepinproc.FakePinPROC, a pinproc.PinPROC stand-in.

• Added procgame.game.GameController.create_pinproc() to enable subclassing or replacing pinproc.PinPROC.

• The procgame.sound.SoundController will disable itself if it cannot initialize pygame.mixer.

• Added procgame.game.GameController.get_events() and procgame.game.GameController.tick().

• Renamed machineType variables to the more Pythonic machine_type.

• Renamed procgame.game.GameController.write_settings() to save_settings(). Renamed write_game_data() to save_game_data().

DMD

• Fixed procgame.dmd.Animation.save() on some Windows platforms.
• Removed procgame.dmd.DisplayController.capture and procgame.dmd.DisplayController.alt_frame_handler in favor of procgame.dmd.DisplayController.frame_handlers.
• Added procgame.dmd.Frame.subframe() and procgame.dmd.Frame.create_with_text().
• Fixed a case where the procgame.dmd.Layer.opaque property was not checked by procgame.dmd.DisplayController.update().
• Added procgame.dmd.ScriptedLayer.force_next(). Added transitions to procgame.dmd.ScriptedLayer (experimental).
• procgame.dmd.AnimatedLayer changed to no longer destructively edit the frames list. Added procgame.dmd.FrameQueueLayer, which does destructively edit the frames list.
• dmdconvert.py now sets upper four bits of each DMD dot to the source image’s alpha channel value, if present.
• Added procgame.highscore module, with new procgame.highscore.EntrySequenceManager.
• Added y_offset parameter to procgame.dmd.MarkupFrameGenerator.frame_for_markup().
• Added procgame.dmd.PanningLayer.
• Added support for coils to procgame.lamps.LampShowTrack and fixed a bug (thanks Koen) in name processing.

pypinproc

• procgame.game.GameController now calls pinproc.PinPROC.flush() after every game loop. This is in response to removing PRFlush() calls from within pypinproc driver update calls.
• Added event type constants pinproc.EventTypeSwitchClosedDebounced and others.
• Added machine type constants pinproc.MachineTypeWPC and others. Added support for wpc95 and wpcAlphanumeric machine types.
• Added auxiliary bus commands.
• Added pinproc.PinPROC.driver_pulsed_patter().
• Added switch rule reload; see pinproc.PinPROC.switch_update_rule().