Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dMagneticini(5)		  FreeBSD File Formats Manual	       dMagneticini(5)

NAME
     dMagnetic.ini -- Configuration file for dMagnetic.

SHORTCUT
     Run dMagnetic -helpini to see an example.

SYNOPSIS
     The configuration for dMagnetic(1)	, and the location of the game bina-
     ries is stored in a .ini file.

ELEMENTS
     The elements within the .ini files	are

     Sections
	 Sections are in square	brackets.

	 [FILE]

	 [DEFAULTGUI]

     Entries
	 entries have a	= in them.

	 rows=40

	 pawnmag=/usr/local/share/games/magneticscrolls/pawn.mag

     Comments
	 ;This is a comment

	 Comments start	with a ;

	 To use	a ; in an entry, it has	to be preceded by a backslash \;
	 Consequently, using a backslash requires preceding it with a back-
	 slash as well.	 \\

SECTION	[FILE]
     Like any .ini file, it is broken down into	sections, each section con-
     tains entries. One	section	has to be [FILES]. It should contain the names
     of	the game binaries, so that the game engine can find them.  For exam-
     ple:
     [FILES]
     pawnmag=/usr/local/share/games/magneticscrolls/pawn.mag
     pawngfx=/home/games/magneticscrolls/pawn.gfx
     ;pawnmsdos=/home/games/magneticscrolls/msdosversions/PAWN

     The .mag and .gfx packages	can be downloaded from https://msmemorial.if-
     legends.org/memorial.php, btw. If you are lucky enough to have a copy of
     the MSDOS version stored on your harddrive, you can provide the directory
     with the pawnmsdos	entry.

     ;wonderlandtworsc=/games/magneticscrolls/wonderland/TWO.RSC
     ;guildtworsc=/games/magneticscrolls/MSC/GTWO.RSC
     ;corruptiontworsc=/games/magneticscrolls/MSC/CTWO.RSC
     ;fishtworsc=/games/magneticscrolls/MSC/FTWO.RSC

     "Wonderland", and the "Magnetic Scrolls Collections" used a different
     framework,	called "Magnetic Windows". This	framework utilized a collec-
     tion of resource files. By	providing the name and the location of the
     second resource file "TWO.RSC", the names of the other ones can be	com-
     puted.

     Another option comes in the form of using .d64 images from	the Commodore
     64	release	of the games. Those image files	come in	pairs, since the games
     occupied both sides of the	floppy.	A komma	is used	to separate those two.
     ;pawnd64=/games/d64/pawn1.d64,/games/d64/pawn2.d64
     ;guildd64=/games/d64/guild1.d64,/games/d64/guild2.d64
     ;jinxterd64=/games/d64/jinxter1.d64,/games/d64/jinxter2.d64
     ;corruptiond64=/games/d64/corruption1.d64,/games/d64/corruption2.d64
     ;fishd64=/games/d64/fish1.d64,/games/d64/fish2.d64
     ;mythd64=/games/d64/myth.d64

     To	avoid any form of misunderstanding, it is recommended to make sure
     that the .ini file	is providing only one of the four methods. The other
     two should	be commented out.

SECTION	[RANDOM]
     This section configures the random	number generator.

     mode=pseudo
     ;mode=real
     seed=12345

     The mode can be one of two: "pseudo" or "real". Each one of them offers a
     different experience whilst playing. When testing the software, or	play-
     ing with scripts, the "pseudo" option should be chosen. This offers a
     certain degree of determinsm.
     Legal values for seed are in the range of 1 to 2147483647.

SECTION	[DEFAULTGUI]
     This section is configuring the default output Interface.

     [DEFAULTGUI]
     rows=40
     columns=100
     ;align=left
     align=block
     ;align=right
     ;mode=none
     ;mode=monochrome
     ;mode=low_ansi
     ;mode=low_ansi2
     mode=high_ansi
     ;mode=high_ansi2
     ;mode=sixel
     low_ansi_characters=\\/=|\;
     monochrome_characters= .:-=+*x#@$X
     sixel_resolution=1024x768

     Changing the numbers of rows will make pictures longer, changing the num-
     ber of columns makes them wider. To change	the output mode, comment it
     in, and comment the current one out.
     The characters that will be used in the low ansi rendering	mode can be
     configured	with the low_ansi_characters entry. Note that the backslash
     and semicolon need	to be escaped.
     The monochrome_characters entry is	a the actual shade that	will be	dis-
     played. The leftmost part start with the lowest intensity,	it goes	up un-
     til the right.
     The sixel resolution is setting the amount	of pixels in which the images
     are being rendered	with sixel mode.

EXAMPLE
     ;you can download the files from https://msmemorial.if-legends.org/mag-
     netic.php
     [FILES]
     pawnmag=/usr/local/share/games/magneticscrolls/pawn.mag
     pawngfx=/usr/local/share/games/magneticscrolls/pawn.gfx
     ;pawnmsdos=/usr/local/share/games/magneticscrolls/msdosversions/PAWN
     ;pawnd64=/games/d64/pawn1.d64,/games/d64/pawn2.d64
     guildmag=/usr/local/share/games/magneticscrolls/guild.mag
     guildgfx=/usr/local/share/games/magneticscrolls/guild.gfx
     ;guildmsdos=/usr/local/share/games/magneticscrolls/msdosversions/GUILD
     ;guildtworsc=/games/magneticscrolls/MSC/GTWO.RSC
     ;guildd64=/games/d64/guild1.d64,/games/d64/guild2.d64
     jinxtermag=/usr/local/share/games/magneticscrolls/jinxter.mag
     jinxtergfx=/usr/local/share/games/magneticscrolls/jinxter.gfx
     ;jinxterd64=/games/d64/jinxter1.d64,/games/d64/jinxter2.d64
     corruptionmag=/usr/local/share/games/magneticscrolls/ccorrupt.mag
     corruptiongfx=/usr/local/share/games/magneticscrolls/ccorrupt.gfx
     ;corruptiontworsc=/games/magneticscrolls/MSC/CTWO.RSC
     ;corruptiond64=/games/d64/corruption1.d64,/games/d64/corruption2.d64
     fishmag=/usr/local/share/games/magneticscrolls/fish.mag
     fishgfx=/usr/local/share/games/magneticscrolls/fish.gfx
     ;fishtworsc=/games/magneticscrolls/MSC/FTWO.RSC
     ;fishd64=/games/d64/fish1.d64,/games/d64/fish2.d64
     mythmag=/usr/local/share/games/magneticscrolls/myth.mag
     mythgfx=/usr/local/share/games/magneticscrolls/myth.gfx
     mythd64=/games/d64/myth.d64
     wonderlandmag=/usr/local/share/games/magneticscrolls/wonder.mag
     wonderlandgfx=/usr/local/share/games/magneticscrolls/wonder.gfx
     ;wonderlandtworsc=/games/magneticscrolls/WONDER/TWO.RSC
     [RANDOM]
     mode=pseudo
     ;mode=real
     seed=12345
     [DEFAULTGUI]
     rows=40
     columns=120
     ;align=left
     align=block
     ;align=right
     ;mode=none
     ;mode=monochrome
     ;mode=low_ansi
     ;mode=low_ansi2
     mode=high_ansi
     ;mode=high_ansi2
     low_ansi_characters=Thomas
     monochrome_characters= .-=+*x#@$X

BUGS
     Report bugs to <dettus@dettus.net>.  Make sure to include DMAGNETIC some-
     where in the subject.

AUTHOR
     Written by	Thomas Dettbarn

SEE ALSO
     dMagnetic(1)

OpenBSD			       April 26th, 2020			       OpenBSD

NAME | SHORTCUT | SYNOPSIS | ELEMENTS | SECTION [FILE] | SECTION [RANDOM] | SECTION [DEFAULTGUI] | EXAMPLE | BUGS | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dMagneticini&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help