go-opengl-pixel/pixelgl/run.go

38 lines
1.0 KiB
Go
Raw Normal View History

package pixelgl
2016-11-25 10:45:24 -06:00
import (
"github.com/faiface/mainthread"
2016-11-25 10:45:24 -06:00
"github.com/go-gl/glfw/v3.2/glfw"
2017-01-25 20:33:48 -06:00
"github.com/pkg/errors"
2016-11-25 10:45:24 -06:00
)
// Run is essentialy the "main" function of Pixel. It exists mainly due to the technical
2017-01-25 11:55:17 -06:00
// limitations of OpenGL and operating systems. In short, all graphics and window manipulating
// calls must be done from the main thread. Run makes this possible.
2016-11-25 10:45:24 -06:00
//
// Call this function from the main function of your application. This is necessary, so that
// Run runs on the main thread.
2016-11-25 10:45:24 -06:00
//
// func run() {
// window := pixel.NewWindow(...)
// for {
// // your game's main loop
// }
// }
//
// func main() {
// pixel.Run(run)
// }
//
// You can spawn any number of goroutines from you run function and interact with Pixel
2017-01-25 11:55:17 -06:00
// concurrently. The only condition is that the Run function is be called from your main
// function.
2016-11-25 16:12:01 -06:00
func Run(run func()) {
2017-01-25 20:33:48 -06:00
err := glfw.Init()
if err != nil {
panic(errors.Wrap(err, "failed to initialize GLFW"))
}
2016-11-25 10:45:24 -06:00
defer glfw.Terminate()
mainthread.Run(run)
2016-11-25 10:45:24 -06:00
}