# graphicsWindowsGlyphRunCaptureSnapshot

A graphics windows glyph run capture snapshot record carrying schema, provider, capability, value, available, and related state.

Last updated: 2026-09-09

Package: graphics.text.windows | Status: source-declared

Tags: cpu, graphics, graphics.text.windows, method, source-example, text, thing, windows, yeho

Capture Windows text shaping and glyph rasterization for the shared text model.

```yh
external thing graphicsWindowsGlyphRunCaptureSnapshot
```

- text schema: Stores schema as text.
- text provider: Stores provider as text.
- text capability: Stores capability as text.
- text value: Stores value as text.
- bool available: Stores available as bool.
- int utf8Length: Stores utf8 length as int.
- int utf16Length: Stores utf16 length as int.
- int describedUtf16Units: Stores described utf16 units as int.
- int totalGlyphs: Stores total glyphs as int.
- int glyphCallbacks: Stores glyph callbacks as int.
- int nativeAcquired: Stores native acquired as int.
- int nativeReleased: Stores native released as int.
- int rendererInitialReferences: Stores renderer initial references as int.
- int rendererFinalReferences: Stores renderer final references as int.
- int queryInterfaceCalls: Stores query interface calls as int.
- int addRefCalls: Stores add ref calls as int.
- int releaseCalls: Stores release calls as int.
- int pixelSnappingDisabledCalls: Stores pixel snapping disabled calls as int.
- int currentTransformCalls: Stores current transform calls as int.
- int pixelsPerDipCalls: Stores pixels per dip calls as int.
- int underlineCalls: Stores underline calls as int.
- int strikethroughCalls: Stores strikethrough calls as int.
- int inlineObjectCalls: Stores inline object calls as int.
- int invalidCallbacks: Stores invalid callbacks as int.
- int referenceKeyBytes: Stores reference key bytes as int.
- int retainedResolvedFontReferences: Stores retained resolved font references as int.
- int releasedResolvedFontReferences: Stores released resolved font references as int.
- int fontIdentityDedupeHits: Stores font identity dedupe hits as int.
- bool fontIdentityComplete: Stores font identity complete as bool.
- bool scriptAnalysisComplete: Stores script analysis complete as bool.
- bool lineBreakAnalysisComplete: Stores line break analysis complete as bool.
- bool lineMetricsComplete: Stores line metrics complete as bool.
- int firstLineHeightQ26_6: Stores first line height q26 6 as int.
- int firstLineBaselineQ26_6: Stores first line baseline q26 6 as int.
- int lineCount: Stores line count as int.
- list of int utf16ToUtf8Boundaries: Stores utf16 to utf8 boundaries as list of int.
- list of graphicsWindowsResolvedFontIdentity fonts: Stores fonts as list of graphicsWindowsResolvedFontIdentity.
- list of graphicsWindowsCapturedScriptSpan scripts: Stores scripts as list of graphicsWindowsCapturedScriptSpan.
- list of graphicsWindowsCapturedLineBreakpoint breakpoints: Stores breakpoints as list of graphicsWindowsCapturedLineBreakpoint.
- list of graphicsWindowsCapturedGlyphRun runs: Stores runs as list of graphicsWindowsCapturedGlyphRun.
- text diagnostic: Stores diagnostic as text.
- text source: Stores source as text.
- graphicsWindowsGlyphRunCaptureSnapshot(text source): Graphics windows glyph run capture snapshot.
- CleanupComplete() returns bool: Cleanup complete.
- HasRtlRun() returns bool: Has rtl run.
- HasMultiUnitCluster() returns bool: Has multi unit cluster.
- HasSurrogateInteriorBoundary() returns bool: Has surrogate interior boundary.
- SourceClusterCount() returns int: Source cluster count.
- HasExactUtf8SourceMapping() returns bool: Has exact utf8 source mapping.
- Utf8BoundaryIssue() returns text: Utf8 boundary issue.
- ValidationIssue() returns text: Validation issue.
- Snapshot() returns text: Snapshot.

## Use graphicsWindowsGlyphRunCaptureSnapshot

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

Verification: type checked

```yh
using graphics.text.windows

// Capture Windows text shaping and glyph rasterization for the shared text model.
graphicsWindowsGlyphRunCaptureSnapshot sample = graphicsWindowsGlyphRunCaptureSnapshot("example")
Console.Log(Text.From(sample.schema))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.CleanupComplete

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Cleanup complete.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
bool result = instance.CleanupComplete()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-CleanupComplete-43 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.HasRtlRun

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Has rtl run.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
bool result = instance.HasRtlRun()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-HasRtlRun-44 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.HasMultiUnitCluster

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Has multi unit cluster.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
bool result = instance.HasMultiUnitCluster()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-HasMultiUnitCluster-45 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.HasSurrogateInteriorBoundary

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Has surrogate interior boundary.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
bool result = instance.HasSurrogateInteriorBoundary()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-HasSurrogateInteriorBoundary-46 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.SourceClusterCount

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Source cluster count.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
int result = instance.SourceClusterCount()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-SourceClusterCount-47 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.HasExactUtf8SourceMapping

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Has exact utf8 source mapping.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
bool result = instance.HasExactUtf8SourceMapping()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-HasExactUtf8SourceMapping-48 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.Utf8BoundaryIssue

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Utf8 boundary issue.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
text result = instance.Utf8BoundaryIssue()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-Utf8BoundaryIssue-49 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.ValidationIssue

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Validation issue.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
text result = instance.ValidationIssue()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-ValidationIssue-50 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## graphicsWindowsGlyphRunCaptureSnapshot.Snapshot

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using graphics.text.windows

// Snapshot.
graphicsWindowsGlyphRunCaptureSnapshot instance = graphicsWindowsGlyphRunCaptureSnapshot("example")
text result = instance.Snapshot()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.graphics_text_windows__graphicswindowsglyphruncapturesnapshot"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "graphics.text.windows"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text/windows"

```

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/graphics.text.windows--graphicsWindowsGlyphRunCaptureSnapshot/method-Snapshot-51 --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/graphics/text/windows/glyph_run_capture.yh

AI training permission: https://demonhunterlabs.com/ai-use
