rtcInterpolateN.3embree3 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. .TH "rtcInterpolateN" "3" "" "" "Embree Ray Tracing Kernels 3"
  2. .SS NAME
  3. .IP
  4. .nf
  5. \f[C]
  6. rtcInterpolateN\ \-\ performs\ N\ interpolations\ of\ vertex\ attribute\ data
  7. \f[]
  8. .fi
  9. .SS SYNOPSIS
  10. .IP
  11. .nf
  12. \f[C]
  13. #include\ <embree3/rtcore.h>
  14. struct\ RTCInterpolateNArguments
  15. {
  16. \ \ RTCGeometry\ geometry;
  17. \ \ const\ void*\ valid;
  18. \ \ const\ unsigned\ int*\ primIDs;
  19. \ \ const\ float*\ u;
  20. \ \ const\ float*\ v;
  21. \ \ unsigned\ int\ N;
  22. \ \ enum\ RTCBufferType\ bufferType;
  23. \ \ unsigned\ int\ bufferSlot;
  24. \ \ float*\ P;
  25. \ \ float*\ dPdu;
  26. \ \ float*\ dPdv;
  27. \ \ float*\ ddPdudu;
  28. \ \ float*\ ddPdvdv;
  29. \ \ float*\ ddPdudv;
  30. \ \ unsigned\ int\ valueCount;
  31. };
  32. void\ rtcInterpolateN(
  33. \ \ const\ struct\ RTCInterpolateNArguments*\ args
  34. );
  35. \f[]
  36. .fi
  37. .SS DESCRIPTION
  38. .PP
  39. The \f[C]rtcInterpolateN\f[] is similar to \f[C]rtcInterpolate\f[], but
  40. performs \f[C]N\f[] many interpolations at once.
  41. It additionally gets an array of u/v coordinates and a valid mask
  42. (\f[C]valid\f[] parameter) that specifies which of these coordinates are
  43. valid.
  44. The valid mask points to \f[C]N\f[] integers, and a value of \-1 denotes
  45. valid and 0 invalid.
  46. If the valid pointer is \f[C]NULL\f[] all elements are considers valid.
  47. The destination arrays are filled in structure of array (SOA) layout.
  48. The value \f[C]N\f[] must be divisible by 4.
  49. .PP
  50. To use \f[C]rtcInterpolateN\f[] for a geometry, all changes to that
  51. geometry must be properly committed using \f[C]rtcCommitGeometry\f[].
  52. .SS EXIT STATUS
  53. .PP
  54. For performance reasons this function does not do any error checks, thus
  55. will not set any error flags on failure.
  56. .SS SEE ALSO
  57. .PP
  58. [rtcInterpolate]