AAAAAAAAAAAAAA

AAAAAAAAAAAAAA
ENDOOMER
AAAAAAAAAAAAAA

ENDOOM editing utility for DOOM

v1.0.1

(c) 1994 Zink The Dink >:D
[[email protected]]

*********************************** INDEX ************************************

[1] : WHAT IS ENDOOMER?

[1.1] : USAGE

[1.2] : PRE-MADE ENDOOM FILES

[2] : KEY COMMAND SUMMARY

[3] : WHAT TO DO NEXT

[4] : TROUBLE SHOOTING

[4.1] : ENDOOMER won't start

[4.2] : I Can Only Choose 8 colours when I'm in the BOX
or DRAW mode

[4.3] The Text Blink Thingy Is Annoying

[4.4] Whenever I Try To Paste It Erases The Screen

[5] : THE BASIC THEORY BEHIND THE ENDOOMER

[5.1] : THE GUTS

[5.2] : THE TEXT ATTRIBUTE

[5.3] : PUTTING IT ALL TOGETHER

[5.4] : TROUBLE SHOOTING (AGAIN?)

[6] : ADDITIONAL CREDIT

[7] : REVISION HISTORY

[8] : ONE FINAL WORD

[1] : WHAT IS ENDOOMER?
******************************************************************************

ENDOOMER is used to edit ENDOOM data that is stored in a IWAD or PWAD. ENDOOM
DATA, if you were not already aware, is used by DOOM to print colour text
ending messages that appear on the screen when you quit DOOM. ENDOOMs are good
to use if you want to give someone credit for the making of your WAD, and it's
also a good place to put your Internet address so people know who to mail their
comments to. (NOTE: if you want to know how the ENDOOM resource works, you
might want to go on ahead to section [5])

This version is just a minor revision. The most noticable change is that there
are now 'transparent' boxes. Refer to section [2] for how to use it.

[1.1] : USAGE

ENDOOMER is used like this:

ENDOOMER [EndFile]

The EndFile parameter is the name of a pre-made ENDOOM file (that usually has
a suffix of .END) that is loaded at the start up.

[1.2] : PRE-MADE ENDOOM FILES

ENDOOMER comes with a whole bunch of .END files to give you some ideas to make
your own ENDOOMs. Here's a list of them...

TEMPLATE END
SLIMY END
MAZE END
BARNEY END
COMMAND END
KNEEDEEP END
EASY END
MANIC END
FIFI END
CHEESE END
SWASTIKA END
MONDRIAN END
URBNBETA END
SONIC END

The TEMPLATE one is good to use if you decide to make an ENDOOM from scratch.
It has Id's credits already added to it, just to keep them happy. After all,
where would we be without them?

[2] : KEY COMMAND SUMMARY
******************************************************************************

Here's a brief summary of the key commands. You can also find these listed
in the on-line help (press F1).

F1 = Help
F2 = Save current ENDOOM file
F3 = Load an ENDOOM file
ALT-C = Copy screen to clipboard
ALT-V = Paste from clipboard to screen
ALT-T = Toggle transparent boxes (they won't cover over the text)
CTRL-C = Change the colour
CTRL-K = Toggle text blink (If text doesn't blink, then it'll blink,
if it does, then it won't blink)
CTRL-T = Switch to text mode
CTRL-D = Switch to draw mode
CTRL-B = Switch to box mode
ESC = Quit ENDOOMER

If you find that any of these key commands are annoying or you think that I
should change some of them, E-Mail me and tell me so.

[3] : WHAT TO DO NEXT
******************************************************************************

After you finish your ENDOOM, you will probably want to install it on a pwad.
This can be done with a program like DEU. Just type in the following...

DEU

> I ENDFILE.END ENDOOM (the pwad MUST be called ENDOOM or it won't work...)

> Q

DOOM -FILE ENDOOM.WAD

OR, if you want to include your ENDOOM in a previously made level, type in
This instead....

DEU

> I ENDFILE.END ENDOOM (again, call it ENDOOM, or else...)

> R ENDOOM.WAD

> R YOURWAD.WAD

> G NEWWAD.WAD

> Q

DOOM -FILE NEWWAD.WAD

Then quit doom, and your ENDOOM should then appear!!!

Also, for quick testing, if you just call your saved file ENDOOM.END, you
can do the DOOM -FILE thingy and it still should show up.

[4] : TROUBLE SHOOTING
******************************************************************************

If for some reason, something does not work right, then it looks like you're
going to have to do a bit of trouble shooting (sigh). If you think you've
found a bug in ENDOOMER, E-Mail me and describe the bug as best as you can.
After all, this is a beta version, and, as with just about every beta version
of a program that ever has and ever will exist, there are bound to be lot's
of bugs!!!

Well, here's a quick trouble shooting reference thing. If you still have
a problem that can't be solved here, E-Mail me. I'll try to help!

[4.1] ENDOOMER won't start

There are a number of reasons why this may happen:

a) You need a mouse! ENDOOMER won't run without a Microsoft compatible
mouse (yet!). I'm working on a keyboard emulator, but I'm not having
too much luck.

b) You're typing the name of a file that can't be loaded at the startup.

c) You don't have a colour monitor. If you can run DOOM on your machine,
You shouldn't have any problems with this.

[4.2] I Can Only Choose 8 colours when I'm in the BOX or DRAW mode

That, unfortunately, is how the standard DOS text mode works. There are
16 foreground colours, and 8 background colours and then there's the
blink. This is explained in more detail in section [5].

[4.3] The Text Blink Thingy Is Annoying

Yes boys AND girls, it's sad but true. The Text Blink thingy is annoying.
So, you may ask, It's annoying, so how do I use it?

Well, how the text blink thingy works is when you turn it on by pressing
CTRL-K, whatever you type over that doesn't blink will blink, and whatever
you type over that does blink won't blink. I know It's very annoying, and
I'm working on it to make it a bit better, but you'll just have to live
with it for now :(

[4.4] Whenever I Try To Paste It Erases The Screen

Eeek! Make sure that you've copied something to the screen before you
paste something to it! The clipboard is blank before you copy anything,
so if you paste something, you end up getting a blank screen! I'm working
on this one too. Just be careful!!!

******************************************************************************
[5] : THE BASIC THEORY BEHIND THE ENDOOMER

(NOTE: If you are not interested in making your own ENDOOM editing program
or you do not wish to know exactly how the ENDOOM works, I suggest that you
skip on ahead to the next chapter and ignore this one. It could ruin your
mind!!! But if you are interested, well, read on!)
******************************************************************************

[5.1] : THE GUTS
If you opened up an ENDOOM with a text editor, you might see something like
this:
S^H^E^E^E^E^R^ ^HNENANRNTN NANTNTNANCNKN!N!N!N [etc, etc...]

You may be wondering what the whole thing means. Let's look at the first two
letters..

S^ <---- The second byte is what colour the first byte will be when it's
| printed to the screen. In this case, the foreground colour will be
| white, and the background colour will be purple. This is called the
| Text Attribute byte. I'll explain this in more detail soon...
|
The first byte is printed to the screen...

They both form a thing that I call a texel. You know, a 'text pixel'.
This is basically how DOS text works. So, the ENDOOM is basically just
raw DOS text. You'll notice too, that the ENDOOM is always 4000 bytes, the
same size as the DOS text screen.

[5.2] : THE TEXT ATTRIBUTE

Like I said before, the second byte in the texel represents what colour the
first byte will look like when it's printed to the screen. This is called
the Text Attribute Byte. Here's a diagram of it:

** The Text Attribute Byte **

+128 +64 +32 +16 +8 +4 +2 +1
+---+---+---+---+---+---+---+---+
| B | b | b | b | f | f | f | f |
+---+---+---+---+---+---+---+---+
7 6 5 4 3 2 1 0

Bits 0-3 are for the foreground colour, bits 4-6 are for the background
colour, bit 7 is for the text blink.

The colours are simply standard DOS colours:

0 = BLACK
1 = BLUE
2 = GREEN
3 = CYAN
4 = RED
5 = MAGENTA
6 = BROWN
7 = WHITE
8 = GRAY
9 = LIGHT BLUE
10 = LIGHT GREEN
11 = LIGHT CYAN
12 = LIGHT RED
13 = LIGHT MAGENTA
14 = YELLOW
15 = BRIGHT WHITE

You must remember, also, that the background colour can have only the
up to 7 (WHITE) because it is only allocated 3 bits. The would be 4th one
is used for the text blink.

Thus 0 010 0001 = 00100001 = hex 21 = ASCII 33 = "!" = blue on green!

If you're programming in C, you're in luck because it just so happens that
there's a function, textattr, that does all this for you! Check your reference
manual and you should find it.

[5.3] : PUTTING IT ALL TOGETHER

After you figure out how the ENDOOM works, you have to put your knowledge
together and create one.

If you're making an ENDOOM in a text editor, well then you're in luck
because I have compiled the following chart that has a number of text
attribute values converted to ASCII so you can just look it up and print it
to the file. It doesn't have all the colours, though. Just a few. After all,
I'm not going to spend all my time trying to figure out what purple on
purple would be in ASCII! But if you have discovered any other combinations,
feel free to send them to me. Not that I'd need them, though...

** Sample Text Attribute Values Converted To ASCII Text **

Background Foreground
Char. ASCII Colour Colour
+----+-------+-----------+---------------+
|NULL| 0 | black | black |
| | 1 | black | blue |
| | 2 | black | green |
| | 3 | black | cyan |
| | 4 | black | red |
| | 5 | black | purple |
| | 6 | black | brown |
| | 7 | black | white |
| | 8 | black | gray |
|TAB | 9 | black | light blue |
| ! | 33 | green | blue |
| @ | 64 | red | black |
| # | 35 | green | cyan |
| $ | 36 | green | red |
| % | 37 | green | purple |
| ^ | 96 | purple | yellow |
| * | 42 | green | light green |
| & | 38 | green | brown |
| ( | 40 | green | gray |
| ) | 41 | green | light blue |
| _ | 95 | purple | white |
| + | 43 | green | light blue |
| 1 | 49 | cyan | blue |
| 2 | 50 | cyan | green |
| 3 | 51 | cyan | cyan |
| 4 | 52 | cyan | red |
| 5 | 53 | cyan | purple |
| 6 | 54 | cyan | brown |
| 7 | 55 | cyan | light gray |
| 8 | 56 | cyan | gray |
| 9 | 57 | cyan | light blue |
| 0 | 48 | cyan | black |
| - | 45 | green | light purple |
| = | 61 | cyan | light purple |
| ` | 96 | brown | black |
| ~ | 126 | gray | yellow |
| \ | 92 | purple | pink |
| / | 47 | green | white |
| | | 124 | gray | pink |
| : | 58 | cyan | light green |
| ; | 59 | cyan | light cyan |
| " | 34 | green | green |
| ' | 39 | green | pink |
| . | 46 | green | yellow |
| ? | 63 | cyan | white |
| < | 60 | cyan | pink |
| > | 62 | cyan | yellow |
| [ | 91 | purple | cyan |
| ] | 93 | purple | light purple |
| { | 123 | gray | light cyan |
| } | 125 | gray | light purple |
| O | 79 | red | white |
| N | 78 | red | yellow |
| K | 75 | red | cyan |
+----+-------+-----------+---------------+

So basically, all you have to remember is that:

(a) The ENDOOM should be 4000 bytes in size (4 k)
(b) The ENDOOM is made up of 2000 'texels'
(c) Texels are 2 bytes in size
(d) The first byte in the texel is what is printed to the screen
(e) The second byte in the text is what colour the first byte will be

With this in mind, you should be able to create an ENDOOM without the help
of ENDOOMER!!!!!!!

[5.4] : TROUBLE SHOOTING

What? I thought we just had a trouble shooting section!!!
Well, fear not, because this one shall be brief.

If you have any technical difficulties with constructing ENDOOMs, just
E-Mail me and tell me your problem, and also include you ENDOOM if you can.
It's a lot easier to just send me the thing and have me fix it than have
you trying to make sense out of my meaningless writing!

[6] : ADDITIONAL CREDIT
******************************************************************************

Yes, some people deserve some credit. After all ENDOOMER wouldn't be possible
(or wouldn't be quite as good) without them.

Id Software [[email protected]]
Most of us people who are hopelessly addicted to DOOM
would probably be lying in the gutter right now, if
it wasn't for all the guys at Id software. Thanks Id!!!

Matt Fell [[email protected]]
The maker of the Unofficial DOOM specs.
I'd still be trying to figure out what the colour byte
was if it wasn't for Matt!

Hank Leukart [[email protected]]
The creator of the Official DOOM FAQ.
I don't know. I just think this guy deserves some credit.
Maybe I'm just insane. I don't know.

Me!!! [[email protected]]
Okay, maybe I shouldn't thank myself, but I did the
whole thing didn't I! I should get some credit!!!

Fifi Fart Face [no address: Fifi is everywhere]
Yes Fifi, someday you will be a god.

Oh, and I couldn't forget my beta testers:

Calvin and Hobbes(?) [[email protected]]
Chris Howse [[email protected]]
Phil Longueuil [[email protected]]
Wesley Reiser [[email protected]]

(Hmm. There seems to be a pattern forming here...)

[7] : REVISION HISTORY
******************************************************************************

Here's a short revision history (not that you'd care, though)

v0.1 : Yup, this was the first one. It was a total disaster. It was written
entirely in Qbasic. Editing was very time consuming. You had to type
things in just like they would be when they were printed to screen
memory! This version really sucked.

v0.2 : At last! I finally got Borland C++ 4.0 for my PC, so this version
worked a lot better. Well, maybe not a lot better. Okay, it almost
sucked as much as v0.1, but hey, It was written in C and it was
about twice as fast as the first one. You must remember, there was
a learning curve! >;)

v0.3 : This version actually had a use! It could view ENDOOM files in full
colour. It had a nice title screen too.

v0.4 : Man, this one WAS a bug! Whenever I compiled the program, it would
restart the computer! And if it didn't do that, I'd just get a
"NULL POINTER ASSIGNMENT" error. I almost gave up completely because
of this!!!

v0.5 : Total revamping of the interface. I started with a clean slate.
I finally started using make-shift text windows. In this version,
you could edit an ENDOOM with relative ease.

v0.6-0.9 : A whole bunch of minor revisions. I just kept changing things,
and ENDOOMER just kept getting better.

v1.0b : My beta version. Now some other people actually got to use it!

v1.0 : A couple minor bug fixes and a few revisions in the
docs made version 1.0.

v1.0.1 : This version! Just a minor revision; corrected a few small bugs
and added transparent boxes

[8] : ONE FINAL WORD
******************************************************************************

Whew! That was a lot! I don't think I've ever written that much before in
my life!! Anyway, make sure to E-Mail me and tell me what you think of this
program. And if you have any ENDOOMs that you have made and are quite proud
of, send them to me! I want to have the biggest ENDOOM collection in the
entire world!!! Also, if you make a wad with an ENDOOM in it that was created
by ENDOOMER, I would appreciate it if you just gave me a wee bit of credit in
the documentation for your wad. Anyhow, just E-Mail me with your comments or
ideas. The next version of ENDOOMER should have a line drawing tool, among
other things.

Until my next release, Happy ENDOOMING!!!

Zink The Dink >:D
[[email protected]]

And Remember...

______________________________________________________________________________
__ __
__|__| The Mind Is Fifi : Fifi Is Not The Mind. __|__|
| |__ | |__
______________________________________________________________________________