graphicscommand

Documentation

Overview

Package graphicscommand represents a low layer for graphics using OpenGL.

Index

• func DumpImages(images []*Image, graphicsDriver graphicsdriver.Graphics, dir string) (string, error)
• func FlushCommands(graphicsDriver graphicsdriver.Graphics) error
• func InitializeGraphicsDriverState(graphicsDriver graphicsdriver.Graphics) (err error)
• func LogImagesInfo(images []*Image)
• func MaxImageSize(graphicsDriver graphicsdriver.Graphics) int
• func ResetGraphicsDriverState(graphicsDriver graphicsdriver.Graphics) (err error)
• func SetRenderingThread(thread Thread)
• type Image
  • func NewImage(width, height int, screenFramebuffer bool) *Image
  • func (i *Image) Dispose()
  • func (i *Image) DrawTriangles(srcs [graphics.ShaderImageCount]*Image, ...)
  • func (i *Image) Dump(graphicsDriver graphicsdriver.Graphics, path string, blackbg bool, ...) (string, error)
  • func (i *Image) InternalSize() (int, int)
  • func (i *Image) IsInvalidated(graphicsDriver graphicsdriver.Graphics) (bool, error)
  • func (i *Image) ReadPixels(graphicsDriver graphicsdriver.Graphics, buf []byte, x, y, width, height int) error
  • func (i *Image) WritePixels(pixels []byte, x, y, width, height int)
• type Shader
  • func NewShader(ir *shaderir.Program) *Shader
  • func (s *Shader) Dispose()
• type Thread

Functions

func DumpImages

func DumpImages(images []*Image, graphicsDriver graphicsdriver.Graphics, dir string) (string, error)

DumpImages dumps all the current images to the specified directory.

This is for testing usage.

func FlushCommands

func FlushCommands(graphicsDriver graphicsdriver.Graphics) error

FlushCommands flushes the command queue.

func InitializeGraphicsDriverState

func InitializeGraphicsDriverState(graphicsDriver graphicsdriver.Graphics) (err error)

InitializeGraphicsDriverState initialize the current graphics driver state.

func LogImagesInfo

func LogImagesInfo(images []*Image)

func MaxImageSize

func MaxImageSize(graphicsDriver graphicsdriver.Graphics) int

MaxImageSize returns the maximum size of an image.

func ResetGraphicsDriverState

func ResetGraphicsDriverState(graphicsDriver graphicsdriver.Graphics) (err error)

ResetGraphicsDriverState resets the current graphics driver state. If the graphics driver doesn't have an API to reset, ResetGraphicsDriverState does nothing.

func SetRenderingThread

func SetRenderingThread(thread Thread)

SetRenderingThread must be called from the rendering thread where e.g. OpenGL works.

TODO: Create thread in this package instead of setting it externally.

Types

type Image

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

Image represents an image that is implemented with OpenGL.

func NewImage

func NewImage(width, height int, screenFramebuffer bool) *Image

NewImage returns a new image.

Note that the image is not initialized yet.

func (*Image) Dispose

func (i *Image) Dispose()

func (*Image) DrawTriangles

func (i *Image) DrawTriangles(srcs [graphics.ShaderImageCount]*Image, offsets [graphics.ShaderImageCount - 1][2]float32, vertices []float32, indices []uint16, mode graphicsdriver.CompositeMode, dstRegion, srcRegion graphicsdriver.Region, shader *Shader, uniforms [][]float32, evenOdd bool)

DrawTriangles draws triangles with the given image.

The vertex floats are:

0: Destination X in pixels
1: Destination Y in pixels
2: Source X in texels
3: Source Y in texels
4: Color R [0.0-1.0]
5: Color G
6: Color B
7: Color Y

src and shader are exclusive and only either is non-nil.

The elements that index is in between 2 and 7 are used for the source images. The source image is 1) src argument if non-nil, or 2) an image value in the uniform variables if it exists. If there are multiple images in the uniform variables, the smallest ID's value is adopted.

If the source image is not specified, i.e., src is nil and there is no image in the uniform variables, the elements for the source image are not used.

func (*Image) Dump

func (i *Image) Dump(graphicsDriver graphicsdriver.Graphics, path string, blackbg bool, rect image.Rectangle) (string, error)

func (*Image) InternalSize

func (i *Image) InternalSize() (int, int)

func (*Image) IsInvalidated

func (i *Image) IsInvalidated(graphicsDriver graphicsdriver.Graphics) (bool, error)

func (*Image) ReadPixels

func (i *Image) ReadPixels(graphicsDriver graphicsdriver.Graphics, buf []byte, x, y, width, height int) error

ReadPixels reads the image's pixels. ReadPixels returns an error when an error happens in the graphics driver.

func (*Image) WritePixels

func (i *Image) WritePixels(pixels []byte, x, y, width, height int)

type Shader

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

func NewShader

func NewShader(ir *shaderir.Program) *Shader

func (*Shader) Dispose

func (s *Shader) Dispose()

type Thread

type Thread interface {
	Call(f func())
}