Lerp#
func Lerp(from, to, t float32) float32Lerp interpolates from one scalar to another. t is clamped to [0, 1] and the end points are returned exactly, so a finished transition paints the same pixels as a static state.
Package ui
Package ui defines lightweight, platform-neutral paint primitives.
Import path: import "github.com/vivaui/viva/ui"
Package ui defines lightweight, platform-neutral paint primitives.
Types
- AlignmentAlignment selects horizontal label placement within its bounds.
- BitmapBitmap is immutable premultiplied BGRA pixel data.
- CanvasCanvas retains paint primitives and hit regions in deterministic back-to-front order.
- ClipClip is one clipping rectangle restricting the primitives painted after it until the next PopClip with the same depth.
- ColorColor is a linear RGBA color.
- ColumnColumn lays out slots top to bottom with a fixed gap.
- DensityDensity scales control geometry without touching colors.
- EasingEasing selects a cubic-bezier timing curve for a transition.
- EllipsisCacheEllipsisCache remembers the ellipsized last line of one wrapped text, so that wrapping the same text at the same width again, frame after frame, builds no string.
- EventResultEventResult reports how an application handled an input event.
- FileDropEventFileDropEvent is files dragged from the system over, or dropped on, a window.
- FileDropPhaseFileDropPhase says where a drag of files from the system is.
- GridGrid hands out the cells of a GridSpec left to right, wrapping at the container edge.
- GridSpecGridSpec describes a wrapping grid of equal cells.
- HitHit is one pointer interaction region in back-to-front paint order.
- HitOptionsHitOptions describes interaction and accessibility state without a dynamic property bag.
- IDID identifies a pointer interaction region: a scope and a name.
- IconIcon is one compiled vector glyph: immutable Path commands plus stroke metadata, produced ahead of time by the `viva icons` compiler from SVG sources.
- IconLayerIconLayer is one filled shape of a multi-color icon.
- ImageImage is one bitmap draw.
- InsetsInsets describe uniform per-edge padding in logical pixels.
- KeyKey is one normalized, platform-independent keyboard identity.
- KeyEventKeyEvent is delivered to the currently focused hit target.
- LinearGradientLinearGradient is a two-color linear gradient in an icon's view-box units: From at Start, To at End, held flat beyond both (SVG's spreadMethod "pad"), mixed as straight RGBA like SVG.
- LiveRegionLiveRegion says how eagerly assistive technology announces a change to the content of a region, as aria-live does.
- MetricsMetrics carries the size tokens every component consumes.
- ModifiersModifiers is a bitset of active keyboard modifiers.
- MonoFaceMonoFace chooses one system-provided fixed-pitch family.
- MotionMotion is one timed state change.
- NameName names one control or item within a scope: a word (Tree.Name) for a control, or the number of an item (Index) for a row of a list.
- PathPath is immutable vector geometry in a fixed view box.
- PathCommandPathCommand is one explicit path instruction in view-box coordinates.
- PathCommandKindPathCommandKind identifies one immutable path command.
- PathFillRulePathFillRule selects how overlapping contour coverage combines.
- PathStylePathStyle describes a path fill and/or stroke.
- PointPoint is one logical-pixel coordinate measured from the top-left.
- PointerButtonPointerButton identifies the pointer button responsible for an event.
- PointerCursorPointerCursor selects the pointer shape while a hit is hovered or dragged.
- PointerEventPointerEvent is delivered in logical window pixels.
- PointerEventKindPointerEventKind identifies one normalized pointer phase.
- PresencePresence describes how one overlay enters and leaves: a dialog fading in and out while it grows from 95% of its size, a menu sliding a few pixels from the edge it opens on, a sheet sliding in from the side.
- RectRect is a logical-pixel rectangle measured from the top-left.
- RectangleRectangle is one solid paint primitive.
- RoleRole describes the platform-neutral semantic purpose of an interactive hit.
- RowRow lays out slots left to right with a fixed gap.
- ScopeScope is a place in the identity tree: a page, a dialog, a list.
- ScrollEventScrollEvent is one normalized scroll gesture in logical window pixels.
- ShadowShadow is one soft shadow primitive: the shadow that the rounded rectangle Bounds and Radius casts, placed and blurred by Style and painted in Color.
- ShadowLevelShadowLevel is a step of the elevation scale shadcn takes from Tailwind CSS: the stronger the level, the higher a surface floats above the page.
- ShadowStyleShadowStyle is one soft drop-shadow layer, the arguments of a CSS box-shadow: the shadow is the casting rectangle moved by OffsetX and OffsetY, grown by Spread on every side (shrunk when negative), and blurred over a Blur-wide band either side of its edge.
- SizeSize is a width and height in logical pixels.
- StrokeCapStrokeCap selects the shape at open contour endpoints.
- StrokeJoinStrokeJoin selects the corner shape between stroke segments.
- SurfaceSurface is a retained, opaque BGRA picture that changes in place: a remote desktop, a video frame, a canvas an application paints pixels into.
- TextText is one immutable single-line label clipped like rectangles.
- TextDirectionTextDirection is the direction of a paragraph of text.
- TextEngineTextEngine measures and hit-tests one line of text with the platform's own shaped line: the same line that is drawn, with the platform's font fallback, so a width, a caret and a click agree with the glyphs on screen.
- TextPlacementTextPlacement is what a text field that lays its own rows out tells the runtime about them, painted by the last frame.
- TextRowTextRow is one row of a wrapped text: the bytes value[Start:End], where Start is a place a row can begin and End is where it stops, before the line break that ends it or, where the text wrapped, at the start of the next row.
- TextRunTextRun colors and places a stretch of a LabelRuns line: the Bytes bytes of the label's text that follow the previous run, drawn starting at cell Column and spanning Cells columns.
- TextSpanTextSpan is a horizontal extent of a line.
- TextStyleTextStyle describes one system-font line.
- ThemeTheme contains semantic design tokens rather than runtime CSS.
- TreeTree is the set of places an application has named.
- TriangleTriangle is one solid vector-mesh primitive.
- ValueRangeValueRange is the numeric value of a slider, a progress bar or a spinner: where it is, the bounds it moves between and the smallest step.
- Win32KeyWin32Key is the Windows console INPUT_RECORD data of a key event: the virtual-key and scan codes, the UTF-16 code unit, the control-key state and the repeat count.
Functions
MonoFamilyCount#
func MonoFamilyCount() intMonoFamilyCount is how many named families have been registered, so a platform can tell cheaply that it has new ones to learn.
MonoFamilyName#
func MonoFamilyName(face MonoFace) stringMonoFamilyName is the family a face from MonoFamily stands for, or "" for the built-in faces and for a number no MonoFamily call returned.
Constants
const (
WeightRegular float32 = 0
WeightMedium float32 = 0.15
WeightSemibold float32 = 0.23
WeightBold float32 = 0.40
)const MaxMonoFamilies = 250MaxMonoFamilies is how many named fixed-pitch families one process can use, besides the two built-in faces.