# dolphinGpuScreenQueries

A dolphin gpu screen queries record carrying rays, candidates, capacity.

Last updated: 2026-09-09

Package: dolphin.lightlab | Status: source-declared

Tags: class, cpu, dolphin, dolphin.lightlab, lightlab, method, source-example

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

```yh
external class dolphinGpuScreenQueries
```

- buffer of float rays: Stores rays as buffer of float.
- buffer of float candidates: Stores candidates as buffer of float.
- int capacity: Stores capacity as int.
- dolphinGpuScreenQueries(): Dolphin gpu screen queries.
- Begin(int count) returns bool: Begin.
- SetRay(int index,float ox,float oy,float oz,float dx,float dy,float dz,float maximum) returns bool: Set ray.
- Resolve(buffer of float completedGeometry,buffer of float camera,int currentRevision,int completedRevision,bool previousFrameReady) returns bool: Resolve.
- CandidatePrimitive(int index) returns int: Candidate primitive.

## Use dolphinGpuScreenQueries

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

Verification: type checked

```yh
using dolphin.lightlab

// Build bounded lighting experiments with geometry, visibility, transport, film, and GPU/CPU contracts.
dolphinGpuScreenQueries sample = dolphinGpuScreenQueries()
Console.Log(Text.From(sample.capacity))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphingpuscreenqueries"
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/dolphin.lightlab--dolphinGpuScreenQueries/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## dolphinGpuScreenQueries.Begin

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using dolphin.lightlab

// Begin.
dolphinGpuScreenQueries instance = dolphinGpuScreenQueries()
int argument_count = 1
bool result = instance.Begin(argument_count)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphingpuscreenqueries"
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/dolphin.lightlab--dolphinGpuScreenQueries/method-Begin-4 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## dolphinGpuScreenQueries.SetRay

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using dolphin.lightlab

// Set ray.
dolphinGpuScreenQueries instance = dolphinGpuScreenQueries()
int argument_index = 1
float argument_ox = 1.0
float argument_oy = 1.0
float argument_oz = 1.0
float argument_dx = 1.0
float argument_dy = 1.0
float argument_dz = 1.0
float argument_maximum = 1.0
bool result = instance.SetRay(argument_index, argument_ox, argument_oy, argument_oz, argument_dx, argument_dy, argument_dz, argument_maximum)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphingpuscreenqueries"
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/dolphin.lightlab--dolphinGpuScreenQueries/method-SetRay-5 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## dolphinGpuScreenQueries.Resolve

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using dolphin.lightlab

// Resolve.
dolphinGpuScreenQueries instance = dolphinGpuScreenQueries()
buffer of float argument_completedGeometry
argument_completedGeometry.Resize(8)
buffer of float argument_camera
argument_camera.Resize(8)
int argument_currentRevision = 1
int argument_completedRevision = 1
bool argument_previousFrameReady = true
bool result = instance.Resolve(argument_completedGeometry, argument_camera, argument_currentRevision, argument_completedRevision, argument_previousFrameReady)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphingpuscreenqueries"
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/dolphin.lightlab--dolphinGpuScreenQueries/method-Resolve-6 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## dolphinGpuScreenQueries.CandidatePrimitive

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using dolphin.lightlab

// Candidate primitive.
dolphinGpuScreenQueries instance = dolphinGpuScreenQueries()
int argument_index = 1
int result = instance.CandidatePrimitive(argument_index)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.dolphin_lightlab__dolphingpuscreenqueries"
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"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/dolphin.lightlab--dolphinGpuScreenQueries/method-CandidatePrimitive-7 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


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

Source: dolphin/packages/lightlab/src/gpu_screen.yh

AI training permission: https://demonhunterlabs.com/ai-use