vector

Documentation

Overview

Package vector provides functions for vector graphics rendering.

This package is under experiments and the API might be changed with breaking backward compatibility.

Index

• func DrawFilledCircle(dst *ebiten.Image, cx, cy, r float32, clr color.Color, antialias bool)
• func DrawFilledRect(dst *ebiten.Image, x, y, width, height float32, clr color.Color, ...)
• func FillCircle(dst *ebiten.Image, cx, cy, r float32, clr color.Color, antialias bool)
• func FillPath(dst *ebiten.Image, path *Path, fillOptions *FillOptions, ...)
• func FillRect(dst *ebiten.Image, x, y, width, height float32, clr color.Color, ...)
• func StrokeCircle(dst *ebiten.Image, cx, cy, r float32, strokeWidth float32, clr color.Color, ...)
• func StrokeLine(dst *ebiten.Image, x0, y0, x1, y1 float32, strokeWidth float32, ...)
• func StrokePath(dst *ebiten.Image, path *Path, strokeOptions *StrokeOptions, ...)
• func StrokeRect(dst *ebiten.Image, x, y, width, height float32, strokeWidth float32, ...)
• type AddPathOptions
• type AddStrokeOptions
• type Direction
• type DrawPathOptions
• type FillOptions
• type FillRule
• type LineCap
• type LineJoin
• type Path
  • func (p *Path) AddPath(src *Path, options *AddPathOptions)
  • func (p *Path) AddStroke(src *Path, options *AddStrokeOptions)
  • func (p *Path) AppendVerticesAndIndicesForFilling(vertices []ebiten.Vertex, indices []uint16) ([]ebiten.Vertex, []uint16)
  • func (p *Path) AppendVerticesAndIndicesForStroke(vertices []ebiten.Vertex, indices []uint16, op *StrokeOptions) ([]ebiten.Vertex, []uint16)
  • func (p *Path) Arc(x, y, radius, startAngle, endAngle float32, dir Direction)
  • func (p *Path) ArcTo(x1, y1, x2, y2, radius float32)
  • func (p *Path) Bounds() image.Rectangle
  • func (p *Path) Close()
  • func (p *Path) CubicTo(x1, y1, x2, y2, x3, y3 float32)
  • func (p *Path) LineTo(x, y float32)
  • func (p *Path) MoveTo(x, y float32)
  • func (p *Path) QuadTo(x1, y1, x2, y2 float32)
  • func (p *Path) Reset()
• type StrokeOptions

Functions

func DrawFilledCircle

func DrawFilledCircle(dst *ebiten.Image, cx, cy, r float32, clr color.Color, antialias bool)

DrawFilledCircle fills a circle with the specified center position (cx, cy), the radius (r), width and color.

Deprecated: as of v2.9. Use FillCircle instead.

func DrawFilledRect

func DrawFilledRect(dst *ebiten.Image, x, y, width, height float32, clr color.Color, antialias bool)

DrawFilledRect fills a rectangle with the specified width and color.

Deprecated: as of v2.9. Use FillRect instead.

func FillCircle

func FillCircle(dst *ebiten.Image, cx, cy, r float32, clr color.Color, antialias bool)

FillCircle fills a circle with the specified center position (cx, cy), the radius (r), width and color.

func FillPath

func FillPath(dst *ebiten.Image, path *Path, fillOptions *FillOptions, drawPathOptions *DrawPathOptions)

FillPath fills the specified path with the specified options.

func FillRect

func FillRect(dst *ebiten.Image, x, y, width, height float32, clr color.Color, antialias bool)

FillRect fills a rectangle with the specified width and color.

func StrokeCircle

func StrokeCircle(dst *ebiten.Image, cx, cy, r float32, strokeWidth float32, clr color.Color, antialias bool)

StrokeCircle strokes a circle with the specified center position (cx, cy), the radius (r), width and color.

func StrokeLine

func StrokeLine(dst *ebiten.Image, x0, y0, x1, y1 float32, strokeWidth float32, clr color.Color, antialias bool)

StrokeLine strokes a line (x0, y0)-(x1, y1) with the specified width and color.

func StrokePath

func StrokePath(dst *ebiten.Image, path *Path, strokeOptions *StrokeOptions, drawPathOptions *DrawPathOptions)

StrokePath strokes the specified path with the specified options.

func StrokeRect

func StrokeRect(dst *ebiten.Image, x, y, width, height float32, strokeWidth float32, clr color.Color, antialias bool)

StrokeRect strokes a rectangle with the specified width and color.

Types

type AddPathOptions

type AddPathOptions struct {
	// GeoM is a geometry matrix to apply to the path.
	//
	// The default (zero) value is an identity matrix.
	GeoM ebiten.GeoM
}

AddPathOptions is options for Path.AddPath.

type AddStrokeOptions

type AddStrokeOptions struct {
	// StrokeOptions is options for the stroke.
	StrokeOptions

	// GeoM is a geometry matrix to apply to the path.
	//
	// The default (zero) value is an identity matrix.
	GeoM ebiten.GeoM
}

AddStrokeOptions is options for Path.AddStroke.

type Direction

type Direction int

Direction represents clockwise or counterclockwise.

const (
	Clockwise Direction = iota
	CounterClockwise
)

type DrawPathOptions

type DrawPathOptions struct {
	// AntiAlias is whether the path is drawn with anti-aliasing.
	// The default (zero) value is false.
	AntiAlias bool

	// ColorScale is the color scale to apply to the path.
	// The default (zero) value is identity, which is (1, 1, 1, 1) (white).
	ColorScale ebiten.ColorScale

	// Blend is the blend mode to apply to the path.
	// The default (zero) value is ebiten.BlendSourceOver.
	Blend ebiten.Blend
}

DrawPathOptions is options to draw a path.

type FillOptions

type FillOptions struct {
	// FillRule is the rule whether an overlapped region is rendered or not.
	// The default (zero) value is FillRuleNonZero.
	FillRule FillRule
}

FillOptions is options to fill a path.

type FillRule

type FillRule int

FillRule is the rule whether an overlapped region is rendered or not.

const (
	// FillRuleNonZero means that triangles are rendered based on the non-zero rule.
	// If and only if the number of overlaps is not 0, the region is rendered.
	FillRuleNonZero FillRule = iota

	// FillRuleEvenOdd means that triangles are rendered based on the even-odd rule.
	// If and only if the number of overlaps is odd, the region is rendered.
	FillRuleEvenOdd
)

type LineCap

type LineCap int

LineCap represents the way in which how the ends of the stroke are rendered.

const (
	LineCapButt LineCap = iota
	LineCapRound
	LineCapSquare
)

type LineJoin

type LineJoin int

LineJoin represents the way in which how two segments are joined.

const (
	LineJoinMiter LineJoin = iota
	LineJoinBevel
	LineJoinRound
)

type Path

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

Path represents a collection of vector graphics operations.

func (*Path) AddPath

func (p *Path) AddPath(src *Path, options *AddPathOptions)

AddPath adds the given path src to this path p as a sub-path.

func (*Path) AddStroke

func (p *Path) AddStroke(src *Path, options *AddStrokeOptions)

AddStroke adds a stroke path to the path p.

The added stroke path must be rendered with FileRuleNonZero.

func (*Path) AppendVerticesAndIndicesForFilling

func (p *Path) AppendVerticesAndIndicesForFilling(vertices []ebiten.Vertex, indices []uint16) ([]ebiten.Vertex, []uint16)

AppendVerticesAndIndicesForFilling appends vertices and indices to fill this path and returns them.

AppendVerticesAndIndicesForFilling works in a similar way to the built-in append function. If the arguments are nils, AppendVerticesAndIndicesForFilling returns new slices.

The returned vertice's SrcX and SrcY are 0, and ColorR, ColorG, ColorB, and ColorA are 1.

The returned values are intended to be passed to DrawTriangles or DrawTrianglesShader with FileRuleNonZero or FillRuleEvenOdd in order to render a complex polygon like a concave polygon, a polygon with holes, or a self-intersecting polygon.

The returned vertices and indices should be rendered with a solid (non-transparent) color with the default Blend (source-over). Otherwise, there is no guarantee about the rendering result.

Deprecated: as of v2.9. Use FillPath instead.

func (*Path) AppendVerticesAndIndicesForStroke

func (p *Path) AppendVerticesAndIndicesForStroke(vertices []ebiten.Vertex, indices []uint16, op *StrokeOptions) ([]ebiten.Vertex, []uint16)

AppendVerticesAndIndicesForStroke appends vertices and indices to render a stroke of this path and returns them. AppendVerticesAndIndicesForStroke works in a similar way to the built-in append function. If the arguments are nils, AppendVerticesAndIndicesForStroke returns new slices.

The returned vertice's SrcX and SrcY are 0, and ColorR, ColorG, ColorB, and ColorA are 1.

The returned values are intended to be passed to DrawTriangles or DrawTrianglesShader with a solid (non-transparent) color with FillRuleFillAll or FillRuleNonZero, not FileRuleEvenOdd.

Deprecated: as of v2.9. Use StrokePath or Path.AddStroke instead.

func (*Path) Arc

func (p *Path) Arc(x, y, radius, startAngle, endAngle float32, dir Direction)

Arc adds an arc to the path. (x, y) is the center of the arc.

func (*Path) ArcTo

func (p *Path) ArcTo(x1, y1, x2, y2, radius float32)

ArcTo adds an arc curve to the path. (x1, y1) is the first control point, and (x2, y2) is the second control point.

func (*Path) Bounds

func (p *Path) Bounds() image.Rectangle

Bounds returns the minimum bounding rectangle of the path.

func (*Path) Close

func (p *Path) Close()

Close adds a new line from the last position of the current sub-path to the first position of the current sub-path, and marks the current sub-path closed. Following operations for this path will start with a new sub-path.

func (*Path) CubicTo

func (p *Path) CubicTo(x1, y1, x2, y2, x3, y3 float32)

CubicTo adds a cubic Bézier curve to the path. (x1, y1) and (x2, y2) are the control points, and (x3, y3) is the destination.

func (*Path) LineTo

func (p *Path) LineTo(x, y float32)

LineTo adds a line segment to the path, which starts from the last position of the current sub-path and ends to the given position (x, y). If p doesn't have any sub-paths or the last sub-path is closed, LineTo sets (x, y) as the start position of a new sub-path.

func (*Path) MoveTo

func (p *Path) MoveTo(x, y float32)

MoveTo starts a new sub-path with the given position (x, y) without adding a sub-path,

func (*Path) QuadTo

func (p *Path) QuadTo(x1, y1, x2, y2 float32)

QuadTo adds a quadratic Bézier curve to the path. (x1, y1) is the control point, and (x2, y2) is the destination.

func (*Path) Reset

func (p *Path) Reset()

Reset resets the path. Reset doesn't release the allocated memory so that the memory can be reused.

type StrokeOptions

type StrokeOptions struct {
	// Width is the stroke width in pixels.
	//
	// The default (zero) value is 0.
	Width float32

	// LineCap is the way in which how the ends of the stroke are rendered.
	// Line caps are not rendered when the sub-path is marked as closed.
	//
	// The default (zero) value is [LineCapButt].
	LineCap LineCap

	// LineJoin is the way in which how two segments are joined.
	//
	// The default (zero) value is [LineJoinMiter].
	LineJoin LineJoin

	// MiterLimit is the miter limit for [LineJoinMiter].
	// For details, see https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-miterlimit.
	//
	// The default (zero) value is 0.
	MiterLimit float32
}

StrokeOptions is options to render a stroke.