RTCSETGEOMETRYTRANSFORM(3embree3)

πŸ“¦ version 3.13.5, in epel 9, fedora 43, fedora 44

πŸ’– rtcSetGeometryTransform β€” bestie edition πŸ’–

okay so this is a page from the Embree Ray Tracing Kernels 3 manual, section 3, and it's all about rtcSetGeometryTransform. pull up a chair, we're gonna slay this 🫢


✨ NAME ✨

rtcSetGeometryTransform β€” sets the transformation for a particular time step of an instance geometry

yes bestie that's literally it, she does one thing and she does it iconically πŸ’…


🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

void rtcSetGeometryTransform(
  RTCGeometry geometry,
  unsigned int timeStep,
  enum RTCFormat format,
  const float* xfm
);

look at her. four little params. main character energy fr fr ✨


πŸ¦‹ DESCRIPTION πŸ¦‹

so the rtcSetGeometryTransform function sets the local-to-world affine transformation (that's the xfm parameter, bestie) of an instance geometry (that's the geometry parameter) for a particular time step (that's the timeStep parameter). πŸŽ€

the transformation is specified as a 3Γ—4 matrix β€” which is a 3Γ—3 linear transformation plus translation, no cap β€” and the following formats (the format parameter) are supported:

  • RTC_FORMAT_FLOAT3X4_ROW_MAJOR β€” the 3Γ—4 float matrix is laid out in row-major form. 🌈
  • RTC_FORMAT_FLOAT3X4_COLUMN_MAJOR β€” the 3Γ—4 float matrix is laid out in column-major form. 🌈
  • RTC_FORMAT_FLOAT4X4_COLUMN_MAJOR β€” the 3Γ—4 float matrix is laid out in column-major form as a 4Γ—4 homogeneous matrix with the last row being equal to (0, 0, 0, 1). 🌈

like... pick your format, pick your layout, we don't judge. all three are valid. periodt. πŸ’œ


πŸ’€ EXIT STATUS πŸ’€

on failure an error code is set that can be queried using rtcGetDeviceError.

so if something goes sideways, don't just sit there looking cute β€” go ask rtcGetDeviceError what happened. she'll tell you. 😭


πŸ‘‘ SEE ALSO πŸ‘‘

  • [RTC_GEOMETRY_TYPE_INSTANCE]

and that's the whole vibe bestie β€” this is from the Embree Ray Tracing Kernels 3 manual, rtcSetGeometryTransform(3), the one and only. go forth and transform your instances, you absolute icon πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸ«ΆπŸ”₯πŸŒˆβ­πŸ’œ

πŸ“¦ where this page comes from