home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / a / ddraw.lbr / DDRAW.DZC / DDRAW.DOC
Encoding:
Text File  |  1993-10-26  |  7.8 KB  |  149 lines
  1.  
  2.  
  3.                           DDRAW.COM
  4.  
  5. The file DDRAW.COM was compiled by Turbo v2.0 with an ending address of B000h.
  6. This should allow it to run on anything with a 64k (to start) CP/M 2.2 system.
  7.  
  8. It compiled and runs fine on my KP10 with a very crowded high memory area 
  9. (ZCPR3, screen dumper, etc.) and a 51k TPA.
  10.  
  11. As Dan states in the DOC, this program is not finished yet. He has a planned
  12. improved pattern fill routine and a few other things to do (make it work with
  13. a printer other then a Gemini/Epson I hope...)
  14.  
  15.         Steve Sanders (Sysop)
  16.         DataCOM Network RCP/M #1 & #2
  17.         (813) 937-3608  300/1200
  18.  
  19.                                     DDraw
  20.                             copyright (c) 1984 by
  21.                                  D. Griffith
  22.  
  23.    DDraw is a general purpose graphics/text utility designed for Kaypro'84
  24. models.  DDraw can be described as a 'McPaint' for the Kaypro.  I want to
  25. say that DDraw (and this documentation) is not nearly in its final form,
  26. so please do not compare it unfavorably to some of the drawing programs
  27. available for more graphicly oriented systems.
  28.  
  29.    The source to DDraw will be released (probably) into the public domain
  30. as soon as I feel it is complete.  Any suggestions for features, improvements,
  31. etc., can be directed to:
  32.                D. Griffith
  33.                912 Terra Mar Dr.
  34.                Tampa, Fla.,  33612
  35. or a message can be sent via modem on the Pro-Com 1 or 2 systems
  36. (813) 937-3608, (813) 937-6829.
  37.  
  38.  
  39. Drawing
  40.  
  41.    To draw something, simply type DDRAW at the CP/M prompt and press <RETURN>.
  42. The screen will clear and a graphic cursor will appear.  Typing a '?' or 'H'
  43. for help will bring up a menu of commands.
  44.    The numbers 1-9, not including 5, move the cursor in the direction
  45. relative to the 5 on the keypad.  The 5 will toggle draw/erase mode.  If you
  46. wish to position the cursor without drawing or erasing, press the B key to
  47. enter Browse mode, move the cursor as though you were drawing, then press
  48. B again to leave browse mode.
  49.    To avoid having to hold down keys to move the cursor, a Repeat mode was
  50. added.  By pressing the R key, all movement commands automatically repeat
  51. until either a key is pressed or the edge of the screen is reached (in non-
  52. wrap-around mode).  Pressing R again puts the cursor back into a manual
  53. repeat mode.
  54.    The cursor will default to stopping when the edge of the screen is reached.
  55. This can be changed by pressing the W key (to stop or start).  At that time,
  56. when the edge is reached, the cursor wraps around to the opposite side.
  57.    The screen can be entirely cleared by pressing ^C (hold down the CTRL key
  58. at the edge of the keyboard and press the C).  If the screen was not saved,
  59. it is lost.
  60.    Two features that make drawing a little easier is a line and circle drawing
  61. command.  To draw a line, move the cursor to one end of the proposed line,
  62. press the L key, move the cursor to the other end and press L again.  To draw
  63. a circle, move the cursor to the center of the proposed circle, press the C,
  64. move to a point on the edge and press C again.  Either command may be aborted
  65. before it is drawn by pressing the space bar before pressing the command key
  66. the second time.  Note that if you are in erase mode, a line or circle is
  67. erased at the indicated positions.
  68.    Another useful feature is the status line.  By pressing the S key, a
  69. status line indicating the cursor position will appear at the lower left
  70. of the screen.  The first Y and X is a character position that can be used
  71. in programs.  The second set, gY and gX are a graphics position that ranges
  72. from 0-99 for gY and 0-159 for gX.
  73.    Yet another useful feature is the Text entry command.  By pressing the
  74. letter T while in graphics mode, a letter-size cursor appears at the same
  75. (approximate) position of the graphics cursor.  At this time, typing of
  76. text is allowed.  The arrow keys (set up for WordStar or Kaypro) will move
  77. the cursor around th screen.  The RETURN key will move the cursor to the
  78. beginning of the next line.  To exit the text entry mode, press the ESCape
  79. key.  Text (but not spaces) will overwrite graphics.  This is not to say
  80. that any graphics you type over are lost;  it is just that the text has
  81. priority.  By typing spaces over text, any covered graphics will appear.
  82.   One last command.  ^U (hold down the CTRL key and press U) will refresh
  83. the screen.  This is used whenever you have typed in the 80th column of
  84. the 24th line (the screen scrolls automatically) or when spaces have been
  85. typed over text to reveal covered graphics (they do not appear immediately).
  86.  
  87.  
  88. Subpictures
  89.  
  90.    It is often convenient to save a portion of a disply in a buffer and
  91. redisplay it at a different position.  The subpicture commands allow this.
  92. I admit the commands are hardly mnemonic of their function, but I did not
  93. want to use multiple control codes at the time.  That will probably change
  94. in later versions for ease of use.  Regardless, the subpicture entry procedure
  95. is: move the cursor to the upper left corner of the block you wish to save,
  96. type ^B (hold CTRL key and press the letter B) begins subpicture entry.
  97. Follow it immediately my the number 0, 1, or 2 to tell which buffer you wish
  98. the image stored.  Move the cursor to the lower right corner and press ^B
  99. again.  The image will be stored.  You may now continue with any editing.
  100.    To recall an entered subpicture simply move the cursor to the upper left
  101. corner of where you wish it displayed and type ^R followed by the number 0,
  102. 1, or 2 depending on which picture you wish displayed.
  103.    At the present time, the subpicture commands actually save a from the
  104. current character position (the YX in the status line) not the graphic
  105. cursor position (gYgX).  This means that usually a little more will be
  106. stored and that the display may not start at precisely where the cursor is
  107. when the ^R command is entered.  That will be remedied soon.
  108.    Subpictures may be saved to disk for use in a later session by
  109. typing ^D and entering a filename.  To reload a set, press the letter D
  110. and enter the filename you wish to restore.  Note that executing a clear
  111. screen command (^C) does not destroy the subpictures stored in memory.
  112.    A final note on redisplaying the subpictures:  if the cursor is in erase
  113. mode, the subpicture will overwrite whatever is 'under' it.  If the cursor
  114. is not in erase mode, the subpicture will me 'merged' with the graphics.
  115. Either way, any text will be overwritten and a screen refresh (^U) command
  116. should be issued.
  117.  
  118.  
  119. Printing
  120.  
  121.    Two methods are provided for displaying screen images on the printer.
  122. The first is solely for graphics.  It prints (on a Gemini/Epson printer)
  123. a bit image of the graphic screen.  To produce this print, type ^P.  The
  124. other print will also copy any text to the printer.  I know it works on
  125. the Gemini printers (not so sure about Epson).  The command is ^O.
  126.  
  127.  
  128. Saving and Loading Screens
  129.  
  130.    To save a screen (graphics and text), type ^S followed by a filename.
  131. If the disk is read only, full, or the directory is full, an error will
  132. occur and the screen will be lost.  To load a screen, type ^L followed
  133. by the filename.  If the file does not exist, an error will occur.
  134. Provisions will be made in a revision to allow separate saving of text
  135. and graphics screens.  This will allow text screens to be produced by
  136. other methods (word processors) then merged into the graphic screens.
  137.  
  138.  
  139. Miscellaneous
  140.  
  141.    A final command ^Q will exit DDraw without saving screens.
  142. If when asked for a filename (loading and saving), you wish to abort the
  143. command, simply press RETURN without entering anything.
  144.  
  145.  
  146. Note
  147.  
  148.    I believe I have covered all of the commands available as of
  149. December 1984.