dolphin.lightlab · function ·

DolphinLightMetaballs

Centers stay within .35 of each half extent and radii within .235 of the minimum extent. Six blends can expand the union by at most 6*k/4=.30*min. Thus the entire field stays inside .885 of the supplied shape bounds. Its gradient has length <=1, so |field distance| is a safe marching bound.

cpudolphindolphin.lightlabfunctionlightlabsource-example

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

external DolphinLightMetaballs(dolphinLightShape s,int index,float time,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 time
Supply time as float.
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 DolphinLightMetaballs

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 time = 1.0
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 = DolphinLightMetaballs(s, index, time, ox, oy, oz, dx, dy, dz, maximum)
Console.Log("Inspect result in your debugger")
project.mech
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphinlightmetaballs"
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/field.yh:61