changed drawing to playfield when changing network mode setup options

reduced time to wait for UDP broadcast answer to auto-detect network server

improved connecting to local network server

added disconnecting from network server from setup menu

added connecting to network server from setup menu without program restart

added displaying screen messages when connecting to network server

added setting network connection flag for network games

improved handling network errors (show message instead of stopping program)

added setup option to skip displaying the high scores after solving a level

added setup option to directly play the next level after solving a level

Before, the program returned to the main menu after the player solved
a level (and the high score table was displayed). From there, the next
level could be played by starting the game with the incremented level.

Now, the program automatically starts playing the next level after the
previous level was successfully solved.

This new setup option is enabled by default now, changing the previous
default behaviour of the program.

removed duplicate code

added explicit level number parameter to high-score handling functions

deactivated some debug messages

replaced constants using #define with enum values

moved debug output for player status to separate function

fixed showing message request if local player stopped network game (finally)

With the previous fix (see commit with same commit message) for this
problem, the message request was still shown if the local player was
remapped to a different player in the actual level.

fixed selecting correct player in single player mode (after network gaming)

When playing levels that contain more than one player in single player
mode, selecting the actual player when starting the level worked
correctly before only if the game was always played in single player
mode since it was started. It did not work correctly in the following
special case: There was a network multi-player game played before, but
the other (remote) client has disconnected (quit the game), leaving the
other client with a local player that might not be the first player.

In this case, using the first active player (which could be the first
player in the level) for the local player (which could be the second
player, because the network client was started after the now
disconnected client) would result in a broken player mapping, so the
player in the game cannot be moved.

This bugfix solves the problem by not using the first active player,
but the local player.

improved handling network errors (show message instead of stopping program)

removed preprocessor definition for network mode that is always true now

added separate network info structure for network options and setup values

added support for cursor keys and joystick to network player request dialog

re-arranged buttons to select network player in request dialog

added support for keys 1 to 4 to select network player in request dialog

fixed showing message request if local player stopped network game

fixed re-opening request door after stopping network game

moved setting preferred network player from game start to setup menu

When running the game in network game mode (via setup menu option or
command line option), do not ask for the preferred network player on
each start of the game, but use the player that can be configured in
the setup menu now.

added setup option to enable network multi-player games

This is a work-in-progress change: The new setup option to enable
network mode just sets the same flag as using the command-line option
"--network" (without specifying a hostname or a port).

For local network games, and if UDP broadcasting works as it should
to auto-detect a local network server that is already running, this is
already sufficient to play network multi-player games.

What's still missing is a way to explicitly specify a network server
to also be able to play network games with hosts outside of the local
network (or if UDP broadcasting does not work correctly).

added UDP broadcast to auto-detect network server in local network

added some missing error handling and more detailed error messages

code cleanup (handling of network socket activity)

added handling SIGINT (Ctrl-C) to exit standalone network server

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

There is a difference to the already existing tape buttons to insert
or play a solution tape in that the main menu buttons are only drawn
if the current level really has a solution tape, while the tape buttons
are always drawn, regardless if the level has a solution tape or not.

added the "return" and "escape" key to be simulated by global animations

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).