New API to make a resizable window

We have introduced these new APIs in the master branch:

• Game interface
• RunGame function
• SetWindowResizable function
• IsWindowResizable function
• SetWindowSize function
• WindowSize function

You can create a resizable window by calling SetWindowResizable(true). You can specify how the screen size will be updated after resizing the window by Game's Layout function. The notion of the screen scale is deprecated, which means that you should not have to care about the screen scale.

There has been a request to have a resizable window by the user for a few years. While implementation is not difficult, we hesitated to introduce the API because there is no clear answer what is the best behavior. When a window size is changed by the user, should the game (logical) screen also be resized, or be the same but the scale should be updated? Both would make sense and be useful. There was no clear answer which is better.

Changing the window size is actually a new notion to Ebiten. Ebiten has SetScreenSize and SetScreenScale. SetScreenSize changes the logical screen size, and SetScreenScale changes the scale without changing the logical size. Both change the window size as a side effect. Both work only with window mode on desktops, and not with fullscreen mode or browsers or mobiles. There is no API to change the window size directly so far.

Game has Update function and Layout function. Update proceeds the game state. Update is called every frame (per 1/60 [s] by default). This is the same as the function given to Run. Layout calculates the logical screen size based on the given outside size. The unit is device-independent pixels. The outside size is a window size on desktops (window mode). The scale is automatically adjusted based on the returned screen scale.

Actually the mobile environments already has the same interface.

RunGame is a very similar function to Run, but takes a Game instead of an updating function. RunGame does not determine the window size, so you have to call SetWindowSize before RunGame if necessary. Otherwise, a default window size is adopted. RunGame also does not take a window title, so you have to call SetWindowTitle instead.

func (g *Game) Layout(outsideWidth, outsideHeight int)
        (screenWidth, screenHeight int) {
    return outsideWidth, outsideHeight
}

If Layout returns the outside size without changing them, the game screen size is adjusted to the outside size without changing the scale.

func (g *Game) Layout(outsideWidth, outsideHeight int)
        (screenWidth, screenHeight int) {
    return 320, 240
}

If Layout returns ignores the outside size and returns a fixed size, the game screen size is not changed but the screen scale is adjusted instead.

Layout implementation now can determine which way the game adopts. Besides, you can do more complex things by implementing your own logic!