*** dMagnetic
*** Use at your own risk
*** (C)opyright 2020 by dettus@dettus.net
*****************************************


Welcome, brave adventurer. This is Version 0.22.
If you are interested in playing "The Pawn", just follow these simple steps.

STEP 1: BUILD
just run 

% make all


STEP 2: CHECK BASE FUNCTIONALITY
run

% ./dMagnetic -mag testcode/minitest.mag 

you should see a colourful X and the request to press enter.


STEP 3: GET THE BINARIES
Get the files pawn.mag and pawn.gfx. For example from this excellent website 
https://msmemorial.if-legends.org/games.htm/pawn.php
Alternatively, if you have the MS-DOS version of the games, copy them onto
your harddrive. 


STEP 4: CONFIGURE
edit dMagnetic.ini, especially the lines that start with one of ????mag= and 
???gfx=, ???msdosdir= or ???tworsc=. Make sure that only one of those three
methods (mag&gfx, msdosdir, tworsc) is being commented in.


STEP 5: RUN
run one of

./dMagnetic -ini dMagnetic.ini pawn
./dMagnetic -ini dMagnetic.ini guild
./dMagnetic -ini dMagnetic.ini jinxter
./dMagnetic -ini dMagnetic.ini corruption
./dMagnetic -ini dMagnetic.ini fish
./dMagnetic -ini dMagnetic.ini myth
./dMagnetic -ini dMagnetic.ini wonderland

Remember that for some games you have to type in GRAPHICS before you see them.

Alternatively, you can select the .mag files like this:

./dMagnetic -ini dMagnetic.ini -mag /usr/local/share/games/pawn.mag

TO SEE GRAPHICS IN WONDERLAND OR ANY GAME FROM THE MAGNETIC SCROLLS COLLECTION,
you have to type in 'GRAPHICS'. To see the EGA version of those pictures, run

./dMagnetic -ega -ini dMagnetic.ini wonderland


STEP 6: GRAPHICS
You can select output modes by using one of the following parameters:

./dMagnetic -ini dMagnetic.ini pawn -vmode none       -vrows 40 -vcols 120
./dMagnetic -ini dMagnetic.ini pawn -vmode monochrome -vrows 40 -vcols 120
./dMagnetic -ini dMagnetic.ini pawn -vmode low_ansi   -vrows 40 -vcols 120
./dMagnetic -ini dMagnetic.ini pawn -vmode high_ansi  -vrows 40 -vcols 120
./dMagnetic -ini dMagnetic.ini pawn -vmode high_ansi2 -vrows 40 -vcols 120
./dMagnetic -ini dMagnetic.ini pawn -vmode sixel -sres 1024x768 -vcols 120

The defaut mode is "low_ansi", since it works on most terminals. The mode 
called "high_ansi" provides the richest amount of colors, even though the 
graphics are slightly block-y. When playing the PC version, the high_ansi2
mode is recommended.
if your terminal does not support them, please try one of the others. 

The sixel mode can be used in certain terminal emulators, such as mlterm, or
some variants of xterm, when run with xterm -ti vt340.

STEP 6: LOGGING
In case you would like to retrace our steps, you can use -vlog LOGFILE.log and
-vecho to be able to see what you have typed in before. This helps when trying
to figure out what you did wrong, and why you have been killed. :)

-------------------------------------------------------------------------------
What about GLK?
I must admit that I am not the biggest fan of GLK. I only started looking into
it, so the whole interaction is quite shaky. Plus, there has not been a modern
X11 frontend on https://www.eblong.com/zarf/glk/ in some time. If you are 
interested in building it, please contact me at dettus@dettus.net. I need some
help with that. Thank you in advance!
-------------------------------------------------------------------------------

-------------------------------------------------------------------------------
I am running dMagnetic in XTERM, but the colors look bleak in low_ansi mode?

The reason might be that the colors for the low ansi mode have been calibrated
to the ANSI rgb values. Especially the brown color (3) is vastly different
in the default xterm settings. One solution could be to set the default rgb
values for xterm, by adding the following lines to your $HOME/.Xresources:

  xterm*background: black
  xterm*foreground: grey
  xterm*color0: rgb:00/00/00
  xterm*color1: rgb:aa/00/00
  xterm*color2: rgb:00/aa/00
  xterm*color3: rgb:aa/55/00
  xterm*color4: rgb:00/00/aa
  xterm*color5: rgb:aa/00/aa
  xterm*color6: rgb:00/aa/aa
  xterm*color7: rgb:aa/aa/aa
  xterm*color8: rgb:55/55/55
  xterm*color9: rgb:ff/55/55
  xterm*color10: rgb:55/ff/55
  xterm*color11: rgb:ff/ff/55
  xterm*color12: rgb:55/55/ff
  xterm*color13: rgb:ff/55/ff
  xterm*color14: rgb:55/ff/ff
  xterm*color15: rgb:ff/ff/ff
  

Afterwards, run 

% xrdb -merge ~/.Xresources  

and open a new xterm window. In this, you can play dMagnetic with proper colors.
  
-------------------------------------------------------------------------------


