Application

The Lacking game engine provides a lightweight API for managing an application window. In many regards, it is similar to what GLFW or SDL2 provide. The benefits are that it is a more Go-oriented and simplified API that is abstract enough to support Web builds as well. The downside is that it does not include all of the advanced features that the forementioned libraries provide.

The API is described in the api package of the library. This package only includes an interface. To actually instantiate a working window, one must use one of the two available implementations:

• The similarly named app package in lacking-native provides a Desktop implementation (at the time of writing based on GLFW).
• The similarly named app package in lacking-js provides a Web implementation.

By having the an abstract API, one benefit is that the underlying implementation can be swapped. In fact, there were successful ports to the API to SDL2 but due to complexities in building so and dll files, it was rolled back in favour of GLFW.

In it's core, a developer need only implement the Controller interface, in order to get keyboard, mouse, etc. events and be able to make changes to the window object itself.

Following is a simple code for starting an app:

package main

import (
    nativeapp "github.com/mokiat/lacking-native/app"
    "github.com/mokiat/lacking/app"
)

func main() {
    if err := runApplication(); err != nil {
        panic(err)
    }
}

func runApplication() error {
    cfg := nativeapp.NewConfig("Example", 1024, 576)
    return nativeapp.Run(cfg, &CustomController{})
}

type CustomController struct {
    app.NopController
}

The CustomController in this cas eis the implementation of the Controller interface. It composes the app.NopController type, which provides no-op implementations for all methods of the interface. This allows one to override only relevant methods.

In a usual project, the built-in game.Controller and ui.Controller implementations would be used instead and developers would then use higher-order APIs.