Edit Guides Operator

Overview

Edit Guides operator is the main hub for editing and managing the guides and hair strands in an Ornatrix hair object. You can interactively plant new guides, delete guides, change their shape in various ways, brush them, and perform other operations which are done by hand instead of parametrically. You can work directly with guide roots, guide vertices or manipulate them using one of several brush tools available.

This operator is broken down into three main sections (or levels) of guide editing. Using these three methods together should allow you to produce any arbitrary hair volume shape, which can then be fine-tuned using the hair modifiers.

Edit Guides also provides tools for guide management like Strand Groups and Stand Channels which allow to apply and filter different effects based on group patterns and paint masking, as well as shading effects in supported render engines.

Ornatrix C4D V2 grooming workflow

Getting started

Select your hair shape and show the hair stack. Use Ornatrix Menu to find the Edit Guides operator button. Click this button to add the Edit Guides operator at the current position of the hair operator stack.

General parameters

A different set of parameters and tools will be displayed in the operator properties window depending on the selected editing mode or if no editing mode is selected.

The parameters in each Ornatrix operator are separated into different categories, Edit Guides operator is separated as Edit Guides, Interpolation Options, Guide Options, Guide Operations, Roots, Guides, Strand Groups, Soft Selection and Channels.

Edit Guides

Edit Modes
Here you will find the two Edit Mode buttons. These two buttons will set the operator into its Strand or Control Point mode, while activating one of the brush contexts will activate the Brushing mode. In each editing mode you will have different ways to interact with and modify the strands.

The editing modes will also allow you to select guides or hair strands by clicking and dragging on the viewport as with any other object. The amount of selected guides will be shown at the bottom of this section. Find more details about the different editing modes in the Roots and Guides sections.

Note If you have one or more hair strands selected press F button at any time to focus the view on their roots.

Apply Amount Parameters
Those parameter will blend the changes made by the current Edit Guides operator using a slider, a ramp curve, a texture multiplier map or a strand channel. It can be used to dial the changes down and can be animated to achieve blending effects between different poses of a hairstyle or isolate the changes to a particular Strand Channel. Multiple Edit Guides operators can be stacked on top of each other for strand change layering.

Using the Apply Amount parameters

Skip Hair Update While Dragging
When on, only guide edits will be displayed while mouse is down and hair will be updated only when mouse is released. Use this option to speed up guide editing for very dense hair.

Interpolation Options

This sections contains options related to strand interpolation when using a brush context.

Multi-resolution

Interpolation

Input Root Interpolation

Re-target Changes
Normally, if the amount of guides is changed by inserting, deleting them or changing the guide interpolation the changes made in Edit Guides will be destroyed. You can mitigate that by using the Re-target function after you made those changes. Ornatrix will try to blend the new guides with the rest, preserving any existing Strand Groups in the process.
Note: This option is only useful if the Multi-Resolution feature is not being used.

Note 2: The parameters in this section do not affect the hair interpolation settings set in Hair from Guides.

Guide Options

This section contains several options related to guide visualization and interaction.

Created Strand Length
Determines the length of newly created strands.

Ignore Backfacing Strands
When on, any guides which are facing away from viewport camera will not be selectable or affected by the brushes.

Show Color Guides
When on, a different color is assigned to each guide based on the strand groups previously created.

Show Vertex Ticks
When ON, points making up the guides will be displayed.

Hide Guides

Guides Width
This parameter is used to change the width of the guides for better visualization.

Guide Operations

This section includes functions for guide management.

Hide
This button will hide the selected guides.

Unhide All
Use this button to reveal the hidden guides.

Freeze
This function is very useful when dealing with a lot of guides and you want to isolate which guides are affected by the brush tools without selecting or hiding them every time.

Unfreeze All
Used to Unfreeze all guides after you are done editing.

Delete Selected Strands
Deletes the selected guides or hair strands.
Note: Ornatrix has a custom way of handling element deletion in shapes. The keyboard Delete button should not be used to delete guides or strands, this action will remove the selected operator. Therefore, you need to use this button instead.

Push Away From Mesh
Used to prevent guide intersection with surface. Use this feature to set a certain distance between each guide vertex and the distribution mesh.
Push Away Distance parameter determines the distance. While the Push Away from Mesh button only runs this operation once, Auto Push Away From Surface will run the operation after each brush stroke, setting the distance to the value previously specified.
- Note: This feature will use the actual distribution surface as collision mesh, it does not allow you to use a different mesh for collision. This means that if the hair is distributed on just a hair scalp extracted from the main character mesh you may get some unexpected result caused by an incomplete surface. If you want to use a custom mesh for collision use the Push Away From Surface operator instead.

Adopt From Stack Top
Captures the current guide shape from the top of the stack into this modifier. Guides will be edited to look like current modifier stack result.

Using Adopt from Stack Top

Roots

The Root section of Edit Guides is designed to work directly with hair roots. There are some fundamental concepts that usually apply to roots such as roots are always located relative to either a surface or object. In most uses, you will deal with roots that are located relative to faces.

The Root level have options to plant, remove, rotate and import splines curves as Ornatrix guides. You can select and deselect roots inside the viewport like you would vertices, faces, or edges on a mesh using standard selection tools. Once selected, you can use the transform tools to move the guides along the surface of the current distribution mesh. This may be needed to tweak the exact position of guides after they were automatically generated by Ornatrix.

Plant Guide Tool

Adds additional guides to your hair object. After activating the tool, click on top of the distribution mesh surface to plant new roots at these locations. As any other Cinema 4D native tool, you can drop the Plant Guides tool by pressing the space key.

Plant Guide Tool options

Adopt Shape
When this option is on, newly planted guides will use the same shape as the selected guide to the location where mouse was clicked.
The closest strands will only be looked up from current strand selection. For example, if only one strand is selected then its shape will always be copied for the newly planted strands. If you want to always have the closest strand shape used then select all strands before planting new strands. Newly created strands are not selected by default.
Guide Length
When Adopt shape option is off newly planted guides will be straight. This option controls the length of newly planted guides.
Point Count
Determines the point count for the newly planted guides.
Post-Plant Selection Behavior
Determines how strand selection changes after a new hair is planted:
- Deselect: All strands are deselected
- Keep Selection: Previously selected strands remain selected, planted strand is not selected
- Select Planted: Only planted strand is selected
- Add Planted to Selection: Planted strand is added to previous selection

Additional Information

Any strand data such as strand channels and strand groups will be inherited from the source strand into the planted strand when Adopt Shape option is used.
The unique strand id for the planted strands will be generated based on the surface dependency information (mesh face index and barycentric coordinate).

Draw Strands

Use it to draw guides or hair strands directly on a polygon mesh. When using this tool with Edit Guides modifier below Hair from Guides modifier it will add guides that will be used for hair interpolation. When this tool is used with Edit Guides operator above Hair from Guides it will add single hair strands that will not be part of the interpolation.
h4. Draw Strands Tool options

Create new Strands
When off, no new strands will be added but existing strands can still be edited if Edit Existing Strands is checked.
Edit Existing Strands
When on, clicking and dragging on existing strands will modify its shape.
Point Count
Sets the point count of the created strands.
Draw Along Surface
When on, the tool allows you to draw strands wrapped to the distribution surface.
Distance from Surface
When Draw Along Surface is checked, this parameter sets the distance at which the strand will be drawn on the surface.
Apply Smoothing
Resample the created strands to smooth out its vertices.
Smooth Amount
This parameter sets the smoothing strength when Apply Smoothing is checked.
Select Edited Strands
When on, each strands is selected after editing it.
Maximum Length
Sets the maximum length for newly created strands.

Rotate Strands

When using Mesh from Strands to convert the hairs to polygon mesh, this tool allows you to manually rotate a strand or a group of strands.

Import Multiple Curves

Opens up a list with all the curve objects in the scene, then you can select and import groups of curves to use as guides in the current hair object. The import dialog have some options to customize the import process.
h4. Import Multiple Curves options

Distance Threshold
If imported curves are further than this value from existing guides they will be added as new guides. Otherwise, existing guides will be updated will their shape.
Custom Point Count
When ON, imported curves will have a specific number of points, otherwise they will have the same number of points as the rest of the existing guides.

Guides

This section deals with everything related to the direct manipulation of strand shapes when working in Edit Control Points mode. The term "direct manipulation" in this case means editing of strand vertices much like you would edit vertices of a mesh. Of course doing that alone would be a nightmare; that is why a set of tools is introduced to organize these strand vertices and manipulate them in a very intuitive manner.

A special IK solver system is used to simplify the task of moving strands. The reason for an IK system is to preserve strand length while editing. Human hair has a very high strength ratio and thus virtually doesn't stretch along its direction. Note that even if you do want hair to stretch (for example if you're doing a length variant hairstyle and would like to form both shape and length at the same time), you can turn off strand length preservation and deal with stretching as well as moving.

To manipulate strands special helpers are used - Control points. Control points can be thought of as vertices located somewhere on hair. Like other vertices in a mesh they can be moved, rotated, and scaled individually or as a group in all transform spaces (world/object/screen etc.). You have the full control over the position of control points along the strand and the influence that they have on each strand.

Control Point Position
Determines the position of the control point or manipulation handle along the strand. Use this slider to position the control point where you want to make the strand deformation.

Control Point Influence
Determines the range of influence of the control point or manipulation handle. Imagine this value as a soft selection range, but instead it works in a per strand point basis.

Preserve Strand Lengths
When on, strands will not be stretched or compressed during brushing.

Ik Iterations
Determines how many times IK solver will iterate before converging on a solution. Generally the higher this value is the slower IK solver will act.

Preserve Strand Geometry
When on, a special algorithm is used for comb, grab, and smooth brushes which affects the whole strand alone its length by calculating the best fit to current stroke while minimizing changes to the strand shapes.

Resample Strands
When on the points on strands will be re-positioned to be equidistant after each brush stroke. This can be useful to retain strands smoothness.

Elastic Mode

Strand Groups

This sections contains tools for creation and management of strand groups.

A strand group is an integer value assigned to each guide or hair strand. Strands belonging to a specific group can be edited separately by various Ornatrix modifiers. Various Ornatrix modifiers provide an option to specify the group index which it will apply to. You can use multiple modifiers to separately style hairs belonging to different groups. See Working with Strand Groups for additional details.

Use Strand Groups
Activate this option to allow the use and creation of strand groups in the selected Edit Guides operator.

Display Strand Groups
Every strand group will have a unique color assigned to it. By default these colors will only affect the guides, not the hair. When this option it's on, the strand group colors will be displayed directly on the hair strands.

Strand Group
Enter the strand group index that you want to assign to the selected guides.

Assign
Assign the strand group index or indices entered in the Strand Group box to the selected guides.

Assign Unique
Assign the next available strand group index to the selected guides. For example, if index 1 has already been used, this command will assign index #2 to the selected guides.

Select by order:
This section includes commands to select the previous index and next index based on the currently selected group.

Select by Group
When on, if you select a single strand that belongs to a strand group, the whole group will be selected.

Strand Channels

This sections contains the tool for creation and management of strand channels.

Strand Channels are additional data added to guides or hair strands in the form of black to white values. Strand channels can be used to control other parameters on all Ornatrix operators, like hair frizz, hair width etc. See Working with Strand Channels for additional details.

Here you will find tools to create or modify strand channels. Channels inside an Edit Guides operator are created non-destructively. This means that any channels already existing before the modifier is applied will not be affected if this modifier is later removed. However, existing channels can be removed by this modifier down the modifier pipeline.

Current Channel Value
Use this slider to choose a value between 0 and 1 or black to white. This is the value that will be assigned to the selected guides when you click the Assign Value button.

Permanent Channel Display
By default the black and white values assigned or painted on the guides in strand channels will be only visible on the guides, and only when an Edit Guides operator is selected in the hair stack. When this option it's on, the strand channel values will be displayed directly on the hair strands and regardless of the selection.

Display Channel Overlay
When Permanent Channel Display it's on, this menu allows you to choose how the channel values will be displayed.
- Single-channel display(greyscale)
  Allows you to display channels that are composed of a single channel.
- Multi-channel display(color)
  Allows you to display channels that are composed of three channels to form other colors: R, G, B.

Strand Channels box
This box contains the list of created channels by category: Per-Strand Channels and Per-Vertex Channels. You can create new channels using the Add button and newly created channels will appear inside this box. Select the Per-Strand channel category and then click Add to create a Per-Strand channel. If you want to create a Per-Vertex channel select the Per-Vertex channel category instead. There are also buttons to Delete, Rename and Select all the channels.

Assign Value
Assign the float value chosen in the Current Channel Value slider to the selected guides.

Select by Value
Allow you to select strands by its strand channel color values suing the Threshold slider to determine the range of values that you want to select.

Threshold
Allows you to select a range of values to be selected when using the Select by Value button.

Ensuring consistent results

Edit Guides operator works by referencing individual guides in your hair structure by their internal index. As such, it is important that once you perform edits with Edit Guides the count and order of input guides below in the operator stack remains the same.

The following could change guide count and order and cause your guide edits to become invalid:

Changing number of guides in Guides from Mesh modifier.
Changing distribution parameters such as method, map, and multiplier in Guides from Mesh modifier.

It is therefore a good practice to use the "Remember Root Positions" option prior to making changes in the Edit Guides operator,

Scripting

Writing custom brushes with Python

Aside from stock set of brushes Ornatrix allows you to easily create your own custom brushes through Python scripts. This is described at detail in the Writing Plugin Brushes section.

Troubleshooting

Guides are corrupt and jumbled

Problem: After making edits and other operations within the scene Edit Guides messes up all of the guides.
Cause: The order and/or count of input guides has changed. Edits made to the guides are being applied to incorrect guides.
Solution: Make sure that you restore the same input guides parameters as they were when you made guide edits. See Ensuring consistent results section for more details.