removed test/debug code for EM graphics engine

This commit removes the testing and debugging capabilities for the
native Emerald Mine graphics engine (that can, but does not have to
be used with the native Emerald Mine game engine). The main purpose
of this test code was to check if the R'n'D "graphicsinfo.conf" style
graphics definitions, when used with the native Emerald Mine engine,
map exactly to this engine's hard-coded graphics definitions, to be
able to flexibly use R'n'D style graphics definitions also for the
native Emerald Mine game engine.

To test a given "graphicsinfo.conf" file against the internal graphics
definitions of the native Emerald Mine engine, its definitions have to
match an "objects" and "players" graphics file which is hard-coded in
the R'n'D graphics configuration file "conf_gfx.c" using the tokens
"emc_object" and "emc_sprite". (To prevent the game from using them in
non-debugging context, it normally refers to existing default artwork
instead of the test graphics files mentioned above.)

When testing or debugging, set these file names to "emc_objects.png"
and "emc_players.png" and enable upscaling to double size (assuming
the tiles in the test artwork have their original 16x16 pixel size).
Also set "DEBUG_EM_GFX" to "TRUE" in "src/tools.c". Then recompile.

When starting, the program performs the test, outputs all graphics
definitions that differ from the hard-coded internal definitions and
exits. To perform the test against the correct artwork, select the
artwork to test against before running the test. Usually the test is
executed using the graphics set "gfx_classic_emc.aga" from the Emerald
Mine Club level package, which uses the original artwork that is also
used by the game "Emerald Mine for X11".

(To perform the test described above, use a version of the code prior
to this commit.)

changed some EM engine game element names

removed pre-processor directive for newly added EM engine elements

fixed handling of fake acid for EM engine

added fast player relocation for level wrap-around in EM engine

changed function from public to static

removed unused function

removed needless delay when relocating the player

added support for EM wrap-around levels also to level editor

Previously, when running a level created with the R'n'D level editor
that uses the EM game engine, that level was forced to have a border
of indestructible game elements, which made it impossible to create
wrap-around levels to be played with the EM engine. This limitation
was removed, so no additional steel wall will ever be added around a
level.

added support for wrap-around levels in EM engine

added limiting amoeba handling in EM engine to the playfield area

This does not make a difference now, but will do when support for
wrap-around levels is added (which will result in accessing tiles
of the regular playfield via linked playfield buffer columns that
will redirect off-playfield access to the opposite side of the
playfield).

fixed using cave buffer offsets in EM engine graphics

added using cave buffer offsets in EM level conversion and game logic

added cave buffer offsets to level structure in EM engine

split function

increased cave buffer offset (and adjusted graphics and amoeba logic)

changed storing native EM cave without internal border elements

The internal representaion of a native Emerald Mine cave (level) does
not contain surrounding internal game engine elements anymore now
(which are only needed for game engine logic when playing the level).

The stored player positions were adjusted accordingly.

added separate playfield and buffer sizes for EM engine caves

The cave playfield size (or just cave size) is the size of the visible
playfield (potentially containing an additional steelwall border, if
the level was converted from R'n'D format and does not contain a
steelwall border).

The cave buffer size is the size of the internal cave buffer (which
also contains surrounding internal game engine elements) that is used
by the EM game engine logic.

Currently the native cave structure has the same size as the internal
cave buffer; this should be changed.

cleanup of EM engine cave size definition names

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