device

Documentation

Index

• type Device
  • func New(windowed bool, title string, x int32, y int32, w int32, h int32) *Device
  • func (d *Device) CreateDisplay() error
  • func (d *Device) Dispose()
  • func (d *Device) GetInput() *Input
  • func (d *Device) IsRunning() bool
  • func (d *Device) SetResizeHandler(callback func())
  • func (d *Device) SurfaceLocation() (x, y int32)
  • func (d *Device) SurfaceSize() (w, h uint32)
  • func (d *Device) ToggleFullscreen()
• type Input

Types

type Device

type Device struct {
	// contains filtered or unexported fields
}

Device provides access to a platform specific user input and display surface.

func New

func New(windowed bool, title string, x int32, y int32, w int32, h int32) *Device

New creates the platform for the current host.

func (*Device) CreateDisplay

func (d *Device) CreateDisplay() error

CreateDisplay initializes a window. Called once at initialization.

func (*Device) Dispose

func (d *Device) Dispose()

Dispose releases all platform specific resources.

func (*Device) GetInput

func (d *Device) GetInput() *Input

GetInput updates the user input. Expected to be called frequently, ie: once before each game update.

func (*Device) IsRunning

func (d *Device) IsRunning() bool

IsRunning returns true if the app is still running.

func (*Device) SetResizeHandler

func (d *Device) SetResizeHandler(callback func())

SetResizeHandler registers a callback to do stuff any time the window is resized.

func (*Device) SurfaceLocation

func (d *Device) SurfaceLocation() (x, y int32)

Returns the upper corner location of the surface in pixels. Consistent with the values provided in device.New().

func (*Device) SurfaceSize

func (d *Device) SurfaceSize() (w, h uint32)

Returns the size of the surface in pixels.

func (*Device) ToggleFullscreen

func (d *Device) ToggleFullscreen()

ToggleFullscreen toggles between windowed with border and windowed fullscreen with no border.

type Input

type Input struct {
	Mx, My int32 // Mouse location relative to top left.
	Scroll int   // Scroll amount: positive, negative, or Zero if no scrolling.
	Focus  bool  // True if window has focus.

	// Pressed are keys that were pressed since last request.
	Pressed map[int32]bool //

	// Down are keys that are currently being pressed.
	// This includes keys that were just pressed and which
	// are being held down. The value can be used to calculate
	// how long the key has been down.
	// Down keys are cleared when the key is
	// released or when the windows looses focus.
	Down map[int32]time.Time // time when key was pressed.

	// Released are keys that were just released since last request.
	// Keys are also released when the window loses focus.
	Released map[int32]time.Duration // total time down.
	// contains filtered or unexported fields
}

Input gathers user input and organizes it for mapping to game actions. Input data is shared with the app and the app should treat the data as read only.