g3n-engine/window/window.go

// Copyright 2016 The G3N Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// Package window abstracts a platform-specific window.
// Depending on the build tags it can be a GLFW desktop window or a browser WebGlCanvas.
package window

import (
	"fmt"

	"github.com/g3n/engine/core"
	"github.com/g3n/engine/gls"
	"github.com/g3n/engine/util/logger"
)

// Package logger
var log = logger.New("WIN", logger.Default)

// IWindow singleton
var win IWindow

// Get returns the IWindow singleton.
func Get() IWindow {
	// Return singleton if already created
	if win != nil {
		return win
	}
	panic(fmt.Errorf("need to call window.Init() first"))
}

// IWindow is the interface for all windows
type IWindow interface {
	core.IDispatcher
	Gls() *gls.GLS
	GetFramebufferSize() (width int, height int)
	GetSize() (width int, height int)
	GetScale() (x float64, y float64)
	CreateCursor(imgFile string, xhot, yhot int) (Cursor, error)
	SetCursor(cursor Cursor)
	SetCursorMode(mode CursorMode)
	DisposeAllCustomCursors()
	Destroy()
	FullScreen() bool
	SetFullScreen(full bool)
}

// Key corresponds to a keyboard key.
type Key int

// ModifierKey corresponds to a set of modifier keys (bitmask).
type ModifierKey int

// MouseButton corresponds to a mouse button.
type MouseButton int

// InputMode corresponds to an input mode.
type InputMode int

// InputMode corresponds to an input mode.
type CursorMode int

// Cursor corresponds to a g3n standard or user-created cursor icon.
type Cursor int

// Standard cursors for G3N.
const (
	ArrowCursor = Cursor(iota)
	IBeamCursor
	CrosshairCursor
	HandCursor
	HResizeCursor
	VResizeCursor
	DiagResize1Cursor
	DiagResize2Cursor
	CursorLast = DiagResize2Cursor
)

// Window event names. See availability per platform below ("x" indicates available).
const ( //                               Desktop | Browser |
	OnWindowFocus = "w.OnWindowFocus" //    x    |    x    |
	OnWindowPos   = "w.OnWindowPos"   //    x    |         |
	OnWindowSize  = "w.OnWindowSize"  //    x    |         |
	OnKeyUp       = "w.OnKeyUp"       //    x    |    x    |
	OnKeyDown     = "w.OnKeyDown"     //    x    |    x    |
	OnKeyRepeat   = "w.OnKeyRepeat"   //    x    |         |
	OnChar        = "w.OnChar"        //    x    |    x    |
	OnCursor      = "w.OnCursor"      //    x    |    x    |
	OnMouseUp     = "w.OnMouseUp"     //    x    |    x    |
	OnMouseDown   = "w.OnMouseDown"   //    x    |    x    |
	OnScroll      = "w.OnScroll"      //    x    |    x    |
	OnLockChange  = "w.OnLockChange"  //    x    |    x    |
)

// PosEvent describes a windows position changed event
type PosEvent struct {
	Xpos int
	Ypos int
}

// SizeEvent describers a window size changed event
type SizeEvent struct {
	Width  int
	Height int
}

// KeyEvent describes a window key event
type KeyEvent struct {
	Key  Key
	Mods ModifierKey
}

// CharEvent describes a window char event
type CharEvent struct {
	Char rune
	Mods ModifierKey
}

// MouseEvent describes a mouse event over the window
type MouseEvent struct {
	Xpos   float32
	Ypos   float32
	Button MouseButton
	Mods   ModifierKey
}

// CursorEvent describes a cursor position changed event
type CursorEvent struct {
	Xpos float32
	Ypos float32
	Mods ModifierKey
}

// ScrollEvent describes a scroll event
type ScrollEvent struct {
	Xoffset float32
	Yoffset float32
	Mods    ModifierKey
}

// FocusEvent describes a focus event
type FocusEvent struct {
	Focused bool
}

// LockEvent describes if cursor is locked or not
type LockEvent struct {
	Locked bool
}