# yuiRenderTelemetry

A yui render telemetry record carrying workload, warmupSamples, measuredSamples, totalFrameMicroseconds, minimumFrameMicroseconds, and related state.

Last updated: 2026-09-09

Package: ui | Status: source-declared

Tags: cpu, method, source-example, thing, ui, yeho

Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.

```yh
external thing yuiRenderTelemetry
```

- text workload: Stores workload as text.
- int warmupSamples: Stores warmup samples as int.
- int measuredSamples: Stores measured samples as int.
- int totalFrameMicroseconds: Stores total frame microseconds as int.
- int minimumFrameMicroseconds: Stores minimum frame microseconds as int.
- int maximumFrameMicroseconds: Stores maximum frame microseconds as int.
- int maximumAllocatedBytes: Stores maximum allocated bytes as int.
- int maximumRealizedElements: Stores maximum realized elements as int.
- int maximumLayoutPasses: Stores maximum layout passes as int.
- int maximumPaintCommands: Stores maximum paint commands as int.
- int maximumInvalidatedArea: Stores maximum invalidated area as int.
- int maximumGlyphCacheBytes: Stores maximum glyph cache bytes as int.
- int maximumResourceBytes: Stores maximum resource bytes as int.
- text diagnostic: Stores diagnostic as text.
- yuiRenderTelemetry(text workload): Yui render telemetry.
- AddSample(bool warmup, int frameMicroseconds, int allocatedBytes, int realizedElements, int layoutPasses, int paintCommands, int invalidatedArea, int glyphCacheBytes, int resourceBytes) returns bool: Add sample.
- MeanFrameMicroseconds() returns int: Mean frame microseconds.
- VariancePercent() returns int: Variance percent.
- WithinBudget(int maximumMeanFrameMicroseconds, int maximumFrameMicroseconds, int maximumVariancePercent, int maximumAllocatedBytes, int maximumRealizedElements, int maximumLayoutPasses, int maximumPaintCommands, int maximumInvalidatedArea) returns bool: Within budget.
- RenderReport() returns text: Render report.

## Use yuiRenderTelemetry

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

Verification: type checked

```yh
using ui

// Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.
yuiRenderTelemetry sample = yuiRenderTelemetry("workload")
Console.Log(Text.From(sample.workload))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRenderTelemetry/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRenderTelemetry.AddSample

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

Verification: type checked

```yh
using ui

// Add sample.
yuiRenderTelemetry instance = yuiRenderTelemetry("workload")
bool argument_warmup = true
int argument_frameMicroseconds = 1
int argument_allocatedBytes = 4
int argument_realizedElements = 1
int argument_layoutPasses = 1
int argument_paintCommands = 1
int argument_invalidatedArea = 1
int argument_glyphCacheBytes = 4
int argument_resourceBytes = 4
bool result = instance.AddSample(argument_warmup, argument_frameMicroseconds, argument_allocatedBytes, argument_realizedElements, argument_layoutPasses, argument_paintCommands, argument_invalidatedArea, argument_glyphCacheBytes, argument_resourceBytes)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRenderTelemetry/method-AddSample-15 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRenderTelemetry.MeanFrameMicroseconds

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

Verification: type checked

```yh
using ui

// Mean frame microseconds.
yuiRenderTelemetry instance = yuiRenderTelemetry("workload")
int result = instance.MeanFrameMicroseconds()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRenderTelemetry/method-MeanFrameMicroseconds-16 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRenderTelemetry.VariancePercent

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

Verification: type checked

```yh
using ui

// Variance percent.
yuiRenderTelemetry instance = yuiRenderTelemetry("workload")
int result = instance.VariancePercent()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRenderTelemetry/method-VariancePercent-17 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRenderTelemetry.WithinBudget

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

Verification: type checked

```yh
using ui

// Within budget.
yuiRenderTelemetry instance = yuiRenderTelemetry("workload")
int argument_maximumMeanFrameMicroseconds = 1
int argument_maximumFrameMicroseconds = 1
int argument_maximumVariancePercent = 1
int argument_maximumAllocatedBytes = 4
int argument_maximumRealizedElements = 1
int argument_maximumLayoutPasses = 1
int argument_maximumPaintCommands = 1
int argument_maximumInvalidatedArea = 1
bool result = instance.WithinBudget(argument_maximumMeanFrameMicroseconds, argument_maximumFrameMicroseconds, argument_maximumVariancePercent, argument_maximumAllocatedBytes, argument_maximumRealizedElements, argument_maximumLayoutPasses, argument_maximumPaintCommands, argument_maximumInvalidatedArea)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRenderTelemetry/method-WithinBudget-18 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiRenderTelemetry.RenderReport

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

Verification: type checked

```yh
using ui

// Render report.
yuiRenderTelemetry instance = yuiRenderTelemetry("workload")
text result = instance.RenderReport()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiRenderTelemetry/method-RenderReport-19 --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/ui/render-40-adapter-telemetry.yh

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