VEX Dictionary / xyzdist

xyzdist

Finds the closest spot on another geometry's surface: its distance, primitive and parametric uv.

group: measuremeasureproximity

Available in every context

Usage

float xyzdist(<geometry>, vector origin)

float xyzdist(<geometry>, vector origin, int &prim, vector &uv)

float xyzdist(<geometry>, vector origin, int &prim, vector &uv, float maxdist)

float xyzdist(<geometry>, string primgroup, vector origin)

float xyzdist(<geometry>, string primgroup, vector origin, int &prim, vector &uv)

float xyzdist(<geometry>, string primgroup, vector origin, int &prim, vector &uv, float maxdist)

Examples

// Input 1: the target surface
int prim;
vector uv;
float dist = xyzdist(1, @P, prim, uv);
@P = primuv(1, "P", prim, uv);
f@dist = dist;

Use cases

• Projecting and ray-free snapping Stick geometry to a surface without the Ray SOP.
• Surface attribute lookup Sample N, uv or Cd from the nearest spot on another mesh.
• Distance fields on the cheap Use the returned distance as a falloff mask.

Signatures (from vcc -X)

• float xyzdist(int, string, vector)all contexts
• float xyzdist(int, string, vector, int &, vector &)all contexts
• float xyzdist(int, string, vector, int &, vector &, float)all contexts
• float xyzdist(int, vector)all contexts
• float xyzdist(int, vector, int &, vector &)all contexts
• float xyzdist(int, vector, int &, vector &, float)all contexts
• float xyzdist(string, string, vector)all contexts
• float xyzdist(string, string, vector, int &, vector &)all contexts
• float xyzdist(string, string, vector, int &, vector &, float)all contexts
• float xyzdist(string, vector)all contexts
• float xyzdist(string, vector, int &, vector &)all contexts
• float xyzdist(string, vector, int &, vector &, float)all contexts

Related

primuv intersect minpos distance distance2 getbbox getbbox_center getbbox_max getbbox_min getbbox_size getbounds getpointbbox getpointbbox_center getpointbbox_max getpointbbox_min getpointbbox_size

Full SideFX documentation ↗