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.

fixed drawing old screens for one video frame when skipping fading

This fixes a problem that was introduced with the last commit: When
skipping fading effects (like when changing screens by pressing the
"Escape" key), the special bitmaps used for fading screens are not
updated to the current source or target screens, which can result in
displaying old screens (displayed before pressing "Escape") for one
video frame.

(For example, this happened when pressing "Escape" on a sub-screen
of the setup menu, then pressing "Escape" again on the setup main
screen, which then resulted in displaying the setup sub-screen in the
main menu for a single video frame, causing "garbage flickering".)

(This change effectively reverts commit 5eabbc4d. Negative effects
on cross-fading were not observed during tests, but may still exist.)

fixed drawing global animations when switching screens without fading

Before, when switching screens without fading (like leaving sub-menus
with default settings for screen fading, or screen changes after
pressing the "Escape" key), a single video frame was drawn without
global animations, which could cause flickering of animations.

With this fix, global animations will also be drawn for this video
frame.

added option to generally set global animations to block clicks

added (optional) main menu button to switch between ECS and AGA chipset

added support for check buttons on menu screens

added missing handling of animation mode "random" for global animations

fixed selecting ECS/AGA graphics if only ECS or AGA graphics exists

In rare cases (like in EMC level set "emc_no_one_mine_19"), there are
only ECS or AGA graphics available, but not both (as it is usually the
case). If this happened, the available graphics set was not selected
if the ECS/AGA preference settings did not match (for example, if ECS
graphics are preferred, but only AGA graphics are available). As no
level set specific graphics were selected at all in such a case, this
resulted in falling back to the R'n'D default graphics.

This bug was fixed by ignoring the ECS/AGA graphics preference in such
cases, but always using the only available graphics set instead.

added option to swap game elements in EM caves using V5/V6 EMC graphics

When having EMC level sets with EMC graphics that were originally
played with the EMC player program, but that have cave files in old
cave file format, setting "use_emc_tiles" to "true" causes certain
game elements to be swapped just like when loading cave files with new
EMC file format (version V5 or V6), like swapping dirt and grass and
some wall elements.

This is a level set option, not a graphics set option, so it is still
possible to override graphics for classic style EM level sets with
modern EMC graphics without game elements being changed (so dirt does
not change to grass in this case).

fixed frame counter for EM engine for single step mode and engine snapshots

fixed centering screen to active player(s) at game start for EM engine

fixed bug with playing EM level with inactive player

moved removing inactive players to separate loop

fixed initializing locally connected player in single player mode

added drawing player twice when wrapping-around in fully visible levels

fixed initialization of flag for wrap-around levels in EM engine