
wtedit-0.03
===========
This is my fourth pre-release of a wt world editor.

NEW FEATURES:
=============
1. Automatic tiling of wall textures - particularily useful for doors
2. Automatic Alignment of walls to floor height (via y - Phase)
3. Definition of start point (you need a patch to wt to use this)
4. Automatic check for which textures are undefined or unused
5. Bug fixes/cleanup with the dialogs
6. y-Coordinates corrected - looks now really like a view from top
   (was it in the version before ?)
7. last not least - 3 of the orginal DOOM levels (e1m1,e1m2,e1m7) -
   yes, really, it works! But, note to Chris, at some points in e1m2 and
   e1m7, wt spites cores at me ...
8. included some patches to wt, to add following features:
   a. 8 bit palette file, back again - really looks better with my bitmaps.
      NOTE: this is a simple minded one, it looks only for exact color
      matches, all others are mapped to index zero. I included a
      colormap file (named cmap) for use with the gif files included.
   b. a keyboard command to lock view height and to move up/down.
      Press keypad-minus to lock the height, keypad-plus/enter to
      move up/down. Clipping code is really necessary ...
   c. make wt more informative in case a wall texture wasn't defined.
      There are some places, where pointers aren't checked for NULL
      in wt.
   d. a change posted by someone in the mail list, which fixes the behaviour
      of x/yphase.
   e. increased  the fixed table size for the bigger world files.
   These patches are relative to wt-0.04b + wt89 for gif89 format,
   they are in the file wt-0.04b+wt89-patches.

Installation: 
=============

look at the file 'edit' and set the variable
"installdir" to the full pathname where the editor will go.
Set the variable texturedir to the path where you keep your
texture files. Run the program by simply typing 'edit'. If
this doesn't work on your machine, 'wishx -f edit'.

NOTE: you really need 'wishx', which is the Extended Tcl/Tk
interpreter shell, since many functions from Extended Tcl are
used.

USAGE
=====
You may create a world by doing the following steps:

1. Adding textures

Choose Texture from the 'misc' menu, select a texture file from the list box
and give it a name in the text entry.  Click 'Add Texture'.

2. Creating Regions

Enter bottom/ceiling height in the two text entries.  Select a floor texture
in the Upper listbox, ceiling texture in the lower one.

3. Creating points 

Choose "Vertex" from the mode menu, use left button to create points, right
button to drag them around. You may split an existing wall by simply creating
the vertex on the wall. NOTE: the newly created wall gets it's defaults from
the preferences dialog, not from the splitted wall (should i change this ?).

4. Creating walls

choose "Wall" from the Mode menu, start by clicking the left button on a
vertex.  A rubber-bading line will appear. Connect vertices by selecting
subsequent Vertices with the left button. When you get to the first vertex you
chose (i.e. you close the cycle), the rubberline disppears.  You may stop at
any time by pressing the Escape-key. You should set defaults for your newly
to-create walls by selecting them from the 'preferences' dialog (choose
'Preferences' from the 'misc' - Menu). You may select a previously added
texture, fore and back region in this dialog, which get set on the newly
created wall. You may also enter the x/y scale&phase values here.

5. Modifying walls:
Most of the modification things work by selecting a wall and then pressing
a key. You need to switch to 'select' mode in the 'Mode' - menu and may then
select a wall or a vertex by clicking on it. A small window showing the 
wall/vertex def pops up, the selected thing turns orange.

To exchange start/end points of a wall, choose "Select" from Mode menu, select
a wall with the left button and press the "f" key.

To set Texture for a wall, choose "Preferences" from the misc menu, and select
a texture. Then select a wall and press "t".

to set fore/back regions for a wall, select two regions in the 
preferences dialog, select a wall and press "r".

to set x/y-scales, enter them in the prefs dialog, select a wall 
and press 'S' (shift-S).

to set x/y-phases, enter them in the prefs dialog, select a wall 
and press 'p'.

Auto-scaling:
with the keys 'x' and 'y' you may arrange for a wall texture to tile exactly
once over the height/width of the wall. 
It's pretty easy - yscale simply gets 1/(visible height of wall).
For x, xscale gets 1/wall length. If you set both, the texture covers the whole
wall exactly once, which is very useful for creating doors, computer consoles
and such.

Alignment:
With the key 'a', you may Align the texture bottom to floor, that means the
bottom of the texture appears at the floor.

There is a function 'Sort walls' with which you can make all walls belonging
to a cycle point into one direction. Try it out yourself to understand best
what it does. Create a cycle of walls, flip some of them, select one and 
press "s". They now point into one direction. This is not very well tested.

The Open/Save dialogs from the 'File' menu are pretty easy to understand,
i think. With the checkbutton 'Tcl format' you may choose, if you want
to save the file in tcl world file format - that is, textures are
output as 'set $Name [texture filename]' and all others are output
with texture references as variables. NO SUPPORT FOR LOADING THIS FORMAT,
sorry, i didn't have the time to do that.


6. Start point:
This is the fat, green point you see when starting the editor up. You may
simply move the point around, it is stored together with the world
file, as 'start x y'. This very useful, in particular when you want to 'debug'
a big world file. You need a patch to use it with wt.

7. Checking textures:
when you choose 'texture' from the 'Check' menu, all textures all compared
against all walls and regions, and you get a message about which textures
used in walls are not defined or which textures are not used at all. Was useful
with those doom worlds ...

======== End of 'Usage' ========

Thomas

Bugs,fixes and proposals to
malik@sun.rhrk.uni-kl.de
or
malik@serv-400.dfki.uni-kl.de

Flames to /dev/null.
have fun.

