---
title: "VectorPath component | zenit Zig UI"
description: "Vector path geometry: stroke, fill and hit-testing. Paths render on the GPU; hit-testing uses the same geometry."
url: https://ui.surf/zenit/components/vectorpath
language: en
alternate_zh: https://ui.surf/zenit/zh/components/vectorpath.md
alternate_es: https://ui.surf/zenit/es/components/vectorpath.md
alternate_ja: https://ui.surf/zenit/ja/components/vectorpath.md
alternate_ko: https://ui.surf/zenit/ko/components/vectorpath.md
alternate_fr: https://ui.surf/zenit/fr/components/vectorpath.md
alternate_de: https://ui.surf/zenit/de/components/vectorpath.md
project: zenit v0.1.0-alpha (Zig 0.15.2, macOS)
source: https://github.com/version-next/zenit
---

# VectorPath

`ui.path`

Vector path geometry: stroke, fill and hit-testing.

[Video](https://ui.surf/zenit/media/stories/vectorpath.mp4?v=b261110454)

**BEHAVIOR CONTRACT**

Paths render on the GPU; hit-testing uses the same geometry.

**RECORDED INTERACTION**

Sweeps the paths.

`examples/storybook/stories.zig:3272`

```zig
pub fn buildVectorPath(scope: *ui.Scope, cx: *ui.Cx) anyerror!*ui.Node {
    _ = scope;
    const a = cx.allocator;
    const c = try col(cx, 16);

    // 相邻多 path 节点：encoder 侧应合并为少数 draw（polygon 组 + triangles 组）
    try c.appendChild(a, try label(cx, "Batched fill_path: adjacent stars (polygon mode)"));
    const stars = try row(cx, 12);
    const star_colors = [_]ui.Color{
        ui.Color.rgb(235, 87, 87),
        ui.Color.rgb(242, 153, 74),
        ui.Color.rgb(39, 174, 96),
        ui.Color.rgb(45, 156, 219),
    };
    for (star_colors) |color| {
        const n = try ui.box(cx, .{
            .width = .{ .px = 64 },
            .height = .{ .px = 64 },
            .background = color,
        }, .{});
        try setStarGeometry(n, a, 64);
        try stars.appendChild(a, n);
    }
    try c.appendChild(a, stars);

    try c.appendChild(a, try label(cx, "Bursts 40-pt (earclip triangles mode)"));
    const bursts = try row(cx, 12);
    const burst_colors = [_]ui.Color{
        ui.Color.rgb(155, 81, 224),
        ui.Color.rgb(47, 128, 237),
        ui.Color.rgb(33, 150, 83),
    };
    for (burst_colors) |color| {
        const n = try ui.box(cx, .{
            .width = .{ .px = 64 },
            .height = .{ .px = 64 },
            .background = color,
        }, .{});
        try setBurstGeometry(n, a, 64);
        try bursts.appendChild(a, n);
    }
    try c.appendChild(a, bursts);

    return c;
}
```

[View source on GitHubexamples/storybook/stories.zig:3272](https://github.com/version-next/zenit/blob/HEAD/examples/storybook/stories.zig#L3272)

The story's verbatim source from the Storybook (zenit 4c50245 2026-10-01). `W` is `ui.widgets`; `col` / `row` / `label` are small Storybook layout helpers.
