ebiten/internal/graphics/command.go

378 lines
10 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"
2016-06-02 19:34:34 +02:00
"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
NumVertices() int
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
// nvertices represents the current length of vertices.
// nvertices must <= len(vertices).
2017-09-18 18:37:24 +02:00
// vertices is never shrunk since re-extending a vertices buffer is heavy.
nvertices 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.nvertices+len(vertices) {
n := q.nvertices + 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.nvertices+i] = vertices[i]
2017-05-27 17:08:10 +02:00
}
q.nvertices += len(vertices)
2016-06-02 19:34:34 +02:00
}
2017-09-18 18:37:24 +02:00
// EnqueueDrawImageCommand enqueues a drawing-image command.
func (q *commandQueue) EnqueueDrawImageCommand(dst, src *Image, vertices []float32, clr *affine.ColorM, mode opengl.CompositeMode, filter Filter) {
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 {
if c.canMerge(dst, src, clr, mode, filter) {
c.nvertices += len(vertices)
2017-05-27 14:35:38 +02:00
q.m.Unlock()
return
}
}
}
c := &drawImageCommand{
dst: dst,
src: src,
nvertices: len(vertices),
color: clr,
mode: mode,
filter: filter,
}
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 {
n += c.NumVertices()
}
if 0 < n-lastN {
// Note that the vertices passed to BufferSubData is not under GC management
// in opengl package due to unsafe-way.
// See BufferSubData in context_mobile.go.
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
}
n := c.NumVertices() * 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.nvertices = 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
// 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
nvertices int
color *affine.ColorM
mode opengl.CompositeMode
filter Filter
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
}
proj := f.projectionMatrix()
theOpenGLState.useProgram(proj, c.src.texture.native, c.dst, c.src, c.color, c.filter)
// 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)
// glFlush() might be necessary at least on MacBook Pro (a smilar problem at #419),
// but basically this pass the tests (esp. TestImageTooManyFill).
// As glFlush() causes performance problems, this should be avoided as much as possible.
// Let's wait and see, and file a new issue when this problem is newly found.
return nil
2016-06-02 19:34:34 +02:00
}
func (c *drawImageCommand) NumVertices() int {
return c.nvertices
}
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.nvertices = n
c2.nvertices -= 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, filter Filter) 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
}
if c.filter != filter {
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.nvertices * 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
2018-01-28 14:40:36 +01:00
pixels []byte
x int
y int
width int
height int
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()
2018-02-28 15:40:43 +01:00
// glFlush is necessary on Android.
// glTexSubImage2D didn't work without this hack at least on Nexus 5x and NuAns NEO [Reloaded] (#211).
opengl.GetContext().Flush()
opengl.GetContext().BindTexture(c.dst.texture.native)
opengl.GetContext().TexSubImage2D(c.pixels, c.x, c.y, c.width, c.height)
2016-06-02 19:34:34 +02:00
return nil
}
2016-06-11 15:52:07 +02:00
func (c *replacePixelsCommand) NumVertices() int {
return 0
}
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 &&
c.target.framebuffer.native != opengl.GetContext().ScreenFramebuffer() {
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
}
func (c *disposeCommand) NumVertices() int {
return 0
}
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
}
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)
if err != nil {
return err
}
c.result.texture = &texture{
native: native,
}
return nil
}
func (c *newImageCommand) NumVertices() int {
return 0
}
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
}
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.")
}
// The (default) framebuffer size can't be converted to a power of 2.
// On browsers, c.width and c.height are used as viewport size and
// Edge can't treat a bigger viewport than the drawing area (#71).
c.result.framebuffer = newScreenFramebuffer(c.width, c.height)
return nil
}
func (c *newScreenFramebufferImageCommand) NumVertices() int {
return 0
}