mat32

package module
v1.0.18 Latest Latest
Warning

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

 Go to latest Published: Aug 17, 2023 License: BSD-3-Clause Imports: 11 Imported by: 284

README

mat32

mat32 is a float32 based vector and matrix package for 2D & 3D graphics, based on the G3N math32 package, but using a value-based design instead of pointer-based, which simplifies chained expressions of multiple operators.

The go-gl/mathgl package is also comparable, which in turn is based on image/math/f32 types, which use arrays instead of structs with named X, Y, Z components. The named components make things easier to read overall. The G3N and this package support a much more complete set of vector and matrix math, covering almost everything you might need, including aggregate types such as triangles, planes, etc.

This package also includes the Matrix class from fogleman/gg (as Mat2) for 2D graphics -- this also includes additional support for SVG-style configuring of a matrix, in the SetString method.

Value-based Vectors

The use of value-based methods means that vectors are passed and returned as values instead of pointers:

So, in this mat32 package, Add looks like this:

// Add adds other vector to this one and returns result in a new vector.
func (v Vec3) Add(other Vec3) Vec3 {
	return Vec3{v.X + other.X, v.Y + other.Y, v.Z + other.Z}
}

versus G3N:

// Add adds other vector to this one.
// Returns the pointer to this updated vector.
func (v *Vector3) Add(other *Vector3) *Vector3 {
	v.X += other.X
	v.Y += other.Y
	v.Z += other.Z
	return v
}

The value-based design allows you to just string together sequences of expressions naturally, without worrying about allocating intermediate variables:

// Normal returns the triangle's normal.
func Normal(a, b, c Vec3) Vec3 {
	nv := c.Sub(b).Cross(a.Sub(b))
   ...

There may be a small performance cost for the value-based approach (comparative benchmarks have not yet been run), but the overall simplicity advantages are significant.

The matrix types still do use pointer-based logic because they are significantly larger and thus the performance issues are likely to be more important.

Struct vs. Array Performance: Struct is much faster

This is a benchmark from Egon Elbre, showing that small arrays can be significantly slower than a struct: https://github.com/egonelbre/exp/blob/master/bench/vector_fusing/vector_test.go

# array
BenchmarkAddMul-32                      70589480                17.3 ns/op
# struct
BenchmarkStructAddMul-32                1000000000               0.740 ns/op

Discussion: https://github.com/golang/go/issues/15925

Documentation

Overview

mat32 is our version of the G3N math32 32-bit, 3D rendering-based math library.

Initially copied from G3N: github.com/g3n/engine/math32 Copyright 2016 The G3N Authors. All rights reserved. Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.

A major modification from the G3N version is to use value-based logic instead of pointer-based self-modification in the Vector classes, As used in e.g., go-gl/mathgl (which uses slice-based vectors instead of the more intuitive and likely more efficient struct-based ones here).

The pointer-based approach was retained for the Matrix classes, which are larger and that is likely more performant.

Many names were shortened, consistent with more idiomatic Go naming. and again with the go-gl/mathgl library

Index

Constants

View Source 
const (
	E   = math.E
	Pi  = math.Pi
	Phi = math.Phi

	Sqrt2   = math.Sqrt2
	SqrtE   = math.SqrtE
	SqrtPi  = math.SqrtPi
	SqrtPhi = math.SqrtPhi

	Ln2    = math.Ln2
	Log2E  = math.Log2E
	Ln10   = math.Ln10
	Log10E = math.Log10E
)
View Source 
const (
	MaxFloat32             = math.MaxFloat32
	SmallestNonzeroFloat32 = math.SmallestNonzeroFloat32
)
View Source 
const (
	DegToRadFactor = Pi / 180
	RadToDegFactor = 180 / Pi
)
View Source 
const (
	Version     = "v1.0.18"
	GitCommit   = "ddc575d"          // the commit JUST BEFORE the release
	VersionDate = "2023-08-17 23:30" // UTC
)

Variables

View Source 
var (
	Vec2Zero = Vec2{0, 0}
	Vec2X    = Vec2{1, 0}
	Vec2Y    = Vec2{0, 1}
)
View Source 
var (
	Vec3Zero = Vec3{0, 0, 0}
	Vec3X    = Vec3{1, 0, 0}
	Vec3Y    = Vec3{0, 1, 0}
	Vec3Z    = Vec3{0, 0, 1}
)
View Source 
var (
	Vec4Zero = Vec4{0, 0, 0, 0}
	Vec4X    = Vec4{1, 0, 0, 0}
	Vec4Y    = Vec4{0, 1, 0, 0}
	Vec4Z    = Vec4{0, 0, 1, 0}
	Vec4W    = Vec4{0, 0, 0, 1}
)
View Source 
var Infinity = float32(math.Inf(1))

Functions

func Abs 

func Abs(x float32) float32

func Acos 

func Acos(x float32) float32

func Acosh added in v1.0.9 

func Acosh(x float32) float32

func Asin 

func Asin(x float32) float32

func Asinh added in v1.0.9 

func Asinh(x float32) float32

func Atan 

func Atan(x float32) float32

func Atan2 

func Atan2(y, x float32) float32

func Atanh added in v1.0.9 

func Atanh(x float32) float32

func Cbrt added in v1.0.9 

func Cbrt(x float32) float32

func Ceil 

func Ceil(x float32) float32

func Clamp 

func Clamp(x, a, b float32) float32

Clamp clamps x to the provided closed interval [a, b]

func ClampInt 

func ClampInt(x, a, b int) int

ClampInt clamps x to the provided closed interval [a, b]

func ContainsPoint 

func ContainsPoint(point, a, b, c Vec3) bool

ContainsPoint returns whether a triangle contains a point.

func CopyFloat32s 

func CopyFloat32s(trg *[]float32, src []float32)

CopyFloat32s copies a []float32 slice from src into target

func CopyFloat64s 

func CopyFloat64s(trg *[]float64, src []float64)

CopyFloat64s copies a []float64 slice from src into target

func Copysign added in v1.0.9 

func Copysign(x, y float32) float32

func Cos 

func Cos(x float32) float32

func Cosh added in v1.0.9 

func Cosh(x float32) float32

func DegToRad 

func DegToRad(degrees float32) float32

DegToRad converts a number from degrees to radians

func Dim added in v1.0.9 

func Dim(x, y float32) float32

func Erf added in v1.0.9 

func Erf(x float32) float32

func Erfc added in v1.0.9 

func Erfc(x float32) float32

func Erfcinv added in v1.0.9 

func Erfcinv(x float32) float32

func Erfinv added in v1.0.9 

func Erfinv(x float32) float32

func Exp added in v1.0.9 

func Exp(x float32) float32

func Exp2 added in v1.0.9 

func Exp2(x float32) float32

func Expm1 added in v1.0.9 

func Expm1(x float32) float32

func FMA added in v1.0.9 

func FMA(x, y, z float32) float32

func FastExp added in v1.0.8 

func FastExp(x float32) float32

FastExp is a quartic spline approximation to the Exp function, by N.N. Schraudolph It does not have any of the sanity checking of a standard method -- returns nonsense when arg is out of range. Runs in 2.23ns vs. 6.3ns for 64bit which is faster than math32.Exp actually.

func Floor 

func Floor(x float32) float32

func Frexp added in v1.0.9 

func Frexp(f float32) (frac float32, exp int)

func FromFixed 

func FromFixed(x fixed.Int26_6) float32

FromFixed converts a fixed.Int26_6 to a float32

func Gamma added in v1.0.9 

func Gamma(x float32) float32

func Hypot added in v1.0.9 

func Hypot(p, q float32) float32

func Ilogb added in v1.0.9 

func Ilogb(x float32) float32

func Inf 

func Inf(sign int) float32

func IntMultiple 

func IntMultiple(val, mod float32) float32

IntMultiple returns the interger multiple of mod closest to given value: int(Round(val / mod)) * mod

func IntMultiple64 

func IntMultiple64(val, mod float64) float64

IntMultiple64 returns the interger multiple of mod closest to given value: int(Round(val / mod)) * mod

func IntMultipleGE added in v1.0.14 

func IntMultipleGE(val, mod float32) float32

IntMultipleGE returns the interger multiple of mod >= given value: int(Ceil(val / mod)) * mod

func IsInf added in v1.0.9 

func IsInf(x float32, sign int) bool

func IsNaN 

func IsNaN(x float32) bool

func J0 added in v1.0.9 

func J0(x float32) float32

func J1 added in v1.0.9 

func J1(x float32) float32

func Jn added in v1.0.9 

func Jn(n int, x float32) float32

func Ldexp added in v1.0.9 

func Ldexp(frac float32, exp int) float32

func Lerp added in v1.0.18 

func Lerp(start, stop, amount float32) float32

Lerp is linear interpolation between start and stop in proportion to amount

func Lgamma added in v1.0.9 

func Lgamma(x float32) (lgamma float32, sign int)

func Log added in v1.0.9 

func Log(x float32) float32

func Log10 added in v1.0.9 

func Log10(x float32) float32

func Log1p added in v1.0.9 

func Log1p(x float32) float32

func Log2 added in v1.0.9 

func Log2(x float32) float32

func Logb added in v1.0.9 

func Logb(x float32) float32

func Max 

func Max(x, y float32) float32

func Max32i 

func Max32i(a, b int32) int32

Max32i returns the max of the two int32 numbers.

func Min 

func Min(x, y float32) float32

func Min32i 

func Min32i(a, b int32) int32

Min32i returns the min of the two int32 numbers.

func MinPos 

func MinPos(a, b float32) float32

MinPos returns the minimum of the two values, excluding any that are <= 0

func Mod 

func Mod(x, y float32) float32

func Modf added in v1.0.9 

func Modf(f float32) (it float32, frac float32)

func NaN 

func NaN() float32

func Nextafter added in v1.0.9 

func Nextafter(x, y float32) float32

func ParseAngle32 

func ParseAngle32(pstr string) (float32, error)

ParseAngle32 returns radians angle from string that can specify units (deg, grad, rad) -- deg is assumed if not specified

func ParseFloat32 

func ParseFloat32(pstr string) (float32, error)

ParseFloat32 logs any strconv.ParseFloat errors

func PointsCheckN 

func PointsCheckN(pts []float32, n int, errmsg string) error

PointsCheckN checks the number of points read and emits an error if not equal to n

func Pow 

func Pow(x, y float32) float32

func Pow10 added in v1.0.9 

func Pow10(n int) float32

func RadToDeg 

func RadToDeg(radians float32) float32

RadToDeg converts a number from radians to degrees

func ReadPoints 

func ReadPoints(pstr string) []float32

ReadPoints reads a set of floating point values from a SVG format number string -- returns a slice or nil if there was an error

func RectFromPosSizeMax 

func RectFromPosSizeMax(pos, sz Vec2) image.Rectangle

RectFromPosSizeMax returns an image.Rectangle from max dims of pos, size (floor on pos, ceil on size)

func RectFromPosSizeMin 

func RectFromPosSizeMin(pos, sz Vec2) image.Rectangle

RectFromPosSizeMin returns an image.Rectangle from min dims of pos, size (ceil on pos, floor on size)

func RectInNotEmpty added in v1.0.7 

func RectInNotEmpty(r, b image.Rectangle) bool

RectInNotEmpty returns true if rect r is contained within b box and r is not empty. The existing image.Rectangle.In method returns true if r is empty, but we typically expect that case to be false (out of range box)

func Remainder added in v1.0.9 

func Remainder(x, y float32) float32

func Round 

func Round(x float32) float32

func RoundToEven added in v1.0.9 

func RoundToEven(x float32) float32

func SRGBFromLinear added in v1.0.12 

func SRGBFromLinear(lin float32) float32

SRGBFromLinear converts a color with linear gamma correction to SRGB standard 2.4 gamma with offsets.

func SRGBToLinear added in v1.0.12 

func SRGBToLinear(sr float32) float32

SRGBToLinear converts a color with SRGB gamma correction to SRGB standard 2.4 gamma with offsets

func SetMax 

func SetMax(a *float32, b float32)

SetMax sets a to Max(a,b)

func SetMin 

func SetMin(a *float32, b float32)

SetMin sets a to Min(a,b)

func Sign 

func Sign(x float32) float32

func Signbit added in v1.0.9 

func Signbit(x float32) bool

func Sin 

func Sin(x float32) float32

func Sincos added in v1.0.9 

func Sincos(x float32) (sin, cos float32)

func Sinh added in v1.0.9 

func Sinh(x float32) float32

func Sqrt 

func Sqrt(x float32) float32

func Tan 

func Tan(x float32) float32

func Tanh added in v1.0.9 

func Tanh(x float32) float32

func ToFixed 

func ToFixed(x float32) fixed.Int26_6

ToFixed converts a float32 value to a fixed.Int26_6

func ToFixedPoint 

func ToFixedPoint(x, y float32) fixed.Point26_6

ToFixedPoint converts float32 x,y values to a fixed.Point26_6

func Trunc added in v1.0.9 

func Trunc(x float32) float32

func Truncate 

func Truncate(val float32, prec int) float32

Truncate truncates a floating point number to given level of precision -- slow.. uses string conversion

func Truncate64 

func Truncate64(val float64, prec int) float64

Truncate64 truncates a floating point number to given level of precision -- slow.. uses string conversion

func Y0 added in v1.0.9 

func Y0(x float32) float32

func Y1 added in v1.0.9 

func Y1(x float32) float32

func Yn added in v1.0.9 

func Yn(n int, x float32) float32

Types

type ArrayF32 

type ArrayF32 []float32

ArrayF32 is a slice of float32 with additional convenience methods

func NewArrayF32 

func NewArrayF32(size, capacity int) ArrayF32

NewArrayF32 creates a returns a new array of floats with the specified initial size and capacity

func (*ArrayF32) Append 

func (a *ArrayF32) Append(v ...float32)

Append appends any number of values to the array

func (*ArrayF32) AppendVec2 

func (a *ArrayF32) AppendVec2(v ...Vec2)

AppendVec2 appends any number of Vec2 to the array

func (*ArrayF32) AppendVec3 

func (a *ArrayF32) AppendVec3(v ...Vec3)

AppendVec3 appends any number of Vec3 to the array

func (*ArrayF32) AppendVec4 

func (a *ArrayF32) AppendVec4(v ...Vec4)

AppendVec4 appends any number of Vec4 to the array

func (*ArrayF32) Bytes 

func (a *ArrayF32) Bytes() int

Bytes returns the size of the array in bytes

func (*ArrayF32) CopyFrom 

func (a *ArrayF32) CopyFrom(src ArrayF32)

func (*ArrayF32) Extend 

func (a *ArrayF32) Extend(addLen int)

Extend appends given number of new float elements to end of existing array

func (ArrayF32) GetMat4 

func (a ArrayF32) GetMat4(pos int, m *Mat4)

GetMat4 stores in the specified Mat4 the values from the array starting at the specified pos.

func (ArrayF32) GetVec2 

func (a ArrayF32) GetVec2(pos int, v *Vec2)

GetVec2 stores in the specified Vec2 the values from the array starting at the specified pos.

func (ArrayF32) GetVec3 

func (a ArrayF32) GetVec3(pos int, v *Vec3)

GetVec3 stores in the specified Vec3 the values from the array starting at the specified pos.

func (ArrayF32) GetVec4 

func (a ArrayF32) GetVec4(pos int, v *Vec4)

GetVec4 stores in the specified Vec4 the values from the array starting at the specified pos.

func (*ArrayF32) Len 

func (a *ArrayF32) Len() int

Len returns the number of float32 elements in the array It is equivalent to Size()

func (ArrayF32) Set 

func (a ArrayF32) Set(pos int, v ...float32)

Set sets the values of the array starting at the specified pos from the specified values

func (ArrayF32) SetVec2 

func (a ArrayF32) SetVec2(pos int, v Vec2)

SetVec2 sets the values of the array at the specified pos from the XY values of the specified Vec2

func (ArrayF32) SetVec3 

func (a ArrayF32) SetVec3(pos int, v Vec3)

SetVec3 sets the values of the array at the specified pos from the XYZ values of the specified Vec3

func (ArrayF32) SetVec4 

func (a ArrayF32) SetVec4(pos int, v Vec4)

SetVec4 sets the values of the array at the specified pos from the XYZ values of the specified Vec4

func (*ArrayF32) Size 

func (a *ArrayF32) Size() int

Size returns the number of float32 elements in the array

type ArrayU32 

type ArrayU32 []uint32

ArrayU32 is a slice of uint32 with additional convenience methods

func NewArrayU32 

func NewArrayU32(size, capacity int) ArrayU32

NewArrayU32 creates a returns a new array of uint32 with the specified initial size and capacity

func (*ArrayU32) Append 

func (a *ArrayU32) Append(v ...uint32)

Append appends n elements to the array updating the slice if necessary

func (*ArrayU32) Bytes 

func (a *ArrayU32) Bytes() int

Bytes returns the size of the array in bytes

func (*ArrayU32) Extend 

func (a *ArrayU32) Extend(addLen int)

Extend appends given number of new elements to end of existing array

func (*ArrayU32) Len 

func (a *ArrayU32) Len() int

Len returns the number of float32 elements in the array

func (ArrayU32) Set 

func (a ArrayU32) Set(pos int, v ...uint32)

Set sets the values of the array starting at the specified pos from the specified values

func (*ArrayU32) Size 

func (a *ArrayU32) Size() int

Size returns the number of float32 elements in the array

type Box2 

type Box2 struct {
	Min Vec2
	Max Vec2
}

Box2 represents a 2D bounding box defined by two points: the point with minimum coordinates and the point with maximum coordinates.

func NewBox2 

func NewBox2(min, max Vec2) Box2

NewBox2 creates and returns a new Box2 defined by its minimum and maximum coordinates.

func NewEmptyBox2 

func NewEmptyBox2() Box2

NewEmptyBox2 creates and returns a new Box2 with empty min / max

func (Box2) Canon added in v1.0.6 

func (b Box2) Canon() Box2

Canon returns the canonical version of the box. The returned rectangle has minimum and maximum coordinates swapped if necessary so that it is well-formed.

func (Box2) Center 

func (b Box2) Center() Vec2

Center calculates the center point of this bounding box.

func (Box2) ClampPoint 

func (b Box2) ClampPoint(point Vec2) Vec2

ClampPoint calculates a new point which is the specified point clamped inside this box.

func (Box2) ContainsBox 

func (b Box2) ContainsBox(box Box2) bool

ContainsBox returns if this bounding box contains other box.

func (Box2) ContainsPoint 

func (b Box2) ContainsPoint(point Vec2) bool

ContainsPoint returns if this bounding box contains the specified point.

func (Box2) DistToPoint 

func (b Box2) DistToPoint(point Vec2) float32

DistToPoint returns the distance from this box to the specified point.

func (*Box2) ExpandByBox added in v1.0.1 

func (b *Box2) ExpandByBox(box Box2)

ExpandByBox may expand this bounding box to include the specified box

func (*Box2) ExpandByPoint 

func (b *Box2) ExpandByPoint(point Vec2)

ExpandByPoint may expand this bounding box to include the specified point.

func (*Box2) ExpandByScalar 

func (b *Box2) ExpandByScalar(scalar float32)

ExpandByScalar expands this bounding box by the specified scalar.

func (*Box2) ExpandByVector 

func (b *Box2) ExpandByVector(vector Vec2)

ExpandByVector expands this bounding box by the specified vector.

func (Box2) Intersect 

func (b Box2) Intersect(other Box2) Box2

Intersect returns the intersection with other box.

func (Box2) IntersectsBox added in v1.0.1 

func (b Box2) IntersectsBox(other Box2) bool

IntersectsBox returns if other box intersects this one.

func (*Box2) IsEmpty 

func (b *Box2) IsEmpty() bool

IsEmpty returns if this bounding box is empty (max < min on any coord).

func (Box2) IsEqual 

func (b Box2) IsEqual(other Box2) bool

IsEqual returns if this box is equal to other.

func (Box2) MulMat2 added in v1.0.6 

func (b Box2) MulMat2(m Mat2) Box2

MulMat2 multiplies the specified matrix to the vertices of this bounding box and computes the resulting spanning Box2 of the transformed points

func (*Box2) Set 

func (b *Box2) Set(min, max *Vec2)

Set sets this bounding box minimum and maximum coordinates. If either min or max are nil, then corresponding values are set to +/- Infinity.

func (*Box2) SetEmpty 

func (b *Box2) SetEmpty()

SetEmpty set this bounding box to empty (min / max +/- Infinity)

func (*Box2) SetFromCenterAndSize 

func (b *Box2) SetFromCenterAndSize(center, size Vec2)

SetFromCenterAndSize set this bounding box from a center point and size. Size is a vector from the minimum point to the maximum point.

func (*Box2) SetFromPoints 

func (b *Box2) SetFromPoints(points []Vec2)

SetFromPoints set this bounding box from the specified array of points.

func (*Box2) SetFromRect added in v1.0.5 

func (b *Box2) SetFromRect(rect image.Rectangle)

SetFromRect set this bounding box from an image.Rectangle

func (Box2) Size 

func (b Box2) Size() Vec2

Size calculates the size of this bounding box: the vector from its minimum point to its maximum point.

func (Box2) ToRect added in v1.0.5 

func (b Box2) ToRect() image.Rectangle

ToRect returns image.Rectangle version of this bbox, using floor for min and Ceil for max.

func (Box2) Translate 

func (b Box2) Translate(offset Vec2) Box2

Translate returns translated position of this box by offset.

func (Box2) Union 

func (b Box2) Union(other Box2) Box2

Union returns the union with other box.

type Box3 

type Box3 struct {
	Min Vec3
	Max Vec3
}

Box3 represents a 3D bounding box defined by two points: the point with minimum coordinates and the point with maximum coordinates.

func NewBox3 

func NewBox3(min, max Vec3) Box3

NewBox3 creates and returns a new Box3 defined by its minimum and maximum coordinates.

func NewEmptyBox3 

func NewEmptyBox3() Box3

NewEmptyBox3 creates and returns a new Box3 with empty min / max

func (Box3) Center 

func (b Box3) Center() Vec3

Center returns the center of the bounding box.

func (Box3) ClampPoint 

func (b Box3) ClampPoint(point Vec3) Vec3

ClampPoint returns a new point which is the specified point clamped inside this box.

func (Box3) ContainsBox 

func (b Box3) ContainsBox(box Box3) bool

ContainsBox returns if this bounding box contains other box.

func (Box3) ContainsPoint 

func (b Box3) ContainsPoint(point Vec3) bool

ContainsPoint returns if this bounding box contains the specified point.

func (Box3) DistToPoint 

func (b Box3) DistToPoint(point Vec3) float32

DistToPoint returns the distance from this box to the specified point.

func (*Box3) ExpandByBox added in v1.0.1 

func (b *Box3) ExpandByBox(box Box3)

ExpandByBox may expand this bounding box to include the specified box

func (*Box3) ExpandByPoint 

func (b *Box3) ExpandByPoint(point Vec3)

ExpandByPoint may expand this bounding box to include the specified point.

func (*Box3) ExpandByPoints 

func (b *Box3) ExpandByPoints(points []Vec3)

ExpandByPoints may expand this bounding box from the specified array of points.

func (*Box3) ExpandByScalar 

func (b *Box3) ExpandByScalar(scalar float32)

ExpandByScalar expands this bounding box by the specified scalar subtracting from min and adding to max.

func (*Box3) ExpandByVector 

func (b *Box3) ExpandByVector(vector Vec3)

ExpandByVector expands this bounding box by the specified vector subtracting from min and adding to max.

func (Box3) GetBoundingSphere 

func (b Box3) GetBoundingSphere() Sphere

GetBoundingSphere returns a bounding sphere to this bounding box.

func (Box3) Intersect 

func (b Box3) Intersect(other Box3) Box3

Intersect returns the intersection with other box.

func (Box3) IntersectsBox added in v1.0.1 

func (b Box3) IntersectsBox(other Box3) bool

IntersectsBox returns if other box intersects this one.

func (Box3) IsEmpty 

func (b Box3) IsEmpty() bool

IsEmpty returns true if this bounding box is empty (max < min on any coord).

func (Box3) IsEqual 

func (b Box3) IsEqual(other Box3) bool

IsEqual returns if this box is equal to other

func (Box3) MVProjToNDC 

func (b Box3) MVProjToNDC(m *Mat4) Box3

MVProjToNDC projects bounding box through given MVP model-view-projection Mat4 with perspective divide to return normalized display coordinates (NDC).

func (Box3) MulMat4 

func (b Box3) MulMat4(m *Mat4) Box3

MulMat4 multiplies the specified matrix to the vertices of this bounding box and computes the resulting spanning Box3 of the transformed points

func (Box3) MulQuat 

func (b Box3) MulQuat(q Quat) Box3

MulQuat multiplies the specified quaternion to the vertices of this bounding box and computes the resulting spanning Box3 of the transformed points

func (*Box3) Set 

func (b *Box3) Set(min, max *Vec3)

Set sets this bounding box minimum and maximum coordinates. If either min or max are nil, then corresponding values are set to +/- Infinity.

func (*Box3) SetEmpty 

func (b *Box3) SetEmpty()

SetEmpty set this bounding box to empty (min / max +/- Infinity)

func (*Box3) SetFromCenterAndSize 

func (b *Box3) SetFromCenterAndSize(center, size Vec3)

SetFromCenterAndSize sets this bounding box from a center point and size. Size is a vector from the minimum point to the maximum point.

func (*Box3) SetFromPoints 

func (b *Box3) SetFromPoints(points []Vec3)

SetFromPoints sets this bounding box from the specified array of points.

func (Box3) Size 

func (b Box3) Size() Vec3

Size calculates the size of this bounding box: the vector from its minimum point to its maximum point.

func (Box3) Translate 

func (b Box3) Translate(offset Vec3) Box3

Translate returns translated position of this box by offset.

func (Box3) Union 

func (b Box3) Union(other Box3) Box3

Union returns the union with other box.

type Dims 

type Dims int

Dims is a list of vector dimension (component) names 

const (
	X Dims = iota
	Y
	Z
	W
	DimsN
)

func OtherDim 

func OtherDim(d Dims) Dims

OtherDim returns the other dimension for 2D X,Y

func (*Dims) FromString 

func (i *Dims) FromString(s string) error

func (Dims) String 

func (i Dims) String() string

type Frustum 

type Frustum struct {
	Planes [6]Plane
}

Frustum represents a frustum

func NewFrustum 

func NewFrustum(p0, p1, p2, p3, p4, p5 *Plane) *Frustum

NewFrustum returns a pointer to a new Frustum object made of 6 explicit planes

func NewFrustumFromMatrix 

func NewFrustumFromMatrix(m *Mat4) *Frustum

NewFrustumFromMatrix creates and returns a Frustum based on the provided matrix

func (*Frustum) ContainsPoint 

func (f *Frustum) ContainsPoint(point Vec3) bool

ContainsPoint determines whether the frustum contains the specified point

func (*Frustum) IntersectsBox 

func (f *Frustum) IntersectsBox(box Box3) bool

IntersectsBox determines whether the specified box is intersecting the frustum

func (*Frustum) IntersectsSphere 

func (f *Frustum) IntersectsSphere(sphere Sphere) bool

IntersectsSphere determines whether the specified sphere is intersecting the frustum

func (*Frustum) Set 

func (f *Frustum) Set(p0, p1, p2, p3, p4, p5 *Plane)

Set sets the frustum's planes

func (*Frustum) SetFromMatrix 

func (f *Frustum) SetFromMatrix(m *Mat4)

SetFromMatrix sets the frustum's planes based on the specified Mat4

type Line3 

type Line3 struct {
	Start Vec3
	End   Vec3
}

Line3 represents a 3D line segment defined by a start and an end point.

func NewLine3 

func NewLine3(start, end Vec3) Line3

NewLine3 creates and returns a new Line3 with the specified start and end points.

func (*Line3) Center 

func (l *Line3) Center() Vec3

Center calculates this line segment center point.

func (*Line3) Delta 

func (l *Line3) Delta() Vec3

Delta calculates the vector from the start to end point of this line segment.

func (*Line3) Dist 

func (l *Line3) Dist() float32

Dist returns the distance from the start point to the end point.

func (*Line3) DistSq 

func (l *Line3) DistSq() float32

DistSq returns the square of the distance from the start point to the end point.

func (*Line3) IsEqual 

func (l *Line3) IsEqual(other Line3) bool

IsEqual returns if this line segement is equal to other.

func (*Line3) MulMat4 

func (l *Line3) MulMat4(mat *Mat4) Line3

MulMat4 returns specified matrix multiplied to this line segment start and end points.

func (*Line3) Set 

func (l *Line3) Set(start, end Vec3)

Set sets this line segment start and end points.

type Mat2 

type Mat2 struct {
	XX, YX, XY, YY, X0, Y0 float32
}

func Identity2D 

func Identity2D() Mat2

func Rotate2D 

func Rotate2D(angle float32) Mat2

func Scale2D 

func Scale2D(x, y float32) Mat2

func Shear2D 

func Shear2D(x, y float32) Mat2

func Skew2D 

func Skew2D(x, y float32) Mat2

func Translate2D 

func Translate2D(x, y float32) Mat2

func (Mat2) ExtractRot 

func (a Mat2) ExtractRot() float32

ExtractRot extracts the rotation component from a given matrix

func (Mat2) ExtractScale 

func (a Mat2) ExtractScale() (scx, scy float32)

ExtractXYScale extracts the X and Y scale factors after undoing any rotation present -- i.e., in the original X, Y coordinates

func (Mat2) Inverse added in v1.0.3 

func (a Mat2) Inverse() Mat2

Inverse returns inverse of matrix, for inverting transforms

func (Mat2) IsIdentity added in v1.0.3 

func (m Mat2) IsIdentity() bool

func (Mat2) Mul 

func (a Mat2) Mul(b Mat2) Mat2

func (Mat2) MulCtr added in v1.0.4 

func (a Mat2) MulCtr(b Mat2, ctr Vec2) Mat2

MulCtr multiplies the Mat2, first subtracting given translation center point from the translation components, and then adding it back in.

func (Mat2) MulVec2AsPt 

func (a Mat2) MulVec2AsPt(v Vec2) Vec2

MulVec2AsPt multiplies the Vec2 as a point, including adding translations.

func (Mat2) MulVec2AsPtCtr added in v1.0.3 

func (a Mat2) MulVec2AsPtCtr(v, ctr Vec2) Vec2

MulVec2AsPtCtr multiplies the Vec2 as a point relative to given center-point including adding translations.

func (Mat2) MulVec2AsVec 

func (a Mat2) MulVec2AsVec(v Vec2) Vec2

MulVec2AsVec multiplies the Vec2 as a vector -- does not add translations. This is for directional vectors and not points.

func (Mat2) Rotate 

func (a Mat2) Rotate(angle float32) Mat2

func (Mat2) Scale 

func (a Mat2) Scale(x, y float32) Mat2

func (*Mat2) SetString 

func (a *Mat2) SetString(str string) error

SetString processes the standard SVG-style transform strings

func (Mat2) Shear 

func (a Mat2) Shear(x, y float32) Mat2

func (Mat2) Skew 

func (a Mat2) Skew(x, y float32) Mat2

func (*Mat2) String added in v1.0.4 

func (a *Mat2) String() string

String returns the XML-based string representation of the transform

func (Mat2) Translate 

func (a Mat2) Translate(x, y float32) Mat2

type Mat3 

type Mat3 [9]float32

Mat3 is 3x3 matrix organized internally as column matrix

func NewMat3 

func NewMat3() *Mat3

NewMat3 creates and returns a pointer to a new Mat3 initialized as the identity matrix.

func (*Mat3) CopyFrom added in v1.0.2 

func (m *Mat3) CopyFrom(src *Mat3)

CopyFrom copies from source matrix into this matrix (a regular = assign does not copy data, just the pointer!)

func (*Mat3) Determinant 

func (m *Mat3) Determinant() float32

Determinant calculates and returns the determinant of this matrix.

func (*Mat3) FromArray 

func (m *Mat3) FromArray(array []float32, offset int)

FromArray sets this matrix array starting at offset.

func (*Mat3) Inverse 

func (m *Mat3) Inverse() (*Mat3, error)

Inverse returns the inverse of this matrix. If the matrix cannot be inverted returns error and sets this matrix to the identity matrix.

func (*Mat3) Mul 

func (m *Mat3) Mul(other *Mat3) *Mat3

Mul returns this matrix times other matrix (this matrix is unchanged)

func (*Mat3) MulMatrices 

func (m *Mat3) MulMatrices(a, b *Mat3)

MulMatrices sets ths matrix as matrix multiplication a by b (i.e., b*a).

func (*Mat3) MulScalar 

func (m *Mat3) MulScalar(s float32)

MulScalar returns each of this matrix's components multiplied by the specified scalar.

func (*Mat3) MulVec3Array 

func (m *Mat3) MulVec3Array(array []float32, start, count int)

MulVec3Array multiplies count vectors (i.e., 3 sequential array values per each increment in count) in the array starting at start index by this matrix.

func (*Mat3) ScaleCols 

func (m *Mat3) ScaleCols(v Vec3) *Mat3

ScaleCols returns matrix with columns multiplied by the vector components. This can be used when multiplying this matrix by a diagonal matrix if we store the diagonal components as a vector.

func (*Mat3) Set 

func (m *Mat3) Set(n11, n12, n13, n21, n22, n23, n31, n32, n33 float32)

Set sets all the elements of the matrix row by row starting at row1, column1, row1, column2, row1, column3 and so forth.

func (*Mat3) SetFromMat4 

func (m *Mat3) SetFromMat4(src *Mat4)

SetFromMat4 sets the matrix elements based on a Mat4.

func (*Mat3) SetIdentity 

func (m *Mat3) SetIdentity()

SetIdentity sets this matrix as the identity matrix.

func (*Mat3) SetInverse 

func (m *Mat3) SetInverse(src *Mat3) error

SetInverse sets this matrix to the inverse of the src matrix. If the src matrix cannot be inverted returns error and sets this matrix to the identity matrix.

func (*Mat3) SetMul 

func (m *Mat3) SetMul(other *Mat3)

SetMul sets this matrix to this matrix * other

func (*Mat3) SetMulScalar 

func (m *Mat3) SetMulScalar(s float32)

SetMulScalar multiplies each of this matrix's components by the specified scalar.

func (*Mat3) SetNormalMatrix 

func (m *Mat3) SetNormalMatrix(src *Mat4) error

SetNormalMatrix set this matrix to the matrix that can transform the normal vectors from the src matrix which is used transform the vertices (e.g., a ModelView matrix). If the src matrix cannot be inverted returns error.

func (*Mat3) SetRotationFromQuat 

func (m *Mat3) SetRotationFromQuat(q Quat)

SetRotationFromQuat sets this matrix as a rotation matrix from the specified quaternion.

func (*Mat3) SetScaleCols 

func (m *Mat3) SetScaleCols(v Vec3)

SetScaleCols multiplies the matrix columns by the vector components. This can be used when multiplying this matrix by a diagonal matrix if we store the diagonal components as a vector.

func (*Mat3) SetTranspose 

func (m *Mat3) SetTranspose()

SetTranspose transposes this matrix.

func (*Mat3) SetZero 

func (m *Mat3) SetZero()

SetZero sets this matrix as the zero matrix.

func (*Mat3) ToArray 

func (m *Mat3) ToArray(array []float32, offset int)

ToArray copies this matrix to array starting at offset.

func (*Mat3) Transpose 

func (m *Mat3) Transpose() *Mat3

Transpose returns the transpose of this matrix.

type Mat4 

type Mat4 [16]float32

Mat4 is 4x4 matrix organized internally as column matrix.

func NewLookAt 

func NewLookAt(eye, target, up Vec3) *Mat4

NewLookAt returns Mat4 matrix as view transform matrix with origin at eye, looking at target and using the up vector.

func NewMat4 

func NewMat4() *Mat4

NewMat4 creates and returns a pointer to a new Mat4 initialized as the identity matrix.

func (*Mat4) CopyFrom added in v1.0.2 

func (m *Mat4) CopyFrom(src *Mat4)

CopyFrom copies from source matrix into this matrix (a regular = assign does not copy data, just the pointer!)

func (*Mat4) CopyPos 

func (m *Mat4) CopyPos(src *Mat4)

CopyPos copies the position elements of the src matrix into this one.

func (*Mat4) Decompose 

func (m *Mat4) Decompose() (pos Vec3, quat Quat, scale Vec3)

Decompose updates the position vector, quaternion and scale from this transformation matrix.

func (*Mat4) Determinant 

func (m *Mat4) Determinant() float32

Determinant calculates and returns the determinat of this matrix.

func (*Mat4) ExtractBasis 

func (m *Mat4) ExtractBasis() (xAxis, yAxis, zAxis Vec3)

ExtractBasis returns the x,y,z basis vectors of this matrix.

func (*Mat4) ExtractRotation 

func (m *Mat4) ExtractRotation(src *Mat4)

ExtractRotation sets this matrix as rotation matrix from the src transformation matrix.

func (*Mat4) FromArray 

func (m *Mat4) FromArray(array []float32, offset int)

FromArray set this matrix elements from the array starting at offset.

func (*Mat4) GetMaxScaleOnAxis 

func (m *Mat4) GetMaxScaleOnAxis() float32

GetMaxScaleOnAxis returns the maximum scale value of the 3 axes.

func (*Mat4) Inverse 

func (m *Mat4) Inverse() (*Mat4, error)

Inverse returns the inverse of this matrix. If the matrix cannot be inverted returns error and sets this matrix to the identity matrix.

func (*Mat4) LookAt 

func (m *Mat4) LookAt(eye, target, up Vec3)

LookAt sets this matrix as view transform matrix with origin at eye, looking at target and using the up vector.

func (*Mat4) Mul 

func (m *Mat4) Mul(other *Mat4) *Mat4

Mul returns this matrix times other matrix (this matrix is unchanged)

func (*Mat4) MulMatrices 

func (m *Mat4) MulMatrices(a, b *Mat4)

MulMatrices sets this matrix as matrix multiplication a by b (i.e. b*a).

func (*Mat4) MulScalar 

func (m *Mat4) MulScalar(s float32)

SetMulScalar multiplies each element of this matrix by the specified scalar.

func (*Mat4) MulVec3Array 

func (m *Mat4) MulVec3Array(array []float32, start, count int)

MulVec3Array multiplies count vectors (i.e., 3 sequential array values per each increment in count) in the array starting at start index by this matrix.

func (*Mat4) Pos 

func (m *Mat4) Pos() Vec3

Pos returns the position component of the matrix

func (*Mat4) ScaleCols 

func (m *Mat4) ScaleCols(v Vec3) *Mat4

ScaleCols returns matrix with first column of this matrix multiplied by the vector X component, the second column by the vector Y component and the third column by the vector Z component. The matrix fourth column is unchanged.

func (*Mat4) Set 

func (m *Mat4) Set(n11, n12, n13, n14, n21, n22, n23, n24, n31, n32, n33, n34, n41, n42, n43, n44 float32)

Set sets all the elements of this matrix row by row starting at row1, column1, row1, column2, row1, column3 and so forth.

func (*Mat4) SetBasis 

func (m *Mat4) SetBasis(xAxis, yAxis, zAxis Vec3)

SetBasis sets this matrix basis vectors from the specified vectors.

func (*Mat4) SetFromMat3 

func (m *Mat4) SetFromMat3(src *Mat3)

SetFromMat3 sets the matrix elements based on a Mat3, filling in 0's for missing off-diagonal elements, and 1 on the diagonal.

func (*Mat4) SetFrustum 

func (m *Mat4) SetFrustum(left, right, bottom, top, near, far float32)

SetFrustum sets this matrix to a projection frustum matrix bounded by the specified planes.

func (*Mat4) SetIdentity 

func (m *Mat4) SetIdentity()

SetIdentity sets this matrix as the identity matrix.

func (*Mat4) SetInverse 

func (m *Mat4) SetInverse(src *Mat4) error

SetInverse sets this matrix to the inverse of the src matrix. If the src matrix cannot be inverted returns error and sets this matrix to the identity matrix.

func (*Mat4) SetMul 

func (m *Mat4) SetMul(other *Mat4)

SetMul sets this matrix to this matrix times other

func (*Mat4) SetOrthographic 

func (m *Mat4) SetOrthographic(width, height, near, far float32)

SetOrthographic sets this matrix to an orthographic projection matrix.

func (*Mat4) SetPerspective 

func (m *Mat4) SetPerspective(fov, aspect, near, far float32)

SetPerspective sets this matrix to a perspective projection matrix with the specified field of view in degrees, aspect ratio (width/height) and near and far planes.

func (*Mat4) SetPos 

func (m *Mat4) SetPos(v Vec3)

SetPos sets this transformation matrix position fields from the specified vector v.

func (*Mat4) SetRotationAxis 

func (m *Mat4) SetRotationAxis(axis *Vec3, angle float32)

SetRotationAxis sets this matrix to a rotation matrix of the specified angle around the specified axis.

func (*Mat4) SetRotationFromEuler 

func (m *Mat4) SetRotationFromEuler(euler Vec3)

SetRotationFromEuler set this a matrix as a rotation matrix from the specified euler angles.

func (*Mat4) SetRotationFromQuat 

func (m *Mat4) SetRotationFromQuat(q Quat)

SetRotationFromQuat sets this matrix as a rotation matrix from the specified quaternion.

func (*Mat4) SetRotationX 

func (m *Mat4) SetRotationX(theta float32)

SetRotationX sets this matrix to a rotation matrix of angle theta around the X axis.

func (*Mat4) SetRotationY 

func (m *Mat4) SetRotationY(theta float32)

SetRotationY sets this matrix to a rotation matrix of angle theta around the Y axis.

func (*Mat4) SetRotationZ 

func (m *Mat4) SetRotationZ(theta float32)

SetRotationZ sets this matrix to a rotation matrix of angle theta around the Z axis.

func (*Mat4) SetScale 

func (m *Mat4) SetScale(x, y, z float32)

SetScale sets this matrix to a scale transformation matrix using the specified x, y and z values.

func (*Mat4) SetScaleCols 

func (m *Mat4) SetScaleCols(v Vec3)

SetScaleCols multiplies the first column of this matrix by the vector X component, the second column by the vector Y component and the third column by the vector Z component. The matrix fourth column is unchanged.

func (*Mat4) SetTransform 

func (m *Mat4) SetTransform(pos Vec3, quat Quat, scale Vec3)

SetTransform sets this matrix to a transformation matrix for the specified position, rotation specified by the quaternion and scale.

func (*Mat4) SetTranslation 

func (m *Mat4) SetTranslation(x, y, z float32)

SetTranslation sets this matrix to a translation matrix from the specified x, y and z values.

func (*Mat4) SetTranspose 

func (m *Mat4) SetTranspose()

SetTranspose transposes this matrix.

func (*Mat4) SetVkFrustum added in v1.0.11 

func (m *Mat4) SetVkFrustum(left, right, bottom, top, near, far float32)

SetVkFrustum sets this matrix to a projection frustum matrix bounded by the specified planes. This version is for use with Vulkan, and does the equivalent of GLM_DEPTH_ZERO_ONE in glm and also multiplies the Y axis by -1, preserving the original OpenGL Y-up system. OpenGL provides a "natural" coordinate system for the physical world so it is useful to retain that for the world system and just convert on the way out to the render using this projection matrix.

func (*Mat4) SetVkPerspective added in v1.0.11 

func (m *Mat4) SetVkPerspective(fov, aspect, near, far float32)

SetVkPerspective sets this matrix to a vulkan appropriate perspective projection matrix, assuming the use of the OpenGL Y-up coordinate system for the geometry points. OpenGL provides a "natural" coordinate system for the physical world so it is useful to retain that for the world system and just convert on the way out to the render using this projection matrix. The specified field of view is in degrees, aspect ratio (width/height) and near and far planes.

func (*Mat4) SetZero 

func (m *Mat4) SetZero()

SetZero sets this matrix as the zero matrix.

func (*Mat4) ToArray 

func (m *Mat4) ToArray(array []float32, offset int)

ToArray copies this matrix elements to array starting at offset.

func (*Mat4) Transpose 

func (m *Mat4) Transpose() *Mat4

Transpose returns the transpose of this matrix.

type Plane 

type Plane struct {
	Norm Vec3
	Off  float32
}

Plane represents a plane in 3D space by its normal vector and a constant offset. When the the normal vector is the unit vector the offset is the distance from the origin.

func NewPlane 

func NewPlane(normal Vec3, offset float32) *Plane

NewPlane creates and returns a new plane from a normal vector and a offset.

func (*Plane) CoplanarPoint 

func (p *Plane) CoplanarPoint() Vec3

CoplanarPoint returns a point in the plane that is the closest point from the origin.

func (*Plane) DistToPoint 

func (p *Plane) DistToPoint(point Vec3) float32

DistToPoint returns the distance of this plane from point.

func (*Plane) DistToSphere 

func (p *Plane) DistToSphere(sphere Sphere) float32

DistToSphere returns the distance of this place from the sphere.

func (*Plane) IntersectLine 

func (p *Plane) IntersectLine(line Line3) (Vec3, bool)

IntersectLine calculates the point in the plane which intersets the specified line. Returns false if the line does not intersects the plane.

func (*Plane) IsEqual 

func (p *Plane) IsEqual(other *Plane) bool

IsEqual returns if this plane is equal to other

func (*Plane) IsIntersectionLine 

func (p *Plane) IsIntersectionLine(line Line3) bool

IsIntersectionLine returns the line intersects this plane.

func (*Plane) Negate 

func (p *Plane) Negate()

Negate negates this plane normal.

func (*Plane) Normalize 

func (p *Plane) Normalize()

Normalize normalizes this plane normal vector and adjusts the offset. Note: will lead to a divide by zero if the plane is invalid.

func (*Plane) Set 

func (p *Plane) Set(normal Vec3, offset float32)

Set sets this plane normal vector and offset.

func (*Plane) SetDims 

func (p *Plane) SetDims(x, y, z, w float32)

SetDims sets this plane normal vector dimensions and offset.

func (*Plane) SetFromCoplanarPoints 

func (p *Plane) SetFromCoplanarPoints(a, b, c Vec3)

SetFromCoplanarPoints sets this plane from three coplanar points.

func (*Plane) SetFromNormalAndCoplanarPoint 

func (p *Plane) SetFromNormalAndCoplanarPoint(normal Vec3, point Vec3)

SetFromNormalAndCoplanarPoint sets this plane from a normal vector and a point on the plane.

func (*Plane) SetTranslate 

func (p *Plane) SetTranslate(offset Vec3)

SetTranslate translates this plane in the direction of its normal by offset.

type Quat 

type Quat struct {
	X float32
	Y float32
	Z float32
	W float32
}

Quat is quaternion with X,Y,Z and W components.

func NewQuat 

func NewQuat(x, y, z, w float32) Quat

NewQuat returns a new quaternion from the specified components.

func NewQuatAxisAngle 

func NewQuatAxisAngle(axis Vec3, angle float32) Quat

NewQuatAxisAngle returns a new quaternion from given axis and angle rotation (radians).

func NewQuatEuler 

func NewQuatEuler(euler Vec3) Quat

NewQuatEuler returns a new quaternion from given Euler angles.

func (*Quat) Conjugate 

func (q *Quat) Conjugate() Quat

Conjugate returns the conjugate of this quaternion.

func (*Quat) Dot 

func (q *Quat) Dot(other Quat) float32

Dot returns the dot products of this quaternion with other.

func (*Quat) FromArray 

func (q *Quat) FromArray(array []float32, offset int)

FromArray sets this quaternion's components from array starting at offset.

func (*Quat) GenGoNew 

func (q *Quat) GenGoNew() string

GenGoNew returns code to create new

func (*Quat) GenGoSet 

func (q *Quat) GenGoSet(path string) string

GenGoSet returns code to set values in object at given path (var.member etc)

func (*Quat) Inverse 

func (q *Quat) Inverse() Quat

Inverse returns the inverse of this quaternion.

func (*Quat) IsEqual 

func (q *Quat) IsEqual(other Quat) bool

IsEqual returns if this quaternion is equal to other.

func (*Quat) IsIdentity 

func (q *Quat) IsIdentity() bool

IsIdentity returns if this is an identity quaternion.

func (*Quat) IsNil 

func (q *Quat) IsNil() bool

IsNil returns true if all values are 0 (uninitialized).

func (Quat) Length 

func (q Quat) Length() float32

Length returns the length of this quaternion

func (Quat) LengthSq 

func (q Quat) LengthSq() float32

LengthSq returns this quanternion's length squared

func (*Quat) Mul 

func (q *Quat) Mul(other Quat) Quat

Mul returns returns multiplication of this quaternion with other

func (*Quat) MulQuats 

func (q *Quat) MulQuats(a, b Quat)

MulQuats set this quaternion to the multiplication of a by b.

func (*Quat) Normalize 

func (q *Quat) Normalize()

Normalize normalizes this quaternion.

func (*Quat) NormalizeFast 

func (q *Quat) NormalizeFast()

NormalizeFast approximates normalizing this quaternion. Works best when the quaternion is already almost-normalized.

func (*Quat) Set 

func (q *Quat) Set(x, y, z, w float32)

Set sets this quaternion's components.

func (*Quat) SetConjugate 

func (q *Quat) SetConjugate()

SetConjugate sets this quaternion to its conjugate.

func (*Quat) SetFromAxisAngle 

func (q *Quat) SetFromAxisAngle(axis Vec3, angle float32)

SetFromAxisAngle sets this quaternion with the rotation specified by the given axis and angle.

func (*Quat) SetFromEuler 

func (q *Quat) SetFromEuler(euler Vec3)

SetFromEuler sets this quaternion from the specified vector with Euler angles for each axis. It is assumed that the Euler angles are in XYZ order.

func (*Quat) SetFromRotationMatrix 

func (q *Quat) SetFromRotationMatrix(m *Mat4)

SetFromRotationMatrix sets this quaternion from the specified rotation matrix.

func (*Quat) SetFromUnitVectors 

func (q *Quat) SetFromUnitVectors(vFrom, vTo Vec3)

SetFromUnitVectors sets this quaternion to the rotation from vector vFrom to vTo. The vectors must be normalized.

func (*Quat) SetIdentity 

func (q *Quat) SetIdentity()

SetIdentity sets this quanternion to the identity quaternion.

func (*Quat) SetInverse 

func (q *Quat) SetInverse()

SetInverse sets this quaternion to its inverse.

func (*Quat) SetMul 

func (q *Quat) SetMul(other Quat)

SetMul sets this quaternion to the multiplication of itself by other.

func (*Quat) Slerp 

func (q *Quat) Slerp(other Quat, t float32)

Slerp sets this quaternion to another quaternion which is the spherically linear interpolation from this quaternion to other using t.

func (*Quat) ToArray 

func (q *Quat) ToArray(array []float32, offset int)

ToArray copies this quaternions's components to array starting at offset.

func (*Quat) ToAxisAngle 

func (q *Quat) ToAxisAngle() Vec4

ToAxisAngle returns the Vec4 holding axis and angle of this Quaternion

func (*Quat) ToEuler 

func (q *Quat) ToEuler() Vec3

ToEuler returns a Vec3 with components as the Euler angles from the given quaternion.

type Ray 

type Ray struct {
	Origin Vec3
	Dir    Vec3
}

Ray represents an oriented 3D line segment defined by an origin point and a direction vector.

func NewRay 

func NewRay(origin, dir Vec3) *Ray

NewRay creates and returns a pointer to a Ray object with the specified origin and direction vectors. If a nil pointer is supplied for any of the parameters, the zero vector will be used.

func (*Ray) ApplyMat4 

func (ray *Ray) ApplyMat4(mat4 *Mat4)

MulMat4 multiplies this ray origin and direction by the specified matrix4, basically transforming this ray coordinates.

func (*Ray) At 

func (ray *Ray) At(t float32) Vec3

At calculates the point in the ray which is at the specified t distance from the origin along its direction.

func (*Ray) ClosestPointToPoint 

func (ray *Ray) ClosestPointToPoint(point Vec3) Vec3

ClosestPointToPoint calculates the point in the ray which is closest to the specified point.

func (*Ray) DistSqToPoint 

func (ray *Ray) DistSqToPoint(point Vec3) float32

DistSqToPoint returns the smallest squared distance from the ray direction vector to the specified point. If the ray was pointed directly at the point this distance would be 0.

func (*Ray) DistSqToSegment 

func (ray *Ray) DistSqToSegment(v0, v1 Vec3, optPointOnRay, optPointOnSegment *Vec3) float32

DistSqToSegment returns the smallest squared distance from this ray to the line segment from v0 to v1. If optPointOnRay Vec3 is not nil, it is set with the coordinates of the point on the ray. if optPointOnSegment Vec3 is not nil, it is set with the coordinates of the point on the segment.

func (*Ray) DistToPlane 

func (ray *Ray) DistToPlane(plane Plane) float32

DistToPlane returns the distance of this ray origin to its intersection point in the plane. If the ray does not intersects the plane, returns NaN.

func (*Ray) DistToPoint 

func (ray *Ray) DistToPoint(point Vec3) float32

DistToPoint returns the smallest distance from the ray direction vector to the specified point.

func (*Ray) IntersectBox 

func (ray *Ray) IntersectBox(box Box3) (Vec3, bool)

IntersectBox calculates the point which is the intersection of this ray with the specified box. If no intersection is found false is returned.

func (*Ray) IntersectPlane 

func (ray *Ray) IntersectPlane(plane Plane) (Vec3, bool)

IntersectPlane calculates the point which is the intersection of this ray with the specified plane. If no intersection is found false is returned.

func (*Ray) IntersectSphere 

func (ray *Ray) IntersectSphere(sphere Sphere) (Vec3, bool)

IntersectSphere calculates the point which is the intersection of this ray with the specified sphere. If no intersection is found false is returne.

func (*Ray) IntersectTriangle 

func (ray *Ray) IntersectTriangle(a, b, c Vec3, backfaceCulling bool) (Vec3, bool)

IntersectTriangle returns if this ray intersects the triangle with the face defined by points a, b, c. Returns true if it intersects and the point parameter with the intersected point coordinates. If backfaceCulling is false it ignores the intersection if the face is not oriented in the ray direction.

func (*Ray) IntersectsBox added in v1.0.1 

func (ray *Ray) IntersectsBox(box Box3) bool

IntersectsBox returns if this ray intersects the specified box.

func (*Ray) IsEqual 

func (ray *Ray) IsEqual(other Ray) bool

IsEqual returns if this ray is equal to other

func (*Ray) IsIntersectPlane 

func (ray *Ray) IsIntersectPlane(plane Plane) bool

IsIntersectPlane returns if this ray intersects the specified plane.

func (*Ray) IsIntersectionSphere 

func (ray *Ray) IsIntersectionSphere(sphere Sphere) bool

IsIntersectionSphere returns if this ray intersects with the specified sphere.

func (*Ray) Recast 

func (ray *Ray) Recast(t float32)

Recast sets the new origin of the ray at the specified distance t from its origin along its direction.

func (*Ray) Set 

func (ray *Ray) Set(origin, dir Vec3)

Set sets the origin and direction vectors of this Ray.

type Sphere 

type Sphere struct {
	Center Vec3    // center of the sphere
	Radius float32 // radius of the sphere
}

Sphere represents a 3D sphere defined by its center point and a radius

func NewSphere 

func NewSphere(center Vec3, radius float32) *Sphere

NewSphere creates and returns a pointer to a new sphere with the specified center and radius.

func (*Sphere) ClampPoint 

func (s *Sphere) ClampPoint(point Vec3) Vec3

ClampPoint clamps the specified point inside the sphere. If the specified point is inside the sphere, it is the clamped point. Otherwise the clamped point is the the point in the sphere surface in the nearest of the specified point.

func (*Sphere) ContainsPoint 

func (s *Sphere) ContainsPoint(point Vec3) bool

ContainsPoint returns if this sphere contains the specified point.

func (*Sphere) DistToPoint 

func (s *Sphere) DistToPoint(point Vec3) float32

DistToPoint returns the distance from the sphere surface to the specified point.

func (*Sphere) GetBoundingBox 

func (s *Sphere) GetBoundingBox() Box3

GetBoundingBox calculates a Box3 which bounds this sphere.

func (*Sphere) IntersectSphere 

func (s *Sphere) IntersectSphere(other Sphere) bool

IntersectSphere returns if other sphere intersects this one.

func (*Sphere) IsEmpty 

func (s *Sphere) IsEmpty(sphere *Sphere) bool

IsEmpty checks if this sphere is empty (radius <= 0)

func (*Sphere) MulMat4 

func (s *Sphere) MulMat4(mat *Mat4)

MulMat4 applies the specified matrix transform to this sphere.

func (*Sphere) Set 

func (s *Sphere) Set(center Vec3, radius float32)

Set sets the center and radius of this sphere.

func (*Sphere) SetFromBox 

func (s *Sphere) SetFromBox(box Box3)

SetFromBox sets the center and radius of this sphere to surround given box

func (*Sphere) SetFromPoints 

func (s *Sphere) SetFromPoints(points []Vec3, optCenter *Vec3)

SetFromPoints sets this sphere from the specified points array and optional center.

func (*Sphere) Translate 

func (s *Sphere) Translate(offset Vec3)

Translate translates this sphere by the specified offset.

type Spline 

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

func NewSpline 

func NewSpline(points []Vec3) Spline

func (*Spline) InitFromArray 

func (sp *Spline) InitFromArray(a []float32)

type Triangle 

type Triangle struct {
	A Vec3
	B Vec3
	C Vec3
}

Triangle represents a triangle made of three vertices.

func NewTriangle 

func NewTriangle(a, b, c Vec3) Triangle

NewTriangle returns a new Triangle object.

func (*Triangle) Area 

func (t *Triangle) Area() float32

Area returns the triangle's area.

func (*Triangle) BarycoordFromPoint 

func (t *Triangle) BarycoordFromPoint(point Vec3) Vec3

BarycoordFromPoint returns the barycentric coordinates for the specified point.

func (*Triangle) ContainsPoint 

func (t *Triangle) ContainsPoint(point Vec3) bool

ContainsPoint returns whether the triangle contains a point.

func (*Triangle) IsEqual 

func (t *Triangle) IsEqual(tri Triangle) bool

IsEqual returns whether the triangles are equal in all their vertices.

func (*Triangle) Midpoint 

func (t *Triangle) Midpoint() Vec3

Midpoint returns the triangle's midpoint.

func (*Triangle) Normal 

func (t *Triangle) Normal() Vec3

Normal returns the triangle's normal.

func (*Triangle) Plane 

func (t *Triangle) Plane() Plane

Plane returns a Plane object aligned with the triangle.

func (*Triangle) Set 

func (t *Triangle) Set(a, b, c Vec3)

Set sets the triangle's three vertices.

func (*Triangle) SetFromPointsAndIndices 

func (t *Triangle) SetFromPointsAndIndices(points []Vec3, i0, i1, i2 int)

SetFromPointsAndIndices sets the triangle's vertices based on the specified points and indices.

type Vec2 

type Vec2 struct {
	X float32
	Y float32
}

Vec2 is a 2D vector/point with X and Y components.

func NewVec2 

func NewVec2(x, y float32) Vec2

NewVec2 returns new Vec2 with the specified x and y components.

func NewVec2FmFixed 

func NewVec2FmFixed(pt fixed.Point26_6) Vec2

func NewVec2FmPoint 

func NewVec2FmPoint(pt image.Point) Vec2

func NewVec2Scalar 

func NewVec2Scalar(s float32) Vec2

NewVec2Scalar returns a new Vec2 with all components set to scalar.

func (Vec2) Abs 

func (v Vec2) Abs() Vec2

Abs returns the absolute value for each dimension

func (Vec2) Add 

func (v Vec2) Add(other Vec2) Vec2

Add adds other vector to this one and returns result in a new vector.

func (Vec2) AddScalar 

func (v Vec2) AddScalar(s float32) Vec2

AddScalar adds scalar s to each component of this vector and returns new vector.

func (Vec2) AlmostEqual 

func (v Vec2) AlmostEqual(other Vec2, tol float32) bool

AlmostEqual returns whether the vector is almost equal to another vector within the specified tolerance.

func (Vec2) AngleTo added in v1.0.17 

func (v Vec2) AngleTo(other Vec2) float32

AngleTo returns the angle between this vector and other. Returns angles in range of -PI to PI (not 0 to 2 PI).

func (Vec2) Ceil 

func (v Vec2) Ceil() Vec2

Ceil returns vector with mat32.Ceil() applied to each of this vector's components.

func (*Vec2) Clamp 

func (v *Vec2) Clamp(min, max Vec2)

Clamp sets this vector components to be no less than the corresponding components of min and not greater than the corresponding component of max. Assumes min < max, if this assumption isn't true it will not operate correctly.

func (*Vec2) ClampScalar 

func (v *Vec2) ClampScalar(minVal, maxVal float32)

ClampScalar sets this vector components to be no less than minVal and not greater than maxVal.

func (Vec2) CosTo added in v1.0.17 

func (v Vec2) CosTo(other Vec2) float32

CosTo returns the cosine (normalized dot product) between this vector and other.

func (Vec2) Cross added in v1.0.17 

func (v Vec2) Cross(other Vec2) float32

Cross returns the cross product of this vector with other which is a scalar, equivalent to the Z coord in 3D: X1 * Y2 - X2 Y1

func (Vec2) Dim 

func (v Vec2) Dim(dim Dims) float32

Dim returns this vector component.

func (Vec2) DistTo 

func (v Vec2) DistTo(other Vec2) float32

DistTo returns the distance of this point to other.

func (Vec2) DistToSquared 

func (v Vec2) DistToSquared(other Vec2) float32

DistToSquared returns the distance squared of this point to other.

func (Vec2) Div 

func (v Vec2) Div(other Vec2) Vec2

Div divides each component of this vector by the corresponding one from other vector and returns resulting vector.

func (Vec2) DivScalar 

func (v Vec2) DivScalar(scalar float32) Vec2

DivScalar divides each component of this vector by the scalar s and returns resulting vector. If scalar is zero, returns zero.

func (Vec2) Dot 

func (v Vec2) Dot(other Vec2) float32

Dot returns the dot product of this vector with other.

func (Vec2) Fixed 

func (a Vec2) Fixed() fixed.Point26_6

func (Vec2) Floor 

func (v Vec2) Floor() Vec2

Floor returns vector with mat32.Floor() applied to each of this vector's components.

func (*Vec2) FromArray 

func (v *Vec2) FromArray(array []float32, offset int)

FromArray sets this vector's components from the specified array and offset.

func (Vec2) InTriangle 

func (v Vec2) InTriangle(p0, p1, p2 Vec2) bool

InTriangle returns whether the vector is inside the specified triangle.

func (Vec2) IsEqual 

func (v Vec2) IsEqual(other Vec2) bool

IsEqual returns if this vector is equal to other.

func (Vec2) IsNil 

func (v Vec2) IsNil() bool

IsNil returns true if all values are 0 (uninitialized).

func (Vec2) Length 

func (v Vec2) Length() float32

Length returns the length of this vector.

func (Vec2) LengthSq 

func (v Vec2) LengthSq() float32

LengthSq returns the length squared of this vector. LengthSq can be used to compare vectors' lengths without the need to perform a square root.

func (Vec2) Lerp 

func (v Vec2) Lerp(other Vec2, alpha float32) Vec2

Lerp returns vector with each components as the linear interpolated value of alpha between itself and the corresponding other component.

func (Vec2) Max 

func (v Vec2) Max(other Vec2) Vec2

Max returns max of this vector components vs. other vector.

func (Vec2) Min 

func (v Vec2) Min(other Vec2) Vec2

Min returns min of this vector components vs. other vector.

func (Vec2) MinPos 

func (a Vec2) MinPos(b Vec2) Vec2

MinPos returns minimum of all positive (> 0) numbers

func (Vec2) Mul 

func (v Vec2) Mul(other Vec2) Vec2

Mul multiplies each component of this vector by the corresponding one from other and returns resulting vector.

func (Vec2) MulScalar 

func (v Vec2) MulScalar(s float32) Vec2

MulScalar multiplies each component of this vector by the scalar s and returns resulting vector.

func (Vec2) Negate 

func (v Vec2) Negate() Vec2

Negate returns vector with each component negated.

func (Vec2) Normal 

func (v Vec2) Normal() Vec2

Normal returns this vector divided by its length

func (*Vec2) Normalize 

func (v *Vec2) Normalize()

Normalize normalizes this vector so its length will be 1.

func (Vec2) Round 

func (v Vec2) Round() Vec2

Round returns vector with mat32.Round() applied to each of this vector's components.

func (*Vec2) Set 

func (v *Vec2) Set(x, y float32)

Set sets this vector X and Y components.

func (*Vec2) SetAdd 

func (v *Vec2) SetAdd(other Vec2)

SetAdd sets this to addition with other vector (i.e., += or plus-equals).

func (*Vec2) SetAddDim 

func (a *Vec2) SetAddDim(d Dims, val float32)

func (*Vec2) SetAddScalar 

func (v *Vec2) SetAddScalar(s float32)

SetAddScalar sets this to addition with scalar.

func (*Vec2) SetByName 

func (v *Vec2) SetByName(name string, value float32)

SetByName sets this vector component value by its case insensitive name: "x" or "y".

func (*Vec2) SetCeil 

func (v *Vec2) SetCeil()

SetCeil applies mat32.Ceil() to each of this vector's components.

func (*Vec2) SetDim 

func (v *Vec2) SetDim(dim Dims, value float32)

SetDim sets this vector component value by its dimension index.

func (*Vec2) SetDiv 

func (v *Vec2) SetDiv(other Vec2)

SetDiv sets this to division by other vector (i.e., /= or divide-equals).

func (*Vec2) SetDivDim 

func (a *Vec2) SetDivDim(d Dims, val float32)

func (*Vec2) SetDivScalar 

func (v *Vec2) SetDivScalar(s float32)

SetDivScalar sets this to division by scalar.

func (*Vec2) SetFixed 

func (a *Vec2) SetFixed(pt fixed.Point26_6)

func (*Vec2) SetFloor 

func (v *Vec2) SetFloor()

SetFloor applies mat32.Floor() to each of this vector's components.

func (*Vec2) SetFromVec2i 

func (v *Vec2) SetFromVec2i(vi Vec2i)

SetFromVec2i sets from a Vec2i (int32) vector.

func (*Vec2) SetLength 

func (v *Vec2) SetLength(l float32)

SetLength sets this vector to have the specified length.

func (*Vec2) SetLerp 

func (v *Vec2) SetLerp(other Vec2, alpha float32)

Lerp sets each of this vector's components to the linear interpolated value of alpha between ifself and the corresponding other component.

func (*Vec2) SetMax 

func (v *Vec2) SetMax(other Vec2)

SetMax sets this vector components to the maximum value of itself and other vector.

func (*Vec2) SetMaxDim 

func (a *Vec2) SetMaxDim(d Dims, val float32)

set the value along a given dimension to max of current val and new val

func (*Vec2) SetMaxScalar 

func (v *Vec2) SetMaxScalar(val float32)

SetMaxScalar sets to max of current value and scalar val

func (*Vec2) SetMin 

func (v *Vec2) SetMin(other Vec2)

SetMin sets this vector components to the minimum values of itself and other vector.

func (*Vec2) SetMinDim 

func (a *Vec2) SetMinDim(d Dims, val float32)

set the value along a given dimension to min of current val and new val

func (*Vec2) SetMinPos 

func (v *Vec2) SetMinPos(b Vec2)

SetMinPos set to minpos of current vs. other

func (*Vec2) SetMinPosDim 

func (a *Vec2) SetMinPosDim(d Dims, val float32)

set the value along a given dimension to min of current val and new val

func (*Vec2) SetMinPosScalar 

func (v *Vec2) SetMinPosScalar(val float32)

SetMinPosScalar sets to minpos of current value and scalar val

func (*Vec2) SetMinScalar 

func (v *Vec2) SetMinScalar(val float32)

SetMinScalar sets to min of current value and scalar val

func (*Vec2) SetMul 

func (v *Vec2) SetMul(other Vec2)

SetMul sets this to multiplication with other vector (i.e., *= or times-equals).

func (*Vec2) SetMulDim 

func (a *Vec2) SetMulDim(d Dims, val float32)

func (*Vec2) SetMulScalar 

func (v *Vec2) SetMulScalar(s float32)

SetMulScalar sets this to multiplication by scalar.

func (*Vec2) SetNegate 

func (v *Vec2) SetNegate()

SetNegate negates each of this vector's components.

func (*Vec2) SetNormal 

func (v *Vec2) SetNormal()

SetNormal normalizes this vector so its length will be 1.

func (*Vec2) SetPoint 

func (a *Vec2) SetPoint(pt image.Point)

func (*Vec2) SetRound 

func (v *Vec2) SetRound()

SetRound rounds each of this vector's components.

func (*Vec2) SetScalar 

func (v *Vec2) SetScalar(s float32)

SetScalar sets all vector components to same scalar value.

func (*Vec2) SetSub 

func (v *Vec2) SetSub(other Vec2)

SetSub sets this to subtraction with other vector (i.e., -= or minus-equals).

func (*Vec2) SetSubDim 

func (a *Vec2) SetSubDim(d Dims, val float32)

func (*Vec2) SetSubScalar 

func (v *Vec2) SetSubScalar(s float32)

SetSubScalar sets this to subtraction of scalar.

func (*Vec2) SetZero 

func (v *Vec2) SetZero()

SetZero sets this vector X and Y components to be zero.

func (Vec2) String 

func (a Vec2) String() string

func (Vec2) Sub 

func (v Vec2) Sub(other Vec2) Vec2

Sub subtracts other vector from this one and returns result in new vector.

func (Vec2) SubScalar 

func (v Vec2) SubScalar(s float32) Vec2

SubScalar subtracts scalar s from each component of this vector and returns new vector.

func (Vec2) ToArray 

func (v Vec2) ToArray(array []float32, offset int)

ToArray copies this vector's components to array starting at offset.

func (Vec2) ToPoint 

func (a Vec2) ToPoint() image.Point

func (Vec2) ToPointCeil 

func (a Vec2) ToPointCeil() image.Point

func (Vec2) ToPointFloor 

func (a Vec2) ToPointFloor() image.Point

func (Vec2) ToPointRound 

func (a Vec2) ToPointRound() image.Point

func (Vec2) WindowToNDC 

func (v Vec2) WindowToNDC(size, off Vec2, flipY bool) Vec3

WindowToNDC converts window (pixel) coordinates to normalized display coordinates (NDC), using given window size parameters. The Z depth coordinate (0-1) must be set manually or by reading from framebuffer flipY if true means flip the Y axis (top = 0 for windows vs. bottom = 0 for 3D coords)

type Vec2i 

type Vec2i struct {
	X int32
	Y int32
}

Vec2i is a 2D vector/point with X and Y integer32 components.

func NewVec2i 

func NewVec2i(x, y int32) Vec2i

NewVec2i returns a new Vec2i with the specified x and y components.

func NewVec2iScalar 

func NewVec2iScalar(s int32) Vec2i

NewVec2iScalar returns a new Vec2i with all components set to scalar.

func (Vec2i) Add 

func (v Vec2i) Add(other Vec2i) Vec2i

Add adds other vector to this one and returns result in a new vector.

func (Vec2i) AddScalar 

func (v Vec2i) AddScalar(s int32) Vec2i

AddScalar adds scalar s to each component of this vector and returns new vector.

func (*Vec2i) Clamp 

func (v *Vec2i) Clamp(min, max Vec2i)

Clamp sets this vector components to be no less than the corresponding components of min and not greater than the corresponding component of max. Assumes min < max, if this assumption isn't true it will not operate correctly.

func (*Vec2i) ClampScalar 

func (v *Vec2i) ClampScalar(minVal, maxVal int32)

ClampScalar sets this vector components to be no less than minVal and not greater than maxVal.

func (Vec2i) Dim 

func (v Vec2i) Dim(dim Dims) int32

Dim returns this vector component

func (Vec2i) Div 

func (v Vec2i) Div(other Vec2i) Vec2i

Div divides each component of this vector by the corresponding one from other vector and returns resulting vector.

func (Vec2i) DivScalar 

func (v Vec2i) DivScalar(scalar int32) Vec2i

DivScalar divides each component of this vector by the scalar s and returns resulting vector. If scalar is zero, returns zero.

func (*Vec2i) FromArray 

func (v *Vec2i) FromArray(array []int32, offset int)

FromArray sets this vector's components from the specified array and offset.

func (Vec2i) IsEqual 

func (v Vec2i) IsEqual(other Vec2i) bool

IsEqual returns if this vector is equal to other.

func (Vec2i) IsNil 

func (v Vec2i) IsNil() bool

IsNil returns true if all values are 0 (uninitialized).

func (Vec2i) Max 

func (v Vec2i) Max(other Vec2i) Vec2i

Max returns max of this vector components vs. other vector.

func (Vec2i) Min 

func (v Vec2i) Min(other Vec2i) Vec2i

Min returns min of this vector components vs. other vector.

func (Vec2i) Mul 

func (v Vec2i) Mul(other Vec2i) Vec2i

Mul multiplies each component of this vector by the corresponding one from other and returns resulting vector.

func (Vec2i) MulScalar 

func (v Vec2i) MulScalar(s int32) Vec2i

MulScalar multiplies each component of this vector by the scalar s and returns resulting vector.

func (Vec2i) Negate 

func (v Vec2i) Negate() Vec2i

Negate returns vector with each component negated.

func (*Vec2i) Set 

func (v *Vec2i) Set(x, y int32)

Set sets this vector X and Y components.

func (*Vec2i) SetAdd 

func (v *Vec2i) SetAdd(other Vec2i)

SetAdd sets this to addition with other vector (i.e., += or plus-equals).

func (*Vec2i) SetAddScalar 

func (v *Vec2i) SetAddScalar(s int32)

SetAddScalar sets this to addition with scalar.

func (*Vec2i) SetByName 

func (v *Vec2i) SetByName(name string, value int32)

SetByName sets this vector component value by its case insensitive name: "x" or "y".

func (*Vec2i) SetDim 

func (v *Vec2i) SetDim(dim Dims, value int32)

SetDim sets this vector component value by its dimension index

func (*Vec2i) SetDiv 

func (v *Vec2i) SetDiv(other Vec2i)

SetDiv sets this to division by other vector (i.e., /= or divide-equals).

func (*Vec2i) SetDivScalar 

func (v *Vec2i) SetDivScalar(s int32)

SetDivScalar sets this to division by scalar.

func (*Vec2i) SetFromVec2 

func (v *Vec2i) SetFromVec2(vf Vec2)

SetFromVec2 sets from a Vec2 (float32) vector.

func (*Vec2i) SetMax 

func (v *Vec2i) SetMax(other Vec2i)

SetMax sets this vector components to the maximum value of itself and other vector.

func (*Vec2i) SetMin 

func (v *Vec2i) SetMin(other Vec2i)

SetMin sets this vector components to the minimum values of itself and other vector.

func (*Vec2i) SetMul 

func (v *Vec2i) SetMul(other Vec2i)

SetMul sets this to multiplication with other vector (i.e., *= or times-equals).

func (*Vec2i) SetMulScalar 

func (v *Vec2i) SetMulScalar(s int32)

SetMulScalar sets this to multiplication by scalar.

func (*Vec2i) SetNegate 

func (v *Vec2i) SetNegate()

SetNegate negates each of this vector's components.

func (*Vec2i) SetScalar 

func (v *Vec2i) SetScalar(s int32)

SetScalar sets all vector components to same scalar value.

func (*Vec2i) SetSub 

func (v *Vec2i) SetSub(other Vec2i)

SetSub sets this to subtraction with other vector (i.e., -= or minus-equals).

func (*Vec2i) SetSubScalar 

func (v *Vec2i) SetSubScalar(s int32)

SetSubScalar sets this to subtraction of scalar.

func (*Vec2i) SetZero 

func (v *Vec2i) SetZero()

SetZero sets this vector X and Y components to be zero.

func (Vec2i) Sub 

func (v Vec2i) Sub(other Vec2i) Vec2i

Sub subtracts other vector from this one and returns result in new vector.

func (Vec2i) SubScalar 

func (v Vec2i) SubScalar(s int32) Vec2i

SubScalar subtracts scalar s from each component of this vector and returns new vector.

func (Vec2i) ToArray 

func (v Vec2i) ToArray(array []int32, offset int)

ToArray copies this vector's components to array starting at offset.

type Vec3 

type Vec3 struct {
	X float32
	Y float32
	Z float32
}

Vec3 is a 3D vector/point with X, Y and Z components.

func BarycoordFromPoint 

func BarycoordFromPoint(point, a, b, c Vec3) Vec3

BarycoordFromPoint returns the barycentric coordinates for the specified point.

func NewEulerAnglesFromMatrix 

func NewEulerAnglesFromMatrix(m *Mat4) Vec3

NewEulerAnglesFromMatrix returns a Vec3 with components as the Euler angles from the specified pure rotation matrix.

func NewVec3 

func NewVec3(x, y, z float32) Vec3

NewVec3 returns a new Vec3 with the specified x, y and y components.

func NewVec3Color added in v1.0.11 

func NewVec3Color(clr color.Color) Vec3

NewVec3Color returns a Vec3 from Go standard color.Color (R,G,B components only)

func NewVec3FromVec4 

func NewVec3FromVec4(v Vec4) Vec3

NewVec3FromVec4 returns a new Vec3 from a Vec4

func NewVec3Scalar 

func NewVec3Scalar(s float32) Vec3

NewVec3Scalar returns a new Vec3 with all components set to scalar.

func Normal 

func Normal(a, b, c Vec3) Vec3

Normal returns the triangle's normal.

func (Vec3) Abs 

func (v Vec3) Abs() Vec3

Abs returns vector with Abs of each component.

func (Vec3) Add 

func (v Vec3) Add(other Vec3) Vec3

Add adds other vector to this one and returns result in a new vector.

func (Vec3) AddScalar 

func (v Vec3) AddScalar(s float32) Vec3

AddScalar adds scalar s to each component of this vector and returns new vector.

func (*Vec3) AlmostEqual 

func (v *Vec3) AlmostEqual(other Vec3, tol float32) bool

AlmostEqual returns whether the vector is almost equal to another vector within the specified tolerance.

func (Vec3) AngleTo 

func (v Vec3) AngleTo(other Vec3) float32

AngleTo returns the angle between this vector and other. Returns angles in range of -PI to PI (not 0 to 2 PI).

func (Vec3) Ceil 

func (v Vec3) Ceil() Vec3

Ceil returns vector with mat32.Ceil() applied to each of this vector's components.

func (*Vec3) Clamp 

func (v *Vec3) Clamp(min, max Vec3)

Clamp sets this vector components to be no less than the corresponding components of min and not greater than the corresponding component of max. Assumes min < max, if this assumption isn't true it will not operate correctly.

func (*Vec3) ClampScalar 

func (v *Vec3) ClampScalar(minVal, maxVal float32)

ClampScalar sets this vector components to be no less than minVal and not greater than maxVal.

func (Vec3) CosTo 

func (v Vec3) CosTo(other Vec3) float32

CosTo returns the cosine (normalized dot product) between this vector and other.

func (Vec3) Cross 

func (v Vec3) Cross(other Vec3) Vec3

Cross returns the cross product of this vector with other.

func (Vec3) Dim 

func (v Vec3) Dim(dim Dims) float32

Dim returns this vector component

func (Vec3) DistTo 

func (v Vec3) DistTo(other Vec3) float32

DistTo returns the distance of this point to other.

func (Vec3) DistToSquared 

func (v Vec3) DistToSquared(other Vec3) float32

DistToSquared returns the distance squared of this point to other.

func (Vec3) Div 

func (v Vec3) Div(other Vec3) Vec3

Div divides each component of this vector by the corresponding one from other vector and returns resulting vector.

func (Vec3) DivScalar 

func (v Vec3) DivScalar(scalar float32) Vec3

DivScalar divides each component of this vector by the scalar s and returns resulting vector. If scalar is zero, returns zero.

func (Vec3) Dot 

func (v Vec3) Dot(other Vec3) float32

Dot returns the dot product of this vector with other.

func (Vec3) Floor 

func (v Vec3) Floor() Vec3

Floor returns vector with mat32.Floor() applied to each of this vector's components.

func (*Vec3) FromArray 

func (v *Vec3) FromArray(array []float32, offset int)

FromArray sets this vector's components from the specified array and offset.

func (*Vec3) GenGoNew 

func (v *Vec3) GenGoNew() string

GenGoNew returns code to create new

func (*Vec3) GenGoSet 

func (v *Vec3) GenGoSet(path string) string

GenGoSet returns code to set values in object at given path (var.member etc)

func (Vec3) IsEqual 

func (v Vec3) IsEqual(other Vec3) bool

IsEqual returns if this vector is equal to other.

func (Vec3) IsNil 

func (v Vec3) IsNil() bool

IsNil returns true if all values are 0 (uninitialized).

func (Vec3) Length 

func (v Vec3) Length() float32

Length returns the length of this vector.

func (Vec3) LengthSq 

func (v Vec3) LengthSq() float32

LengthSq returns the length squared of this vector. LengthSq can be used to compare vectors' lengths without the need to perform a square root.

func (Vec3) Lerp 

func (v Vec3) Lerp(other Vec3, alpha float32) Vec3

Lerp returns vector with each components as the linear interpolated value of alpha between itself and the corresponding other component.

func (Vec3) MVProjToNDC 

func (v Vec3) MVProjToNDC(m *Mat4, w float32) Vec3

MVProjToNDC project given vector through given MVP model-view-projection Mat4 and do perspective divide to return normalized display coordinates (NDC). w is value for 4th coordinate -- use 1 for positions, 0 for normals.

func (Vec3) Max 

func (v Vec3) Max(other Vec3) Vec3

Max returns max of this vector components vs. other vector.

func (Vec3) Min 

func (v Vec3) Min(other Vec3) Vec3

Min returns min of this vector components vs. other vector.

func (Vec3) Mul 

func (v Vec3) Mul(other Vec3) Vec3

Mul multiplies each component of this vector by the corresponding one from other and returns resulting vector.

func (Vec3) MulMat3 

func (v Vec3) MulMat3(m *Mat3) Vec3

MulMat3 returns vector multiplied by specified 3x3 matrix.

func (Vec3) MulMat4 

func (v Vec3) MulMat4(m *Mat4) Vec3

MulMat4 returns vector multiplied by specified 4x4 matrix.

func (Vec3) MulMat4AsVec4 

func (v Vec3) MulMat4AsVec4(m *Mat4, w float32) Vec3

MulMat4AsVec4 returns 3-dim vector multiplied by specified 4x4 matrix using a 4-dim vector with given 4th dimensional value, then reduced back to a 3-dimensional vector. This is somehow different from just straight MulMat4 on the 3-dim vector. Use 0 for normals and 1 for positions as the 4th dim to set.

func (Vec3) MulProjection 

func (v Vec3) MulProjection(m *Mat4) Vec3

MulProjection returns vector multiplied by the projection matrix m

func (Vec3) MulQuat 

func (v Vec3) MulQuat(q Quat) Vec3

MulQuat returns vector multiplied by specified quaternion and then by the quaternion inverse. It basically applies the rotation encoded in the quaternion to this vector.

func (Vec3) MulScalar 

func (v Vec3) MulScalar(s float32) Vec3

MulScalar multiplies each component of this vector by the scalar s and returns resulting vector.

func (Vec3) NDCToWindow 

func (v Vec3) NDCToWindow(size, off Vec2, near, far float32, flipY bool) Vec3

NDCToWindow converts normalized display coordinates (NDC) to window (pixel) coordinates, using given window size parameters. near, far are 0, 1 by default (glDepthRange defaults). flipY if true means flip the Y axis (top = 0 for windows vs. bottom = 0 for 3D coords)

func (Vec3) Negate 

func (v Vec3) Negate() Vec3

Negate returns vector with each component negated.

func (Vec3) Normal 

func (v Vec3) Normal() Vec3

Normal returns this vector divided by its length

func (*Vec3) Normalize 

func (v *Vec3) Normalize()

Normalize normalizes this vector so its length will be 1.

func (*Vec3) ProjectOnPlane 

func (v *Vec3) ProjectOnPlane(planeNormal Vec3) Vec3

ProjectOnPlane returns vector projected on the plane specified by normal vector.

func (*Vec3) ProjectOnVector 

func (v *Vec3) ProjectOnVector(other Vec3) Vec3

ProjectOnVector returns vector projected on other vector.

func (*Vec3) RandomTangents 

func (v *Vec3) RandomTangents() (Vec3, Vec3)

RandomTangents computes and returns two arbitrary tangents to the vector.

func (*Vec3) Reflect 

func (v *Vec3) Reflect(normal Vec3) Vec3

Reflect returns vector reflected relative to the normal vector (assumed to be already normalized).

func (Vec3) RotateAxisAngle 

func (v Vec3) RotateAxisAngle(axis Vec3, angle float32) Vec3

RotateAxisAngle returns vector rotated around axis by angle.

func (Vec3) Round 

func (v Vec3) Round() Vec3

Round returns vector with mat32.Round() applied to each of this vector's components.

func (Vec3) SRGBFromLinear added in v1.0.12 

func (v Vec3) SRGBFromLinear() Vec3

SRGBFromLinear returns an SRGB color space value from a linear source

func (Vec3) SRGBToLinear added in v1.0.12 

func (v Vec3) SRGBToLinear() Vec3

SRGBToLinear returns a linear color space value from a SRGB source

func (*Vec3) Set 

func (v *Vec3) Set(x, y, z float32)

Set sets this vector X, Y and Z components.

func (*Vec3) SetAdd 

func (v *Vec3) SetAdd(other Vec3)

SetAdd sets this to addition with other vector (i.e., += or plus-equals).

func (*Vec3) SetAddScalar 

func (v *Vec3) SetAddScalar(s float32)

SetAddScalar sets this to addition with scalar.

func (*Vec3) SetByName 

func (v *Vec3) SetByName(name string, value float32)

SetByName sets this vector component value by its case insensitive name: "x", "y", or "z".

func (*Vec3) SetCeil 

func (v *Vec3) SetCeil()

SetCeil applies mat32.Ceil() to each of this vector's components.

func (*Vec3) SetColor added in v1.0.11 

func (v *Vec3) SetColor(clr color.Color)

SetColor sets from Go standard color.Color (R,G,B components only)

func (*Vec3) SetDim 

func (v *Vec3) SetDim(dim Dims, value float32)

SetDim sets this vector component value by dimension index.

func (*Vec3) SetDiv 

func (v *Vec3) SetDiv(other Vec3)

SetDiv sets this to division by other vector (i.e., /= or divide-equals).

func (*Vec3) SetDivScalar 

func (v *Vec3) SetDivScalar(s float32)

SetDivScalar sets this to division by scalar.

func (*Vec3) SetEulerAnglesFromMatrix 

func (v *Vec3) SetEulerAnglesFromMatrix(m *Mat4)

SetEulerAnglesFromMatrix sets this vector components to the Euler angles from the specified pure rotation matrix.

func (*Vec3) SetEulerAnglesFromQuat 

func (v *Vec3) SetEulerAnglesFromQuat(q Quat)

SetEulerAnglesFromQuat sets this vector components to the Euler angles from the specified quaternion.

func (*Vec3) SetFloor 

func (v *Vec3) SetFloor()

SetFloor applies mat32.Floor() to each of this vector's components.

func (*Vec3) SetFromMatrixCol 

func (v *Vec3) SetFromMatrixCol(index int, m *Mat4)

SetFromMatrixCol set this vector with the column at index of the m matrix.

func (*Vec3) SetFromMatrixPos 

func (v *Vec3) SetFromMatrixPos(m *Mat4)

SetFromMatrixPos set this vector from the translation coordinates in the specified transformation matrix.

func (*Vec3) SetFromVec3i 

func (v *Vec3) SetFromVec3i(vi Vec3i)

SetFromVec3i sets from a Vec3i (int32) vector.

func (*Vec3) SetFromVec4 

func (v *Vec3) SetFromVec4(other Vec4)

SetFromVec4 sets this vector from a Vec4

func (*Vec3) SetLength 

func (v *Vec3) SetLength(l float32)

SetLength sets this vector to have the specified length. If the current length is zero, does nothing.

func (*Vec3) SetLerp 

func (v *Vec3) SetLerp(other Vec3, alpha float32)

SetLerp sets each of this vector's components to the linear interpolated value of alpha between itself and the corresponding other component.

func (*Vec3) SetMax 

func (v *Vec3) SetMax(other Vec3)

SetMax sets this vector components to the maximum value of itself and other vector.

func (*Vec3) SetMin 

func (v *Vec3) SetMin(other Vec3)

SetMin sets this vector components to the minimum values of itself and other vector.

func (*Vec3) SetMul 

func (v *Vec3) SetMul(other Vec3)

SetMul sets this to multiplication with other vector (i.e., *= or times-equals).

func (*Vec3) SetMulMat3 

func (v *Vec3) SetMulMat3(m *Mat3)

SetMulMat3 sets vector multiplied by specified 3x3 matrix.

func (*Vec3) SetMulMat4 

func (v *Vec3) SetMulMat4(m *Mat4)

SetMulMat4 sets vector multiplied by specified 4x4 matrix.

func (*Vec3) SetMulQuat 

func (v *Vec3) SetMulQuat(q Quat)

SetMulQuat multiplies vector by specified quaternion and then by the quaternion inverse. It basically applies the rotation encoded in the quaternion to this vector.

func (*Vec3) SetMulScalar 

func (v *Vec3) SetMulScalar(s float32)

SetMulScalar sets this to multiplication by scalar.

func (*Vec3) SetNegate 

func (v *Vec3) SetNegate()

SetNegate negates each of this vector's components.

func (*Vec3) SetNormal 

func (v *Vec3) SetNormal()

SetNormal normalizes this vector so its length will be 1.

func (*Vec3) SetRotateAxisAngle 

func (v *Vec3) SetRotateAxisAngle(axis Vec3, angle float32)

SetRotateAxisAngle sets vector rotated around axis by angle.

func (*Vec3) SetRound 

func (v *Vec3) SetRound()

SetRound rounds each of this vector's components.

func (*Vec3) SetScalar 

func (v *Vec3) SetScalar(s float32)

SetScalar sets all vector X, Y and Z components to same scalar value.

func (*Vec3) SetSub 

func (v *Vec3) SetSub(other Vec3)

SetSub sets this to subtraction with other vector (i.e., -= or minus-equals).

func (*Vec3) SetSubScalar 

func (v *Vec3) SetSubScalar(s float32)

SetSubScalar sets this to subtraction of scalar.

func (*Vec3) SetZero 

func (v *Vec3) SetZero()

SetZero sets this vector X, Y and Z components to be zero.

func (Vec3) Sub 

func (v Vec3) Sub(other Vec3) Vec3

Sub subtracts other vector from this one and returns result in new vector.

func (Vec3) SubScalar 

func (v Vec3) SubScalar(s float32) Vec3

SubScalar subtracts scalar s from each component of this vector and returns new vector.

func (Vec3) ToArray 

func (v Vec3) ToArray(array []float32, offset int)

ToArray copies this vector's components to array starting at offset.

type Vec3i 

type Vec3i struct {
	X int32
	Y int32
	Z int32
}

Vec3i is a 3D vector/point with X, Y and Z int32 components.

func NewVec3i 

func NewVec3i(x, y, z int32) Vec3i

NewVec3i returns a new Vec3i with the specified x, y and y components.

func NewVec3iScalar 

func NewVec3iScalar(s int32) Vec3i

NewVec3iScalar returns a new Vec3 with all components set to scalar.

func (Vec3i) Add 

func (v Vec3i) Add(other Vec3i) Vec3i

Add adds other vector to this one and returns result in a new vector.

func (Vec3i) AddScalar 

func (v Vec3i) AddScalar(s int32) Vec3i

AddScalar adds scalar s to each component of this vector and returns new vector.

func (*Vec3i) Clamp 

func (v *Vec3i) Clamp(min, max Vec3i)

Clamp sets this vector components to be no less than the corresponding components of min and not greater than the corresponding component of max. Assumes min < max, if this assumption isn't true it will not operate correctly.

func (*Vec3i) ClampScalar 

func (v *Vec3i) ClampScalar(minVal, maxVal int32)

ClampScalar sets this vector components to be no less than minVal and not greater than maxVal.

func (Vec3i) Dim 

func (v Vec3i) Dim(dim Dims) int32

Dim returns this vector component

func (Vec3i) Div 

func (v Vec3i) Div(other Vec3i) Vec3i

Div divides each component of this vector by the corresponding one from other vector and returns resulting vector.

func (Vec3i) DivScalar 

func (v Vec3i) DivScalar(scalar int32) Vec3i

DivScalar divides each component of this vector by the scalar s and returns resulting vector. If scalar is zero, returns zero.

func (*Vec3i) FromArray 

func (v *Vec3i) FromArray(array []int32, offset int)

FromArray sets this vector's components from the specified array and offset

func (Vec3i) IsEqual 

func (v Vec3i) IsEqual(other Vec3i) bool

IsEqual returns if this vector is equal to other.

func (Vec3i) IsNil 

func (v Vec3i) IsNil() bool

IsNil returns true if all values are 0 (uninitialized).

func (Vec3i) Max 

func (v Vec3i) Max(other Vec3i) Vec3i

Max returns max of this vector components vs. other vector.

func (Vec3i) Min 

func (v Vec3i) Min(other Vec3i) Vec3i

Min returns min of this vector components vs. other vector.

func (Vec3i) Mul 

func (v Vec3i) Mul(other Vec3i) Vec3i

Mul multiplies each component of this vector by the corresponding one from other and returns resulting vector.

func (Vec3i) MulScalar 

func (v Vec3i) MulScalar(s int32) Vec3i

MulScalar multiplies each component of this vector by the scalar s and returns resulting vector.

func (Vec3i) Negate 

func (v Vec3i) Negate() Vec3i

Negate returns vector with each component negated.

func (*Vec3i) Set 

func (v *Vec3i) Set(x, y, z int32)

Set sets this vector X, Y and Z components.

func (*Vec3i) SetAdd 

func (v *Vec3i) SetAdd(other Vec3i)

SetAdd sets this to addition with other vector (i.e., += or plus-equals).

func (*Vec3i) SetAddScalar 

func (v *Vec3i) SetAddScalar(s int32)

SetAddScalar sets this to addition with scalar.

func (*Vec3i) SetByName 

func (v *Vec3i) SetByName(name string, value int32)

SetByName sets this vector component value by its case insensitive name: "x", "y", or "z".

func (*Vec3i) SetDim 

func (v *Vec3i) SetDim(dim Dims, value int32)

SetDim sets this vector component value by dimension index.

func (*Vec3i) SetDiv 

func (v *Vec3i) SetDiv(other Vec3i)

SetDiv sets this to division by other vector (i.e., /= or divide-equals).

func (*Vec3i) SetDivScalar 

func (v *Vec3i) SetDivScalar(s int32)

SetDivScalar sets this to division by scalar.

func (*Vec3i) SetFromVec3 

func (v *Vec3i) SetFromVec3(vf Vec3)

SetFromVec3 sets from a Vec3 (float32) vector.

func (*Vec3i) SetMax 

func (v *Vec3i) SetMax(other Vec3i)

SetMax sets this vector components to the maximum value of itself and other vector.

func (*Vec3i) SetMin 

func (v *Vec3i) SetMin(other Vec3i)

SetMin sets this vector components to the minimum values of itself and other vector.

func (*Vec3i) SetMul 

func (v *Vec3i) SetMul(other Vec3i)

SetMul sets this to multiplication with other vector (i.e., *= or times-equals).

func (*Vec3i) SetMulScalar 

func (v *Vec3i) SetMulScalar(s int32)

SetMulScalar sets this to multiplication by scalar.

func (*Vec3i) SetNegate 

func (v *Vec3i) SetNegate()

SetNegate negates each of this vector's components.

func (*Vec3i) SetScalar 

func (v *Vec3i) SetScalar(s int32)

SetScalar sets all vector X, Y and Z components to same scalar value.

func (*Vec3i) SetSub 

func (v *Vec3i) SetSub(other Vec3i)

SetSub sets this to subtraction with other vector (i.e., -= or minus-equals).

func (*Vec3i) SetSubScalar 

func (v *Vec3i) SetSubScalar(s int32)

SetSubScalar sets this to subtraction of scalar.

func (*Vec3i) SetZero 

func (v *Vec3i) SetZero()

SetZero sets this vector X, Y and Z components to be zero.

func (Vec3i) Sub 

func (v Vec3i) Sub(other Vec3i) Vec3i

Sub subtracts other vector from this one and returns result in new vector.

func (Vec3i) SubScalar 

func (v Vec3i) SubScalar(s int32) Vec3i

SubScalar subtracts scalar s from each component of this vector and returns new vector.

func (Vec3i) ToArray 

func (v Vec3i) ToArray(array []int32, offset int)

ToArray copies this vector's components to array starting at offset.

type Vec4 

type Vec4 struct {
	X float32
	Y float32
	Z float32
	W float32
}

Vec4 is a vector/point in homogeneous coordinates with X, Y, Z and W components.

func NewVec4 

func NewVec4(x, y, z, w float32) Vec4

NewVec4 returns a new Vec4 with the specified components.

func NewVec4Color added in v1.0.11 

func NewVec4Color(clr color.Color) Vec4

NewVec4Color returns a Vec4 from Go standard color.Color (full R,G,B,A components)

func NewVec4FromVec3 

func NewVec4FromVec3(v Vec3, w float32) Vec4

NewVec4FromVec3 returns a new Vec4 from a Vec3 and W

func NewVec4Scalar 

func NewVec4Scalar(s float32) Vec4

NewVec4Scalar returns a new Vec4 with all components set to scalar.

func (Vec4) Add 

func (v Vec4) Add(other Vec4) Vec4

Add adds other vector to this one and returns result in a new vector.

func (Vec4) AddScalar 

func (v Vec4) AddScalar(s float32) Vec4

AddScalar adds scalar s to each component of this vector and returns new vector.

func (*Vec4) AlmostEqual 

func (v *Vec4) AlmostEqual(other Vec4, tol float32) bool

AlmostEqual returns whether the vector is almost equal to another vector within the specified tolerance.

func (Vec4) Ceil 

func (v Vec4) Ceil() Vec4

Ceil returns vector with mat32.Ceil() applied to each of this vector's components.

func (*Vec4) Clamp 

func (v *Vec4) Clamp(min, max Vec4)

Clamp sets this vector components to be no less than the corresponding components of min and not greater than the corresponding component of max. Assumes min < max, if this assumption isn't true it will not operate correctly.

func (*Vec4) ClampScalar 

func (v *Vec4) ClampScalar(minVal, maxVal float32)

ClampScalar sets this vector components to be no less than minVal and not greater than maxVal.

func (Vec4) Dim 

func (v Vec4) Dim(dim Dims) float32

Dim returns this vector component.

func (Vec4) Div 

func (v Vec4) Div(other Vec4) Vec4

Div divides each component of this vector by the corresponding one from other vector and returns resulting vector.

func (Vec4) DivScalar 

func (v Vec4) DivScalar(scalar float32) Vec4

DivScalar divides each component of this vector by the scalar s and returns resulting vector. If scalar is zero, returns zero.

func (Vec4) Dot 

func (v Vec4) Dot(other Vec4) float32

Dot returns the dot product of this vector with other.

func (Vec4) Floor 

func (v Vec4) Floor() Vec4

Floor returns vector with mat32.Floor() applied to each of this vector's components.

func (*Vec4) FromArray 

func (v *Vec4) FromArray(array []float32, offset int)

FromArray sets this vector's components from the specified array and offset

func (*Vec4) IsEqual 

func (v *Vec4) IsEqual(other Vec4) bool

IsEqual returns if this vector is equal to other.

func (Vec4) IsNil 

func (v Vec4) IsNil() bool

IsNil returns true if all values are 0 (uninitialized).

func (Vec4) Length 

func (v Vec4) Length() float32

Length returns the length of this vector.

func (Vec4) LengthSq 

func (v Vec4) LengthSq() float32

LengthSq returns the length squared of this vector. LengthSq can be used to compare vectors' lengths without the need to perform a square root.

func (Vec4) Lerp 

func (v Vec4) Lerp(other Vec4, alpha float32) Vec4

Lerp returns vector with each components as the linear interpolated value of alpha between itself and the corresponding other component.

func (Vec4) Max 

func (v Vec4) Max(other Vec4) Vec4

Max returns max of this vector components vs. other vector.

func (Vec4) Min 

func (v Vec4) Min(other Vec4) Vec4

Min returns min of this vector components vs. other vector.

func (Vec4) Mul 

func (v Vec4) Mul(other Vec4) Vec4

Mul multiplies each component of this vector by the corresponding one from other and returns resulting vector.

func (Vec4) MulMat4 

func (v Vec4) MulMat4(m *Mat4) Vec4

MulMat4 returns vector multiplied by specified 4x4 matrix.

func (Vec4) MulScalar 

func (v Vec4) MulScalar(s float32) Vec4

MulScalar multiplies each component of this vector by the scalar s and returns resulting vector.

func (Vec4) Negate 

func (v Vec4) Negate() Vec4

Negate returns vector with each component negated.

func (Vec4) Normal 

func (v Vec4) Normal() Vec4

Normal returns this vector divided by its length

func (*Vec4) Normalize 

func (v *Vec4) Normalize()

Normalize normalizes this vector so its length will be 1.

func (Vec4) PerspDiv 

func (v Vec4) PerspDiv() Vec3

PerspDiv returns the 3-vector of normalized display coordinates (NDC) from given 4-vector By dividing by the 4th W component

func (Vec4) Round 

func (v Vec4) Round() Vec4

Round returns vector with mat32.Round() applied to each of this vector's components.

func (Vec4) SRGBFromLinear added in v1.0.12 

func (v Vec4) SRGBFromLinear() Vec4

SRGBFromLinear returns an SRGB color space value from a linear source

func (Vec4) SRGBToLinear added in v1.0.12 

func (v Vec4) SRGBToLinear() Vec4

SRGBToLinear returns a linear color space value from a SRGB source

func (*Vec4) Set 

func (v *Vec4) Set(x, y, z, w float32)

Set sets this vector X, Y, Z and W components.

func (*Vec4) SetAdd 

func (v *Vec4) SetAdd(other Vec4)

SetAdd sets this to addition with other vector (i.e., += or plus-equals).

func (*Vec4) SetAddScalar 

func (v *Vec4) SetAddScalar(s float32)

SetAddScalar sets this to addition with scalar.

func (*Vec4) SetAxisAngleFromQuat 

func (v *Vec4) SetAxisAngleFromQuat(q Quat)

SetAxisAngleFromQuat set this vector to be the axis (x, y, z) and angle (w) of a rotation specified the quaternion q. Assumes q is normalized.

func (*Vec4) SetAxisFromRotationMatrix 

func (v *Vec4) SetAxisFromRotationMatrix(m *Mat4)

SetAxisFromRotationMatrix sets this vector to be the axis (x, y, z) and angle (w) of a rotation specified the matrix m. Assumes the upper 3x3 of m is a pure rotation matrix (i.e, unscaled).

func (*Vec4) SetByName 

func (v *Vec4) SetByName(name string, value float32)

SetByName sets this vector component value by its case insensitive name: "x", "y", "z" or "w".

func (*Vec4) SetCeil 

func (v *Vec4) SetCeil()

SetCeil applies mat32.Ceil() to each of this vector's components.

func (*Vec4) SetColor added in v1.0.11 

func (v *Vec4) SetColor(clr color.Color)

SetColor sets a Vec4 from Go standard color.Color

func (*Vec4) SetDim 

func (v *Vec4) SetDim(dim Dims, value float32)

SetDim sets this vector component value by dimension index.

func (*Vec4) SetDiv 

func (v *Vec4) SetDiv(other Vec4)

SetDiv sets this to division by other vector (i.e., /= or divide-equals).

func (*Vec4) SetDivScalar 

func (v *Vec4) SetDivScalar(s float32)

SetDivScalar sets this to division by scalar.

func (*Vec4) SetFloor 

func (v *Vec4) SetFloor()

SetFloor applies mat32.Floor() to each of this vector's components.

func (*Vec4) SetFromVec2 added in v1.0.14 

func (v *Vec4) SetFromVec2(other Vec2)

SetFromVec2 sets this vector from a Vec2 with 0,1 for Z,W

func (*Vec4) SetFromVec3 

func (v *Vec4) SetFromVec3(other Vec3, w float32)

SetFromVec3 sets this vector from a Vec3 and W

func (*Vec4) SetLength 

func (v *Vec4) SetLength(l float32)

SetLength sets this vector to have the specified length. If the current length is zero, does nothing.

func (*Vec4) SetLerp 

func (v *Vec4) SetLerp(other *Vec4, alpha float32)

SetLerp sets each of this vector's components to the linear interpolated value of alpha between ifself and the corresponding other component.

func (*Vec4) SetMax 

func (v *Vec4) SetMax(other Vec4)

SetMax sets this vector components to the maximum value of itself and other vector.

func (*Vec4) SetMin 

func (v *Vec4) SetMin(other Vec4)

SetMin sets this vector components to the minimum values of itself and other vector.

func (*Vec4) SetMul 

func (v *Vec4) SetMul(other Vec4)

SetMul sets this to multiplication with other vector (i.e., *= or times-equals).

func (*Vec4) SetMulScalar 

func (v *Vec4) SetMulScalar(s float32)

SetMulScalar sets this to multiplication by scalar.

func (*Vec4) SetNegate 

func (v *Vec4) SetNegate()

SetNegate negates each of this vector's components.

func (*Vec4) SetNormal 

func (v *Vec4) SetNormal()

SetNormal normalizes this vector so its length will be 1.

func (*Vec4) SetRound 

func (v *Vec4) SetRound()

SetRound rounds each of this vector's components.

func (*Vec4) SetSub 

func (v *Vec4) SetSub(other Vec4)

SetSub sets this to subtraction with other vector (i.e., -= or minus-equals).

func (*Vec4) SetSubScalar 

func (v *Vec4) SetSubScalar(s float32)

SetSubScalar sets this to subtraction of scalar.

func (*Vec4) SetZero 

func (v *Vec4) SetZero()

SetZero sets this vector X, Y and Z components to be zero and W to be one.

func (Vec4) Sub 

func (v Vec4) Sub(other Vec4) Vec4

Sub subtracts other vector from this one and returns result in new vector.

func (Vec4) SubScalar 

func (v Vec4) SubScalar(s float32) Vec4

SubScalar subtracts scalar s from each component of this vector and returns new vector.

func (Vec4) ToArray 

func (v Vec4) ToArray(array []float32, offset int)

ToArray copies this vector's components to array starting at offset.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.