len0rd/rockbox
1
0
Fork 1
mirror of https://github.com/Rockbox/rockbox.git synced 2025-11-09 21:22:39 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

puzzles: update documentation and copyright year.

Browse source 
Change-Id: I50731664f278f76946f96529f4ec696c9c115589
This commit is contained in:
Franklin Wei 2024-07-23 20:53:07 -04:00
parent 96f564fe64
commit cd1922fe74
2 changed files with 16 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

3
apps/plugins/puzzles/README.rockbox
View file

@ -64,3 +64,6 @@ May 2019: Resync to e2135d5.
June 2020: Resync to 9aa7b7c. Fixed really embarrassing bug in loading June 2020: Resync to 9aa7b7c. Fixed really embarrassing bug in loading
saved games. saved games.
July 2024: Resync to 1c62dac (branched from Simon's fd304c5).
Implement user preferences menu. Introduced "Mosaic".

24
apps/plugins/puzzles/rockbox.c
View file

@ -7,7 +7,7 @@
* \/ \/ \/ \/ \/ * \/ \/ \/ \/ \/
* $Id$ * $Id$
* *
* Copyright (C) 2016-2020 Franklin Wei * Copyright (C) 2016-2024 Franklin Wei
* *
* This program is free software; you can redistribute it and/or * This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License * modify it under the terms of the GNU General Public License
@ -24,10 +24,9 @@
* ================================ * ================================
* *
* This file contains the majority of the rockbox-specific code for * This file contains the majority of the rockbox-specific code for
* the sgt-puzzles port. It implements a set of functions for the * the sgt-puzzles port. It implements an API for the backend to call
* backend to call to actually run the games, as well as rockbox UI * to run the games, as well as the rockbox UI code (menus, input,
* code (menus, input, etc). For a good overview of the rest of the * etc). For a good overview of the rest of the puzzles code, see:
* puzzles code, see:
* *
* <https://www.chiark.greenend.org.uk/~sgtatham/puzzles/devel/>. * <https://www.chiark.greenend.org.uk/~sgtatham/puzzles/devel/>.
* *
@ -37,7 +36,7 @@
* Contents of this file * Contents of this file
* --------------------- * ---------------------
* *
* By rough order of appearnce in this file: * By rough order of appearance in this file:
* *
* 1) "Zoom" feature * 1) "Zoom" feature
* *
@ -62,8 +61,7 @@
* mode switching. In commit 5094aaa, this behavior was changed so * mode switching. In commit 5094aaa, this behavior was changed so
* that the frontend can now query the backend for the on-screen * that the frontend can now query the backend for the on-screen
* cursor location and move the viewport accordingly through the * cursor location and move the viewport accordingly through the
* new midend_get_cursor_location() API (which is not yet merged * new midend_get_cursor_location() API.
* into Simon's tree as of October 2020).
* *
* 2) Font management * 2) Font management
* *
@ -82,8 +80,8 @@
* *
* 3) Drawing API * 3) Drawing API
* *
* The sgt-puzzles backend wants a set of function pointers to the * The sgt-puzzles backend wants a set of function pointers to
* usual drawing primitives. [1] If the `zoom_enabled' switch is * typical drawing primitives. [1] If the `zoom_enabled' switch is
* on, these call upon the "zoomed" drawing routines in (1). * on, these call upon the "zoomed" drawing routines in (1).
* *
* In the normal un-zoomed case, these functions generally rely on * In the normal un-zoomed case, these functions generally rely on
@ -108,7 +106,7 @@
* a) Mouse mode * a) Mouse mode
* *
* This mode is designed to accommodate puzzles without a * This mode is designed to accommodate puzzles without a
* keyboard or cursor interface (currently only "Loopy"). We * keyboard or cursor interface (currently only Loopyx). We
* remap the cursor keys to move an on-screen cursor rather * remap the cursor keys to move an on-screen cursor rather
* than sending arrow keys to the game. * than sending arrow keys to the game.
* *
@ -175,6 +173,10 @@
* generation, etc. Also supplied are a set of "presets" that * generation, etc. Also supplied are a set of "presets" that
* specify a predetermined set of configuration parameters. * specify a predetermined set of configuration parameters.
* *
* In 2023, Simon introduced a User Preferences system that allows
* further customization of the game UI (e.g., "snap to grid" in
* Untangle). Rockbox support for this was added in July 2024.
*
* 6) In-game help * 6) In-game help
* *
* The sgt-puzzles manual (src/puzzles.but) contains a chapter * The sgt-puzzles manual (src/puzzles.but) contains a chapter