User Tools

Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
collections [2017/05/04 16:29]
meredith
collections [2017/05/05 14:04] (current)
Line 1: Line 1:
 ====== Collections ====== ====== Collections ======
- 
-This section describes how to dynamically capture part of the tree geometry for use as obstacles, growth surfaces, or anything else that calls for a mesh asset. 
- 
-===== Overview ===== 
- 
-==== What is a collection? ==== 
  
 Collections allow tree geometry to be collected in a mesh asset during tree model compute. This gathered geometry can then be used by generators and forces just as any other mesh asset would be. Collections allow tree geometry to be collected in a mesh asset during tree model compute. This gathered geometry can then be used by generators and forces just as any other mesh asset would be.
- 
-==== How to use collections ==== 
- 
-Use collections like you would any other mesh asset – drag and drop them on the desired object or select them via any object that can use a mesh's properties. Usually, collections are used as zones or mesh forces. 
- 
-==== Order matters ==== 
- 
-Generators that contribute to collections should precede generators that use them during tree model computation. ​ This means contributing generators should be on lower levels and to the left of using generators when the Generation Editor is oriented vertically.\\ 
  
 ===== Creating a Collection ===== ===== Creating a Collection =====
Line 23: Line 9:
  
 ====Collection Properties (Mesh Asset bar)==== ====Collection Properties (Mesh Asset bar)====
-The two properties in this group allow you to control how the collection is created. ​ The "​Spines"​ property controls what geometry types can be contributed from Spine nodes. ​ The "​Pivot"​ property determines how the pivot point for the collection is determined. ​ "​Origin"​ uses the world coordinate (0.0, 0.0, 0.0), and is appropriate for capturing tree geometry for growth or collision purposes. ​ "​First"​ uses the pivot point of the first object that contributes to the mesh as the pivot point for the collection. ​ This option is useful when creating collections that may later be used as leaf or frond meshes.+ 
 +The two properties in this group allow you to control how the collection is created. ​ The "​Spines"​ property controls what geometry types can be contributed from Spine nodes. The "​Pivot"​ property determines how the pivot point for the collection is determined. ​ "​Origin"​ uses the world coordinate (0.0, 0.0, 0.0), and is appropriate for capturing tree geometry for growth or collision purposes. ​ "​First"​ uses the pivot point of the first object that contributes to the mesh as the pivot point for the collection. ​ This option is useful when creating collections that may later be used as leaf or frond meshes.
  
 ===="​Create Collection From Selection"​ Tool==== ===="​Create Collection From Selection"​ Tool====
Line 33: Line 20:
 {{ :​collection-properties.png?​nolink|}} {{ :​collection-properties.png?​nolink|}}
 To make a generator contribute to a collection, look for the Collections group with the "​Generation"​ properties (depicted to the right). ​ There will be a check box for each collection asset. ​ Check each collection that the selected generator should contribute to.  Repeat this for each generator whose geometry should be in the collection. To make a generator contribute to a collection, look for the Collections group with the "​Generation"​ properties (depicted to the right). ​ There will be a check box for each collection asset. ​ Check each collection that the selected generator should contribute to.  Repeat this for each generator whose geometry should be in the collection.
 +
 +> **Note**: Order matters. Generators that contribute to collections should precede generators that use them during tree model computation. ​ This means contributing generators should be on lower levels and to the left of using generators when the Generation Editor is oriented vertically.
  
 Mesh forces can also contribute their geometry to collections. ​ The Collections group in the "​Mesh"​ properties of the force object works in the manner described above. Mesh forces can also contribute their geometry to collections. ​ The Collections group in the "​Mesh"​ properties of the force object works in the manner described above.