mirror of
https://github.com/hajimehoshi/ebiten.git
synced 2024-09-19 21:02:18 +02:00
7d56e4335e
This change introduces the new APIs RunGame, WindowSize and SetWindowSize. These new APIs hides the notion of 'scale', and is more flexible with the outside size change. This means that we can introduce a resizable window. This change also adds -legacy flag to examples/windowsize. If the flag is off, the new APIs are used. This change deprecates these functions since the notion of 'scale' is deprecated: * ScreenScale * ScreenSizeInFullscreen * SetScreenScale * SetScreenSize Fixes #943, #571 Updates #320
100 lines
3.6 KiB
Go
100 lines
3.6 KiB
Go
// Copyright 2014 Hajime Hoshi
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
// Package ebiten provides graphics and input API to develop a 2D game.
|
|
//
|
|
// You can start the game by calling the function RunGame.
|
|
//
|
|
// type Game struct{}
|
|
//
|
|
// // Update is called every frame (1/60 [s]).
|
|
// func (g *Game) Update(screen *ebiten.Image) error {
|
|
//
|
|
// // Write your game's logical update.
|
|
//
|
|
// if ebiten.IsDrawingSkipped() {
|
|
// // When the game is running slowly, the rendering result
|
|
// // will not be adopted.
|
|
// return nil
|
|
// }
|
|
//
|
|
// // Write your game's rendering.
|
|
//
|
|
// return nil
|
|
// }
|
|
//
|
|
// // Layout takes the outside size (e.g., the window size) and returns the (logical) screen size.
|
|
// // If you don't have to adjust the screen size with the outside size, just return a fixed size.
|
|
// func (g *Game) Layout(outsideWidth, outsideHeight int) (screenWidth, screenHeight int) {
|
|
// return 320, 240
|
|
// }
|
|
//
|
|
// func main() {
|
|
// // Sepcify the window size as you like. Here, a doulbed size is specified.
|
|
// ebiten.SetWindowSize(640, 480)
|
|
// ebiten.SetTitle("Your game's title")
|
|
// // Call ebiten.RunGame to start your game loop.
|
|
// if err := ebiten.Run(game); err != nil {
|
|
// log.Fatal(err)
|
|
// }
|
|
// }
|
|
//
|
|
// For backward compatibility, you can use a shorthand style Run.
|
|
//
|
|
// // update is called every frame (1/60 [s]).
|
|
// func update(screen *ebiten.Image) error {
|
|
//
|
|
// // Write your game's logical update.
|
|
//
|
|
// if ebiten.IsDrawingSkipped() {
|
|
// // When the game is running slowly, the rendering result
|
|
// // will not be adopted.
|
|
// return nil
|
|
// }
|
|
//
|
|
// // Write your game's rendering.
|
|
//
|
|
// return nil
|
|
// }
|
|
//
|
|
// func main() {
|
|
// // Call ebiten.Run to start your game loop.
|
|
// if err := ebiten.Run(update, 320, 240, 2, "Your game's title"); err != nil {
|
|
// log.Fatal(err)
|
|
// }
|
|
// }
|
|
//
|
|
// In the API document, 'the main thread' means the goroutine in init(), main() and their callees without 'go'
|
|
// statement. It is assured that 'the main thread' runs on the OS main thread. There are some Ebiten functions that
|
|
// must be called on the main thread under some conditions (typically, before ebiten.Run is called).
|
|
//
|
|
// Environment variables
|
|
//
|
|
// `EBITEN_SCREENSHOT_KEY` environment variable specifies the key
|
|
// to take a screenshot. For example, if you run your game with
|
|
// `EBITEN_SCREENSHOT_KEY=q`, you can take a game screen's screenshot
|
|
// by pressing Q key. This works only on desktops.
|
|
//
|
|
// `EBITEN_INTERNAL_IMAGES_KEY` environment variable specifies the key
|
|
// to dump all the internal images. This is valid only when the build tag
|
|
// 'ebitendebug' is specified. This works only on desktops.
|
|
//
|
|
// Build tags
|
|
//
|
|
// `ebitendebug` outputs a log of graphics commands. This is useful to know what happens in Ebiten. In general, the
|
|
// number of graphics commands affects the performance of your game.
|
|
//
|
|
// `ebitengl` forces to use OpenGL in any environments.
|
|
package ebiten
|