---
name: "rtcGetGeometry"
section: "3embree4"
platform: "linux"
package: "embree"
version: "4.4.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rtcGetGeometry/3embree4"
---

# rtcGetGeometry(3embree4)

### NAME

-

  ```
  rtcGetGeometry - returns the geometry bound to
    the specified geometry ID
  ```

### SYNOPSIS

-

  ```
  #include <embree4/rtcore.h>
  RTCGeometry rtcGetGeometry(RTCScene scene, unsigned int geomID);
  ```

### DESCRIPTION

The `rtcGetGeometry` function returns the geometry that is bound to the specified geometry ID (`geomID` argument) for the specified scene (`scene` argument). This function just looks up the handle and does *not* increment the reference count. If you want to get ownership of the handle, you need to additionally call `rtcRetainGeometry`.

This function is not thread safe and thus can be used during rendering. However, it is generally recommended to store the geometry handle inside the application’s geometry representation and look up the geometry handle from that representation directly.

If you need a thread safe version of this function please use \[rtcGetGeometryThreadSafe\].

### EXIT STATUS

On failure `NULL` is returned and an error code is set that can be queried using `rtcGetDeviceError`.

### SEE ALSO

\[rtcAttachGeometry\], \[rtcAttachGeometryByID\], \[rtcGetGeometryThreadSafe\]