Difference between revisions of "Tube SOP"

From Derivative
Jump to navigation Jump to search
(TD Editor)
m
Tag: 2021.10000
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Summary
+
{{Summary
|OPtype=tube
+
|opType=tube
|OPlabel=Tube
+
|opLabel=Tube
|short=The Tube SOP generates open or closed tubes, cones, or pyramids along the X, Y or Z axes.
+
|short=The Tube SOP generates open or closed tubes, cones, or pyramids along the X, Y or Z axes.
|OPclass=tubeSOP_Class
+
|opClass=tubeSOP_Class
|OPfamily=SOP
+
|opFamily=SOP
|long=The Tube SOP generates open or closed tubes, cones, or pyramids along the X, Y or Z axes. It outputs as meshes, polygons or simply a tube [[primitive]].
+
|long=The Tube SOP generates open or closed tubes, cones, or pyramids along the X, Y or Z axes. It outputs as meshes, polygons or simply a tube [[Primitive]].
|OPlicense=Non-Commercial
+
|opLicense=Non-Commercial
|OPfilter=False
+
|opFilter=False
}}
+
}}
{{ParameterPage
+
{{ParameterPage
|Pagename=Tube
+
|pageName=Tube
|Pagesummary=
+
|pageSummary=
|OPfamily=SOP
+
|opFamily=SOP
|items=
+
|items={{Parameter
{{ParMenu
+
|parItems={{ParameterItem
|Paritems=
+
|itemName=prim
{{Menuitem
+
|itemSummary=
|Itemname=prim
+
|itemLabel=Primitive
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Primitive
+
|parName=type
|OPfamily=SOP
+
}}<!--
|Parname=type
+
-->{{ParameterItem
}}
+
|itemName=poly
{{Menuitem
+
|itemSummary=
|Itemname=poly
+
|itemLabel=Polygon
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Polygon
+
|parName=type
|OPfamily=SOP
+
}}<!--
|Parname=type
+
-->{{ParameterItem
}}
+
|itemName=mesh
{{Menuitem
+
|itemSummary=
|Itemname=mesh
+
|itemLabel=Mesh
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Mesh
+
|parName=type
|OPfamily=SOP
+
}}<!--
|Parname=type
+
-->{{ParameterItem
}}
+
|itemName=nurbs
{{Menuitem
+
|itemSummary=
|Itemname=nurbs
+
|itemLabel=NURBS
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=NURBS
+
|parName=type
|OPfamily=SOP
+
}}<!--
|Parname=type
+
-->{{ParameterItem
}}
+
|itemName=bezier
{{Menuitem
+
|itemSummary=
|Itemname=bezier
+
|itemLabel=Bezier
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Bezier
+
|parName=type
|OPfamily=SOP
+
}}
|Parname=type
+
|parLabel=Primitive Type
}}
+
|opType=tube
+
|opFamily=SOP
|Parlabel=Primitive Type
+
|parSummary=Select from the following types. For information on the different types, see the [[:Category:Geometry|Geometry]] category articles.
|OPtype=tube
+
|parOrder=0
|OPfamily=SOP
+
|parName=type
|Parsummary=
+
|parType=Menu
|Parorder=0
+
|parReadOnly=
|Parname=type
+
}}
}}
+
{{Parameter
{{ParMenu
+
|parItems={{ParameterItem
|Paritems=
+
|itemName=rows
{{Menuitem
+
|itemSummary=Creates horizontal lines.
|Itemname=rows
+
|itemLabel=Rows
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Rows
+
|parName=surftype
|OPfamily=SOP
+
}}<!--
|Parname=surftype
+
-->{{ParameterItem
}}
+
|itemName=cols
{{Menuitem
+
|itemSummary=Creates vertical lines.
|Itemname=cols
+
|itemLabel=Columns
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Columns
+
|parName=surftype
|OPfamily=SOP
+
}}<!--
|Parname=surftype
+
-->{{ParameterItem
}}
+
|itemName=rowcol
{{Menuitem
+
|itemSummary=Both Rows and Columns. Looks like Quads in wire frame display, but all polygons are open (if the primitive type is polygon).
|Itemname=rowcol
+
|itemLabel=Rows and Columns
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Rows and Columns
+
|parName=surftype
|OPfamily=SOP
+
}}<!--
|Parname=surftype
+
-->{{ParameterItem
}}
+
|itemName=triangles
{{Menuitem
+
|itemSummary=Build the grid with Triangles.
|Itemname=triangles
+
|itemLabel=Triangles
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Triangles
+
|parName=surftype
|OPfamily=SOP
+
}}<!--
|Parname=surftype
+
-->{{ParameterItem
}}
+
|itemName=quads
{{Menuitem
+
|itemSummary=Generates sides composed of quadrilaterals (default).
|Itemname=quads
+
|itemLabel=Quadrilaterals
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Quadrilaterals
+
|parName=surftype
|OPfamily=SOP
+
}}<!--
|Parname=surftype
+
-->{{ParameterItem
}}
+
|itemName=alttriangles
{{Menuitem
+
|itemSummary=Generates triangles that are opposed; similar to the Triangles option.
|Itemname=alttriangles
+
|itemLabel=Alternating Triangles
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Alternating Triangles
+
|parName=surftype
|OPfamily=SOP
+
}}
|Parname=surftype
+
|parLabel=Connectivity
}}
+
|opType=tube
+
|opFamily=SOP
|Parlabel=Connectivity
+
|parSummary=This option is used to select the type of surface, when using a Mesh Primitive Type.
|OPtype=tube
+
|parOrder=1
|OPfamily=SOP
+
|parName=surftype
|Parsummary=
+
|parType=Menu
|Parorder=1
+
|parReadOnly=
|Parname=surftype
+
}}
}}
+
{{Parameter
{{ParMenu
+
|parItems={{ParameterItem
|Paritems=
+
|itemName=x
{{Menuitem
+
|itemSummary=
|Itemname=x
+
|itemLabel=X Axis
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=X Axis
+
|parName=orient
|OPfamily=SOP
+
}}<!--
|Parname=orient
+
-->{{ParameterItem
}}
+
|itemName=y
{{Menuitem
+
|itemSummary=
|Itemname=y
+
|itemLabel=Y Axis
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Y Axis
+
|parName=orient
|OPfamily=SOP
+
}}<!--
|Parname=orient
+
-->{{ParameterItem
}}
+
|itemName=z
{{Menuitem
+
|itemSummary=
|Itemname=z
+
|itemLabel=Z Axis
|Itemsummary=
+
|opFamily=SOP
|Itemlabel=Z Axis
+
|parName=orient
|OPfamily=SOP
+
}}
|Parname=orient
+
|parLabel=Orientation
}}
+
|opType=tube
+
|opFamily=SOP
|Parlabel=Orientation
+
|parSummary=Primary axis of tube (long axis).
|OPtype=tube
+
|parOrder=2
|OPfamily=SOP
+
|parName=orient
|Parsummary=
+
|parType=Menu
|Parorder=2
+
|parReadOnly=
|Parname=orient
+
}}
}}
+
{{Parameter
{{ParToggle
+
|parLabel=Orient Bounds
|Parlabel=Modify Bounds
+
|opType=tube
|OPtype=tube
+
|opFamily=SOP
|OPfamily=SOP
+
|parSummary=Available only when an input is connected to the Tube SOP to set bounds for the tube. When Orient Bounds = On it will rotate the geometry to match the orientation of the input SOP used for bounds. 
|Parsummary=
+
|parOrder=3
|Parorder=3
+
|parName=orientbounds
|Parname=modifybounds
+
|parType=Toggle
}}
+
|parReadOnly=
{{ParFloat
+
|parItems=
|Paritems=
+
}}
{{floatitem
+
{{Parameter
|Itemname=tx
+
|parLabel=Modify Bounds
|Itemsummary=
+
|opType=tube
|Itemlabel=X
+
|opFamily=SOP
|OPfamily=SOP
+
|parSummary=Enabled only when an input is connected to the Tube SOP to set bounds for the tube. Turn Modify Bounds = On to enable the transform parameters below to further modify the position, scale, radius and height of the bounds.
|Parname=t
+
|parOrder=4
}}
+
|parName=modifybounds
{{floatitem
+
|parType=Toggle
|Itemname=ty
+
|parReadOnly=
|Itemsummary=
+
|parItems=
|Itemlabel=Y
+
}}
|OPfamily=SOP
+
{{Parameter
|Parname=t
+
|opFamily=SOP
}}
+
|opType=tubeSOP
{{floatitem
+
|parLabel=Rotate Order
|Itemname=tz
+
|parName=rord
|Itemsummary=
+
|parType=Menu
|Itemlabel=Z
+
|parReadOnly=
|OPfamily=SOP
+
|parOrder=5
|Parname=t
+
|parSummary=
}}
+
|parItems={{ParameterItem
+
|opFamily=SOP
|Parlabel=Center
+
|parName=rord
|OPtype=tube
+
|itemLabel=Rx Ry Rz
|OPfamily=SOP
+
|itemName=xyz
|Parsummary=
+
|itemSummary=
|Parorder=4
+
}}<!--
|Parname=t
+
-->{{ParameterItem
}}
+
|opFamily=SOP
{{ParFloat
+
|parName=rord
|Paritems=
+
|itemLabel=Rx Rz Ry
{{floatitem
+
|itemName=xzy
|Itemname=rad1
+
|itemSummary=
|Itemsummary=
+
}}<!--
|Itemlabel=""
+
-->{{ParameterItem
|OPfamily=SOP
+
|opFamily=SOP
|Parname=rad
+
|parName=rord
}}
+
|itemLabel=Ry Rx Rz
{{floatitem
+
|itemName=yxz
|Itemname=rad2
+
|itemSummary=
|Itemsummary=
+
}}<!--
|Itemlabel=""
+
-->{{ParameterItem
|OPfamily=SOP
+
|opFamily=SOP
|Parname=rad
+
|parName=rord
}}
+
|itemLabel=Ry Rz Rx
+
|itemName=yzx
|Parlabel=Radius
+
|itemSummary=
|OPtype=tube
+
}}<!--
|OPfamily=SOP
+
-->{{ParameterItem
|Parsummary=
+
|opFamily=SOP
|Parorder=5
+
|parName=rord
|Parname=rad
+
|itemLabel=Rz Rx Ry
}}
+
|itemName=zxy
{{ParFloat
+
|itemSummary=
|Parlabel=Height
+
}}<!--
|OPtype=tube
+
-->{{ParameterItem
|OPfamily=SOP
+
|opFamily=SOP
|Parsummary=
+
|parName=rord
|Parorder=6
+
|itemLabel=Rz Ry Rx
|Parname=height
+
|itemName=zyx
}}
+
|itemSummary=
+
}}
}}
+
}}
{{ParameterPage
+
{{Parameter
|Pagename=Detail
+
|parItems={{ParameterItem
|Pagesummary=
+
|itemName=tx
|OPfamily=SOP
+
|itemSummary=
|items=
+
|itemLabel=X
{{ParToggle
+
|opFamily=SOP
|Parlabel=Imperfect
+
|parName=t
|OPtype=tube
+
}}<!--
|OPfamily=SOP
+
-->{{ParameterItem
|Parsummary=
+
|itemName=ty
|Parorder=0
+
|itemSummary=
|Parname=imperfect
+
|itemLabel=Y
}}
+
|opFamily=SOP
{{ParInteger
+
|parName=t
|Parlabel=Rows
+
}}<!--
|OPtype=tube
+
-->{{ParameterItem
|OPfamily=SOP
+
|itemName=tz
|Parsummary=
+
|itemSummary=
|Parorder=1
+
|itemLabel=Z
|Parname=rows
+
|opFamily=SOP
}}
+
|parName=t
{{ParInteger
+
}}
|Parlabel=Columns
+
|parLabel=Center
|OPtype=tube
+
|opType=tube
|OPfamily=SOP
+
|opFamily=SOP
|Parsummary=
+
|parSummary=Location of the tube center from the object origin.
|Parorder=2
+
|parOrder=6
|Parname=cols
+
|parName=t
}}
+
|parType=XYZ
{{ParInteger
+
|parReadOnly=
|Parlabel=U Order
+
}}
|OPtype=tube
+
{{Parameter
|OPfamily=SOP
+
|opFamily=SOP
|Parsummary=
+
|opType=tubeSOP
|Parorder=3
+
|parLabel=Rotate
|Parname=orderu
+
|parName=r
}}
+
|parType=XYZ
{{ParInteger
+
|parReadOnly=
|Parlabel=V Order
+
|parOrder=7
|OPtype=tube
+
|parSummary=
|OPfamily=SOP
+
|parItems={{ParameterItem
|Parsummary=
+
|opFamily=SOP
|Parorder=4
+
|parName=r
|Parname=orderv
+
|itemLabel=Rotate
}}
+
|itemName=rx
{{ParToggle
+
|itemSummary=
|Parlabel=End Caps
+
}}<!--
|OPtype=tube
+
-->{{ParameterItem
|OPfamily=SOP
+
|opFamily=SOP
|Parsummary=
+
|parName=r
|Parorder=5
+
|itemLabel=Rotate
|Parname=cap
+
|itemName=ry
}}
+
|itemSummary=
{{ParMenu
+
}}<!--
|Paritems=
+
-->{{ParameterItem
{{Menuitem
+
|opFamily=SOP
|Itemname=off
+
|parName=r
|Itemsummary=
+
|itemLabel=Rotate
|Itemlabel=Off
+
|itemName=rz
|OPfamily=SOP
+
|itemSummary=
|Parname=texture
+
}}
}}
+
}}
{{Menuitem
+
{{Parameter
|Itemname=rowcol
+
|parItems={{ParameterItem
|Itemsummary=
+
|itemName=rad1
|Itemlabel=Row & Columns
+
|itemSummary=
|OPfamily=SOP
+
|itemLabel=""
|Parname=texture
+
|opFamily=SOP
}}
+
|parName=rad
+
}}<!--
|Parlabel=Texture Coordinates
+
-->{{ParameterItem
|OPtype=tube
+
|itemName=rad2
|OPfamily=SOP
+
|itemSummary=
|Parsummary=
+
|itemLabel=""
|Parorder=6
+
|opFamily=SOP
|Parname=texture
+
|parName=rad
}}
+
}}
+
|parLabel=Radius
}}
+
|opType=tube
{{ParToggle
+
|opFamily=SOP
|Parlabel=Compute Normals
+
|parSummary=The first field is the radius of the top of the tube and the second field represents the radius of the bottom of the tube.
|OPtype=tube
+
|parOrder=8
|OPfamily=SOP
+
|parName=rad
|Parsummary=
+
|parType=Float
|Parorder=1
+
|parReadOnly=
|Parname=normals
+
}}
}}
+
{{Parameter
{{History
+
|parLabel=Height
}}
+
|opType=tube
{{SOPNavBox
+
|opFamily=SOP
|OPfamily=SOP
+
|parSummary=The height of the tube.
}}
+
|parOrder=9
{{#invoke:Category
+
|parName=height
|list|SOPs}}
+
|parType=Float
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|opFamily=SOP
 +
|opType=tubeSOP
 +
|parLabel=Anchor U
 +
|parName=anchoru
 +
|parType=Float
 +
|parReadOnly=
 +
|parOrder=10
 +
|parSummary=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|opFamily=SOP
 +
|opType=tubeSOP
 +
|parLabel=Anchor V
 +
|parName=anchorv
 +
|parType=Float
 +
|parReadOnly=
 +
|parOrder=11
 +
|parSummary=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|opFamily=SOP
 +
|opType=tubeSOP
 +
|parLabel=Anchor W
 +
|parName=anchorw
 +
|parType=Float
 +
|parReadOnly=
 +
|parOrder=12
 +
|parSummary=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|parLabel=Imperfect
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=This option applies only to Bezier and NURBS types. If selected, the tube is an approximated nonrational curve, otherwise it is a perfect rational curve.
 +
|parOrder=13
 +
|parName=imperfect
 +
|parType=Toggle
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
}}
 +
{{ParameterPage
 +
|pageName=Detail
 +
|pageSummary=
 +
|opFamily=SOP
 +
|items={{Parameter
 +
|parLabel=Rows
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=Number of rows in tube.
 +
|parOrder=0
 +
|parName=rows
 +
|parType=Int
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|parLabel=Columns
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=Number of columns in tube.
 +
|parOrder=1
 +
|parName=cols
 +
|parType=Int
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|parLabel=U Order
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=If a spline surface is selected, it is built at this order for U.
 +
|parOrder=2
 +
|parName=orderu
 +
|parType=Int
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|parLabel=V Order
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=If a spline surface is selected, it is built at this order for V.
 +
|parOrder=3
 +
|parName=orderv
 +
|parType=Int
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|parLabel=End Caps
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary= If selected, it adds faceted end caps to the ends of the tube.
 +
|parOrder=4
 +
|parName=cap
 +
|parType=Toggle
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter
 +
|parItems={{ParameterItem
 +
|itemName=off
 +
|itemSummary=No UV coordinates added to surface.
 +
|itemLabel=Off
 +
|opFamily=SOP
 +
|parName=texture
 +
}}<!--
 +
-->{{ParameterItem
 +
|itemName=rowcol
 +
|itemSummary=Adds vertex UV coordinates.
 +
|itemLabel=Row & Columns
 +
|opFamily=SOP
 +
|parName=texture
 +
}}
 +
|parLabel=Texture Coordinates
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=Adds UV texture coordinates to the sphere.
 +
|parOrder=5
 +
|parName=texture
 +
|parType=Menu
 +
|parReadOnly=
 +
}}
 +
{{Parameter
 +
|parLabel=Compute Normals
 +
|opType=tube
 +
|opFamily=SOP
 +
|parSummary=Checking this option On will compute surface normals.
 +
|parOrder=6
 +
|parName=normals
 +
|parType=Toggle
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
}}
 +
{{InputsPage
 +
|opFamily=SOP
 +
|opInputs={{OPInput
 +
|opFamily=SOP
 +
|inputIndex=0
 +
|inputName=
 +
|inputSummary=
 +
}}
 +
}}
 +
{{History
 +
}}
 +
{{SOPNavBox
 +
|opFamily=SOP
 +
}}
 +
{{#invoke:Category|list|SOPs}}

Latest revision as of 13:12, 28 July 2020

Summary
[edit]

The Tube SOP generates open or closed tubes, cones, or pyramids along the X, Y or Z axes. It outputs as meshes, polygons or simply a tube Primitive.

PythonIcon.pngtubeSOP_Class


Parameters - Tube Page

Primitive Type type - - Select from the following types. For information on the different types, see the Geometry category articles.

  • Primitive prim -
  • Polygon poly -
  • Mesh mesh -
  • NURBS nurbs -
  • Bezier bezier -

Connectivity surftype - - This option is used to select the type of surface, when using a Mesh Primitive Type.

  • Rows rows - Creates horizontal lines.
  • Columns cols - Creates vertical lines.
  • Rows and Columns rowcol - Both Rows and Columns. Looks like Quads in wire frame display, but all polygons are open (if the primitive type is polygon).
  • Triangles triangles - Build the grid with Triangles.
  • Quadrilaterals quads - Generates sides composed of quadrilaterals (default).
  • Alternating Triangles alttriangles - Generates triangles that are opposed; similar to the Triangles option.

Orientation orient - - Primary axis of tube (long axis).

  • X Axis x -
  • Y Axis y -
  • Z Axis z -

Orient Bounds orientbounds - Available only when an input is connected to the Tube SOP to set bounds for the tube. When Orient Bounds = On it will rotate the geometry to match the orientation of the input SOP used for bounds.

Modify Bounds modifybounds - Enabled only when an input is connected to the Tube SOP to set bounds for the tube. Turn Modify Bounds = On to enable the transform parameters below to further modify the position, scale, radius and height of the bounds.

Rotate Order rord - -

  • Rx Ry Rz xyz -
  • Rx Rz Ry xzy -
  • Ry Rx Rz yxz -
  • Ry Rz Rx yzx -
  • Rz Rx Ry zxy -
  • Rz Ry Rx zyx -

Center t - - Location of the tube center from the object origin.

  • X tx -
  • Y ty -
  • Z tz -

Rotate r - -

  • Rotate rx -
  • Rotate ry -
  • Rotate rz -

Radius rad - - The first field is the radius of the top of the tube and the second field represents the radius of the bottom of the tube.

  • rad1 -
  • rad2 -

Height height - The height of the tube.

Anchor U anchoru -

Anchor V anchorv -

Anchor W anchorw -

Imperfect imperfect - This option applies only to Bezier and NURBS types. If selected, the tube is an approximated nonrational curve, otherwise it is a perfect rational curve.


Parameters - Detail Page

Rows rows - Number of rows in tube.

Columns cols - Number of columns in tube.

U Order orderu - If a spline surface is selected, it is built at this order for U.

V Order orderv - If a spline surface is selected, it is built at this order for V.

End Caps cap - If selected, it adds faceted end caps to the ends of the tube.

Texture Coordinates texture - - Adds UV texture coordinates to the sphere.

  • Off off - No UV coordinates added to surface.
  • Row & Columns rowcol - Adds vertex UV coordinates.

Compute Normals normals - Checking this option On will compute surface normals.


Operator Inputs

  • Input 0 -

TouchDesigner Build:

SOPs
Add • Alembic • Align • Arm • Attribute Create • Attribute • Basis • Blend • Bone Group • Boolean • Box • Bridge • Cache • Cap • Capture Region • Capture • Carve • CHOP to • Circle • Clay • Clip • Convert • Copy • CPlusPlus • Creep • Curveclay • Curvesect • DAT to • Deform • Delete • Divide • Extrude • Facet • File In • Fillet • Fit • Font • Force • Fractal • Grid • Group • Hole • Import Select • In • Introduction To SOPs id • Inverse Curve • Iso Surface • Join • Joint • Kinect • Lattice • Limit • Line • Line Thick • LOD • LSystem • Magnet • Material • Merge • Metaball • Model • Noise • Null • Object Merge • Oculus Rift • OpenVR • Out • Particle • Point • Polyloft • Polypatch • Polyreduce • Polyspline • Polystitch • Primitive • Profile • Project • Rails • Raster • Ray • Rectangle • Refine • Resample • Revolve • Script • Select • Sequence Blend • Skin • Sort • Sphere • Spring • Sprinkle • Sprite • Stitch • Subdivide • Superquad • Surfsect • Sweep • Switch • Text • Texture • Torus • Trace • Trail • Transform • Trim • Tristrip • Tube • Twist • Vertex • Wireframe • ZED