2016-06-11 18:45:40 +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.
|
|
|
|
|
2018-10-28 12:10:05 +01:00
|
|
|
package graphicscommand
|
2016-06-11 18:45:40 +02:00
|
|
|
|
|
|
|
import (
|
2018-08-05 14:30:06 +02:00
|
|
|
"github.com/hajimehoshi/ebiten/internal/affine"
|
2018-10-28 12:25:52 +01:00
|
|
|
"github.com/hajimehoshi/ebiten/internal/graphics"
|
2018-11-10 14:47:39 +01:00
|
|
|
"github.com/hajimehoshi/ebiten/internal/graphicsdriver"
|
2016-06-11 18:45:40 +02:00
|
|
|
)
|
|
|
|
|
2018-03-09 03:03:55 +01:00
|
|
|
var (
|
2018-11-10 17:26:37 +01:00
|
|
|
// maxImageSize is the maximum texture size
|
2018-03-09 03:03:55 +01:00
|
|
|
//
|
2018-11-10 17:26:37 +01:00
|
|
|
// maxImageSize also represents the default size (width or height) of viewport.
|
|
|
|
maxImageSize = 0
|
2018-03-09 03:03:55 +01:00
|
|
|
)
|
|
|
|
|
|
|
|
// MaxImageSize returns the maximum of width/height of an image.
|
|
|
|
func MaxImageSize() int {
|
2018-11-10 17:26:37 +01:00
|
|
|
if maxImageSize == 0 {
|
|
|
|
maxImageSize = driver().MaxImageSize()
|
|
|
|
if maxImageSize == 0 {
|
2018-03-09 03:03:55 +01:00
|
|
|
panic("graphics: failed to get the max texture size")
|
|
|
|
}
|
|
|
|
}
|
2018-11-10 17:26:37 +01:00
|
|
|
return maxImageSize
|
2018-03-09 03:03:55 +01:00
|
|
|
}
|
|
|
|
|
2018-11-30 00:59:31 +01:00
|
|
|
// imageState is a state of an image.
|
|
|
|
type imageState int
|
|
|
|
|
|
|
|
const (
|
|
|
|
// imageStateInit represents that the image is just allocated and not ready for DrawImages.
|
|
|
|
imageStateInit imageState = iota
|
|
|
|
|
|
|
|
// imageStateReplacePixelsOnly represents that only ReplacePixels is acceptable.
|
|
|
|
imageStateReplacePixelsOnly
|
|
|
|
|
|
|
|
// imageStateDrawable represents that the image is ready to draw with any commands.
|
|
|
|
imageStateDrawable
|
|
|
|
|
|
|
|
// imageStateScreen is the special state for screen framebuffer.
|
|
|
|
// Only copying image on the screen image is allowed.
|
|
|
|
imageStateScreen
|
|
|
|
)
|
|
|
|
|
2017-09-21 18:13:37 +02:00
|
|
|
// Image represents an image that is implemented with OpenGL.
|
2016-06-11 18:45:40 +02:00
|
|
|
type Image struct {
|
2018-11-10 14:47:39 +01:00
|
|
|
image graphicsdriver.Image
|
2018-11-04 11:36:33 +01:00
|
|
|
width int
|
|
|
|
height int
|
2018-11-30 00:59:31 +01:00
|
|
|
state imageState
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
|
2018-02-13 18:02:48 +01:00
|
|
|
func NewImage(width, height int) *Image {
|
2016-07-04 17:24:06 +02:00
|
|
|
i := &Image{
|
2018-11-04 11:36:33 +01:00
|
|
|
width: width,
|
|
|
|
height: height,
|
2018-11-30 00:59:31 +01:00
|
|
|
state: imageStateInit, // The screen image must be inited with ReplacePixels first.
|
2016-07-04 17:24:06 +02:00
|
|
|
}
|
2016-06-11 18:45:40 +02:00
|
|
|
c := &newImageCommand{
|
2016-06-12 15:44:23 +02:00
|
|
|
result: i,
|
|
|
|
width: width,
|
|
|
|
height: height,
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
theCommandQueue.Enqueue(c)
|
2017-03-03 15:51:25 +01:00
|
|
|
return i
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
|
2018-02-24 15:35:55 +01:00
|
|
|
func NewScreenFramebufferImage(width, height int) *Image {
|
2016-07-04 17:24:06 +02:00
|
|
|
i := &Image{
|
2018-11-04 11:36:33 +01:00
|
|
|
width: width,
|
|
|
|
height: height,
|
2018-11-30 00:59:31 +01:00
|
|
|
state: imageStateScreen,
|
2016-07-04 17:24:06 +02:00
|
|
|
}
|
2016-06-17 21:46:33 +02:00
|
|
|
c := &newScreenFramebufferImageCommand{
|
2018-02-24 15:35:55 +01:00
|
|
|
result: i,
|
|
|
|
width: width,
|
|
|
|
height: height,
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
2016-06-17 21:46:33 +02:00
|
|
|
theCommandQueue.Enqueue(c)
|
2017-03-03 15:51:25 +01:00
|
|
|
return i
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
|
2018-11-30 00:59:31 +01:00
|
|
|
// clearByReplacingPixels clears the image by replacing pixels.
|
|
|
|
//
|
|
|
|
// The implementation must use replacing-pixels way instead of drawing polygons, since
|
|
|
|
// some environments (e.g. Metal) require replacing-pixels way as initialization.
|
|
|
|
func (i *Image) clearByReplacingPixels() {
|
|
|
|
if i.state != imageStateInit {
|
|
|
|
panic("not reached")
|
|
|
|
}
|
|
|
|
c := &replacePixelsCommand{
|
|
|
|
dst: i,
|
|
|
|
pixels: make([]byte, 4*i.width*i.height),
|
|
|
|
x: 0,
|
|
|
|
y: 0,
|
|
|
|
width: i.width,
|
|
|
|
height: i.height,
|
|
|
|
}
|
|
|
|
theCommandQueue.Enqueue(c)
|
|
|
|
i.state = imageStateDrawable
|
|
|
|
}
|
|
|
|
|
2017-03-03 15:51:25 +01:00
|
|
|
func (i *Image) Dispose() {
|
2016-06-11 18:45:40 +02:00
|
|
|
c := &disposeCommand{
|
2016-06-12 15:44:23 +02:00
|
|
|
target: i,
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
theCommandQueue.Enqueue(c)
|
|
|
|
}
|
|
|
|
|
2016-07-04 17:24:06 +02:00
|
|
|
func (i *Image) Size() (int, int) {
|
2018-11-04 11:36:33 +01:00
|
|
|
// i.image can be nil before initializing.
|
|
|
|
return i.width, i.height
|
2016-07-04 17:24:06 +02:00
|
|
|
}
|
|
|
|
|
2018-10-28 12:42:57 +01:00
|
|
|
func (i *Image) DrawImage(src *Image, vertices []float32, indices []uint16, clr *affine.ColorM, mode graphics.CompositeMode, filter graphics.Filter) {
|
2018-11-30 00:59:31 +01:00
|
|
|
switch i.state {
|
|
|
|
case imageStateInit:
|
|
|
|
// Before DrawImage, the image must be initialized with ReplacePixels.
|
|
|
|
// Especially on Metal, the image might be broken when drawing without initializing.
|
|
|
|
i.clearByReplacingPixels()
|
|
|
|
case imageStateReplacePixelsOnly:
|
|
|
|
panic("not reached")
|
|
|
|
case imageStateDrawable:
|
|
|
|
// Do nothing
|
|
|
|
case imageStateScreen:
|
|
|
|
if mode != graphics.CompositeModeCopy {
|
|
|
|
panic("not reached")
|
|
|
|
}
|
|
|
|
default:
|
|
|
|
panic("not reached")
|
|
|
|
}
|
2018-08-05 14:30:06 +02:00
|
|
|
theCommandQueue.EnqueueDrawImageCommand(i, src, vertices, indices, clr, mode, filter)
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
|
2018-07-11 19:11:18 +02:00
|
|
|
// Pixels returns the image's pixels.
|
|
|
|
// Pixels might return nil when OpenGL error happens.
|
|
|
|
func (i *Image) Pixels() []byte {
|
2018-11-30 00:59:31 +01:00
|
|
|
switch i.state {
|
|
|
|
case imageStateInit:
|
|
|
|
i.clearByReplacingPixels()
|
|
|
|
case imageStateReplacePixelsOnly:
|
|
|
|
// Do nothing
|
|
|
|
// TODO: Check the region?
|
|
|
|
case imageStateDrawable:
|
|
|
|
// Do nothing
|
|
|
|
case imageStateScreen:
|
|
|
|
panic("not reached")
|
|
|
|
default:
|
|
|
|
panic("not reached")
|
|
|
|
}
|
2018-07-11 19:40:06 +02:00
|
|
|
c := &pixelsCommand{
|
2018-07-11 19:11:18 +02:00
|
|
|
result: nil,
|
|
|
|
img: i,
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
2018-07-11 19:40:06 +02:00
|
|
|
theCommandQueue.Enqueue(c)
|
2018-07-11 19:11:18 +02:00
|
|
|
theCommandQueue.Flush()
|
|
|
|
return c.result
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
|
2018-02-28 16:27:55 +01:00
|
|
|
func (i *Image) ReplacePixels(p []byte, x, y, width, height int) {
|
2018-11-30 00:59:31 +01:00
|
|
|
switch i.state {
|
|
|
|
case imageStateInit:
|
|
|
|
if x == 0 && y == 0 && width == i.width && height == i.height {
|
|
|
|
i.state = imageStateDrawable
|
|
|
|
} else {
|
|
|
|
i.state = imageStateReplacePixelsOnly
|
|
|
|
}
|
|
|
|
case imageStateReplacePixelsOnly:
|
|
|
|
// Do nothing
|
|
|
|
case imageStateDrawable:
|
|
|
|
// Do nothing
|
|
|
|
case imageStateScreen:
|
|
|
|
panic("not reached")
|
|
|
|
default:
|
|
|
|
panic("not reached")
|
|
|
|
}
|
2018-01-28 14:40:36 +01:00
|
|
|
pixels := make([]byte, len(p))
|
2016-08-17 15:10:29 +02:00
|
|
|
copy(pixels, p)
|
2016-06-11 18:45:40 +02:00
|
|
|
c := &replacePixelsCommand{
|
2016-06-12 15:44:23 +02:00
|
|
|
dst: i,
|
2016-08-17 15:10:29 +02:00
|
|
|
pixels: pixels,
|
2018-02-28 16:27:55 +01:00
|
|
|
x: x,
|
|
|
|
y: y,
|
|
|
|
width: width,
|
|
|
|
height: height,
|
2016-06-11 18:45:40 +02:00
|
|
|
}
|
|
|
|
theCommandQueue.Enqueue(c)
|
|
|
|
}
|
2016-06-12 16:54:36 +02:00
|
|
|
|
2017-05-30 19:09:27 +02:00
|
|
|
func (i *Image) IsInvalidated() bool {
|
2018-11-04 11:36:33 +01:00
|
|
|
// i.image can be nil before initializing.
|
|
|
|
if i.image == nil {
|
|
|
|
return false
|
|
|
|
}
|
2018-11-04 10:34:36 +01:00
|
|
|
return i.image.IsInvalidated()
|
2016-06-12 16:54:36 +02:00
|
|
|
}
|