{"id":"dolphin.lightlab--DolphinLightMetaballs","name":"DolphinLightMetaballs","owner":"dolphin","package":"dolphin.lightlab","kind":"function","signature":"external DolphinLightMetaballs(dolphinLightShape s,int index,float time,float ox,float oy,float oz,float dx,float dy,float dz,float maximum) returns dolphinLightHit","description":"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.","context":"Build bounded lighting experiments with geometry, visibility, transport, film, and GPU/CPU contracts.","parameters":[{"name":"s","type":"dolphinLightShape","description":"Supply s as dolphinLightShape."},{"name":"index","type":"int","description":"Supply index as int."},{"name":"time","type":"float","description":"Supply time as float."},{"name":"ox","type":"float","description":"Supply ox as float."},{"name":"oy","type":"float","description":"Supply oy as float."},{"name":"oz","type":"float","description":"Supply oz as float."},{"name":"dx","type":"float","description":"Supply dx as float."},{"name":"dy","type":"float","description":"Supply dy as float."},{"name":"dz","type":"float","description":"Supply dz as float."},{"name":"maximum","type":"float","description":"Supply maximum as float."}],"returns":"dolphinLightHit","members":[],"tags":["cpu","dolphin","dolphin.lightlab","function","lightlab","source-example"],"updated":"2026-09-09","source":{"repository":"dolphin","path":"packages/lightlab/src/field.yh","line":61,"sha256":"ac00ff055060d0c3bb950abe9e2797e4f6faa692163a73498d9d2891db78a8ca"},"status":"source-declared","notes":["Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup."],"examples":[{"id":"usage","title":"Use DolphinLightMetaballs","description":"A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.","code":"using dolphin.lightlab\n\n// Build bounded lighting experiments with geometry, visibility, transport, film, and GPU/CPU contracts.\ndolphinLightShape s = dolphinLightShape(1, 1, 1, 1, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0)\nint index = 1\nfloat time = 1.0\nfloat ox = 1.0\nfloat oy = 1.0\nfloat oz = 1.0\nfloat dx = 1.0\nfloat dy = 1.0\nfloat dz = 1.0\nfloat maximum = 1.0\ndolphinLightHit result = DolphinLightMetaballs(s, index, time, ox, oy, oz, dx, dy, dz, maximum)\nConsole.Log(\"Inspect result in your debugger\")\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.dolphin_lightlab__dolphinlightmetaballs\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"dolphin.lightlab\"\nversion = \"0.1.0\"\npath = \"../../../dolphin/packages/lightlab\"\n\n[[dependencies]]\npackage = \"dolphin.materials\"\nversion = \"0.1.0\"\npath = \"../../../dolphin/packages/materials\"\n\n[[dependencies]]\npackage = \"dolphin.math\"\nversion = \"0.1.0\"\npath = \"../../../dolphin/packages/math\"\n\n[[dependencies]]\npackage = \"dolphin.spatial3d\"\nversion = \"0.1.0\"\npath = \"../../../dolphin/packages/spatial3d\"\n","tags":["cpu","source-example"],"verification":"type checked","run":"cpu-oracle","sha256":"a1fb586655b3667114d83d9719504fa95d74aa346dcd2296c960d4ae9e9bf0ec","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null}],"searchTerms":[],"url":"https://demonhunterlabs.com/academy/api?item=dolphin.lightlab--DolphinLightMetaballs","json":"https://demonhunterlabs.com/reference/items/dolphin.lightlab--DolphinLightMetaballs.json","markdown":"https://demonhunterlabs.com/reference/text/dolphin.lightlab--DolphinLightMetaballs.md"}