home *** CD-ROM | disk | FTP | other *** search
/ Game Developers Magazine 1 / GDM001.ZIP / TPAINT.DOC < prev    next >
Text File  |  1993-07-01  |  13KB  |  381 lines
  1.  
  2.  
  3.  
  4.                                 - TEXT PAINT -
  5.                                      (TM)
  6.                                      v1.2
  7.  
  8.  
  9.                       Copyright (c)  1993  Kevin Solway
  10.  
  11.  
  12.         DESCRIPTION:
  13.  
  14.         Text Paint is a text-based paint program which can produce plain
  15.         or multi-coloured text screens, and supports 43/50 line modes on
  16.         EGA/VGA systems.  This program is ideal for those times when you
  17.         need to provide relatively simple diagrams or pictures without
  18.         the memory and time overheads associated with more detailed
  19.         graphic images.  Also creates slide shows which you can
  20.         distribute.  Text Paint will only work on systems equipped with
  21.         a mouse.  Text Paint comes with the program Text Capture to
  22.         capture screen images in full colour for editing with Text Paint.
  23.  
  24.         Text Paint files can be incorporated into "Bigtext" document
  25.         files.  Bigtext (by the same author) creates self-displaying
  26.         books with illustrations.
  27.  
  28.  
  29.  
  30.  
  31.         A NOTE ON USER-SUPPORTED SOFTWARE:
  32.  
  33.         The user supported software concept (usually referred to as
  34.         shareware) is an attempt to provide software at low cost.  The
  35.         cost of offering a new product by conventional means is
  36.         staggering, and hence dissuades many independent authors and
  37.         small companies from developing and promoting their ideas.  User
  38.         supported software is an attempt to develop a new marketing
  39.         channel, where products can be introduced at low cost.
  40.  
  41.         If user supported software works, then everyone will benefit.
  42.         The user will benefit by receiving quality products at low cost,
  43.         and by being able to "test drive" software thoroughly before
  44.         purchasing it.  The author benefits by being able to enter the
  45.         commercial software arena without first needing large sources of
  46.         venture capital.
  47.  
  48.         But it can only work with your support.  We're not just talking
  49.         about Text Paint here, but about all user supported software.
  50.         If you find that you are still using a program after a couple of
  51.         weeks, then pretty obviously it is worth something to you, and
  52.         you should send in a contribution.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                   - USAGE -
  59.  
  60.  
  61.         To run the program:
  62.  
  63.           From the DOS prompt, type TPAINT then press Enter.  Text Paint
  64.           will only work on systems equipped with a mouse.
  65.  
  66.           Also, you can enter a file to edit from the command line:
  67.  
  68.                               for example,
  69.  
  70.                               tpaint filename.scr
  71.  
  72.  
  73.  
  74.         Help:
  75.  
  76.           Pressing F1 from inside Text Paint will display a help screen
  77.         with all the essential instructions.
  78.  
  79.  
  80.  
  81.         To draw:
  82.  
  83.           Hold the left button of the mouse down and drag the cursor
  84.         (the pen) around the screen.
  85.  
  86.           To draw on the very bottom line of the screen (below the menu
  87.         options) you can drag then pen onto the bottom line while
  88.         drawing, or hold down the RIGHT button of the mouse.
  89.  
  90.  
  91.  
  92.         Select pen type:
  93.  
  94.           Click on "Pen" to select the pen style, then clicking on the
  95.         character you want.  Clicking on a space between the characters
  96.         will select the space character.
  97.  
  98.           The currently selected pen type is coloured bright white.
  99.  
  100.  
  101.  
  102.         Pen Colour:
  103.  
  104.           Click on "Pen col" to select drawing colour (both background
  105.         and foreground).  Background colours range vertically from 1..16
  106.         while foreground colours range horizontally from 1..16.
  107.  
  108.           The currently selected colour is indicated with an asterix.
  109.  
  110.  
  111.  
  112.         Background Colour:
  113.  
  114.           Click on "B/g col" to change the original page colour.  All
  115.         occurances of that background colour (whether they were part of
  116.         the original page, or whether they have been drawn) will be
  117.         converted to the new background colour.
  118.  
  119.  
  120.  
  121.         Load:
  122.  
  123.           Load a previously saved screen, or any standard ascii text
  124.         file into Text Paint for viewing or editing.
  125.  
  126.           Any standard ascii text file can be loaded, and then saved as
  127.         a Text Paint file.  But be warned: Text paint may not be able to
  128.         load all of the lines of larger files, so if you save the file
  129.         under the same name then text will be lost from the original
  130.         file.
  131.  
  132.  
  133.  
  134.         Save:
  135.  
  136.           Saves work to disk.  If you do not provide an extension then
  137.         an extension of .SCR will automatically be appended to the file.
  138.         For example, if you type a file name of MYFILE then the file
  139.         will be saved as MYFILE.SCR
  140.  
  141.           You can save the file in colour format or plain format.  The
  142.         only value of saving screens in plain format is if your screens
  143.         are likely to viewed on mono monitors.  Colour screens will
  144.         sometimes look messy on a mono monitor.  A compromise is to save
  145.         screens in colour format, but to use a black background which
  146.         will provide good contrast on mono monitors.
  147.  
  148.  
  149.  
  150.         New:
  151.  
  152.           Clear the current screen and start a new drawing.  If the
  153.         current screen has been changed then you will be prompted to
  154.         save it before it is cleared.
  155.  
  156.  
  157.  
  158.         Erase:
  159.  
  160.           Sets the cursor working as an eraser by setting the pen style
  161.         to that of a space.
  162.  
  163.  
  164.  
  165.         Overwriting with different colours or pen style:  
  166.  
  167.           Pressing Alt-C will cause overwriting of what is on the screen
  168.         with a new colour, but preserves the pen character.  Alt-P will
  169.         cause overwriting of what is on the screen with a new pen, but
  170.         preserving the colour.
  171.  
  172.           When colour overwriting is on, a white "O" will appear after
  173.         "col" on the bottom line of the screen.  Similarly, when pen
  174.         overwriting is on this is indicated by a white "O" after the
  175.         word "Pen".
  176.  
  177.           Of course, when both colour overwriting and pen overwriting
  178.         are on, this is the same as normal drawing mode.
  179.  
  180.  
  181.  
  182.         Fill:  - also, change colours or characters of areas.
  183.  
  184.           To fill an area of the screen with the currently selected pen
  185.         style and colour, click on "Fill" then click on the area you
  186.         wish to fill.  You can fill any pen/colour combination with
  187.         another pen/colour combination.
  188.  
  189.           If you want to change the colour of an area of the screen, but
  190.         want to preserve the pen style (eg, the colours surrounding some
  191.         text) then press Alt-C for "colour overwriting" (see above)
  192.         before you select "Fill". 
  193.  
  194.           If you want to change the characters but want to preserve the
  195.         colours of an area, press Alt-P to enable "pen overwriting"
  196.         before you select "Fill". 
  197.  
  198.  
  199.  
  200.         Undo:
  201.  
  202.           This function undoes the last piece of work - up to 10 levels.
  203.         Keep pressing Undo to return to your original work.
  204.  
  205.  
  206.  
  207.         Box:
  208.  
  209.           To draw a box on the screen, firstly click on "Box" then click
  210.         on the screen where you want the corner of the box.  Keep
  211.         holding the left button down while you drag (rubber band
  212.         fashion) the box to the shape you want.
  213.  
  214.           Special feature: if the "pen" character is a line drawing
  215.         character, then a box will be specially designed using the
  216.         appropriate line drawing characters for corners etc.
  217.  
  218.  
  219.  
  220.         Text:
  221.  
  222.           To type text into your picture, firstly click on "Text" then
  223.         click on the number of the font you desire.  Then click where
  224.         you want to begin typing.  Press Enter to accept what you have
  225.         typed or press Escape to cancel it.  Undo will erase any text
  226.         you type so you can get the positioning correct.
  227.  
  228.  
  229.  
  230.         Lines:
  231.  
  232.           Select "Lines" then draw lines around the screen by holding
  233.         the left button down, as you do with normal drawing.
  234.  
  235.  
  236.  
  237.         Special select colour and pen style:
  238.  
  239.           If you can see a character or a colour on the screen that you
  240.         want to use, then rather than selecting them from the "Pen" and
  241.         "Pen colour" menus, it is often faster to use the following
  242.         short-cut:
  243.  
  244.           Position the cursor on the character, then press "C" to grab
  245.         its colour, "P" to grab its pen style, or "B" to grab both its
  246.         colour and pen style.
  247.  
  248.                            That is:  "C"olour
  249.                                      "P"en
  250.                                      "B"oth
  251.  
  252.  
  253.  
  254.         Condensed lines on EGA/VGA:
  255.  
  256.           If you have an EGA or VGA system then a small arrow will
  257.         appear at the bottom right corner of the screen.  Clicking on
  258.         this arrow will switch between 25 line mode and 43/50 line mode.
  259.  
  260.  
  261.  
  262.         Viewing the entire picture:
  263.  
  264.           Hold down the right mouse button to remove the bottom menu
  265.         line for viewing the full picture.
  266.  
  267.  
  268.  
  269.         VIEW.EXE to view Text Paint files:
  270.  
  271.           VIEW.EXE is a small program whose sole task is to display the
  272.         screens you create with Text Paint.  Registered users of Text
  273.         Paint can distribute this program to other parties to display
  274.         their Text Paint files.
  275.  
  276.           For example if you have a saved text screen called picture.scr
  277.         then you would issue the command:
  278.  
  279.                           view picture.scr
  280.  
  281.                        or view picture    (view.exe will assume picture.scr)
  282.  
  283.           The picture will be displayed until a key is pressed.
  284.  
  285.           Alternatively you can make view display a picture for only a
  286.         few seconds with the command:
  287.  
  288.                     view picture.scr 3000  (displays for 3000 milliseconds)
  289.                                                            = 3 seconds
  290.  
  291.           Using this feature you can create your own slide shows by
  292.         displaying a number of screens from (say) a batch file.  Using
  293.         the program BAT2EXEC.COM you can turn these batch files into
  294.         .COM files.
  295.  
  296.           If your screen images have more than 25 lines then VIEW will
  297.         automatically switch to condensed line mode on EGA/VGA systems
  298.         to display the picture.
  299.  
  300.  
  301.  
  302.         * Better still - BIGTEXT *
  303.  
  304.           Better than using VIEW.EXE to display your screens is BIGTEXT.
  305.         This program (also written by myself) creates self-displaying
  306.         books with illustrations.
  307.  
  308.           Bigtext can convert big text files of up to 700k or more into
  309.         executable self-displaying text programs that fit on a 360k
  310.         disk.  Complete with menus, searching and printing, Bigtext is
  311.         great for books, catalogues, reports and manuals.  Importantly,
  312.         Bigtext can display Text Paint files in full colour, integrated
  313.         seemlessly into the text.  Bigtext can also execute other
  314.         programs from within the text, so you can have complex VGA
  315.         graphic illustrations as well.
  316.  
  317.  
  318.  
  319.         TCAPTURE - Text Capture
  320.  
  321.           Text Capture (which accompanies Text Paint) is a memory
  322.         resident program that can capture text screen images - IN FULL
  323.         COLOUR - from other programs.  These images can then be viewed
  324.         and edited with Text Paint.
  325.  
  326.  
  327.   ************************************************************************
  328.  
  329.  
  330.  
  331.         LICENCE:
  332.  
  333.  
  334.         Copyright (c) 1993    Kevin Solway.      All rights reserved.
  335.  
  336.             This program is provided AS IS without warranty, expressed
  337.         or implied.
  338.  
  339.             This program is in the public domain.  Users are encouraged
  340.         to make as many copies as they like and to distribute them to
  341.         whoever they choose.
  342.  
  343.             Under no circumstances is this program to be sold, except
  344.         where clubs distribute programs without profit.
  345.  
  346.             If the program Text Paint does not accompany this program
  347.         then registered copies are available from me for $10.
  348.  
  349.  
  350.                         Suggestions are welcome.
  351.  
  352.                         Kevin Solway,
  353.                         PO Box 207
  354.                         St Lucia  4067
  355.                         AUSTRALIA
  356.  
  357.  
  358.   ************************************************************************
  359.  
  360.  
  361.  
  362.     ---------------------------------------------------------------------
  363.  
  364.         LICENCE/REGISTRATION:
  365.  
  366.           Full registration details in the file TPORDER.DOC
  367.  
  368.           Registration for Text Paint costs $10 but is FREE when you
  369.         register Bigtext for $30.
  370.  
  371.  
  372.                                Kevin Solway
  373.                                PO Box 207
  374.                                St Lucia 4067
  375.                                Australia
  376.  
  377.  
  378.     ---------------------------------------------------------------------
  379.  
  380.  
  381.