surface_types.go RawHistoryFolder

1package neferclient
2
3import "slices"
4
5// SurfaceID identifies a [Surface] in Handler callbacks. IDs are never
6// reused within a connection.
7type SurfaceID uint32
8
9// Format is one DRM format and modifier pair from linux-dmabuf feedback.
10type Format struct {
11	FourCC   uint32
12	Modifier uint64
13}
14
15// Feedback is the latest complete linux-dmabuf feedback of a surface.
16type Feedback struct {
17	MainDevice uint64   // dev_t of the compositor's main device
18	Formats    []Format // every tranche's formats, flattened in tranche order
19}
20
21// Equal reports whether f and o have the same main device and the same formats
22// in the same order. Feedback flattens tranches, so a change limited to a
23// tranche's target device or scanout flag is not visible here. A nil Feedback
24// equals only nil. The compositor sends a complete round again whenever it
25// re-evaluates its preference, often unchanged, so compare against the
26// feedback a renderer was built from before rebuilding it.
27func (f *Feedback) Equal(o *Feedback) bool {
28	if f == nil || o == nil {
29		return f == o
30	}
31	return f.MainDevice == o.MainDevice && slices.Equal(f.Formats, o.Formats)
32}
33
34// Clone returns a deep copy that stays valid after later rounds. The value from
35// [Surface.Feedback] shares memory the library reuses, so keep a Clone of the
36// feedback a renderer was built from. A nil Feedback clones to nil.
37func (f *Feedback) Clone() *Feedback {
38	if f == nil {
39		return nil
40	}
41	return &Feedback{MainDevice: f.MainDevice, Formats: slices.Clone(f.Formats)}
42}
43
44// Rect is an integer rectangle: surface-local logical pixels for input
45// regions, buffer pixels for damage.
46type Rect struct{ X, Y, Width, Height int32 }