Sprinkle POP

Summary

The Sprinkle POP creates points either on the surface of the input POP or within the volume of the input POP.

You create points based on the Method menu. The Per Primitive method creates points on the surface of primitives (triangles or quads). It keeps the distribution of points approximately constant per primitive no matter their size. (There is currently no method to create points on a surface that is constant per-area). The Volume method creates points randomly within a closed volume. (You will get some approximations if the volume is not closed.)

The Number of Points parameter is an approximate upper-limit number, the Volume (Deterministic) method produces a more accurate number of points (TBD).

By default, for every point it creates, it also creates a Point Primitive. The latter is useful if you are rendering the points directly, but may not be needed for other purposes (like you are copying to each point). Turn off Create Point Primitives if you don't need primitives, you just want a points list, and you wish to save memory.

See also Point Generator POP, Random POP

sprinklePOP_Class

Parameters - Sprinkle Page

Create Point Primitives createpointprim - Enable creating point primitives

Seed seed - Numerical value that initializes the randomization.

Method method - ⊞ - How to sprinkle points - on peimitives like triangles/quads, or inside closed volumes formed by primitives like triangles/quads.

• Per Primitive perprim -

• Volume volume -

• Volume (Deterministic) volumedeterministic -

• Volume (Non-Deterministic) volnondeterministic -

• Volume vol -

Number of Points numpoints - Sets the number of points. In the case of volume sprinkle, this is the max number of points, it might require a higher number of attempts per point to reach it.

Attempts per Point attemptsperpoint - For volume sprinkle, the number of attempts to try to get a point inside the mesh.

Ray Direction Mode raydirmode - ⊞ - To determine if point is inside or outside, cast rays from in random direction or in constant direction.

• Constant constant -

• Random random -

Ray Direction raydir - ⊞ - Constant direction to cast rays to determine if candidate point is inside or outside.

• Ray Direction raydirx -

• Ray Direction raydiry -

• Ray Direction raydirz -

Hardware Ray Tracing hwraytracing - ⊞ - Selects mode for Hardware Ray Tracing if supported

• Off off -

• Fast Build (Dynamic Geometry) fastbuild -

• Fast Trace (Static Geometry) fasttrace -

Point Attribute Scope pointattrscope - ⊞ - The Point attribute scope to blend.

• * * -

Primitive Attribute Scope primattrscope - ⊞ - The Primitive attribute scope to blend.

• * * -

Vertex Attribute Scope vertattribscope - ⊞ - Vertex attributes to sample when sprinkling.

• * * -

Parameters - Common Page

Bypass bypass - Pass through the first input to the output unchanged.

Free Extra GPU Memory freeextragpumem - Free memory that has accumulated when output memory has grown and shrunk.

Delete Input Attributes delinputattrs - Only output which attributes you specify in this POP - helps isolate attributes into a separate branch.

Operator Inputs

• Input 0: -

Info CHOP Channels

Extra Information for the Sprinkle 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\nwikieditor2025.30000

POPs (Point Operators) is a new Operator Family of TouchDesigner that runs on the GPU accelerated graphics card or chips, and creates/modifies 3D data which is rendered by the Render TOP or passed to devices like DMX lighting, LED arrays, lasers or other external systems.

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.

The 3D data held in SOPs and passed for rendering by the Geometry COMP.

A parameter in most CHOPs that restricts which channels of that CHOP will be affected. Normally all channels of a CHOP are affected by the operator. TOPs have Channel Mask, a similar feature.

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 whose Bypass flag is set does nothing: All data going into its first input appears at its output unaffected.

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.

Attributes are data associated with POP geometry. Points, Vertex (Vertices) and Primitives (polygons, lines, etc) can have any number of attributes.

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.