# nativePointerFrame

A native pointer frame record carrying schema, schemaVersion, windowId, sequence, timestampMicroseconds, and related state.

Last updated: 2026-09-09

Package: window.multi | Status: source-declared

Tags: cpu, method, multi, source-example, thing, window, window.multi, yeho

Describe multiple windows, input events, lifecycle, and capabilities with typed records.

```yh
external thing nativePointerFrame
```

- text schema: Stores schema as text.
- int schemaVersion: Stores schema version as int.
- text windowId: Stores window id as text.
- int sequence: Stores sequence as int.
- int timestampMicroseconds: Stores timestamp microseconds as int.
- int maximumContacts: Stores maximum contacts as int.
- list of nativePointerRecord activeContacts: Stores active contacts as list of nativePointerRecord.
- list of nativePointerContactChange changes: Stores changes as list of nativePointerContactChange.
- text diagnostic: Stores diagnostic as text.
- nativePointerFrame(text windowId): Native pointer frame.
- Reject(text reason) returns bool: Reject.
- ContactIndex(int pointerId) returns int: Contact index.
- Advance(list of nativePointerContactChange requestedChanges, int nextSequence, int nextTimestampMicroseconds) returns bool: Advance.
- Snapshot() returns nativePointerFrame: Snapshot.
- Fingerprint() returns text: Fingerprint.

## Use nativePointerFrame

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

Verification: type checked

```yh
using window.multi

// Describe multiple windows, input events, lifecycle, and capabilities with typed records.
nativePointerFrame sample = nativePointerFrame("window Id")
Console.Log(Text.From(sample.schema))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativepointerframe"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

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/window.multi--nativePointerFrame/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativePointerFrame.Reject

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

Verification: type checked

```yh
using window.multi

// Reject.
nativePointerFrame instance = nativePointerFrame("window Id")
text argument_reason = "argument reason"
bool result = instance.Reject(argument_reason)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativepointerframe"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

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/window.multi--nativePointerFrame/method-Reject-10 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativePointerFrame.ContactIndex

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

Verification: type checked

```yh
using window.multi

// Contact index.
nativePointerFrame instance = nativePointerFrame("window Id")
int argument_pointerId = 1
int result = instance.ContactIndex(argument_pointerId)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativepointerframe"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

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/window.multi--nativePointerFrame/method-ContactIndex-11 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativePointerFrame.Advance

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

Verification: type checked

```yh
using window.multi

// Advance.
nativePointerFrame instance = nativePointerFrame("window Id")
list of nativePointerContactChange argument_requestedChanges = []
int argument_nextSequence = 1
int argument_nextTimestampMicroseconds = 1
bool result = instance.Advance(argument_requestedChanges, argument_nextSequence, argument_nextTimestampMicroseconds)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativepointerframe"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

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/window.multi--nativePointerFrame/method-Advance-12 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativePointerFrame.Snapshot

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

Verification: type checked

```yh
using window.multi

// Snapshot.
nativePointerFrame instance = nativePointerFrame("window Id")
nativePointerFrame result = instance.Snapshot()
Console.Log("Inspect result in your debugger")

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativepointerframe"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

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/window.multi--nativePointerFrame/method-Snapshot-13 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativePointerFrame.Fingerprint

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

Verification: type checked

```yh
using window.multi

// Fingerprint.
nativePointerFrame instance = nativePointerFrame("window Id")
text result = instance.Fingerprint()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativepointerframe"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

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/window.multi--nativePointerFrame/method-Fingerprint-14 --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: yeho/packages/window/multi/20-pointer-frame.yh

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