fixed text event handling for newer SDL versions (again)

This fixes another regression of commit 5a53ae0c, 888ee049 and
35da46e4 that still causes incorrect key/text event handling.

The problem occurs when entering uppercase letters, which creates two
key events (pressed and released) with the lowercase letter (while
modifier state indicates that the Shift key is active), plus one text
event with the uppercase letter. The previous logic caused both cases
to be handled as a new key event, effectively handling that letter
twice (one time in lowercase, and another time in uppercase).

An additional check for text input style modifier keys prevents the
lowercase variant of the case described above not to be handled.

changed simple "printf()" debug output to new debug log function

removed checking for debug mode when using debug logging

fixed debug logging to omit output if debug mode disabled

added setting Android log level for new logging functions

changed warnings and debug output to use new generic logging functions

added option to limit debug output to specific debug mode

added generic logging functions (not used yet)

fixed potentially invalid string pointers when parsing options

When using command line options like "--option=argument" instead of
"--option argument" (which is especially needed if arguments are
optional), this resulted in invalid string pointers before this fix.

fixed regression bug introduced by changes for "autofix" command

This fixes program crashes that may happen when using automatic tape
replay with visible feedback (like "autoplay", "autowarp" etc.).

This is a regression of commit e534f3cf.

improved startup speed by optimizing parsing of parameter values

Commit bd5cd062 (that introduced event actions for global animations)
also added a nasty performance bottleneck due to complexity of parsing
event action parameters, which slowed down program startup phase quite
significantly. However, in most cases these parameters just stay at
their default values, so checking for that default value first results
in massively speeding up this part of the startup phase.

added ability to undo (restore) the previously recorded tape

When the in-memory tape is erased with more than a minimum length of
playing time (currently set to 20 seconds), an internal copy of the
tape is created to be able to restore it. Just type ":undo-tape" or
":ut" to undo (restore) the last tape.

If the in-memory tape to be erased is shorter than the minimum length,
an undo tape is created from it if it is longer than the currently
stored undo tape.

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.