home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / kolekcje / stanislaw_weslawski / ulubione_share / gridmaker / docs / gridmaker.doc next >
Text File  |  1996-06-07  |  7KB  |  216 lines
  1.  
  2. Grid Maker version 1.11 manual:
  3. ===============================
  4.  
  5. Copyright © 1995, 1996 by InterMedia consulting. All rights reserved.
  6. Coded by Kenneth C. Nilsen in assembler.
  7.  
  8. This program needs dfunc.library (by Kenneth C. Nilsen)
  9. and iff.library (by Chistian A. Weber).
  10.  
  11.  
  12. This program is freeware.
  13.  
  14. The GridMaker archive must not be changed in any way. Distribution must
  15. contain all files!
  16.  
  17.  
  18.  
  19. INTRODUCTION
  20. ============
  21.  
  22.  
  23. This program will take an iff picture and transform it into a 3D grid looking
  24. picture. The methode used for this is based on the pen numbers in the picture.
  25. Color 0 is no delta pixel, color 1 is delta 1 pixel and so on.
  26.  
  27. The program can take most resolution, including HAM (which though is not of
  28. very much use) thanks to Weber who made the iff.library.
  29.  
  30. It will same the new 3D grid picture in the same resolution as the original,
  31. but with only one bitplane and the colors set by you (or default).
  32.  
  33.  
  34.  
  35. Version 1.11 is only a bugfix: Left a lock on the dir if started from WB.
  36. Caused by a bug in the startupcode.
  37.  
  38.  
  39.  
  40. USAGE
  41. =====
  42.  
  43.  
  44. GridMaker [inpicture] [outpicture] [REQ] [Options]
  45.  
  46. InPicture    - the name of the iff picture to be converted
  47. OutPicture    - name of the finished iff picture
  48. Req        - use requesters for filenames instead
  49.  
  50. Options:    -d    = double curve heights
  51.         -i    = invert the way curves are drawn
  52.         -NoX  = don't draw the horizontal curves
  53.         -NoY  = don't draw the vertical curves
  54.         -x[n] = grid size x, n=pixels (def.=7)
  55.         -y[n] = grid size y, n=pixels (def.=7)
  56.         -f[c] = foreground color by c=[$fff] (def=$00f)
  57.         -b[c] = background color (see above) (def=$000)
  58.         -p    = preview process
  59.  
  60. New from 1.1:    -h    = halve the curve heights (useful with lores pics)
  61.         -r    = reverse pen methode. pen 0 = highest curve.
  62.         -t    = trigg exit.
  63.         -s    = toggle save = don't save to outfile.
  64.         -z[n] = zoom faktor. Height*[n]. Max=255
  65.         -o    = draw points instead of lines.
  66.         -NoB  = don't draw zero height curves.
  67.  
  68.  
  69. Here are the options explained in details:
  70.  
  71. inpicture,    must be an ILBM IFF picture. Any resolution can be taken, even
  72.         HAM and HAM8 (i think). I have not supported 24bit and the
  73.         GetColorTab() function in the iff.library doesn't convert to
  74.         more than 16 bit values (for each component). In the next
  75.         main version I will most propably have solved this by making
  76.         my own color converter in the dfunc.library.
  77.  
  78. outpicture,    is the name of the ILBM IFF file to save. The file is packed
  79.         and can be viewed directly after GridMaker is done.
  80.  
  81. REQ,        will allow you to use an asl requester to choose the input
  82.         and output file.
  83.  
  84.         If you start GridMaker from Workbench REQ is default. The rest
  85.         of the options will be set by default. In future this can be
  86.         set by tooltypes.
  87.  
  88.  
  89. -d,        doubles the pen value heights. This is useful in picture with
  90.         low number of colors.
  91.  
  92. -i,        will invert the height to be drawn downwards instead of
  93.         default upwards. This enable you to make walleys instead of
  94.         montains.
  95.  
  96. -NoX,        will disable the program in rendering the horizontal lines.
  97.  
  98. -NoY,        same as above with the vertical lines.
  99.  
  100. -x[n],        will set the horizontal grid width. [n] is the value to set in
  101.         pixels. Default is 7 pixels in width.
  102.  
  103. -y[n],        same as above with the height grid. Default is also 7 pixels.
  104.  
  105. -b[c],        sets the background color. You can use either hexadecimal or
  106.         just decimal numbers like this: $fff, $f, 1245, $0fff, 8 etc.
  107.         Limited to word size.
  108.  
  109. -f[c],        same as above with the foreground color. [c]=color value.
  110.  
  111. -p,        will put the rendering screen to front. By default the screen
  112.         will open in behind mode to allow you to do monitor the
  113.         Workbench screen or shell etc.
  114.  
  115. -h,        will halve the curve heights. This can be useful with lores
  116.         pictures or with pictures with many colors.
  117.  
  118. -r,        will reverse the pen methode. Normal pen 0 = lowest height,
  119.         but with this option set pen 0 is highest curve. Useful with
  120.         "inverted pictures". Similar to the -i option but doesn't
  121.         negate the picture.
  122.  
  123. -t,        this will allow you to watch the finished picture as long as
  124.         you want. Press left mousebutton to exit. GridMaker is used
  125.         mostly with scripts, therefore it has autoexit as default.
  126.  
  127. -s,        disables save. With this option set GridMaker will not save
  128.         the gridded picture to outfile. The outfile arg must anyway be
  129.         set, use some garbage signs. This will be fixed later.
  130.  
  131. -z[n],        this will multiply the heights: Height*[n] where [n] is max
  132.         255.
  133.  
  134. -o        will draw points instead of lines at the scan points. Only one
  135.         scan direction is necessary during this process. You can thow
  136.         choose which by setting the approriate -NoX/-NoY options.
  137.  
  138. -NoB,        do not draw curves/lines/points with height=0. This means that
  139.         you only get curves/points drawn at the areas in the picture
  140.         which has colors defined.
  141.  
  142.  
  143.  
  144. EXAMPLES
  145. ========
  146.  
  147. Here are some examples for you to try out. You will find demo pictures of
  148. these examples in this archive:
  149.  
  150. 1) GridMaker GridTest.iff ram:Grid1.iff -b$800 -f0 -x5 -y5 -p
  151.  
  152. 2) GridMaker GridTest.iff ram:Grid2.iff -NoX -p
  153.  
  154. 3) GridMaker GridTest.iff ram:Grid3.iff -NoY -y5 -f$a0 -i -p
  155.  
  156. 4) GridMaker GridTest.iff ram:Grid4.iff -NoX -x5 -y5 -f$ccc -b$4 -i -d -p
  157.  
  158. 5) GridMaker GridTest.iff ram:Grid5.iff -x15 -y15 -d -p
  159.  
  160. 6) GridMaker GridTest.iff ram:Grid6.iff -y3 -x4 -f0 -b$fff -p
  161.  
  162. and so on. Experiment to make most useful effects. in future there will come
  163. more options!
  164.  
  165.  
  166.  
  167. SOME TECHNICAL INFO
  168. ===================
  169.  
  170. The -x is justed to set the vertical resolution and spacing beetween the
  171. vertical lines. The -y is the oposite and the resolution for x rendering. This
  172. means you can use eg. the -x option even if you have set -NoX. This has the
  173. effect that the vertical lines are rendered closer.
  174.  
  175. The vertical are rendered shared for two reasons:
  176.  
  177. In interlaced pictures it will suit for more non-interlace and the second
  178. reason is to make an illution of light coming from upper left corner.
  179.  
  180.  
  181. The exact way to render these drawings is indeed very simple:
  182.  
  183. It has a coordinate counter. Lets take the X counter. While this counter
  184. crosses the screen horizontal it picks a color read from the original picture
  185. with graphics.library/ReadPixel(). It then uses this value as a subtractor (or
  186. adder if inverted) on the Y coordinate. The higher color number the higher
  187. curve and the result will be a 3D look in gridded outline. This also means
  188. that the colorvalues in the picture has no effect on the rendering, just the
  189. colornumber.
  190.  
  191.  
  192.  
  193. SUMMARY
  194. =======
  195.  
  196. So, experiment with the program. This is version 1 so don't be suprised if any
  197. bugs occure. I have removed the bugs I self discovered, but you know how it is
  198. when you work with a program a lot, you get tired of it. Btw: made this
  199. program in one day :)
  200.  
  201. Enjoy, have fun!
  202.  
  203.  
  204.  
  205. ADDRESS
  206. =======
  207.  
  208.  
  209. InterMedia consulting
  210. Attn: Kenneth C. Nilsen
  211. Kvernhusrenen 31
  212. N-5227 S-Neset
  213. Norway
  214.  
  215. E-Mail: kenneth@norConnect.no
  216.