Python wrapper for Embree-3. Source code adapted from pyembree Embree-2 wrapper.

Example:

import numpy as np
import trimesh
from trimesh.primitives import Sphere
from pyemblite.mesh_construction import TriangleMesh
from pyemblite.rtcore_scene import EmbreeScene

# Create Embree scene which holds meshes.
scene = EmbreeScene()

# Create a mesh using trimesh (https://github.com/mikedh/trimesh).
tmesh = Sphere(radius=5.0, subdivisions=1)

# Create Embree triangle mesh geometry
emesh = TriangleMesh(scene, tmesh.vertices, tmesh.faces)

# Commit the scene (builds spatial acceleration structures).
scene.commit()

# Generate ray origins and ray directions
ray_orgs = (
    np.zeros((tmesh.vertices.shape[0], 3), dtype=np.float32)
    +
    tmesh.centroid
).astype(np.float32)
ray_dirs = (tmesh.vertices - tmesh.centroid).astype(np.float32)
ray_dirs /= np.linalg.norm(ray_dirs, axis=1)[np.newaxis, 1]

# Query the index of the first face which gets hit by ray
# (index of -1 indicates ray did not hit a face)
primID = scene.run(ray_orgs, ray_dirs, query='INTERSECT')

# Query the distance from the ray origin where face which gets hit by ray
# Intersection points are ray_orgs + tfar * ray_dirs
tfar = scene.run(ray_orgs, ray_dirs, query='DISTANCE')
print(tfar)

# Query all info, intersect_info is a dict with keys:
# ['u', 'v', 'Ng', 'tfar', 'primID', 'geomID']
intersect_info = scene.run(ray_orgs, ray_dirs, output=True)

Install from latest github source:

python -m pip install --no-deps --no-build-isolation --user git+https://github.com/AppliedMathematicsANU/pyemblite.git#egg=pyemblite

If you're on windows, you need to have embree3 installed. Use the most recent version, make sure you unzip the contents of the zip file into a folder where the MS build tools can find them.

You can always add the embree3 folder to your library and include path by changing the LIB and INCLUDE environment variables:

set INCLUDE="C:\Path\to\embree\include\dir:%INCLUDE%"

set LIB="C:\Path\to\embree\lib\dir:%LIB%"

You also still need to have build tools installed (some kind of C/C++ compiler). One way to achieve this is to install Visual Studio Build tools. Visual studio build tools likely require the installation of visual studio community edition first. This link should (hopefully) get you started:

https://visualstudio.microsoft.com/downloads/

Finally, you'll need to manually copy the Embree3.dll from (standard path when installed) C:\Program Files\Intel\Embree3\bin to C:\windows\system32 and (if you are on windows as you likely are these days) also to C:\windows\sysWOW64 . That should do it...

Requires:

• python-3 version >= 3.4,
• numpy version >= 1.7,
• embree >= 3.0 (Latest release)

Run tests (unit-tests and doctest module docstring tests) using:

python -m pyemblite.test

Source at github:

https://github.com/AppliedMathematicsANU/pyemblite

See the file LICENSE.txt for terms & conditions, for usage and a DISCLAIMER OF ALL WARRANTIES.