render

type Frame ¶

type Frame struct {
	Quads   []Quad
	Uploads []text.Upload
}

type ListBuffer ¶

type ListBuffer struct {
	// contains filtered or unexported fields
}

ListBuffer is a single-owner scratch area for repeated ListBatches calls. The slices it returns alias its storage: they are valid only until the next List or Release call, and must not be retained, shared across goroutines, or used while another List may run. This is safe for consumers that copy the data synchronously (Target.submit uploads instances into GPU memory and resolve copies the batches before recording returns); anything that keeps the slices past that point must use ListBatches instead. Retained frames hold only render.Frame, never these slices, so a blocked frame is re-listed on retry. Stats.Skipped shares the same lifetime. The zero value is ready to use.

func (b *ListBuffer) List(frame Frame) ([]vkdevice.Instance, []vkdevice.Batch, ListStats)

func (b *ListBuffer) Release()

type ListStats ¶

type ListStats struct {
	Drawn   int
	Skipped map[string]int
}

ListStats reports every skipped prepared quad by operation.

func ListBatches(frame Frame) ([]vkdevice.Instance, []vkdevice.Batch, ListStats)

func ListInstances(frame Frame) ([]vkdevice.Instance, ListStats)

type Preparer ¶

type Preparer struct {
	Atlas *text.Atlas
	// contains filtered or unexported fields
}

Preparer owns the glyph atlas and the obligation to deliver its changes to the GPU mirror. Prepare hands the caller every change not yet known to be submitted; Submitted is the only acknowledgement. A frame that is retried, abandoned, superseded or never reached submission therefore never loses atlas changes: the next Prepare resends whole pages (placements are kept).

func NewPreparer(size, pages int) (*Preparer, error)

func (p *Preparer) Prepare(commands []layout.Command, scale float64, width, height int) (Frame, error)

func (p *Preparer) PrepareInto(quads []Quad, commands []layout.Command, scale float64, width, height int) (Frame, error)

func (p *Preparer) Submitted(uploads []text.Upload)

type Quad ¶

type Quad struct {
	Op     string
	Rect   layout.Rect
	Clip   layout.Rect
	Color  css.Color
	Radii  [4]float64
	Widths layout.Edges
	Colors css.ColorSides
	Glyph  text.Placement
	Image  image.Image
	// Shape is the original box when the draw bounds extend past it.
	Shape layout.Rect
	// Shadow holds physical offset, blur and spread. Inset is carried separately.
	Shadow [4]float64
	Inset  bool
}

Quad is a physical-pixel rectangle with a physical clip. Color is straight sRGB; conversion to premultiplied linear color belongs at the GPU boundary. Glyphs refer to an atlas placement valid only for this prepared frame.