mirror of
https://github.com/ghostty-org/ghostty.git
synced 2026-07-31 04:39:01 +00:00
Terminal construction previously accepted GhosttyTerminalOptions with dimensions and one scrollback byte limit. Remove the options struct from the ABI and make ghostty_terminal_new accept columns and rows directly. Add byte and line limit options to ghostty_terminal_set and forward them to the runtime Terminal setters. NULL removes a limit, while zero bytes disables scrollback. Update type metadata, tests, and all API examples.
75 lines
2.3 KiB
C
75 lines
2.3 KiB
C
#include <assert.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <string.h>
|
|
#include <ghostty/vt.h>
|
|
|
|
//! [compression-idle-step]
|
|
// Perform one step after the application's idle timer fires. Returning true
|
|
// asks the application to schedule another step while the terminal is idle.
|
|
static bool compression_idle_step(GhosttyTerminal terminal) {
|
|
GhosttyTerminalCompressionResult compression_result;
|
|
GhosttyResult result = ghostty_terminal_compress(
|
|
terminal,
|
|
GHOSTTY_TERMINAL_COMPRESSION_MODE_INCREMENTAL,
|
|
&compression_result);
|
|
assert(result == GHOSTTY_SUCCESS);
|
|
|
|
switch (compression_result) {
|
|
case GHOSTTY_TERMINAL_COMPRESSION_RESULT_PENDING:
|
|
return true;
|
|
case GHOSTTY_TERMINAL_COMPRESSION_RESULT_COMPLETE:
|
|
case GHOSTTY_TERMINAL_COMPRESSION_RESULT_UNSUPPORTED:
|
|
return false;
|
|
default:
|
|
assert(false);
|
|
return false;
|
|
}
|
|
}
|
|
//! [compression-idle-step]
|
|
|
|
int main(void) {
|
|
GhosttyTerminal terminal;
|
|
GhosttyResult result = ghostty_terminal_new(NULL, &terminal, 80, 24);
|
|
assert(result == GHOSTTY_SUCCESS);
|
|
|
|
size_t max_scrollback_bytes = 10 * 1024 * 1024;
|
|
result = ghostty_terminal_set(
|
|
terminal,
|
|
GHOSTTY_TERMINAL_OPT_SCROLLBACK_MAX_BYTES,
|
|
&max_scrollback_bytes);
|
|
assert(result == GHOSTTY_SUCCESS);
|
|
|
|
//! [compression-activity]
|
|
uint64_t compression_activity;
|
|
result = ghostty_terminal_compression_activity(
|
|
terminal,
|
|
&compression_activity);
|
|
assert(result == GHOSTTY_SUCCESS);
|
|
|
|
// Terminal mutations may change the token. When it changes, restart the
|
|
// application's idle timer rather than compressing on the output path.
|
|
const char *line = "repeated and compressible terminal history\r\n";
|
|
for (size_t i = 0; i < 4000; i++) {
|
|
ghostty_terminal_vt_write(
|
|
terminal,
|
|
(const uint8_t *)line,
|
|
strlen(line));
|
|
}
|
|
|
|
uint64_t new_activity;
|
|
result = ghostty_terminal_compression_activity(terminal, &new_activity);
|
|
assert(result == GHOSTTY_SUCCESS);
|
|
if (new_activity != compression_activity) {
|
|
compression_activity = new_activity;
|
|
// Restart the application's compression idle timer here.
|
|
}
|
|
//! [compression-activity]
|
|
|
|
// Simulate the idle timer and its short pending-work continuations.
|
|
while (compression_idle_step(terminal)) {}
|
|
|
|
ghostty_terminal_free(terminal);
|
|
return 0;
|
|
}
|