Project SOP

From TouchDesigner 088 Wiki

Summary

The Project SOP creates curves on surface (also known as trim or profile curves) by projecting a 3D face onto a spline surface, much like a light casts a 2D shadow onto a 3D surface. There are two projection methods: along a vector, or by mapping the face directly onto the parametric space of the surface.

You will usually need a Trim SOP, Bridge SOP, or Profile SOP after a Project SOP. For example, in the case of a Trim SOP we might have:

TouchGeometry146.gif

Use a Trim SOP to cut a hole in the projected surface (as shown above).

Use a Bridge SOP to skin the profile curve to another profile curve.

Use a Profile SOP to extract the curve on surface or remap its position.

If you end up with a profile curve that is not visible, it may still exist. Confirm a profile curve's existence by clicking on the SOP's info pop-up (using middle-mouse button).

Additional Operations for Profile Curves

To delete a projected curve, use a Delete SOP, and enter the profile number (e.g. 1.4 returns the fifth profile on the second primitive (counting starts at 0) ). You can visualise the number of the profiles by enabling the Profile Number icon in the Viewport Display options.

You can group the profile curves with a Group SOP. Do this by typing the profile numbers in the Pattern field. You can use all regular expressions.

You can apply parametric affine transformations to the profile by using a Primitive SOP. You can also use the Primitive SOP to open, close, reverse, and cycle the profile curves.

Note: When applying transformations to a profile in the Primitive SOP, you can only rotate about the Z axis because the projected curve is a planar curve that lives in the domain of the surface. Therefore it wouldn't make any sense to allow rotations in X or Y for profiles.

PythonIcon.png projectSOP_Class

Parameters

Face Group /facegroup - The group of faces to be projected onto the spline surfaces. Accepts patterns, as described in Pattern Matching.

Surface Group /surfgroup - The group of surfaces to project faces onto. Accepts patterns, as described in Pattern Matching.

Cycle Type /cycle

  • All On Each In Surface in sequence - If projected parametrically, the spatial relationship between the faces will be preserved. For example, if the text "hello" is projected parametrically and in sequence, the letters will appear on the surface naturally, side by side. Sequence is not applicable if projecting along a vector.
  • All On Each Surface Overlapping - If projected parametrically, the spatial relationship between the faces is not preserved, so they will appear overlapped in the area of the domain chosen for projection. Overlapping is not applicable if projecting along a vector.
  • One Per Surface - Each face is projected onto a surface in the order in which the face and the surface appear in the input or in their respective groups.
  • Cycled - This is the same as One Per Surface, above, but starts the faces again if there are surfaces left.

Along Vector

The face is projected along a 3D vector and its image on the surface is converted into a curve on the surface. One spatial curve may generate several profiles depending on its position relative to the surface, the shape of the surface, and the chosen projection side. If the projected face does not intersect the surface at all, no profile curve will be generated.

Axis /axis - The axis along which the four corners of the feature are projected onto the base. When adding the feature from the outside as a Vector paste.

  • X / Y / Z - Cartesian axis X, Y, or Z.
  • Face Normal - Projection axis occurs along each face's normal. Thus, each face could potentially have a different projection direction than the others. The option also works well for non-planar faces.
  • Minimum Distance - Projects the entire 3D face along the vectors of minimum distance to the surface. The projection resolution is given by the Divisions per Span value.
  • User Defined: - Enables the Vector fields immediately below to specify the X, Y, and Z components of the vector.

Note: When the Minimum Distance option is selected, the Side button becomes disabled because it's irrelevant for this projection type.

Vector /vector - The X, Y, and Z components of the projection vector if none of the main axes is chosen in the Axis parameter above.

Side /projside

  • Closest - Will project the face onto the closest part of the surface in either direction of projection vector. For example, if a curve being projected onto a tube is inside the tube, it will yield two profiles, one on each side of the tube; if the curve is outside the tube, it will project onto the side closest to it.
  • Farthest - The reverse of Closest. In the example above, Farthest would also yield two images if the curve is inside the tube, but it will choose the farthest side if the curve is outside the tube.

Divisions Per Span /sdivs - The number of points to be computed on the spatial face between successive spans. A span is the line connecting two consecutive CVs on a polygon, or the arc between two breakpoints on a spline curve. The projection tends to become more accurate as the number of divisions increases.

Ray Tolerance /rtolerance - Controls the precision of the ray intersection with the surface. The ray is cast along the projection vector from every point of the 3-D curve.

Fit Tolerance /ftolerance - Controls the 2-D fitting precision and is typically less than 0.01.

Max UV Gap (%) /uvgap - This specifies what percentage of the size of the surface domain is acceptable for two separate profiles to be joined into a single curve.

Order /order - The spline order of the resulting profile curve. The type of curve (Bzier or NURBS) is inherited from the spatial curve. The order, however, is not inherited because the spline order provides useful control over the quality of the fit. If the spatial face is a polygon, the profile will be a NURBS curve.

Preserve Sharp Corners /csharp - Controls the precision with which sharp corners in the projection curve are interpolated. It should be on when the projection has areas of high changes in curvature.

Super Accurate Projection /accurate - Use a very accurate yet expensive algebraic pruning algorithm to determine the intersection of the vector with the surface.

Parametrically

The spatial size of the faces is mapped directly onto the domain of the spline surface. The resulting projection is sensitive to the parameterization of the surface and is likely to appear distorted. It is, however, the fastest of the two projection types and tends to behave well on surfaces with regular shapes and chord-length parameterizations.

U From /ufrom - Specifies which of the spatial coordinates - X, Y, or Z - must be mapped to the U parametric direction of the surface.

V From /vfrom - Specifies which of the spatial coordinates - X, Y, or Z - must be mapped to the V parametric direction of the surface.

Map Profile to Range /userange - This option is on by default. It causes the profile to be scaled and translated to fit within the surface's domain ranges described below. If this option is off, the profile's coordinates are mapped onto the surface domain without any transformation; consequently, the profile will not be visible if its points are not inside the domain of the target surface.

Typically, the projected face should not be mapped to the U/V range if it was previously extracted from the same surface using the Profile SOP with the Parametrically to XY option selected.

The extraction and re-projection tandem can be very useful in achieving the modeling goals currently attainable only with 3D curves. Such tasks include the ability to edit the points of a profile, joining, stitching, or filleting profiles together, carving or refining profiles, etc. By extracting a profile parametrically to XY, Touch creates a 3D face that is identical to the 2D profile but has an additional (constant) Z component.

The resulting 3D curve can be modeled using all the 3D tools available. Finally, the modeled 3D face can be reapplied onto the surface parametrically, making sure that the range mapping option is off.

U Range /urange1, 2 - Indicates in percentages what part of the U surface domain is the mapping area. A full range of 0-1 will cause the profiles to be mapped to the entire domain in the U parametric direction. The range is not restricted to the 0-1 interval.

V range /vrange1, 2 - Indicates in percentages what part of the V surface domain is the mapping area. A full range of 0-1 will cause the profiles to be mapped to the entire domain in the V parametric direction. The range is not restricted to the 0-1 interval.

Mapping Type /maptype

  • Uniform - mapping converts the spatial coordinates of the projection faces to (U,V) points in the domain of the surface without taking into account the parameterization of the surface.
  • Chord Length - mapping takes into account the surface parameterization and attempts to compute a projection best suited to the spatial and parametric determinants of the model.

If the face is not mapped to range, it's vertices will be transferred to the profile without any transformation. Use this technique together with the parametric extraction in the Profile SOP to edit the points of a profile generated by a SOP other than Project: extract, edit the points, then project again.

Tips

NURBS Scalp Patch for Hair

The: Along Vector > Axis > Minimum Distance option is extremely useful, say in the following situation: You have a NURBS surface of a head, and you want to obtain a NURBS patch by projecting a hairline onto the head's surface. You could:

Template the NURBS head.

Enter a Model SOP.

Enable the Snap to Template option in the Model Editor (Snap options).

Draw a NURBS curve along the surface of the head where you want the hairline. Then, with the Project SOP, you select the Minimum Distance option, and you have a profile curve with which you can trim the surface of the head to obtain the patch.

Thus having obtained a NURBS patch for the scalp, you could use it as the base for hair.

Example

  1. Place a Circle SOP - Type: NURBS, Radius: 0.3, 0.3; then place a Tube SOP - Type: NURBS.
  2. Connect them into a Project SOP - Circle to Input1; Tube to Input2.
  3. Append a Trim SOP to the Project SOP - it trims the surface according to the projection provided by the Project SOP. You need to append a Trim SOP to a Project SOP in order to realise this trimming action.
  4. Enable the template flags on the Circle and Tube SOPs; make the Project SOP the display SOP.

TouchGeometry36.gif

See Also