moved cave arrays and pointers for EM engine to level structure

whitespace changes

added using cave pointers to handle game logic in EM engine

changed order of cave tile changes in EM engine

moved code for explosions in EM engine to separate functions

changed order of switch cases in EM engine source file

moved some switch statements in EM engine to separate functions

moved game logic for EM engine to single source file

changed order of functions in EM engine source file

moved switch statement for handling EM engine tiles to separate function

swapped x and y dimensions in EM engine cave arrays

improved readability of some condition checks in EM engine

improved readability of random number macro in EM engine

fixed some pre-processor defines in EM engine source file

changed order of switch cases in EM engine source file

changed code formatting in EM engine source file

changed order of functions in EM engine source file

moved element handling code for EM engine to separate functions

added "pause" element to game elements in EM engine

changed order of game elements in EM engine (no functional change)

removed options to prevent initial rolling objects in native EM levels

When reading, converting and playing native Emerald Mine levels,
always allow initial rolling objects now. Compile-time switches
to deactivate this behaviour have been removed now. (A special
switch to handle rolling springs when playing has been kept.)

minor code formatting changes

whitespace changes

updated various names of EM engine specific definitions

This is the first part of various code changes of the EM engine to
update the engine code to the 2009 version of the source code.

moved EM engine specific definitions to separate include file

cleanup of unused EM engine source files and declarations

improved readability of tape test summary

fixed potential crash bug if personal user level set cannot be found

renamed duplicate definition of global variable

This would cause a compilation error with GCC 10, where "-fno-common"
is set by default.

removed duplicate definition of global variable

This would cause a compilation error with GCC 10, where "-fno-common"
is set by default.

removed declarations for unused objects

version number set to 4.1.4.2

cleanup of unused MM engine declarations

cleanup of unused SP engine declarations

added workaround for a bug in SDL 2.0.12 which prevents transparency

Unfortunately, the current stable release version 2.0.12 of the SDL
library used by R'n'D has a critical bug that causes all transparent
images in R'n'D to be opaque, which hurts the game graphics at various
places.

The cause of this bug is in SDL_ConvertSurface(), which does not copy
the color key anymore.

The bug is documented in the SDL bug tracking system as follows:
https://bugzilla.libsdl.org/show_bug.cgi?id=2979

The bug will be fixed in the next stable release of the SDL library.

This workaround checks if a converted surface should have a color key,
and explicitly sets it if it is missing in the newly created surface.

version number set to 4.1.4.1

fixed bug in editor with GEs using graphic of other element

This bug appeared when using "use graphic of element" and then
changing some other GE settings (like counters etc.), which caused
the custom graphics to be reset to the GEs default graphics.

This is the same bug as the one fixed in commit 77c74cbf, but for
group elements instead of custom elements.

version number set to 4.1.4.0

changed Android project to API level 23 to support Android 10

Android 10 requires at least API level 23, or a warning is displayed
at the first start of the app.

fixed crash bug in Android project when rotating device

When changing API level from 12 to 17, "screenSize" events must be
handled, or newer Android versions will terminate the app when the
device is rotated.

changed Android project to API level 17 to support Android 9

Android 9 requires at least API level 17, or a warning is displayed
at the first start of the app.

added Android project files

To build Rocks'n'Diamonds for Android, the SDL library source files
and the assets directory must be added to the project.

See file "build-projects/android/README.txt" for details.

fixed bug in editor with CEs using graphic of other element

This bug appeared when using "use graphic of element" and then
changing some other CE settings (like counters etc.), which caused
the custom graphics to be reset to the CEs default graphics.

improved error messages when IMG_Load() fails loading an image

If loading an image using "IMG_Load()" fails, the name of the file is
now also displayed with the error message.

This already worked in the past, but was broken since commit a2698b3b.

added showing overlay touch buttons only if touch screen is really used

added overlay touch buttons for virtual buttons configuration

added overlay touch buttons for in-game "stop" and "pause" buttons

added overlay touch buttons for door request dialog

added code for overlay touch buttons (currently not used)

This adds support for overlay touch buttons to be used with the
Android port, to address the following problems:

* Especially when playing on smartphones, the display may be too small
  to use the most essential buttons, like the "yes" and "no" buttons
  of the door request dialog, or the "stop" and "pause" buttons on the
  game panel.

* Additionally, the most important game panel buttons (again, mainly
  the "stop" and "pause" buttons) may not be accessible at all because
  of being covered by virtual buttons.

* When configuring virtual buttons using recent Android versions,
  navigating to the next page is not possible anymore, because there
  is no "menu" button anymore. This was a hardware button opposite
  to the "back" button, so the "menu" and "back" buttons could be used
  to navigate to the next or previous page when configuring virtual
  buttons.

* When thinking about a potential iOS port of the game, there is not
  even a "back" button (like on Android devices), so it is even more
  difficult to stop playing a game (as the "stop" button has to be
  touched instead of just hitting the "back" button, which simply does
  not exist on iOS devices).

The next steps will be to use overlay touch buttons to solve some or
all of the above problems.

improved highlighting currently configured virtual button

fixed updating multiple pause button gadgets when toggling pause mode

cleaned up configuring virtual buttons

fixed some function declarations

added additional check for handling gadgets from button events

fixed check for virtual buttons when handling gadgets

Before, when handling finger events, a flag was set to indicate if
any virtual button was pressed to prevent handling gadgets at the
same screen position. This check was broken, because button events
(including gadget checks) may be processed before the corresponding
finger events are handled, in which case this flag will be set too
late.

Now, checking if virtual buttons are pressed is done directly before
attempting to handle gadgets at the same screen position, so it does
not make a difference if button events or finger events are handled
first.

moved code to separate function

removed unused code

cleaned up calculating screen positions for menu buttons

added options for player selection button positions in setup menu

added support for gadget buttons defined outside viewports

Commit 50a54138 (and the bugfix in the previous commit) prevent
drawing gadget buttons that are defined outside of viewports (like
playfield or door area), but are placed in the screen border area.

This was not supported in older versions of the redraw system (where
full-screen redraws where always done from a different back buffer).

Recent (SDL2 based) versions of the redraw system do support this, so
this limitation can be removed now to allow for gadget buttons placed
in the screen border area.

fixed redraw bug if gadget buttons are defined outside viewports

This bug was introduced with a fix in commit 50a54138. The problem
with this fix was that it clears REDRAW_ALL from the redraw mask,
which may lead to no redraw at all for this game frame.

This bugfix makes sure that at least the playfield and doors area
will always be redrawn in this case.

added support for undo/redo using Ctrl-z/Ctrl-Shift-z in level editor

fixed crash bug caused by division by zero

This bug will crash the program when loading a graphics set which uses
toon animation step delay values of zero (instead of positive integers
as it should be).

This bug was introduced around version 4.0.0.0 when adding global
animations (treating toon animations as special global animations),
which could result in animation delay values of zero even though
this was checked and corrected when reading the graphics config file.

fixed sporadic problems when playing MP3 files on Windows

This change (hopefully) fixes a problem that may sporadically occur
when playing MP3 files on Windows, in which case audio output is
either completely silent or music is stuttering instead of playing
normally.

The problem seems to be fixed by stopping the music channel before
playing the next track.

fixed mouse x/y position (for pointer class global animations)

This is required in rare cases where the mouse x/y position calculated
from raw values (to apply logical screen size scaling corrections)
does not match the final mouse event x/y position -- this may happen
because the SDL renderer's viewport position is internally represented
as float, but only accessible as integer, which may lead to rounding
errors.

Setting the mouse x/y position for pointer class global animations
from the final mouse event position fixes this problem.

fixed handling global animation click events (again)

Before, only global animations exactly defined for the current game
mode were correctly handled. (Example: ".MAIN")

Now, also global animations defined for several game modes are
correctly handled. (Example: ".MENU")

fixed handling global animation click events (finally)

Also see commit 4be294f9, which did not fix the problem in all cases,
because the next part of a multi-part global animation (activated by
a click event) will not be active before the following game frame, so
a directly following release event would still just be ignored.

Stopping processing of all following events for one game frame after
handling a click event lets the animation successfully change to the
next part, which can then be triggered by the release event.

An example where this might happen is mentioned in the above commit.

re-added variable to check if any global animation was clicked

fixed bug with resetting variable which may already be set

renamed variable (old name did not describe its use anymore)

fixed detecting running animations ('restart' bit may also be set)

fixed initially displaying custom mouse cursor in upper left corner

added new option "create_user_levelset" (setup file only)

Setting this option to "false" (in a global program setup file)
prevents the creation of a new, empty user level set at the first
start of the program.

This option was specifically created for the R'n'D special edition
"R'n'D jue II", which comes with pre-defined user level sets.

version number set to 4.1.3.1

added using new screen fading option ".auto_delay_unit"

added new screen fading option ".auto_delay_unit" (currently not used)

This new option will be used to be able to configure the existing
option ".auto_delay" (the time delay after which a title screen will
be automatically faded to the next screen) to use video frames instead
of milliseconds. This can be useful to synchronize global animations
on title screens with the automatic screen fade delay (which may be
inaccurate if using milliseconds for fading, while global animations
always use video frames for configuring animation delay).

added video frame counter (currently not used)

version number set to 4.1.3.0

fixed handling clickable global animations during request dialog

added handling global animations during delays in Mirror Magic game engine

added handling global animations when showing envelope during tape replay

added handling clickable global animations during request dialog

fixed bug with restarting pointer-style global animations when moving mouse

fixed (reversed) setting hot spot for pointer-style global animations

added not using global animation mouse pointer when reloading artwork

added setting draw order and style for pointer-style global animations

To ensure pointer-like behavior for pointer-style global animations,
set draw order to high value (if draw order has default value) to be
on top of all other animations and set style to pass-through clicks
(if style has default value) to handle mouse clicks under the pointer
animation.

added forcing pointer-style global animations to stay inside window area

added pumping events when waiting for screen redraw

This is required for executing event filter to update mouse position
during actions without event handling (like fading screens).

fixed handling global animation click events

When handling global animation click events, it may happen that more
than one click event occurs within the same game frame (especially
when doing a click by tapping on a touch pad or screen, which may lead
to a "press" and "release" event within the same game frame).

Before, only the first click event was correctly handled (as the event
was not directly handled, but stored and processed later in the screen
redraw phase, when global animations are handled), while all following
events (that occurred within the same game frame) are usually lost if
they should be processed for the next part of the animation (which is
not active before the first event was processed).

Example: Global animation for a button that will be shown as "pressed"
after handling a "click" event and that will be shown as "unpressed"
again after handling a "release" event. If the "click" and "release"
events occur within the same game frame, the global animation still is
in the "unpressed" animation part when the "release" event is handled,
so it will be ignored and the button will stay in the "pressed" state.

To fix this buggy behavior, click (and release) events are now handled
immediately after they occur (instead of processing them in the screen
redraw phase), which results in changing the animation's active part
directly after the event occured, so the next event can be processed
by the next part of the animation.

fixed handling "Escape" key on high score screen

Before, pressing the "Escape" key on the high score screen after
solving a level when using the game setting "auto-play next level"
started playing the next level.

Now, only "positive" input actions (like pressing "Space" or "Enter"
or pressing a joystick button) start playing the next level, while a
"negative" input action like pressing the "Escape" key always returns
to the main menu even with this game setting activated.

fixed function to always return a string copy (and never a string constant)

fixed some memory allocations to prevent valgrind warnings

fixed some memory allocations to prevent valgrind warnings

added function to update the mouse position when changing window size

added SDL event filter to track mouse position from mouse motion events

This (re-)adds a mouse motion event filter to update the current mouse
position for "pointer" class global animations, even if no events were
handled before, which improves smoothness of mouse pointer movement.

improved global animation class "pointer" for animation at mouse position

When using this animation class, the "real" mouse pointer is made
invisible now.

added global animation actions executed after init/anim/post delay

This change adds the following new options for global animations:

* .init_delay_action
* .anim_delay_action
* .post_delay_action

They can be set to the same values as ".init_event_action" and
".anim_event_action" (buttons, gadgets and key actions).

renamed variable

fixed bug with not recognizing ".init_event_action" for global animations

fixed initializing post delay counter when starting global animation