sdf

package
v0.0.0-...-4203c70 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 7, 2024 License: MIT Imports: 20 Imported by: 174

Documentation

Index

Constants

View Source
const InchesPerMillimetre = 1.0 / MillimetresPerInch

InchesPerMillimetre is inches per millimetre

View Source
const Mil = MillimetresPerInch / 1000.0

Mil is millimetres per 1/1000 of an inch

View Source
const MillimetresPerInch = 25.4

MillimetresPerInch is millimetres per inch (25.4)

View Source
const Pi = math.Pi

Pi (3.14159...)

View Source
const Tau = 2 * math.Pi

Tau (2 * Pi).

Variables

This section is empty.

Functions

func BenchmarkSDF2

func BenchmarkSDF2(description string, s SDF2)

BenchmarkSDF2 reports the evaluation speed for an SDF2.

func BenchmarkSDF3

func BenchmarkSDF3(description string, s SDF3)

BenchmarkSDF3 reports the evaluation speed for an SDF3.

func Clamp

func Clamp(x, a, b float64) float64

Clamp x between a and b, assume a <= b

func DtoR

func DtoR(degrees float64) float64

DtoR converts degrees to radians

func EqualFloat64

func EqualFloat64(a, b, epsilon float64) bool

EqualFloat64 compares two float64 values for equality.

func ErrMsg

func ErrMsg(msg string) error

ErrMsg returns an error with a message function name and line number.

func FloatDecode

func FloatDecode(x float64) string

FloatDecode returns a string that decodes the float64 bitfields.

func FloatEncode

func FloatEncode(s int, f uint64, e int) float64

FloatEncode encodes a float64 from sign, fraction and exponent values.

func GenerateMesh2D

func GenerateMesh2D(s SDF2, grid v2i.Vec) (v2.VecSet, error)

GenerateMesh2D generates a set of internal mesh points for an SDF2.

func LoadFont

func LoadFont(fname string) (*truetype.Font, error)

LoadFont loads a truetype (*.ttf) font file.

func Mix

func Mix(x, y, a float64) float64

Mix does a linear interpolation from x to y, a = [0,1]

func Nagon

func Nagon(n int, radius float64) v2.VecSet

Nagon return the vertices of a N sided regular polygon.

func Normal2

func Normal2(s SDF2, p v2.Vec, eps float64) v2.Vec

Normal2 returns the normal of an SDF3 at a point (doesn't need to be on the surface). Computed by sampling it several times inside a box of side 2*eps centered on p.

func Normal3

func Normal3(s SDF3, p v3.Vec, eps float64) v3.Vec

Normal3 returns the normal of an SDF3 at a point (doesn't need to be on the surface). Computed by sampling it several times inside a box of side 2*eps centered on p.

func NormalExtrude

func NormalExtrude(p v3.Vec) v2.Vec

NormalExtrude returns an extrusion function.

func Raycast2

func Raycast2(s SDF2, from, dir v2.Vec, scaleAndSigmoid, stepScale, epsilon, maxDist float64, maxSteps int) (v2.Vec, float64, int)

Raycast2 see Raycast3. NOTE: implementation using Raycast3 (inefficient?)

func Raycast3

func Raycast3(s SDF3, from, dir v3.Vec, scaleAndSigmoid, stepScale, epsilon, maxDist float64, maxSteps int) (collision v3.Vec, t float64, steps int)

Raycast3 collides a ray (with an origin point from and a direction dir) with an SDF3. sigmoid is useful for fixing bad distance functions (those that do not accurately represent the distance to the closest surface, but will probably imply more evaluations) stepScale controls precision (less stepSize, more precision, but more SDF evaluations): use 1 if SDF indicates distance to the closest surface. It returns the collision point, how many normalized distances to reach it (t), and the number of steps performed If no surface is found (in maxDist and maxSteps), t is < 0

func RtoD

func RtoD(radians float64) float64

RtoD converts radians to degrees

func SawTooth

func SawTooth(x, period float64) float64

SawTooth generates a sawtooth function. Returns [-period/2, period/2)

func Sign

func Sign(x float64) float64

Sign returns the sign of x

func SnapFloat64

func SnapFloat64(a, b, epsilon float64) float64

SnapFloat64 snaps a float value to b if it is within epsilon of b.

func WriteTriangles

func WriteTriangles(wg *sync.WaitGroup, triangles *[]*Triangle3) chan<- []*Triangle3

WriteTriangles writes a stream of triangles to a slice.

func ZeroSmall

func ZeroSmall(x, y, epsilon float64) float64

ZeroSmall zeroes out values that are small relative to a quantity.

Types

type ArcSpiralSDF2

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

ArcSpiralSDF2 is a 2d Archimedean spiral.

func (*ArcSpiralSDF2) BoundingBox

func (s *ArcSpiralSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a 2d Archimedean spiral.

func (*ArcSpiralSDF2) Evaluate

func (s *ArcSpiralSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a 2d Archimedean spiral.

type ArraySDF2

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

ArraySDF2 defines an XY grid array of an existing SDF2.

func (*ArraySDF2) BoundingBox

func (s *ArraySDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a grid array of SDF2s.

func (*ArraySDF2) Evaluate

func (s *ArraySDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a grid array of SDF2s.

func (*ArraySDF2) SetMin

func (s *ArraySDF2) SetMin(min MinFunc)

SetMin sets the minimum function to control blending.

type ArraySDF3

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

ArraySDF3 stores an XYZ array of a given SDF3

func (*ArraySDF3) BoundingBox

func (s *ArraySDF3) BoundingBox() Box3

BoundingBox returns the bounding box of an XYZ SDF3 array.

func (*ArraySDF3) Evaluate

func (s *ArraySDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to an XYZ SDF3 array.

func (*ArraySDF3) SetMin

func (s *ArraySDF3) SetMin(min MinFunc)

SetMin sets the minimum function to control blending.

type Bezier

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

Bezier curve specification..

func NewBezier

func NewBezier() *Bezier

NewBezier returns an empty bezier curve.

func (*Bezier) Add

func (b *Bezier) Add(x, y float64) *BezierVertex

Add an x,y vertex to a polygon.

func (*Bezier) AddV2

func (b *Bezier) AddV2(x v2.Vec) *BezierVertex

AddV2 adds a V2 vertex to a polygon.

func (*Bezier) Close

func (b *Bezier) Close()

Close the bezier curve.

func (*Bezier) Mesh2D

func (b *Bezier) Mesh2D() (SDF2, error)

Mesh2D returns the Mesh2D for the bezier curve.

func (*Bezier) Polygon

func (b *Bezier) Polygon() (*Polygon, error)

Polygon returns a polygon approximating the bezier curve.

type BezierPolynomial

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

BezierPolynomial contains the bezier polynomial parameters.

func (*BezierPolynomial) Set

func (p *BezierPolynomial) Set(x []float64)

Set calculates bezier polynomial coefficients given the end/control points.

type BezierSpline

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

BezierSpline contains the x/y bezier curves for a 2D spline.

func NewBezierSpline

func NewBezierSpline(p []v2.Vec) *BezierSpline

NewBezierSpline returns a bezier spline from the provided control/end points.

func (*BezierSpline) Sample

func (s *BezierSpline) Sample(p *Polygon, t0, t1 float64, p0, p1 v2.Vec, n int)

Sample generates polygon samples for a bezier spline.

type BezierVertex

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

BezierVertex specifies the vertex for a bezier curve.

func (*BezierVertex) Handle

func (v *BezierVertex) Handle(theta, fwd, rev float64) *BezierVertex

Handle marks the vertex with a slope control handle.

func (*BezierVertex) HandleFwd

func (v *BezierVertex) HandleFwd(theta, r float64) *BezierVertex

HandleFwd sets the slope handle in the forward direction.

func (*BezierVertex) HandleRev

func (v *BezierVertex) HandleRev(theta, r float64) *BezierVertex

HandleRev sets the slope handle in the reverse direction.

func (*BezierVertex) Mid

func (v *BezierVertex) Mid() *BezierVertex

Mid marks the vertex as a mid-curve control point.

type Box2

type Box2 struct {
	Min, Max v2.Vec
}

Box2 is a 2d bounding box.

func NewBox2

func NewBox2(center, size v2.Vec) Box2

NewBox2 creates a 2d box with a given center and size.

func (Box2) Center

func (a Box2) Center() v2.Vec

Center returns the center of a 2d box.

func (Box2) Contains

func (a Box2) Contains(v v2.Vec) bool

Contains checks if the 2d box contains the point.

func (Box2) Enlarge

func (a Box2) Enlarge(v v2.Vec) Box2

Enlarge returns a new 2d box enlarged by a size vector.

func (Box2) Equals

func (a Box2) Equals(b Box2, delta float64) bool

Equals test the equality of 2d boxes.

func (Box2) Extend

func (a Box2) Extend(b Box2) Box2

Extend returns a box enclosing two 2d boxes.

func (Box2) Include

func (a Box2) Include(v v2.Vec) Box2

Include enlarges a 2d box to include a point.

func (Box2) MinMaxDist2

func (a Box2) MinMaxDist2(p v2.Vec) Interval

MinMaxDist2 returns the minimum and maximum dist * dist from a point to a box. Points within the box have minimum distance = 0.

func (*Box2) Random

func (a *Box2) Random() v2.Vec

Random returns a random point within a 2d box.

func (*Box2) RandomSet

func (a *Box2) RandomSet(n int) v2.VecSet

RandomSet returns a set of random points from within a 2d box.

func (Box2) ScaleAboutCenter

func (a Box2) ScaleAboutCenter(k float64) Box2

ScaleAboutCenter returns a new 2d box scaled about the center of a box.

func (Box2) Size

func (a Box2) Size() v2.Vec

Size returns the size of a 2d box.

func (*Box2) Snap

func (a *Box2) Snap(p v2.Vec, delta float64) v2.Vec

Snap a point to the box edges

func (Box2) Square

func (a Box2) Square() Box2

Square returns a square box larger than the original box.

func (Box2) Translate

func (a Box2) Translate(v v2.Vec) Box2

Translate translates a 2d box.

func (Box2) Vertices

func (a Box2) Vertices() v2.VecSet

Vertices returns a slice of 2d box corner vertices.

type Box3

type Box3 struct {
	Min, Max v3.Vec
}

Box3 is a 3d bounding box.

func NewBox3

func NewBox3(center, size v3.Vec) Box3

NewBox3 creates a 3d box with a given center and size.

func (Box3) Center

func (a Box3) Center() v3.Vec

Center returns the center of a 3d box.

func (Box3) Contains

func (a Box3) Contains(v v3.Vec) bool

Contains checks if the 3d box contains the point.

func (Box3) Cube

func (a Box3) Cube() Box3

Cube returns a cubical box larger than the original box.

func (Box3) Enlarge

func (a Box3) Enlarge(v v3.Vec) Box3

Enlarge returns a new 3d box enlarged by a size vector.

func (Box3) Equals

func (a Box3) Equals(b Box3, delta float64) bool

Equals test the equality of 3d boxes.

func (Box3) Extend

func (a Box3) Extend(b Box3) Box3

Extend returns a box enclosing two 3d boxes.

func (Box3) Include

func (a Box3) Include(v v3.Vec) Box3

Include enlarges a 3d box to include a point.

func (Box3) MinMaxDist2

func (a Box3) MinMaxDist2(p v3.Vec) Interval

MinMaxDist2 returns the minimum and maximum dist * dist from a point to a box. Points within the box have minimum distance = 0.

func (*Box3) Random

func (a *Box3) Random() v3.Vec

Random returns a random point within 3d box.

func (*Box3) RandomSet

func (a *Box3) RandomSet(n int) v3.VecSet

RandomSet returns a set of random points from within a 3d box.

func (*Box3) RandomTriangle

func (a *Box3) RandomTriangle() Triangle3

RandomTriangle returns a random triangle that lies within the box

func (Box3) ScaleAboutCenter

func (a Box3) ScaleAboutCenter(k float64) Box3

ScaleAboutCenter returns a new 3d box scaled about the center of a box.

func (Box3) Size

func (a Box3) Size() v3.Vec

Size returns the size of a 3d box.

func (*Box3) Snap

func (a *Box3) Snap(p v3.Vec, epsilon float64) v3.Vec

Snap a point to the box edges

func (Box3) Translate

func (a Box3) Translate(v v3.Vec) Box3

Translate translates a 3d box.

func (Box3) Vertices

func (a Box3) Vertices() v3.VecSet

Vertices returns a slice of 3d box corner vertices.

type BoxSDF2

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

BoxSDF2 is the 2d signed distance object for a rectangular box.

func (*BoxSDF2) BoundingBox

func (s *BoxSDF2) BoundingBox() Box2

BoundingBox returns the bounding box for a 2d box.

func (*BoxSDF2) Evaluate

func (s *BoxSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a 2d box.

type BoxSDF3

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

BoxSDF3 is a 3d box.

func (*BoxSDF3) BoundingBox

func (s *BoxSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a 3d box.

func (*BoxSDF3) Evaluate

func (s *BoxSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a 3d box.

type CacheSDF2

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

CacheSDF2 is an SDF2 cache.

func (*CacheSDF2) BoundingBox

func (s *CacheSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a cached 2d sdf.

func (*CacheSDF2) Evaluate

func (s *CacheSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a cached 2d sdf.

func (*CacheSDF2) String

func (s *CacheSDF2) String() string

type CircleSDF2

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

CircleSDF2 is the 2d signed distance object for a circle.

func (*CircleSDF2) BoundingBox

func (s *CircleSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a 2d circle.

func (*CircleSDF2) Evaluate

func (s *CircleSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a 2d circle.

type ConeSDF3

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

ConeSDF3 is a truncated cone.

func (*ConeSDF3) BoundingBox

func (s *ConeSDF3) BoundingBox() Box3

BoundingBox return the bounding box for the trucated cone..

func (*ConeSDF3) Evaluate

func (s *ConeSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a trucated cone.

type CubicPolynomial

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

CubicPolynomial is a cubic polynomial

func (*CubicPolynomial) Set

func (p *CubicPolynomial) Set(y0, y1, D0, D1 float64)

Set cubic polynomial coefficient values.

type CubicSpline

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

CubicSpline is a 2d cubic spline.

func (*CubicSpline) BoundingBox

func (s *CubicSpline) BoundingBox() Box2

BoundingBox returns the bounding box for a cubic spline.

type CubicSplineSDF2

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

CubicSplineSDF2 is an SDF2 made from a set of cubic splines.

func (*CubicSplineSDF2) BoundingBox

func (s *CubicSplineSDF2) BoundingBox() Box2

BoundingBox returns the 2d bounding box of a cubic spline.

func (*CubicSplineSDF2) Evaluate

func (s *CubicSplineSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance from a point to the cubic spline SDF2. Note: This uses Newton-Raphson minimisation and is unstable in some circumstances. A simple (and slower) solution is to convert the cubic spline SDF2 to a polygon SDF2 and use that for rendering.

func (*CubicSplineSDF2) PolySpline2D

func (s *CubicSplineSDF2) PolySpline2D(n int) (SDF2, error)

PolySpline2D returns a polygon SDF2 approximating a cubic spline SDF2.

func (*CubicSplineSDF2) Polygonize

func (s *CubicSplineSDF2) Polygonize(n int) *Polygon

Polygonize returns a polygon approximating the cubic spline SDF2.

type CutSDF2

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

CutSDF2 is an SDF2 made by cutting across an existing SDF2.

func (*CutSDF2) BoundingBox

func (s *CutSDF2) BoundingBox() Box2

BoundingBox returns the bounding box for the cut SDF2.

func (*CutSDF2) Evaluate

func (s *CutSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to cut SDF2.

type CutSDF3

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

CutSDF3 makes a planar cut through an SDF3.

func (*CutSDF3) BoundingBox

func (s *CutSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of the cut SDF3.

func (*CutSDF3) Evaluate

func (s *CutSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to the cut SDF3.

type CylinderSDF3

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

CylinderSDF3 is a cylinder.

func (*CylinderSDF3) BoundingBox

func (s *CylinderSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a cylinder.

func (*CylinderSDF3) Evaluate

func (s *CylinderSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a cylinder.

type DifferenceSDF2

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

DifferenceSDF2 is the difference of two SDF2s.

func (*DifferenceSDF2) BoundingBox

func (s *DifferenceSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of the difference of two SDF2s.

func (*DifferenceSDF2) Evaluate

func (s *DifferenceSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the difference of two SDF2s.

func (*DifferenceSDF2) SetMax

func (s *DifferenceSDF2) SetMax(max MaxFunc)

SetMax sets the maximum function to control blending.

type DifferenceSDF3

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

DifferenceSDF3 is the difference of two SDF3s, s0 - s1.

func (*DifferenceSDF3) BoundingBox

func (s *DifferenceSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of the SDF3 difference.

func (*DifferenceSDF3) Evaluate

func (s *DifferenceSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to the SDF3 difference.

func (*DifferenceSDF3) SetMax

func (s *DifferenceSDF3) SetMax(max MaxFunc)

SetMax sets the maximum function to control blending.

type ElongateSDF2

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

ElongateSDF2 is the elongation of an SDF2.

func (*ElongateSDF2) BoundingBox

func (s *ElongateSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of an elongated SDF2.

func (*ElongateSDF2) Evaluate

func (s *ElongateSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to an elongated SDF2.

type ElongateSDF3

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

ElongateSDF3 is the elongation of an SDF3.

func (*ElongateSDF3) BoundingBox

func (s *ElongateSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of an elongated SDF3.

func (*ElongateSDF3) Evaluate

func (s *ElongateSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a elongated SDF2.

type ExtrudeFunc

type ExtrudeFunc func(p v3.Vec) v2.Vec

ExtrudeFunc maps v3.Vec to v2.Vec - the point used to evaluate the SDF2.

func ScaleExtrude

func ScaleExtrude(height float64, scale v2.Vec) ExtrudeFunc

ScaleExtrude returns an extrusion functions that scales with z.

func ScaleTwistExtrude

func ScaleTwistExtrude(height, twist float64, scale v2.Vec) ExtrudeFunc

ScaleTwistExtrude returns an extrusion function that scales and twists with z.

func TwistExtrude

func TwistExtrude(height, twist float64) ExtrudeFunc

TwistExtrude returns an extrusion function that twists with z.

type ExtrudeRoundedSDF3

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

ExtrudeRoundedSDF3 extrudes an SDF2 to an SDF3 with rounded edges.

func (*ExtrudeRoundedSDF3) BoundingBox

func (s *ExtrudeRoundedSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a rounded extrusion.

func (*ExtrudeRoundedSDF3) Evaluate

func (s *ExtrudeRoundedSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a rounded extrusion.

type ExtrudeSDF3

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

ExtrudeSDF3 extrudes an SDF2 to an SDF3.

func (*ExtrudeSDF3) BoundingBox

func (s *ExtrudeSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for an extrusion.

func (*ExtrudeSDF3) Evaluate

func (s *ExtrudeSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to an extrusion.

func (*ExtrudeSDF3) SetExtrude

func (s *ExtrudeSDF3) SetExtrude(extrude ExtrudeFunc)

SetExtrude sets the extrusion control function.

type Flange1

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

Flange1 is a flange shape made from a center circle with two side circles.

func (*Flange1) BoundingBox

func (s *Flange1) BoundingBox() Box2

BoundingBox returns the bounding box for the flange.

func (*Flange1) Evaluate

func (s *Flange1) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the flange.

type FlatFlankCamSDF2

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

FlatFlankCamSDF2 is 2d cam profile. The profile is made from a base circle, a smaller nose circle and flat, tangential flanks.

func (*FlatFlankCamSDF2) BoundingBox

func (s *FlatFlankCamSDF2) BoundingBox() Box2

BoundingBox returns the bounding box for the cam.

func (*FlatFlankCamSDF2) Evaluate

func (s *FlatFlankCamSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the cam.

type GearRackParms

type GearRackParms struct {
	NumberTeeth   int     // number of rack teeth
	Module        float64 // pitch circle diameter / number of gear teeth
	PressureAngle float64 // gear pressure angle (radians)
	Backlash      float64 // backlash expressed as units of pitch circumference
	BaseHeight    float64 // height of rack base
}

GearRackParms defines the parameters for a gear rack.

type GearRackSDF2

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

GearRackSDF2 is a 2d linear gear rack.

func (*GearRackSDF2) BoundingBox

func (s *GearRackSDF2) BoundingBox() Box2

BoundingBox returns the bounding box for the gear rack.

func (*GearRackSDF2) Evaluate

func (s *GearRackSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the gear rack.

type GyroidSDF3

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

GyroidSDF3 is a 3d gyroid.

func (*GyroidSDF3) BoundingBox

func (s *GyroidSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a 3d gyroid.

func (*GyroidSDF3) Evaluate

func (s *GyroidSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a 3d gyroid.

type IntersectionSDF2

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

IntersectionSDF2 is the intersection of two SDF2s.

func (*IntersectionSDF2) BoundingBox

func (s *IntersectionSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of an SDF2 intersection.

func (*IntersectionSDF2) Evaluate

func (s *IntersectionSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the SDF2 intersection.

func (*IntersectionSDF2) SetMax

func (s *IntersectionSDF2) SetMax(max MaxFunc)

SetMax sets the maximum function to control blending.

type IntersectionSDF3

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

IntersectionSDF3 is the intersection of two SDF3s.

func (*IntersectionSDF3) BoundingBox

func (s *IntersectionSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of an SDF3 intersection.

func (*IntersectionSDF3) Evaluate

func (s *IntersectionSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to the SDF3 intersection.

func (*IntersectionSDF3) SetMax

func (s *IntersectionSDF3) SetMax(max MaxFunc)

SetMax sets the maximum function to control blending.

type Interval

type Interval [2]float64

Interval is a closed interval on real numbers.

func (Interval) Equals

func (a Interval) Equals(b Interval, tolerance float64) bool

Equals returns true if a == b within the tolerance limit.

func (Interval) Intersect

func (a Interval) Intersect(b Interval) *Interval

Intersect returns the intersection of two intervals.

func (Interval) Overlap

func (a Interval) Overlap(b Interval) bool

Overlap returns true if two intervals overlap.

func (Interval) Sort

func (a Interval) Sort() Interval

Sort sorts the interval endpoints lowest to highest.

type Line2

type Line2 [2]v2.Vec

Line2 is a 2d line defined with end-points.

func VertexToLine

func VertexToLine(vertex []v2.Vec, closed bool) []*Line2

VertexToLine converts a set of vertices into a set of line segments.

func (*Line2) BoundingBox

func (a *Line2) BoundingBox() Box2

BoundingBox returns a bounding box for the line.

func (Line2) Degenerate

func (a Line2) Degenerate(tolerance float64) bool

Degenerate returns true if the line is degenerate.

func (*Line2) Equals

func (a *Line2) Equals(b *Line2, tolerance float64) bool

Equals returns true if the lines are the same (within tolerance).

func (*Line2) IntersectLine

func (a *Line2) IntersectLine(b *Line2) []v2.Vec

IntersectLine intersects 2 line segments. https://stackoverflow.com/questions/563198/how-do-you-detect-where-two-line-segments-intersect

func (*Line2) Reverse

func (a *Line2) Reverse() *Line2

Reverse the direction of a line segment.

type Line2Buffer

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

Line2Buffer buffers lines before writing them to a channel.

func (*Line2Buffer) Close

func (a *Line2Buffer) Close() error

Close flushes out any remaining lines in the buffer.

func (*Line2Buffer) Write

func (a *Line2Buffer) Write(in []*Line2) error

type Line2Writer

type Line2Writer interface {
	Write(in []*Line2) error
	Close() error
}

Line2Writer is the interface of a line writer/closer object.

func NewLine2Buffer

func NewLine2Buffer(out chan<- []*Line2) Line2Writer

NewLine2Buffer returns a Line2Buffer.

type LineSDF2

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

LineSDF2 is the 2d signed distance object for a line.

func (*LineSDF2) BoundingBox

func (s *LineSDF2) BoundingBox() Box2

BoundingBox returns the bounding box for a 2d line.

func (*LineSDF2) Evaluate

func (s *LineSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a 2d line.

type LoftSDF3

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

LoftSDF3 is an extrusion between two SDF2s.

func (*LoftSDF3) BoundingBox

func (s *LoftSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a loft extrusion.

func (*LoftSDF3) Evaluate

func (s *LoftSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a loft extrusion.

type M22

type M22 [4]float64

M22 is a 2x2 matrix.

func Identity

func Identity() M22

Identity returns a 2x2 identity matrix.

func NewM22

func NewM22(x [4]float64) M22

NewM22 returns a new matrix. Input is in row-major order.

func RandomM22

func RandomM22(a, b float64) M22

RandomM22 returns a 2x2 matrix with random elements.

func Rotate

func Rotate(a float64) M22

Rotate returns an orthographic 2x2 rotation matrix (right hand rule).

func (M22) Determinant

func (a M22) Determinant() float64

Determinant returns the determinant of a 2x2 matrix.

func (M22) Equals

func (a M22) Equals(b M22, tolerance float64) bool

Equals tests the equality of 2x2 matrices.

func (M22) Inverse

func (a M22) Inverse() M22

Inverse returns the inverse of a 2x2 matrix.

func (M22) Mul

func (a M22) Mul(b M22) M22

Mul multiplies 2x2 matrices.

func (M22) MulPosition

func (a M22) MulPosition(b v2.Vec) v2.Vec

MulPosition multiplies a v2.Vec position with a rotate matrix.

func (M22) Values

func (a M22) Values() [4]float64

Values returns the matrix values in row-major order.

type M33

type M33 [9]float64

M33 is a 3x3 matrix.

func Identity2d

func Identity2d() M33

Identity2d returns a 3x3 identity matrix.

func MirrorX

func MirrorX() M33

MirrorX returns a 3x3 matrix with mirroring across the X axis.

func MirrorY

func MirrorY() M33

MirrorY returns a 3x3 matrix with mirroring across the Y axis.

func NewM33

func NewM33(x [9]float64) M33

NewM33 returns a new matrix. Input is in row-major order.

func RandomM33

func RandomM33(a, b float64) M33

RandomM33 returns a 3x3 matrix with random elements.

func Rotate2d

func Rotate2d(a float64) M33

Rotate2d returns an orthographic 3x3 rotation matrix (right hand rule).

func Scale2d

func Scale2d(v v2.Vec) M33

Scale2d returns a 3x3 scaling matrix. Scaling does not preserve distance. See: ScaleUniform2D().

func Translate2d

func Translate2d(v v2.Vec) M33

Translate2d returns a 3x3 translation matrix.

func (M33) Add

func (a M33) Add(b M33) M33

Add two 3x3 matrices.

func (M33) Determinant

func (a M33) Determinant() float64

Determinant returns the determinant of a 3x3 matrix.

func (M33) Equals

func (a M33) Equals(b M33, tolerance float64) bool

Equals tests the equality of 3x3 matrices.

func (M33) Inverse

func (a M33) Inverse() M33

Inverse returns the inverse of a 3x3 matrix.

func (M33) Mul

func (a M33) Mul(b M33) M33

Mul multiplies 3x3 matrices.

func (M33) MulBox

func (a M33) MulBox(box Box2) Box2

MulBox rotates/translates a 2d bounding box and resizes for axis-alignment.

func (M33) MulPosition

func (a M33) MulPosition(b v2.Vec) v2.Vec

MulPosition multiplies a v2.Vec position with a rotate/translate matrix.

func (M33) MulScalar

func (a M33) MulScalar(k float64) M33

MulScalar multiplies each 3x3 matrix component by a scalar.

func (M33) Values

func (a M33) Values() [9]float64

Values returns the matrix values in row-major order.

type M44

type M44 [16]float64

M44 is a 4x4 matrix.

func Identity3d

func Identity3d() M44

Identity3d returns a 4x4 identity matrix.

func MirrorXY

func MirrorXY() M44

MirrorXY returns a 4x4 matrix with mirroring across the XY plane.

func MirrorXZ

func MirrorXZ() M44

MirrorXZ returns a 4x4 matrix with mirroring across the XZ plane.

func MirrorXeqY

func MirrorXeqY() M44

MirrorXeqY returns a 4x4 matrix with mirroring across the X == Y plane.

func MirrorYZ

func MirrorYZ() M44

MirrorYZ returns a 4x4 matrix with mirroring across the YZ plane.

func NewM44

func NewM44(x [16]float64) M44

NewM44 returns a new matrix. Input is in row-major order.

func RandomM44

func RandomM44(a, b float64) M44

RandomM44 returns a 4x4 matrix with random elements.

func Rotate3d

func Rotate3d(v v3.Vec, a float64) M44

Rotate3d returns an orthographic 4x4 rotation matrix (right hand rule).

func RotateToVector

func RotateToVector(a, b v3.Vec) M44

RotateToVector returns the rotation matrix that transforms a onto the same direction as b.

func RotateX

func RotateX(a float64) M44

RotateX returns a 4x4 matrix with rotation about the X axis.

func RotateY

func RotateY(a float64) M44

RotateY returns a 4x4 matrix with rotation about the Y axis.

func RotateZ

func RotateZ(a float64) M44

RotateZ returns a 4x4 matrix with rotation about the Z axis.

func Scale3d

func Scale3d(v v3.Vec) M44

Scale3d returns a 4x4 scaling matrix. Scaling does not preserve distance. See: ScaleUniform3D()

func Translate3d

func Translate3d(v v3.Vec) M44

Translate3d returns a 4x4 translation matrix.

func (M44) Determinant

func (a M44) Determinant() float64

Determinant returns the determinant of a 4x4 matrix.

func (M44) Equals

func (a M44) Equals(b M44, tolerance float64) bool

Equals tests the equality of 4x4 matrices.

func (M44) Inverse

func (a M44) Inverse() M44

Inverse returns the inverse of a 4x4 matrix.

func (M44) Mul

func (a M44) Mul(b M44) M44

Mul multiplies 4x4 matrices.

func (M44) MulBox

func (a M44) MulBox(box Box3) Box3

MulBox rotates/translates a 3d bounding box and resizes for axis-alignment.

func (M44) MulPosition

func (a M44) MulPosition(b v3.Vec) v3.Vec

MulPosition multiplies a v3.Vec position with a rotate/translate matrix.

func (M44) Values

func (a M44) Values() [16]float64

Values returns the matrix values in row-major order.

type Map2

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

Map2 maps a 2d region to integer grid coordinates.

func NewMap2

func NewMap2(bb Box2, grid v2i.Vec, flipy bool) (*Map2, error)

NewMap2 returns a 2d region to grid coordinates map.

func (*Map2) ToV2

func (m *Map2) ToV2(p v2i.Vec) v2.Vec

ToV2 converts grid integer coordinates to 2d region float coordinates.

func (*Map2) ToV2i

func (m *Map2) ToV2i(p v2.Vec) v2i.Vec

ToV2i converts 2d region float coordinates to grid integer coordinates.

type MaxFunc

type MaxFunc func(a, b float64) float64

MaxFunc is a maximum function for SDF blending.

func PolyMax

func PolyMax(k float64) MaxFunc

PolyMax returns a maximum function (Try k = 0.1, a bigger k gives a bigger fillet).

type MeshSDF2

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

MeshSDF2 is SDF2 made from a set of line segments.

func (*MeshSDF2) BoundingBox

func (s *MeshSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a 2d mesh.

func (*MeshSDF2) Boxes

func (s *MeshSDF2) Boxes() []*Box2

Boxes returns the full set of quadtree boxes.

func (*MeshSDF2) Evaluate

func (s *MeshSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance for a 2d mesh.

type MeshSDF2Slow

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

MeshSDF2Slow is SDF2 made from a set of line segments.

func (*MeshSDF2Slow) BoundingBox

func (s *MeshSDF2Slow) BoundingBox() Box2

BoundingBox returns the bounding box of a 2d mesh.

func (*MeshSDF2Slow) Evaluate

func (s *MeshSDF2Slow) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance for a 2d mesh.

type MeshSDF3

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

MeshSDF3 is an SDF3 made from a set of 3d triangles.

func (*MeshSDF3) BoundingBox

func (s *MeshSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of a 3d mesh.

func (*MeshSDF3) Evaluate

func (s *MeshSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance for a 2d mesh.

type MeshSDF3Slow

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

MeshSDF3Slow is an SDF3 made from a set of 3d triangles.

func (*MeshSDF3Slow) BoundingBox

func (s *MeshSDF3Slow) BoundingBox() Box3

BoundingBox returns the bounding box of a 3d mesh.

func (*MeshSDF3Slow) Evaluate

func (s *MeshSDF3Slow) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance for a 2d mesh.

type MinFunc

type MinFunc func(a, b float64) float64

MinFunc is a minimum functions for SDF blending.

func ChamferMin

func ChamferMin(k float64) MinFunc

ChamferMin returns a minimum function that makes a 45-degree chamfered edge (the diagonal of a square of size <r>). TODO: why the holes in the rendering?

func ExpMin

func ExpMin(k float64) MinFunc

ExpMin returns a minimum function with exponential smoothing (k = 32).

func PolyMin

func PolyMin(k float64) MinFunc

PolyMin returns a minimum function (Try k = 0.1, a bigger k gives a bigger fillet).

func PowMin

func PowMin(k float64) MinFunc

PowMin returns a minimum function (k = 8). TODO - weird results, is this correct?

func RoundMin

func RoundMin(k float64) MinFunc

RoundMin returns a minimum function that uses a quarter-circle to join the two objects smoothly.

type OffsetSDF2

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

OffsetSDF2 offsets the distance function of an existing SDF2.

func (*OffsetSDF2) BoundingBox

func (s *OffsetSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of an offset SDF2.

func (*OffsetSDF2) Evaluate

func (s *OffsetSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to an offset SDF2.

type OffsetSDF3

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

OffsetSDF3 offsets the distance function of an existing SDF3.

func (*OffsetSDF3) BoundingBox

func (s *OffsetSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of an offset SDF3.

func (*OffsetSDF3) Evaluate

func (s *OffsetSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to an offset SDF3.

type Polygon

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

Polygon stores a set of 2d polygon vertices.

func NewPolygon

func NewPolygon() *Polygon

NewPolygon returns an empty polygon.

func (*Polygon) Add

func (p *Polygon) Add(x, y float64) *PolygonVertex

Add an x,y vertex to a polygon.

func (*Polygon) AddV2

func (p *Polygon) AddV2(x v2.Vec) *PolygonVertex

AddV2 adds a V2 vertex to a polygon.

func (*Polygon) AddV2Set

func (p *Polygon) AddV2Set(x []v2.Vec)

AddV2Set adds a set of V2 vertices to a polygon.

func (*Polygon) Close

func (p *Polygon) Close()

Close closes the polygon.

func (*Polygon) Closed

func (p *Polygon) Closed() bool

Closed returns true/fale if the polygon is closed/open.

func (*Polygon) Drop

func (p *Polygon) Drop()

Drop the last vertex from the list.

func (*Polygon) Mesh2D

func (p *Polygon) Mesh2D() (SDF2, error)

Mesh2D returns the Mesh2D for the polygon.

func (*Polygon) Reverse

func (p *Polygon) Reverse()

Reverse reverses the order the vertices are returned.

func (*Polygon) Vertices

func (p *Polygon) Vertices() []v2.Vec

Vertices returns the vertices of the polygon.

type PolygonVertex

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

PolygonVertex is a polygon vertex.

func (*PolygonVertex) Arc

func (v *PolygonVertex) Arc(radius float64, facets int) *PolygonVertex

Arc replaces a line segment with a circular arc.

func (*PolygonVertex) Chamfer

func (v *PolygonVertex) Chamfer(size float64) *PolygonVertex

Chamfer marks the polygon vertex for chamfering.

func (*PolygonVertex) Polar

func (v *PolygonVertex) Polar() *PolygonVertex

Polar treats the polygon vertex values as polar coordinates (r, theta).

func (*PolygonVertex) Rel

func (v *PolygonVertex) Rel() *PolygonVertex

Rel positions the polygon vertex relative to the prior vertex.

func (*PolygonVertex) Smooth

func (v *PolygonVertex) Smooth(radius float64, facets int) *PolygonVertex

Smooth marks the polygon vertex for smoothing.

type RotateCopySDF2

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

RotateCopySDF2 copies an SDF2 n times in a full circle.

func (*RotateCopySDF2) BoundingBox

func (s *RotateCopySDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a rotate/copy SDF2.

func (*RotateCopySDF2) Evaluate

func (s *RotateCopySDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a rotate/copy SDF2.

type RotateCopySDF3

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

RotateCopySDF3 rotates and creates N copies of an SDF3 about the z-axis.

func (*RotateCopySDF3) BoundingBox

func (s *RotateCopySDF3) BoundingBox() Box3

BoundingBox returns the bounding box of a rotate/copy SDF3.

func (*RotateCopySDF3) Evaluate

func (s *RotateCopySDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a rotate/copy SDF3.

type RotateUnionSDF2

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

RotateUnionSDF2 defines a union of rotated SDF2s.

func (*RotateUnionSDF2) BoundingBox

func (s *RotateUnionSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a union of rotated SDF2s.

func (*RotateUnionSDF2) Evaluate

func (s *RotateUnionSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a union of rotated SDF2s.

func (*RotateUnionSDF2) SetMin

func (s *RotateUnionSDF2) SetMin(min MinFunc)

SetMin sets the minimum function to control blending.

type RotateUnionSDF3

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

RotateUnionSDF3 creates a union of SDF3s rotated about the z-axis.

func (*RotateUnionSDF3) BoundingBox

func (s *RotateUnionSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of a rotate/union object.

func (*RotateUnionSDF3) Evaluate

func (s *RotateUnionSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a rotate/union object.

func (*RotateUnionSDF3) SetMin

func (s *RotateUnionSDF3) SetMin(min MinFunc)

SetMin sets the minimum function to control blending.

type SDF2

type SDF2 interface {
	Evaluate(p v2.Vec) float64
	BoundingBox() Box2
}

SDF2 is the interface to a 2d signed distance function object.

func ANSIButtressThread

func ANSIButtressThread(
	radius float64,
	pitch float64,
) (SDF2, error)

ANSIButtressThread returns the 2d profile for an ANSI 45/7 buttress thread. https://en.wikipedia.org/wiki/Buttress_thread AMSE B1.9-1973

func AcmeThread

func AcmeThread(
	radius float64,
	pitch float64,
) (SDF2, error)

AcmeThread returns the 2d profile for an acme thread.

func ArcSpiral2D

func ArcSpiral2D(
	a, k float64,
	start, end float64,
	d float64,
) (SDF2, error)

ArcSpiral2D returns a 2d Archimedean spiral (r = m*theta + b).

func Array2D

func Array2D(sdf SDF2, num v2i.Vec, step v2.Vec) SDF2

Array2D returns an XY grid array of an existing SDF2.

func Box2D

func Box2D(size v2.Vec, round float64) SDF2

Box2D returns a 2d box.

func Cache2D

func Cache2D(sdf SDF2) SDF2

Cache2D wraps the passed SDF2 with an evaluation cache.

func Center2D

func Center2D(s SDF2) SDF2

Center2D centers the origin of an SDF2 on it's bounding box.

func CenterAndScale2D

func CenterAndScale2D(s SDF2, k float64) SDF2

CenterAndScale2D centers the origin of an SDF2 on it's bounding box, and then scales it. Distance is correct with scaling.

func Circle2D

func Circle2D(radius float64) (SDF2, error)

Circle2D returns the SDF2 for a 2d circle.

func CubicSpline2D

func CubicSpline2D(knot []v2.Vec) (SDF2, error)

CubicSpline2D returns an SDF2 made from a set of cubic splines.

func Cut2D

func Cut2D(sdf SDF2, a, v v2.Vec) SDF2

Cut2D cuts the SDF2 along a line from a in direction v. The SDF2 to the right of the line remains.

func Difference2D

func Difference2D(s0, s1 SDF2) SDF2

Difference2D returns the difference of two SDF2 objects, s0 - s1.

func Elongate2D

func Elongate2D(sdf SDF2, h v2.Vec) SDF2

Elongate2D returns the elongation of an SDF2.

func FlatFlankCam2D

func FlatFlankCam2D(
	distance float64,
	baseRadius float64,
	noseRadius float64,
) (SDF2, error)

FlatFlankCam2D creates a 2D cam profile. The profile is made from a base circle, a smaller nose circle and flat, tangential flanks. The base circle is centered on the origin. The nose circle is located on the positive y axis.

func GearRack2D

func GearRack2D(k *GearRackParms) (SDF2, error)

GearRack2D returns the 2D profile for a gear rack.

func ISOThread

func ISOThread(
	radius float64,
	pitch float64,
	external bool,
) (SDF2, error)

ISOThread returns the 2d profile for an ISO/UTS thread. https://en.wikipedia.org/wiki/ISO_metric_screw_thread https://en.wikipedia.org/wiki/Unified_Thread_Standard

func Intersect2D

func Intersect2D(s0, s1 SDF2) SDF2

Intersect2D returns the intersection of two SDF2s.

func Line2D

func Line2D(l, round float64) SDF2

Line2D returns a line from (-l/2,0) to (l/2,0).

func LineOf2D

func LineOf2D(s SDF2, p0, p1 v2.Vec, pattern string) SDF2

LineOf2D returns a union of 2D objects positioned along a line from p0 to p1.

func MakeFlatFlankCam

func MakeFlatFlankCam(
	lift float64,
	duration float64,
	maxDiameter float64,
) (SDF2, error)

MakeFlatFlankCam makes a flat flank cam profile from design parameters.

func MakeThreeArcCam

func MakeThreeArcCam(
	lift float64,
	duration float64,
	maxDiameter float64,
	k float64,
) (SDF2, error)

MakeThreeArcCam makes a three arc cam profile from design parameters.

func Mesh2D

func Mesh2D(mesh []*Line2) (SDF2, error)

Mesh2D returns an SDF2 made from a set of line segments.

func Mesh2DSlow

func Mesh2DSlow(mesh []*Line2) (SDF2, error)

Mesh2DSlow returns an SDF2 made from a set of line segments.

func Multi2D

func Multi2D(s SDF2, positions v2.VecSet) SDF2

Multi2D creates a union of an SDF2 at a set of 2D positions.

func NewFlange1

func NewFlange1(
	distance float64,
	centerRadius float64,
	sideRadius float64,
) SDF2

NewFlange1 returns a flange shape made from a center circle with two side circles.

func Offset2D

func Offset2D(sdf SDF2, offset float64) SDF2

Offset2D returns an SDF2 that offsets the distance function of another SDF2.

func PlasticButtressThread

func PlasticButtressThread(
	radius float64,
	pitch float64,
) (SDF2, error)

PlasticButtressThread returns the 2d profile for a screw top style plastic buttress thread. Similar to ANSI 45/7 - but with more corner rounding

func Polygon2D

func Polygon2D(vertex []v2.Vec) (SDF2, error)

Polygon2D returns a Mesh2D built with polygon vertices.

func RotateCopy2D

func RotateCopy2D(sdf SDF2, n int) SDF2

RotateCopy2D rotates and copies an SDF2 n times in a full circle.

func RotateUnion2D

func RotateUnion2D(sdf SDF2, num int, step M33) SDF2

RotateUnion2D returns a union of rotated SDF2s.

func ScaleUniform2D

func ScaleUniform2D(sdf SDF2, k float64) SDF2

ScaleUniform2D scales an SDF2 by k on each axis. Distance is correct with scaling.

func Slice2D

func Slice2D(
	sdf SDF3,
	a v3.Vec,
	n v3.Vec,
) SDF2

Slice2D returns an SDF2 created from a planar slice through an SDF3.

func Text2D

func Text2D(f *truetype.Font, t *Text, h float64) (SDF2, error)

Text2D returns a sized SDF2 for a text object.

func ThreeArcCam2D

func ThreeArcCam2D(
	distance float64,
	baseRadius float64,
	noseRadius float64,
	flankRadius float64,
) (SDF2, error)

ThreeArcCam2D creates a 2D cam profile. The profile is made from a base circle, a smaller nose circle and circular flank arcs. The base circle is centered on the origin. The nose circle is located on the positive y axis. The flank arcs are tangential to the base and nose circles.

func Transform2D

func Transform2D(sdf SDF2, m M33) SDF2

Transform2D applies a transformation matrix to an SDF2. Distance is *not* preserved with scaling.

func Union2D

func Union2D(sdf ...SDF2) SDF2

Union2D returns the union of multiple SDF2 objects.

type SDF3

type SDF3 interface {
	Evaluate(p v3.Vec) float64
	BoundingBox() Box3
}

SDF3 is the interface to a 3d signed distance function object.

func Array3D

func Array3D(sdf SDF3, num v3i.Vec, step v3.Vec) SDF3

Array3D returns an XYZ array of a given SDF3

func Box3D

func Box3D(size v3.Vec, round float64) (SDF3, error)

Box3D return an SDF3 for a 3d box (rounded corners with round > 0).

func Capsule3D

func Capsule3D(height, radius float64) (SDF3, error)

Capsule3D return an SDF3 for a capsule.

func Cone3D

func Cone3D(height, r0, r1, round float64) (SDF3, error)

Cone3D returns the SDF3 for a trucated cone (round > 0 gives rounded edges).

func Cut3D

func Cut3D(sdf SDF3, a, n v3.Vec) SDF3

Cut3D cuts an SDF3 along a plane passing through a with normal n. The SDF3 on the same side as the normal remains.

func Cylinder3D

func Cylinder3D(height, radius, round float64) (SDF3, error)

Cylinder3D return an SDF3 for a cylinder (rounded edges with round > 0).

func Difference3D

func Difference3D(s0, s1 SDF3) SDF3

Difference3D returns the difference of two SDF3s, s0 - s1.

func Elongate3D

func Elongate3D(sdf SDF3, h v3.Vec) SDF3

Elongate3D returns the elongation of an SDF3.

func Extrude3D

func Extrude3D(sdf SDF2, height float64) SDF3

Extrude3D does a linear extrude on an SDF3.

func ExtrudeRounded3D

func ExtrudeRounded3D(sdf SDF2, height, round float64) (SDF3, error)

ExtrudeRounded3D extrudes an SDF2 to an SDF3 with rounded edges.

func Gyroid3D

func Gyroid3D(scale v3.Vec) (SDF3, error)

Gyroid3D returns a 3d gyroid.

func Intersect3D

func Intersect3D(s0, s1 SDF3) SDF3

Intersect3D returns the intersection of two SDF3s.

func LineOf3D

func LineOf3D(s SDF3, p0, p1 v3.Vec, pattern string) SDF3

LineOf3D returns a union of 3D objects positioned along a line from p0 to p1.

func Loft3D

func Loft3D(sdf0, sdf1 SDF2, height, round float64) (SDF3, error)

Loft3D extrudes an SDF3 that transitions between two SDF2 shapes.

func Mesh3D

func Mesh3D(mesh []*Triangle3) (SDF3, error)

Mesh3D returns an SDF3 made from a set of triangles.

func Mesh3DSlow

func Mesh3DSlow(mesh []*Triangle3) (SDF3, error)

Mesh3DSlow returns an SDF3 made from a set of triangles.

func Multi3D

func Multi3D(s SDF3, positions v3.VecSet) SDF3

Multi3D creates a union of an SDF3 at translated positions.

func NewVoxelSDF3

func NewVoxelSDF3(s SDF3, meshCells int, progress chan float64) SDF3

NewVoxelSDF3 returns a VoxelSDF3. This populates the whole cache from the given SDF. The progress listener may be nil.

func Offset3D

func Offset3D(sdf SDF3, offset float64) SDF3

Offset3D returns an SDF3 that offsets the distance function of another SDF3.

func Orient3D

func Orient3D(s SDF3, base v3.Vec, directions v3.VecSet) SDF3

Orient3D creates a union of an SDF3 at oriented directions.

func Revolve3D

func Revolve3D(sdf SDF2) (SDF3, error)

Revolve3D returns an SDF3 for a solid of revolution.

func RevolveTheta3D

func RevolveTheta3D(sdf SDF2, theta float64) (SDF3, error)

RevolveTheta3D returns an SDF3 for a solid of revolution.

func RotateCopy3D

func RotateCopy3D(
	sdf SDF3,
	num int,
) SDF3

RotateCopy3D rotates and creates N copies of an SDF3 about the z-axis.

func RotateUnion3D

func RotateUnion3D(sdf SDF3, num int, step M44) SDF3

RotateUnion3D creates a union of SDF3s rotated about the z-axis.

func ScaleExtrude3D

func ScaleExtrude3D(sdf SDF2, height float64, scale v2.Vec) SDF3

ScaleExtrude3D extrudes an SDF2 and scales it over the height of the extrusion.

func ScaleTwistExtrude3D

func ScaleTwistExtrude3D(sdf SDF2, height, twist float64, scale v2.Vec) SDF3

ScaleTwistExtrude3D extrudes an SDF2 and scales and twists it over the height of the extrusion.

func ScaleUniform3D

func ScaleUniform3D(sdf SDF3, k float64) SDF3

ScaleUniform3D uniformly scales an SDF3 on all axes.

func Screw3D

func Screw3D(
	thread SDF2,
	length float64,
	taper float64,
	pitch float64,
	starts int,
) (SDF3, error)

Screw3D returns a screw SDF3.

func Shell3D

func Shell3D(sdf SDF3, thickness float64) (SDF3, error)

Shell3D returns an SDF3 that shells the surface of an existing SDF3.

func Sphere3D

func Sphere3D(radius float64) (SDF3, error)

Sphere3D return an SDF3 for a sphere.

func Transform3D

func Transform3D(sdf SDF3, matrix M44) SDF3

Transform3D applies a transformation matrix to an SDF3.

func TwistExtrude3D

func TwistExtrude3D(sdf SDF2, height, twist float64) SDF3

TwistExtrude3D extrudes an SDF2 while rotating by twist radians over the height of the extrusion.

func Union3D

func Union3D(sdf ...SDF3) SDF3

Union3D returns the union of multiple SDF3 objects.

type ScaleUniformSDF2

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

ScaleUniformSDF2 scales another SDF2 on each axis.

func (*ScaleUniformSDF2) BoundingBox

func (s *ScaleUniformSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of an SDF2 with uniform scaling.

func (*ScaleUniformSDF2) Evaluate

func (s *ScaleUniformSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to an SDF2 with uniform scaling.

type ScaleUniformSDF3

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

ScaleUniformSDF3 is an SDF3 scaled uniformly in XYZ directions.

func (*ScaleUniformSDF3) BoundingBox

func (s *ScaleUniformSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of a uniformly scaled SDF3.

func (*ScaleUniformSDF3) Evaluate

func (s *ScaleUniformSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a uniformly scaled SDF3. The distance is correct with scaling.

type ScrewSDF3

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

ScrewSDF3 is a 3d screw form.

func (*ScrewSDF3) BoundingBox

func (s *ScrewSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a 3d screw form.

func (*ScrewSDF3) Evaluate

func (s *ScrewSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a 3d screw form.

type ShellSDF3

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

ShellSDF3 shells the surface of an existing SDF3.

func (*ShellSDF3) BoundingBox

func (s *ShellSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of a shelled SDF3.

func (*ShellSDF3) Evaluate

func (s *ShellSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a shelled SDF3.

type SliceSDF2

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

SliceSDF2 creates an SDF2 from a planar slice through an SDF3.

func (*SliceSDF2) BoundingBox

func (s *SliceSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of the sliced SDF2.

func (*SliceSDF2) Evaluate

func (s *SliceSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the sliced SDF2.

type SorSDF3

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

SorSDF3 solid of revolution, SDF2 to SDF3.

func (*SorSDF3) BoundingBox

func (s *SorSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a solid of revolution.

func (*SorSDF3) Evaluate

func (s *SorSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a solid of revolution.

type SphereSDF3

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

SphereSDF3 is a sphere.

func (*SphereSDF3) BoundingBox

func (s *SphereSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a sphere.

func (*SphereSDF3) Evaluate

func (s *SphereSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a sphere.

type Text

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

Text stores a UTF8 string and it's rendering parameters.

func NewText

func NewText(s string) *Text

NewText returns a text object (text and alignment).

type ThreadParameters

type ThreadParameters struct {
	Name         string  // name of screw thread
	Radius       float64 // nominal major radius of screw
	Pitch        float64 // thread to thread distance of screw
	Taper        float64 // thread taper (radians)
	HexFlat2Flat float64 // hex head flat to flat distance
	Units        string  // "inch" or "mm"
}

ThreadParameters stores the values that define a thread.

func ThreadLookup

func ThreadLookup(name string) (*ThreadParameters, error)

ThreadLookup lookups the parameters for a thread by name.

func (*ThreadParameters) HexHeight

func (t *ThreadParameters) HexHeight() float64

HexHeight returns the hex head height (empirical).

func (*ThreadParameters) HexRadius

func (t *ThreadParameters) HexRadius() float64

HexRadius returns the hex head radius.

type ThreeArcCamSDF2

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

ThreeArcCamSDF2 is 2d cam profile. The profile is made from a base circle, a smaller nose circle and circular flank arcs.

func (*ThreeArcCamSDF2) BoundingBox

func (s *ThreeArcCamSDF2) BoundingBox() Box2

BoundingBox returns the bounding box for the cam.

func (*ThreeArcCamSDF2) Evaluate

func (s *ThreeArcCamSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the cam.

type TransformSDF2

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

TransformSDF2 transorms an SDF2 with rotation, translation and scaling.

func (*TransformSDF2) BoundingBox

func (s *TransformSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of a transformed SDF2.

func (*TransformSDF2) Evaluate

func (s *TransformSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to a transformed SDF2. Distance is *not* preserved with scaling.

type TransformSDF3

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

TransformSDF3 is an SDF3 transformed with a 4x4 transformation matrix.

func (*TransformSDF3) BoundingBox

func (s *TransformSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of a transformed SDF3.

func (*TransformSDF3) Evaluate

func (s *TransformSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a transformed SDF3. Distance is *not* preserved with scaling.

type Triangle2

type Triangle2 [3]v2.Vec

Triangle2 is a 2D triangle

func (Triangle2) Circumcenter

func (t Triangle2) Circumcenter() (v2.Vec, error)

Circumcenter returns the circumcenter of a triangle.

func (Triangle2) InCircumcircle

func (t Triangle2) InCircumcircle(p v2.Vec) (inside, done bool)

InCircumcircle return inside == true if the point is inside the circumcircle of the triangle. Returns done == true if the vertex and the subsequent x-ordered vertices are outside the circumcircle.

type Triangle3

type Triangle3 [3]v3.Vec

Triangle3 is a 3D triangle

func (*Triangle3) BoundingBox

func (t *Triangle3) BoundingBox() Box3

BoundingBox returns a bounding box for the triangle.

func (*Triangle3) Bounds

func (t *Triangle3) Bounds() rtreego.Rect

Bounds returns a r-tree bounding rectangle for the triangle.

func (*Triangle3) Degenerate

func (t *Triangle3) Degenerate(tolerance float64) bool

Degenerate returns true if the triangle is degenerate.

func (*Triangle3) Equals

func (t *Triangle3) Equals(a *Triangle3, tolerance float64) bool

Equals tests if two triangles are equal within tolerance.

func (*Triangle3) Normal

func (t *Triangle3) Normal() v3.Vec

Normal returns the normal vector to the plane defined by the 3D triangle.

type Triangle3Buffer

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

Triangle3Buffer buffers triangles before writing them to a channel.

func (*Triangle3Buffer) Close

func (a *Triangle3Buffer) Close() error

Close flushes out any remaining triangles in the buffer.

func (*Triangle3Buffer) Write

func (a *Triangle3Buffer) Write(in []*Triangle3) error

type Triangle3Writer

type Triangle3Writer interface {
	Write(in []*Triangle3) error
	Close() error
}

Triangle3Writer is the interface of a triangle writer/closer object.

func NewTriangle3Buffer

func NewTriangle3Buffer(out chan<- []*Triangle3) Triangle3Writer

NewTriangle3Buffer returns a Triangle3Buffer.

type UnionSDF2

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

UnionSDF2 is a union of multiple SDF2 objects.

func (*UnionSDF2) BoundingBox

func (s *UnionSDF2) BoundingBox() Box2

BoundingBox returns the bounding box of an SDF2 union.

func (*UnionSDF2) Evaluate

func (s *UnionSDF2) Evaluate(p v2.Vec) float64

Evaluate returns the minimum distance to the SDF2 union.

func (*UnionSDF2) EvaluateSlow

func (s *UnionSDF2) EvaluateSlow(p v2.Vec) float64

EvaluateSlow returns the minimum distance to the SDF2 union.

func (*UnionSDF2) SetMin

func (s *UnionSDF2) SetMin(min MinFunc)

SetMin sets the minimum function to control SDF2 blending.

type UnionSDF3

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

UnionSDF3 is a union of SDF3s.

func (*UnionSDF3) BoundingBox

func (s *UnionSDF3) BoundingBox() Box3

BoundingBox returns the bounding box of an SDF3 union.

func (*UnionSDF3) Evaluate

func (s *UnionSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to an SDF3 union.

func (*UnionSDF3) SetMin

func (s *UnionSDF3) SetMin(min MinFunc)

SetMin sets the minimum function to control blending.

type VoxelSDF3

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

VoxelSDF3 is the SDF that represents a pre-computed voxel-based SDF3. It can be used as a cache, or for smoothing.

CACHE: It can be used to speed up all evaluations required by the surface mesher at the cost of scene setup time and accuracy.

SMOOTHING (meshCells <<< renderer's meshCells): It performs trilinear mapping for inner values and may be used as a cache for any other SDF, losing some accuracy.

WARNING: It may lose sharp features, even if meshCells is high.

func (*VoxelSDF3) BoundingBox

func (m *VoxelSDF3) BoundingBox() Box3

BoundingBox returns the bounding box for a VoxelSDF3.

func (*VoxelSDF3) Evaluate

func (m *VoxelSDF3) Evaluate(p v3.Vec) float64

Evaluate returns the minimum distance to a VoxelSDF3.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL