pcimport VEX function

Imports channel data from a point cloud inside a pciterate or a pcunshaded loop.

Contexts: image3d, chop, cop, pop, sop, surface, displace, fog, light, shadow, photon, cvex

See also: pcopen, pciterate, pcunshaded, pcexport

  1. int pcimport(int handle, string channel_name, int value&)

  2. int pcimport(int handle, string channel_name, float value&)

  3. int pcimport(int handle, string channel_name, vector value&)

  4. int pcimport(int handle, string channel_name, vector4 value&)

  5. int pcimport(int handle, string channel_name, matrix value&)

  6. int pcimport(int handle, string channel_name, matrix3 value&)

While looping using pciterate or pcunshaded, use these functions to import data from the point cloud file into the value variable.

The function will return 1 if the import succeeded or 0 if the import failed (usually due to the given channel name not existing).

There are two special channel names you can import:

point.number

The number of the point being processed.

point.distance

The distance of the point being processed from the query point. This is only available when iterating over unshaded points.

This function is only valid while looping with pciterate or pcunshaded.