dolphin.lightlab · function ·

DolphinLightTorus

Exact torus SDF: sphere-trace only its conservative bounding box. The 128-step budget returns an explicit unresolved hit, never invented empty space.

cpudolphindolphin.lightlabfunctionlightlabsource-example

Build bounded lighting experiments with geometry, visibility, transport, film, and GPU/CPU contracts.

external DolphinLightTorus(dolphinLightShape s,int index,float ox,float oy,float oz,float dx,float dy,float dz,float maximum) returns dolphinLightHit

Status: source-declared

Parameters

dolphinLightShape s
Supply s as dolphinLightShape.
int index
Supply index as int.
float ox
Supply ox as float.
float oy
Supply oy as float.
float oz
Supply oz as float.
float dx
Supply dx as float.
float dy
Supply dy as float.
float dz
Supply dz as float.
float maximum
Supply maximum as float.

Use DolphinLightTorus

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

cpu · source-example · type checked

using dolphin.lightlab

// Build bounded lighting experiments with geometry, visibility, transport, film, and GPU/CPU contracts.
dolphinLightShape s = dolphinLightShape(1, 1, 1, 1, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0)
int index = 1
float ox = 1.0
float oy = 1.0
float oz = 1.0
float dx = 1.0
float dy = 1.0
float dz = 1.0
float maximum = 1.0
dolphinLightHit result = DolphinLightTorus(s, index, ox, oy, oz, dx, dy, dz, maximum)
Console.Log("Inspect result in your debugger")
project.mech
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphinlighttorus"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "dolphin.lightlab"
version = "0.1.0"
path = "../../../dolphin/packages/lightlab"

[[dependencies]]
package = "dolphin.materials"
version = "0.1.0"
path = "../../../dolphin/packages/materials"

[[dependencies]]
package = "dolphin.math"
version = "0.1.0"
path = "../../../dolphin/packages/math"

[[dependencies]]
package = "dolphin.spatial3d"
version = "0.1.0"
path = "../../../dolphin/packages/spatial3d"
Notes and source

Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

dolphin/packages/lightlab/src/lightlab.yh:183