mirrors/ghostty
1
0
Fork 0
mirror of https://github.com/ghostty-org/ghostty.git synced 2026-04-06 07:38:21 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
ghostty/example/c-vt-grid-traverse/README.md
Mitchell Hashimoto 93c597ce6b example: add grid reference traversal example 
Add a c-vt-grid-ref example that demonstrates the terminal and grid
reference APIs end-to-end. The example creates a small 10x3 terminal,
writes text with mixed styles via VT sequences, then iterates over
every cell in the active area using ghostty_terminal_grid_ref. For
each cell it extracts the codepoint, and for each row it inspects
the wrap flag and the style bold attribute.

The grid_ref.h defgroup gains a @snippet reference to the new example,
and vt.h gets the corresponding @example entry and @ref listing.
2026-03-19 19:55:02 -07:00

573 B
Raw Permalink Blame History

Example: ghostty-vt Grid Traversal

This contains a simple example of how to use the ghostty-vt terminal and grid reference APIs to create a terminal, write content into it, and then traverse the entire grid cell-by-cell using grid refs to inspect codepoints, row state, and styles.

This uses a build.zig and Zig to build the C program so that we can reuse a lot of our build logic and depend directly on our source tree, but Ghostty emits a standard C library that can be used with any C tooling.

Usage

Run the program:

zig build run