编织毛发曲线¶

The Braid Hair Curves node deforms existing hair curves into braided strands by grouping nearby curves around guide curves. The deformation creates a multi-strand braid pattern, with options for radius, twist frequency, strand thickness, and an optional flare or tied ending.

This node is designed for grooming workflows where a few curves act as braid guides, and surrounding curves are wrapped around them to form a structured braid.

输入¶

几何数据: The input geometry containing the hair curves to deform into braids.
系数: Controls how strongly the braiding effect is applied. A value of 0.0 leaves the hair unchanged, while 1.0 applies the full braid deformation.
细分: The number of subdivisions applied to curves before deformation. Higher values allow smoother braids at the cost of performance.
编织起始: Controls where along each curve the braid effect begins, measured from the root. Lower values start the braid closer to the root, higher values leave more unbraided length.
半径: The overall radius of the braid. Larger values create a thicker braid by moving the strands farther from the braid center.
形状: Adjusts the radius profile along each curve. This can be used to taper or vary the braid width from root to tip.
频率: Controls how quickly the curves twist around the center of the braid. Higher values create tighter, more frequent wrapping. This input can vary per point along a curve, allowing twists to tighten or loosen along the length.

形状参数¶

最小系数: Minimum radius factor for the braid cross-section. This determines how close strands can get to the braid center.
最大系数: Maximum radius factor for the braid cross-section. This determines how far strands can move outward from the center.
厚(宽)度: The thickness of each strand of hair within the braid.
粗细形状: Adjusts how strand thickness changes along the length of the braid.
形状不对称: Introduces asymmetry in the strand shaping. This breaks perfect radial uniformity, helping the braid feel more organic.
扩张长度: The length of the flare at the end of the braid, where the strands loosen or fan out.
扩张开放度: The radius of that flare at the tip of the braid. Higher values create a wider, more open flare.

发圈¶

发圈输入类型

Defines how the hair tie object (e.g. a band or wrap) is provided for instancing.

物体:: Use an object reference for the hair tie instance.
几何数据:: 直接使用几何体输入。

发圈

The object or geometry used as the hair tie to cap or bind the end of the braid.

缩放

发圈实例的缩放。

引导映射¶

引导编号: A map that specifies which curve should act as the central "guide" for each braid group. If provided, this overrides any existing guide_curve_index attribute, and the Guide Distance and Guide Mask inputs are ignored.
引导距离: The minimum spacing between selected guides when automatically generating a guide map. Larger values result in fewer guides, forming larger braid groups.
引导遮罩: A mask that determines which curves are allowed to be considered as guides.
现有的引导映射: When enabled, use an existing guide map attribute (for example, guide_curve_index) if it is already present. If this is disabled and Guide Index is not provided, a new guide map is generated using Guide Distance and Guide Mask. Creating the guide map ahead of time, in a separate node or modifier, gives more precise control over which curves act as braid guides.

输出¶

几何数据: The resulting geometry with braided deformation applied.
张开参数: A value from 0 to 1 indicating the position along the braid flare region. This can be used for shading or for adding effects (such as tying, binding, or loosening near the braid tip).
发股线编号: An index identifying which strand of the braid each curve belongs to within its braid group.

引导映射¶

引导编号: The guide index map actually used to generate the braid. If a new guide map was created by this node, it is provided here for reuse downstream.