rtcSetGeometryBuffer(3)

💅 rtcSetGeometryBuffer — the Embree Ray Tracing Kernels 3 era 💅

okay bestie, sit DOWN, because this one is literally the "here, hold my buffer" of the Embree world. It's rtcSetGeometryBuffer(3), and it's giving ✨ glue ✨ — it takes a buffer and assigns a view of it to the geometry. no cap.

🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

void rtcSetGeometryBuffer(
  RTCGeometry geometry,
  enum RTCBufferType type,
  unsigned int slot,
  enum RTCFormat format,
  RTCBuffer buffer,
  size_t byteOffset,
  size_t byteStride,
  size_t itemCount
);

🎀 DESCRIPTION 🎀

so rtcSetGeometryBuffer does the iconic thing: it binds a view of a buffer object (that's the buffer argument, hi bestie 🫶) to a geometry buffer type and slot (those are the type and slot arguments) of the geometry you point at (the geometry argument).

and you get to be SO specific about it, which honestly? obsessed. 💖

• you can say where the first buffer element starts, in bytes — that's byteOffset
• you can say the byte stride between individual buffer elements — that's byteStride
• you can say the format of the buffer elements — that's format
• and you can say how many elements to bind — that's itemCount

but here's the part where you gotta be careful, bestie, no skipping:

the start address (byteOffset argument) and the stride (byteStride argument) must both be aligned to 4 bytes — otherwise rtcSetGeometryBuffer will fail. periodt. 💀

and once it's done being successful? the geometry holds a reference to the buffer object. main character energy. it's not borrowing, it's committed. 👑

💀 EXIT STATUS 💀

on failure, an error code gets set, and you can go ask about it with rtcGetDeviceError. (yes, that's your vibe check function. use it.)

🦋 SEE ALSO 🦋

• [rtcSetSharedGeometryBuffer]
• [rtcSetNewGeometryBuffer]

and that's the whole thing, bestie ✨ this page came to you from Embree Ray Tracing Kernels 3, and yeah, rtcSetGeometryBuffer(3) said what it said. now go align your offsets to 4 bytes before I hear about it again 😭💅🌈