ui · function ·
CreateUiSurfaceSpec
Create ui surface spec from the supplied values.
Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.
external CreateUiSurfaceSpec(text id, int width, int height, int scalePercent, text root) returns uiSurfaceSpecStatus: source-declared
Parameters
text id- Supply id as text.
int width- Supply width as int.
int height- Supply height as int.
int scalePercent- Supply scale percent as int.
text root- Supply root as text.
Use CreateUiSurfaceSpec
A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.
cpu · source-example · type checked
using ui
// Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.
text id = "id"
int width = 1
int height = 1
int scalePercent = 1
text root = "root"
uiSurfaceSpec result = CreateUiSurfaceSpec(id, width, height, scalePercent, root)
Console.Log("Inspect result in your debugger")
project.mech
manifestVersion = "2"
package = "api.example.ui__createuisurfacespec"
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"
Notes and source
Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.
yeho/packages/ui/surface-surface.yh:158