ebiten/internal/graphics/command.go

415 lines
12 KiB
Go
Raw Normal View History

2016-06-02 19:34:34 +02:00
// Copyright 2016 Hajime Hoshi
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package graphics
import (
"errors"
"fmt"
"image"
2016-06-02 19:34:34 +02:00
"image/color"
"math"
"github.com/hajimehoshi/ebiten/internal/affine"
2017-08-06 13:05:14 +02:00
emath "github.com/hajimehoshi/ebiten/internal/math"
"github.com/hajimehoshi/ebiten/internal/opengl"
2017-05-26 19:37:01 +02:00
"github.com/hajimehoshi/ebiten/internal/sync"
2016-06-02 19:34:34 +02:00
)
2017-09-11 20:12:17 +02:00
// command represents a drawing command.
//
// A command for drawing that is created when Image functions are called like DrawImage,
// or Fill.
// A command is not immediately executed after created. Instaed, it is queued after created,
// and executed only when necessary.
2016-06-02 19:34:34 +02:00
type command interface {
Exec(indexOffsetInBytes int) error
2016-06-02 19:34:34 +02:00
}
2017-09-16 08:49:29 +02:00
// commandQueue is a command queue for drawing commands.
2016-06-02 19:34:34 +02:00
type commandQueue struct {
2017-09-18 18:37:24 +02:00
// commands is a queue of drawing commands.
commands []command
// vertices represents a vertices data in OpenGL's array buffer.
vertices []float32
// verticesNum represents the current length of vertices.
// verticesNum must <= len(vertices).
// vertices is never shrunk since re-extending a vertices buffer is heavy.
verticesNum int
2017-09-18 18:37:24 +02:00
m sync.Mutex
2016-06-02 19:34:34 +02:00
}
2017-09-16 08:49:29 +02:00
// theCommandQueue is the command queue for the current process.
var theCommandQueue = &commandQueue{}
2017-09-18 18:37:24 +02:00
// appendVertices appends vertices to the queue.
func (q *commandQueue) appendVertices(vertices []float32) {
if len(q.vertices) < q.verticesNum+len(vertices) {
n := q.verticesNum + len(vertices) - len(q.vertices)
q.vertices = append(q.vertices, make([]float32, n)...)
}
2017-05-27 17:08:10 +02:00
// for-loop might be faster than copy:
// On GopherJS, copy might cause subarray calls.
for i := 0; i < len(vertices); i++ {
q.vertices[q.verticesNum+i] = vertices[i]
}
q.verticesNum += len(vertices)
2016-06-02 19:34:34 +02:00
}
2017-09-18 18:37:24 +02:00
// EnqueueDrawImageCommand enqueues a drawing-image command.
2017-05-27 09:14:48 +02:00
func (q *commandQueue) EnqueueDrawImageCommand(dst, src *Image, vertices []float32, clr *affine.ColorM, mode opengl.CompositeMode) {
2017-05-27 14:35:38 +02:00
// Avoid defer for performance
2016-07-03 15:55:15 +02:00
q.m.Lock()
q.appendVertices(vertices)
if 0 < len(q.commands) {
if c, ok := q.commands[len(q.commands)-1].(*drawImageCommand); ok {
2017-09-19 18:35:56 +02:00
if c.canMerge(dst, src, clr, mode) {
c.verticesNum += len(vertices)
2017-05-27 14:35:38 +02:00
q.m.Unlock()
return
}
}
}
c := &drawImageCommand{
dst: dst,
src: src,
verticesNum: len(vertices),
2017-05-27 09:14:48 +02:00
color: *clr,
mode: mode,
}
q.commands = append(q.commands, c)
2017-05-27 14:35:38 +02:00
q.m.Unlock()
}
2017-09-19 18:35:56 +02:00
// Enqueue enqueues a drawing command other than a draw-image command.
//
2017-09-21 16:33:27 +02:00
// For a draw-image command, use EnqueueDrawImageCommand.
func (q *commandQueue) Enqueue(command command) {
q.m.Lock()
q.commands = append(q.commands, command)
2017-05-27 14:35:38 +02:00
q.m.Unlock()
}
// commandGroups separates q.commands into some groups.
// The number of quads of drawImageCommand in one groups must be equal to or less than
// its limit (maxQuads).
func (q *commandQueue) commandGroups() [][]command {
cs := q.commands
var gs [][]command
quads := 0
for 0 < len(cs) {
if len(gs) == 0 {
gs = append(gs, []command{})
}
c := cs[0]
switch c := c.(type) {
case *drawImageCommand:
if maxQuads >= quads+c.quadsNum() {
quads += c.quadsNum()
break
}
cc := c.split(maxQuads - quads)
gs[len(gs)-1] = append(gs[len(gs)-1], cc[0])
cs[0] = cc[1]
quads = 0
gs = append(gs, []command{})
continue
}
gs[len(gs)-1] = append(gs[len(gs)-1], c)
cs = cs[1:]
}
return gs
}
2017-09-19 18:35:56 +02:00
// Flush flushes the command queue.
func (q *commandQueue) Flush() error {
2016-07-03 15:55:15 +02:00
q.m.Lock()
defer q.m.Unlock()
// glViewport must be called at least at every frame on iOS.
opengl.GetContext().ResetViewportSize()
n := 0
lastN := 0
for _, g := range q.commandGroups() {
for _, c := range g {
switch c := c.(type) {
case *drawImageCommand:
n += c.verticesNum
}
}
if 0 < n-lastN {
opengl.GetContext().BufferSubData(opengl.ArrayBuffer, q.vertices[lastN:n])
}
// NOTE: WebGL doesn't seem to have Check gl.MAX_ELEMENTS_VERTICES or gl.MAX_ELEMENTS_INDICES so far.
// Let's use them to compare to len(quads) in the future.
if maxQuads < (n-lastN)*opengl.Float.SizeInBytes()/QuadVertexSizeInBytes() {
return fmt.Errorf("len(quads) must be equal to or less than %d", maxQuads)
2016-06-02 19:34:34 +02:00
}
numc := len(g)
indexOffsetInBytes := 0
for _, c := range g {
if err := c.Exec(indexOffsetInBytes); err != nil {
return err
}
if c, ok := c.(*drawImageCommand); ok {
n := c.verticesNum * opengl.Float.SizeInBytes() / QuadVertexSizeInBytes()
indexOffsetInBytes += 6 * n * 2
}
}
if 0 < numc {
// Call glFlush to prevent black flicking (especially on Android (#226) and iOS).
opengl.GetContext().Flush()
}
lastN = n
2016-06-02 19:34:34 +02:00
}
q.commands = nil
q.verticesNum = 0
2016-06-02 19:34:34 +02:00
return nil
}
2017-09-19 18:35:56 +02:00
// FlushCommands flushes the command queue.
func FlushCommands() error {
return theCommandQueue.Flush()
2016-06-10 22:48:09 +02:00
}
2017-09-19 18:35:56 +02:00
// fillCommand represents a drawing command to fill an image with a solid color.
2016-06-02 19:34:34 +02:00
type fillCommand struct {
dst *Image
color color.RGBA
2016-06-02 19:34:34 +02:00
}
2017-09-19 18:35:56 +02:00
// Exec executes the fillCommand.
func (c *fillCommand) Exec(indexOffsetInBytes int) error {
f, err := c.dst.createFramebufferIfNeeded()
2016-12-14 15:40:43 +01:00
if err != nil {
return err
}
f.setAsViewport()
cr, cg, cb, ca := c.color.R, c.color.G, c.color.B, c.color.A
const max = math.MaxUint8
2016-06-02 19:34:34 +02:00
r := float64(cr) / max
g := float64(cg) / max
b := float64(cb) / max
a := float64(ca) / max
if err := opengl.GetContext().FillFramebuffer(r, g, b, a); err != nil {
return err
}
// Flush is needed after filling (#419)
opengl.GetContext().Flush()
return nil
2016-06-02 19:34:34 +02:00
}
2017-09-19 18:35:56 +02:00
// drawImageCommand represents a drawing command to draw an image on another image.
2016-06-02 19:34:34 +02:00
type drawImageCommand struct {
dst *Image
src *Image
verticesNum int
color affine.ColorM
mode opengl.CompositeMode
2016-06-02 19:34:34 +02:00
}
2017-09-19 18:35:56 +02:00
// QuadVertexSizeInBytes returns the size in bytes of vertices for a quadrangle.
func QuadVertexSizeInBytes() int {
2016-10-28 18:07:19 +02:00
return 4 * theArrayBufferLayout.totalBytes()
}
2016-10-17 04:16:17 +02:00
2017-09-19 18:35:56 +02:00
// Exec executes the drawImageCommand.
func (c *drawImageCommand) Exec(indexOffsetInBytes int) error {
f, err := c.dst.createFramebufferIfNeeded()
2016-12-14 15:40:43 +01:00
if err != nil {
return err
}
f.setAsViewport()
opengl.GetContext().BlendFunc(c.mode)
n := c.quadsNum()
if n == 0 {
return nil
}
_, h := c.dst.Size()
2016-12-14 15:40:43 +01:00
proj := f.projectionMatrix(h)
theOpenGLState.useProgram(proj, c.src.texture.native, c.color)
// TODO: We should call glBindBuffer here?
// The buffer is already bound at begin() but it is counterintuitive.
opengl.GetContext().DrawElements(opengl.Triangles, 6*n, indexOffsetInBytes)
return nil
2016-06-02 19:34:34 +02:00
}
2017-09-19 18:35:56 +02:00
// split splits the drawImageCommand c into two drawImageCommands.
//
// split is called when the number of vertices reaches of the maximum and
// a command is needed to be executed as another draw call.
func (c *drawImageCommand) split(quadsNum int) [2]*drawImageCommand {
c1 := *c
c2 := *c
s := opengl.Float.SizeInBytes()
n := quadsNum * QuadVertexSizeInBytes() / s
c1.verticesNum = n
c2.verticesNum -= n
return [2]*drawImageCommand{&c1, &c2}
}
2017-09-19 18:35:56 +02:00
// canMerge returns a boolean value indicating whether the other drawImageCommand can be merged
// with the drawImageCommand c.
func (c *drawImageCommand) canMerge(dst, src *Image, clr *affine.ColorM, mode opengl.CompositeMode) bool {
if c.dst != dst {
return false
}
if c.src != src {
return false
}
2017-05-27 09:14:48 +02:00
if !c.color.Equals(clr) {
2016-10-31 16:28:07 +01:00
return false
}
if c.mode != mode {
return false
}
return true
}
2017-09-19 18:35:56 +02:00
// quadsNum returns the number of quadrangles.
func (c *drawImageCommand) quadsNum() int {
return c.verticesNum * opengl.Float.SizeInBytes() / QuadVertexSizeInBytes()
}
2017-09-19 18:35:56 +02:00
// replacePixelsCommand represents a command to replace pixels of an image.
2016-06-02 19:34:34 +02:00
type replacePixelsCommand struct {
dst *Image
pixels []uint8
2016-06-02 19:34:34 +02:00
}
2017-09-19 18:35:56 +02:00
// Exec executes the replacePixelsCommand.
func (c *replacePixelsCommand) Exec(indexOffsetInBytes int) error {
f, err := c.dst.createFramebufferIfNeeded()
2016-12-14 15:40:43 +01:00
if err != nil {
return err
}
f.setAsViewport()
2016-06-02 19:34:34 +02:00
// Filling with non black or white color is required here for glTexSubImage2D.
2016-06-27 20:05:47 +02:00
// Very mysterious but this actually works (Issue #186).
// This is needed even after fixing a shader bug at f537378f2a6a8ef56e1acf1c03034967b77c7b51.
if err := opengl.GetContext().FillFramebuffer(0, 0, 0.5, 1); err != nil {
2016-06-02 19:34:34 +02:00
return err
}
// This is necessary on Android. We can't call glClear just before glTexSubImage2D without
// glFlush. glTexSubImage2D didn't work without this hack at least on Nexus 5x (#211).
2016-07-10 07:49:41 +02:00
// This also happens when a fillCommand precedes a replacePixelsCommand.
// TODO: Can we have a better way like optimizing commands?
opengl.GetContext().Flush()
opengl.GetContext().BindTexture(c.dst.texture.native)
2017-08-06 13:05:14 +02:00
opengl.GetContext().TexSubImage2D(c.pixels, emath.NextPowerOf2Int(c.dst.width), emath.NextPowerOf2Int(c.dst.height))
2016-06-02 19:34:34 +02:00
return nil
}
2016-06-11 15:52:07 +02:00
2017-09-19 18:35:56 +02:00
// disposeCommand represents a command to dispose an image.
2016-06-11 15:52:07 +02:00
type disposeCommand struct {
target *Image
2016-06-11 15:52:07 +02:00
}
2017-09-19 18:35:56 +02:00
// Exec executes the disposeCommand.
func (c *disposeCommand) Exec(indexOffsetInBytes int) error {
if c.target.framebuffer != nil {
opengl.GetContext().DeleteFramebuffer(c.target.framebuffer.native)
2016-06-11 15:52:07 +02:00
}
if c.target.texture != nil {
opengl.GetContext().DeleteTexture(c.target.texture.native)
2016-06-11 15:52:07 +02:00
}
return nil
}
2017-09-19 18:35:56 +02:00
// newImageFromImageCommand represents a command to create an image from an image.RGBA.
type newImageFromImageCommand struct {
result *Image
img *image.RGBA
filter opengl.Filter
}
2017-09-19 18:35:56 +02:00
// Exec executes the newImageFromImageCommand.
func (c *newImageFromImageCommand) Exec(indexOffsetInBytes int) error {
origSize := c.img.Bounds().Size()
if origSize.X < 1 {
return errors.New("graphics: width must be equal or more than 1.")
}
if origSize.Y < 1 {
return errors.New("graphics: height must be equal or more than 1.")
}
2016-12-26 19:18:56 +01:00
w, h := c.img.Bounds().Size().X, c.img.Bounds().Size().Y
2017-08-06 13:05:14 +02:00
if c.img.Bounds() != image.Rect(0, 0, emath.NextPowerOf2Int(w), emath.NextPowerOf2Int(h)) {
2016-12-26 19:18:56 +01:00
panic(fmt.Sprintf("graphics: invalid image bounds: %v", c.img.Bounds()))
}
native, err := opengl.GetContext().NewTexture(w, h, c.img.Pix, c.filter)
if err != nil {
return err
}
c.result.texture = &texture{
native: native,
}
return nil
}
2017-09-19 18:35:56 +02:00
// newImageCommand represents a command to create an empty image with given width and height.
type newImageCommand struct {
result *Image
width int
height int
filter opengl.Filter
}
2017-09-19 18:35:56 +02:00
// Exec executes a newImageCommand.
func (c *newImageCommand) Exec(indexOffsetInBytes int) error {
2017-08-06 13:05:14 +02:00
w := emath.NextPowerOf2Int(c.width)
h := emath.NextPowerOf2Int(c.height)
if w < 1 {
return errors.New("graphics: width must be equal or more than 1.")
}
if h < 1 {
return errors.New("graphics: height must be equal or more than 1.")
}
native, err := opengl.GetContext().NewTexture(w, h, nil, c.filter)
if err != nil {
return err
}
c.result.texture = &texture{
native: native,
}
return nil
}
2017-09-19 18:35:56 +02:00
// newScreenFramebufferImageCommand is a command to create a special image for the screen.
type newScreenFramebufferImageCommand struct {
result *Image
width int
height int
offsetX float64
offsetY float64
}
2017-09-19 18:35:56 +02:00
// Exec executes a newScreenFramebufferImageCommand.
func (c *newScreenFramebufferImageCommand) Exec(indexOffsetInBytes int) error {
if c.width < 1 {
return errors.New("graphics: width must be equal or more than 1.")
}
if c.height < 1 {
return errors.New("graphics: height must be equal or more than 1.")
}
2017-09-21 18:13:37 +02:00
c.result.framebuffer = newScreenFramebuffer(c.width, c.height, c.offsetX, c.offsetY)
return nil
}