*******************************************************************************
*                                                                             *
*                               D.T.Painter                                   *
*                                                                             *
*                               Version 1.1                                   *
*                                                                             *
*                           Created by Earl Gehr                              *
*                                                                             *
*            This software is copyright (c) 1990 by Earl Gehr and             *
*   copyright 1986 TML Systems, Inc. Certain portions of this software are    *
*   copyrighted by TML Systems, Inc.                                          *
*                                                                             *
*******************************************************************************

*******************************************************************************
*                                                                             *
*   This program is SHAREWARE! You can try it free for two weeks. If after    *
*   that time you decide to keep it, then send $10 to:                        *
*                                                                             *
*                                 Earl Gehr                                   *
*                           1824 A Manning Circle                             *
*                           Charleston, SC 29404                              *
*                                                                             *
*                  --> Support me and I will support you!  <--                *
*                                                                             *
*  Neither this documentation or this software may not be altered. A copy     *
*  of this documentation must be included with each copy of this software     *
*  distributed.                                                               *
*                                                                             *
*  This software may be distrubuted freely so long as no money is made from   *
*  its distribution without prior agreement with Earl Gehr.                   *
*                                                                             *
*  Apple, Apple IIgs, AppleColor and Imagewriter are registered trademarks    *
*  of Apple Computer,Inc. PaintWorks is a trademark of Activision.            *
*                                                                             *
*******************************************************************************

*************************** Disclaimer of Warranty ****************************
*Even though Earl Gehr has tested the software and reviewed the documentation,*
*Earl Gehr makes no warranty or representation,either express or implied,with *
*respect to this software,its quality,performance,merchantability,or fitness  *
*for a particular purpose. As a result,this software is sold "AS IS" and you  *
*the purchaser,are assuming the entire risk as to its quality and performance.*
*In no event shall Earl Gehr be held liable for direct, indirect,special,     *
*incidental,or consequential damages resulting from any defect in this        *
*software or its documentation.                                               *
*******************************************************************************

Minimum system requirements are :
  1. Apple IIgs computer.
  2. 1.25 meg memory(minimum).
  3. One 3.5" disk drive (hard disk recommended).
  4. Apple IIgs System Disk 5.0 or greater.


What is D.T.Painter?

It's a complete Apple IIgs paint program under the disguise of an NDA (New Desk
Accessory). When your computer is booted from a disk that contains the
D.T.Painter program in the SYSTEM/DESK.ACCS folder you have access to it from
within any program that uses the standard Apple IIgs desktop interface (host
program).
The program works in host programs that run in either 320 or 640 Super Hi-Res
modes. All drawing is done in the mode that the host program is running in.


How do I install D.T.Painter?

All you need to do to install the program is to copy it into the
SYSTEM/DESK.ACCS folder of a copy of your Apple IIgs System disk or
hard disk drive.

If you do not have enough room on your system disk to install D.T.Painter then
you can install it into memory AFTER booting up your system using one of
the many NDA/CDA installer programs available as freeware or shareware in
the public domain.

These programs can add an NDA to your apple menu (or a CDA to your CDA
Control panel) from any disk or folder that it is in. Some of these programs
are actually NDA's themselves and will easily fit on a complete System disk
5.0 or greater without modifications. To find out more about these programs
contact your local Apple User Group or one of the public domain software
distributing businesses. Your local Apple dealer MIGHT even be able to help
you out.
 

What programs won't D.T.Painter work with?

D.T.Painter is a very flexible program and adjusts itself to run within most
host programs, but there are some programs that do non-standard things to the
Apple IIgs desktop enviroment. The things I am talking about are the use of
more then one Super Hi-Res mode and/or more then one color palette at the same
time. D.T.Painter checks for these conditions when you select it from the Apple
menu. If it finds either to be true it will tell you so and close itself.

One other thing that a host program might do is to change Super Hi-Res modes
improperly while D.T.Painter is on the desktop. Proper switching of modes
requires the host program to close all New Desk Accessories before switching
modes. If a program does this while D.T.Painter is running, D.T.Painter will
find out about it and close itself.


How do I use D.T.Painter?

Just select D.T.Painter from the Apple menu of the host program that you are
using. Click the mouse or press a key to clear the title screen and start
drawing. To quit D.T.Painter click the CLOSE box in the upper left corner of
the programs window.


Drawing Tools

The Tools are displayed on the left side of the programs window. They are
divided into two columns (displayed in order listed). Tools are selected by
clicking the mouse on top of the tool you want or by using the arrow keys.

  Left Tool Column:                           Right Tool Column:

  Edit - Selects an area of picture      Scroll - Scrolls picture.
         to edit with edit functions.    Airbrush - Simulates an airbrush.
  Eraser - Erases area under mouse.      Text - For typing text into picture.
  Fill - Flood fill starting under       Line - For drawing straight lines.
         cursor.                         Oval - Draws circles and ovals.
  Pencil - Freehand drawing tool.        Round Rectangle - Draws rects with
  Arc/Wedge - Draws arcs and wedges.                       round corners.
  Rectangle - Draws rectangles.           Polygon - Draws polygons. Click to
  Region - Draws a closed freehand                  start and double click to
           shape.                                   end drawing.

The two buttons (Frame, Solid) under the tool area are for selecting either
framed or solid shapes. Click on either the Frame or Solid button to select the
type shape you want to draw with or press the return key to toggle the type
shape to use.

The area under the Frame/Solid buttons is the color selection area just click
the mouse on top of the color you want to use or use the arrow keys with the
shift key pressed to select a color.


D.T.Painter Menu Bar

The programs window contains its own menu bar. The following is an explanation
of each menu item:


Apple Menu Items
 
About D.T.Painter - Displays a dialog with author, copyright and version
                    information.

NDA's - Below the 'About D.T.Painter' item all NDA's that are available to your
        system are listed and selectable.


File Menu Items

New - Clears the screen, resets colors to host colors, resets picture title
      to "Untitled", shows tools if they were hidden, turns off Fat Bits,
      Turns off Edit, turns off Coordinates, turns off Text, resets tool to
      scroll and resets type file to save to Apple Preferred. You will be
      prompted for verification to perform this function if you have
      changed the picture currently displayed.

Open - Displays a dialog for selecting a file to load. All the same functions
       and tools are reset just as when selecting the NEW item. The following
       picture file types are supported :

         PaintWorks Packed Picture (File Type $C0 Aux Type 0).
         Packed Super Hi-Res Image (File Type $C0 Aux Type 1).
         Apple Preferred Picture   (File Type $C0 Aux Type 2).
         Super Hi-Res Screen Image (File Type $C1 Aux Type 0).

       If the picture you have selected was created in a Super Hi-Res mode
       other then the one that the program is currently using then the
       colors available when the picture is loaded will be those of the host
       program. Otherwise the pictures colors will be used
       You will be prompted for verification to perform this function if you
       have changed the picture currently displayed.

Save - Displays a dialog for saving a picture to disk. The picture will be
       saved using the colors and in the Super Hi-res mode currently in use.
       The file type the picture is saved in by default is Apple Preferred
       Picture, but the file type can be changed in two ways. If the picture
       you are saving was loaded from disk then the file type to save it in
       will be changed to the type that was loaded. The file type can be
       changed at anytime by using the SET FILE TYPE function explained
       below.

Set File Type - Used to select the file type to save a picture in. When the
                dialog is displayed it will reflect the currently selected
                file type. The following picture file types are supported :

                  PaintWorks Packed Picture (File Type $C0 Aux Type 0).
                  Packed Super Hi-Res Image (File Type $C0 Aux Type 1).
                  Apple Preferred Picture   (File Type $C0 Aux Type 2).
                  Super Hi-Res Screen Image (File Type $C1 Aux Type 0).

                The Packed SHR Image and SHR Screen Image file types save only
                the top half of the picture (200 lines, full screen image) the
                other two types (PaintWorks Packed Picture and Apple Preferred
                Picture) save the entire picture which is 396 lines.

Delete - Used to delete any file on a disk. You will be prompted to verify
         your desire to perform this function before the file selected is
         deleted.

Page Setup - Used to tell the program the type paper available on your
             printer and for performing several special effects with print
             output.
             The default paper type is 8" x 11" single sheet. This type paper
             size setting will cause pictures that are a full printed page in
             size to be truncated by a few lines to fit within the automatic
             margins set up for this paper type. If you are going to print a
             full printed page size picture then use fan fold paper and
             select this type paper with this function. This will allow the
             entire picture to be printed on a single page since no margins
             are set for this type of paper.

Print - Used to print the currently displayed picture, select number of
        copies to be printed, selecting any of several special effects and
        whether to print in color or not.


Edit Menu Items

Undo - Undoes the last thing done to the picture displayed.

Cut - Used with the Edit tool. Cuts the area within the edit rectangle from
      the picture and places it on the clipboard.

Copy - Used with the Edit tool. Copies the area within the edit rectangle to
       the clipboard.

Paste - Turns on the edit tool and displays the contents of the clipboard on
        the screen within a movable edit rectangle. The pasted item is not
        added to the picture until another edit function is selected or
        another tool other then the edit tool is selected or the mouse is
        clicked outside the edit rectangle.

Clear - Used with the Edit tool. Erases the area within the edit rectangle
        from the picture.

Invert - Used with the Edit tool. Inverts the colors of picture within the
         edit rectangle.

Horiz Flip - Used with the Edit tool. Flips the area within the edit
             rectangle horizontally.

Vert Flip - Used with the Edit tool. Flips the area within the edit
            rectangle vertically.

Show Clipboard - Displays the contents of the editing clipboard.


Special Menu Items

Fat Bits - Zooms the area of the picture that was last clicked on by the
           mouse. The only tools that function within Fat Bits are the pencil
           and scroll tools. Selection of any other tools turns off Fat bits.

Coordinates - Displays the coordinates of the mouse in the D.T.Painter menu
              bar in relation to its position on the whole picture.

Hide/Show Tools - Toggles the display of the tools at the left side of the
                  screen.

Full Screen - Displays the picture using the full screen. Scroll the picture
              just as you would using the scroll tool.

Choose Font - Select a font to draw with from any available in your boot
              disk SYSTEM/FONTS folder and modify the style and size of the
              font you have selected.

Pen Size - Select the pen size to draw with by just clicking on it within
           the dialog. Clicking on any area other then a pen size will
           cancel the operation.

Edit Color - Displays a dialog for editing the pictures colors. When the
             program is running in 320 Super Hi-res mode you can create any
             of the 4096 colors the Apple IIgs can display. When editing
             colors with the program running in 640 Super Hi-res mode, you
             edit the six BASIC colors that make up the DITHERED color
             patterns used to give the illusion of 16 colors in this mode.
             Selecting Edit Color when using the host programs colors (ie Use
             Host Colors item selected) causes the Use Pic Colors item
             (described below) to be activated. This causes the current pic
             colors to be replaced with the host colors. All color editing
             effects only these new pic colors.

Use Pic/Host Colors - Toggles which colors are used, those of the host
                      program or those that were loaded with a picture from
                      disk. If a picture was loaded from disk and was created
                      in the same Super Hi-Res mode the program is running
                      within then the Use Pic Colors item will be enabled and
                      selectable, otherwise it is disabled until either a
                      picture is loaded that was created in the same Super
                      Hi-Res mode or you have selected the Edit Color item
                      described above and attempted to edit the colors.


KeyBoard Equivalents

Pressing one of the following keys while holding the OA (Open Apple) key has the
same result as selecting the listed function from the D.T.Painter menu bar:

                         @ - Displays Title Screen

      File menu items        Edit menu items    Special menu items

      N - New                Z - Undo           B - Fat Bits
      O - Open               X - Cut            L - Coordinates
      S - Save               C - Copy           W - Hide/Show Tools
      T - Set File Type      V - Paste          F - Choose Font
      D - Delete             I - Invert         J - Pen Size
      Y - Page Setup         H - Horiz Flip     E - Edit Color
      P - Print              U - Vert Flip      R - Use Pic/Host Colors

The keys listed below perform the functions listed next to them without the
OA (Apple key) being pressed:

  Delete key - When the text tool is in use it deletes the character to the
               left of the text cursor.

  Delete key - When the edit tool is in use it deletes the area within the
               edit rectangle.

  Space bar - Toggles Full Screen display.

  Return key - Toggles type shape to be drawn (frame or solid).

  Arrow keys - Used to select tools.

  Arrow keys with shift key pressed - Used to select colors.

*******************************************************************************