       +----------------------------------------------------------+
       |                                                          |
       |         ----------------------------------------         |
       |                                                          |
       |                RIPaint v2.1 Professional                 |
       |                                                          |
       |         ----------------------------------------         |
       |                                                          |
       |                                                          |
       |                    October 21, 1997                      |
       |                                                          |
       |                                                          |
       |  Copyright (c) 1992-97, TeleGrafix Communications, Inc.  |
       |                   All Rights Reserved                    |
       |                                                          |
       +----------------------------------------------------------+


PROGRAM REQUIREMENTS
--------------------

RIPaint requires that you be using an 80386 or higher IBM-PC compatible
computer system running MS-DOS version 3.0 or higher.  You must have at
least 4Mb of memory in the system configured as XMS memory (EMS memory is
not recognized) - we strongly recommend running the software with at
least 8 megabytes of memory.  

A hard disk is also required.  You must have an EGA or greater video
adapter and a Microsoft compatible mouse.  A color monitor is not required,
but is strongly recommended.  This software is a 32-bit protected mode
application that takes advantage of the 80386 microprocessor's features
and capabilities.  It requires and makes use of extended memory.

RIPaint requires a minimum of 10MB of disk space.  It is recommended that
you leave approximately 15MB of disk space for it when you're running it.


RUNNING RIPAINT UNDER DOSBOX
----------------------------

RIPaint runs well under DOSBox.  Two things to know about the setup that
runs the first time you start the program:

* Video card - do NOT use auto-detect.  Choose one of the VESA entries from
  the list instead.  VESA Super VGA 640x480, 800x600 and 1024x768 are safe 
  choices.  Auto-detect does not reliably identify the emulated adapter.

* Audio card - auto-detect works fine here and can be used.

Click inside the DOSBox window first so that DOSBox captures the mouse.
RIPaint is mouse driven and a mouse is required.

To run the setup again later, exit to C:\RIPAINT2\, and run SETUP.BAT 
or delete RIPAINT.CNF and start RIPAINT again.


RUNNING RIPAINT UNDER MICROSOFT WINDOWS
---------------------------------------

Included with your software is a Microsoft Windows 3.11 Program Information
File (PIF) called RIPAINT.PIF.  This file allows RIPaint to run properly
under Windows 3.11.  An icon file named RIPAINT.ICN is also provided for
your desktop.


PROBLEMS RUNNING RIPAINT UNDER WINDOWS
--------------------------------------

If you encounter any problems running RIPaint under Windows (i.e.,
crash problems, graphics becoming corrupted, etc.), try copying the
file called RIPAINT.PIF (located in the C:\RIPAINT directory) to your
WINDOWS subdirectory.  Nearly all problems that you might encounter
running RIPaint under Windows can be solved by changing the PIF file.
To change the RIPAINT.PIF file, run the "PIF Editor" from the
Accessories Group and change the settings to suit your needs.

-------------------------------------------------------------------------------

DOCUMENTATION
-------------

The complete 362 page RIPaint 2 manual is included in this package:

   RPMANUAL.html   The whole manual as a single web page.  Open it in any
                   web browser, on any operating system.  The text is real
                   searchable text, every figure is embedded in the file,
                   and there is a clickable table of contents at the top.

   RPMANUAL.pdf    The same manual as a US Letter PDF, for printing.

Everything below is only a quick reference.  The manual has the full detail.

Known limitation:  a small number of vector line drawings - simple outline
shapes that illustrate some of the drawing commands - are not reproduced,
because that part of the original Common Ground drawing format was not 
decoded.  All text, rules, boxes, table lines and all 28 bitmap figures 
are complete.

The original RPMANUAL.EXE is still in this directory and is unchanged.  It
continues to requires Windows 3.1 or newer, it also runs under Wine on Linux 
and macOS.


-------------------------------------------------------------------------------

MOUSE NAVIGATION
----------------

RIPaint is a mouse driven program and a Microsoft compatible mouse is
REQUIRED.  Under DOSBox, click once inside the window first so that DOSBox
captures the mouse.

  RIGHT BUTTON - press and hold
        Brings up the menu bar across the top of the screen.  Keep the
        button held down, slide onto File, Edit, Windows and so on, and
        release on the item you want.  (The manual describes this as a
        right click; under DOSBox press and hold is usually more reliable.)

  RIGHT BUTTON - while placing an object
        Cancels the current drawing or placement mode.  Identical to ESC.

  LEFT BUTTON
        Draws, selects, and works every control.  Objects are drawn by
        pressing and holding the left button, dragging the shape out as a
        pink "rubber band" outline, then releasing where you want it.

  TOOLBOX AND COLOR PICKER
        Both float over the drawing.  Drag either one by the middle of the
        dark grey bar across its top - that is the only place they can be
        picked up.  The small grey square in the upper left corner of each
        one makes it disappear.

        To get the Toolbox back, press TAB, or click the part of the
        status bar that shows the current tool.  To get the Color Picker
        back, click the three colored rectangles on the status bar.

        You may draw straight over the top of either box, so long as the
        object STARTS somewhere else.  The box flashes and reappears.

  STATUS BAR (along the bottom)
        Font name .......... opens the font and size dialog
        B / I / U / S ...... toggle Bold, Italic, Underline, Strikeout
        Fill pattern box ... opens the Fill Pattern Editor
        Line style box ..... opens the Line Style Editor
        Grid icon .......... turns Grid Snap on and off, and opens the
                             Grid Snap editor
        Double triangles ... redraws the screen
        Single triangle .... redraws at a chosen baud rate, so you can
                             preview the scene at the speed a caller sees
        Question mark ...... help for the current drawing mode
        Box at far right ... cycles the coordinate readout between World
                             coordinates, Video coordinates and off

  EDIT MODE  (the arrow icon on the Toolbox)
        Click the EDGE of an object to select it.  A boundary rectangle
        with control points appears.  Drag a control point to resize, or
        drag from the middle of the rectangle to move it.  Hold SHIFT and
        click to add or remove objects from the selection.  Drag a
        rectangle around several objects to select them as a group.

  MODIFIER KEYS WHILE DRAWING
        SHIFT   Line ....... forces the line perfectly horizontal or
                             vertical
                Rectangles . forces a square (also rounded rectangles)
                Point ...... hold SHIFT with the left button for freehand
                             drawing (use sparingly - it makes very large
                             files)

        CTRL    Rectangles . centers the shape on the point you started
                             from, which makes nesting shapes easy
                Point ...... draws a single pixel, ignoring line thickness

        Either key may be pressed or released at any time before you let
        go of the left mouse button, and the shape changes to match.

-------------------------------------------------------------------------------

KEYBOARD SHORTCUTS
------------------

  Files and scenes
        ALT-L ........ Load a .RIP file
        ALT-S ........ Save the current scene
        ALT-N ........ New scene (clears what is in memory)
        ALT-T ........ Load a text file into the current article
        ALT-0 (zero) . Insert a Text Variable, e.g. $D(60)$ for a delay

  Editors, tools and placement
        TAB .......... Show / hide the Toolbox
        F2 ........... Edit the selected object's attributes
        F3 ........... Font Selector
        F4 ........... Line Style Editor
        F5 ........... Fill Pattern Editor
        F9 ........... Place a BMP or icon        (also CTRL-ALT-B)
        SHIFT-F9 ..... Place a photo              (also CTRL-ALT-H)
        ALT-F9 ....... Attach a sound (.WAV file)
        DELETE ....... Delete the selected object(s)
        ESC .......... Leave the current placement mode (same as clicking
                       the right mouse button)

  Articles and columns  (multi-column text)
        SHIFT-F3 ..... Choose which article to work on (1 to 35)
        SHIFT-F4 ..... Drag out a new column for the current article
        ALT-F6 ....... Show the column outlines if you cannot see them
        SHIFT-F1 ..... End the current article

  Mouse limits  (restrict where RIPaint accepts clicks, like Grid Snap)
        ALT-F1 ....... Set the left border
        ALT-F2 ....... Set the right border
        ALT-F3 ....... Set the top border
        ALT-F4 ....... Set the bottom border
        ALT-F5 ....... Reset all borders back to the full screen

        Drag the blue line to where you want the edge, then hit ESC.

-------------------------------------------------------------------------------
