text

type AtlasEntry struct {
	Style    FontStyle
	BakeSize float64
	PNG      []byte
	JSON     []byte
}

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

type FontFamilyConfig struct {
	Regular    []byte    // required — TTF/OTF data for the regular style
	Bold       []byte    // optional — TTF/OTF data for bold
	Italic     []byte    // optional — TTF/OTF data for italic
	BoldItalic []byte    // optional — TTF/OTF data for bold-italic
	BakeSizes  []float64 // optional — defaults to [64, 256]
}

type FontStyle int

type Glyph struct {
	ID       rune
	X, Y     uint16
	Width    uint16
	Height   uint16
	XOffset  int16
	YOffset  int16
	XAdvance int16
	Page     uint16
}

type GlyphBitmap struct {
	ID       rune
	Img      *image.Alpha // rasterized glyph (grayscale)
	XOffset  int
	YOffset  int
	XAdvance int
	// contains filtered or unexported fields
}

type GlyphPos struct {
	X, Y   float64
	Region types.TextureRegion
	Page   uint16
}

type SDFGenOptions struct {
	// Size is the font size in pixels for rasterization.
	Size float64
	// DistanceRange is the pixel range of the distance field (typically 4-8).
	DistanceRange float64
	// Chars is the set of characters to include. Empty means printable ASCII (32-126).
	Chars string
	// AtlasWidth is the maximum atlas width in pixels. Default 1024.
	AtlasWidth int
	// PageIndex is the atlas page index for the generated font. Default 0.
	PageIndex uint16
	// MSDF enables multi-channel SDF generation.
	MSDF bool
}

type TextBlock struct {
	// Content is the text string to render. Supports embedded newlines.
	Content string
	// Font is the font family used for measurement and rendering.
	Font *FontFamily
	// FontSize is the desired display size in pixels. Applied at render time as a
	// scale factor (FontSize / Font.LineHeight()), independent of ScaleX/ScaleY.
	// Defaults to 16. Set to 0 or negative to use the font's native atlas size.
	FontSize float64
	// Bold selects the bold variant when resolving the font.
	Bold bool
	// Italic selects the italic variant when resolving the font.
	Italic bool
	// Align controls horizontal alignment within the wrap width or measured bounds.
	Align types.TextAlign
	// WrapWidth is the maximum line width in screen pixels before word wrapping.
	// Internally converted to atlas pixels via FontScale. Zero means no wrapping.
	WrapWidth float64
	// Color is the fill color for the text glyphs.
	Color types.Color
	// LineHeight overrides the font's default line height. Zero uses the font's native value.
	LineHeight float64
	// Sharpness tightens the SDF edge smoothstep window. 0.0 = default rendering,
	// 1.0 = sharpest (half the default smoothing width). Values around 0.5–0.7
	// give crisp edges without aliasing on most display densities.
	Sharpness float64

	// Cached layout (unexported)
	LayoutDirty bool
	MeasuredW   float64
	MeasuredH   float64
	Lines       []TextLine // cached line layout

	// SDF rendering fields
	TextEffects   *TextEffects    // nil = no effects (plain fill)
	SdfVerts      []ebiten.Vertex // local-space glyph quads, rebuilt on layout change
	SdfInds       []uint16        // glyph index buffer
	SdfVertCount  int             // active vertex count
	SdfIndCount   int             // active index count
	SdfUniforms   map[string]any  // cached uniform map (allocated once, updated in place)
	SdfShader     *ebiten.Shader  // cached SDF vs MSDF shader selection
	UniformsDirty bool            // triggers uniform rebuild
}

type TextEffects struct {
	OutlineWidth   float64 // 0 = no outline
	OutlineColor   types.Color
	GlowWidth      float64 // 0 = no glow
	GlowColor      types.Color
	ShadowOffset   types.Vec2 // (0,0) = no shadow
	ShadowColor    types.Color
	ShadowSoftness float64
}

type TextLine struct {
	Glyphs []GlyphPos
	Width  float64
}