Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-render

A spectral GPU path tracer for Luce: USD-shaped cameras and lights, OpenPBR materials, wavefront kernels on luce-gpu compute.

A library written in luce-base. Latest release 0.1.4.

Install#

luc add dymokomi/luce-render

Documentation#

luce-render

A spectral path tracer that runs on the GPU, for luced-3d and any Luce program that holds a luce-geocore GeometrySet. The host side, in Luce Base, compiles the scene into GPU buffers and records compute passes on luce-gpu. All tracing happens in GLSL compute kernels: Metal on macOS, Vulkan on Windows and Linux. There is no CPU renderer.

It is early. The v1 integrator renders Lambertian surfaces under UsdLux lights, spectral or RGB, and is checked against closed-form answers. OpenPBR's lobes come next; docs/DESIGN.md has the plan and the status.

from luce_render import render
from luce_gpu import gpu

var scene = render.compile_scene(set)              # triangles, BVH, cameras, lights
defer scene.close()
var on_gpu = render.GpuScene.upload(device, &scene)
defer on_gpu.destroy()
let frame = render.ray_frame(scene.objects.object(0), 1920, 1080)
render.probe(device, &on_gpu, &frame, probes)      # each pixel's polygon and distance

var renderer = render.Renderer.create(device, &scene, render.RenderSettings.of(1920, 1080, 128))
defer renderer.destroy()
while renderer.advance():                          # once per UI frame; never waits
    show(renderer.image(), renderer.samples_done())    # an rgba32f ACEScg texture

What it reads

  • Geometry: every polygon mesh in the set and in its visible instances. Analytic CAD needs a Tessellate node first; CompiledScene.skipped counts what was left out.
  • Cameras and lights: luce-geocore's scene component, shaped like USD's UsdGeomCamera and UsdLux (rect, disk, sphere and distant lights). A camera looks down its local -Z, and its film fits the image horizontally.

Kernels

GLSL sources are in shaders/. python3 tools/build_kernels.py embeds them into src/render/kernels.lucb through luce-gpu's embed_shaders.py. Tracing kernels will be built twice: spectral (SPECTRAL=1) and RGB (SPECTRAL=0).

Tests

luc test runs the host tests and tests/gpu. That program compares the GPU's BVH traversal with brute-force intersection, and prints skip: no GPU on machines without one.

Dependencies#

Versions#

0.1.4

Browse source · pack · commit 1fcf8b08d4c7

SHA-256 1c3146dfe807926b03bb1450fb53ad17e778b46174bb6cd89fcfa992e1d4efb2

luce-render 0.1.4: batch release

0.1.3

Browse source · pack · commit 90ba99d8ec10

SHA-256 8b8d0c3d47bea0120b5b0d84535d5912767e57e5e6e311c2b7c19838eca16587

luce-render 0.1.3: batch release

0.1.2

Browse source · pack · commit 17aff3018d28

SHA-256 e2eacd85ca190bd1b65dbfca2da171e2f0cc86bdad0fe537bcd64cbf44cc6a5d

luce-render 0.1.2: batch release

0.1.1

Browse source · pack · commit 257fc82535e3

SHA-256 47446430db42295360deb7c7b5095283e887b581f31977d2ea39a173a5935d7d

luce-render 0.1.1: batch release

0.1.0

Browse source · pack · commit 6a8cce324fe6

SHA-256 af8db6a6eb7b7f8837c823916e2a3830b30ff71a35b39ed1937c85ded74de31f

luce-render 0.1.0: first release