1RTC_GEOMETRY_TYPE_*_POINT(E3m)bree Ray Tracing KernelsRT3C_GEOMETRY_TYPE_*_POINT(3)
2
3
4
5   NAME
6              RTC_GEOMETRY_TYPE_SPHERE_POINT -
7                point geometry spheres
8
9              RTC_GEOMETRY_TYPE_DISC_POINT -
10                point geometry with ray-oriented discs
11
12              RTC_GEOMETRY_TYPE_ORIENTED_DISC_POINT -
13                point geometry with normal-oriented discs
14
15   SYNOPSIS
16              #include <embree3/rtcore.h>
17
18              rtcNewGeometry(device, RTC_GEOMETRY_TYPE_SPHERE_POINT);
19              rtcNewGeometry(device, RTC_GEOMETRY_TYPE_DISC_POINT);
20              rtcNewGeometry(device, RTC_GEOMETRY_TYPE_ORIENTED_DISC_POINT);
21
22   DESCRIPTION
23       Points  with  per  vertex radii are supported with sphere, ray-oriented
24       discs, and normal-oriented discs geometric representations.  Such point
25       geometries   are  created  by  passing  RTC_GEOMETRY_TYPE_SPHERE_POINT,
26       RTC_GEOMETRY_TYPE_DISC_POINT, or  RTC_GEOMETRY_TYPE_ORIENTED_DISC_POINT
27       to  the rtcNewGeometry function.  The point vertices can be specified t
28       through a vertex buffer (RTC_BUFFER_TYPE_VERTEX).  For the normal  ori‐
29       ented  discs a normal buffer (RTC_BUFFER_TYPE_NORMAL) has to get speci‐
30       fied additionally.  See rtcSetGeometryBuffer and  rtcSetSharedGeometry‐
31       Buffer for more details on how to set buffers.
32
33       The  vertex  buffer  stores each control vertex in the form of a single
34       precision position and radius stored in (x, y, z, r)  order  in  memory
35       (RTC_FORMAT_FLOAT4  format).   The  number of vertices is inferred from
36       the size of this buffer.  Similarly, the normal buffer stores a  single
37       precision  normal  per  control  vertex  (x,  y,  z  order and RTC_FOR‐
38       MAT_FLOAT3 format).
39
40       In the RTC_GEOMETRY_TYPE_SPHERE_POINT mode, a real geometric surface is
41       rendered  for  the  curve,  which  is more expensive but allows closeup
42       views.
43
44       The RTC_GEOMETRY_TYPE_DISC_POINT flat mode is a fast mode  designed  to
45       render  distant  points.   In  this mode the point is rendered as a ray
46       facing disc.
47
48       The RTC_GEOMETRY_TYPE_ORIENTED_DISC_POINT mode is a mode designed as  a
49       midpoint  geometrically  between ray facing discs and spheres.  In this
50       mode the point is rendered as a normal oriented disc.
51
52       For all point types, only the hit distance and geometry normal  is  re‐
53       turned as hit information, u and v are set to zero.
54
55       For  multi-segment  motion blur, the number of time steps must be first
56       specified using the rtcSetGeometryTimeStepCount call.   Then  a  vertex
57       buffer  for each time step can be set using different buffer slots, and
58       all these buffers must have the same stride and size.
59
60       Also see tutorial [Points] for an example of  how  to  create  and  use
61       point geometries.
62
63   EXIT STATUS
64       On  failure  NULL  is  returned  and  an  error code is set that can be
65       queried using rtcGetDeviceError.
66
67   SEE ALSO
68       [rtcNewGeometry]
69
70
71
72                                                  RTC_GEOMETRY_TYPE_*_POINT(3)