1rtcSetGeometryTimeRange(3)Embree Ray Tracing Kernels 3rtcSetGeometryTimeRange(3)
2
3
4
5   NAME
6              rtcSetGeometryTimeRange - sets the time range for a motion blur geometry
7
8   SYNOPSIS
9              #include <embree3/rtcore.h>
10
11              void rtcSetGeometryTimeRange(
12                RTCGeometry geometry,
13                float startTime,
14                float endTime
15              );
16
17   DESCRIPTION
18       The  rtcSetGeometryTimeRange  function  sets a time range which defines
19       the start (and end time) of the first (and last) time step of a  motion
20       blur  geometry.  The time range is defined relative to the camera shut‐
21       ter interval [0,1] but it can be arbitrary.  Thus the startTime can  be
22       smaller, equal, or larger 0, indicating a geometry whose animation def‐
23       inition start before, at, or after the camera shutter  opens.   Similar
24       the endTime can be smaller, equal, or larger than 1, indicating a geom‐
25       etry whose animation definition ends after, at, or  before  the  camera
26       shutter  closes.   The startTime has to be smaller or equal to the end‐
27       Time.
28
29       The default time range when this function is not called is  the  entire
30       camera shutter [0,1].  For best performance at most one time segment of
31       the piece wise linear definition of the motion should fall outside  the
32       shutter  window  to  the  left  and  to the right.  Thus do not set the
33       startTime or endTime too far outside the [0,1] interval for  best  per‐
34       formance.
35
36       This time range feature will also allow geometries to appear and disap‐
37       pear during the camera shutter time if the specified time  range  is  a
38       sub range of [0,1].
39
40       Please  also have a look at the rtcSetGeometryTimeStepCount function to
41       see how to define the time steps for the specified time range.
42
43   EXIT STATUS
44       On failure an error code is set that can  be  queried  using  rtcGetDe‐
45       viceError.
46
47   SEE ALSO
48       [rtcSetGeometryTimeStepCount]
49
50
51
52                                                    rtcSetGeometryTimeRange(3)