package f32
import "golang.org/x/mobile/exp/f32"
Package f32 implements some linear algebra and GL helpers for float32s.
Types defined in this package have methods implementing common mathematical operations. The common form for these functions is
func (dst *T) Op(lhs, rhs *T)
which reads in traditional mathematical notation as
dst = lhs op rhs.
It is safe to use the destination address as the left-hand side, that is, dst *= rhs is dst.Mul(dst, rhs).
WARNING
The interface to this package is not stable. It will change considerably. Only use functions that provide package documentation. Semantics are non-obvious. Be prepared for the package name to change.
Index ¶
- func Bytes(byteOrder binary.ByteOrder, values ...float32) []byte
- func Cos(x float32) float32
- func Sin(x float32) float32
- func Sqrt(x float32) float32
- func Tan(x float32) float32
- type Affine
- func (m *Affine) Eq(n *Affine, epsilon float32) bool
- func (m *Affine) Identity()
- func (m *Affine) Inverse(p *Affine)
- func (m *Affine) Mul(p, q *Affine)
- func (m *Affine) Rotate(p *Affine, radians float32)
- func (m *Affine) Scale(p *Affine, x, y float32)
- func (m Affine) String() string
- func (m *Affine) Translate(p *Affine, x, y float32)
- type Mat3
- func (m *Mat3) Eq(n *Mat3, epsilon float32) bool
- func (m *Mat3) Identity()
- func (m *Mat3) Mul(a, b *Mat3)
- func (m Mat3) String() string
- type Mat4
- func (m *Mat4) Eq(n *Mat4, epsilon float32) bool
- func (m *Mat4) Identity()
- func (m *Mat4) LookAt(eye, center, up *Vec3)
- func (m *Mat4) Mul(a, b *Mat4)
- func (m *Mat4) Perspective(fov Radian, aspect, near, far float32)
- func (m *Mat4) Rotate(p *Mat4, angle Radian, axis *Vec3)
- func (m *Mat4) Scale(p *Mat4, x, y, z float32)
- func (m Mat4) String() string
- func (m *Mat4) Translate(p *Mat4, x, y, z float32)
- type Radian
- type Vec3
- func (v *Vec3) Add(v0, v1 *Vec3)
- func (v *Vec3) Cross(v0, v1 *Vec3)
- func (v *Vec3) Dot(v1 *Vec3) float32
- func (v *Vec3) Mul(v0, v1 *Vec3)
- func (v *Vec3) Normalize()
- func (v Vec3) String() string
- func (v *Vec3) Sub(v0, v1 *Vec3)
- type Vec4
Functions ¶
func Bytes ¶
Bytes returns the byte representation of float32 values in the given byte order. byteOrder must be either binary.BigEndian or binary.LittleEndian.
func Cos ¶
func Sin ¶
func Sqrt ¶
func Tan ¶
Types ¶
type Affine ¶
type Affine [2]Vec3
An Affine is a 3x3 matrix of float32 values for which the bottom row is implicitly always equal to [0 0 1]. Elements are indexed first by row then column, i.e. m[row][column].
func (*Affine) Eq ¶
Eq reports whether each component of m is within epsilon of the same component in n.
func (*Affine) Identity ¶
func (m *Affine) Identity()
Identity sets m to be the identity transform.
func (*Affine) Inverse ¶
Inverse sets m to be the inverse of p.
func (*Affine) Mul ¶
Mul sets m to be p × q.
func (*Affine) Rotate ¶
Rotate sets m to a rotation in radians followed by p. It is equivalent to m.Mul(p, affineRotation).
func (*Affine) Scale ¶
Scale sets m to be a scale followed by p. It is equivalent to m.Mul(p, &Affine{{x,0,0}, {0,y,0}}).
func (Affine) String ¶
func (*Affine) Translate ¶
Translate sets m to be a translation followed by p. It is equivalent to m.Mul(p, &Affine{{1,0,x}, {0,1,y}}).
type Mat3 ¶
type Mat3 [3]Vec3
A Mat3 is a 3x3 matrix of float32 values. Elements are indexed first by row then column, i.e. m[row][column].
func (*Mat3) Eq ¶
func (*Mat3) Identity ¶
func (m *Mat3) Identity()
func (*Mat3) Mul ¶
Mul stores a × b in m.
func (Mat3) String ¶
type Mat4 ¶
type Mat4 [4]Vec4
A Mat4 is a 4x4 matrix of float32 values. Elements are indexed first by row then column, i.e. m[row][column].
func (*Mat4) Eq ¶
func (*Mat4) Identity ¶
func (m *Mat4) Identity()
func (*Mat4) LookAt ¶
func (*Mat4) Mul ¶
Mul stores a × b in m.
func (*Mat4) Perspective ¶
Perspective sets m to be the GL perspective matrix.
func (*Mat4) Rotate ¶
Rotate sets m to a rotation in radians around a specified axis, followed by p. It is equivalent to m.Mul(p, affineRotation).
func (*Mat4) Scale ¶
Scale sets m to be a scale followed by p. It is equivalent to
m.Mul(p, &Mat4{
{x, 0, 0, 0},
{0, y, 0, 0},
{0, 0, z, 0},
{0, 0, 0, 1},
}).
func (Mat4) String ¶
func (*Mat4) Translate ¶
Translate sets m to be a translation followed by p. It is equivalent to
m.Mul(p, &Mat4{
{1, 0, 0, x},
{0, 1, 0, y},
{0, 0, 1, z},
{0, 0, 0, 1},
}).
type Radian ¶
type Radian float32
type Vec3 ¶
type Vec3 [3]float32
func (*Vec3) Add ¶
func (*Vec3) Cross ¶
func (*Vec3) Dot ¶
func (*Vec3) Mul ¶
func (*Vec3) Normalize ¶
func (v *Vec3) Normalize()
func (Vec3) String ¶
func (*Vec3) Sub ¶
type Vec4 ¶
type Vec4 [4]float32
func (*Vec4) Add ¶
func (*Vec4) Dot ¶
func (*Vec4) Mul ¶
func (*Vec4) Normalize ¶
func (v *Vec4) Normalize()
func (Vec4) String ¶
func (*Vec4) Sub ¶
Source Files ¶
affine.go f32.go mat3.go mat4.go table.go vec3.go vec4.go
- Version
- v0.0.0-20250210185054-b38b8813d607 (latest)
- Published
- Feb 10, 2025
- Platform
- linux/amd64
- Imports
- 3 packages
- Last checked
- 1 month ago –
Tools for package owners.