example_test.go RawHistoryFolder

1package nefergui_test
2
3import (
4	"fmt"
5	"log"
6
7	"github.com/bnema/nefergui"
8)
9
10// ExampleRenderer shows the shape of a client loop. The Wayland side (display
11// connection, linux-dmabuf feedback, buffer import, event dispatch) belongs to
12// the application, for instance through github.com/bnema/neferclient; it is
13// elided here. The example needs a GPU and a compositor, so it is compiled but
14// not run by go test.
15func ExampleRenderer() {
16	type model struct{ count int }
17	view := func(f *nefergui.Frame, m *model) {
18		root := f.Root().Column()
19		root.Text("Hello, Wayland!")
20		if root.Button("Count", nefergui.Key("count")).Activated() {
21			m.count++
22		}
23		root.Text(fmt.Sprintf("Clicked %d times", m.count))
24	}
25
26	// mainDevice and formats come from the compositor's linux-dmabuf feedback.
27	var (
28		mainDevice uint64
29		formats    []nefergui.Format
30	)
31	r, err := nefergui.NewRenderer(nefergui.RendererConfig{MainDevice: mainDevice, Formats: formats})
32	if err != nil {
33		log.Fatal(err)
34	}
35	defer r.Close()
36
37	// Forward the surface size, then wire events as they arrive.
38	r.Resize(320, 200, 1)
39	r.Input(&nefergui.Input{Kind: nefergui.InputPointerMotion, X: 10, Y: 10})
40
41	m := &model{}
42	var out nefergui.Output
43	// One iteration of the client loop; real clients repeat it forever.
44	drawn, err := r.Render(&out, m, view)
45	if err != nil {
46		log.Fatal(err)
47	}
48	if drawn {
49		// Import out.Planes as a wl_buffer when out.NewBuffer is set, attach
50		// it with the Acquire/Release points, commit, and call r.Released
51		// when out.ReleaseFD becomes readable.
52		_ = out.Buffer
53	}
54	// Then sleep until a Wayland event, <-r.Wake(), or a short timer when
55	// r.Pending() reports a frame waiting for the GPU.
56}