; ; comments        = comments
; ^text             = center this line
; >text             = right justify line
; ~a                = highlight a
; @###              = icon
; !text             = indent over 2nd line of icon
;
^Warlock Screen Editor
^Version 1.1.1a

_~I~N~T~R~O~D~U~C~T~I~O~N
Warlock is a comprehensive screen editor with some
special features not found in any other screen
editor to date. The user interface has been
specifically designed for ease of use and for
increase in productivity.

_~K~E~Y~S
[~P~g~U~p] : Used to pan up the page.
[~P~g~D~n] : Used to pan down the page.
[~C~t~r~l~-~P~g~U~p] : Used to zoom out.
[~C~t~r~l~-~P~g~D~n] : Used to zoom in.
[~A~r~r~o~w~s] : Used to move around on the edit screen.
[~S~p~a~c~e] : Simulate a left click (for painting,
erasing and flood filling) on the edit screen.
Other keys that correspond to buttons will be listed
in the description of that button.

_~M~O~U~S~E
The mouse is used to activate buttons, and also to
place and move things around on the screen.  The left 
button is used to press buttons and for dragging lines 
and rectangles and such. The right button (if pressed on
the edit window) will recenter the screen with that
location in the center.

_~P~A~L~E~T~T~E ~T~O~O~L~B~O~X
These buttons are used to select characters and
colors to be used for editing.

@000 Select NULL character : this tells Warlock to use
!the character already on the screen for painting,
line drawing, etc. NULL character has no effect in
wide and tall character mode, only text character
mode.

@003 Select NULL foreground color : this tells Warlock
!to use the foreground color already on the screen
for painting, etc. Affects all drawing modes.

@006 Select foreground color
!

@020 Select Null background color : this tells Warlock
!to use the background color already on the screen
for painting, etc. Does not effect wide and tall
character modes.

@023 Select background color. Note that there are
!

@031 Select background color (High Intensity/
!Blinking). This selects either a background
color plus a blinking foreground color or a high
intensity background color (depending upon the
destination video mode). Warlock represents blinking
text as a high intensity background color.

_~T~O~O~L~B~O~X
These are the main control buttons. They are used
to determine how the screen will be edited, etc.
You may rearrange the layout of the buttons by
pressing and dragging buttons around using the
right mouse button.

@044 Import area/drawing. [~F~2] Load a drawing
!from disk to the screen (or area). Current
formats supported are .WLD ("wild") Warlock Drawing
files, .ANS ANSI files, .ASC ASCII text files, .AVT
AVATAR files, .BIN binary files, .TXT text files.
Other formats will be added in the near future.

@043 Export area/drawing. [~F~3] Save a drawing
!(or area) to disk. Current formats supported
are .WLD ("wild") Warlock Drawing files, .WLF
("wolf") Warlock Font files, .ANS ANSI files, .ASC
ASCII text files, .AVT AVATAR files, .BIN binary
files, .C C/C++ source code, .TXT text files. Other
formats will be added in the near future.

@053 New area/drawing. Erase or clear the selected
!area or the whole screen. If the whole screen
is erased, a new screen size will be asked.

@068 Import bitmap area/drawing. [~A~L~T~-~F~2] Imports
!a bitmapped image from disk to either the
selected area to to the full screen. Current bitmap
formats supported are .PCX PC paintbrush files, .GIF
CompuServe Graphical Interchange Files, and .BMP
Windows BitMaP files. Importing can be done in any
number of different ways ranging from full color
approximation to greyscale to ASCII text. Experiment
with the various options. Note: 24 .bit PCX files are
not supported and 24 bit .BMP files are imported as
grey scale. Brightness range is 0 (darkest) through
100 (normal) through 200 (brightest). Shade-Block
value represents the ratio between shaded characters
to solid block characters. The lower the value is,
fewer shaded characters will be generated. Quality
represents how close you want to match the incoming
bitmap image. The lower the value, the higher the
quality. Quality can range from 0 (best) to 99.9
(worst). High quality images take longer to generate
than low.

@037 Paint. [~P] Allows you to "paint" using the
!currently selected character, foreground and
background colors.

@038 Eraser. [~E] Allows you to "erase" characters
!and/or colors from the drawing.

@040 Lines. [~L] Allows you to enter line drawing
!mode. Lines are draw in the current character
and colors. To select a line, click the first point
on the screen and drag to the end point.

@076 Rectangles. [~R] Click and draw hollow
!rectangles using the current character/colors.

@046 Boxes. [~B] Click and draw filled rectangles
!using the current character/colors.

@077 Circles. [~C] Click and draw hollow "ellipses"
!using the current character/colors.

@052 Balls. [~B] Click and draw filled "ellipses"
!using the current character/colors.

@041 Fill region. [~F] Fill a region on the drawing
!with the current character and color.

@048 Text place. [~T] Place text on the screen. To
!specify a font and font attributes, see Select
Fonts below. Once you are entering text, you may
press [~E~S~C] at any time to abort or [~F~1~0] when
you are finished.

@051 Area select. [~A] Used to select an area
!on the screen. Areas are used for newing
(deleting), exporting, importing, importing bitmaps
to, moving, snapshotting, pasting, mirroring, etc. If
an area is selected for one such operation, it will
only effect the highlighted area of the drawing.

@087 Area select. This tool will select everything
!from the upper-left corner of the drawing to a
position on the screen. This is the only way to
select areas larger then 25 rows long.

@070 Area snapshot. Copies the selected area to
!the clipboard for use with pasting.

@071 Paste area. Plops the contents of the clipboard
!onto the screen for you to move around.

@066 Vertical mirror area/drawing. Vertically mirror
!images the selected area.

@069 Horizontal mirror area/drawing. Horizontally
!mirror images the selected area.

@085 Rotate Area. This will rotate the currently
!selected area 90 right.

@088 Crop area. This will delete everything EXCEPT
!the selected area.

@067 Move area over. Allows you to move a selected
!area around on the screen. Spaces in the image
will be transparent revealing the screen contents
underneath. The move will be complete when another
drawing tool is selected (paint, eraser, line,
rectangle, box, circle, ball, fill, etc).  If the
area border is red the move is not complete. Any
output done when the move is incomplete will not
be saved.

@081 Move area under. Allows you to move a selected
!area around on the screen. Spaces on the screen
will be transparent revealing the contents of the
selected area. The move will be complete when another
drawing tool is selected (paint, eraser, line,
rectangle, box, circle, ball, fill, etc).  If the
area border is red the move is not complete. Any
output done when the move is incomplete will not
be saved.

@054 Use character. Will pick up a character from
!the screen and activate it on the character
palette toolbox.

@050 Use colors. Will pick up either the foreground
!and background color in Character mode or
just the foreground color in wide or tall block mode.

@042 Create shade. Allows for mixing colors to
!generate a shaded character, foreground, and
background color and will activate them on the
character palette toolbox. This is really only
usable in Character mode.

@039 Toggle grid. [~G] Turns on and off the grid.
!The grid is useful for alignment of stuff
on the screen and such.

@059 Select font. Tells Warlock which font to use
!and also how much additional space to place
in between characters, whether to use the fonts
internal colors or the currently selected characters
and if spaces are to be transparent or not.

@089 Toggle Warlock Code Page. This will switch
!from standard IBM font to the alternate
Warlock font (called Warlock Code Page) and back.
More detailed text screens can be generated with
this font either through direct drawing or from
importing a bitmapped image. For more details on 
Warlock Code Page, please refer to WCP.DOC included
with this package.

@061 Character mode. [~1] Turn on Character mode.
!This will allow the paint, erase, line,
rectangle, box, circle, ball, and flood fill
functions to use the character and colors selected
in the palette toolboxes.

@058 Wide block mode. [~2] Turn on the Wide block
!mode. Background colors and characters are
not used in this drawing mode. There are two blocks
in a character position in Wide blocks mode: one on
the top half and one on the bottom half of the
character.

@055 Tall block mode. [~3] Turn on Tall block mode.
!Background colors and characters are not
used in this drawing mode. There are two blocks in a
character position in Wide blocks mode: one on the
top half and one on the bottom half of the character.

@064 Line drawing modes. [~4,~5,~6,~7,~8] Select 
!line drawing mode. All drawing functions
@065 (with the exception of fill) use the line
!drawing characters. Box and Ball fill with 
@062 the currently selected character and then 
!outline with the line drawing characters.
@063 Only ~5, ~6, and ~7 are only available in
!standard IBM Code Page. ~8 is only available
@094 in the Warlock Code Page. (See Toggle Warlock 
!Code Page command)

@090 Quarter block mode. [~9] Select the quarter
!block mode. Background colors and characters
are not used in this drawing mode. There are four
blocks in a character position in Quarter block 
mode: two on the top half and two on the bottom 
half of the character. This mode is only available
in Warlock Code Page mode.

@091 Half character shaded modes. These modes are
!only available in the Warlock Code Page. The
@092 will use the currently selected foreground
!and background colors to plot a shaded half block
@093 on the screen.
!

@073 Undo. [~F~9] Restores the screen to its state
!just prior to the last operation.

@074 Zoom in. [~I] Select the Zoom In tool. Allows
!for zooming in on specific portions of the
screen (up to 800% magnification).

@075 Zoom out. [~O] Select the Zoom Out tool. Allows
!for zooming out on a specific portion of
the screen (up to the original 80 x 24 100%
magnification).

@047 View drawing in text mode. [~V] Allow to view
!the current drawing in native text mode.
You will be asked for the screen size (80x25 or
80x50) and whether or not you would like a status
line on the screen. Once in Text mode use the
[~P~g~U~p], [~P~g~D~n], [~A~r~r~o~w~s], [~H~o~m~e], [~E~n~d] keys to
scroll the screen around and press [~E~s~c] when you
are done viewing. The correct VGA font will be loaded
for the proper mode (i.e.: Warlock Code Page will be
active in this text mode if it is also active within
Warlock.

@057 About box. Display the credits for Warlock along
!with the amount of free memory available.

@060 Online help. [~F~1] You're soaking in it.
!

@049 Shell to DOS. Temporarily exits to DOS. Type 
!'EXIT' to return to Warlock.

@045 Exit to DOS. [~A~l~t~-~X] Exit Warlock and return
!to DOS.

@084 Switch toolboxes. Swaps positions of the
!character/color palette and main toolboxes.

@086 Shave right edge. This tool will shave the last
!column of characters off either the entire
screen or the selected area (if one is selected).
Most text and ANSI screens have difficulties with
screens that are exactly 80 characters wide due to
wrap-around.

Warlock is copyrighted 1994 by Aphelion Software.
For more information or for assistance, please
contact Daniel Mecklenburg via netmail at 1:267/89
on FidoNet, 75:7518/0 on DoorNet, 19:1518/0 on
Wishnet, 97:518/0 on SCN-Net, 181:201/0 on
StormNet, or call Non-Sequitur BBS at (518)359-7887.

I'd like to thank my beta team for their work to make
this program the best it can be.

!~B~l~a~c~k ~T~i~g~e~r - For the name, icon assistance,
!technical help, suggestions, and inspiration.
!~P~a~t~t~i ~T~h~o~m~p~s~o~n - For being the 'novice user'
!tester and my devoted spell checker.
!~B~r~i~a~n ~R~i~d~e~r - Testing on a network and
!general program testing.
