| 1234567891011121314151617181920212223242526272829303132333435363738 |
- .TH "rtcGetGeometry" "3" "" "" "Embree Ray Tracing Kernels 3"
- .SS NAME
- .IP
- .nf
- \f[C]
- rtcGetGeometry\ \-\ returns\ the\ geometry\ bound\ to
- \ \ the\ specified\ geometry\ ID
- \f[]
- .fi
- .SS SYNOPSIS
- .IP
- .nf
- \f[C]
- #include\ <embree3/rtcore.h>
- RTCGeometry\ rtcGetGeometry(RTCScene\ scene,\ unsigned\ int\ geomID);
- \f[]
- .fi
- .SS DESCRIPTION
- .PP
- The \f[C]rtcGetGeometry\f[] function returns the geometry that is bound
- to the specified geometry ID (\f[C]geomID\f[] argument) for the
- specified scene (\f[C]scene\f[] argument).
- This function just looks up the handle and does \f[I]not\f[] increment
- the reference count.
- If you want to get ownership of the handle, you need to additionally
- call \f[C]rtcRetainGeometry\f[].
- For this reason, this function is fast and can be used during rendering.
- However, it is generally recommended to store the geometry handle inside
- the application\[aq]s geometry representation and look up the geometry
- handle from that representation directly.
- .SS EXIT STATUS
- .PP
- On failure \f[C]NULL\f[] is returned and an error code is set that can
- be queried using \f[C]rtcGetDeviceError\f[].
- .SS SEE ALSO
- .PP
- [rtcAttachGeometry], [rtcAttachGeometryByID]
|
