mirrors/ghostty
1
0
Fork 0
mirror of https://github.com/ghostty-org/ghostty.git synced 2026-05-25 22:38:36 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
bb375a2f7565b9d8c8b60c6cbc0bd4e6c4532023
ghostty/example/c-vt-grid-ref-tracked/README.md
Mitchell Hashimoto 2355550a94 libghostty: add tracked grid ref API 
Add a C API for tracked pins, known as a tracked grid ref in C.

The new API can create tracked refs from terminal points, snapshot them
back to regular grid refs for cell access, convert them to coordinates,
move them to a new point, report when their semantic location was lost,
and free the tracked pin bookkeeping. This is backed by PageList tracked
pins and exposed through the libghostty-vt export layer and headers.
2026-05-23 14:37:59 -07:00

609 B
Raw Blame History

Example: ghostty-vt Tracked Grid References

This contains a simple example of how to use the ghostty-vt terminal and tracked grid reference APIs to keep a long-lived reference to a cell as the terminal scrolls, detect when that reference loses its meaningful location, and move the same tracked handle to a new point.

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