Experimental:Grid POP

Summary

The Grid POP creates rows and columns of points in a plane, and optionally creates multiple slices of points resulting in a 3D grid. The points can be connected with a variety of primitives using the Connectivity menu.

The grid size is specified in X, Y and Z, but the grid can be post-rotated to any angles using the Rotate parameters, and translated using the Translate parameters. Columns refers to the divisions in X, Rows to the divisions in Y, and Slices to the divisions in Z (pre-rotation).

Connectivity lets you choose the primitives and their organization that is output. You can output triangles, quads, lines, line strips, point primitives or no primitives (only points). Using the Line toggles, you can make your lines and line strips in X, Y and/or Z. Using the Plane toggles, you can make triangles and quads in XY, YZ and/or ZX.

Randomize parameters will randomize where each point is in its cell, if you think of a cell being the box around a point beside the next point's cell. This is especially useful when Randomize is set to 1, which guarantees that every cell has exactly one point evenly distributed randomly in its cell, and that no points end up in another cell. This is otherwise hard to assure. Random Size Fit puts the randomized grid inside the boundary of the original unrandomized grid, ir or in a space that is one cell larger than the original unrandomized grid.

Anchor will line up the left, center or right side of the grid to X=0. Similar for Y and Z.

Dimension: When the grid is passed to other POPs it cannot be known for certain how many rows, columns and slices were specified in the Grid POP. However the grid (and other generator POPs) output its Dimensions to all POPs connected to it. Dimension is a powerful indicator of the organizations of points in a points list. A 2D grid has dimensions numCols numRows, and a 3D grid has dimensions numCols NumRows numSlices. Every POP outputs it dimensions which can be used by built-in attributes like _Dim[]. The Append Dimension menu gives you more control over the form of the dimension that is output.

You can output point, vertex or primitive normals (N attribute), and you can output point or vertex texture coordinates (Tex attribute).

The Grid POP takes an input which will cause the starting grid to have the same bounding box as the bounding box of the input. Then turning on Modify Bounds lets you further transform the grid.

You can turn on Unique Points which makes each vertex of each primitive use a unique point (not point sharing). But the grid Dimension is lost in this case - dimension is simply numPoints.

See also Dimension, Sphere POP, Tube POP, Torus POP, Line POP

gridPOP_Class

Parameters - Grid Page

Connectivity surftype - ⊞ -

• None none -

• Lines lines -

• Line Strips linestrips -

• Triangles triangles -

• Alternating Triangles alttriangles -

• Quadrilaterals quads -

• Point Prims points -

Modify Bounds modifybounds -

Size size - ⊞ -

• Size size1 -

• Size size2 -

• Size size3 -

Uniform Scale scale -

Columns cols -

Rows rows -

Slices slices -

Unique Points uniquepoints -

Seed seed -

Random random - ⊞ -

• Random random1 -

• Random random2 -

• Random random3 -

Random Size Fit randomsizefit - ⊞ -

• Random Size Fit randomsizefit1 -

• Random Size Fit randomsizefit2 -

• Random Size Fit randomsizefit3 -

Line X/Y/Z line - ⊞ -

• Line X/Y/Z line1 -

• Line X/Y/Z line2 -

• Line X/Y/Z line3 -

Plane XY/YZ/ZX plane - ⊞ -

• Plane XY/YZ/ZX plane1 -

• Plane XY/YZ/ZX plane2 -

• Plane XY/YZ/ZX plane3 -

Anchor U anchoru -

Anchor V anchorv -

Anchor W anchorw -

Translate t - ⊞ -

• Translate tx -

• Translate ty -

• Translate tz -

Rotate r - ⊞ -

• Rotate rx -

• Rotate ry -

• Rotate rz -

Normal normal - ⊞ -

• None none -

• Point pointNormals -

• Vertex vertNormals -

• Primitive primNormals -

Texture Coordinates texture - ⊞ -

• None none -

• Point point -

• Vertex vert -

Append Dimension dimension - ⊞ -

• When Rows Cols Slices > 1 morethanone -

• Always for Rows Cols rowscolsalways -

• Always for Rows Cols Slices rowscolsslicesalways -

Parameters - Common Page

Bypass bypass -

Delete Input Attributes delinputattrs -

Parameter Color Space parmcolorspace - ⊞ - Controls how all color parameters on this node are interpreted. The color values as treated as being in the selected color space, and are converted to the Working Color Space before they are used as part of the node's operation. Note that this does not change the color space of the node itself, as that is always in the Working Color Space.

• sRGB srgb - sRGB color space, with sRGB transfer function. Considered an SDR color space with respect to Reference White.

• sRGB - Linear srgblinear - sRGB color space, with linear transfer function. Considered an SDR color space with respect to Reference White.

• Rec.601 (NTSC) rec601ntsc - Rec.601 with NTSC primaries color space, with Rec.601 transfer function. Considered an SDR color space with respect to Reference White.

• Rec.709 rec709 - Rec.709 color space, with Rec.709 (same as Rec.2020) transfer function. Considered an SDR color space with respect to Reference White.

• Rec.2020 rec2020 - Rec.2020 color space, with Rec.2020 (same as Rec.709) transfer function. Considered an HDR color space with respect to Reference White.

• DCI-P3 dcip3 - DCI-P3 color space, with D65 white point and 2.6 gamma transfer function. Considered an HDR color space with respect to Reference White.

• DCI-P3 (D60) dcip3d60 - DCI-P3 "D60 sim" color space, with D60 white point, and 2.6 gamma transfer function. Considered an HDR color space with respect to Reference White.

• Display-P3 (D65) displayp3d65 - Display-P3 color space, with D65 white point, and sRGB gamma transfer function. Considered an HDR color space with respect to Reference White.

• ACES2065-1 aces2065-1 - ACES 2065-1 (also known as ACES AP0) color space, with a linear gamma transfer function. Considered an HDR color space with respect to Reference White.

• ACEScg acescg - ACEScg (also known as ACES AP1) color space, with a linear gamma transfer function. Considered an HDR color space with respect to Reference White.

• Passthrough passthrough - When selected, the color values will be used as-is in the operation, without any modification or attempt to convert them into the Working Color Space.

Parameter Reference White parmreferencewhite - ⊞ - When converting a parameter color value to the Working Color Space, this controls how it should be treated with respect to Reference White. If the Working Color Space is the same Reference White, then no adjustment is done. If they are different, then the Reference White level (brightness) of this color will be adjusted to the range expected by the Working Color Space. For example if the project is set to have a SDR Reference White of 120 nits, and the HDR Reference White is 80 nits, then a color of (1, 1, 1), which is 120 nits in the SDR color space, will be converted to be (1.5, 1.5, 1.5), which is 120 nits still in the HDR Working Color Space.

• Default For Color Space default - Will use either the SDR or the HDR Reference White, based on the color space selected.

• Standard (SDR) sdr - Will treat the Parameter Color Space as SDR for it's reference white value.

• High (HDR) hdr - Will treat the Parameter Color Space as HDR for it's reference white value.

Operator Inputs

• Input 0: -

Info CHOP Channels

Extra Information for the Grid POP can be accessed via an Info CHOP.

Common Operator Info Channels

• total_cooks - Number of times the operator has cooked since the process started.

• cook_time - Duration of the last cook in milliseconds.

• cook_frame - Frame number when this operator was last cooked relative to the component timeline.

• cook_abs_frame - Frame number when this operator was last cooked relative to the absolute time.

• cook_start_time - Time in milliseconds at which the operator started cooking in the frame it was cooked.

• cook_end_time - Time in milliseconds at which the operator finished cooking in the frame it was cooked.

• cooked_this_frame - 1 if operator was cooked this frame.

• warnings - Number of warnings in this operator if any.

• errors - Number of errors in this operator if any.

TouchDesigner Build: Latest\nwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditorwikieditor

Each SOP has a list of Points. Each point has an XYZ 3D position value plus other optional attributes. Each polygon Primitive is defined by a vertex list, which is list of point numbers.

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.

A surface type in SOPs that includes polygon, curve (NURBS and Bezier), patch (NURBS and Bezier) and other basic shapes like sphere, tube and metaball. Points and Primitives are part of the Geometry Detail, which is a part of a SOP.

An operator whose Bypass flag is set does nothing: All data going into its first input appears at its output unaffected.

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

A Link. The grey dashed lines between nodes is a Reference or Link that indicates one operator is getting data from another operator from any Operator Family.

The grey dashed lines between nodes is a Reference (or Link). A Reference is (1) a Parameter Reference, a parameter in an OP that is a name or path to another operator, (2) a Node Reference, an expression in a parameter or DAT script that contains the name or path of another operator, (3) a DAT Cell Reference or (4) a CHOP Channel Reference.

A Link or Reference is a dashed line between nodes that represent other data flowing between nodes. Examples are CHOP Exports, node Paths in parameters, and expressions in parameters referencing CHOP channels, DAT tables and other nodes. In contrast is a Wire that connects nodes in the same Operator Family.

A parameter reference can be setup between any two parameters by putting an expression in one parameter that refers to another parameter. This creates a Link between the two parameters such that when one changes, the other will change automatically (known in other software as a "constraint").

An Operator Family which operate on Channels (a sequence of numbers (Samples)) which are used for animation, audio, mathematics, simulation, logic, UI construction, and data streamed from/to devices and protocols.