pciterate VEX function

This function can be used to iterate over all the points which were found in the pcopen query.

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

See also: pcopen, pcunshaded, pcimport

int pciterate(int handle)

This function can be used to iterate over all the points which were found in a pcopen query. The first argument is the handle returned by pcopen. The function returns 1 while there are points left in the iteration loop, or 0 when there are no further points. This lets you use the function as the condition in a while loop.

Warnings:

It is not possible to nest pcunshaded or pciterate loops for the same handle. That is, for a single pcopen call, only one pcunshaded or pciterate loop may be entered.
Computations involving derivatives inside pcunshaded loops may have slightly different results. If derivatives are required for variables which aren’t set by pcimport it may be better to pre-compute the derivatives before the pcunshaded loop is entered.