meta data for this page
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
generation_properties [2022/04/05 09:26] – sechrest | generation_properties [2023/04/03 18:44] (current) – steph.jorgensen | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Generation | + | ====== Generation |
- | Each [[generators|generator]] has a group of properties called | + | Each [[kcgenerators|generator]] has a group of properties called Generation. These properties control how many nodes are created by each generator, where each node is on its parent, and which direction each node is facing. |
- | ===== Modes ===== | + | The Generation |
- | Under the "Generation" group on each generator, there are several different modes to choose from. The first set of properties are unique to the selected mode. The next set is shared | + | |
- | Generators " | + | ===== Mode ===== |
+ | Nodes are generated based on the selected | ||
- | > | + | ==== Classic ==== |
+ | [[genmode_classic|Classic]] mode exists solely | ||
- | === Interval | + | ==== Proportional ==== |
- | [[genmode_interval|Interval]] mode creates nodes at regular intervals along the parent | + | [[genmode_proportional|Proportional]] mode creates nodes based on the size of the parent. This mode is useful |
- | === Phyllotaxy | + | ==== Proportional steps ==== |
- | [[genmode_phyllotaxy|Phyllotaxy]] is the scientific word meaning "the arrangement of leaves on a stem." | + | [[genmode_proportional_steps|Proportional steps]] mode creates |
- | === Bifurcation | + | ==== Absolute ==== |
- | [[genmode_bifurcation|Bifurcation]] mode places | + | [[genmode_absolute|Absolute]] mode creates an exact number of nodes. Use this mode sparingly since it does not adapt to the size of the parent. Specifying exactly one trunk or switching over to this mode to periodically reduce node counts are common uses for this mode. |
- | === Proportional | + | ==== Absolute steps==== |
- | [[genmode_proportional|Proportional]] mode creates nodes based on the size of the parent. This mode is useful for randomly distributing nodes on a parent based on the size of the parent. | + | [[genmode_absolute_steps|Absolute steps]] mode creates |
- | === Proportional Steps === | + | ==== Phyllotaxy ==== |
- | [[genmode_proportional_steps|Proportional Steps]] mode creates a series of steps with each step containing several nodes. | + | [[genmode_phyllotaxy|Phyllotaxy]] mode provides access to many common styles |
- | === Absolute | + | ==== Interval ==== |
- | [[genmode_absolute|Absolute]] mode creates | + | [[genmode_interval|Interval]] mode creates nodes at regular intervals along the parent |
- | === Absolute Steps=== | + | ==== Bifurcation ==== |
- | [[genmode_absolute_steps|Absolute Steps]] creates an absolute number of steps with each step having several nodes. | + | [[genmode_bifurcation|Bifurcation]] mode places nodes on spots where the parent |
- | === Classic | + | ==== Flood ==== |
- | [[genmode_classic|Classic]] mode exists solely to support legacy models | + | [[genmode_flood|Flood]] mode creates an exact number of nodes and places them randomly along the parent. |
+ | ==== Parent ==== | ||
+ | [[[genmode_parent|Parent]] mode creates an exact number of nodes and places them at the origin of the parent. | ||
=====Shared===== | =====Shared===== | ||
The properties in this group apply to all generation modes. | The properties in this group apply to all generation modes. | ||
- | === Boundaries | + | ==== Active |
+ | Set whether a generator is visible based on the active [[kcvfxresolution|Resolution]]. The generator is active when the value of the curve is more than 0.5 and inactive when the value of the curve is less than 0.5. | ||
- | == First == | + | Use this property to swap generators in and out based on the resolution of the model. For example, make a leaf map with only one leaf active in Draft and Low resolution and a leaf map with five leaves active in Medium and High resolution. |
- | The lowest point on the parent where nodes can occur. | + | |
- | == Last == | + | ==== Pass ==== |
- | The highest | + | Determine when a generator is computed. By default, all generators compute in pass 1. A generator’s pass number can’t be lower than that of its ancestors. Pass errors result in an error message. |
+ | ==== Boundaries ==== | ||
+ | === First === | ||
+ | Set the lowest | ||
- | == Clip == | + | === Last === |
- | When enabled, this option removes any nodes that are pushed past the ' | + | Set the highest point on the parent where nodes occur. |
- | == Rotation | + | === Clip === |
- | Rotates all nodes around | + | Remove |
- | > | + | ==== Rotation ==== |
+ | Rotate | ||
- | == Position == | + | **Note:** Use variance to jumble |
- | Shifts all nodes up or down the parent. | + | |
- | > | + | ==== Position ==== |
+ | Shift all nodes up or down the parent. | ||
- | == Size Scalar == | + | **Note:** Use variance to jumble up the position |
- | Scales not only the size of the nodes themselves but also the size of their children. | + | |
- | == Sink == | + | ==== Size scalar ==== |
- | Adjusts | + | Scale the size of the nodes and their children. |
- | == Pruning | + | ==== Sink ==== |
- | This curve removes branches based on their position | + | Adjust the start position |
- | == Click place== | + | ==== Pruning ==== |
- | This property controls how the selected generator responds | + | Remove branches based on their position on their parent (left side corresponds |
- | ^Ready|This generator is ready to accept any click-place action. If more than one eligible generator is ready one will be selected by the system.| | + | ==== Extend parent |
- | ^None|This generator will not accept click-place actions.| | + | |
- | ^Any|Any click-place action will be accepted by this generator, even if other generators will accept it as well.| | + | |
- | ^Number|Only click-place actions with the corresponding ID will be accepted. | + | |
- | + | ||
- | === Extend parent === | + | |
The properties in this group govern extensions. | The properties in this group govern extensions. | ||
- | == Type == | + | === Type === |
- | This option forces an extra node (or nodes) to be generated at the end of the parent branch, regardless of how many were generated by the selected " | + | |
- | ^None|No extension | + | Generate extra nodes at the end of a parent branch, regardless of how many were generated by the selected generation mode. If a [[branch_generator|Branch]] generator extends another Branch, expect a seamless transition between nodes. This can be used successively to go from the trunk to the tip of a twig with no transitions. [[cap_generator|Caps]] are always |
- | ^Any|A node will be generated for each open end of the parent (branches can [[atsplits|split]] into two openings).| | + | |
- | ^Split 1|A node will be generated off the first split (or only open end) of the parent.| | + | |
- | ^Split 2|A node will be generated off the second split (if it exists) | + | |
- | ^Skinny|A node will be generated | + | |
- | ^Fat|A node will be generated off the fatter of the two splits on the parent.| | + | |
- | ^Breaks only|A node will be generated only if the parent is broken.| | + | |
- | ^Bottom|A node will be generated that extends the bottom of the parent.| | + | |
- | >**Note:** Multiple generators can extend a single parent. Use this with splits and the styles "Split 1," "Split 2," " | + | This property only works if the parent node is a Branch generator and the child node is one of the following: |
+ | | ||
+ | | ||
+ | | ||
+ | | ||
- | == Count == | + | ^**Property**^**Description**^ |
- | Controls how many extensions | + | | **None** | No extension nodes are generated.| |
+ | | **Any** | A node is generated for each open end of the parent (branches | ||
+ | | **Split 1** | A node is generated off the first split (or only open end) of the parent.| | ||
+ | | **Split 2** | A node is generated off the second split (if it exists) of the parent.| | ||
+ | | **Skinny** | A node is generated off the skinnier of the two splits | ||
+ | | **Fat** | A node is generated off the fatter of the two splits on the parent.| | ||
+ | | **Breaks only** | A node is generated only if the parent is broken.| | ||
+ | | **Bottom** | A node is generated that extends the bottom of the parent.| | ||
- | === Knockout === | + | **Note:** Multiple generators can extend a single parent. Use this with splits and the styles **Split 1**, **Split 2**, **Skinny**, and **Fat** |
- | == Amount == | + | |
- | Removes nodes randomly after the " | + | |
- | == + Resolution | + | === Count === |
- | Increase this curve to increase the amount of nodes removed by knockout based on the active [[kcvfxresolution|Resolution]]. | + | Control how many extensions can be on any given parent. This option is typically set to one unless multiple branches extending a parent branch is desired. |
- | === Force containers | + | ==== Click place==== |
- | These are containers that control where in 3D space nodes can be generated. By typing | + | Control how the selected generator responds to [[ctclickplacex|click-place]] actions made by the user in Freehand mode. |
- | ^Include|Nodes that fall inside | + | ^**Property**^**Description**^ |
- | ^Exclude|Nodes that fall inside | + | |**Ready**|This generator is ready to accept any click-place action. If more than one eligible generator is ready, one will be selected by the system.| |
+ | |**None**|This generator will not accept click-place actions.| | ||
+ | |**Any**|Any click-place action | ||
+ | |**Number**|Only click-place actions with the corresponding ID will be accepted. **Ready** generators | ||
- | === Masks === | + | ==== Knockout ==== |
- | Assign [[toolmasksbar|mask assets]] here to limit the placement of generated nodes. | + | === Amount === |
+ | Remove nodes randomly after the generation mode creates them but before they are computed. Use the parent curve to target this feature based on the model' | ||
+ | === + Resolution === | ||
+ | Increase or decrease the amount of nodes removed by Knockout based on the active [[kcvfxresolution|Resolution]]. | ||
+ | |||
+ | ==== Force containers ==== | ||
+ | Force containers control where in 3D space nodes can be generated. By typing the name of a [[geometry_forces|geometry force]] in the box, generated nodes will determine if they are inside the box and then act accordingly. | ||
+ | |||
+ | ^**Property**^**Description**^ | ||
+ | |**Include**|Nodes that fall inside the specified geometry force will be created, others will not.| | ||
+ | |**Exclude**|Nodes that fall inside the specified geometry force will not be created, others will.| | ||
+ | |||
+ | ==== Mesh alignment ==== | ||
+ | Align the mesh with the chosen destination. This property only works for Leaf mesh and Batched leaf generators, as well any nodes created using click place. The parent node must be a mesh. | ||
+ | |||
+ | ^**Property**^**Description**^ | ||
+ | | **None** | No mesh alignment. | | ||
+ | | **Tangent** | Align with the surface tangent of the parent mesh. | | ||
+ | | **Binormal** | Align with the surface binormal of the parent mesh. | | ||
+ | | **Parent X** | Align with the X axis of the parent orientation. | | ||
+ | | **Parent Y** | Align with the Y axis of the parent orientation. | | ||
+ | | **Parent Z** | Align with the Z axis of the parent orientation. | | ||
+ | |**World X** | Align with the global X axis. | | ||
+ | | **World Y** | Align with the global Y axis. | | ||
+ | | **World Z** | Align with the global Z axis. | | ||
+ | |||
+ | ==== Masks ==== | ||
+ | Assign [[toolmasksbar|mask assets]] here to limit the placement of generated nodes. |