@database Maper.guide
@(c) by Martin Kuchinka 20.Aug.1997
@font helvetica.font 11

@node main
@title "Maper.guide - Main Page"
@{jcenter}
Maper v0.02
18.-22.Aug.1997
by Martin Kuchinka
SHAREWARE
@{jleft}
  @{"   " link why         } Why I did it.
  @{"   " link requirements} What does id need.
  @{"   " link usage       } How to create a Map.
  @{"   " link register    } How to Register.
  @{"   " link save        } Save Formats.
  @{"   " link future      } Future Ideas.
  @{"   " link bugs        } Still Bugs.
  @{"   " link limitations } Limitations.
  @{"   " link history     } History.
  @{"   " link settings    } Preferences.

  @{"   " link address     } Author.

@{jcenter}
Special Thanks:

Wouter van Oortmerssen (@{fg fill}AmigaE 3.2e@{fg text})
Jan van den Baard (@{fg fill}GadToolsBox 2.0c@{fg text})
Michael Zucchi (@{fg fill}ilbm.m@{fg text},@{fg fill}ilbmdefs.m@{fg text})

@{fg shine}
Maper must NOT be used for
commercial use without authors
permission!!! Hacking this soft is
immoral (and useless).
@{fg fill}
Everybody can Register!!!
@endnode

@node why
@title "Maper.guide - Why I did it."
@{jcenter}
Excuse my pure English!...Thanx

I was working on a Dungeon and I created maps by 
hands and numeric keyboard. It was dificult with map
20x20x3... So I started with finding Map Editors on 
AmiNet, I found about 5 Editors, and Started with trying
their functions...
There was NO (I think) Editor with multi-level Editing 
functions, so I wrote Maper in AmigaE v3.2e by
Wouter van Oortmerssen (thanks you!)
It can Import data of "MAP " format and much more formats
written by me! Good Looking Editors was written in AMOS, 
so no AGA Maps...

I hope you will like this programm, you will register 
this programm  and you will send me your Suggestions or
Ideas or Bug Reports. @{" Address " link address}
@endnode

@node address
@title "Maper.guide - Authors Address"
@{jcenter}
@{u}Address:@{uu}

Martin Kuchinka
Kapucínská 79/3
Praha 1, 118 00
Czech Republic

@{u}E-Mail:@{uu}

kuchinka@k332.feld.cvut.cz


@{u}My Configuration:@{uu}

A1200
Blizzard 1230 IV
MC68882/50 MHz
16 MB Fast RAM
HD WDC 420 MB
CD-ROM GoldStar(6x)
Modem 2400 bps
@endnode

@node register
@title "Maper.guide - How to Register"
@{jcenter}      I wrote this Programm for all Amigians who trusts and
stayed with Amiga in her hard times...
Grrr...Co**odore...
#?!$%&...EsC*M...
Uffff...VisC*RP...

Because I`m only a pure Amigian(?!) and I hate programmers
who did useless programms and wants for it eg.: $50...
so I think that prices $1, £1, 1 DM or $1 equivalent are 
cheaper than cheap...
Every Amigian can buy Maper for its wonderful price...
:^) :^) :^) :^) :^)


Please send me a mail or e-mail like this:

@{i}@{fg shine}
Hi Martin,
I really like your  soft, and I want to register...

@{u}@{fg fill}My Name:@{uu}@{fg shine}
Fox Mulder 
@{u}@{fg fill}My Address:@{uu}@{fg shine}
Beverly Hills 90210 :^) 
Los Angels 
California, U.S.A. 
@{u}@{fg fill}My E-Mail:@{uu}@{fg shine}
mulder@xxx.usa
@{u}@{fg fill}My Config:@{uu}@{fg shine}
A1200 
Blizzard 604e+ 
130 MB RAM 
CD-ROM(24x) 
6.5 GB HD 
etc...

Martin, today(2.11.1997) I have sent you an Envelope with 
1$...

Thanx, Fox
@{ui}@{fg text}
When I will receive similar message I will do the version 
which will not open the requester when you starts Maper. 
In Project Menu will be new Item @{i}User@{ui}, with your name, 
address, registration number etc...

When I will receive your envelope I
will E-Mail you the UUCoded Maper...

If you dont have access to Internet so send me in your 
Envelope a 3½" AmigaDOS Formated Disk else I will format 
it to AmigaDOS format! Than put in to the Envelope stamps
to sent it back to you...

I hope that`s all!
@endnode

@node requirements
@title "Maper.guide - What does it need."
@{jcenter}
@{u}Required:@{uu}

OS2.0 (37+)
0.5 MB Chip RAM
reqtools.library v38+
iffparse.library v37+

@{u}Recommended:@{uu}

AGA Chip Set
amigaguide.library v37+
diskfont.library v37+
helvetica.font 9

All Libraries included:
reqtools.library v38.1435 (Nico François)
amigaguide.library v40.4
iffparse.library v40.1
diskfont.library v39.3

I am not sure if some of these
libraries will not require OS3.0(39+)
I have only A1200
@endnode

@node usage
@title "Maper.guide - How to create a map"
@{jcenter}
@{b}----------Menus:----------@{ub}

@{fg shine}Project:

@{fg fill}New...
@{fg text}Create New Map
It will Ask you for new sizes: Width, Height, Depth.

@{fg fill}Resize...
@{fg text}Resize your Map
It will Ask you for new sizes: Width, Height
If you want to resize the map with Depth, see:
Add Level/Delete Level Items in Edit Menu.

@{fg fill}Load Map
@{fg text}Load a Map
If the map is in format "MAP2" so you can`t load
blocks, it will be loaded automaticaly!
If the Map is a RAW File you MUST enter its sizes!

@{fg fill}Load Blocks
@{fg text}Load Blocks
It will ask you for:
Block Width
Block Height
Gap between Blocks
# of Blocks per Line
Be sure that All Blocks must have same size!!!
If there is a gap, it have to be same verticaly as horizontaly!!!
If you will enter a number wrong the map will be drew wrong!
If you will enter wrong numbers, try to load it again!

@{fg fill}Save Map
@{fg text}Save your Map
You can select one of @{"Save Formats" link save}

@{fg fill}About...
@{fg text}About Programm and Author, Memory.

@{fg fill}Info...
@{fg text}Show Map Sizes.

@{fg fill}Help...
@{fg text}Open this AmigaGuide Documents.

@{fg fill}Quit
@{fg text}Leaves the Maper!


@{fg shine}Edit:

@{fg fill}Cut
@{fg text}Cut a Marked Blocks, puts the Blocks in to the Buffer
and fills the marked Blocks with Selected Block.
How to Mark Blocks:
Click on a Left Top Corner of Blocks to Cut, press RMB,
Select Right Bottom Corner of Blocks to Cut, press RMB,
In Status Line will be written Width and Height of Marked Block.

@{fg fill}Copy
@{fg text}Copies a Marked Blocks in to the Buffer
Marking the Block is Same as with Cutting!

@{fg fill}Paste
@{fg text}Copies the Buffer in to the Selected Position,
be Sure that the Buffer can fit the Map!

@{fg fill}Save Buffer
@{fg text}Save the Buffer as RAM:Buffer.map it is in "MAP " format.

@{fg fill}Load Buffer
@{fg text}Load file RAM:Buffer.map to the Buffer,
it MUST be in "MAP " format.

@{fg fill}Add Level
@{fg text}Add a New Level Above the Current Level.

@{fg fill}Delete Level
@{fg text}Delete the Current Level.

@{fg fill}Copy Level
@{fg text}Copies Current Level to destination Level.

@{fg fill}Swap Levels
@{fg text}Swaps Current Level with destination one.

@{fg fill}Roll/Left...
@{fg text}Roll Current Level # Blocks to the Left.

@{fg fill}Roll/Right...
@{fg text}Roll Current Level # Blocks to the Right.

@{fg fill}Roll/Up...
@{fg text}Roll Current Level # Blocks to the Up.

@{fg fill}Roll/Down...
@{fg text}Roll Current Level # Blocks to the Down.

@{fg fill}Roll/Level Up...
@{fg text}Roll Whole Map # Levels Up.

@{fg fill}Roll/Level Down...
@{fg text}Roll Whole Map # Levels Down.


@{fg shine}Blocks:

@{fg fill}Get
@{fg text}You can select a Block from the Map.

@{fg fill}Set...
@{fg text}You can select a Block as a number.

@{fg fill}Swap...
@{fg text}Swap current and Second Block in current level.

@{fg fill}Copy...
@{fg text}Copy current Block to a Destination 
in current level.

@{fg fill}Select/...
@{fg text}See Keys...


@{b}----------Keys:----------@{ub}

@{fg shine}Map Scrolling:
@{fg text}(Good on Numeric Pad)
"@{fg fill}4@{fg text}" - Left
"@{fg fill}6@{fg text}" - Right
"@{fg fill}8@{fg text}" - Up
"@{fg fill}2@{fg text}" - Down

"@{fg fill}7@{fg text}" - Left Up
"@{fg fill}1@{fg text}" - Left Down
"@{fg fill}9@{fg text}" - Right Up
"@{fg fill}3@{fg text}" - Right Down

"@{fg fill}+@{fg text}" - Level Up
"@{fg fill}-@{fg text}" - Level Down

@{fg shine}Map Rolling:
@{fg text}This will Roll the Map Always by one Block!
"@{fg fill}Alt+4@{fg text}" - Left
"@{fg fill}Alt+6@{fg text}" - Right
"@{fg fill}Alt+8@{fg text}" - Up
"@{fg fill}Alt+2@{fg text}" - Down

"@{fg fill}Alt++@{fg text}" - Level Up
"@{fg fill}Alt+-@{fg text}" - Level Down

@{fg shine}Block Selecting:
"@{fg fill}Left@{fg text}" - Select Left Block
"@{fg fill}Right@{fg text}" - Select Right Block
"@{fg fill}Up@{fg text}" - Select Above Block
"@{fg fill}Down@{fg text}" - Select Below Block


@{b}----------Gadgets:----------@{ub}

@{fg fill}X
@{fg text}Same as Cut Menu Item.

@{fg fill}C
@{fg text}Same as Copy Menu Item.

@{fg fill}P
@{fg text}Same as Paste Menu Item.

@{fg fill}Q
@{fg text}Same as Quit Menu Item.

@{fg fill}N
@{fg text}Same as New... Menu Item.

@{fg fill}L
@{fg text}Same as Load Map Menu Item.

@{fg fill}B
@{fg text}Same as Load Blocks Menu Item.

@{fg fill}S
@{fg text}Same as Save Map Menu Item.
@endnode

@node bugs
@title "Maper.guide - Bugs"
@{jcenter}
@{fg fill}1:@{fg text}
If you will create a map small map: eg.: 8x8x1 with block
size 16x16 Maper will draw Map 10x10! Last two columns
and lines will drew of illegal blocks, if you will over write
this blocks Maper will crash your Amiga!
@{fg fill}2:@{fg text}
If you will scroll with scrollers
and while pressing the LMB you will
move your Mouse over the Map, the
strange thigs will happen...

In next Version I will eliminate
this bugs.
@endnode

@node save
@title "Maper.guide - Save Formats"
@{jcenter}
@{fg fill}"MAP "@{fg text}
Simpliest map file format ever.
@{jleft}			1. LONG "MAP "
			2. WORD width
			3. WORD height
			4. BYTE map data
				(length := width x height)

@{jcenter}@{fg fill}"MAP1"@{fg text}
This Format Allows to Save Multi-Level Maps.
@{jleft}			1. LONG "MAP1"
			2. WORD width
			3. WORD height
			4. WORD depth
			5. BYTE map data for level 0,1,2...
				(length := width x height x depth)

@{jcenter}@{fg fill}"MAP2"@{fg text}
This Format Allows to Save Multi-Level Maps and info
about Blocks Picture.
@{jleft}			1. LONG "MAP2"
			2. WORD width
			3. WORD height
			4. WORD depth
			5. WORD block width
			6. WORD block height
			7. WORD # of blocks per line
			8. WORD gap between blocks
			9. BYTE picture name (256 Bytes)
			10. BYTE map data for level 0,1,2...
				(length := width x height x depth)

@{jcenter}@{fg fill}RAW@{fg text}
This Format(?) saves Only Map Data without any Headers
@{jleft}			1. BYTE map data for level 0,1,2...
				(length := width x height x depth)

@{jcenter}@{fg fill}Map Data Description:
@{fg text}Level 0
Level 1
Level 2
...

Each Level has equal length: width x height bytes
Each Block Means one Byte (In Future may Extend!).
@endnode

@node future
@title "Maper.guide - Future Ideas"
@{jcenter}
Eliminate All Bugs.
Screen Mode Settings.
Generate Preview of a Map
Use More Than 256 Blocks
@endnode

@node limitations
@title "Maper.guide - Limitations"
@{jcenter}Max. Width - 32767
Min. Width - 4
Max. Height - 32767
Min. Height - 4
Max. Depth - 1024
Max. Block Width - 256
Min. Block Width - 4
Max. Block Height - 256
Min. Block Height - 4
Max. Block Gap - 256
Max. # of Blocks per Line - 1024
Max. # of Blocks in Map - 256
@endnode

@node history
@title "Maper.guide - History"
@{jcenter}
@{fg fill}v0.01@{fg text}
20.August.97
First Release

@{fg fill}v0.02@{fg text}
21.August.97
First Public Release

Added Edit Buffer Functions
Added Roll Map Functions
Requesters can remember previous path
Added Add/Delete Level Functions
Added Resize Function
Added Overwrite Requester
Topaz.font 8 Changed to Helvetica.font 9
Added Icon Settings of Important Paths
CopyMem() used instead CopyMemQuick(),
So the sizes can have values you like
Added Flip X and Y map and buffer.
Added Menu Blocks and its Functions.
Added Selected Block in Info Requester.
@endnode

@node settings
@title "Maper.guide - Preferences"
@{jcenter}
In Maper Icon you can change path for:
Maps, Blocks and this document.
@endnode