home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gfx / duerer-1.01.lha / Duerer / Duerer.DOC < prev    next >
Text File  |  1993-11-27  |  13KB  |  274 lines
  1. DUERER  I     -----     english manual
  2. ======================================
  3.  
  4. ATTENTION PROGRAMMERS !!
  5. ========================
  6. First: You are allowed to use or to distribute this program as much as
  7.        you want.
  8.  
  9. If you send me 20 DM (German Marks) or 15 $ (US-Dollar), you will get the
  10. 170 KByte long source code on a SONY MFD-2DD disk. Because of the extensive
  11. length, this disk includes some other ASCII-Files explaining the programming
  12. and the working methode of the following subroutines of Duerer:
  13.  
  14. - the paint instruments (e.g. pencil, rubber, line, ...)
  15. - the magnifier and its options
  16. - load/save an IFF-Graphicfile
  17. - hardcopies
  18. - reflect a graphic on x/y
  19. - the brushes and their options
  20. - using diskfonts
  21. - the message system used in Duerer
  22. - some advice to convert Duerer into NTSC
  23.  
  24. - as an addition, the disk contains an assembler routine, drawing a line
  25.   with the blitter in only 472 clock cycles.
  26.  
  27. If you want to get this highly interesting disk, you must write to me:
  28.   STEFAN KUWALDT
  29.   AM HIRSCH 1
  30.   66265 HEUSWEILER
  31.   WEST-GERMANY
  32. Please write your own address in printed letters; I'll react as fast as
  33. possible.
  34.  
  35. =========================================================================
  36.  
  37.  
  38. INTRODUCTION
  39. ============
  40. In spite of its short program length, Duerer is very well suitable to create
  41. graphics or brushes. All of those can be saved either in the known IFF format
  42. or in a special RAW format, which is especially interesting for game writers.
  43. Except HAM and EHB, Duerer makes all Amiga graphic formats available to you.
  44. Don't forget that fonts have to be on the bootdisk. Unfortunately, Duerer
  45. is only compatible to the europe PAL screen mode.
  46.  
  47.  
  48. GENERAL USING
  49. =============
  50. After starting the program, a requester appears on the screen. Now, you
  51. can select your favorite resolution and the number of colors, you need.
  52. Quit the requester with a click on OK or hit simply RETURN.
  53. Now appears the paint screen in the selected attributes together with
  54. the border, used to display the painting instruments and the color
  55. gadgets. You can simply begin to paint by using the left mouse button.
  56. Use F10 to fade in/out the borders to get the whole screen to paint on.
  57.  
  58.  
  59. THE TOOL-BOXES
  60. ==============
  61. You select an instrument by clicking on it with the left mouse button
  62. or by using an alternative key command.
  63. Some tools allow you to choice under several modes; if available, you
  64. can get the respective requester by clicking the tool with the right
  65. mouse button or by hitting CTRL together with the alternative key to
  66. this instrument.
  67. For the rest, all key commands are you shown by selecting menu
  68. "Options/key commands".
  69.  
  70. A) THE VERTICAL TOOL-BOX:
  71. The tools "PENCIL","RUBBER" and "LINE" should be easy to understand.
  72. CTRL-d allows you to choose under a "pointed" and a "normal" pencil
  73. draw mode. This is important to the rubber as well.
  74. With CTRL-l, you can define an alternative "Line pattern". Further,
  75. it's possible to activate the interesting "Trace effect". Mind you,
  76. that's also possible with some other instruments as well.
  77. The "BRUSH" is a little more complex; clicking it by the right mouse
  78. button, you are expected to choose under three program-defined brushes,
  79. which can be individually manipulated by their size ("Change size"), and
  80. your own brush ("defined"). Wait a moment, and I will explain you how
  81. to use it. The modes "Normal" and "Stamp", respectively, mean, that
  82. the background will shine through your brush, or not. That occurs on
  83. the transparent areas of it.
  84. The "WATER-TAP" fills out closed areas with the current color and the
  85. selected fill pattern, which is displayed in a little box in the vertical
  86. tool-box. Click it or press CTRL-f and you can choose under 32 patterns,
  87. which can be individually changed. All the 32 can be loaded/saved. Click
  88. the pattern you are going to change, with the right mouse button and it
  89. will appear a requester, in which you can manipulate this pattern.
  90. With the "BRUSH-GETTER", you define a part of the screen as to be your
  91. new paint brush, by simply drawing a rectangle around the desired area.
  92. The "TEXT-TOOL" is to possible you to write a short text into the picture.
  93. After selecting this tool, you must position the cursor in the screen with
  94. the mouseclick. Now you can write, but don't forget the following: YOU
  95. MUST TERMINATE THE WRITING BY  E S C ! Otherwise, you will cause unex-
  96. pected results.
  97. Whether the background shines through or not is determinated by the fill
  98. pattern mode, selected with CTRL-f.
  99. If you click the text tool with the right mouse button (or CTRL-t), it
  100. will appear a font requester, in which you can choose under the fonts on
  101. your bootdisk and the styles underlined, bold, italic, extended and normal.
  102. Click on "Show" to let you show the current font with the selected styles.
  103. With "POLYGON" you can simply draw polygons. Finish the drawing with SPACE.
  104. The tools "RECTANGLE" and "ELLIPSE" respectively, are similar to under-
  105. stand. Drawing rectangles, you must know, that the line pattern is important
  106. to empty recs. and the fill pattern for filled recs. The fill pattern is
  107. also important to filled ellipses. In a special requester (CTRL-r / CTRL-e),
  108. you can activate the trace effect and choice under rectangles/squares and
  109. ellipses/circles, respectively. Note, that the choosen resolution is very
  110. important to that!
  111. The "MAGNIFIER" is an especially interesting feature of Duerer. After
  112. clicking on it, the mouse moves a rectangle over the screen which is
  113. representating the area to be enlarged. Now click the left mouse button
  114. and in a new window will appear the enlarged area, in which you can paint
  115. now, unfortunately only with a simple pencil. Left at the bottom is dis-
  116. played the area in its original size. You can move this scrap with the
  117. gadgets on the right side of it (or use the cursor keys). Click on the "X"
  118. (or press RETURN), and the new part of the picture will be enlarged.
  119. Right at the bottom, you can choose under three factors, important to the
  120. magnifying. With the gadgets under them, you select the color to paint
  121. with. But there is another, more comfortable, way: use the size gadget
  122. in the right down edge and click on the color gadgets of the horizontal
  123. tool-box. Note this: never use the magnify, when the tool-boxes are faded
  124. out!
  125. The "RASTER" draws lines for orientation in selectable distances on the
  126. screen (to select, click on raster with right). If you click with left
  127. on this gadget once more, the lines will be replaced. But: don't paint
  128. over the lines. Otherwise, they won't be replaced correctly! While
  129. entering the distances, you should never use negative or other unsuitable
  130. distances!
  131. The tools "CLR" and "UNDO" respectively are supposed to be easy to under-
  132. stand. Nevertheless, you must know, that Undo will work in another way
  133. when using brushes: all steps up to the selecting of the brush tool are
  134. canceled.
  135.  
  136. B) THE HORIZONTAL TOOL-BOX:
  137. The conspicuous color gadgets in the horizontal tool-box can simply be
  138. clicked by the left mouse button to select the paint color.
  139. The current paint color is displayed in a little box left from the color
  140. gadgets. This box must be clicked (alternative key F1) to have the RGB
  141. COLOR MIXER on the screen. It's simply to use; the RGB values are shown
  142. under the proportional gadgets in hexadecimal.
  143. The "EDIT" gadget leads to the color mixer too.
  144. With "RESET", you choice the color having been current after starting
  145. the program, in other words the default colors.
  146.  
  147.  
  148. THE PULLDOWN MENUS
  149. ==================
  150. A) THE "PROJECT" MENU:
  151. The procedures "LOAD", "SAVE" and "DELETE" are supposed to be clear.
  152. A special feature is the RAW format, which you can choose in the file
  153. requester instead of the standard IFF format. Such a RAW file is built
  154. as following:
  155.  
  156. Offset:     Function:
  157.   0         Viewmode of the graphic file (WORD)
  158.   2         Width in pixels (WORD)
  159.   4         Height in pixels (WORD)
  160.   6         Number of bitplanes (WORD)
  161.   8         Here are the RGB color values. According to the number
  162.             of bitplanes, there are from 2 to 32 WORDS, exactly built
  163.             like the color values used in the Amiga Hardware.
  164.   Finally, the file contains the bitplanes, mixed together like the
  165.   follow