A GO GUI package
Go to file
Jeff Carr 40ad372361 gocui: simple grid working
Signed-off-by: Jeff Carr <jcarr@wit.com>
2023-04-03 17:49:37 -05:00
cmds gocui: simple grid working 2023-04-03 17:49:37 -05:00
debian Squashed commit of the following: 2023-03-23 12:35:12 -05:00
log add semi-working gocui 2023-03-29 23:03:04 -05:00
toolkit gocui: simple grid working 2023-04-03 17:49:37 -05:00
.gitignore Squashed commit of the following: 2023-03-12 08:47:16 -05:00
LICENSE The debugging window is finally useful 2023-02-25 14:05:25 -06:00
Makefile gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
README-goreadme.md gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
README.md The debugging window is finally useful 2023-02-25 14:05:25 -06:00
button.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
chan.go add semi-working gocui 2023-03-29 23:03:04 -05:00
checkbox.go add semi-working gocui 2023-03-29 23:03:04 -05:00
common.go 'hide' and 'show' works in gocui 2023-03-30 08:51:33 -05:00
debug.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
debugFlags.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
debugGochan.go Squashed commit of the following: 2023-03-23 12:35:12 -05:00
debugGolang.go Squashed commit of the following: 2023-03-23 12:35:12 -05:00
debugWidget.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
debugWindow.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
direct.go lots cleaner code between the plugin 2023-03-01 11:35:36 -06:00
doc.go The debugging window is finally useful 2023-02-25 14:05:25 -06:00
dropdown.go add semi-working gocui 2023-03-29 23:03:04 -05:00
example_test.go REFACTOR: refactor everything to gui.Node struct 2021-10-31 14:21:36 -05:00
go.mod Squashed commit of the following: 2023-03-12 08:47:16 -05:00
go.sum Squashed commit of the following: 2023-03-12 08:47:16 -05:00
grid.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
group.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
image.go add semi-working gocui 2023-03-29 23:03:04 -05:00
int.go Squashed commit of the following: 2023-03-23 12:35:12 -05:00
label.go add semi-working gocui 2023-03-29 23:03:04 -05:00
log.go add semi-working gocui 2023-03-29 23:03:04 -05:00
main.go add semi-working gocui 2023-03-29 23:03:04 -05:00
node.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
plugin.go add semi-working gocui 2023-03-29 23:03:04 -05:00
redraw.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00
slider.go gocui: more size debugging 2023-04-03 16:32:01 -05:00
spinner.go gocui: more size debugging 2023-04-03 16:32:01 -05:00
structs.go add semi-working gocui 2023-03-29 23:03:04 -05:00
tab.go add semi-working gocui 2023-03-29 23:03:04 -05:00
textbox.go gocui: more size debugging 2023-04-03 16:32:01 -05:00
watchdog.go The debugging window is finally useful 2023-02-25 14:05:25 -06:00
window.go gocui: working towards correct layout 2023-04-03 10:26:47 -05:00

README.md

gui

Package gui implements a abstraction layer for Go visual elements.

Definitions:

  • Toolkit: the underlying GUI library (MacOS gui, Windows gui, gtk, qt, etc)
  • Node: A binary tree of all the underlying widgets

Principles:

  • Make code using this package simple to use
  • Hide complexity internally here
  • Isolate the GUI toolkit
  • Widget names should try to match [Wikipedia Graphical widget]
  • When in doubt, search upward in the binary tree
  • It's ok to guess. Try to do something sensible.

Quick Start

// This creates a simple hello world window
package main

import 	(
	"log"
	"git.wit.org/wit/gui"
)

var window *gui.Node // This is the beginning of the binary tree of widgets

// go will sit here until the window exits
func main() {
	gui.Init()
	gui.Main(helloworld)
}

// This initializes the first window and 2 tabs
func helloworld() {
	gui.Config.Title = "Hello World golang wit/gui Window"
	gui.Config.Width = 640
	gui.Config.Height = 480

	window := gui.NewWindow()
	addTab(window, "A Simple Tab Demo")
	addTab(window, "A Second Tab")
}

func addTab(w *gui.Node, title string) {
	tab := w.NewTab(title)

	group := tab.NewGroup("foo bar")
	group.NewButton("hello", func() {
		log.Println("world")
	})
}

Debian Build

This worked on debian sid on 2022/10/20 I didn't record the dependances needed

GO111MODULE="off" go get -v -t -u git.wit.org/wit/gui
cd ~/go/src/git.wit.org/wit/gui/cmds/helloworld/
GO111MODULE="off" go build -v -x
[./helloworld](./helloworld)

Toolkits

The next step is to allow this to work against go-gtk and go-qt.

TODO: Add Fyne, WASM, native macos & windows, android and hopefully also things like libSDL, faiface/pixel, slint

Bugs

"The author's idea of friendly may differ to that of many other people."

-- quote from the minimalistic window manager 'evilwm'

References

Useful links and other external things which might be useful

Functions

func GetDebug

func GetDebug() bool

func GetDebugToolkit

func GetDebugToolkit() bool

func IndentPrintln

func IndentPrintln(a ...interface{})

func Init

func Init()

func LoadToolkit

func LoadToolkit(name string)

loads and initializes a toolkit (andlabs/ui, gocui, etc)

func Main

func Main(f func())

func Queue

func Queue(f func())

Other goroutines must use this to access the GUI

You can not acess / process the GUI thread directly from other goroutines. This is due to the nature of how Linux, MacOS and Windows work (they all work differently. suprise. surprise.) For example: gui.Queue(NewWindow())

func SetDebug

func SetDebug(s bool)

func SetDebugToolkit

func SetDebugToolkit(s bool)

func ShowDebugValues

func ShowDebugValues()

func StandardClose

func StandardClose(n *Node)

The window is destroyed but the application does not quit

func StandardExit

func StandardExit(n *Node)

The window is destroyed but the application does not quit

func Watchdog

func Watchdog()

This program sits here. If you exit here, the whole thing will os.Exit()

This goroutine can be used like a watchdog timer

Types

type GuiConfig

type GuiConfig struct { ... }

Variables

var Config GuiConfig

type GuiOptions

type GuiOptions struct { ... }

This struct can be used with go-arg

type Node

type Node struct { ... }

The Node is simply the name and the size of whatever GUI element exists

func NewWindow

func NewWindow() *Node

This routine creates a blank window with a Title and size (W x H)

This routine can not have any arguements due to the nature of how it can be passed via the 'andlabs/ui' queue which, because it is cross platform, must pass UI changes into the OS threads (that is my guess).

type Symbol

type Symbol any

Sub Packages


Readme created from Go doc with goreadme