// Copyright 2022 The Ebiten Authors // // 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 ui import ( "errors" "image" "sync" "sync/atomic" "github.com/hajimehoshi/ebiten/v2/internal/atlas" "github.com/hajimehoshi/ebiten/v2/internal/mipmap" ) // RegularTermination represents a regular termination. // Run can return this error, and if this error is received, // the game loop should be terminated as soon as possible. var RegularTermination = errors.New("regular termination") type FPSModeType int const ( FPSModeVsyncOn FPSModeType = iota FPSModeVsyncOffMaximum FPSModeVsyncOffMinimum ) type CursorMode int const ( CursorModeVisible CursorMode = iota CursorModeHidden CursorModeCaptured ) type CursorShape int const ( CursorShapeDefault CursorShape = iota CursorShapeText CursorShapeCrosshair CursorShapePointer CursorShapeEWResize CursorShapeNSResize CursorShapeNESWResize CursorShapeNWSEResize CursorShapeMove CursorShapeNotAllowed ) type WindowResizingMode int const ( WindowResizingModeDisabled WindowResizingMode = iota WindowResizingModeOnlyFullscreenEnabled WindowResizingModeEnabled ) type UserInterface struct { err error errM sync.Mutex isScreenClearedEveryFrame int32 graphicsLibrary int32 whiteImage *Image userInterfaceImpl } var ( theUI *UserInterface ) func init() { // newUserInterface() must be called in the main goroutine. u, err := newUserInterface() if err != nil { panic(err) } theUI = u } func Get() *UserInterface { return theUI } // newUserInterface must be called from the main thread. func newUserInterface() (*UserInterface, error) { u := &UserInterface{ isScreenClearedEveryFrame: 1, graphicsLibrary: int32(GraphicsLibraryUnknown), } u.whiteImage = u.NewImage(3, 3, atlas.ImageTypeRegular) pix := make([]byte, 4*u.whiteImage.width*u.whiteImage.height) for i := range pix { pix[i] = 0xff } // As a white image is used at Fill, use WritePixels instead. u.whiteImage.WritePixels(pix, image.Rect(0, 0, u.whiteImage.width, u.whiteImage.height)) if err := u.init(); err != nil { return nil, err } return u, nil } func (u *UserInterface) readPixels(mipmap *mipmap.Mipmap, pixels []byte, region image.Rectangle) error { ok, err := mipmap.ReadPixels(u.graphicsDriver, pixels, region) if err != nil { return err } // ReadPixels failed since this was called in between two frames. // Try this again at the next frame. if !ok { ch := make(chan error) u.context.appendDeferredFunc(func() { defer close(ch) ok, err := mipmap.ReadPixels(u.graphicsDriver, pixels, region) if err != nil { ch <- err return } if !ok { // This never reaches since this function must be called in a frame. panic("ui: ReadPixels unexpectedly failed") } }) // If this function is called from the game (Update/Draw) goroutine in between two frames, // this channel never returns and causes a dead lock. // This never happens so far, but if handling inputs after EndFrame is implemented, // this might be possible (#1704). return <-ch } return nil } func (u *UserInterface) dumpScreenshot(mipmap *mipmap.Mipmap, name string, blackbg bool) (string, error) { return mipmap.DumpScreenshot(u.graphicsDriver, name, blackbg) } func (u *UserInterface) dumpImages(dir string) (string, error) { return atlas.DumpImages(u.graphicsDriver, dir) } type RunOptions struct { GraphicsLibrary GraphicsLibrary InitUnfocused bool ScreenTransparent bool SkipTaskbar bool } // InitialWindowPosition returns the position for centering the given second width/height pair within the first width/height pair. func InitialWindowPosition(mw, mh, ww, wh int) (x, y int) { return (mw - ww) / 2, (mh - wh) / 3 } func (u *UserInterface) error() error { u.errM.Lock() defer u.errM.Unlock() return u.err } func (u *UserInterface) setError(err error) { u.errM.Lock() defer u.errM.Unlock() if u.err == nil { u.err = err } } func (u *UserInterface) IsScreenClearedEveryFrame() bool { return atomic.LoadInt32(&u.isScreenClearedEveryFrame) != 0 } func (u *UserInterface) SetScreenClearedEveryFrame(cleared bool) { v := int32(0) if cleared { v = 1 } atomic.StoreInt32(&u.isScreenClearedEveryFrame, v) } func (u *UserInterface) setGraphicsLibrary(library GraphicsLibrary) { atomic.StoreInt32(&u.graphicsLibrary, int32(library)) } func (u *UserInterface) GraphicsLibrary() GraphicsLibrary { return GraphicsLibrary(atomic.LoadInt32(&u.graphicsLibrary)) }