added support for loading and saving number of currently active user

added support for multiple user game data directories

This change adds support for game data directories for multiple users,
to store individual user configuration files (like setup data and last
played level sets and levels) and individual user content files (like
personal tape files, but not personal level sets and scores, which are
still stored to be accessible by all users).

Special treatment is done for the game data files of the first user,
which are still stored in the main game data directory like before,
so there are no changes in file and directory paths for the "default
user", regardless if multiple user support is enabled or disabled.

added user structure for upcoming multiple user support

added setup option for upcoming new name selection screen

added definitions for upcoming new name selection screen

removed unnecessary braces in "return" statements

added missing free() for local string variable

improved code to type player name in main menu

improved code to set or change current artwork

fixed bug with tile selection cursor for MM game engine

added using setup values for tile selection cursor for MM game engine

added setup values for tile selection cursor for MM game engine

added function to remove entry from hash

moved initializing hash

fixed setup option position when using narrow font

improved tile selection cursor for MM game engine

added previously static function to header file

moved function to different source file

added highlighting of drawing element in editor when pressing "Alt" key

version number set to 4.2.0.6

fixed time of some game elements when reading native DC2 levels

fixed score of some game elements when reading native DC2 levels

fixed mapping of some game elements when reading native DC2 levels

fixed compiling on OS/2 (ArcaOS, in fact)

fixed activating robot wheel at wrap-around position for EM engine

fixed wrap-around with entering EM style door (gate) for EM engine

added "index.html" file for Emscripten support

added Emscripten support for running R'n'D in a web browser

removed unused definition

minor Makefile changes

added fix to Makefile to execute "sdl2-config" only once

added abstractions for using getpwuid()

removed unused array

fixed compiler warning with GCC 9

fixed handling of player at fake acid for EM engine

version number set to 4.2.0.5

fixed graphical bugs if digging or collecting caused player relocation

If digging or collecting (but not snapping!) certain tiles or elements
causes the player to be relocated ("teleported"), the corresponding
digging or collecting animation for this element will not be continued
anymore (because the player does not move towards this tile anymore).

To fix this problem, the digged or collected tile will be treated like
being snapped (using a temporary run-time element) for this edge case.
(The resulting engine behaviour is slightly different to the previous
behaviour, but should not break too many levels as this case should be
rather uncommon.)

increased the maximum tape length for playing extreme levels

Playing Alan Bond's famous "Zelda 2" one-level set requires a tape
playing time of several hours, which may exceed the previous maximum
tape length.

fixed bug with not setting grid size and buttons after screen changes

moved setting overlay grid size and buttons to separate function

changed handling "conf" and "properties" buttons in level editor

When clicking "conf" and "properties" buttons in the level editor when
the previous screen is not the playfield screen, it can be confusing
how to return to the playfield screen (by clicking both buttons in the
"right" order). To make things easier, both buttons now return to the
playfield screen if the user is already on the corresponding screen.

removed unused function

fixed bug with copying color key if surfaces have different format

This bug occurs when getting the color key of a surface and setting it
as the color key of another surface that has a surface format that
differs from that of the first surface.

This bug occurs in conjunction with the workaround for the color key
bug in SDL 2.0.12 which prevents transparency in graphics files with
color palette. (See commit 6b6c9eb2 for that workaround.)

Especially, this bug combination occurs on the high score screen of
Alan Bond's "Snake Bite" level set, which then only shows a headline
on a black screen. (This screen uses a trick to show each line on the
screen in a different color by using a background with different
colors and an inverted font with transparent characters and opaque
black surroundings, so missing transparency leads to "black text on
black background".)

changed function to check if a surface has a color key

improved inserting level sketch from clipboard to level editor

When pasting a level sketch to the level editor that has been copied
from the R'n'D forum, obsolete (historic) game elements will be mapped
to their current counterparts (just like it is done when loading an
old R'n'D level file). In addition, the corresponding game engine is
auto-detected (if possible) and set accordingly.

fixed bug with clicked text area gadgets marking level as changed

This bugs happens when clicking into a text area gadgets, then
deactivating it again by clicking somewhere else. This marks the level
as changed, even though nothing was changed at all.

fixed bug with text area gadgets when pressing "Escape" key

This bugs happens when leaving a text area gadget by pressing the
"Escape" key. While this is allowed and does not cause the previous
text area content to be restored (as text area gadgets cannot be
left using the "Enter" key, and as there may be huge amount of text
being entered), the corresponding callback function is not called, so
the entered text is lost as soon as the gadget gets unmapped.

fixed bug with text input gadgets when pressing "Escape" key

This bugs happens when incrementing or decrementing a numeric text
input gadget by 5 or 10 (using middle or right mouse button) so that
it gets a value beyond the allowed range. Although this will be
corrected, the "last value" variable still has the bad value, which
gets restored when clicking that text input gadget and then leaving
it by pressing the "Escape" key.

re-added accidentally removed program icon

The program icon file was unintentionally removed with commit
679bbca8.

version number set to 4.2.0.4

added disabling overlay touch buttons when showing envelope

added check to prevent unnecessary SDL download for Android build

removed unnecessary screen redraws when waiting for events to continue

added waiting for press/release events when waiting for events to continue

added always clearing player action when waiting for events to continue

added clearing player action for non-game finger release events

added clearing virtual buttons when clearing player action

added clearing touch info when clearing player action

moved code for setting touch info for finger events to separate function

added creating engine snapshots when using mouse click events

Before, when using mouse click events as CE change events, clicking on
a CE with mouse click event did not save a new game engine snapshot,
so undo/redo of CE mouse click events did not work.

With this change, undo/redo snapshots will also be created when using
mouse click events.

fixed single-step mode for mouse click events

Before, when using mouse click events as CE change events, pressing a
mouse button in the playfield when in single-step mode was immediately
followed by entering pause mode again.

With this change, pause mode is not entered as long as a mouse button
is pressed. (This already works similarly in the MM game engine.)

changed compiling on Android to use optimization for release builds

changed gcc optimization level from "-O3" to "-O2" for releases

This change was done due to general recommendations and because of
some versions of gcc emitting lots of misleading warnings with "-O3"
related to pointers possibly being null in cases where they surely
cannot be null ("warning: argument 1 null where non-null expected"
for "strcmp(s1, s2)" in src/libgame/misc.c after explicitly checking
that s1 is not null), which makes it harder to recognize "real"
warnings when building the distribution packages.

fixed showing commit hash on version page of info screen for Android

This is needed when building for Android and was missing in commit
438a173a.

fixed potential crash bug when loading custom artwork

This patch fixes a memory corruption bug that potentially leads to
program crashes when loading custom artwork (or level sets with custom
artwork) by accessing a potentially invalid bitmap pointer (used for
the global border bitmap).

fixed single-step mode for wrap-around levels in EM engine

This fixes a graphical bug when wrapping around in single-step mode by
drawing wrap-around animation before going to single step pause mode.

added full compatibility for wrap-around levels in EM engine

The previous support for wrap-around levels in the EM game engine was
some sort of "idealized" implementation that lets the player wrap
around by moving horizontally on the same vertical level position
forever (which results in truely infinite wrap-around levels).

This may be nice and perfect, but has the disadvantage that the
original Emerald Mine Club engine did not work that way, making
existing EMC levels unplayable and/or unsolvable. (Examples are
level 80 of "Ruppelmine 3" or level 34 of "The Exception 2".)

Instead, the original game engine caused the player to step one
vertical position up or down when leaving the playfield at the left
or right border, which is required by the mentioned example levels.

This correction adds a flag that is set by default to use the original
behaviour.

fixed support for wrap-around levels in EM engine

Fixed initializing wrap-around levels in the EM game engine; this was
done when loading the cave, but using a run-time flag, which is not
set until starting the game.

This is a regression bug of commit 04c0f302.

added showing commit hash on version page of info screen

enabled init time debugging messages when compiled with debug code

added multi-part line debug logging functions

removed unused functions to set/get internal error messages

changed non-fatal error handling to use new error functions

changed fatal error handling to use new error functions

moved variables for network server thread to network structure

renamed function

changed check for limiting debug output to substring match

moved checks for debug mode to main logging function

changed simple "printf()" debug output to new debug log function

changed printing game tile information to console and log file

changed printing level editor brush data to console and log file

fixed text event handling for newer SDL versions (again)

This fixes another regression of commit 5a53ae0c, 888ee049 and
35da46e4 that still causes incorrect key/text event handling.

The problem occurs when entering uppercase letters, which creates two
key events (pressed and released) with the lowercase letter (while
modifier state indicates that the Shift key is active), plus one text
event with the uppercase letter. The previous logic caused both cases
to be handled as a new key event, effectively handling that letter
twice (one time in lowercase, and another time in uppercase).

An additional check for text input style modifier keys prevents the
lowercase variant of the case described above not to be handled.

changed simple "printf()" debug output to new debug log function

removed checking for debug mode when using debug logging

fixed debug logging to omit output if debug mode disabled

added setting Android log level for new logging functions

changed warnings and debug output to use new generic logging functions

added option to limit debug output to specific debug mode

added generic logging functions (not used yet)

fixed potentially invalid string pointers when parsing options

When using command line options like "--option=argument" instead of
"--option argument" (which is especially needed if arguments are
optional), this resulted in invalid string pointers before this fix.

fixed regression bug introduced by changes for "autofix" command

This fixes program crashes that may happen when using automatic tape
replay with visible feedback (like "autoplay", "autowarp" etc.).

This is a regression of commit e534f3cf.

improved startup speed by optimizing parsing of parameter values

Commit bd5cd062 (that introduced event actions for global animations)
also added a nasty performance bottleneck due to complexity of parsing
event action parameters, which slowed down program startup phase quite
significantly. However, in most cases these parameters just stay at
their default values, so checking for that default value first results
in massively speeding up this part of the startup phase.

added ability to undo (restore) the previously recorded tape

When the in-memory tape is erased with more than a minimum length of
playing time (currently set to 20 seconds), an internal copy of the
tape is created to be able to restore it. Just type ":undo-tape" or
":ut" to undo (restore) the last tape.

If the in-memory tape to be erased is shorter than the minimum length,
an undo tape is created from it if it is longer than the currently
stored undo tape.

fixed key shortcut to start/end game (broken by regression)

This change fixes a regression of commit 888ee049 (and 35da46e4) that
causes problems when handling text input in situations unrelated to
the Android screen keyboard, like entering key shortcuts to start and
end a game on non-Android platforms.

This commit fixes a bug that results in restarting the game when the
player has died and the "space" key (or other configured key) was used
to return to the main menu (or level editor).

moved code for fixing single-player tapes to separate function

minor improvement of function to check for string suffix

removed duplicate function to check for string suffix

fixed output to logfile for "autofix" command

Thanks to Bela Lubkin for this fix.

added command to automatically test tapes and try to fix if broken

This adds a new command "autofix" that can be used to test and try to
fix existing tapes (by setting a property bit in the tape header).

The only patch currently available is "em_random_bug" that sets the
property bit for using the 64-bit random value workaround in the EM
game engine (see commit 1006b2db for details).

This command is an improved variant for the command "patch tapes"
introduced with commit 7c1d6252.

Thanks to Bela Lubkin for convincing me that this command is in fact a
good idea! :-)

small change of console output when auto-playing tapes