fixed key shortcut to start/end game (broken by regression)

This change fixes a regression of commit 888ee049 (and 35da46e4) that
causes problems when handling text input in situations unrelated to
the Android screen keyboard, like entering key shortcuts to start and
end a game on non-Android platforms.

This commit fixes a bug that results in restarting the game when the
player has died and the "space" key (or other configured key) was used
to return to the main menu (or level editor).

moved code for fixing single-player tapes to separate function

minor improvement of function to check for string suffix

removed duplicate function to check for string suffix

fixed output to logfile for "autofix" command

Thanks to Bela Lubkin for this fix.

added command to automatically test tapes and try to fix if broken

This adds a new command "autofix" that can be used to test and try to
fix existing tapes (by setting a property bit in the tape header).

The only patch currently available is "em_random_bug" that sets the
property bit for using the 64-bit random value workaround in the EM
game engine (see commit 1006b2db for details).

This command is an improved variant for the command "patch tapes"
introduced with commit 7c1d6252.

Thanks to Bela Lubkin for convincing me that this command is in fact a
good idea! :-)

small change of console output when auto-playing tapes

renamed function

renamed playfield variable

renamed some functions

added command to automatically patch tapes for the "EM random bug"

This adds a command line option that can be used to patch existing
tapes (by setting or unsetting property bits in the tape header).

The only patch mode currently available is "em_random_bug" that sets
the property bit for using the 64-bit random value workaround in the
EM game engine (see commit 1006b2db for details).

When using "help" for "MODE", all available patch modes will be shown.

split function to save tape

added handling 64-bit random value bug with old tapes in EM engine

See commits 61c3da0 (incomplete fix) and c92edfe9 (final fix) for
details about this problem that was introduced (by a partial fix) in
version 3.3.1.0 and finally fixed in version 4.0.1.2, which resulted
in many tapes recorded between these versions with the EM game engine
to be broken.

To fix these broken tapes, it is required to set a new property bit in
all existing tape files that are affected by this bug.

The functionality to automatically patch these tapes will be added as
a new command line option.

added support for tape property bits (not used yet)

version number set to 4.2.0.3

updated installation instructions

fixed version number references for changes since version 4.2.0.0

Fixed some version number references to version 4.1.4.2 that was never
released as packages, but only via Git repository and that was nearly
identical to version 4.1.4.1. Especially it contained the same version
of the Emerald Mine game engine as version 4.1.4.1, so tapes recorded
with version 4.1.4.2 must be played with the old EM engine.

Starting with version 4.2.0.0, the new EM engine will be used.

added check if setting vsync mode to selected value was successful

changed function logic for changing fullscreen/scaling/vsync to match

split function to toggle fullscreen and change window scaling

fixed setting setup value and list selection for vsync mode

improved function to toggle fullscreen or change window scaling

added re-creating renderer and textures when changing video vsync mode

When not using OpenGL renderer, changing video vsync mode requires
re-creating renderer and textures with changed vsync settings.

(This uses code for re-creating the screen that was a part of function
"ToggleFullscreenOrChangeWindowScalingIfNeeded()", but that was never
used after support for SDL 1.2 was removed with commit d3e24bbf.)

added check for OpenGL renderer when trying to change vsync mode

added macros for converting vsync mode string and integer values

added setting video vsync mode when creating renderer

Changing the vsync mode after creating the renderer only works for the
OpenGL renderer. For all other renderers, it must be set when creating
the renderer.

This means that changes to the vsync mode settings in the setup menu
currently only take effect after restarting the program.

added storing current video vsync mode after setting it

added option for setting hint for render driver to setup config file

minor whitespace change

changed "http" to "https" in URLs

added displaying render driver on info screen page

improved displaying video and audio driver on info screen page

version number set to 4.2.0.2

fixed wrong eater content when loading native EM levels

This fixes a regression bug from commit baf962d5 that causes wrong
eater content when loading native EM levels.

Native Emerald Mine levels before version V5 only supported 28 eater
objects, but some levels contained object codes above that, which are
now mapped to empty space. (Before, they were mapped to the first 32
eater objects (28 objects, padded with four empty space objects) using
"mod 32" operation, which lead to completely wrong eater objects for
nearly all affected levels.)

Mapping these eater objects to empty space is the best solution for
now, as nearly all affected levels are solvable when using empty space
objects instead (as most of these objects originally mapped to doors
or letter elements).

changed number of eater arrays from 8 to 4 for pre-V6 EM engine levels

This prevents duplication of eater arrays for native EM engine levels
prior to version V6 (which had only four eater arrays). This is more
or less a cosmetical change only for the level editor when looking at
the eater arrays. There is no difference when playing such levels.

changed constant number of eater arrays to variable for EM game engine

This makes it possible to create and play levels with a number of
eater arrays other than eight (which was a contant value before)
when using the EM game engine.

fixed potential crash bug when reading from artwork info cache

This fixes a regression bug from commit 79425634, which allowed for
empty cache entries (as tokens "program_title", "program_copyright"
and "program_company" may be undefined), which may result in crashes
when reading inconsistent or incomplete cache files.

added missing cave buffer offsets to robot wheel position

fixed pushed objects going into acid in EM engine for old tapes

With the new EM game engine, objects that are pushed towards acid when
initially created fall into acid instead of replacing it (like in the
old engine). This change adds some compatibility code to use the old
behaviour when replaying old tapes.

This is an addition to commit f717d0c1.

fixed handling of pushed objects in EM engine for old tapes

This change fixes problems with emulating the behaviour of initially
pushed objects for old tapes. (With the new EM game engine, objects
that are pushed towards the player when initially created always kill
the player, while the object just stopped with the old engine.)

This is an addition to commit 1dd2190d.

fixed handling of androids in EM engine for old tapes

This change emulates slight differences in android handling between
the old and new EM game engine to prevent old tapes from breaking.

fixed handling of chain explosions in EM engine for old tapes

This change fixes problems with emulating the old behaviour of chain
explosions for old tapes.

This is an addition to commit 6b9e2be7.

fixed element mapping for amoeba drop for use with EM game engine

fixed support for initially moving spring in EM game engine

added support for initially moving spring to R'n'D game engine

fixed support for wrap-around levels in EM engine for old tapes

When playing tapes that solved wrap-around levels with the EM engine
that were recorded before wrap-around support was added, deactivate
wrap-around to not break old tapes.

fixed level editor key shortcuts (broken by regression)

This change fixes a regression of commit 888ee049 that causes problems
when handling text input in situations unrelated to the Android screen
keyboard, like entering key shortcuts with upper case letters inside
the level editor on non-Android platforms.

Thanks to Eizzoux for reporting this bug!

version number set to 4.2.0.1

fixed bug with reanimating killed player by CE condition

When checking for CE condition "explosion of <element>" using the
player as <element>, it is possible to create a new player right after
the player died (exploded).

However, this only worked when directly changing the CE to the player,
but not when using an extended change target (to create the player on
some adjacent tile next to the CE) that puts the new player on a tile
that is walkable (which is especially true for tiles that are empty).

This change fixes this bug. (The problematic code is in function
"CreateFieldExt()", but always checking for reanimating a killed
player in "InitPlayerField()" seems to be the better (more clean)
fix for this bug.)

renamed targets in Makefile

updated custom game controller mappings for newer SDL versions on Android

added disabling overlay touch buttons when using joystick

added tutorial level sets (those which are always part of the distribution)

changed build system for Android from Ant to Gradle

This change is due to an upgrade of the SDL library version used
for building the Android version from 2.0.5 to 2.0.12, which does
not use Ant anymore, but switched to Gradle several versions ago.

fixed screen size for newer SDL versions on Android

Using the previous code with newer SDL versions on Android, setting
the drawable screen size using the physical display size does not work
correctly anymore (as the display is usually larger than the drawable
screen area). This is corrected by using the effective size of the
renderer as soon as it is created.

fixed screen rotation for newer SDL versions on Android

Using the previous code with newer SDL versions on Android, screen
rotation did not work anymore, because the "resizable" flag seems
to be needed even when creating fullscreen surfaces to correctly
detect device rotation in recent SDL versions.

This was fixed by always using the "resizable" flag, regardless of
windowed or fullscreen surfaces on all platforms.

fixed text event handling for newer SDL versions on Android

Using the previous code with newer SDL versions on Android, when
entering text using the screen keyboard, all keys were processed
twice, because of different handling of text events and modifier
keys in recent SDL versions.

The new, more generic approach should work for all SDL versions
on all platforms.

added build support for older versions of Mac OS X

removed obsolete targets and statements from Makefiles

added CPU architecture (32/64 bit) to version info screen

added support for cross-compiling to Windows 64-bit platform

fixed compiler warning on non-Unix systems

added pre-processor directive to set if platform has touch device

fixed bug with scrollbar still active on virtual buttons config screen

replaced ILBM graphics source files in repository with converted PNG files

version number set to 4.2.0.0

updated title text and border graphic to show current year

fixed calculation of clickable area for list entries on menu screens

added setup option to select default or low-pass sounds for EMC levels

fixed text on game engines setup menu screen

added explicit type for headline entries on setup menu screens

moved game engine settings to separate setup menu screen

added playing door/gate sound when wrapping-around in EM engine

removed functions for correcting playfield buffer position for EM engine

moved correcting playfield buffer sound position to EM engine

moved correcting playfield buffer scroll position to EM engine

fixed correcting playfield buffer offsets for EM engine

added correcting playfield scroll position for EM engine

moved functions for correcting playfield buffer position to EM engine

changed correcting playfield buffer position for EM engine

removed checks for (unused) border element for EM engine

improved debug output for level/tape file, game and engine versions

fixed element property that caused levels/tapes to be unsolvable

This fixes a bug introduced in version 2.0.1 that broke already
existing levels and tapes, and adds some compatibility code for levels
and tapes created later that require the previous behaviour.

This bugfix was needed for level set "rnd_sam_bateman", level 029,
for example, while the compatibility code was needed for level set
"rnd_gerhard_haeusler", level 023, for example.

changed move speed for some elements for older game engine versions

This fix adds some compatibility code for a change in version 2.0.1
that lowered the speed of elements falling into magic wall elements.

This change was needed for level set "rnd_conor_mancone", level 014,
for example.

minor whitespace change

minor change of preprocessor macro

replaced a few bitmask operations by modulo operations

replaced bitmask for game/tape key/mouse actions by flags again

The previous solution using bitmasks was simply over-engineered.

added support for tapes with both keyboard/joystick and mouse actions

replaced flag for game/tape mouse actions by bitmask

fixed bug with potentially wrong data size at tape position

added function to calculate data size at tape position

changed variable for counting number of tape players

prepared code to support more tape actions than players

moved conditions to separate "if" statement

fixed bug with invisible, but active overlay touch buttons

This fixes a nasty bug with handling (invisible) overlay touch buttons
on devices without touch screen.

moved flag for mouse click events from level to game structure

Without this change, click events for newly built levels that are
started from the level editor, but that are not yet saved, are not
recognized and not handled (because the corresponding flag was set
only when loading a level).

added new change action "move player new" to CE change actions

The difference to the already existing change action "move player" is
that "move player new" only moves the player if this starts a "new"
movement (that is, the player is either not moving at all yet, or has
just finished moving to the next tile).

This is useful to prevent the case of an apparent "two-step movement"
caused by moving the player right after a movement has just started,
which then adds a "second" movement after the "first" movement.

added mouse click events to CE change events (experimental)

This addition is sort of fundamental to the R'n'D game engine in that
it extends the previous limitation of game engine input to only four
direction and two buttons, now also handling mouse clicks to elements
in the playfield as configurable custom element change events.

In contrast to the Mirror Magic game engine (which already handles
mouse input), recording mouse click events to tapes still has to be
implemented.

added being able to use CE condition "CE value/score gets 0"

While the custom element check "CE value/score gets 0 of [<element>]"
always worked fine, using the check "CE value/score gets 0" for the
same element never worked, because this required a previous change
action for changing the CE value or CE score in the same game frame,
but CEs can only change once in one game frame. (And checking in the
next game frame does not work either, because the CE value or score
does not change in the next frame, so it cannot be checked for zero.)

Resetting the CE's change counter after changing the CE value or score
makes it possible to test for zero directly afterwards.