View source for Project SOP

{{Summary			
	|OPtype=project		
	|OPlabel=Project		
	|short=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.		
	|OPclass=projectSOP_Class		
	|OPfamily=SOP		
	|long=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:			
			
[[Image: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).			
			
===<div class="subSectionLineSOP"> Additional Operations for Profile Curves </div>===			
			
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. 			
	|OPlicense=Non-Commercial		
	|OPfilter=True		
}}			
{{ParMiniMenu			
	|Paritems=		
	|Parlabel=Face Group		
	|OPtype=project		
	|OPfamily=SOP		
	|Parsummary=The group of faces to be projected onto the spline surfaces. Accepts patterns, as described in [[Pattern Matching]].		
	|Parorder=0		
	|Parname=facegroup		
}}			
{{ParMiniMenu			
	|Paritems=		
	|Parlabel=Surface Group		
	|OPtype=project		
	|OPfamily=SOP		
	|Parsummary=The group of surfaces to project faces onto. Accepts patterns, as described in [[Pattern Matching]].		
	|Parorder=1		
	|Parname=surfgroup		
}}			
{{ParMenu			
	|Paritems=		
	{{Menuitem		
		|Itemname=allseq	
		|Itemsummary=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.	
		|Itemlabel=All on Each Surface in Sequence	
		|OPfamily=SOP	
		|Parname=cycle	
	}}		
	{{Menuitem		
		|Itemname=allover	
		|Itemsummary=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.	
		|Itemlabel=All on Each Surface Overlapping	
		|OPfamily=SOP	
		|Parname=cycle	
	}}		
	{{Menuitem		
		|Itemname=oneeach	
		|Itemsummary=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.	
		|Itemlabel=One per Surface	
		|OPfamily=SOP	
		|Parname=cycle	
	}}		
	{{Menuitem		
		|Itemname=cycled	
		|Itemsummary= This is the same as <span class="tipTextSOP">One Per Surface</span>, above, but starts the faces again if there are surfaces left.	
		|Itemlabel=Cycled	
		|OPfamily=SOP	
		|Parname=cycle	
	}}		
			
	|Parlabel=Cycle Type		
	|OPtype=project		
	|OPfamily=SOP		
	|Parsummary=		
	|Parorder=2		
	|Parname=cycle		
}}			
{{ParameterPage			
	|Pagename=Along Vector		
	|Pagesummary====<div class="subSectionLineSOP">Along Vector </div>===		
			
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.			
	|OPfamily=SOP		
	|items=		
	{{ParMenu		
		|Paritems=	
		{{Menuitem	
			|Itemname=xaxis
			|Itemsummary=Cartesian axis X, Y, or Z.
			|Itemlabel=X
			|OPfamily=SOP
			|Parname=axis
		}}	
		{{Menuitem	
			|Itemname=yaxis
			|Itemsummary=Cartesian axis X, Y, or Z.
			|Itemlabel=Y
			|OPfamily=SOP
			|Parname=axis
		}}	
		{{Menuitem	
			|Itemname=zaxis
			|Itemsummary=Cartesian axis X, Y, or Z.
			|Itemlabel=Z
			|OPfamily=SOP
			|Parname=axis
		}}	
		{{Menuitem	
			|Itemname=fnorm
			|Itemsummary=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.
			|Itemlabel=Face Normal
			|OPfamily=SOP
			|Parname=axis
		}}	
		{{Menuitem	
			|Itemname=mindist
			|Itemsummary=Projects the entire 3D face along the vectors of minimum distance to the surface. The projection resolution is given by the <span class="tipTextSOP">Divisions per Span</span> value.
			|Itemlabel=Minimum Distance
			|OPfamily=SOP
			|Parname=axis
		}}	
		{{Menuitem	
			|Itemname=other
			|Itemsummary=Enables the <span class="tipTextSOP">Vector</span> fields immediately below to specify the X, Y, and Z components of the vector.
			|Itemlabel=User Defined:
			|OPfamily=SOP
			|Parname=axis
		}}	
			
		|Parlabel=Axis	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=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.	
		|Parorder=0	
		|Parname=axis	
	}}		
	{{ParFloat		
		|Paritems=	
		{{floatitem	
			|Itemname=vector1
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=vector
		}}	
		{{floatitem	
			|Itemname=vector2
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=vector
		}}	
		{{floatitem	
			|Itemname=vector3
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=vector
		}}	
			
		|Parlabel=Vector	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=1	
		|Parname=vector	
	}}		
	{{ParMenu		
		|Paritems=	
		{{Menuitem	
			|Itemname=closest
			|Itemsummary=
			|Itemlabel=Closest
			|OPfamily=SOP
			|Parname=projside
		}}	
		{{Menuitem	
			|Itemname=farthest
			|Itemsummary=
			|Itemlabel=Farthest
			|OPfamily=SOP
			|Parname=projside
		}}	
			
		|Parlabel=Side	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=2	
		|Parname=projside	
	}}		
	{{ParInteger		
		|Parlabel=Divisions per Span	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=3	
		|Parname=sdivs	
	}}		
	{{ParFloat		
		|Parlabel=Ray Tolerance	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=4	
		|Parname=rtolerance	
	}}		
	{{ParFloat		
		|Parlabel=Fit Tolerance	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=5	
		|Parname=ftolerance	
	}}		
	{{ParFloat		
		|Parlabel=Max UV Gap (%)	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=6	
		|Parname=uvgap	
	}}		
	{{ParInteger		
		|Parlabel=Order	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=7	
		|Parname=order	
	}}		
	{{ParToggle		
		|Parlabel=Preserve Sharp Corners	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=8	
		|Parname=csharp	
	}}		
	{{ParToggle		
		|Parlabel=Super Accurate Projection	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=9	
		|Parname=accurate	
	}}		
			
}}			
{{ParameterPage			
	|Pagename=Parametrically		
	|Pagesummary=		
	|OPfamily=SOP		
	|items=		
	{{ParMenu		
		|Paritems=	
		{{Menuitem	
			|Itemname=uvx
			|Itemsummary=
			|Itemlabel=X Coordinate
			|OPfamily=SOP
			|Parname=ufrom
		}}	
		{{Menuitem	
			|Itemname=uvy
			|Itemsummary=
			|Itemlabel=Y Coordinate
			|OPfamily=SOP
			|Parname=ufrom
		}}	
		{{Menuitem	
			|Itemname=uvz
			|Itemsummary=
			|Itemlabel=Z Coordinate
			|OPfamily=SOP
			|Parname=ufrom
		}}	
			
		|Parlabel=U from	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=0	
		|Parname=ufrom	
	}}		
	{{ParMenu		
		|Paritems=	
		{{Menuitem	
			|Itemname=uvx
			|Itemsummary=
			|Itemlabel=X Coordinate
			|OPfamily=SOP
			|Parname=vfrom
		}}	
		{{Menuitem	
			|Itemname=uvy
			|Itemsummary=
			|Itemlabel=Y Coordinate
			|OPfamily=SOP
			|Parname=vfrom
		}}	
		{{Menuitem	
			|Itemname=uvz
			|Itemsummary=
			|Itemlabel=Z Coordinate
			|OPfamily=SOP
			|Parname=vfrom
		}}	
			
		|Parlabel=V from	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=1	
		|Parname=vfrom	
	}}		
	{{ParToggle		
		|Parlabel=Map Profile to Range:	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=2	
		|Parname=userange	
	}}		
	{{ParFloat		
		|Paritems=	
		{{floatitem	
			|Itemname=urange1
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=urange
		}}	
		{{floatitem	
			|Itemname=urange2
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=urange
		}}	
			
		|Parlabel=U Range	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=3	
		|Parname=urange	
	}}		
	{{ParFloat		
		|Paritems=	
		{{floatitem	
			|Itemname=vrange1
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=vrange
		}}	
		{{floatitem	
			|Itemname=vrange2
			|Itemsummary=
			|Itemlabel=""
			|OPfamily=SOP
			|Parname=vrange
		}}	
			
		|Parlabel=V Range	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=4	
		|Parname=vrange	
	}}		
	{{ParMenu		
		|Paritems=	
		{{Menuitem	
			|Itemname=unif
			|Itemsummary=
			|Itemlabel=Uniform
			|OPfamily=SOP
			|Parname=maptype
		}}	
		{{Menuitem	
			|Itemname=chordlen
			|Itemsummary=
			|Itemlabel=Chord Length
			|OPfamily=SOP
			|Parname=maptype
		}}	
			
		|Parlabel=Mapping Type	
		|OPtype=project	
		|OPfamily=SOP	
		|Parsummary=	
		|Parorder=5	
		|Parname=maptype	
	}}		
			
}}			
{{History			
}}			
{{SOPNavBox			
	|OPfamily=SOP		
}}			
{{#invoke:Category			
	|list|SOPs}}