Vertex SOP

From TouchDesigner Documentation
Jump to: navigation, search


The Vertex SOP allows you to edit/create attributes on a per-vertex (rather than per-point) basis. It is similar to the Point SOP in this respect. It supports two inputs, and will inherit the first input source by default. If the second input have less primitives than the first input, it will cycle through the primitives and match the vertices. If the primitive in the first input has more vertices than the matching primitive in the second input, the extra vertices are ignored.

There are currently three vertex attributes supported:

  • Diffuse Color
  • Alpha
  • Texture Coordinates

When the attribute is defined, it can only occur on either points or vertices, but not both. Thus, if the input geometry has a point attribute for diffuse color, the attribute will automatically be "elevated" to be a vertex attribute (if diffuse colors are added in the Vertex SOP).

The SOP processes every vertex of every primitive. For each vertex processed, there are variables which allow you to know the:

  • Vertex number of the primitive being processed
  • The number of vertices in the primitive being processed
  • The point which is referenced by the vertex
  • The primitive which contains the vertex
  • The total number of points
  • The total number of primitives

There are also local variables to find out the values of some point attributes (i.e. position, normal - if they exist), in addition to vertex attributes. To access the attributes of the second input source, append a 2 to the variable.


Parameters - Vertex Page

Group group - If there are input groups, specifying a group name in this field will cause this SOP to act only upon the group specified. Accepts patterns, as described in Pattern Matching.  

Color doclr - - Select between keeping the color, adding new color, or using no color for vertex color attributes from incoming geometry.

  • Keep Color off -
  • Add Color on -
  • No Color remove -

Color diff - - If you select 'Add Color' from the menu above, Cd color vertex attributes will be added/modified in the SOP. Enter expressions below to control the values of the point colors. The attributes to modify are: me.inputColor[0] for red, me.inputColor[1] for green, me.inputColor[2] for blue, and me.inputColor[3] for alpha. If you select 'No Color' from the menu above, the Cd color vertex attribute will be removed from the SOP.

  • Color diffr -
  • Color diffg -
  • Color diffb -

Alpha alpha - Control the alpha attribute in the same manner as the rgb colors above. Alpha is Cd[3] and comes from input via me.inputColor[3]  

Texture douvw - - Select between keeping the texture coordinates, adding new texture coordinates, or using no texture coordinates for the vertex texture attributes from incoming geometry.

  • Keep Texture off -
  • Add Texture on -
  • No Texture remove -

Texture map - - If you select 'Add Texture' from the menu above, uv texture coordinate vertex attributes will be added/modified in the SOP. Enter expressions here to control the values of the vertex texture coordinates here. The attributes to modify are: me.inputTexture[0], me.inputTexture[1] and me.inputTexture[2]. If you select 'No Texture' from the menu above, the uv texture coordinates vertex attribute will be removed from the SOP.

  • Texture mapu -
  • Texture mapv -
  • Texture mapw -

Crease docrease - - Select between keeping the crease, adding new crease, or using no crease for creaseweight attribute from incoming geometry.

The Crease Weight attribute can be used to set individual edge crease weights for sub-division surfaces (see Subdivide SOP ). This vertex attribute defines the weight for the edge which goes from that vertex to the next vertex in the polygon. For example, with a triangle (which has vertices 0, 1, 2), the attribute for vertex 1 defines the crease weight for the edge (1, 2). The attribute for vertex 2 defines the crease weight for edge (2, 0). The crease weight should be greater than 0. The larger the value for crease weights, the sharper the edge will be when sub-divided.

Crease attributes can be visualized by passing them into a Subdivide SOP.

  • Keep Crease off -
  • Add Crease on -
  • No Crease remove -

Crease crease - If you select 'Add Crease' from the menu above, enter expressions here to control the values of the creaseweights here. The attribute to modify is: me.inputVertex.creaseWeight[0]. Values for the weight of the vertex can range from 0.0001 to infinity.  

Parameters - Attributes Page

Custom Attrib 1 custom1 - Creates a custom attribute with this name.  

Type custom1type - - The type of attribute created can be selected from this menu.

  • float float -
  • vec2 vec2 -
  • vec3 vec3 -
  • vec4 vec4 -
  • int int -
  • ivec2 ivec2 -
  • ivec3 ivec3 -
  • ivec4 ivec4 -

Value custom1val - - Set the values of the Custom Attrib using these parameters.

  • Value custom1val1 -
  • Value custom1val2 -
  • Value custom1val3 -
  • Value custom1val4 -


Texture Offsets

You can have set of images in a TOP, and apply all of them in one material to different parts of an object. This allows you to have a pre-rendered animation clip with the clip playing at different speeds and time offsets on different surfaces.

You can adjust the material frame time by the first vertex/point texture W component (texture coordinated are U (horizontal), V (vertical) and W (one of a set of texture images). A texture (W) value of -1 moves back in time 1 frame. This lets you apply different frames to many polygons simultaneously using the Vertex SOP, or Point SOP.

Operator Inputs

  • Input 0 -
  • Input 1 -

TouchDesigner Build:

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 • Sprite • Stitch • Subdivide • Superquad • Surfsect • Sweep • Switch • Text • Texture • Torus • Trace • Trail • Transform • Trim • Tristrip • Tube • Twist • Vertex • Wireframe • ZED

A sequence of vertices form a Polygon in a SOP. Each vertex is an integer index into the Point List, and each Point holds an XYZ position and attributes like Normals and Texture Coordinates.

An Operator Family that reads, creates and modifies 3D polygons, curves, NURBS surfaces, spheres, meatballs and other 3D surface data.

Information associated with SOP geometry. Points and primitives (polygons, NURBS, etc.) can have any number of attributes - position (P) is standard, and optional are normals (N), texture coordinates (uv), color (Cd), etc.

An Operator Family that creates, composites and modifies images, and reads/writes images and movies to/from files and the network. TOPs run on the graphics card's GPU.