added event actions (by simulating keyboard input) for global animations

This change adds more event actions to the "anim_event_action" option
for clickable global animations, this time adding simulated keyboard
input by specifying a key symbol for the key to be simulated.

For example, you can now use:

global.anim_1.part_1.MAIN.anim_event:            click
global.anim_1.part_1.MAIN.anim_event_action:     XK_Return

When clicking this global animation (on the main menu screen), the
currently selected/highlighted menu item will be chosen/executed.

To get the key symbol/name for the key to be simulated, just choose
the desired key as a keyboard shortcut in the setup menu (temporarily
only) and look at the resulting entry in the file "setup.conf" in the
game's configuration and personal data directory.

fixed compiler warning due to missing function declaration

added being able to generally set global animations to passthrough clicks

Before, the "passthrough_clicks" option was limited to allow mouse
clicks on global animations to be passed through to the mouse sensitive
screen controls, but not to other global animations.

Now, stacked global animations can all receive mouse clicks if those
global animations overlapping them are set to "passthrough_clicks".

added "multiple_actions" option for clickable global animations

This change adds a new option for the "graphicsinfo.conf" file to be
able to explicitly allow multiple event actions for clickable global
animations, which is deactivated by default to prevent unwanted side
effects. This would make it possible to trigger two actions that make
sense when executed at the same time, like triggering the "play" and
"pause" buttons of the tape recorder together, for example.)

The new option works like this (with "global.anim_1.part_1.MAIN" also
being defined):

global.anim_2.part_1.MAIN.anim_event:            click:anim_1.part_1
global.anim_2.part_1.MAIN.anim_event_action:     some.action
global.anim_2.part_1.MAIN.style:                 multiple_actions

global.anim_3.part_1.MAIN.anim_event:            click:anim_1.part_1
global.anim_3.part_1.MAIN.anim_event_action:     another.action

When clicking the first global animation (on the main menu screen),
there might be two or more other global animation which are triggered
by clicking the first animation and which each execute their own event
action when triggered. (The style "multiple_actions" must be defined
for all animations that should *not* stop the chain of event actions
to be executed, so it's easiest to just define it for all animations
that should execute their event actions together when triggered.)

This option can be combined with "passthrough_clicks".

added ignoring gadgets if click already caused animation event action

Before, even though executing more than one event action triggered by
clickable global animations was already prevented, further processing
of mouse clicks by gadgets at the same position was still performed if
the global animation style was set to "passthrough_clicks", which could
lead to more than one gadgets being triggered at the same time by a
single click on a clickable global animation, with potentially unwanted
side effects.

Now, mouse clicks that already triggered an event action (which could
be a gadget) are not processed by the standard gadget handling anymore.

fixed order of handling mouse clicks on gadgets and on global animations

Before, gadgets were checked for clicks before global animations, which
caused clickable global animations to not be clicked if a gadget at the
same position was successfully clicked (because mouse events are forced
to be off-screen afterwards).

Now, clickable global animations are checked for mouse clicks before
gadgets, and they either consume the mouse click (so a gadget at the
same position will not receive the mouse click anymore), or they are
set to "passthrough_clicks" style (so a gadget at the same position
will still receive the mouse click).

fixed potential bug with default step size when increasing/decreasing level

added event actions (active screen elements) for global animations

This change adds more event actions to the "anim_event_action" option
for clickable global animations, this time adding active screen elements
(currently limited to a selection of screen elements in the main menu).

For example, you can now use:

global.anim_1.part_1.MAIN.anim_event:            click
global.anim_1.part_1.MAIN.anim_event_action:     menu.button_game

When clicking this global animation (on the main menu screen), the
game will be started (by triggering the "start game" menu button).

To dump a list of all available event actions for global animations,
blindly type the "cheat mode" style shortcut ":dump-event-actions" or
":dea" in the main menu.

fixed handling passthrough option for clickable global animations

fixed ignoring clicks on global animations after executing event actions

improved function to dump identifiers for all gadgets on current screen

added "passthrough" option for clickable global animations

This change adds a new option for the "graphicsinfo.conf" file for
defining a "passthrough" option for global animations that causes
clicks on clickable global animations not to be consumed, but to
be passed-through to the underlying screen controls (or other global
animations under the clicked global animation). The new option works
like this:

global.anim_1.part_1.MAIN.anim_event:            click
global.anim_1.part_1.MAIN.style:                 passthrough_clicks

The second option is the new one (the first one already existed).
When clicking this global animation (on the main menu screen), the
click will passed-through to the main menu screen to be further
processed by screen controls like gadgets or menu buttons.

added event actions (by triggering gadgets) for global animations

This change adds a new option for the "graphicsinfo.conf" file for
defining clickable global animations that trigger other actions
(currently limited to triggering active gadget buttons on the same
screen as the global animations). The new option works like this:

global.anim_1.part_1.MAIN.anim_event:            click
global.anim_1.part_1.MAIN.anim_event_action:     tape.button.record

The second option is the new one (the first one already existed).
When clicking this global animation (on the main menu screen), the
game will be started (by triggering the "record" button on the tape
recorder, which effectively starts playing the current level).

added key shortcut to dump identifiers for all gadgets on current screen

fixed state of inactive parts of global animations

code cleanup

added event action parameter for global animations (no functionality yet)

added storing image identifier in internal gadget structure

fixed not updating audio buttons if shown on tape and changed in setup menu

removed SDL 2.0 key symbols (using preprocessor) when compiling for SDL 1.2

fixed bug causing crash when trying to draw undefined optional graphics

Before, the program crashed (segmentation fault) if optional graphics
(like "menu.button_level_number", which are defined to be off-screen
by default) are defined to a valid screen position (by setting the
corresponding screen position values like "main.button.level_number.x/y"
to positions on the screen), but no image was defined to be used for
that graphic.

This bug was fixed by using fallback graphics when attempting to draw
those undefined optional graphics.

improved code to handle special game controller buttons

fixed bug with wrong order of checking global animations for click events

added (optional) menu buttons to select level number and first/last level

added (optional) tape buttons to insert or play solution tape

added option to draw pressed virtual buttons highlighted

added option to draw virtual buttons outlined

code cleanup

fixed small bug in preprocessor macro

added updating virtual buttons setup screen depending on screen orientation

added configurability of grid size for virtual buttons

fixed default values for move/drop distances for wipe gestures

added configurability of transparency for virtual buttons

fixed bug with not updating screen during request door post delay

removed explicit check for Android for displaying virtual buttons

added loading/saving virtual button configuration from/to setup file

moved virtual buttons definitions to setup data structures

added empty borders between different virtual buttons

added using configurable virtual buttons while playing

Note: Virtual buttons can be configured (for both screen orientations)
and are also used when playing the game now, but are not saved yet.

added support for updating grid buttons after the screen was rotated

added separate grid buttons for landscape and portrait screen orientation

Separate grid buttons can be configured for landscape and portrait screen
orientation. The correct grid buttons are currently only selected at the
start of the program, but not after the screen was rotated.

added grid buttons to virtual buttons setup screen

This change defines a grid of virtual buttons that can be configured on
the virtual buttons setup screen for all four directions and two buttons
(but is not used or shown anywhere else yet).

fixed event handling on (not yet functional) virtual buttons setup screen

added grid to (not yet functional) setup screen to configure virtual buttons

added (not yet functional) setup screen to configure virtual buttons

added correcting positions for envelope request buttons, if needed

removed support for off-screen positions for request dialog buttons

fixed network games, part 4: added debug output for player mapping

fixed network games, part 3: enabled mapping input to reassigned players

Before this change, player input from connected network players was
only allowed for active players. However, the old code did not take
into account that players may have been reassigned to other players
in the level playfield, so their input actions have to be mapped to
that different player.

This change accepts input actions for all players, and later maps
them to the finally assigned player in the game.

fixed network games, part 2: set player focus after setting local player

There was also a bug with setting the focussed player to the local
player where the local player potentially changed afterwards (if the
player for network games was assigned to any player in the playfield
different from the player that was selected for network games by the
user on program start).

To fix this, the code to set the focussed player for network games was
moved to a point after setting the local player.

fixed network games, part 1: separate locally and network connected players

Network games were largely broken since (at least) version 3.2.4
(although they still worked for the most common cases, but only for the
first game after starting the program). They will be fixed in several
separate steps.

This first part separates storing if a team-mode player was connected
locally or over the network (and then sets the previously used general
flag if a certain player is "connected" or not, regardless of being
connected locally or remotely).

fixed potential bug with alpha blending when using virtual buttons

fixed bug with alpha blending when configuring game controllers

fixed bug causing access to negative array index

fixed variable type

added hiding selection list style setup options marked with '.hide'

added recognizing "y/Y" and "n/N" keys to answer request dialog

changed variable name

added adjusting input setup menu according to configured screen size

added using narrow fonts for input setup if screen width is less than default

added font definition for narrow variant of existing font

added using variable for screen positions in input setup menu

added using some variables for font identifiers instead of constants

fixed centered screen position for keyboard/joystick configuration

fixed changing key bindings if customization aborted by "Escape" key

Before, partially changed key bindings were kept even if keyboard
customization was aborted by pressing the "Escape" key during the
process. Now, the old key bindings are restored in this case.

changed keyboard customization to be similar to joystick configuration

Before, the user was asked to press the "Return" key after keyboard
customization was finished. Now, keyboard customization automatically
ends after configuring the last key, and a message is displayed that
is similar to the message displayed after joystick configuration.

changed starting music for MM game engine after charging laser

Before, music was started immediately after opening the game panel
door, and therefore before starting the initial "rotating mirrors
and charging laser" sequence when playing levels using the Mirror
Magic game engine.

Now, music starts after that initialization sequence is finished
(just like it was done in Mirror Magic 2.0.2).

added saving static variables to engine snapshots for SP game engine

There were a number of static variables holding game engine values
that were forgotten to be saved in game engine snapshots for the
Supaplex game engine.

Storing and restoring these engine values was added by this fix.

added check to prevent crash when drawing sprites for undefined graphics

Due to a bug (that will be fixed with the following commit) it may
be possible that game elements are drawn for undefined graphics ID,
resulting in a crash.

A check was added to prevent drawing sprites for undefined graphics.

changed internal program versioning naming conventions

Before, program version numbers consisting of four parts were named
"MAJOR.MINOR.PATCH.BUILD" internally. From now on, this will be named
"SUPER.MAJOR.MINOR.PATCH" instead, because this better reflects how
the four parts of the version numbers are really used nowadays.

For the Mirror Magic game engine, "MAJOR.MINOR.PATCH" is still used
internally, as there is no fourth part for the version number, so the
names of these version number parts currently do not match the parts of
the internal R'n'D version numbers with the same name, but parts 1, 2
and 3 (which would be "SUPER.MAJOR.MINOR" in R'n'D version numbers).

version number set to 4.1.0.1

fixed tile selection cursor position for levels smaller than the playfield

For centered levels that are smaller than the playfield (MM engine),
the tile selection cursor position was not shifted like the level,
but was still inside the top/left aligned grid as if the level was
not centered.

This fix also centers the tile selection cursor position accordingly.

fixed always redrawing global border when redrawing playfield area

When in the level editor, the "special editor door" area was not redrawn
correctly when redrawing the global border, but was instead always
redrawn with the "normal" border (without special treatment for the
larger editor door area).

This workaround fixes redrawing the global border inside the level editor.

version number set to 4.1.0.0

added always redrawing global border when redrawing playfield area

Before, the global border was only redrawn if its graphics had changed
or if any of the viewport areas (playfield or doors) had changed their
position or size.

Now, it is always redrawn if the playfield area is cleared (to redraw
its content). This has the advantage that accidentally damaged global
border areas (caused by buggy graphics definitions from custom artwork
sets) are redrawn much earlier than before (where it could require
loading a different level set with different graphics to "repair" the
damaged global border).

added support for non-button touch pads for MM game engine

There are some systems with touch pads (like Mac notebooks) which do not
have separate left/right buttons, which are required for controlling the
Mirror Magic game engine (which usually works best with left/right mouse
buttons).

This change adds support for recognizing touch clicks on the left and
right half of the touch pad as left and right button clicks to rotate
mirrors and other rotatable game elements in the MM game engine to the
left or to the right.

added support for compiling non-default Windows icons into the executable

If the environment variable "EDITION" is defined, it is used to search at
a non-default location for icons to be compiled into the R'n'D executable
when building the game for the Windows platform.

fixed some level editor element descriptions

added using options for left/right/top/bottom spacing on some info screens

added options for left/right/top/bottom spacing for the info screens

replaced some info screen positions with already defined symbolic names

fixed bug when creating static mappings of elements to graphics

This bug showed up with wrong mapping for "mm_pacman.eating.right" (as
defined in "src/conf_gfx.c") in auto-conf file "src/conf_e2g.c" being

  {
    EL_MM_PACMAN,                       ACTION_EATING, -1, FALSE,
    IMG_MM_PACMAN_EATING_RIGHT
  },

where it should correctly be

  {
    EL_MM_PACMAN,                       ACTION_EATING, MV_BIT_RIGHT, FALSE,
    IMG_MM_PACMAN_EATING_RIGHT
  },

instead. This problem was fixed by always using the calculated direction
(which can still be "-1" if no direction is specified).

added centering levels that are smaller than the playfield (MM engine)

fixed incorrect sizes of some arrays in menu info structure

fixed compiling MM engine code with MinGW environment

fixed name of element 'beamer' to 'teleporter'

fixed name of element 'polarisator' to 'polarizer'

fixed bug with deriving game data directory from default 'setup.conf'

removed shortly visible video display when starting game from level editor

removed short black screen when starting test game from level editor

added message 'level solved' after solving a level

replaced duplicated code with equivalent function call

added asking for restart after game was lost (MM game engine only)

fixed displaying title strings from config files in info screen headline

moved getting title strings from config files to separate functions

fixed bug with always drawing level playfield in editor after test playing

- even if the last edit mode was "level info", "element properties" etc.
- this bug was introduced by the commit with the following message:
  "added editor door 1 animation if viewport is unchanged and contains toolbox"
  (no commit ID given here due to frequent use of "git rebase")

fixed saving snapshots (step, move and collect mode) to MM game engine

fixed bug in (still largely broken) single-step mode when using joystick

added single-step mode (well, sort of) to MM game engine

fixed updating tile selection cursor position when using mouse in MM games