home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff258.lzh / DMouse / dlineart.doc < prev    next >
Text File  |  1989-10-18  |  7KB  |  182 lines
  1.  
  2.     Is your computer BORED? If so, then you need...
  3.  
  4.         DLineArt, by Steve -Raz- Berry with help
  5.         from Matt Dillon.
  6.  
  7.     IF YOU ARE IMPATIENT WITH LONG WINDED README'S... skip to the section
  8. labeled Examples and try them out...
  9.  
  10.  This program must be used in conjunction with Dmouse 1.13, and is
  11.  intended to be a screen blanker replacement program. IT IS NOT
  12.  STAND ALONE. An earlier release of LineArt works without Dmouse.
  13.  
  14. 0) SHORT HISTORY
  15. ----------------
  16.  
  17.     This display hack does nothing usefull, but draw pretty lines on a
  18. custom screen. I have seen this program running on everything from Suns
  19. to Mac's, and I decided that it was time that one was done for the Amiga.
  20. Although similar to the lines demo distributed on Workbench 1.1 & 1.2,
  21. It does things on it's own screen in full 4096 color interlaced
  22. splendor :*).
  23.  
  24.     Matt Dillon liked it so much that he stitched in a way to
  25. add your own customized screen blanker via an IPC port. As soon as
  26. I found Dmouse 1.13, I took his example "blanker.c", and hacked it
  27. up to support LineArt graphics. I also fixed a few bugs and added a few
  28. more things along the way.
  29.  
  30.     When I first wrote this program, I was unaware of MACKIE written by
  31. Tom Rokicki, which draws the same kind of lines boxes and splines
  32. as part of a hot-key/screen-blanker type program. Undaunted (although
  33. somewhat embarassed) I proceeded to allow infinite customization
  34. to those who are bored enough to want to play with LineArt. Besides, I prefer
  35. DMOUSE (Thanks Matt!) for my hot-key handler. Don't get me wrong, I really
  36. like the way Tom does splines... In fact I stole his spline code and put
  37. it in (D)LineArt.
  38.  
  39. 1) TO GET DMOUSE TO RECOGNIZE DLineArt -
  40. --------------------------------------
  41.  
  42.     To make dmouse (v1.20+) use the DLineArt screen blanker instead of its
  43.     default blanker (a boring blank screen) simply run DLineArt after you
  44.     initialize dmouse.
  45.  
  46. ------------------------------------------------------
  47. stack 4000
  48. dmouse -a4 -m3 -s90 -l0003 -w1 -t7 -C NewWSH
  49. runback -1 DLineArt -a -n 3 -c2500 -l30
  50.  
  51. ------------------------------------------------------
  52.  
  53.     To terminate DLineArt do this:
  54.  
  55. raz's prompt> status
  56. Process  1: Loaded as command: dlineart
  57. Process  3: Loaded as command: status
  58. raz's prompt> break 1
  59.  
  60.  The break command will terminate DLineArt.
  61.  
  62.  Terminating DMouse (1> dmouse quit) will also terminate DLineArt.
  63.  
  64. 2) INVOCATION:
  65. -------------
  66.  
  67. There are a LOT of comand line options (for a program like this anyway)!
  68.  
  69.  You need to run DLineArt in the background for it to function properly.
  70.  You can enter the options in ANY order on the command line, and only the
  71.  last occurance of a particular switch will be used. The options are:
  72.  
  73.     run >nil: <nil: DLineArt -[b|t|n|e|c{0-4096}|l{2-1000}] [i]
  74.  
  75.  or use the PD 'runback' program to start DLineArt.
  76.  
  77.  The '-l' and '-c' options require an integer immediately following the
  78.  switch in the range indicated in the {}'s, without a space. Descriptions
  79.  and examples follow.
  80.  
  81.    Dlineart -t        - This leaves a trail (one out of every 'l' lines)
  82.               remains on the screen.
  83.  
  84.         -s        - Draw splines. Code blatently ripped off from Tomas
  85.               Rokicki's Mackie.
  86.  
  87.         "-Tstring"
  88.             - This option allows you to "bounce" words around the
  89.               screen. You MUST enclose quotes around the entire
  90.               string. This example will use "string". The default
  91.               is the string "BOING!"
  92.  
  93.         -n        - This is the 'nice' option, this makes LineArt much
  94.               more friendly in a multitasking environment
  95.               (It takes less CPU time.) It also slows things down.
  96.  
  97.         -cXXXX  - This switch allows you to specify the initial color
  98.               that the program will cycle from. Suggested color
  99.               values start from 1900 (decimal) and up.
  100.  
  101.         -lXXXX  - This switch allows you to specify the number of
  102.               lines to be drawn before the last one is erased.
  103.  
  104.         -b        - draw boxes (4 connected lines) instead of lines.
  105.  
  106.         i        - This is an integer between 1 and 9 that will change
  107.               the minimum distance between sucessive endpoints for
  108.               each line drawn. A high number will give the illusion
  109.               of unbelievable speed! (Woah... hold me down Toto!)
  110.  
  111.         -e        - Draw ellipses instead of anything else.
  112.               (I would be interested to see this run with an '020)
  113.  
  114.         -a        - Cycle through all of the available line (and circle)
  115.               types. This is a good loop mode.
  116.  
  117. The defaults (if you just type 'run lineart') are as if you entered:
  118.  
  119.  run <nil: >nil: DLineArt 3 -a -c1280 -l10 -TBOING!
  120.  
  121. 3) EXAMPLES:
  122. -----------
  123.  
  124.  Some of my favorites:
  125.  
  126.     runback DLineArt 4 -l100 -c2500 -n
  127.     runback DLineArt 1 -l10 -c2500
  128.     runback DLineArt 9 -l30 -c2500 -n
  129.     runback DLineArt 9 -l30 -c2500 -t
  130.     runback DLineArt 4 -l3 -c1500 -n
  131.     runback DLineArt -b -c2500 1 -l20
  132.     runback DLineArt -s -c2500 4 -l35
  133.     runback DLineArt "-TI love Teresa!" -c2500 9 -n -l20
  134.     runback DLineArt -e 7 -c1999 -l30
  135.  
  136.  For speed freaks -
  137.     run <nil: >nil: DLineArt 9 -c4000 -l7
  138.  
  139. 4) Miscelaneous:
  140. ---------------
  141.  
  142.     If you want to time the drawing speed (roughly) turn on the trailing option
  143.     and wait for the screen to clear. 60,000 lines would have been drawn in
  144.     this amount of time.
  145.  
  146.     I timed it at 2'7" (127 seconds) or 944 lines per second in line draw
  147.     mode. Using boxes it climbs to 2400 vectors per second. Not too shabby for
  148.     a game machine eh?
  149.  
  150. 5) Future improvements:
  151.  
  152.     It could be faster, if I use the screen's rastport instead of the
  153.     windows'. Unfortuneately, CED (which is an excellent editor) does not
  154.     co-exist with DLineart when doing this. I have no clue why this is so.
  155.     The only symptoms are that retrieving CED via hot-key produces an instant
  156.     GURU. And no, I am NOT drawing out of bounds of the rastport, you
  157.     should have seen the debugging code I put in to make sure of that!
  158.  
  159. ------------------------------------------------------------------------
  160.  
  161.    This program is PD. Use it or abuse it, only you will know.
  162.  
  163.     Steve -Raz- Berry        (Note the new address)
  164.     1260 Ayala Dr. #214
  165.     Sunnyvale, Ca. 94086
  166.  
  167.     UUCP: ...sun!kilowatt!raz    ARPA: raz%kilowatt.EBay@sun.com
  168.  
  169.     If you are on USENET, please feel free to use the archive server
  170.     on kilowatt. Just send a message of "send help" to the
  171.  
  172.         archive-server%kilowatt.EBay@Sun.com
  173.     or    {well bonded site}!sun!kilowatt!archive-server
  174.  
  175.     The archive has *all* of the binaries and sources that Bob Page
  176.     has posted and some from the days of Pat White. Currently this
  177.     totals to over 40 meg of stuff (zoo'ed and uuencoded).
  178.  
  179.    This program is a Public Domain product of The Checkered Ball 1989.
  180.  
  181.     8/07/89
  182.