Experimental:Point File In POP

Summary

The Point File In POP loads 3D point data into POPs from either a single file or a sequence of files. The Point File In POP will load all available point data after you select field names and give them attribute names. Fields include standard ones like XYZ position, normal vectors, texture coordinates and RGBA color. More specialized fields are read in via any number of sequential blocks that map fields to attributes.

By default, field x, y and z are placed into the P attribute, and r g b a into the Color attribute, but that can be all re-assigned. The sequential blocks can create float, float2, float3 and float4 attributes, as well as arrays of values (no matrices or double at the moment).

The Thin page lets you skip points in the file, either randomly or in patterns. The ReRange page lets you scale/offset attribute values without having to create a temporary version of an attribute.

The Point File In POP will read point data from various mesh and floating point data files including: .obj, .ply, .fits (astronomy format), and .exr. It can also load ASCII point files (.xyz, .pts, .csv, .txt, etc) with one point per line and comma- or space-separated fields. The first line in ASCII point files can either be the number of points, the names of the point fields or the first point in the file.

For a complete list, see File Types. The OpenEXR file format is generally best to use as it is binary, can be read in multi-frame file sequences that uses TouchDesigner's movie file pre-reading and buffering, and can be written from TouchDesigner's Movie File Out TOP with unlimited numbers of channels.

(TBD: Examine the state of a Point File In POP by attaching an Info CHOP. This will show information like the number of points, fields per point and the number of frames. It also shows dynamic information like the file open status, current frame, readahead frames and queue size, dropped frame count, CPU decode time and GPU upload time.)

Headers: If the file contains any additional header data, this can be viewed by attaching an Info DAT. Header data is stored as key-value pairs with the keys in the first column and the corresponding data in the second column, which can easily be interpreted with python.

All of the ASCII point list formats are loaded the same way whether their extension is txt, csv, xyz, etc. The parser looks for the first separating character (comma, space or tab) and then uses that to delimit the rest of the file. It will ignore delimiters that are inside single or double quotes. There are a few special rules depending on the delimiter style e.g. multiple spaces are merged together, but a comma at the end of a line indicates a blank field afterwards. Once a delimiter is established, The first line can be the number of points, but it is ignored. If the next line are strings then it is treated as a row of headers (channel names). Each row after that is considered the attributes of point.

pointfileinPOP_Class

Parameters - Point File In Page

File file -

Reload reload -

Reload Pulse reloadpulse -

Create Point Primitives createpointprim -

Max Number of Points maxpointsenable -

Number of Points maxpoints -

Position Fields positionfields - ⊞ -

x x -

y y -

z z -

nx nx -

ny ny -

nz nz -

r r -

g g -

b b -

a a -

Normal Fields normalfields - ⊞ -

x x -

y y -

z z -

nx nx -

ny ny -

nz nz -

r r -

g g -

b b -

a a -

Texture Fields texturefields - ⊞ -

x x -

y y -

z z -

nx nx -

ny ny -

nz nz -

r r -

g g -

b b -

a a -

Color Fields colorfields - ⊞ -

x x -

y y -

z z -

nx nx -

ny ny -

nz nz -

r r -

g g -

b b -

a a -

Attribute attr -

Fields attr0fields - ⊞ -

x x -

y y -

z z -

nx nx -

ny ny -

nz nz -

r r -

g g -

b b -

a a -

Attribute Name attr0name -

Array attr0isarray -

Array Size attr0arraysize -

Parameters - Thin Page

Thin Out Range thinoutrange -

Thin Range Start thinrangestart -

Thin Range Length thinrangelength -

Thin Step thinstep -

Thin Random thinrandom -

Thin Random Seed thinrandomseed -

Parameters - ReRange Page

Rerange rerange -

Scope rerange0scope - ⊞ -

P P -

P(0) P(1) P(2) P(0) P(1) P(2) -

Color Color -

Color(0) Color(1) Color(2) Color(0) Color(1) Color(2) -

N N -

P.i01 P.i01 -

Color.i012 Color.i012 -

Parameter Size rerange0parsize - ⊞ -

1 1 -

2 2 -

3 3 -

4 4 -

Map from Low rerange0fromlow -

Map from High rerange0fromhigh -

Map to Low rerange0tolow -

Map to High rerange0tohigh -

Parameters - Common Page

Bypass bypass -

Delete Input Attributes delinputattrs -

Info CHOP Channels

Extra Information for the Point File In POP can be accessed via an Info CHOP.

Common POP Info Channels

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:

Privacy policy

Follow us