mirror of https://github.com/ghostty-org/ghostty.git synced 2026-09-20 04:28:06 +00:00

Files

Mitchell Hashimoto b4079f00c8 libghostty: add render state structured cursor read

A normal renderer would have to call `ghostty_render_state_get`
_eight times_ to reconstruct the cursor. In languages where FFI is
expensive (Go, wasm, etc.), this showed up in profiles of every frame.

Add a sized cursor snapshot and expose it. Also expose the existing color
snapshot through ghostty_render_state_get and remove the older
dedicated color getter.

2026-08-15 20:54:40 -07:00

src

libghostty: add render state structured cursor read

2026-08-15 20:54:40 -07:00

build.zig

vt: add c render state api and example

2026-03-19 20:13:14 -07:00

build.zig.zon

vt: add c render state api and example

2026-03-19 20:13:14 -07:00

README.md

libghostty: expose row-local render selections

2026-05-23 15:03:51 -07:00

README.md

Example: `ghostty-vt` Render State

This contains an example of how to use the ghostty-vt render-state API to create a render state, update it from terminal content, iterate rows and cells, read styles and colors, inspect cursor and row-local selection state, and manage dirty tracking.

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

README.md

Example: ghostty-vt Render State

Usage

Example: `ghostty-vt` Render State