home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 064.lha / LineDrawer / LineDrawer.doc < prev    next >
Text File  |  1986-11-20  |  2KB  |  54 lines
  1. This README file has been extracted from the comments in linedrawer.c, but
  2. has a few clarifications.
  3.  
  4. LineDrawer by John M. Olsen. V1.0 July 5, 1987
  5.  
  6. John M. Olsen
  7. 1547 Jamestown Drive
  8. Salt Lake City, UT  84121-2051
  9.  
  10. Network addresses:
  11. u-jmolse@ug.utah.edu  or  ...!{seismo,ihnp4}!utah-cs!utah-ug!u-jmolse
  12.  
  13. This is public domain software.  Do whatever you want with it.
  14. Just don't complain to me when it breaks after a few hundred people
  15. have hacked on it. :^)
  16.  
  17. This program takes a data file as a parameter and makes a line drawing
  18. based on the commands in the file.  The instruction format is listed
  19. below.  There should be two data files included.  One is a Mercator
  20. projection of the USA, and the other is a really short demo of how to use
  21. the color changing and line patterning commands.
  22.  
  23. Manx Instructions:
  24. cc LineDrawer.c
  25. ln LineDrawer.o -lc
  26.  
  27. It should (no guarantees) work fine with Lettuce C since I used only
  28. longs, and have (hopefully) everything type cast correctly.
  29.  
  30. Data file format:
  31. lines may have white space just about anywhere.  Each command line begins
  32. with a number followed by a number of parameters.  Any line not starting
  33. with an appropriate number (after white space, if any) is considered to
  34. be a comment.  Lines may also have a comment after the data.  No error
  35. checking is done, so it is guaranteed to do strange things if the data is
  36. messed up.
  37.  
  38. 1 <minx> <miny> <maxx> <maxy>.  Specify the range the coordinates fall into.
  39.           Reversing the miny and maxy will flip a picture vertically, making
  40.           the origin be at the bottom left corner instead of the top left.
  41. 2 <x> <y>.  Draw a line from current position to x,y.
  42. 3 <x> <y>.  Move pen to position x,y.
  43. 4 <color>.  Foreground pen color.
  44. 5 <color>.  Background pen color.
  45. 6 <pattern>.  Line pattern.  This is an unsigned word 0 to 65536 (0 to $ffff)
  46. 7 <mode>.  This can change the way 4 to 6 appear by using only foreground,
  47.           or complimenting colors, etc.  It can do some strange stuff.
  48.           The current (unguaranteed) values usable here are:
  49.           JAM1:       0
  50.           JAM2:       1
  51.           COMPLIMENT: 2
  52.           INVERSVID:  4
  53.           You can add these, so 3 = JAM2 and COMPLIMENT.
  54.