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

fixed inconsistent global animation state after event actions

When executing event actions for global animations, these actions may
cause a screen change, which itself may change the state of global
animations (especially stopping animations that were running on the
previous screen).

When executing event actions directly from the functions that handle
global animations, these functions may continue changing the state of
the global animation that caused the event action, even though this
animation was already stopped due to a screen change, which may cause
this animation to be set back to "active" ("running") state, so that
it continues being displayed on the new screen, even though it was
never defined for it.

This problem was fixed by executing all event actions independently
from the animation handling functions, by inserting new user events
into the program's standard event queue, to handle animation event
actions in a separate, independent step after all animations were
handled.

fixed handling global animation key event actions multiple times

When checking key events for triggering global animations, all keys
that are not handled as "click" events for the "any" animation event
were effectively treated like a "released button" event, which did
not have an effect if no mouse button was pressed at the same time.

However, when clicking on "clickable" global animations (those that
have a "click" animation event defined) with key event actions (that
will cause a simulated key press and release event), any key press
event that is not recognized as a "click" event will again be treated
like a "released button" event, causing the "button is pressed" state
in "HandleGlobalAnimClicks()" to be changed to "not pressed anymore",
so the still pressed mouse button will cause another "press event" in
"HandleGlobalAnimClicks()" right away, which will result in multiple
key events instead of one single key event. This may cause unexpected
and unwanted behaviour when handling global animation events.

This problem is fixed by only handling those key events for global
animations that will be handled as "click" events.

added generic support for handling user events

cleanup of obsolete client message event from SDL 1.2

This event is only used for the "quit" event in SDL 2.0 now.

removed obsolete window events from SDL 1.2

These obsolete window events were used for SDL 1.2 support (which was
removed some time ago) and are not needed anymore. All corresponding
window events are handled by SDL_WINDOWEVENT in SDL 2.0 now.

fixed handling global animation key actions when mouse button is pressed

When handling key actions for global animations (like pressing "Enter"
or "Escape") which are translated into global animation click events,
they were ignored if a "real" mouse button is already held pressed at
the same time. This can especially happen with animation event actions
that simulate key press events when clicking on global animations, so
the key actions were ignored if the mouse button was held down for too
long.

This change forces key actions of global animations to be handled even
if a mouse button was pressed at the same time.

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

The animation's x and y position values are used to set the animation
position relative to the mouse pointer position when using this class.

added fields to graphics info structure to store current mouse position

added global animation event 'unclick:any' to handle mouse release events

fixed wrong position of global animations in 'door_2' in level editor

minor code formatting changes

fixed handling key event actions by global animations in level editor

added some more debug output for triggered global animations

added several new event types that can trigger global animations

This change adds the following new global animations event types,
which can be used like the already existing "click:anim_X.part_Y":

* init:anim_X.part_Y  - triggers when animation is initialized
* start:anim_X.part_Y - triggers when animation is started
* end:anim_X.part_Y   - triggers when animation ends
* post:anim_X.part_Y  - triggers when animation post delay ends

The second part ".part_Y" is optional; if missing, events for every
animation part will trigger the animation for which this event is
defined.

The "init" event will trigger even if the animation is not yet
displayed, but starts waiting for its "init_delay" or "init_event",
while the "start" event will trigger when the first frame of the
animation is displayed.

The "end" event will trigger when the last frame of the animation is
displayed (either because the animation has stopped due to a click
event, due to the "anim_delay" being finished or because the animation
has completely moved off the screen), while the "post" event will
trigger when the "post_delay" is completely finished.

added some debug output for triggered global animations (deactivated)

added support for more event types that can trigger global animations

moved checking if click triggered other animations to separate function

added support for more event types for global animations (yet to be added)

added support for handling multiple event definitions for global animations

cleanup of (boolean) animation event state handling

added support for storing multiple event definitions for global animations

moved functions to parse GIC parameters from 'libgame' to main source tree

fixed a few element token names (previously set to 'char_unused')

fixed editor graphic of element "steel_char_space" (now visually different)

changed some level editor graphic definitions to use in-game graphics

The old definitions still came from a time where downscaled graphics
did not use interpolation and therefore did not look well with those
graphics also used in-game.

fixed creating level sketch images for DF/MM elements and for SQL statements

added cycling through all zoom tilesizes in editor when using touch device

added detecting use of touch device for user input on current platform

fixed graphical bugs caused by commit f77bbb8f and 1b4dc759

Each of these two commits exactly do the reverse of the other commit,
both still resulting in graphical bugs (that the corresponding other
commit fixes).

This change should fix both problems, resulting in (a) playfield not
flashing black when game started from level editor and (b) different
global borders when playing from level editor being correctly drawn.

fixed level editor copy/paste using Ctrl-c/v for custom/group/DF elements

Before, all custom/group elements were mapped to first custom/group
element when copying them to the clipboard (as this was fine for level
sketches, which do not use any custom artwork anyway), but of course
this breaks copying level playfields in the level editor.

This bug was fixed (which will require updating/extending the level
sketch images for the R'n'D web forum).

Besides this, level sketches from level playfields that contain game
elements with a higher element number than 999 are changed to use a
format of always four digits for all game elements (which will also
require updating/extending the level sketch images for the forum).

Last but not least, while level sketches with four-digit element
number were already created, they were not parsed correctly when
reading them back from the clipboard, which was fixed, too.

version number set to 4.1.2.1

fixed level sketch copy/paste via clipboard on Windows (using CR+LF)

Before, level sketch copy/paste using Ctrl-c/v in level editor did not
work on Windows, where lines of text in the clipboard are terminated
with CR+LF (carriage return and line feed) instead of simple newlines.

This fixes this bug, and makes parsing level sketches from clipboard
a little bit more robust regarding empty lines and garbage text.

fixed using (manually changed) invalid values for editor zoom tile size

added more detailed messages for drag-and-drop actions