svg source pure

Package svg is a minimalist and extensible SVG generation library for Gno.

It provides a structured way to create and compose SVG elements such as rectangles, circles, text, paths, and more. The package is designed to be modular and developer-friendly, enabling optional attributes and method chaining for ease of use.

Each SVG element embeds a BaseAttrs struct, which supports common SVG attributes like `id`, `class`, `style`, `fill`, `stroke`, and `transform`.

Canvas objects represent the root SVG container and support global dimensions, viewBox configuration, embedded styles, and element composition.

Example:

Example

 1import "gno.land/p/demo/svg"
 2
 3func Foo() string {
 4	canvas := svg.NewCanvas(200, 200).WithViewBox(0, 0, 200, 200)
 5	canvas.AddStyle(".my-rect", "stroke:black;stroke-width:2")
 6	canvas.Append(
 7		svg.NewRectangle(60, 40, 100, 50, "red").WithClass("my-rect"),
 8		svg.NewCircle(50, 80, 40, "blue"),
 9		&svg.Path{D: `M 10,30
10		A 20,20 0,0,1 50,30
11			A 20,20 0,0,1  90,30
12			Q 90,60 50,90
13			Q 10,60 10,30 z`, Fill: "magenta"},
14		svg.NewText(20, 50, "Hello SVG", "black"),
15	)
16	mysvg := canvas.Base64()
17}

1func NewCanvas(width, height int) *Canvas

source

1func NewCircle(cx, cy, r int, fill string) *Circle

source

1func NewEllipse(cx, cy int, fill string) *Ellipse

source

1func NewGroup(fill string) *Group

source

1func NewPath(d, fill string) *Path

source

1func NewPolygon(points, fill string) *Polygon

source

1func NewPolyline(points, fill string) *Polyline

source

1func NewRectangle(x, y, width, height int, fill string) *Rectangle

source

1func NewText(x, y int, text, fill string) *Text

source

 1type BaseAttrs struct {
 2	ID          string
 3	Class       string
 4	Style       string
 5	Stroke      string
 6	StrokeWidth string
 7	Opacity     string
 8	Transform   string
 9	Visibility  string
10}

source

1func (b BaseAttrs) String() string

source

1type Canvas struct {
2	Width, Height int
3	ViewBox       string
4	Elems         []Elem
5	Style         *avl.Tree
6}

source

1func (c *Canvas) AddStyle(key, value string) *Canvas

source

1func (c *Canvas) Append(elem ...Elem)

source

1func (c Canvas) Base64() string

source

1func (c Canvas) Render(alt string) string

source

Render renders your canvas

1func (c Canvas) String() string

source

1func (c *Canvas) WithViewBox(x, y, width, height int) *Canvas

source

1type Circle struct {
2	CX   int // center X
3	CY   int // center Y
4	R    int // radius
5	Fill string
6	Attr BaseAttrs
7}

source

1func (c Circle) String() string

source

1func (c *Circle) WithClass(class string) *Circle

source

1type Elem interface{ String() string }

source

1type Ellipse struct {
2	CX   int // center X
3	CY   int // center Y
4	RX   int // radius X
5	RY   int // radius Y
6	Fill string
7	Attr BaseAttrs
8}

source

1func (e Ellipse) String() string

source

1func (e *Ellipse) WithClass(class string) *Ellipse

source

1type Group struct {
2	Elems []Elem
3	Fill  string
4	Attr  BaseAttrs
5}

source

1func (g *Group) Append(elem ...Elem)

source

1func (g Group) String() string

source

1func (g *Group) WithClass(class string) *Group

source

1type Path struct {
2	D    string
3	Fill string
4	Attr BaseAttrs
5}

source

1func (p Path) String() string

source

1func (p *Path) WithClass(class string) *Path

source

1type Polygon struct {
2	Points string
3	Fill   string
4	Attr   BaseAttrs
5}

source

1func (p Polygon) String() string

source

1func (p *Polygon) WithClass(class string) *Polygon

source

1type Polyline struct {
2	Points string
3	Fill   string
4	Attr   BaseAttrs
5}

source

1func (p Polyline) String() string

source

1func (p *Polyline) WithClass(class string) *Polyline

source

1type Rectangle struct {
2	X, Y, Width, Height int
3	RX, RY              int // corner radiuses
4	Fill                string
5	Attr                BaseAttrs
6}

source

1func (r Rectangle) String() string

source

1func (r *Rectangle) WithClass(class string) *Rectangle

source

1type Text struct {
2	X, Y       int
3	DX, DY     int // shift text pos horizontally/ vertically
4	Rotate     string
5	Text, Fill string
6	Attr       BaseAttrs
7}

source

1func (c Text) String() string

source

1func (c *Text) WithClass(class string) *Text

source

encoding/base64 stdlib
gno.land/p/nt/avl/v0 package
gno.land/p/nt/ufmt/v0 package
strings stdlib

Overview

Functions 9

Types 11

Methods on BaseAttrs

Methods on Canvas

Methods on Circle

Methods on Ellipse

Methods on Group

Methods on Path

Methods on Polygon

Methods on Polyline

Methods on Rectangle

Methods on Text

Imports 4

Source Files 5