rtcSetGeometryVertexAttributeTopology.3embree3 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. .TH "rtcSetGeometryVertexAttributeTopology" "3" "" "" "Embree Ray Tracing Kernels 3"
  2. .SS NAME
  3. .IP
  4. .nf
  5. \f[C]
  6. rtcSetGeometryVertexAttributeTopology\ \-\ binds\ a\ vertex
  7. \ \ attribute\ to\ a\ topology\ of\ the\ geometry
  8. \f[]
  9. .fi
  10. .SS SYNOPSIS
  11. .IP
  12. .nf
  13. \f[C]
  14. #include\ <embree3/rtcore.h>
  15. void\ rtcSetGeometryVertexAttributeTopology(
  16. \ \ RTCGeometry\ geometry,
  17. \ \ unsigned\ int\ vertexAttributeID,
  18. \ \ unsigned\ int\ topologyID
  19. );
  20. \f[]
  21. .fi
  22. .SS DESCRIPTION
  23. .PP
  24. The \f[C]rtcSetGeometryVertexAttributeTopology\f[] function binds a
  25. vertex attribute buffer slot (\f[C]vertexAttributeID\f[] argument) to a
  26. topology (\f[C]topologyID\f[] argument) for the specified subdivision
  27. geometry (\f[C]geometry\f[] argument).
  28. Standard vertex buffers are always bound to the default topology
  29. (topology 0) and cannot be bound differently.
  30. A vertex attribute buffer always uses the topology it is bound to when
  31. used in the \f[C]rtcInterpolate\f[] and \f[C]rtcInterpolateN\f[] calls.
  32. .PP
  33. A topology with ID \f[C]i\f[] consists of a subdivision mode set through
  34. \f[C]rtcSetGeometrySubdivisionMode\f[] and the index buffer bound to the
  35. index buffer slot \f[C]i\f[].
  36. This index buffer can assign indices for each face of the subdivision
  37. geometry that are different to the indices of the default topology.
  38. These new indices can for example be used to introduce additional
  39. borders into the subdivision mesh to map multiple textures onto one
  40. subdivision geometry.
  41. .SS EXIT STATUS
  42. .PP
  43. On failure an error code is set that can be queried using
  44. \f[C]rtcGetDeviceError\f[].
  45. .SS SEE ALSO
  46. .PP
  47. [rtcSetGeometrySubdivisionMode], [rtcInterpolate], [rtcInterpolateN]