axes

type Axis ¶

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

Axis represents a visualization axis with tick marks and labels. Works with any scale type (linear, log, time, band, etc.) to generate appropriate tick positions and labels.

Example:

scale := scales.NewLinearScale([2]float64{0, 100}, [2]units.Length{units.Px(0), units.Px(500)})
axis := NewAxis(scale, AxisOrientationBottom)
axis.TickCount(10).Title("Temperature (°C)")

func NewAxis(scale scales.Scale, orientation AxisOrientation) *Axis

func (a *Axis) Grid(length units.Length) *Axis

func (a *Axis) Orientation() AxisOrientation

func (a *Axis) Render(opts RenderOptions) string

func (a *Axis) Scale() scales.Scale

func (a *Axis) String(opts RenderOptions) string

func (a *Axis) TickCount(count int) *Axis

func (a *Axis) TickFormat(formatter TickFormatFunc) *Axis

func (a *Axis) TickPadding(padding units.Length) *Axis

func (a *Axis) TickSize(size units.Length) *Axis

func (a *Axis) Ticks() []Tick

func (a *Axis) Title(title string) *Axis

type AxisOrientation ¶

type AxisOrientation int

AxisOrientation specifies where the axis is positioned

const (
	AxisOrientationTop AxisOrientation = iota
	AxisOrientationBottom
	AxisOrientationLeft
	AxisOrientationRight
)

func (o AxisOrientation) IsHorizontal() bool

func (o AxisOrientation) IsVertical() bool

func (o AxisOrientation) String() string

type AxisStyle ¶

type AxisStyle struct {
	StrokeColor     string
	StrokeWidth     float64
	TextColor       string
	FontSize        float64
	FontFamily      string
	GridStrokeColor string
	GridStrokeWidth float64
	GridDashArray   string
	TitleFontSize   float64
	TitleFontWeight string
	TextOverflow    TextOverflow // How to handle long labels
}

AxisStyle contains styling options for axis rendering

func DefaultAxisStyle() AxisStyle

type RenderOptions ¶

type RenderOptions struct {
	Style    AxisStyle
	Position units.Length // Position perpendicular to axis (e.g., y-position for horizontal axis)
}

RenderOptions contains options for rendering an axis

func DefaultRenderOptions() RenderOptions

type TextOverflow ¶

type TextOverflow int

TextOverflow defines how long text should be handled

const (
	// TextOverflowEllipsis truncates text with "..." when it's too long
	TextOverflowEllipsis TextOverflow = iota
	// TextOverflowWrap wraps text onto multiple lines (future enhancement)
	TextOverflowWrap
	// TextOverflowClip clips text without ellipsis
	TextOverflowClip
)

type Tick ¶

type Tick struct {
	Value    interface{}  // Domain value
	Position units.Length // Pixel position along axis
	Label    string       // Formatted label text
}

Tick represents a single axis tick with position and label

type TickFormatFunc ¶

type TickFormatFunc func(value interface{}) string

TickFormatFunc formats tick values into labels

func NumberTickFormatter(precision int) TickFormatFunc

func TimeTickFormatter(format string) TickFormatFunc