rtcSetGeometryTimeStepCount.3embree3 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. .TH "rtcSetGeometryTimeStepCount" "3" "" "" "Embree Ray Tracing Kernels 3"
  2. .SS NAME
  3. .IP
  4. .nf
  5. \f[C]
  6. rtcSetGeometryTimeStepCount\ \-\ sets\ the\ number\ of\ time\ steps\ of\ the
  7. \ \ geometry
  8. \f[]
  9. .fi
  10. .SS SYNOPSIS
  11. .IP
  12. .nf
  13. \f[C]
  14. #include\ <embree3/rtcore.h>
  15. void\ rtcSetGeometryTimeStepCount(
  16. \ \ RTCGeometry\ geometry,
  17. \ \ unsigned\ int\ timeStepCount
  18. );
  19. \f[]
  20. .fi
  21. .SS DESCRIPTION
  22. .PP
  23. The \f[C]rtcSetGeometryTimeStepCount\f[] function sets the number of
  24. time steps for multi\-segment motion blur (\f[C]timeStepCount\f[]
  25. parameter) of the specified geometry (\f[C]geometry\f[] parameter).
  26. .PP
  27. For triangle meshes (\f[C]RTC_GEOMETRY_TYPE_TRIANGLE\f[]), quad meshes
  28. (\f[C]RTC_GEOMETRY_TYPE_QUAD\f[]), curves
  29. (\f[C]RTC_GEOMETRY_TYPE_CURVE\f[]), points
  30. (\f[C]RTC_GEOMETRY_TYPE_POINT\f[]), and subdivision geometries
  31. (\f[C]RTC_GEOMETRY_TYPE_SUBDIVISION\f[]), the number of time steps
  32. directly corresponds to the number of vertex buffer slots available
  33. (\f[C]RTC_BUFFER_TYPE_VERTEX\f[] buffer type).
  34. For these geometries, one vertex buffer per time step must be specified
  35. when creating multi\-segment motion blur geometries.
  36. .PP
  37. For instance geometries (\f[C]RTC_GEOMETRY_TYPE_INSTANCE\f[]), a
  38. transformation must be specified for each time step (see
  39. \f[C]rtcSetGeometryTransform\f[]).
  40. .PP
  41. For user geometries, the registered bounding callback function must
  42. provide a bounding box per primitive and time step, and the intersection
  43. and occlusion callback functions should properly intersect the
  44. motion\-blurred geometry at the ray time.
  45. .SS EXIT STATUS
  46. .PP
  47. On failure an error code is set that can be queried using
  48. \f[C]rtcGetDeviceError\f[].
  49. .SS SEE ALSO
  50. .PP
  51. [rtcNewGeometry], [rtcSetGeometryTimeRange]