
--------------
--- HELLO! ---
--------------

This is Custom DOSBox R17 by David Walters.

Based on the official DOSBox SVN revison #4067
http://sourceforge.net/p/dosbox/code-0/HEAD/tree/

It's designed as a drop-in replacement for existing DOSBox installations.


-----------------
--- GAME LINK ---
-----------------

Game Link allows an external application to communicate with the emulated game that DOSBox is running. It provides a mechanism for video, input and game data to be shared with the external application to play a game in a picture-in-picture mode.

When running the replacement "dosbox.exe" the default mode is to only allow access to read DOS memory. In this mode the game will appear in the DOSBox window as normal. External applications can read from DOS memory and extract information to enhance the game experience. For example, reading out the current player position and showing it as a top-down map.

To enable video and input sharing, you can choose one of three ways:

1. Setting the 'output' parameter in the dosbox.conf file to 'gamelink' (instead of surface, overlay, etc.)
2. Use the 'dosbox_gamelink' executable instead. This is hard coded to always use 'gamelink' output and ignore the dosbox.conf file (useful if you don't want to keep changing it back and forth).
3. Adding '-gamelink' to the command line parameters of 'dosbox'.

NOTE: If you wish to completely disable all Game Link functions from DOSBox add the line 'gamelinkmaster=false' to the [sdl] section of dosbox.conf.


---------------------
--- EXTRA CHANGES ---
---------------------

The following extra features have also been added. They are all disabled by default.

* Custom Window Title. Make games look friendlier with a custom window title. Set the option windowtitle=%name% with the text of your choice, or leave blank for default behaviour.

* Fixes for audio 'popping' in Wizardry 6 and 7. To enable this add the line wizpopfix=6 or wizpopfix=7 below pcspeaker=true in the dosbox.conf file.

* Mouse Vertical Sensitivity. Apply additional scaling to vertical movement of the mouse using sensitivityaspect=%value% in the [sdl] section. Where %value% ranges from -1000 to 1000 (negative values invert mouse movement). Typical values are 120 or 150 but feel free to experiment.

* Fix for reversed cutscene audio in "Terra Nova: Strike Force Centauri". This is always enabled.


------------------
--- CHANGE LOG ---
------------------

-- R17 --

* Updated to Game Link 3.0. Now requires Grid Cartographer v4.0.8 or later.
* Adds support for remote control of audio volume, pause, reset and power-off.
* Removed legacy [netpeek] feature.


-- R16B --

* [R16B] Fixed Game Link problems when using the restart key combination (default: CTRL+ALT+HOME)
* Game Link terminal. Send commands from Grid Cartographer to search memory.
* Removed legacy 'memscan' toolset.
* DOSBox now officially supports deadzones, so I've replaced my modified code with the official version.
* Added more 'DWD' markers in sdl_mapper.cpp and sdlmain.cpp
* Retained older sblaster.cpp implementation to preserve stereo fix for "Terra Nova: Strike Force Centauri".


-- R15 --

* Updated to Game Link 2.1. Now requires Grid Cartographer v4.0.7 or later.
* Fixed possible crash when running Windows 3.11 and opening a DOS prompt.
* Includes all official DOSBox changes up to SVN revision 4052.


-- R14 --

* Fixed an issue where Game Link could only access the first megabyte of RAM.
* Includes all official DOSBox changes up to SVN revision 4020.


-- R13 ---

* Tracking-only version of Game Link is used by default when starting the regular executable.
* Fixed Game Link bug where tracking doesn't work if the screen isn't being updated (e.g. Dark areas in 'Might and Magic II').
* Added gamelinkmaster option to dosbox.conf which disables all Game Link features if set to false.
* Includes all official DOSBox changes up to SVN revision 4000.


------------------
--- DISCLAIMER ---
------------------

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
