home *** CD-ROM | disk | FTP | other *** search
/ TopWare 18: Liquid / Image.iso / liquid / top2186 / tombart.doc < prev    next >
Text File  |  1993-08-28  |  23KB  |  535 lines
  1.  
  2.         ******                Tombstone Artist, version 1.5
  3.      ***      ***             A RIPscrip Drawing Utility.
  4.    **            **
  5.   **  Here Lies   **
  6.   *                *          Copyright 1993 Jonathan and Steven Lang
  7.   *  TOMBSTONE     *
  8.   *        ARTIST  *
  9.   *      1.5       *
  10.   *                *
  11.   *     R I P      *          RIPscrip is a trademark of
  12.   ******************          TeleGrafix Communications, Inc.
  13.  
  14.                              ---------------------
  15.                              - Table of Contents -
  16.                              ---------------------
  17.  
  18.      Introduction
  19.           Licensing and Distribution . . . . . . . . . . . . . . . . 3
  20.           Overview . . . . . . . . . . . . . . . . . . . . . . . . . 3
  21.           Features . . . . . . . . . . . . . . . . . . . . . . . . . 3
  22.  
  23.      Getting Started
  24.           Requirements . . . . . . . . . . . . . . . . . . . . . . . 4
  25.           Installation . . . . . . . . . . . . . . . . . . . . . . . 4
  26.           Getting Around . . . . . . . . . . . . . . . . . . . . . . 4
  27.           Command Line Options . . . . . . . . . . . . . . . . . . . 4
  28.  
  29.      Using Tombstone Artist  
  30.           Draw Color and Fill Color  . . . . . . . . . . . . . . . . 5
  31.           Line Style and Fill Style  . . . . . . . . . . . . . . . . 5
  32.           Line, Multiline and Rays . . . . . . . . . . . . . . . . . 5
  33.           Bezier Curves and Arcs . . . . . . . . . . . . . . . . . . 5
  34.           Squares and Filled Squares . . . . . . . . . . . . . . . . 6
  35.           Polygons and Filled Polygons . . . . . . . . . . . . . . . 6
  36.           Circles and Filled Circles . . . . . . . . . . . . . . . . 6
  37.           Ovals and Filled Ovals . . . . . . . . . . . . . . . . . . 6
  38.           Flood Fill . . . . . . . . . . . . . . . . . . . . . . . . 6
  39.           Place Text . . . . . . . . . . . . . . . . . . . . . . . . 7
  40.           Put Pixel  . . . . . . . . . . . . . . . . . . . . . . . . 7
  41.           Copy and Paste . . . . . . . . . . . . . . . . . . . . . . 7
  42.           Mouse Regions  . . . . . . . . . . . . . . . . . . . . . . 8
  43.           Mouse Buttons  . . . . . . . . . . . . . . . . . . . . . . 8
  44.           Palette Editing  . . . . . . . . . . . . . . . . . . . . . 9
  45.           Save RIP . . . . . . . . . . . . . . . . . . . . . . . . . 9
  46.           Load RIP . . . . . . . . . . . . . . . . . . . . . . . . . 9
  47.           Clear  . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  48.           Undo . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  49.           Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  50.  
  51.      Support, Registration and Credits
  52.           How to contact us  . . . . . . . . . . . . . . . . . . .  10
  53.           Registration . . . . . . . . . . . . . . . . . . . . . .  10
  54.           Credits  . . . . . . . . . . . . . . . . . . . . . . . .  10
  55.  
  56.                                ----------------
  57.                                - Introduction -
  58.                                ----------------
  59.  
  60. Licensing and Distribution
  61. --------------------------
  62.      Tombstone Artist is a copyrighted program.  It has been released for
  63. distribution as shareware.  Considerable work has gone into developing this
  64. program.  You are granted a license to try Tombstone Artist for an evaluation
  65. period not to exceed one month.  If, after this time, you find that Tombstone
  66. Artist is useful and you intend to continue using it, then you are expected
  67. to register it.
  68.      The registration fee is $30.  This will legally allow you to continue
  69. to use Tombstone Artist beyond the trial period, and it will entitle you to
  70. program support.  Registration will also remove the registration messages.
  71. Please see the registration form that was included in this archive to
  72. register Tombstone Artist.
  73.      Sysops are encouraged to post Tombstone Artist online for downloading
  74. by their users.
  75.      Tombstone Artist may be uploaded to commercial and hobby boards provided
  76. that no fee is charged to download Tombstone Artist, except for fees to
  77. subscribe to the board.  Anyone distributing the archive in any form is
  78. requested to do so without modifying the copyright notices, and to pass the
  79. archive on intact, to ensure that those who receive the file will receive all
  80. the included files.  A listing of all the files in the archive may be found
  81. in a separate file, included in this archive.
  82.      The documentation may not be modified by users, nor may the program and
  83. the documentation be separated when it's distributed.  Printed or photocopies
  84. of the documentation may not be sold without the written permission of the
  85. authors.
  86.      No person, other than the authors, may accept payment or royalties for
  87. this program.
  88.      This license to use Tombstone Artist does not include the right to sell
  89. Tombstone Artist for a fee.  
  90.  
  91.  
  92. Overview
  93. --------
  94.      Tombstone Artist was written because we saw a need for a good shareware
  95. RIPscrip drawing program.  All the ones we had seen were crippled, or just
  96. were insufficient.  So, we got a copy of the RIPscrip Protocol, and this is 
  97. the result.  Our intent was to write a RIPscrip Drawing program that wasn't
  98. crippled, and supported most of the RIPscrip command set, including mouse
  99. regions and buttons support.
  100.  
  101.  
  102. Features
  103. --------
  104.      o Ability to Load and Save RIPscrip files.
  105.      o Full drawing commands, including lines, squares, circles,
  106.        polygons, and more!
  107.      o Palette editing.
  108.      o Mouse Regions and Areas.
  109.      o Custom line and fill styles.
  110.      o Undo/Redo.
  111.  
  112.  
  113.  
  114.      Tombstone Artist 1.5                                            Page 3
  115.  
  116.                               -------------------
  117.                               - Getting Started -
  118.                               -------------------
  119.  
  120. Requirements
  121. ------------
  122.      Tombstone Artist requires at least an EGA display with 256k of video 
  123. memory and approximately 384k of system memory free.  Less memory, and you 
  124. may not be able to Undo, use Copy and Paste, or use the fonts.  Tombstone
  125. Artist also requires DOS 3.0 or greater to run, and a microsoft compatable
  126. mouse.  To view Simplex, Complex, Triplex Script, Script, European, Bold
  127. Outline, the user needs RipTerm 1.53+ or compatable.  The other fonts will
  128. work in all the versions.
  129.  
  130.  
  131. Installation
  132. ------------
  133.      Installing is extremely simple.  Create a directory where you wish to
  134. install Tombstone Artist, and copy all the files to it.  Then, create a
  135. subdirectory under that called FONTS, and copy all the .CHR files to it.
  136. To save yourself harddrive space, you may stick Tombstone Artist in your
  137. RipTerm directory, and it will use the same font files as RipTerm uses.
  138. When you run Tombstone Artist, if the subdirectory RIP doesn't exist, then
  139. it will create it for you.  When you load and save rip files, and don't
  140. provide a path, then Tombstone Artist will automatically assume you want to
  141. use the RIP subdirectory.
  142.      To make installing Tombstone Artist easier, a batch file has been
  143. included to move all the files to whatever directory you wish.
  144.  
  145. Getting Around
  146. --------------
  147.      Getting around inside of Tombstone Artist is easy.  The program uses a 
  148. simple to learn set of buttons you can click on with your mouse.  The menus 
  149. are really simple and their meaning is clear, and they are available at the 
  150. bottom of your screen.  But, when you want to use the full screen to draw, you
  151. can scroll the menus off and on by hitting the <ESC> key.
  152.  
  153. Command Line Options
  154. --------------------
  155.      -N . . . Bypass the title screen.
  156.      -S#  . . Set Scroll Speed to # (1 is slowest, 9 is fastest, 0 is off)
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.      Tombstone Artist 1.5                                            Page 4
  175.  
  176.                           --------------------------
  177.                           - Using Tombstone Artist -
  178.                           --------------------------
  179.  
  180. Draw Color and Fill Color
  181. -------------------------
  182.      The Draw Color is the color that drawing is done in, and for filled areas,
  183. is also the border color.  The Fill Color is the color used by all the filled
  184. draw commands to fill the areas.  When you click on the colors, their buttons
  185. are depressed.
  186.  
  187.  
  188. Line Style and Fill Style
  189. -------------------------
  190.      The Line Style command changes the width and style of the lines that are
  191. drawn.  Clicking on the question mark button will bring up a menu allowing you
  192. to create your own line styles.  All lines drawn will be in the current line
  193. style, including borders.  Fill Style allows you to change the styles of the 
  194. fills done using all the fill commands.  Clicking on the question mark button 
  195. will again bring up a eight by eight grid which you can create a custom fill 
  196. style with.  All future fill commands will use the current fill style.
  197.  
  198.  
  199. Line, Multiline and Rays
  200. ------------------------
  201.      These three commands are essentially the same.  Line is the standard line
  202. command.  It lets you draw a line from one point to a second point on the 
  203. screen.  Multiline is an extension of line that will then let you place 
  204. additional points, and the line will be continued from one point to the next.
  205. Rays are work the same way, except that all the lines you place will meet at
  206. the first point you chose.  All lines drawn will be in the current draw color
  207. and line style.
  208.  
  209.  
  210. Bezier Curves and Arcs
  211. ----------------------
  212.      Bezier Curves are a powerful drawing tool.  With just four points, you
  213. can define a variety of curves and loops.  To create a Bezier Curve, click
  214. on the Bezier Curve button and draw a line from where the curve should start,
  215. to where it should end.  Once you draw the line, two crosses will appear, one
  216. on each end of the line.  These are the middle two points.  They can be moved
  217. around by clicking near the one you wish to move, and moving it while holding
  218. down the left mouse button.  Once you have a curve you like, you can press
  219. the right mouse button to place it.  If you click on the Bezier Curve button
  220. when it is already active, a slidebar will appear allowing you to change the
  221. number of segments that are used to make the Bezier Curve, from 2 to 500.
  222. 100 is recommended for most uses, above that can be slow on some systems.
  223. Certain line styles do not work with Bezier Curves.  You can still draw the
  224. curve, but your result may range from nothing to a line that fades across the
  225. curve.
  226.      Arcs are a more basic tool then Bezier Curves, but they have their uses,
  227. too.  To draw an arc, first mark the center of the arc by clicking the left 
  228. mouse button.  You will then be able to adjust the size of a circle.  Click 
  229. where you wish your arc to begin with the left mouse button, then move the 
  230. mouse to where you wish it to end, and click again.  The arc will be drawn
  231. counterclockwise from the first point to the second one.  You now have an arc.
  232.  
  233.  
  234.      Tombstone Artist 1.5                                            Page 5
  235.  
  236.                        ---------------------------------
  237.                        - Using Tombstone Artist (cont) -
  238.                        ---------------------------------
  239.  
  240. Squares and Filled Squares
  241. --------------------------
  242.      The square command will let you place a square on the screen.  Ordinary
  243. squares are simple outlines using the current draw color and line style.  
  244. Filled Squares are solid squares using the current fill color and fill style, 
  245. but are not outlined.  (This is due to RIPscrip, not an error in the program)
  246.  
  247.      
  248. Polygons and Filled Polygons
  249. ----------------------------
  250.      Polygons and filled polygons allow you to make shapes with up to 512 
  251. sides.  Polygons are drawn the same way as multilines, you place a series of
  252. points and lines are drawn from one to another.  Ordinary polygons are drawn in
  253. the current draw color and line style.  Filled polygons are filled in the 
  254. current fill color and fill style, and outlined in the current draw color and
  255. line style.
  256.  
  257.  
  258. Circles and Filled Circles
  259. --------------------------
  260.      Circles and Filled Circles allow you to place circles on the screen.
  261. When placing the circle, you are provided with a square box that shows the
  262. top, bottom, left and right sides of the circle.  The circle itself isn't
  263. drawn until you have it the size you want.  Circles are drawn in the current
  264. draw color and line style.  Filled circles are filled in the current fill
  265. color and fill style, and outlined in the current draw color and draw style.
  266.  
  267.  
  268. Ovals and Filled Ovals
  269. ----------------------
  270.      Ovals and Filled Ovals are the same as circles, except that the you are
  271. not limited to perfect circles.
  272.  
  273.  
  274. Flood Fill
  275. ----------
  276.      Fill will fill an area of the screen in the current fill color and fill
  277. style.  
  278.      NOTE:  Unlike most paint programs, fill does not fill one color with
  279. another.  Instead, fill will fill a section surrounded by one color with
  280. another.  Fill will fill up to the current draw color.  Fill will not fill
  281. beyond the current draw color.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.      Tombstone Artist 1.5                                            Page 6
  295.  
  296.                        ---------------------------------
  297.                        - Using Tombstone Artist (cont) -
  298.                        ---------------------------------
  299.  
  300. Place Text
  301. ----------
  302.      Clicking on place text will bring up a menu allowing you to enter the text
  303. to place, and select a font, size and orientation.  (horizontal or vertical)  
  304. When you have text entered, and are on the drawing screen, the mouse cursor
  305. will change into a box the size of the text, allowing you to place as many
  306. copies of it as you want wherever you want in the current draw color.  If you
  307. already have text to place, and you click on the place text button, the menu will
  308. not pop-up, but instead you can place more text on the screen.  Clicking on it a
  309. second time will bring the menu back up.  
  310.      NOTE:  You can not place the 8x8 block font vertically.  Also, you may not
  311. be able to place text at the top of the screen.  Again, this is due to 
  312. RIPscrip, not an error.  Also, the fonts Simplex, Complex, Triplex Script,
  313. Script, European and Bold Outline require that the user has RipTerm 1.53+ or
  314. compatable.
  315.  
  316.  
  317. Put Pixel
  318. ---------
  319.      Put Pixel allows you to place one pixel at a time in the current draw
  320. color.  Holding down the mouse button will not keep putting pixels.  As placing
  321. individual pixels is very inefficient, due to the way RIPscrip works, it is
  322. not suggested that you use this command much, but it's included for 
  323. completeness.
  324.  
  325.  
  326. Copy and Paste
  327. --------------
  328.      Two commands that should prove to be extremely useful are copy and paste.
  329. Clicking on the copy (scissors) button will allow you to copy a section of the
  330. screen into the clipboard buffer.  You are limited to 64k (a little over half
  331. of the screen)  Paste allows you to paste the clipboard image to the screen.
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.      Tombstone Artist 1.5                                            Page 7
  355.  
  356.                        ---------------------------------
  357.                        - Using Tombstone Artist (cont) -
  358.                        ---------------------------------
  359.  
  360. Mouse Regions
  361. -------------
  362.      Mouse Region are among a few of the commands that make RIPscrip so 
  363. powerful.  Because of this, they are a little more complicated then other
  364. commands.  When you click on the mouse regions button, you are given a menu.
  365. From this menu, you have three options: Del, Add and OK.  Del will delete the
  366. currently selected button.  Add will give you the drawing screen again, and you
  367. will be allowed to draw a box on the screen.  This box is the Mouse Region,
  368. they are displayed as a box with numbers in the center telling which one it is.
  369. When you are not in the mouse regions menu, these boxes won't be visible.  The
  370. box defines an area for that mouse region.  A mouse click inside the box will
  371. cause that boxes Host Command to be sent.  When two boxes overlap, the topmost
  372. one is used.  After defining the region, you will be given the menu again, 
  373. where you can define the Host Command.  The Host Command is the command sent to
  374. the BBS when the users clicks in this region.  Any text you type while in the
  375. mouse regions menu goes into the current regions Host Command.  Control
  376. characters appear in white on blue, while normal characters appear as white on
  377. black.  (So, to send the command M<return> you could enter either M<enter> or
  378. M^M.  And, it will be displayed as a white on black M, and a white on blue M)
  379. You can change whether a region is reversed when it is clicked by clicking on
  380. the 'visibly inverted' button.  The default is that the regions will be 
  381. inverted when they are clicked on.  All defined mouse regions are listed in a
  382. selection box on the left of the menu, and you can change the command you're
  383. editing by clicking on the up and down arrows.  The final menu command, OK, 
  384. will simply leave the menu.  You will need to select a drawing tool before you 
  385. can draw again.
  386.  
  387.  
  388. Mouse Buttons
  389. -------------
  390.      Mouse Buttons are similar to Mouse Regions, and like the Mouse Regions,
  391. are a very important part of RIPscrip.  The work exactly like Mouse Regions,
  392. except that they will draw a beveled button with text on it, and have hotkeys.
  393. Unlike when you place a Mouse Region, an actual button will be displayed, with
  394. it's number on it.  The user won't see the number on it, instead they will see
  395. the button's label.  Like Mouse Regions, the buttons will disappear when you
  396. are doing anything other than Mouse Buttons.  The buttons are visible to the
  397. user, but to avoid them being written over, they are placed at the end of the
  398. rip file.  The commands in the Mouse Button menu work the exact same as those
  399. in the Mouse Regions menu, with one noticeable difference.  Where there is only
  400. one text field in the Mouse Regions menu (Host Command) there are three in the
  401. Mouse Buttons menu.  The Host Command is again the string that is sent to the
  402. BBS when the Button is clicked on.  The Label is the text that is displayed on
  403. the button, and the Hotkey is the key that the user can press to select that
  404. button.  (The hotkey is highlighted when the buttons are displayed)  You can
  405. move between these three fields by pressing the TAB key, or by clicking on
  406. one of the other strings with the mouse.
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.      Tombstone Artist 1.5                                            Page 8
  415.  
  416.                        ---------------------------------
  417.                        - Using Tombstone Artist (cont) -
  418.                        ---------------------------------
  419.  
  420. Palette Editing
  421. ---------------
  422.      Clicking on the Edit Palette Button will bring up a menu of the current
  423. palette, each color with it's number over it, and up and down arrows.  To
  424. change a palette entry, click on the color to change, and the just click the
  425. up or down arrows to change that color.  To reset the palette to normal, click
  426. on the RST (RESET) button.  To undo the current changes, but keep your old
  427. custom palette, click ABT (ABORT), otherwise click OK when you're done to use
  428. the palette you've made.
  429.  
  430.  
  431. Save RIP
  432. --------
  433.      This will save the current screen as a RIP file.  You will be asked for
  434. the filename, which can include the drive and path.  If you do not supply a
  435. path, then it will be assumed that you wish to save the file to the RIP
  436. subdirectory.  If you don't supply an extension, then .RIP will be used.  If
  437. the file already exists, then you will be asked whether or not to overwrite it.
  438. You can also save a RIP file by pressing "S".
  439.  
  440.  
  441. Load RIP
  442. --------
  443.      This will load a RIP file for editing.  You will be asked for a filename,
  444. which can include the drive and path.  If no path is specified, then the RIP
  445. subdirectory will be assumed, and if no extension is supplied, .RIP will be
  446. used.  If the file doesn't exist, you will be given an error message.
  447. You can also load a RIP file by pressing "L".
  448.  
  449.  
  450. Clear
  451. -----
  452.      Clear will clear the current screen.  If it isn't saved, it will ask if
  453. you wish to save it first.  The Draw Color, Fill Color, Line Style and Fill
  454. Style will all be reset, and all the Mouse Regions and Buttons will be erased.
  455. You can also clear the screen by pressing "C".
  456.  
  457.  
  458. Undo
  459. ----
  460.      The standard undo.  If you make a mistake, undo will remove it.  If you're
  461. short on memory, you may not be able to use undo on everything.  After undoing
  462. something, you can change the colors and styles, and then click undo again, and
  463. undo will redo what you just did with the new settings.  The Load and Save
  464. commands will both erase the undo buffer, and you won't be able to undo after
  465. using these commands.  You can also undo by hitting "U".
  466.  
  467.  
  468. Quit
  469. ----
  470.      Exits Tombstone Artist.  If the current file isn't save, it will ask you
  471. if you wish to save it first.  You can also quit by hitting "Q".
  472.  
  473.  
  474.      Tombstone Artist 1.5                                            Page 9
  475.  
  476.                        ---------------------------------
  477.                        Support, Registration and Credits
  478.                        ---------------------------------
  479.  
  480. How to contact us
  481. -----------------
  482.      Steven can be contacted as Steven Lang @ 1:125/233 (Fidonet)
  483.      Or you can contact Jonathan Lang through either the Fidonet Shareware 
  484.      Echo or the ILink Shareware Conference
  485.  
  486.      You can also send Snail-Mail to:
  487.      Steven Lang
  488.      1542 Pleasant Lane
  489.      Lafayette, Ca. 94549-2215
  490.  
  491.  
  492. How to Register
  493. ---------------
  494.      If you find this program to be useful, it would be appreciated if you
  495. would register it.  Registering helps keep the shareware idea alive.  
  496. Registering is only $30.  For more info on how to register, please see
  497. REGISTER.DOC.
  498.  
  499.  
  500. Credits
  501. -------
  502.      Special Thanks to John Friel for the Bezier Curve source code and
  503. Bob Martin for spotting the Bezier Curve source code and forwarding it to us. 
  504. Also to Nancy H. Miller for helping distribute Tombstone Artist, and to 
  505. Morgan McConnell for reporting a major bug with the mouse button routines.
  506.  
  507.      RIPscrip, RIPaint, RIPdraw, and RIPterm are trademarks of TeleGrafix
  508. Communications, Inc.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.      Tombstone Artist 1.5                                            Page 10
  535.