Files
ghostty-rs/crates/ghostty-apprt-gtk/examples/demo.rs
T
ddidderr db954441fa fix(input): carry key and preedit text as bytes like Zig
Zig's KeyEvent.utf8 and the embedded API's key/preedit text are byte
slices passed through to key encoding and the pty; the port converted
them lossily to UTF-8.
- KeyEvent.utf8 is &[u8] end to end (ghostty-input encoder, core,
  ghostty-lib C API, libghostty-vt key events, GTK callers). Where Zig
  validates with Utf8View (alternates, modify-other-keys, ctrl CSI-u,
  associated text, binding unicode lookup) invalid text takes the same
  "no UTF-8" fallback.
- Invalid preedit UTF-8 behaves like Zig's `try Utf8View.init`: the
  prior preedit is cleared and marked dirty, the callback returns an
  error (logged by the C API) and no preedit is set.
- The inspector key widget shows invalid key text lossily, display only.

Test Plan:
- cargo test --workspace --no-fail-fast (3407 passed)
- cargo test -p ghostty-lib --features test-platform (C-API key text
  0xff 0xfe reaches the pty unchanged)
- just check-macos (both), just check-windows, just check-wasm
2026-10-12 11:01:17 +02:00

363 lines
12 KiB
Rust

//! Demo for the GTK app runtime with a dummy core.
//!
//! The dummy `CoreApp`/`CoreSurface` clear the `GLArea` with the configured
//! background color and implement just enough key handling (keybindings from
//! the user's config) to exercise windows, tabs, splits, dialogs, the command
//! palette, fullscreen, etc.
//!
//! Environment:
//! * `DEMO_QUIT_AFTER_MS=<n>`: quit automatically after n milliseconds.
//! * `DEMO_CONFIRM=1`: make every surface report "needs confirm quit".
//!
//! Run: `cargo run -p ghostty-apprt-gtk --example demo`
#![allow(unsafe_code)] // GL calls through glow
use std::{
cell::{Cell, RefCell},
rc::Rc,
sync::Arc,
time::Duration,
};
use ghostty_apprt::{
action::{self, Action, Target},
runtime_api::{
AppMessage,
CellSize,
ClipboardError,
CoreApp,
CoreError,
CoreSurface,
DesiredFontSize,
InputEffect,
KeyEvent,
RtApp,
RtSurface,
SurfaceId,
},
structs::{ClipboardRequest, ColorScheme, ContentScale, CursorPos, ImePos, SurfaceSize},
};
use ghostty_apprt_gtk::app::App;
use ghostty_config::config::Config;
use ghostty_input::{
Mods,
MouseButton,
MouseButtonState,
ScrollMods,
binding::{self, Action as Binding, set::Value as BindingValue},
};
use glow::HasContext;
fn confirm() -> bool {
std::env::var("DEMO_CONFIRM").is_ok_and(|v| v == "1")
}
/// Map the subset of keybinding actions the demo understands to apprt actions.
fn binding_to_action(b: &Binding) -> Option<Action> {
use binding::action::{CloseTabMode, SplitDirection, SplitFocusDirection};
Some(match b {
Binding::NewWindow => Action::NewWindow,
Binding::NewTab => Action::NewTab,
Binding::PreviousTab => Action::GotoTab(action::GotoTab::Previous),
Binding::NextTab => Action::GotoTab(action::GotoTab::Next),
Binding::LastTab => Action::GotoTab(action::GotoTab::Last),
Binding::GotoTab(n) => Action::GotoTab(action::GotoTab::Index(*n as i32)),
Binding::MoveTab(n) => Action::MoveTab(action::MoveTab { amount: *n }),
Binding::ToggleTabOverview => Action::ToggleTabOverview,
Binding::PromptSurfaceTitle => Action::PromptTitle(action::PromptTitle::Surface),
Binding::PromptTabTitle => Action::PromptTitle(action::PromptTitle::Tab),
Binding::NewSplit(d) => Action::NewSplit(match d {
SplitDirection::Right | SplitDirection::Auto => action::SplitDirection::Right,
SplitDirection::Down => action::SplitDirection::Down,
SplitDirection::Left => action::SplitDirection::Left,
SplitDirection::Up => action::SplitDirection::Up,
}),
Binding::GotoSplit(d) => Action::GotoSplit(match d {
SplitFocusDirection::Previous => action::GotoSplit::Previous,
SplitFocusDirection::Next => action::GotoSplit::Next,
SplitFocusDirection::Up => action::GotoSplit::Up,
SplitFocusDirection::Left => action::GotoSplit::Left,
SplitFocusDirection::Down => action::GotoSplit::Down,
SplitFocusDirection::Right => action::GotoSplit::Right,
}),
Binding::ToggleSplitZoom => Action::ToggleSplitZoom,
Binding::EqualizeSplits => Action::EqualizeSplits,
Binding::OpenConfig => Action::OpenConfig,
Binding::ReloadConfig => Action::ReloadConfig(action::ReloadConfig::default()),
Binding::CloseTab(m) => Action::CloseTab(match m {
CloseTabMode::This => action::CloseTabMode::This,
CloseTabMode::Other => action::CloseTabMode::Other,
CloseTabMode::Right => action::CloseTabMode::Right,
}),
Binding::CloseWindow | Binding::CloseSurface => Action::CloseWindow,
Binding::ToggleMaximize => Action::ToggleMaximize,
Binding::ToggleFullscreen => Action::ToggleFullscreen(action::Fullscreen::Native),
Binding::ToggleWindowDecorations => Action::ToggleWindowDecorations,
Binding::ToggleCommandPalette => Action::ToggleCommandPalette,
Binding::ToggleQuickTerminal => Action::ToggleQuickTerminal,
Binding::ShowGtkInspector => Action::ShowGtkInspector,
Binding::Quit => Action::Quit,
_ => return None,
})
}
// ---------------------------------------------------------------------
struct DemoSurface {
id: SurfaceId,
config: RefCell<Arc<Config>>,
rt_app: Rc<dyn RtApp>,
_rt_surface: Rc<dyn RtSurface>,
gl: RefCell<Option<glow::Context>>,
focused: Cell<bool>,
}
impl DemoSurface {
fn perform(&self, a: Action) -> bool {
self.rt_app.perform_action(Target::Surface(self.id), a)
}
}
impl CoreSurface for DemoSurface {
fn config(&self) -> Arc<Config> {
self.config.borrow().clone()
}
fn key_callback(&self, event: KeyEvent<'_>) -> Result<InputEffect, CoreError> {
if event.action == ghostty_input::Action::Release {
return Ok(InputEffect::Ignored);
}
let config = self.config();
let Some((_, value)) = config.keybind.set.get_event(&event) else {
return Ok(InputEffect::Ignored);
};
let BindingValue::Leaf(leaf) = value else {
return Ok(InputEffect::Ignored);
};
match binding_to_action(&leaf.action) {
Some(a) => {
let closes = matches!(a, Action::CloseWindow | Action::CloseTab(_));
self.perform(a);
Ok(if closes {
InputEffect::Closed
} else {
InputEffect::Consumed
})
}
None => Ok(InputEffect::Ignored),
}
}
fn preedit_callback(&self, _text: Option<&[u8]>) -> Result<(), CoreError> {
Ok(())
}
fn focus_callback(&self, focused: bool) -> Result<(), CoreError> {
self.focused.set(focused);
Ok(())
}
fn mouse_button_callback(
&self,
_state: MouseButtonState,
_button: MouseButton,
_mods: Mods,
) -> Result<bool, CoreError> {
Ok(false)
}
fn cursor_pos_callback(&self, _pos: CursorPos, _mods: Option<Mods>) -> Result<(), CoreError> {
Ok(())
}
fn scroll_callback(&self, _x: f64, _y: f64, _mods: ScrollMods) -> Result<(), CoreError> {
Ok(())
}
fn size_callback(&self, _size: SurfaceSize) -> Result<(), CoreError> {
Ok(())
}
fn content_scale_callback(&self, _scale: ContentScale) -> Result<(), CoreError> {
Ok(())
}
fn ime_point(&self) -> ImePos {
ImePos {
x: 0.0,
y: 0.0,
width: 10.0,
height: 20.0,
}
}
fn has_selection(&self) -> bool {
false
}
fn color_scheme_callback(&self, _scheme: ColorScheme) -> Result<(), CoreError> {
Ok(())
}
fn update_config(&self, config: &Arc<Config>) -> Result<(), CoreError> {
*self.config.borrow_mut() = config.clone();
self.perform(Action::ConfigChange(action::ConfigChange {
config: config.clone(),
}));
Ok(())
}
fn perform_binding_action(&self, a: &Binding) -> Result<bool, CoreError> {
Ok(binding_to_action(a).is_some_and(|a| self.perform(a)))
}
fn complete_clipboard_request(
&self,
_req: ClipboardRequest,
data: &[u8],
_confirmed: bool,
) -> Result<(), ClipboardError> {
log::info!("demo: paste of {} bytes", data.len());
Ok(())
}
fn set_clipboard_read_allowed(&self, _allow: bool) {}
fn set_clipboard_write_allowed(&self, _allow: bool) {}
fn needs_confirm_quit(&self) -> bool {
confirm()
}
fn child_exited(&self) -> bool {
false
}
fn renderer_realized(&self) -> Result<(), CoreError> {
// SAFETY: the GLArea context is current while realizing; the loader
// resolves symbols through libepoxy which dispatches to it.
let gl =
unsafe { glow::Context::from_loader_function(ghostty_apprt_gtk::gl::proc_address) };
*self.gl.borrow_mut() = Some(gl);
Ok(())
}
fn renderer_unrealized(&self) {
*self.gl.borrow_mut() = None;
}
fn draw_frame(&self, default_framebuffer: u32) -> Result<(), CoreError> {
let gl = self.gl.borrow();
let Some(gl) = gl.as_ref() else {
return Ok(());
};
let config = self.config();
let bg = config.background;
let a = config.background_opacity as f32;
let (r, g, b) = (
f32::from(bg.r) / 255.0,
f32::from(bg.g) / 255.0,
f32::from(bg.b) / 255.0,
);
// SAFETY: GL context is current (GLArea render signal).
unsafe {
gl.bind_framebuffer(
glow::FRAMEBUFFER,
std::num::NonZeroU32::new(default_framebuffer).map(glow::NativeFramebuffer),
);
// Premultiplied alpha.
gl.clear_color(r * a, g * a, b * a, a);
gl.clear(glow::COLOR_BUFFER_BIT);
}
Ok(())
}
}
// ---------------------------------------------------------------------
#[derive(Default)]
struct DemoApp {
surfaces: RefCell<Vec<SurfaceId>>,
mailbox: RefCell<Vec<AppMessage>>,
}
impl CoreApp for DemoApp {
fn tick(&self, rt: &dyn RtApp) -> Result<(), CoreError> {
let msgs: Vec<AppMessage> = self.mailbox.borrow_mut().drain(..).collect();
for m in msgs {
match m {
AppMessage::NewWindow => {
rt.perform_action(Target::App, Action::NewWindow);
}
AppMessage::OpenConfig => {
rt.perform_action(Target::App, Action::OpenConfig);
}
AppMessage::PresentSurface(id) => {
if self.surfaces.borrow().contains(&id) {
rt.perform_action(Target::Surface(id), Action::PresentTerminal);
}
}
}
}
Ok(())
}
fn update_config(&self, rt: &dyn RtApp, config: &Arc<Config>) -> Result<(), CoreError> {
rt.perform_action(
Target::App,
Action::ConfigChange(action::ConfigChange {
config: config.clone(),
}),
);
Ok(())
}
fn needs_confirm_quit(&self) -> bool {
confirm() && !self.surfaces.borrow().is_empty()
}
fn color_scheme_event(&self, _rt: &dyn RtApp, scheme: ColorScheme) {
log::info!("demo: color scheme {scheme:?}");
}
fn perform_all_action(&self, rt: &dyn RtApp, a: &Binding) -> Result<(), CoreError> {
if let Some(a) = binding_to_action(a) {
rt.perform_action(Target::App, a);
}
Ok(())
}
fn push_message(&self, msg: AppMessage) {
self.mailbox.borrow_mut().push(msg);
}
fn new_surface(
&self,
id: SurfaceId,
config: Config,
rt_app: Rc<dyn RtApp>,
rt_surface: Rc<dyn RtSurface>,
) -> Result<Rc<dyn CoreSurface>, CoreError> {
self.surfaces.borrow_mut().push(id);
Ok(Rc::new(DemoSurface {
id,
config: RefCell::new(Arc::new(config)),
rt_app,
_rt_surface: rt_surface,
gl: RefCell::new(None),
focused: Cell::new(false),
}))
}
fn delete_surface(&self, id: SurfaceId) {
self.surfaces.borrow_mut().retain(|s| *s != id);
}
fn surface_ids(&self) -> Vec<SurfaceId> {
self.surfaces.borrow().clone()
}
fn cell_size(&self, _config: &Config, _font_size: DesiredFontSize) -> Option<CellSize> {
Some(CellSize {
width: 9,
height: 18,
})
}
}
fn main() {
env_logger::Builder::from_env(env_logger::Env::default().default_filter_or("info")).init();
let core = Rc::new(DemoApp::default());
let app = App::new(core);
if let Some(ms) = std::env::var("DEMO_QUIT_AFTER_MS")
.ok()
.and_then(|v| v.parse::<u64>().ok())
{
gtk::glib::timeout_add_local_once(Duration::from_millis(ms), || {
ghostty_apprt_gtk::class::application::Application::default().quit();
});
}
if let Err(err) = app.run() {
eprintln!("error: {err}");
std::process::exit(1);
}
app.terminate();
}