added options "game.forced_scroll_x" and "game.forced_scroll_y"

This adds the above two "graphicsinfo.conf" options to override the
automatically calculated playfield scroll values when starting a game.

The purpose of these options is to force an initial scroll position
(which is used for all levels), which means that the visible part of
the playfield when the game is started is not determined by the player
position, but by the values defined using the above options.

This may be useful in combination with a large value for the option
"game.forced_scroll_delay_value" to limit the visible part of the
playfield to a smaller, screen-sized area, while the remaining part of
the playfield contains some control elements. It may also be useful
for levels using teleportation from one area to another area while
still controlling which parts of the playfield entered by the player
are visible. It can also be used to force a certain initial visible
part of the playfield, regardless of the exact position of the player
within that area. And it is currently the only way to force showing
levels with an even width or even height with the player near the
border of the playfield with half-tile border elements, which would
also be needed for teleporting the player to a different part of the
playfield without scrolling the playfield relative to the player's
screen position.

Therefore, this feature should probably be considered experimental.

fixed bug with limiting forced scroll delay value to lower default value

fixed broken player option "no centering when relocating"

fixed bug with global animation at top left playfield corner for one frame

moved code to set global animation to CE position to separate function

fixed bug with CE replacing exploding player, causing half-dead player

This bug could happen when a player was just exploding (for whatever
reason) and an adjacent CE replaced the explosion's center element
with something else, leading to the player not being totally removed,
potentially causing some strange effects afterwards.

This change adds some cleanup required to prevent such cases.

fixed bug with causing explosion instead of killing player directly

While the final effect is the same (player is killed), the player was
killed by an explosion before (causing a "double explosion" when the
player itself exploded when being killed by the explosion), while the
player is killed directly now, preventing the double explosion.

fixed bug with CE change setting the player to its current position

This change fixes a bug where a CE change places the player at the
current player position, causing an explosion at that playfield
position, which should not happen.

In other words, such an event would normally relocate the player, but
to a playfield position which is identical to the current playfield
position of the player, which should therefore have no effect at all.

The bug occured because it was not checked if the new element to be
created is the player itself, but only checks if an element that is
not walkable by the player is created at the players current position.

added selecting element for group elements according to current level

This change works similar to the previous commit, but not selecting an
animation frame according to the current level, but selecting a game
element from a number of elements in a group element (selecting the
first element for the first level, the second element for the second
level, and so on, again overwrapping if there are more levels than
game elements defined for the group element). That way, different game
elements can be used in different levels which all use the same group
elements.

added new animation mode "level_nr" to select frame according to level

This change adds a new animation mode "level_nr" which selects a
single animation frame from a number of frames that corresponds to the
current level. That is, the first frame is used for the first level,
the second frame is used for the second level and so on (overwrapping
frames if there are more levels than animation frames). This animation
mode can therefore only be used for non-animated game graphics, like
walls. So this animation mode can be used to have different graphics
in different levels for certain game elements, while still using the
same game elements in each level.

fixed bug with CE triggered global animations treated as "off-screen"

added pausing global animations on playfield if game engine is paused

fixed drawing envelope request to be always on top of global animations

fixed drawing envelope request to be always on top of tile cursor

moved code to draw envelope request over global animations

fixed bug with shifted global playfield animations during envelope requests

fixed CE condition that checks touching the player at some side

In the level editor on the "change" tab of a custom element, when
using the CE condition "[x] element changes ..." in combination with
"[x][touching] element [<element>]" with "at [<side>] side", there
was wrong behaviour in some cases when "<element>" was the player.

This was caused by not checking the side of the player (that was being
touched by the custom element), but by checking the side of the custom
element (touching the player), which is the exact opposite side here.

This change fixes the bug, now always checking the correct side as it
is configured in the level editor. (Regarding to the game engine test
suite, this functional game engine change did not break any tapes.)

fixed calculating position of global animations triggered by CE change

fixed bug with forced restart of global animations when restarting game

This fixes a bug which occured if the game was restarted (by loading a
tape during the game, or by playing again after a game was lost) and
if a custom artwork set was active that used cross-fading for the game
screen. In this case, global animations displayed during the game were
stopped, but not restarted again,

improved forced restart of global animations when restarting game

When forcing a restart of global animations when restarting the game,
a full screen redraw is neither required nor desired. Therefore, this
change only restarts global animations according to the game status
passed to function "RestartGlobalAnimsByStatus()", but does not redraw
the screen (including global animations, so nothing is drawn at all).

removed redundant code

fixed one-frame delay when global animations leave "init" state

This fixes a bug for global animations which either have an initial
delay or an initial event defined, causing a delay of one screen frame
after the initial waiting state has ended and before the running state
(which displays the global animation) is started.

This can especially be visible if a changing CE is graphically replaced
with a global animation triggered by the CE change.

changed global animations to handle only one CE change event per frame

Before, several (same) CEs could change within the same game frame,
triggering the same global animation several times (each time with the
new/next CE, with different CE position for each change. for example).

This bugfix results in each global animation being triggered exactly
one time for each change of the same CE in the same frame (which is
especially important if there are several global animations being
triggered by the change of the same CE, to display several animations
for several same CEs changing in the same game frame).

added option to not trigger further animations if CE change event consumed

This adds the parameter "consume_ce_event" to the ".style" option of
global animations to prevent any further global animation to be
triggered by "ce_change" events (".init_event" or ".anim_event") if
the event was already recognized by any other global animation (which
therefore "consumes" this event).

Using this option, several similar global animations can be defined
that are triggered one after another by several custom element changes
to make it possible to show several similar global animations for
multiple CE changes at the same time.

added setting scroll offset to global animation position triggered by CE

fixed bug when handling init and anim events for global animations

Before, defining ".init_event" as "click:anim_X" and ".anim_event" as
"click" resulted in the global animation being started by clicking
global animation "anim_X" (which is correct), but resulted in stopping
it by clicking the animation itself (which is correct), but also by
clicking global animation "anim_X" (which is not correct).

fixed bugs when parsing global animation parameter values

The previous code recognized the value "click" in the parameter string
"click,click:anim_X", but did not in string "click:anim_X,click".

added setting global animation position from CE triggering that animation

fixed setting global animation sync frame when started with ".init_event"

The previous code only handled adjusting the initial animation sync
frame when starting the animation using an "init delay" configuration
(starting the animation after a delay), but did not handle starting
the animation using an "init event" configuration (like triggering by
a click event or by a custom element change), in which case the sync
frame should also be reset.

added support for CE change pages triggering global animations

This commit extends the previous commit to not only be able to trigger
global animations using "ce_change:custom_X" (by any CE change page),
but also by specifying change page using "ce_change:custom_X.page_Y".

added support for custom elements triggering global animations

For the global animation options ".init_event" or "anim_event" in file
"graphicsinfo.conf", the new value "ce_change:custom_xxx" can be used
to trigger (initiate or continue) the corresponding global animation
whenever custom element "custom_xxx" changes.

fixed bug with re-initialized variables when reading multiple config files

added wrapper functions to initialize and set variables

moved code to check redefined screen positions to separate function

fixed stopping music if global anim music differs from current music

As there is only one single music channel, the following edge case
could happen before this commit: The current screen plays music from
a global animation, while the next screen plays background music as
defined for this screen (as it might happen with two title screens).
When going from one screen to the other screen, the global animation
music from the first screen is stopped and the background music for
the second screen is started.

If there is a delay between both screens (typically by fading from one
screen to the next one), the first music is stopped and the second
music is started shortly after. Everything works as expected.

However, if there is no delay between both screens (if fading is
disabled by setup menu or by graphics configuration), stopping and
starting old and new music happens in the same screen frame. But as
global animations (including music) are applied *after* the screen is
prepared (also including music), the music for the new screen is
started and immediately stopped again by the global animation code,
which notices the screen change and stops the global animation for the
previous screen (including stopping music for it).

This is fixed now by only stoping the global animation's music if it
is still the same as the currently playing music (which would not be
the case in the edge case described above).

fixed playfield redraw bug when closing envelope after asking to play again

This reverts commit 3df902ff.

For currently unknown reason, the above commit does not fix the
described bug, but introduces it. As long as this is not sorted out,
the commit will be reverted.

fixed bug with checking for mouse events used by custom elements

fixed using full image size for initial images if not specified

moved code for getting size of initial images to corresponding function

moved code to handle mouse actions to separate function

fixed sending key release events to animation event handling

fixed sending button press/release events to animation event handling

added variables to prevent repeating expression

changed global animation events to use more practical bit range

reordered some preprocessor definitions

fixed broken animation of CE that can not change, but has CE delay action

This fixes a bug that occurred if a custom element with an animation
has a CE action defined to be triggered after a delay, but without a
CE change, in which cause there was no animation displayed at all.

fixed bugs when using music sets without unconfigured game music

Without this fix, playing a level set with an "empty" music set (that
has no in-game music, like it is the case for all Emerald Mine Club
level sets, for example) caused the game to fall back to the classic
(default) game music set, even though using an "empty" music set was
by intention in such cases.

fixed crash bug on info screen if music set has no unconfigured music

fixed drawing (maybe redefined) empty space around MM style level in editor

added options "played_header" and "played" to music file info

If option "played" is specified in the music file info, it overrides
a potentially detected level number to be displayed for this option.

The option "played_header" can be used to replace the text "played in"
with a different header text.

added highlighting single MM wall tiles in editor when pressing Alt key

added highlighting similar elements in editor when pressing Alt+Shift keys

version number set to 4.3.7.0

version number set to 4.3.6.0

fixed bug with triggering "entered by player" event when pushing element

added following diagonal side of a slope corner for MM engine

moved variables to higher position in scope

fixed bug with wrong laser position for slope element check in MM engine

fixed bug with wrong check offset for slope elements in MM engine

moved checking element mask to separate function in MM engine

fixed bugs with wrong X/Y access in element mask in MM engine

moved code for handling wall side of slope for MM engine

improved reflecting laser by slope in corners in MM engine

fixed small graphical bug with laser overloaded by slope in MM engine

fixed hitting some edge on the way to opposing diagonal side of slope

fixed advancing laser position on slopes from non-center position

fixed bug when checking if end of slope is blocked by other element

moved code to count bits to separate function

added stopping game startup actions on Escape key when using MM engine

fixed debug code for fast game startup when using MM engine

added new steel slope game element for MM game engine

fixed bug with macro for laser angle for MM engine

fixed getting level position after laser hits something in MM engine

improved flipping and rotating tiles in brushes in level editor

added flipping and rotating tiles in brushes in level editor

fixed drawing mouse pointer global animation above MM engine tile cursor

fixed preprocessor macros to detect MM and DF game elements

added flipping and rotating brushes in level editor

fixed centering text from files (like credits) using different font width

added functions to get level position from laser position for MM engine

fixed editor element descriptions for fixed mirror elements of MM engine

added description for Deflektor style fixed mirror game elements

This should have been part of commit 7b347435.

fixed showing level music file info in correct level order

added reading unconfigured music files from already existing list

Before, the list of unconfigured music files was read from the music
directory (in function "LoadMusicInfo()" in "src/files.c") instead
of using the already existing list from the sound sub-system (read
exactly the same way in function "LoadCustomMusic_NoConf()" in
"src/libgame/sound.c"). Now, the code just uses this existing list.

added playing the first unconfigured music file in the first level

Before, the (unconfigured) music file to be played in the first level
of a level set depended on the number of the first level (with the
result that the first music file was played in level 000, the second
music file was played in level 001 and so on, which probably was not
the intended behaviour when the level set started with level 001).

Now the first music file in the list of unconfigured music files is
played in the first level of a level set, regardless of the number of
that level (which is either 000 or 001 for most level sets).

added sorting unconfigured music files by filename

Before, unconfigured music files were played in the order they were
stored in the file system (that is, in unpredictable order). This
change adds sorting them by filename.

added showing configured level on music info screen

fixed bug with checking music only for current instead of all levels

added Deflektor style fixed mirror game elements to MM engine

improved scanning laser outside level, but inside visible playfield area

This change adds checking that not only the current, but also the next
step of the laser beam is still inside the visible playfield area.

This is a correction of commit dea6197b.

fixed regression bug with bad playfield offset

This reverts commit a35cd127.

The bug introduced by the above commit was caused by a wrong comment
indicating that a certain offset was related to the playfield border,
which was wrong. In fact, this offset is related to the width of the
laser beam (to store the middle position of the tile the laser beam
touches, to be able to draw a variable-width laser beam later with a
size that is relative to the middle of the tile).

As the laser beam currently has a width of 4 pixels, this value has
to be set to 2 here.

added supporting reference elements for custom element explosion content

fixed bug with using already assigned byte position when saving level

fixed bug with laser passing between two diagonally placed DF polarizers

This reverts commit f00dbcf8.

The behaviour "fixed" in the above commit as being a bug is in fact
the correct and intended behaviour, as Deflektor style polarizors are
to be treated as solid, tile-filling blocks, not as tiles with a
little bit free space around them, as suggested by the graphics (and
as it is the case with the Mirror Magic variant of these tiles).

fixed scanning laser outside level, but inside visible playfield area

replaced variables

removed hardcoding playfield viewport border

removed variables

removed hardcoding playfield viewport border

fixed bug with laser not passing between two diagonally placed DF polarizers