55 lines
1.6 KiB
Go
55 lines
1.6 KiB
Go
package tomo
|
|
|
|
import "errors"
|
|
|
|
var backend Backend
|
|
|
|
// Run initializes a backend, calls the callback function, and begins the event
|
|
// loop in that order. This function does not return until Stop() is called, or
|
|
// the backend experiences a fatal error.
|
|
func Run (callback func ()) (err error) {
|
|
backend, err = instantiateBackend()
|
|
if callback != nil { callback() }
|
|
err = backend.Run()
|
|
backend = nil
|
|
return
|
|
}
|
|
|
|
// Stop gracefully stops the event loop and shuts the backend down. Call this
|
|
// before closing your application.
|
|
func Stop () {
|
|
if backend != nil { backend.Stop() }
|
|
}
|
|
|
|
// Do executes the specified callback within the main thread as soon as
|
|
// possible. This function can be safely called from other threads.
|
|
func Do (callback func ()) {
|
|
if backend == nil { panic("no backend is running") }
|
|
backend.Do(callback)
|
|
}
|
|
|
|
// NewWindow creates a new window using the current backend, and returns it as a
|
|
// Window. If the window could not be created, an error is returned explaining
|
|
// why. If this function is called without a running backend, an error is
|
|
// returned as well.
|
|
func NewWindow (width, height int) (window Window, err error) {
|
|
if backend == nil {
|
|
err = errors.New("no backend is running.")
|
|
return
|
|
}
|
|
return backend.NewWindow(width, height)
|
|
}
|
|
|
|
// Copy puts data into the clipboard.
|
|
func Copy (data Data) {
|
|
if backend == nil { panic("no backend is running") }
|
|
backend.Copy(data)
|
|
}
|
|
|
|
// Paste returns the data currently in the clipboard. This method may
|
|
// return nil.
|
|
func Paste () (data Data) {
|
|
if backend == nil { panic("no backend is running") }
|
|
return backend.Paste()
|
|
}
|