home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / disks / disk430.lzh / SculptTools / Spiral4D / spiral_4d_docs < prev    next >
Text File  |  1991-01-11  |  6KB  |  211 lines
  1. December 1990       Spiral_4d v. 1.2  © Bruce Thomson
  2.  
  3.  
  4.  
  5.   This is Shareware.  Donations of $US10 to the address below.
  6.  
  7.  
  8.  
  9. This  program makes spring-like objects for Sculpt-4D. You have 
  10. control over many aspects of shape and colouring.
  11.  
  12.   It makes a climbing spiral which has a copy connected below it 
  13. giving the object some solidity.  The radius of the spiral can 
  14. change dynamically.  It can be coloured by checkers that 
  15. alternate from a list you supply or the colouring can be given as 
  16. spreads of colours such as in the DPaint palette.  You can get 
  17. very smooth colour patterning this way by needing to enter only 
  18. the start and end colour.  This can be done is several blocks 
  19. covering different parts of the spiral.
  20.  
  21.  
  22.  
  23. This program runs from Workbench and CLI.  You will need 
  24. 'req.library' in your LIBS: directory.
  25.  
  26.  
  27.  
  28. Some values must be entered to define the spiral.
  29.  
  30.  To help describe them picture a spring sitting on the ground, 
  31. upright.  Imagine the coils as being made from paper tape.
  32.  
  33.  
  34.  
  35.   "Radius at base? & Radius at top?"  
  36.  
  37.   Radius will move smoothly between the two as goes from bottom 
  38. up.  If the two values are different then the spring will become 
  39. more tightly or loosely coiled along its length.  E.g. To get a 
  40. pointed shape make the base, say 100 wide and the top 5 wide.  
  41. These values can have a fractional component.
  42.  
  43.  
  44.  
  45.   "Rise per rotation? & Edge offset?"
  46.  
  47.   Every coil of the spring will be "rise per rotation" above the 
  48. one below.  This value determines how stretched the spring looks.  
  49. "Edge offset" is the width of the paper tape, or thickness of the 
  50. coils.  This is the distance between the top and bottom of the 
  51. paper tape.  This value works together with "rise per rot." to 
  52. control the compactness of the spring.  If the value is slightly 
  53. less than "rise per rot." then the spring will be quite 
  54. substantial and compact.  If the value is only a fraction of 
  55. "rise per rot." then the spring will look more like it is made of 
  56. wire.  If this is too high it will overlap onto the coil below, 
  57. or push up into the one above.  Both values need not be integers.
  58.  
  59.  
  60.  
  61.   "Multiplication factor for copy?"
  62.  
  63.   This value can be used for extra effects.  Your spring need not 
  64. just be made of paper tape.  The lower edge of the tape need not 
  65. just hang straight below the upper.  This value can push it 
  66. further out or move it closer towards the axis of rotation.  If 
  67. the value is less than one then the radius of the copy will be 
  68. less than the radius of the original spiral at all points.  If 
  69. the value equals one then it will hang straight below.  If 
  70. greater than one it will be pushed out further.  Your spring can 
  71. thus be made to have some horizontal thickness.  This value can 
  72. be fractional.
  73.  
  74.  
  75.  
  76.   "Number of rotations? & Number of points?"
  77.  
  78.   The number of coils the spring will have, and the total number 
  79. of points, or segments, along the whole of the spring.  These 
  80. values work together to control how smooth the spring looks.  
  81. E.g. with 2 rotations and 50 points you would have 25 points for 
  82. each circle.  With 10 rotations and 40 points your spring would 
  83. have four sides rising up through ten coils.  The number of 
  84. rotations can be fractional but number of points must be an 
  85. integer.
  86.  
  87.  
  88.  
  89.   "X translation? & Y translation?"
  90.  
  91.   As well as spiralling upwards the whole spring can lean in one 
  92. direction or another.  These values determine the position of the 
  93. axis of rotation at the end relative to the original position. It 
  94. is a shear, not a rotation.  E.g. if you want it to lean 
  95. forwards-right.  Make X positive and Y negative.  Good for 
  96. movement in anims.  Both values can be fractional.
  97.  
  98.  
  99.  
  100.   "Colouring type?  Checkers or Spreads"
  101.  
  102.   Checkers: Alternating colours from a series you enter.  You 
  103. will need to enter how many checkers there are then enter the 
  104. colours for each one.  This is made easy as you only need to 
  105. adjust the highlighted colour in the colour requester.  Do this 
  106. and click on OK for each check.
  107.  
  108.   Spreads:  Your will be coloured with smooth ranges of colours.  
  109. The number of points you entered earlier is the number of 
  110. segments your spring is made of.  Each one can be coloured 
  111. individually but the easiest way is to enter the start and end 
  112. point and then the colours you would like to spread between.  
  113. Enter the start and end segment.  A colour requester will pop up 
  114. and this is where you select the colours.  Adjust the highlighted 
  115. colour and then the one to its right and then click on OK.  The 
  116. colours between will be spread amongst the segments in the range 
  117. you specified.  Cancel the 'start point?' requester to finish 
  118. entering spread data.  To help you enter the numbers for the 
  119. ranges the program gives as default values ranges made of equal 
  120. steps based on your previous entries.  Ensure you colour the 
  121. whole of the spring or some will be left black.  The segments 
  122. range from number zero to the maximum points.
  123.  
  124.  
  125.  
  126.   Finally you will be prompted for a filename to write the object 
  127. off to.
  128.  
  129.  
  130.  
  131. Note:  All measurements are in the same units.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.   EXAMPLES:
  138.  
  139.  
  140.  
  141.    Smooth tube shape:
  142.  
  143.     Radius bottom = 50
  144.  
  145.     Radius at top = 50
  146.  
  147.     Edge offset = 150
  148.  
  149.     Rise per rotation = 0
  150.  
  151.     Multiplier = 1
  152.  
  153.     Number of rotations = 1
  154.  
  155.     Number of points = 50
  156.  
  157.  
  158.  
  159.    Skinny, stretched out spring, small at bottom, wide at top.
  160.  
  161.    Has a   square profile:
  162.  
  163.     Radius bottom = 20
  164.  
  165.     R at top = 100
  166.  
  167.     Edge offset = 5
  168.  
  169.     Multiplier = 1
  170.  
  171.     Rise per rot = 20
  172.  
  173.     Number of rots = 6
  174.  
  175.     Number of points = 24 /*gives 24/6=4 points per circle */
  176.  
  177.  
  178.  
  179.    Flat disk with a hole in the middle:
  180.  
  181.     Radius at bottom = 10
  182.  
  183.     Radius at top = 10
  184.  
  185.     Edge offset = 0
  186.  
  187.     Rise per rotation = 0
  188.  
  189.     Multiplier = 4
  190.  
  191.     Number of rots = 1
  192.  
  193.     Number of points = 40
  194.  
  195.  
  196.  
  197.  
  198.  
  199.   Author: 
  200.  
  201.    Bruce Thomson
  202.  
  203.    PO Box 33116
  204.  
  205.    Takapuna
  206.  
  207.    Auckland
  208.  
  209.    NEW ZEALAND
  210.  
  211.