Grundlæggende immediate-mode-UI

To centrale typer optræder overalt. egui::Context er det delte håndtag, som er billigt at klone, til hele brugergrænsefladens tilstand i billedet.

Ui er et område, som du føjer widgets til. Paneler og vinduer giver dig en &mut Ui i deres closure; du kalder metoder som ui.label eller ui.button på den.

Da brugergrænsefladen genopbygges i hvert billede, kan du ikke registrere callback-funktioner på samme måde som i retained-mode-værktøjskasser. I stedet returnerer hvert widgetkald straks en Response.

Du undersøger Response i det samme billede: .clicked(), .hovered(), .changed(). Det holder hændelseshåndteringen på linje med layoutet.

egui gemmer næsten ingen data om applikationen. Dine widgetværdier ligger i self i App-strukturen, og du sender mutable referencer ind i widgets.

Et tekstfelt tager &mut String, og et afkrydsningsfelt tager &mut bool. egui skriver tilbage gennem referencen, så din struktur er den eneste sandhedskilde.

eframe er det officielle framework, der hoster egui på skrivebordet og på nettet. Det ejer det oprindelige vindue, GPU-overfladen og hændelsesløkken.

Du starter med eframe::run_native og sender en vinduestitel, oprindelige indstillinger og en closure, der opbygger din App.

Som standard genoptegner egui kun, når der sker noget: en musebevægelse, et tastetryk eller en eksplicit anmodning. Det sparer CPU i inaktive applikationer.

Til animationer eller dynamiske data kan du kalde ctx.request_repaint() for at planlægge endnu en frame eller bruge request_repaint_after med en varighed til tidsstyrede opdateringer.

egui udleder widgetidentiteten fra kalderækkefølgen og placeringen og genererer automatisk et Id. Det er vigtigt for ting som sammenklappelige overskrifter, der skal have stabil hukommelse mellem frames.

Når to widgets ville kollidere — f.eks. knapper med samme etiket i en løkke — kan du omgive dem med ui.push_id(i, |ui| ...) for at skelne dem fra hinanden.

Øjeblikstilstand gør brugerfladekode direkte datadrevet: en if viser eller skjuler en sektion, og en for gengiver en liste. Du skal hverken manuelt tilføje eller fjerne noder eller håndtere uoverensstemmelser mellem model og visning.

Ulempen er, at hele brugerfladen køres igen i hver frame, så arbejdet pr. frame skal være billigt, og du bør undgå tunge beregninger i update.

Hvis vi samler det hele: En struktur indeholder tilstanden, update tegner den, og main kører vinduet. Det er hele grundstrukturen i ethvert egui-skrivebordsprogram.

Alt andet — layout, temaer og pakning — bygger videre på denne løkke.

egui's design udnytter R lends styrker. Når &mut self lånes ind i et enkelt kald til update, garanterer lånekontrollen, at der ikke opstår datakapløb mellem widgets og din model.

Der er ingen callbacks, der indfanger delt mutable tilstand, og ingen Rc<RefCell>-grafer, som et gemt træ tvinger dig til at bruge — kun almindeligt ejerskab og én mutable gennemgang pr. frame.

egui bruger øjeblikstilstand: Hele brugerfladen genopbygges i hver frame inde i eframe::App::update. Widgets er funktionskald, der returnerer et Response, som du undersøger med det samme.

Dine data ligger i self og sendes med mutable referencer, så lånekontrollen holder model og visning synkroniseret. eframe::run_native hoster vinduet og hændelsesløkken. Nu undersøger vi widgetudvalget og layoutsystemet.