text

type Alignment ¶

type Alignment uint8

const (
	Start Alignment = iota
	End
	Middle
)

func (a Alignment) Align(dir system.TextDirection, width fixed.Int26_6, maxWidth int) fixed.Int26_6

func (a Alignment) String() string

type Flags ¶

type Flags uint16

const (
	FlagTowardOrigin Flags = 1 << iota

	FlagLineBreak

	FlagRunBreak

	FlagClusterBreak

	FlagParagraphBreak

	FlagParagraphStart

	FlagTruncator
)

func (f Flags) String() string

type FontFace ¶

type FontFace = giofont.FontFace

type Glyph ¶

type Glyph struct {
	ID GlyphID

	X fixed.Int26_6

	Y int32

	Advance fixed.Int26_6

	Ascent fixed.Int26_6

	Descent fixed.Int26_6

	Offset fixed.Point26_6

	Bounds fixed.Rectangle26_6

	// Runes is the number of runes represented by the glyph. It can
	// exceed 65535 on the truncator glyph, which accounts for every
	// rune hidden by truncation, so it must not be narrower than 32 bits.
	Runes uint32

	Flags Flags
}

type GlyphID ¶

type GlyphID uint64

type LazyFace ¶ added in v1.4.0

type LazyFace struct {
	Typeface giofont.Typeface
	Ranges   []RuneRange
	Match    func(giofont.Font) bool
	Load     func() (FontFace, error)
}

LazyFace describes a font face that is parsed on first use instead of when the Shaper is built. Ranges lists the runes the face is expected to serve; the face is parsed the first time one of them is shaped, or when a rune turns out to be covered by no already-loaded face.

Match, when non-nil, additionally loads the face the first time a layout requests a matching font. This defers faces whose trigger is a style rather than a codepoint — an italic or heavy-weight variant loads on the first layout asking for that aspect, not at startup. A face with Match set and no Ranges is loaded only by its Match (or by the missing-coverage fallback, which always loads everything before giving up on a rune).

Typeface must be the family name the parsed face reports, so that family queries naming it behave the same before and after loading.

type Parameters ¶

type Parameters struct {
	Font giofont.Font

	Alignment Alignment

	PxPerEm fixed.Int26_6

	MaxLines int

	Truncator string

	WrapPolicy WrapPolicy

	MinWidth, MaxWidth int

	Locale system.Locale

	LineHeightScale float32

	LineHeight fixed.Int26_6

	DisableSpaceTrim bool
	// contains filtered or unexported fields
}

type Range ¶

type Range struct {
	Count  int
	Offset int
}

type RuneRange ¶ added in v1.4.0

type RuneRange struct {
	Lo, Hi rune
}

RuneRange is an inclusive range of runes.

type Shaper ¶

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

func NewShaper(options ...ShaperOption) *Shaper

func (l *Shaper) Bitmaps(gs []Glyph) op.CallOp

func (l *Shaper) Layout(params Parameters, txt io.Reader)

func (l *Shaper) LayoutString(params Parameters, str string)

func (l *Shaper) NextGlyph() (_ Glyph, ok bool)

func (l *Shaper) ReleaseLayoutBuffers()

func (l *Shaper) ResetLayoutCache()

func (l *Shaper) Shape(gs []Glyph) clip.PathSpec

type ShaperOption ¶

type ShaperOption func(*Shaper)

func NoSystemFonts() ShaperOption

func WithCollection(collection []FontFace) ShaperOption

func WithLazyCollection(collection []LazyFace) ShaperOption

func WithoutLigatures(typefaces ...giofont.Typeface) ShaperOption

type WrapPolicy ¶

type WrapPolicy uint8

const (
	WrapHeuristically WrapPolicy = iota

	WrapWords

	WrapGraphemes
)