Experimental:Topology POP

Summary

The Topology POP gives finer control on how to combine existing points and topology (vertices and primitives), as well as their memory allocation.

Any unsigned int attribute from the input POP or another POP, interpreted as a list of point indices, can be used to describe the topology of the POP, alongside a manual description of the number of primitives (Topology Info), either using the parameters when the number of primitives of each type are known on the CPU, or using values coming from attributes, when the number of primitives of each type are only known on the GPU. This allows to combine multiple buffers created with GLSL and GLSL Advanced POP to describe geometry for example.

Alternatively the Topology and Topology info can be provided from another POP. Primitives and Vertices attributes can also be merged in from other POPs.

Last but not least, for POPs whose numbers of points and primitives are known on the GPU, the maximum numbers can be updated here, if the user knows them to be smaller, to reduce the memory allocation of downstream POPs. Alternatively if the exact counts are known they can also be entered manually and the POP updated to know that its point count info and topology info are now known on the CPU, without incurring the cost and stall of a download. (Refer to Learning about POPs, Information known on CPU/GPU)

topologyPOP_Class

Parameters - Topology Page

Render render -

Max Points maxpointsmode - ⊞ -

• From Input input -

• Custom custom -

Max Points maxpoints -

Primitive Source Mode primsourcemode - ⊞ -

• Input input -

• Specify POP specpop -

Primitive Mode primmode - ⊞ -

• Source Topology and Topology Info topo -

• Source Attribute and Manual Topology Info attr -

Primitives POP primspop -

Point Index Attrib Class pointindexattrclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Point Index Attrib Name pointindexattrname -

Vertex Attribute Mode vertattrmode - ⊞ -

• None none -

• Primitive Source primsource -

• Specify POP specpop -

Vertex Attribute POP vertattrpop -

Vertex Attribute Class vertattrclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Prim Attribute Mode primattrmode - ⊞ -

• None none -

• Primitive Source primsource -

• Specify POP specpop -

Prim Attribute POP primattrpop -

Prim Attribute Class primattrclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Topology topology - ⊞ -

• Source Topology Reference ref -

• Source Topology Copy copy -

Max Triangles maxtrianglesmode - ⊞ -

• Primitive Source primsource -

• Custom custom -

Max Triangles maxtriangles -

Max Quads maxquadsmode - ⊞ -

• Primitive Source primsource -

• Custom custom -

Max Quads maxquads -

Max Line Strips maxlinestripsmode - ⊞ -

• Primitive Source primsource -

• Custom custom -

Max Line Strips maxlinestrips -

Max Line Strip Verts maxlsvertsmode - ⊞ -

• Primitive Source primsource -

• Custom custom -

Max Line Strip Verts maxlsverts -

Max Lines maxlinesmode - ⊞ -

• Primitive Source primsource -

• Custom custom -

Max Lines maxlines -

Max Point Prims maxpointprimsmode - ⊞ -

• Primitive Source primsource -

• Custom custom -

Max Point Prims maxpointprims -

Line Strip Info from Prim Source lsinfofromprimsource -

Line Strip Info Update lsinfoupdate - ⊞ -

• Auto auto -

• Manual manual -

Line Strip Info POP lsinfopop -

Line Strip Info Attribute lsinfoclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Line Strip Info Attribute lsinfoattr -

Line Strip Index per Vert POP lsindexpop -

Line Strip Index per Vert Attribute lsindexclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Line Strip Index per Vert Attribute lsindexattr -

Max Verts per Line Strip lsmaxvertsoverride -

Max Verts per Line Strip lsmaxverts -

Point Count and Topology Info pointcounttopoinfo - ⊞ -

• From Input input -

• From Primitive Source primsource -

• From Parameters fromparams -

• From Attributes fromattrs -

Point Count pointcountmode - ⊞ -

• From Input input -

• Set set -

Point Count POP pointcountpop -

Point Count Attribute pointcountclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Point Count Attribute pointcountattr -

Topology Info POP topoinfopop -

Topology Info Attributes Class topoinfoclass - ⊞ -

• Point point -

• Vertex vertex -

• Primitive primitive -

Triangle Count trianglecountmode - ⊞ -

• Primitive Source primsource -

• Zero zero -

• Set set -

Triangle Count Attribute trianglecountattr -

Quad Count quadcountmode - ⊞ -

• Primitive Source primsource -

• Zero zero -

• Set set -

Quad Count Attribute quadcountattr -

Line Strip Count linestripcountmode - ⊞ -

• Primitive Source primsource -

• Zero zero -

• Set set -

Line Strip Count Attribute linestripcountattr -

Line Strip Vert Count lsvertcountmode - ⊞ -

• Primitive Source primsource -

• Zero zero -

• Set set -

Line Strip Vert Count Attribute lsvertcountattr -

Line Count linecountmode - ⊞ -

• Primitive Source primsource -

• Zero zero -

• Set set -

Line Count Attribute linecountattr -

Point Prim Count pointprimcountmode - ⊞ -

• Primitive Source primsource -

• Zero zero -

• Set set -

Point Prim Count Attrib pointprimcountattr -

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 Topology 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\nwikieditorwikieditorwikieditor

The Graphics Processing Unit. This is the high-speed, many-core processor of the graphics card/chip that takes geometry, images and data from the CPU and creates images and processed data.

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.

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 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.

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.

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

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.