go-opengl-pixel/pixelgl/window.go

534 lines
14 KiB
Go
Raw Normal View History

package pixelgl
2016-11-23 16:12:23 -06:00
import (
"fmt"
2017-04-30 17:43:05 -05:00
"image"
2016-11-24 08:13:05 -06:00
"image/color"
"runtime"
2017-02-11 07:09:47 -06:00
"github.com/faiface/glhf"
"github.com/faiface/mainthread"
"github.com/faiface/pixel"
2021-06-21 14:51:26 -05:00
"github.com/go-gl/gl/v3.3-core/gl"
2019-12-30 16:59:20 -06:00
"github.com/go-gl/glfw/v3.3/glfw"
2016-11-23 16:12:23 -06:00
"github.com/pkg/errors"
)
2017-03-15 16:55:43 -05:00
// WindowConfig is a structure for specifying all possible properties of a Window. Properties are
2017-01-10 17:36:54 -06:00
// chosen in such a way, that you usually only need to set a few of them - defaults (zeros) should
// usually be sensible.
2016-11-24 07:27:43 -06:00
//
2017-03-15 16:55:43 -05:00
// Note that you always need to set the Bounds of a Window.
2016-11-23 16:12:23 -06:00
type WindowConfig struct {
2017-03-14 19:09:33 -05:00
// Title at the top of the Window.
Title string
// Icon specifies the icon images available to be used by the window. This is usually
// displayed in the top bar of the window or in the task bar of the desktop environment.
2017-04-30 17:43:05 -05:00
//
// If passed one image, it will use that image, if passed an array of images those of or
// closest to the sizes desired by the system are selected. The desired image sizes varies
// depending on platform and system settings. The selected images will be rescaled as
// needed. Good sizes include 16x16, 32x32 and 48x48.
2017-04-30 17:43:05 -05:00
//
// Note: Setting this value doesn't have an effect on OSX. You'll need to set the icon when
// bundling your application for release.
2017-04-30 17:43:05 -05:00
Icon []pixel.Picture
2017-04-30 16:19:51 -05:00
2017-03-05 17:28:52 -06:00
// Bounds specify the bounds of the Window in pixels.
Bounds pixel.Rect
// Initial window position
Position pixel.Vec
// If set to nil, the Window will be windowed. Otherwise it will be fullscreen on the
2017-03-15 16:56:23 -05:00
// specified Monitor.
Monitor *Monitor
// Resizable specifies whether the window will be resizable by the user.
Resizable bool
// Undecorated Window omits the borders and decorations (close button, etc.).
2016-11-23 16:12:23 -06:00
Undecorated bool
// NoIconify specifies whether fullscreen windows should not automatically
// iconify (and restore the previous video mode) on focus loss.
NoIconify bool
// AlwaysOnTop specifies whether the windowed mode window will be floating
// above other regular windows, also called topmost or always-on-top.
// This is intended primarily for debugging purposes and cannot be used to
// implement proper full screen windows.
AlwaysOnTop bool
// TransparentFramebuffer specifies whether the window framebuffer will be
// transparent. If enabled and supported by the system, the window
// framebuffer alpha channel will be used to combine the framebuffer with
// the background. This does not affect window decorations.
TransparentFramebuffer bool
2017-03-15 16:56:23 -05:00
// VSync (vertical synchronization) synchronizes Window's framerate with the framerate of
2017-03-05 17:28:52 -06:00
// the monitor.
VSync bool
// Maximized specifies whether the window is maximized.
Maximized bool
// Invisible specifies whether the window will be initially hidden.
// You can make the window visible later using Window.Show().
Invisible bool
2021-06-21 14:51:26 -05:00
//SamplesMSAA specifies the level of MSAA to be used. Must be a power of 2. 0 to disable.
2021-06-21 14:51:26 -05:00
SamplesMSAA int
2016-11-23 16:12:23 -06:00
}
2017-03-15 16:55:43 -05:00
// Window is a window handler. Use this type to manipulate a window (input, drawing, etc.).
2016-11-23 16:12:23 -06:00
type Window struct {
2017-02-11 07:09:47 -06:00
window *glfw.Window
bounds pixel.Rect
canvas *Canvas
vsync bool
cursorVisible bool
cursorInsideWindow bool
2016-11-24 15:06:51 -06:00
// need to save these to correctly restore a fullscreen window
restore struct {
xpos, ypos, width, height int
}
prevInp, currInp, tempInp struct {
2017-03-08 17:56:57 -06:00
mouse pixel.Vec
buttons [KeyLast + 1]bool
2017-05-10 16:54:06 -05:00
repeat [KeyLast + 1]bool
scroll pixel.Vec
2017-05-10 14:10:10 -05:00
typed string
}
2018-12-30 12:42:02 -06:00
2021-06-21 14:51:26 -05:00
pressEvents, tempPressEvents [KeyLast + 1]bool
releaseEvents, tempReleaseEvents [KeyLast + 1]bool
2018-12-30 12:42:02 -06:00
prevJoy, currJoy, tempJoy joystickState
2016-11-23 16:12:23 -06:00
}
2017-03-15 18:15:39 -05:00
var currWin *Window
2017-01-01 15:12:12 -06:00
2017-01-25 11:55:17 -06:00
// NewWindow creates a new Window with it's properties specified in the provided config.
2016-11-24 07:27:43 -06:00
//
2017-01-25 11:55:17 -06:00
// If Window creation fails, an error is returned (e.g. due to unavailable graphics device).
2017-03-05 17:28:52 -06:00
func NewWindow(cfg WindowConfig) (*Window, error) {
2016-11-23 16:12:23 -06:00
bool2int := map[bool]int{
true: glfw.True,
false: glfw.False,
}
w := &Window{bounds: cfg.Bounds, cursorVisible: true}
2016-11-23 16:12:23 -06:00
flag := false
for _, v := range []int{0, 2, 4, 8, 16} {
if cfg.SamplesMSAA == v {
flag = true
break
}
}
if !flag {
return nil, fmt.Errorf("invalid value '%v' for msaaSamples", cfg.SamplesMSAA)
}
err := mainthread.CallErr(func() error {
2017-01-25 20:33:21 -06:00
var err error
2016-11-25 16:12:01 -06:00
glfw.WindowHint(glfw.ContextVersionMajor, 3)
glfw.WindowHint(glfw.ContextVersionMinor, 3)
glfw.WindowHint(glfw.OpenGLProfile, glfw.OpenGLCoreProfile)
glfw.WindowHint(glfw.OpenGLForwardCompatible, glfw.True)
2016-11-23 16:12:23 -06:00
2017-03-05 17:28:52 -06:00
glfw.WindowHint(glfw.Resizable, bool2int[cfg.Resizable])
glfw.WindowHint(glfw.Decorated, bool2int[!cfg.Undecorated])
glfw.WindowHint(glfw.Floating, bool2int[cfg.AlwaysOnTop])
glfw.WindowHint(glfw.AutoIconify, bool2int[!cfg.NoIconify])
glfw.WindowHint(glfw.TransparentFramebuffer, bool2int[cfg.TransparentFramebuffer])
glfw.WindowHint(glfw.Maximized, bool2int[cfg.Maximized])
glfw.WindowHint(glfw.Visible, bool2int[!cfg.Invisible])
2021-06-21 14:51:26 -05:00
glfw.WindowHint(glfw.Samples, cfg.SamplesMSAA)
2016-11-23 16:12:23 -06:00
if cfg.Position.X != 0 || cfg.Position.Y != 0 {
glfw.WindowHint(glfw.Visible, glfw.False)
}
2017-01-01 15:12:12 -06:00
var share *glfw.Window
2017-03-15 18:15:39 -05:00
if currWin != nil {
share = currWin.window
2017-01-01 15:12:12 -06:00
}
2017-03-07 10:45:46 -06:00
_, _, width, height := intBounds(cfg.Bounds)
w.window, err = glfw.CreateWindow(
2017-03-05 17:28:52 -06:00
width,
height,
cfg.Title,
nil,
share,
)
2016-11-23 16:12:23 -06:00
if err != nil {
return err
}
if cfg.Position.X != 0 || cfg.Position.Y != 0 {
w.window.SetPos(int(cfg.Position.X), int(cfg.Position.Y))
w.window.Show()
}
// enter the OpenGL context
w.begin()
2018-02-26 11:38:12 -06:00
glhf.Init()
gl.Enable(gl.MULTISAMPLE)
2017-01-10 18:05:24 -06:00
w.end()
2016-11-24 15:06:51 -06:00
return nil
2016-12-16 13:46:24 -06:00
})
2016-12-01 18:20:54 -06:00
if err != nil {
return nil, errors.Wrap(err, "creating window failed")
}
2017-05-01 05:18:23 -05:00
if len(cfg.Icon) > 0 {
imgs := make([]image.Image, len(cfg.Icon))
for i, icon := range cfg.Icon {
pic := pixel.PictureDataFromPicture(icon)
imgs[i] = pic.Image()
}
mainthread.Call(func() {
w.window.SetIcon(imgs)
})
}
2017-03-05 17:28:52 -06:00
w.SetVSync(cfg.VSync)
2017-01-01 15:12:12 -06:00
w.initInput()
w.SetMonitor(cfg.Monitor)
2017-01-21 20:05:59 -06:00
2017-04-09 17:48:17 -05:00
w.canvas = NewCanvas(cfg.Bounds)
w.Update()
runtime.SetFinalizer(w, (*Window).Destroy)
2017-05-01 05:18:23 -05:00
2016-11-23 16:12:23 -06:00
return w, nil
}
2017-01-25 11:55:17 -06:00
// Destroy destroys the Window. The Window can't be used any further.
func (w *Window) Destroy() {
mainthread.Call(func() {
w.window.Destroy()
})
}
2017-03-15 16:55:43 -05:00
// Update swaps buffers and polls events. Call this method at the end of each frame.
2016-11-23 16:12:23 -06:00
func (w *Window) Update() {
w.SwapBuffers()
w.UpdateInput()
}
// SwapBuffers swaps buffers. Call this to swap buffers without polling window events.
// Note that Update invokes SwapBuffers.
func (w *Window) SwapBuffers() {
2017-03-05 17:28:52 -06:00
mainthread.Call(func() {
2017-03-14 12:31:44 -05:00
_, _, oldW, oldH := intBounds(w.bounds)
newW, newH := w.window.GetSize()
2017-05-21 12:25:06 -05:00
w.bounds = w.bounds.ResizedMin(w.bounds.Size().Add(pixel.V(
2017-03-14 12:31:44 -05:00
float64(newW-oldW),
float64(newH-oldH),
2017-05-21 12:25:06 -05:00
)))
2017-03-05 17:28:52 -06:00
})
2017-03-14 12:31:44 -05:00
w.canvas.SetBounds(w.bounds)
mainthread.Call(func() {
w.begin()
2017-04-22 06:15:57 -05:00
framebufferWidth, framebufferHeight := w.window.GetFramebufferSize()
glhf.Bounds(0, 0, framebufferWidth, framebufferHeight)
2017-03-05 17:28:52 -06:00
2017-02-11 07:09:47 -06:00
glhf.Clear(0, 0, 0, 0)
w.canvas.gf.Frame().Begin()
w.canvas.gf.Frame().Blit(
2017-03-05 17:28:52 -06:00
nil,
0, 0, w.canvas.Texture().Width(), w.canvas.Texture().Height(),
2017-04-22 06:15:57 -05:00
0, 0, framebufferWidth, framebufferHeight,
2017-03-05 17:28:52 -06:00
)
w.canvas.gf.Frame().End()
2017-03-05 17:28:52 -06:00
if w.vsync {
2017-01-01 15:12:12 -06:00
glfw.SwapInterval(1)
2017-03-05 17:28:52 -06:00
} else {
glfw.SwapInterval(0)
2017-01-01 15:12:12 -06:00
}
w.window.SwapBuffers()
2017-01-15 18:12:03 -06:00
w.end()
2017-01-01 15:12:12 -06:00
})
2016-11-24 15:06:51 -06:00
}
2017-01-25 11:55:17 -06:00
// SetClosed sets the closed flag of the Window.
//
2017-03-15 18:45:04 -05:00
// This is useful when overriding the user's attempt to close the Window, or just to close the
2017-01-25 11:55:17 -06:00
// Window from within the program.
func (w *Window) SetClosed(closed bool) {
mainthread.Call(func() {
w.window.SetShouldClose(closed)
})
}
2017-01-25 11:55:17 -06:00
// Closed returns the closed flag of the Window, which reports whether the Window should be closed.
//
2017-01-25 11:55:17 -06:00
// The closed flag is automatically set when a user attempts to close the Window.
func (w *Window) Closed() bool {
var closed bool
mainthread.Call(func() {
closed = w.window.ShouldClose()
})
return closed
}
2017-01-25 11:55:17 -06:00
// SetTitle changes the title of the Window.
2016-11-24 15:06:51 -06:00
func (w *Window) SetTitle(title string) {
mainthread.Call(func() {
w.window.SetTitle(title)
2016-11-24 15:06:51 -06:00
})
}
2017-03-15 16:55:43 -05:00
// SetBounds sets the bounds of the Window in pixels. Bounds can be fractional, but the actual size
// of the window will be rounded to integers.
2017-03-05 17:28:52 -06:00
func (w *Window) SetBounds(bounds pixel.Rect) {
w.bounds = bounds
mainthread.Call(func() {
2017-03-07 10:45:46 -06:00
_, _, width, height := intBounds(bounds)
2017-03-05 17:28:52 -06:00
w.window.SetSize(width, height)
2016-11-24 15:06:51 -06:00
})
}
2017-10-27 13:28:28 -05:00
// SetPos sets the position, in screen coordinates, of the upper-left corner
// of the client area of the window. Position can be fractional, but the actual position
// of the window will be rounded to integers.
//
// If it is a full screen window, this function does nothing.
func (w *Window) SetPos(pos pixel.Vec) {
mainthread.Call(func() {
left, top := int(pos.X), int(pos.Y)
w.window.SetPos(left, top)
})
}
2017-11-19 18:37:22 -06:00
// GetPos gets the position, in screen coordinates, of the upper-left corner
// of the client area of the window. The position is rounded to integers.
func (w *Window) GetPos() pixel.Vec {
var v pixel.Vec
mainthread.Call(func() {
x, y := w.window.GetPos()
v = pixel.V(float64(x), float64(y))
})
return v
}
2017-03-05 17:28:52 -06:00
// Bounds returns the current bounds of the Window.
func (w *Window) Bounds() pixel.Rect {
return w.bounds
2016-11-24 15:06:51 -06:00
}
func (w *Window) setFullscreen(monitor *Monitor) {
mainthread.Call(func() {
w.restore.xpos, w.restore.ypos = w.window.GetPos()
w.restore.width, w.restore.height = w.window.GetSize()
mode := monitor.monitor.GetVideoMode()
w.window.SetMonitor(
monitor.monitor,
0,
0,
mode.Width,
mode.Height,
mode.RefreshRate,
)
})
}
func (w *Window) setWindowed() {
mainthread.Call(func() {
w.window.SetMonitor(
nil,
w.restore.xpos,
w.restore.ypos,
w.restore.width,
w.restore.height,
0,
)
})
}
2017-01-25 11:55:17 -06:00
// SetMonitor sets the Window fullscreen on the given Monitor. If the Monitor is nil, the Window
2017-03-15 16:55:43 -05:00
// will be restored to windowed state instead.
2016-11-24 15:06:51 -06:00
//
2017-03-15 16:55:43 -05:00
// The Window will be automatically set to the Monitor's resolution. If you want a different
// resolution, you will need to set it manually with SetBounds method.
func (w *Window) SetMonitor(monitor *Monitor) {
2016-11-24 15:06:51 -06:00
if w.Monitor() != monitor {
if monitor != nil {
w.setFullscreen(monitor)
2016-11-24 15:06:51 -06:00
} else {
w.setWindowed()
2016-11-24 15:06:51 -06:00
}
}
}
2017-03-15 16:55:43 -05:00
// Monitor returns a monitor the Window is fullscreen on. If the Window is not fullscreen, this
// function returns nil.
2016-11-24 15:06:51 -06:00
func (w *Window) Monitor() *Monitor {
var monitor *glfw.Monitor
mainthread.Call(func() {
monitor = w.window.GetMonitor()
})
2016-11-24 15:06:51 -06:00
if monitor == nil {
return nil
}
return &Monitor{
monitor: monitor,
}
2016-11-23 16:12:23 -06:00
}
2017-01-25 11:55:17 -06:00
// Focused returns true if the Window has input focus.
2016-11-24 15:06:51 -06:00
func (w *Window) Focused() bool {
var focused bool
mainthread.Call(func() {
focused = w.window.GetAttrib(glfw.Focused) == glfw.True
})
return focused
2016-11-24 15:06:51 -06:00
}
2017-03-15 16:55:43 -05:00
// SetVSync sets whether the Window's Update should synchronize with the monitor refresh rate.
2017-03-05 17:28:52 -06:00
func (w *Window) SetVSync(vsync bool) {
w.vsync = vsync
}
// VSync returns whether the Window is set to synchronize with the monitor refresh rate.
func (w *Window) VSync() bool {
return w.vsync
}
2017-04-30 11:33:27 -05:00
// SetCursorVisible sets the visibility of the mouse cursor inside the Window client area.
2017-04-30 09:40:31 -05:00
func (w *Window) SetCursorVisible(visible bool) {
w.cursorVisible = visible
mainthread.Call(func() {
2017-04-30 11:33:27 -05:00
if visible {
2017-04-30 09:40:31 -05:00
w.window.SetInputMode(glfw.CursorMode, glfw.CursorNormal)
2017-04-30 11:33:27 -05:00
} else {
2017-04-30 09:40:31 -05:00
w.window.SetInputMode(glfw.CursorMode, glfw.CursorHidden)
}
})
}
2020-02-07 17:22:39 -06:00
// SetCursorDisabled hides the cursor and provides unlimited virtual cursor movement
// make cursor visible using SetCursorVisible
func (w *Window) SetCursorDisabled() {
2020-09-12 12:56:39 -05:00
w.cursorVisible = false
mainthread.Call(func() {
w.window.SetInputMode(glfw.CursorMode, glfw.CursorDisabled)
})
2020-01-08 23:24:48 -06:00
}
2017-04-30 11:33:27 -05:00
// CursorVisible returns the visibility status of the mouse cursor.
2017-04-30 09:40:31 -05:00
func (w *Window) CursorVisible() bool {
return w.cursorVisible
}
// Note: must be called inside the main thread.
func (w *Window) begin() {
2017-03-15 18:15:39 -05:00
if currWin != w {
2017-01-01 15:12:12 -06:00
w.window.MakeContextCurrent()
2017-03-15 18:15:39 -05:00
currWin = w
2017-01-01 15:12:12 -06:00
}
}
2016-11-23 16:12:23 -06:00
// Note: must be called inside the main thread.
func (w *Window) end() {
2017-01-25 11:55:17 -06:00
// nothing, really
}
2017-03-05 17:28:52 -06:00
// MakeTriangles generates a specialized copy of the supplied Triangles that will draw onto this
// Window.
//
2017-03-15 16:55:43 -05:00
// Window supports TrianglesPosition, TrianglesColor and TrianglesPicture.
func (w *Window) MakeTriangles(t pixel.Triangles) pixel.TargetTriangles {
return w.canvas.MakeTriangles(t)
}
2017-03-05 17:28:52 -06:00
// MakePicture generates a specialized copy of the supplied Picture that will draw onto this Window.
//
2017-04-08 11:05:50 -05:00
// Window supports PictureColor.
2017-03-05 17:28:52 -06:00
func (w *Window) MakePicture(p pixel.Picture) pixel.TargetPicture {
return w.canvas.MakePicture(p)
}
// SetMatrix sets a Matrix that every point will be projected by.
func (w *Window) SetMatrix(m pixel.Matrix) {
w.canvas.SetMatrix(m)
}
2017-03-05 17:28:52 -06:00
// SetColorMask sets a global color mask for the Window.
func (w *Window) SetColorMask(c color.Color) {
w.canvas.SetColorMask(c)
2016-12-02 11:17:40 -06:00
}
2017-04-09 17:41:48 -05:00
// SetComposeMethod sets a Porter-Duff composition method to be used in the following draws onto
// this Window.
func (w *Window) SetComposeMethod(cmp pixel.ComposeMethod) {
w.canvas.SetComposeMethod(cmp)
}
2017-03-05 17:28:52 -06:00
// SetSmooth sets whether the stretched Pictures drawn onto this Window should be drawn smooth or
// pixely.
func (w *Window) SetSmooth(smooth bool) {
w.canvas.SetSmooth(smooth)
2016-11-23 16:12:23 -06:00
}
2016-12-01 18:20:54 -06:00
2017-03-05 17:28:52 -06:00
// Smooth returns whether the stretched Pictures drawn onto this Window are set to be drawn smooth
// or pixely.
func (w *Window) Smooth() bool {
return w.canvas.Smooth()
2016-12-01 18:20:54 -06:00
}
2017-03-15 16:55:43 -05:00
// Clear clears the Window with a single color.
2017-03-05 17:28:52 -06:00
func (w *Window) Clear(c color.Color) {
w.canvas.Clear(c)
2016-12-01 18:20:54 -06:00
}
2017-04-02 12:08:48 -05:00
// Color returns the color of the pixel over the given position inside the Window.
func (w *Window) Color(at pixel.Vec) pixel.RGBA {
2017-04-02 12:08:48 -05:00
return w.canvas.Color(at)
}
// Canvas returns the window's underlying Canvas
func (w *Window) Canvas() *Canvas {
return w.canvas
}
// Show makes the window visible, if it was previously hidden. If the window is
// already visible or is in full screen mode, this function does nothing.
func (w *Window) Show() {
mainthread.Call(func() {
w.window.Show()
})
}
2020-09-12 12:56:39 -05:00
// Clipboard returns the contents of the system clipboard.
func (w *Window) Clipboard() string {
var clipboard string
mainthread.Call(func() {
clipboard = w.window.GetClipboardString()
})
return clipboard
}
// SetClipboardString sets the system clipboard to the specified UTF-8 encoded string.
func (w *Window) SetClipboard(str string) {
mainthread.Call(func() {
w.window.SetClipboardString(str)
})
}