home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 609a.lha / Contour4D / contour_4d_docs.pp / contour_4d_docs
Encoding:
Text File  |  1992-01-30  |  8.8 KB  |  206 lines
  1. December 1991                   CONTOUR_4D v1.5
  2.                                 ---------------
  3.  
  4.                   Copyright © 1991 by Bruce Thomson
  5.  
  6.                            DISCLAIMER
  7.  No guarantee is made, expressed or implied as to Contour_4D's
  8. suitability for any application.  No responsibility will be taken by the
  9. author for any results of its use or misuse.
  10.  
  11.         SIZE LIMITATION
  12.  This is Shareware.  This version will create objects of up to 2000
  13. faces.  If you want more then I recommend you register with $US10 to get
  14. latest major updates etc.
  15.  
  16.       What Does It Do?
  17.  
  18.     Contour_4D makes objects for Sculpt 4D out of IFF brushes.  It uses
  19. a 'colour' brush and a 'contour' brush.  The 'colour' brush is converted
  20. into a flat plane with various  controls over texture etc.  It doesn't
  21. stay flat for long.  The 'contour' brush alters the altitude of the
  22. pixels in the flat brush depending on the colour of the matching pixel
  23. in the 'contour' brush.  Bright colours make for high points, dark
  24. colours for low points.  You end up with a 3D surface.  The program
  25. allows you to use  standard, Extra Halfbrite and HAM brushes for both
  26. the 'colour' and 'contour' brushes.  It works in full colour.  
  27.  
  28. You can also:
  29. - Optimise the brush so that areas of the same colour become 
  30.   one large square as opposed to many small ones.
  31. - Make any colours transparent.
  32. - Alter the texture of colours independently.
  33.  
  34.       How Do I Use It?
  35.  
  36. Contour_4D runs from CLI or Workbench and is easy to use.  It needs
  37. about 160K of free memory as well as the screen memory for your brushes.
  38.  
  39. When running respond to the requesters, set up transparency and textures
  40. and then the object file will be created, ready to load into Sculpt 4D
  41. as an object or scene.
  42.  
  43. You will need a copy of 'req.library' in your LIBS: directory.
  44.  
  45.       How Does It Work?
  46.  
  47. Contour_4D loads in the brushes and displays them.   You enter some
  48. information and then Contour_4D will then proceed to analyse the
  49. pictures and convert the pixels into pairs of sculpt faces making up
  50. squares with that block's colour.
  51.   The height of the pixels depends on the colours in the 'contour'
  52. brush.  The four pixels around the corners of the faces in the object
  53. are averaged to get the height of that corner. Black (red=0, green=0,
  54. blue=0) has an altitude of zero.  White (red=15, green=15, blue=15) has
  55. an altitude of 45.  Shades inbetween these boundaries will give
  56. intermediary altitudes.  Pure red for example gives an altitude of 15.
  57. The red, green and blue values are added to give the final altitude.
  58. The best palette to work with when designing the contour palette is
  59. one with 16 grey scales.  Colours you think might give the same height
  60. may not, such as white and bright yellow.  Yellow is missing any blue
  61. component and will have 33% less height.  If you wanted to use a
  62. colourful IFF you had handy generally convert it to B&W first.
  63. The program links up all the squares to give a smooth surface. 
  64.   You can have some optimisation of the object, rather than every pixel
  65. being made into a pair of faces.  This allows areas of one colour to
  66. become a large block rather than lots of small blocks.
  67.   Depending on the brush, optimisation of up to around 90% can be
  68. achieved, giving a great saving in memory and object faces.
  69.  
  70.   When the conversion is finished you will be told of the number of
  71. vertices, edges, faces and file size of the object, along with the
  72. percentage of points made transparent and the percentage of compression
  73. performed.  Conversion time varies greatly depending on brush size and
  74. complexity, but should be around a couple of minutes.  The current
  75. location being converted is shown on the main screen along with the
  76. current number of faces.  If you wish to abort the conversion for any
  77. reason click on the 'Abort' gadget.  
  78.  
  79. When one conversion has been done you will be given the choice to
  80. perform another or to quit.
  81.  
  82.       The Inputs.
  83.  
  84. A series of requesters and gadgets will pop up which you will use to
  85. control the conversion.
  86.  
  87. First you must select the filenames for the IFF brushes.  A file
  88. requester will appear and you will enter the 'Colour' brush first and
  89. then the 'Contour' brush.  If you want to quit then click on 'Forget it'
  90.  
  91. Next the contour control panel window will appear and from this you
  92. can change the
  93.   - Height and Width to be converted 
  94. The area to be converted is from the top left and these values
  95. give the size of the area to convert.
  96. They default to the largest area possible constrained by the size
  97. of both input brushes.
  98.  
  99.   - Optimisation
  100. Click on the gadget to toggle between optimisation or not.  If
  101. you don't optimise every pixel will be converted into a pair of
  102. faces.
  103. You should normally have optimising on.  You will get a smoother
  104. contour under some circumstances without it but depending on
  105. brush complexity could have a lot more faces.
  106.  
  107.   - Transparent colours
  108. If you have a HAM screen as the colour brush you will only be
  109. able to make the background colour transparent.
  110. If you have a non-HAM brush for the colour brush then each colour
  111. can be made transparent or not.  A set of gadgets will appear on
  112. another window, each with a number 0 - #colours in brush.  The
  113. numbers correspond to the palette number in the brush.  Click on
  114. the gadgets to toggle transparency for that colour.
  115. The bright and dull versions of extra-halfbrite colours can be
  116. changed separately.
  117.  
  118.   - Textures
  119. If you have the colour brush as a non-HAM screen then each colour
  120. can be given a different texture so that the final object will be
  121. constructed of faces of differing textures.  When you click on
  122. 'change colour textures' another window will appear with gadgets
  123. for each colour you can change.  The current setting of each
  124. colour is displayed to the gadget's right.  The two characters
  125. shown are the abbreviations of the possible textures.  The
  126. numbers in the gadgets are the palette numbers.  To change
  127. textures click on the first colour to change, then the last and
  128. finally the texture that you want them to become. 
  129.   All colours start off being dull.
  130. With a HAM screen as the colour brush you can only alter the
  131. overall texture for the object.
  132. With EHB the half-brite colours should be textured separately
  133. from their corresponding bright colours.
  134.  
  135. When the conversion is finished you will be asked for a filename to
  136. save the scene under.  A ".scene" will be appended to the name so do
  137. not enter one yourself.
  138.  
  139.       Tips.
  140.  
  141. Make sure the 'contour' brush is large enough to cover the 'colour'
  142. brush or the program will automatically convert a smaller brush.
  143.  
  144. If you have a simple but large brush you should reduce it in size to
  145. greatly decrease conversion time.
  146.  
  147. Fewer colours will result in higher compression levels but you should
  148. balance the memory saving against the look of the object.
  149.  
  150. If you want smaller objects then reduce the brush before conversion or
  151. reduce the number of colours on a program like Deluxe Photolab.
  152.  
  153. Name your objects when they are loaded in as when you have transparent
  154. colours the various parts may not be connected so you will want an easy
  155. way of selecting the whole object.
  156.  
  157. Key frame animation can be performed.  Use either no optimisation and
  158. any brushes of the same size or you can use optimisation as long as you
  159. change only the colouring of the contour or colour brush within blocks
  160. of one colour which have surrounding edges of an unchanging colour.
  161.  
  162.       Errors.
  163.  
  164. You will be told throughout if anything goes wrong like not being able
  165. to open the screen or files etc.
  166.  
  167. You might get the "Exceeded maximum vertices" or "Exceeded maximum
  168. faces" message.  If this happens you should send off the cash for the
  169. version without limits.  Alternatively reduce your image (but lose
  170. detail).
  171.  
  172. If you run the program but it returns immediately then you  may not have
  173. the "req.library" in your  LIBS: directory, or be low on memory.
  174.  
  175. 7.      The Address
  176.  
  177. I am a poor student, and need your donations. Future upgrades depend on
  178. your generosity.  These will be sent free of charge when any important
  179. changes are made, to all registered users.
  180.  
  181. Send your money to:
  182.  
  183.                     Bruce Thomson
  184.                     PO Box 33116
  185.                     Takapuna
  186.                     Auckland
  187.                     NEW ZEALAND
  188.  
  189. Make that $US cash or international cheques or money orders.
  190.  
  191. 8.     Other Important Stuff.
  192.  
  193. This program is to be distributed with these docs intact and unaltered.  
  194. Distribution of restricted (in object size) version. (ie this package)
  195. - This restricted version is freely uploadable to BBS's etc.
  196. - Fred Fish can include it in his library.
  197. - Other PD/Shareware libraries can distribute it if they are 
  198. not greedy, ie they charge no more than 150% of Fred 
  199. Fish's charges.
  200. - Free User Group disk magazines, etc. may distribute it.
  201. - Ask me if you want to distribute it packaged in any form 
  202. that is not covered above, that you will be charging any 
  203. money for - e.g. a disk that accompanies a magazine
  204. -The unlimited size version is for your private use only if you 
  205. decide to register.  It is not to be copied.
  206.