home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / KAYPRO / K4SKETCH.LBR / K4SKETCH.DZC / K4SKETCH.DOC
Text File  |  2000-06-30  |  4KB  |  86 lines
  1.  
  2.                                 S K E T C H
  3.                      Screen Editor for Graphics Kaypros
  4.  
  5. Version 1.0
  6. by Eric Mausolf
  7. Seattle, Wa.
  8.  
  9.  
  10.    I wrote this program in order to sketch out how I might want a display
  11. screen in a program to look before I had to sit down and write code.  I use
  12. SKETCH to fiddle with the graphics until I get the screen looking how I want
  13. it to look.  I then copy down the coordinates of what I see on the screen in
  14. order to recreate it in a program.  Having to write down coordinates isn't
  15. very convenient, but at least it beats the trial and error of writing code
  16. and running it to see what happens.  Of course, this program can also be
  17. used as a deluxe Etch-a-Sketch.
  18.  
  19.    SKETCH has two primary methods of operation.  While in Erase or Draw modes,
  20. you can erase or draw lines by moving a pixel-sized cursor around the screen
  21. with the arrow keys, or use some of the special drawing commands available
  22. in these two modes.  In Write mode, you can write regular characters on the
  23. screen.  These characters can be set to any combination of the video attri-
  24. butes available on graphics-capable Kaypros (blinking, underlined, etc.).
  25.  
  26.   COORDINATES:  Coordinates of the cursor are shown on the status line.
  27. In Erase or Draw modes, the coordinates shown are the vertical and hori-
  28. zontal coordinates according to the system built into the Kaypro hardware.
  29. They are the coordinates sent out directly to the Kaypro terminal to draw
  30. pixels or lines.In Write mode, the coordinates shown are the X and Y
  31. coordinates as they are referenced by Turbo Pascal (top left corner
  32. is (1,1)).  This system allows coordinates to be quickly copied down so
  33. the graphics can be quickly translated into program code (in Turbo at any
  34. rate).  If you want to see sample graphics access procedures, look at the
  35. source list for this program.
  36.  
  37. DRAW AND ERASE MODES: These modes draw and erase pixels and lines.  The
  38. following commands are used under both of these modes.  Under Draw Mode,
  39. the commands draw lines and pixels.  Under Erase Mode, the commands erase
  40. lines and pixels.  NOTE that the commands that require the user to enter
  41. coordinates will not accept coordinates that are not on the screen, and
  42. you must enter legal coordinates before the program will proceed.  The
  43. commands (all one letter) available are:
  44.  
  45. <E>  Shifts to Erase Mode.
  46. <D>  Shifts to Draw Mode.
  47. <W>  Shifts to Write Mode (detailed below).
  48. <M>  Memorizes the current position of the cursor.
  49. <R>  Returns cursor to the position previously memorized.
  50. <D>  Draws or Erases (depending on Mode) a line to the memorized position.
  51. <J>  Jumps the cursor to the position you are prompted to supply.
  52. <P>  Plots (draws or erases) a line to the coordinates you supply.
  53. <C>  Draws or erases a circle at a radius you specify from the cursor.
  54. <N>  Clears the screen (gives you a New screen).
  55. <Q>  Quit to system.
  56.  
  57.  
  58. WRITE MODE:  This mode allows you to write regular characters along with
  59. the graphics created in Draw and Erase modes.  These characters can be
  60. set to any combination of the video attributes available on the Kaypro.
  61. All commands in Write mode are preceeded by pressing the escape key.
  62. Thus, pressing <ESC> B would cause all further characters pressed to blink
  63. on the screen.  Commands are cumulative, so that pressing <ESC> U along
  64. with <ESC> B would characters to be printed as both blinking and under-
  65. lined.  This means that if you want to go back to just blinking, you
  66. have to press <ESC> N to set the attributes back to normal, and then press
  67. <ESC> B to re-engage the blinking attribute.  The cursor can be freely
  68. moved about the screen with the arrow keys.  To erase, you can either back
  69. over characters with the DEL key or overwrite them with spaces.
  70. NOTE: The commands available in Erase and Draw modes are NOT available
  71. in Write mode.  To access these commands (including Quit and New Screen)
  72. you must go back to Erase or Draw mode by pressing the escape key twice.
  73. Go back to Write Mode by pressing W.  The commands available in Write
  74. Mode are:
  75.  
  76. <ESC> plus:
  77.  
  78. <D> Print characters dim (half-intensity).
  79. <B> Print characters blinking.
  80. <U> Print characters underlined.
  81. <W> Print characters in inverse (White) video.
  82. <G> Print characters in dim inverse (Gray) video.
  83. <ESC> Go to Erase and Draw Modes.
  84.  
  85.            -------- end of SKETCH description --------
  86.