gfx

package
v0.2.75 Latest Latest
Warning

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

 Go to latest Published: Oct 15, 2020 License: MIT Imports: 18 Imported by: 0

Documentation

Overview

Package gfx is a thin abstraction layer for OpenGL.

Index

Constants

This section is empty.

Variables

View Source 
var (
	// FrameSync is an internal variable.
	FrameSync = make(chan chan struct{}, 1)
)
View Source 
var GL gl.Context

GL is the OpenGL context.

View Source 
var Lock sync.Mutex

Lock should be held whenever an operation depends on or modifies global OpenGL state.

View Source 
var Square = NewStaticBuffer("square", []uint8{
	m1, +1, m1, 1, 0, 0,
	m1, m1, m1, 1, 0, 1,
	+1, m1, +1, 1, 1, 1,
	+1, +1, +1, 1, 1, 0,
}, []uint16{3, 2, 1, 0, 3, 1})

Square is a StaticBuffer containing vertices for a square.

Functions

func Init 

func Init(ctx gl.Context)

Init is an internal function that sets up the context.

func NextFrame 

func NextFrame()

NextFrame synchronizes a frame boundary.

func Release added in v0.2.70 

func Release()

Release is an internal function that shuts down the context.

func SetSize 

func SetSize(w, h int)

SetSize is an internal function.

func Size 

func Size() (int, int)

Size returns the current screen size.

Types

type AssetTexture added in v0.2.72 

type AssetTexture struct {
	Name string
	// contains filtered or unexported fields
}

AssetTexture is a lazy-loaded texture.

func BlankAssetTexture added in v0.2.75 

func BlankAssetTexture() *AssetTexture

BlankAssetTexture returns a 1x1 white square.

func NewAssetTexture added in v0.2.72 

func NewAssetTexture(name string, nearest bool) *AssetTexture

NewAssetTexture creates a lazy-loaded texture from an asset.

func NewCachedAssetTexture added in v0.2.75 

func NewCachedAssetTexture(name string) *AssetTexture

NewCachedAssetTexture creates a lazy-loaded texture from an asset.

func NewEmbeddedTexture added in v0.2.75 

func NewEmbeddedTexture(name string, nearest bool, f func() ([]byte, string, error)) *AssetTexture

NewEmbeddedTexture creates an AssetTexture that loads from memory.

func (*AssetTexture) LazyTexture added in v0.2.73 

func (a *AssetTexture) LazyTexture(def gl.Texture) gl.Texture

LazyTexture loads the texture and returns the texture handle.

func (*AssetTexture) Preload added in v0.2.72 

func (a *AssetTexture) Preload() error

Preload loads the texture and returns any error encountered.

func (*AssetTexture) Release added in v0.2.73 

func (a *AssetTexture) Release()

Release deletes the texture handle.

func (*AssetTexture) Texture added in v0.2.72 

func (a *AssetTexture) Texture() gl.Texture

Texture loads the texture and returns the texture handle.

type Attrib added in v0.2.70 

type Attrib struct {
	Attrib gl.Attrib
	Name   string
	// contains filtered or unexported fields
}

Attrib is a vertex attribute.

type Camera 

type Camera struct {
	Offset      Matrix
	Rotation    Matrix
	Position    Matrix
	Perspective Matrix
	// contains filtered or unexported fields
}

Camera tracks the position and orientation of the 3D camera.

func (*Camera) Combined 

func (c *Camera) Combined() Matrix

Combined returns the combined transformation matrix.

func (*Camera) PopTransform 

func (c *Camera) PopTransform()

PopTransform removes the last transform added via PushTransform.

func (*Camera) PushTransform 

func (c *Camera) PushTransform(m Matrix)

PushTransform adds a transform to the transform stack.

func (*Camera) SetDefaults 

func (c *Camera) SetDefaults()

SetDefaults sets the Matrix fields in Camera to default values.

type CustomInit added in v0.2.70 

type CustomInit struct {
	Name string
	// contains filtered or unexported fields
}

CustomInit is a custom OpenGL init/release function pair.

func Custom added in v0.2.70 

func Custom(name string, init, release func()) *CustomInit

Custom registers a CustomInit.

type Matrix 

type Matrix [16]float32

Matrix is a 4x4 transformation matrix.

func Identity 

func Identity() Matrix

Identity returns the identity matrix.

func MultiplyMatrix 

func MultiplyMatrix(m0, m1 Matrix) Matrix

MultiplyMatrix multiplies a matrix by a matrix.

func Perspective 

func Perspective(fov, aspect, nearZ, farZ float32) Matrix

Perspective constructs a perspective matrix.

func RotationX 

func RotationX(r float32) Matrix

RotationX constructs a rotation matrix over the X axis.

func RotationY 

func RotationY(r float32) Matrix

RotationY constructs a rotation matrix over the Y axis.

func RotationZ 

func RotationZ(r float32) Matrix

RotationZ constructs a rotation matrix over the Z axis.

func Scale 

func Scale(x, y, z float32) Matrix

Scale constructs a scaling matrix.

func Translation 

func Translation(x, y, z float32) Matrix

Translation constructs translation matrix.

type Program added in v0.2.70 

type Program struct {
	Name string

	Program gl.Program
	// contains filtered or unexported fields
}

Program is an OpenGL shader.

func Shader added in v0.2.70 

func Shader(name, vertex, fragment string) *Program

Shader registers an OpenGL shader.

func (*Program) Attrib added in v0.2.70 

func (p *Program) Attrib(name string) *Attrib

Attrib gets the location of a vertex attribute.

func (*Program) Uniform added in v0.2.70 

func (p *Program) Uniform(name string) *Uniform

Uniform gets the location of a global variable.

type StaticBuffer 

type StaticBuffer struct {
	Name string

	Data    gl.Buffer
	Element gl.Buffer
	Count   int
	// contains filtered or unexported fields
}

StaticBuffer is a convenience layer for OpenGL vertex buffer objects.

func NewStaticBuffer 

func NewStaticBuffer(name string, data []uint8, elements []uint16) *StaticBuffer

NewStaticBuffer creates a StaticBuffer.

func (*StaticBuffer) Delete 

func (sb *StaticBuffer) Delete()

Delete frees the GPU memory held by StaticBuffer and removes it from the list of buffers.

type Texture added in v0.2.70 

type Texture struct {
	Name    string
	Texture gl.Texture
	// contains filtered or unexported fields
}

Texture is an OpenGL texture.

func NewTexture added in v0.2.70 

func NewTexture(name string, img image.Image, nearest bool) *Texture

NewTexture creates a texture.

func (*Texture) Release added in v0.2.73 

func (t *Texture) Release()

Release deletes a texture handle.

type Uniform added in v0.2.70 

type Uniform struct {
	Uniform gl.Uniform
	Name    string
	// contains filtered or unexported fields
}

Uniform is a global variable.

type Vector 

type Vector [4]float32

Vector is a 4-component geometric vector of (x, y, z, 1).

func MultiplyVector 

func MultiplyVector(m Matrix, v Vector) Vector

MultiplyVector multiplies a matrix by a vector.

Source Files

View all Source files

Directories

Path Synopsis
Package crt renders a screen-space CRT monitor effect.
 Package crt renders a screen-space CRT monitor effect.
Package sprites handles loading and rendering sprites.
 Package sprites handles loading and rendering sprites.
internal/gentext

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.