Fundamentos de UI em modo imediato

egui é uma biblioteca GUI de modo imediato. Diferentemente dos kits de ferramentas de modo retido (GTK, Qt), nos quais você constrói uma árvore persistente de componentes, egui reconstrói toda a interface do zero a cada quadro.

Seu código é executado de cima para baixo em cada quadro, emitindo componentes como chamadas de função. Não há um grafo de nós armazenado — a interface é apenas um efeito colateral da execução do seu fechamento.

Um app egui implementa eframe::App, cujo método update é chamado uma vez por quadro, normalmente 60 vezes por segundo.

Dentro de update, você descreve a aparência que a interface deve ter agora, considerando o estado atual. egui não calcula diferenças — simplesmente emite tudo novamente.

Dois tipos essenciais aparecem em toda parte. egui::Context é o identificador compartilhado, barato de clonar, para todo o estado da interface no quadro.

Ui é uma região na qual você adiciona componentes. Painéis e janelas fornecem um &mut Ui dentro do fechamento; você chama métodos como ui.label ou ui.button nele.

Como a interface é reconstruída a cada quadro, você não pode registrar retornos de chamada como nos kits de ferramentas de modo retido. Em vez disso, cada chamada de componente retorna imediatamente uma Response.

Você inspeciona a Response no mesmo quadro: .clicked(), .hovered(), .changed(). Isso mantém o tratamento de eventos junto do layout.

egui armazena pouquíssimos dados da aplicação. Os valores dos seus componentes vivem em self na estrutura App, e você passa referências mutáveis para os componentes.

Um campo de texto recebe &mut String; uma caixa de seleção recebe &mut bool. egui grava os valores de volta por meio da referência, portanto sua estrutura é a única fonte da verdade.

eframe é o framework oficial que hospeda egui em computadores e na web. Ele gerencia a janela nativa, a superfície da GPU e o loop de eventos.

Você o inicia com eframe::run_native, passando um título de janela, opções nativas e um fechamento que cria seu App.

Por padrão, egui só redesenha quando algo acontece: movimento do mouse, pressionamento de tecla ou uma solicitação explícita. Isso economiza CPU em aplicações ociosas.

Para animações ou dados em tempo real, chame ctx.request_repaint() para agendar outro quadro ou request_repaint_after com uma duração para atualizações programadas.

egui deriva a identidade do componente a partir da ordem e da posição das chamadas, gerando um Id automaticamente. Isso é importante para elementos como cabeçalhos recolhíveis, que precisam manter uma memória estável entre os quadros.

Quando dois componentes colidiriam — por exemplo, botões com o mesmo rótulo em um loop — envolva-os com ui.push_id(i, |ui| ...) para diferenciá-los.

O modo imediato torna o código da interface naturalmente orientado a dados: um if mostra ou oculta uma seção, e um for renderiza uma lista. Não há adição ou remoção manual de nós nem dessincronização entre o modelo e a visualização.

O custo é que toda a interface é executada novamente a cada quadro; portanto, mantenha baixo o trabalho por quadro e evite cálculos pesados dentro de update.

Reunindo tudo: uma estrutura mantém o estado, update o desenha e main executa a janela. Esse é o esqueleto completo de qualquer programa egui para computador.

Todo o restante — layout, temas e empacotamento — é construído sobre esse loop.

O design de egui aproveita os pontos fortes de Rust. Emprestar &mut self em uma única chamada a update permite que o verificador de empréstimos garanta a ausência de condições de corrida entre os componentes e seu modelo.

Não há retornos de chamada que capturem estado mutável compartilhado nem grafos de Rc<RefCell> impostos por uma árvore retida — apenas propriedade direta e uma passagem mutável por quadro.

egui usa o modo imediato: toda a interface é reconstruída a cada quadro dentro de eframe::App::update. Os componentes são chamadas de função que retornam uma Response para você inspecionar imediatamente.

Seus dados vivem em self e são passados por referência mutável, portanto o verificador de empréstimos mantém o modelo e a visualização sincronizados. eframe::run_native hospeda a janela e o loop de eventos. A seguir, exploraremos a coleção de componentes e o sistema de layout.