Change clip behaviors to sub behaviors

Remedies #4

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = tab
+indent_size = 8
+charset = utf-8
+
+[*.md]
+indent_style = space
+indent_size = 2

README.md

@@ -2,4 +2,7 @@
 
 [![Go Reference](https://pkg.go.dev/badge/git.tebibyte.media/tomo/tomo.svg)](https://pkg.go.dev/git.tebibyte.media/tomo/tomo)
 
-Tomo is a lightweight GUI toolkit written in pure Go.
+Tomo is a lightweight GUI toolkit written in pure Go. This repository defines
+the API that other components of the toolkit agree on. In order to use Tomo in
+an application, use [Nasin](https://git.tebibyte.media/tomo/nasin), which builds
+an application framework on top of Tomo.

application.go

@@ -1,113 +0,0 @@
-package tomo
-
-import "image"
-
-// Application represents an application object.
-type Application interface {
-	// Describe returns a description of the application.
-	Describe () ApplicationDescription
-
-	// Init performs the initial setup of the application.
-	Init ()
-}
-
-// ApplicationDescription describes the name and type of an application.
-type ApplicationDescription struct {
-	// The name or ID of the application.
-	Name string
-
-	// Role describes what the application does.
-	Role ApplicationRole
-}
-
-// String satisfies the fmt.Stringer interface.
-func (application ApplicationDescription) String () string {
-	if application.Name == "" {
-		return application.Role.String()
-	} else {
-		return application.Name
-	}
-}
-
-// ApplicationRole describes what an application does.
-type ApplicationRole int; const (
-	RoleUnknown ApplicationRole = iota
-
-	RoleWebBrowser
-	RoleMesssanger
-	RolePhone
-	RoleMail
-
-	RoleTerminalEmulator
-	RoleFileBrowser
-	RoleTextEditor
-
-	RoleDocumentViewer
-	RoleWordProcessor
-	RoleSpreadsheet
-	RoleSlideshow
-	RoleCalculator
-
-	RolePreferences
-	RoleProcessManager
-	RoleSystemInformation
-	RoleManual
-
-	RoleCamera
-	RoleImageViewer
-	RoleMediaPlayer
-	RoleImageEditor
-	RoleAudioEditor
-	RoleVideoEditor
-
-	RoleClock
-	RoleCalendar
-	RoleChecklist
-)
-
-// String satisfies the fmt.Stringer interface.
-func (role ApplicationRole) String () string {
-	switch role {
-	case RoleWebBrowser:        return "Web Browser"
-	case RoleMesssanger:        return "Messsanger"
-	case RolePhone:             return "Phone"
-	case RoleMail:              return "Mail"
-	case RoleTerminalEmulator:  return "Terminal Emulator"
-	case RoleFileBrowser:       return "File Browser"
-	case RoleTextEditor:        return "Text Editor"
-	case RoleDocumentViewer:    return "Document Viewer"
-	case RoleWordProcessor:     return "Word Processor"
-	case RoleSpreadsheet:       return "Spreadsheet"
-	case RoleSlideshow:         return "Slideshow"
-	case RoleCalculator:        return "Calculator"
-	case RolePreferences:       return "Preferences"
-	case RoleProcessManager:    return "Process Manager"
-	case RoleSystemInformation: return "System Information"
-	case RoleManual:            return "Manual"
-	case RoleCamera:            return "Camera"
-	case RoleImageViewer:       return "Image Viewer"
-	case RoleMediaPlayer:       return "Media Player"
-	case RoleImageEditor:       return "Image Editor"
-	case RoleAudioEditor:       return "Audio Editor"
-	case RoleVideoEditor:       return "Video Editor"
-	case RoleClock:             return "Clock"
-	case RoleCalendar:          return "Calendar"
-	case RoleChecklist:         return "Checklist"
-	default:                    return "unknown"
-	}
-}
-
-// RunApplication is like Run, but runs an application.
-func RunApplication (application Application) error {
-	return Run(application.Init)
-}
-
-// NewApplicationWindow creates a window for an application. It will
-// automatically set window information to signal to the OS that the window is
-// owned by the application.
-func NewApplicationWindow (application Application, bounds image.Rectangle) (Window, error) {
-	window, err := NewWindow(bounds)
-	if err != nil { return nil, err }
-	window.SetTitle(application.Describe().String())
-	return window, nil
-}

backend.go

@@ -11,12 +11,19 @@ import "git.tebibyte.media/tomo/tomo/canvas"
 type Backend interface {
 	// These methods create new objects. The backend must reject any object
 	// that was not made by it.
-	NewWindow       (image.Rectangle) (MainWindow, error)
 	NewBox          () Box
 	NewTextBox      () TextBox
 	NewCanvasBox    () CanvasBox
 	NewContainerBox () ContainerBox
 
+	// NewWindow creates a normal MainWindow and returns it.
+	NewWindow (image.Rectangle) (MainWindow, error)
+
+	// NewPlainWindow creates an undecorated window that does not appear in
+	// window lists and returns it. This is intended for making things like
+	// panels, docks, etc.
+	NewPlainWindow (image.Rectangle) (MainWindow, error)
+
 	// NewTexture creates a new texture from an image. The backend must
 	// reject any texture that was not made by it.
 	NewTexture (image.Image) canvas.TextureCloser

canvas/canvas.go

@@ -8,9 +8,9 @@ import "image/color"
 
 // Cap represents a stroke cap type.
 type Cap int; const (
-	CapButt Cap = iota // Square cap that ends at the point
-	CapRound           // Round cap that surrounds the point
-	CapSquare          // square cap that surrounds the point
+	CapRound Cap = iota // Round cap that surrounds the point
+	CapSquare           // Square cap that surrounds the point
+	CapButt             // Square cap that ends at the point
 )
 
 // Joint represents a stroke joint type.
@@ -30,23 +30,38 @@ type StrokeAlign int; const (
 
 // Pen represents a drawing context that is linked to a canvas. Each canvas can
 // have multiple pens associated with it, each maintaining their own drawing
-// context.
+// state.
 type Pen interface {
-	// Rectangle draws a rectangle
+	// Rectangle draws a rectangle.
 	Rectangle (image.Rectangle)
 
-	// Path draws a path
+	// Path draws a path, which is a series of connected points.
 	Path (points ...image.Point)
 
-	Closed       (bool)        // if the path is closed
-	Cap          (Cap)         // line cap stype
-	Joint        (Joint)       // line joint style
-	StrokeWeight (int)         // how thick the stroke is
-	StrokeAlign  (StrokeAlign) // where the stroke is drawn
+	// StrokeWeight sets how thick the stroke is. The default value is zero.
+	StrokeWeight (int)
+	// SetClosed sets whether the path is a closed shape, or has an open
+	// side. This only applies if the stroke weight is greater than zero.
+	Closed (bool)
+	// Cap sets how the ends of the stroke look. This only applies if the
+	// stroke weight is greater than zero, and if the path is not closed.
+	// The default value is CapRound.
+	Cap (Cap)
+	// Joint sets how bend points in the stroke look. This only applies if
+	// the stroke weight is greater than zero. The default value is
+	// JointRound.
+	Joint (Joint)
+	// StrokeAlign sets where the stroke is drawn in relation to the path.
+	// This only applies if the stroke weight is greater than zero. The
+	// default value is StrokeAlignCenter.
+	StrokeAlign (StrokeAlign)
 
-	Stroke  (color.Color) // Sets the stroke to a solid color
-	Fill    (color.Color) // Sets the fill to a solid color
-	Texture (Texture)     // Overlaps a texture onto the fill color
+	// Stroke sets the stroke to a solid color.
+	Stroke (color.Color)
+	// Fill sets the fill to a solid color.
+	Fill (color.Color)
+	// Texture overlaps a texture onto the fill color.
+	Texture (Texture)
 }
 
 // Canvas is an image that supports drawing paths.
@@ -56,8 +71,10 @@ type Canvas interface {
 	// Pen returns a new pen for this canvas.
 	Pen () Pen
 
-	// Clip returns a new canvas that points to a specific area of this one.
-	Clip (image.Rectangle) Canvas
+	// SubCanvas returns a returns a Canvas representing the portion of this
+	// Canvas visible and drawable through a rectangle. The returned value
+	// shares pixels with the original Canvas.
+	SubCanvas (image.Rectangle) Canvas
 }
 
 // Drawer is an object that can draw to a canvas.

canvas/texture.go

@@ -7,9 +7,10 @@ import "image"
 type Texture interface {
 	image.Image
 
-	// Clip returns a smaller section of this texture, pointing to the same
-	// internal data.
-	Clip (image.Rectangle) Texture
+	// SubTexture returns a returns a Texture representing the portion of
+	// this Texture visible through a rectangle. The returned value shares
+	// pixels with the original Texture.
+	SubTexture (image.Rectangle) Texture
 }
 
 // TextureCloser is a texture that can be closed. Anything that receives a

object.go

@@ -101,7 +101,7 @@ type Align int; const (
 	AlignEven               // similar to justified text
 )
 
-// Object is any obscreen object. Each object must be linked to a box, even if
+// Object is any onscreen object. Each object must be linked to a box, even if
 // it is that box.
 type Object interface {
 	GetBox () Box
@@ -145,6 +145,12 @@ type Box interface {
 	// SetPadding sets the padding between the Box's innermost Border and
 	// its content.
 	SetPadding (Inset)
+	// SetVisible sets whether or not this box is visible. If invisible,
+	// it will not be drawn and no space will be created for it in the
+	// layout. Boxes are visible by default.
+	SetVisible (bool)
+	// Visible returns whether or not this box is visible.
+	Visible () bool
 
 	// SetDNDData sets the data that will be picked up if this Box is
 	// dragged. If this is nil (which is the default), this Box will not be
@@ -195,7 +201,12 @@ type CanvasBox interface {
 	Box
 
 	// SetDrawer sets the Drawer that will be called upon to draw the Box's
-	// content when it is invalidated.
+	// content when it is invalidated. The Canvas passed to the drawer will
+	// have these properties:
+	//   - It will have the same origin (0, 0) as the window which contains
+	//     the CanvasBox
+	//   - The Canvas bounds will describe the portion of the CanvasBox
+	//     visible on screen
 	SetDrawer (canvas.Drawer)
 
 	// Invalidate causes the Box's area to be redrawn at the end of the
@@ -216,7 +227,7 @@ type ContentBox interface {
 	// vertically.
 	SetAlign (x, y Align)
 	// ContentBounds returns the bounds of the inner content of the Box
-	// relative to the window.
+	// relative to the Box's InnerBounds.
 	ContentBounds () image.Rectangle
 	// ScrollTo shifts the origin of the Box's content to the origin of the
 	// Box's InnerBounds, offset by the given point.
@@ -258,30 +269,35 @@ type TextBox interface {
 type ContainerBox interface {
 	ContentBox
 
-	// SetPropagateEvents specifies whether or not child Objects will
-	// receive user input events. It is true by default. If it is false, all
-	// user input that would otherwise be directed to a child Box is
-	// directed to this Box.
-	SetPropagateEvents (bool)
 	// SetGap sets the gap between child Objects.
 	SetGap (image.Point)
-	// Add appends a child Object.
+	// Add appends a child Object. If the object is already a child of
+	// another object, it will be removed from that object first.
 	Add (Object)
-	// Delete removes a child Object, if it is a child of this Box.
-	Delete             (Object)
+	// Remove removes a child Object, if it is a child of this Box.
+	Remove (Object)
 	// Insert inserts a child Object before a specified Object. If the
 	// before Object is nil or is not contained within this Box, the
 	// inserted Object is appended.
 	Insert (child Object, before Object)
 	// Clear removes all child Objects.
 	Clear ()
-	// Length returns the amount of child objects.
+	// Length returns the amount of child Objects.
 	Length () int
 	// At returns the child Object at the specified index.
 	At (int) Object
 	// SetLayout sets the layout of this Box. Child Objects will be
 	// positioned according to it.
 	SetLayout (Layout)
+
+	// These methods control whether certain user input events get
+	// propagated to child Objects. If set to true, the relevant events will
+	// be sent to this container. If set to false (which is the default),
+	// the events will be sent to the appropriate child Object.
+	CaptureDND      (bool)
+	CaptureMouse    (bool)
+	CaptureScroll   (bool)
+	CaptureKeyboard (bool)
 }
 
 // LayoutHints are passed to a layout to tell it how to arrange child boxes.
@@ -289,7 +305,7 @@ type LayoutHints struct {
 	// Bounds is the bounding rectangle that children should be placed
 	// within. Any padding values are already applied.
 	Bounds image.Rectangle
-	// OverflowX and OverflowY control wether child Boxes may be positioned
+	// OverflowX and OverflowY control whether child Boxes may be positioned
 	// outside of Bounds.
 	OverflowX bool
 	OverflowY bool
@@ -337,10 +353,11 @@ type Window interface {
 	// Paste reads data from the clipboard. When the data is available or an
 	// error has occurred, the provided function will be called.
 	Paste (callback func (data.Data, error), accept ...data.Mime)
-	// Show shows the window.
-	Show     ()
-	// Hide hides the window.
-	Hide     ()
+	// SetVisible sets whether or not this window is visible. Windows are
+	// invisible by default.
+	SetVisible (bool)
+	// Visible returns whether or not this window is visible.
+	Visible () bool
 	// Close closes the window.
 	Close ()
 	// OnClose specifies a function to be called when the window is closed.

path.go

@@ -1,187 +0,0 @@
-package tomo
-
-import "io"
-import "os"
-import "io/fs"
-import "strings"
-import "path/filepath"
-
-// FS is Tomo's implementation of fs.FS. It provides access to a specific part
-// of the filesystem.
-type FS struct {
-	path string
-}
-
-// FileWriter is a writable version of fs.File. 
-type FileWriter interface {
-	interface { fs.File; io.Writer }
-}
-
-// ApplicationUserDataFS returns an FS that an application can use to store user
-// data files.
-func ApplicationUserDataFS (app ApplicationDescription) (*FS, error) {
-	return appFs(userDataDir, app)
-}
-
-// ApplicationUserConfigFS returns an FS that an application can use to store
-// user configuration files.
-func ApplicationUserConfigFS (app ApplicationDescription) (*FS, error) {
-	configDir, err := os.UserConfigDir()
-	if err != nil { return nil, err }
-	return appFs(configDir, app)
-}
-
-// ApplicationUserCacheFS returns an FS that an application can use to store
-// user cache files.
-func ApplicationUserCacheFS (app ApplicationDescription) (*FS, error) {
-	cacheDir, err := os.UserCacheDir()
-	if err != nil { return nil, err }
-	return appFs(cacheDir, app)
-}
-
-func pathErr (op, path string, err error) error {
-	return &fs.PathError {
-		Op:   op,
-		Path: path,
-		Err:  err,
-	}
-}
-
-func appFs (root string, app ApplicationDescription) (*FS, error) {
-	// remove slashes
-	appname := app.String()
-	appname = strings.ReplaceAll(appname, "/", "-")
-	appname = strings.ReplaceAll(appname, "\\", "-")
-
-	path := filepath.Join(root, appname)
-	
-	// ensure the directory actually exists
-	err := os.MkdirAll(path, 755)
-	if err != nil { return nil, err }
-	
-	return &FS { path: path }, nil
-}
-
-func (this FS) subPath (name string) (string, error) {
-	if !fs.ValidPath(name)         { return "", fs.ErrInvalid }
-	if strings.Contains(name, "/") { return "", fs.ErrInvalid }
-	return filepath.Join(this.path, name), nil
-}
-
-// Open opens the named file.
-func (this FS) Open (name string) (fs.File, error) {
-	path, err := this.subPath(name)
-	if err != nil {
-		return nil, pathErr("open", name, err)
-	}
-
-	return os.Open(path)
-}
-
-// Create creates or truncates the named file.
-func (this FS) Create (name string) (FileWriter, error) {
-	path, err := this.subPath(name)
-	if err != nil {
-		return nil, pathErr("create", name, err)
-	}
-
-	return os.Create(path)
-}
-
-// OpenFile is the generalized open call; most users will use Open or Create
-// instead.
-func (this FS) OpenFile (
-	name string,
-	flag int,
-	perm os.FileMode,
-) (
-	FileWriter,
-	error,
-) {
-	path, err := this.subPath(name)
-	if err != nil {
-		return nil, pathErr("open", name, err)
-	}
-
-	return os.OpenFile(path, flag, perm)
-}
-
-// ReadDir reads the named directory and returns a list of directory entries
-// sorted by filename.
-func (this FS) ReadDir (name string) ([]fs.DirEntry, error) {
-	path, err := this.subPath(name)
-	if err != nil {
-		return nil, pathErr("readdir", name, err)
-	}
-
-	return os.ReadDir(path)
-}
-
-// ReadFile reads the named file and returns its contents.
-// A successful call returns a nil error, not io.EOF.
-// (Because ReadFile reads the whole file, the expected EOF
-// from the final Read is not treated as an error to be reported.)
-//
-// The caller is permitted to modify the returned byte slice.
-func (this FS) ReadFile (name string) ([]byte, error) {
-	path, err := this.subPath(name)
-	if err != nil {
-		return nil, pathErr("readfile", name, err)
-	}
-
-	return os.ReadFile(path)
-}
-
-// WriteFile writes data to the named file, creating it if necessary.
-func (this FS) WriteFile (name string, data []byte, perm os.FileMode) error {
-	path, err := this.subPath(name)
-	if err != nil {
-		return pathErr("writefile", name, err)
-	}
-
-	return os.WriteFile(path, data, perm)
-}
-
-// Stat returns a FileInfo describing the file.
-func (this FS) Stat (name string) (fs.FileInfo, error) {
-	path, err := this.subPath(name)
-	if err != nil {
-		return nil, pathErr("stat", name, err)
-	}
-
-	return os.Stat(path)
-}
-
-// Remove removes the named file or (empty) directory.
-func (this FS) Remove (name string) error {
-	path, err := this.subPath(name)
-	if err != nil {
-		return pathErr("remove", name, err)
-	}
-
-	return os.Remove(path)
-}
-
-// RemoveAll removes name and any children it contains.
-func (this FS) RemoveAll (name string) error {
-	path, err := this.subPath(name)
-	if err != nil {
-		return pathErr("removeall", name, err)
-	}
-
-	return os.RemoveAll(path)
-}
-
-// Rename renames (moves) oldname to newname.
-func (this FS) Rename (oldname, newname string) error {
-	oldpath, err := this.subPath(oldname)
-	if err != nil {
-		return pathErr("rename", oldname, err)
-	}
-	newpath, err := this.subPath(newname)
-	if err != nil {
-		return pathErr("rename", newname, err)
-	}
-
-	return os.Rename(oldpath, newpath)
-}

plugin.go

@@ -1,55 +0,0 @@
-package tomo
-
-import "os"
-import "plugin"
-import "path/filepath"
-
-var pluginPaths []string
-
-func loadPlugins () {
-	for _, dir := range pluginPaths {
-		if dir != "" {
-			loadPluginsFrom(dir)
-		}
-	}
-}
-
-func loadPluginsFrom (dir string) {
-	entries, err := os.ReadDir(dir)
-	// its no big deal if one of the dirs doesn't exist
-	if err != nil { return }
-
-	for _, entry := range entries {
-		if entry.IsDir() { continue }
-		if filepath.Ext(entry.Name()) != ".so" { continue }
-		pluginPath := filepath.Join(dir, entry.Name())
-		loadPlugin(pluginPath)
-	}
-}
-
-func loadPlugin (path string) {
-	die := func (reason string) {
-		println("tomo: could not load plugin at", path + ":", reason)
-	}
-
-	plugin, err := plugin.Open(path)
-	if err != nil {
-		die(err.Error())
-		return
-	}
-
-	// check for and obtain basic plugin functions
-	name, ok := extract[func () string](plugin, "Name")
-	if !ok { die("does not implement Name() string"); return }
-	_, ok = extract[func () string](plugin, "Description")
-	if !ok { die("does not implement Description() string"); return }
-
-	println("tomo: loaded plugin", name())
-}
-
-func extract[T any] (plugin *plugin.Plugin, name string) (value T, ok bool) {
-	symbol, err := plugin.Lookup(name)
-	if err != nil { return }
-	value, ok = symbol.(T)
-	return
-}

theme/icon.go

@@ -1,6 +1,5 @@
 package theme
 
-import "git.tebibyte.media/tomo/tomo"
 import "git.tebibyte.media/tomo/tomo/data"
 import "git.tebibyte.media/tomo/tomo/canvas"
 
@@ -21,403 +20,251 @@ func (size IconSize) String () string {
 	}
 }
 
-// TODO: the Icon type, along with its String method, needs to be codegen'd.
-
 // Icon represents an icon ID.
-type Icon int; const (
-	// --- Objects --- //
+type Icon string
 
-	// files
-	IconFile Icon = iota
-	IconDirectory
-	IconDirectoryFull
+// A list of standard icon IDs.
+const (
+	IconUnknown                      Icon = ""
 
-	// places
-	IconDownloads
-	IconPhotos
-	IconBooks
-	IconDocuments
-	IconRepositories
-	IconMusic
-	IconArchives
-	IconFonts
-	IconBinaries
-	IconVideos
-	Icon3DObjects
-	IconHistory
-	IconPreferences
+	// objects: files
+	IconFile                         Icon = "File" // generic
+	IconDirectory                    Icon = "Directory"
+	IconDirectoryFull                Icon = "DirectoryFull"
 
-	// storage
-	IconStorage // generic
-	IconMagneticTape
-	IconFloppyDisk
-	IconHardDisk
-	IconSolidStateDrive
-	IconFlashDrive
-	IconMemoryCard
-	IconROMDisk
-	IconRAMDisk
-	IconCD
-	IconDVD
+	// objects: places
+	IconPlaceHome                    Icon = "PlaceHome"
+	IconPlaceDownloads               Icon = "PlaceDownloads"
+	IconPlacePhotos                  Icon = "PlacePhotos"
+	IconPlaceBooks                   Icon = "PlaceBooks"
+	IconPlaceDocuments               Icon = "PlaceDocuments"
+	IconPlaceRepositories            Icon = "PlaceRepositories"
+	IconPlaceMusic                   Icon = "PlaceMusic"
+	IconPlaceArchives                Icon = "PlaceArchives"
+	IconPlaceFonts                   Icon = "PlaceFonts"
+	IconPlaceBinaries                Icon = "PlaceBinaries"
+	IconPlaceVideos                  Icon = "PlaceVideos"
+	IconPlace3DObjects               Icon = "Place3DObjects"
+	IconPlaceHistory                 Icon = "PlaceHistory"
+	IconPlacePreferences             Icon = "PlacePreferences"
 
-	// network
-	IconNetwork // generic
-	IconLocalNetwork
-	IconInternet
-	IconEthernet
-	IconWireless
-	IconCell
-	IconBluetooth
-	IconRadio
+	// objects: storage
+	IconStorage                      Icon = "Storage" // generic
+	IconStorageMagneticTape          Icon = "StorageMagneticTape"
+	IconStorageFloppyDisk            Icon = "StorageFloppyDisk"
+	IconStorageHardDisk              Icon = "StorageHardDisk"
+	IconStorageSolidStateDisk        Icon = "StorageSolidState"
+	IconStorageFlashStick            Icon = "StorageFlashStick"
+	IconStorageFlashCard             Icon = "StorageFlashCard"
+	IconStorageROM                   Icon = "StorageROM"
+	IconStorageRAM                   Icon = "StorageRAM"
+	IconStorageCD                    Icon = "StorageCD"
+	IconStorageDVD                   Icon = "StorageDVD"
 
-	// devices
-	IconDevice // generic
-	IconRouter
-	IconServer
-	IconDesktop
-	IconLaptop
-	IconTablet
-	IconPhone
-	IconWatch
-	IconCamera
+	// objects: applications
+	// Keep these in sync with nasin.ApplicationRole!
+	IconApplication                  Icon = "Application" // generic
+	IconApplicationWebBrowser        Icon = "ApplicationWebBrowser"
+	IconApplicationMesssanger        Icon = "ApplicationMesssanger"
+	IconApplicationPhone             Icon = "ApplicationPhone"
+	IconApplicationMail              Icon = "ApplicationMail"
+	IconApplicationTerminalEmulator  Icon = "ApplicationTerminalEmulator"
+	IconApplicationFileBrowser       Icon = "ApplicationFileBrowser"
+	IconApplicationTextEditor        Icon = "ApplicationTextEditor"
+	IconApplicationDocumentViewer    Icon = "ApplicationDocumentViewer"
+	IconApplicationWordProcessor     Icon = "ApplicationWordProcessor"
+	IconApplicationSpreadsheet       Icon = "ApplicationSpreadsheet"
+	IconApplicationSlideshow         Icon = "ApplicationSlideshow"
+	IconApplicationCalculator        Icon = "ApplicationCalculator"
+	IconApplicationPreferences       Icon = "ApplicationPreferences"
+	IconApplicationProcessManager    Icon = "ApplicationProcessManager"
+	IconApplicationSystemInformation Icon = "ApplicationSystemInformation"
+	IconApplicationManual            Icon = "ApplicationManual"
+	IconApplicationCamera            Icon = "ApplicationCamera"
+	IconApplicationImageViewer       Icon = "ApplicationImageViewer"
+	IconApplicationMediaPlayer       Icon = "ApplicationMediaPlayer"
+	IconApplicationImageEditor       Icon = "ApplicationImageEditor"
+	IconApplicationAudioEditor       Icon = "ApplicationAudioEditor"
+	IconApplicationVideoEditor       Icon = "ApplicationVideoEditor"
+	IconApplicationClock             Icon = "ApplicationClock"
+	IconApplicationCalendar          Icon = "ApplicationCalendar"
+	IconApplicationChecklist         Icon = "ApplicationChecklist"
 
-	// peripherals
-	IconPeripheral // generic
-	IconKeyboard
-	IconMouse
-	IconMonitor
-	IconWebcam
-	IconMicrophone
-	IconSpeaker
-	IconPenTablet
-	IconTrackpad
-	IconController
+	// objects: networks
+	IconNetwork                      Icon = "Network" // generic
+	IconNetworkLocal                 Icon = "NetworkLocal"
+	IconNetworkInternet              Icon = "NetworkInternet"
+	IconNetworkEthernet              Icon = "NetworkEthernet"
+	IconNetworkWireless              Icon = "NetworkWireless"
+	IconNetworkCell                  Icon = "NetworkCell"
+	IconNetworkBluetooth             Icon = "NetworkBluetooth"
+	IconNetworkRadio                 Icon = "NetworkRadio"
 
-	// i/o
-	IconPort // generic
-	IconEthernetPort
-	IconUSBPort
-	IconParallelPort
-	IconSerialPort
-	IconPS2Port
-	IconDisplayConnector
-	IconCGAPort
-	IconVGAPort
-	IconHDMIPort
-	IconDisplayPort
-	IconInfrared
+	// objects: devices
+	IconDevice                       Icon = "Device" // generic
+	IconDeviceRouter                 Icon = "DeviceRouter"
+	IconDeviceServer                 Icon = "DeviceServer"
+	IconDeviceDesktop                Icon = "DeviceDesktop"
+	IconDeviceLaptop                 Icon = "DeviceLaptop"
+	IconDeviceTablet                 Icon = "DeviceTablet"
+	IconDevicePhone                  Icon = "DevicePhone"
+	IconDeviceWatch                  Icon = "DeviceWatch"
+	IconDeviceCamera                 Icon = "DeviceCamera"
 
-	// --- Actions --- //
+	// objects: peripherals
+	IconPeripheral                   Icon = "Peripheral" // generic
+	IconPeripheralKeyboard           Icon = "PeripheralKeyboard"
+	IconPeripheralMouse              Icon = "PeripheralMouse"
+	IconPeripheralMonitor            Icon = "PeripheralMonitor"
+	IconPeripheralWebcam             Icon = "PeripheralWebcam"
+	IconPeripheralMicrophone         Icon = "PeripheralMicrophone"
+	IconPeripheralSpeaker            Icon = "PeripheralSpeaker"
+	IconPeripheralPenTablet          Icon = "PeripheralPenTablet"
+	IconPeripheralTrackpad           Icon = "PeripheralTrackpad"
+	IconPeripheralController         Icon = "PeripheralController"
 
-	// files
-	IconOpen
-	IconOpenIn
-	IconSave
-	IconSaveAs
-	IconPrint
-	IconNew
-	IconNewDirectory
-	IconDelete
-	IconRename
-	IconGetInformation
-	IconChangePermissions
-	IconRevert
+	// objects: i/o
+	IconPort                         Icon = "Port" // generic
+	IconPortEthernet                 Icon = "PortEthernet"
+	IconPortUSB                      Icon = "PortUSB"
+	IconPortParallel                 Icon = "PortParallel"
+	IconPortSerial                   Icon = "PortSerial"
+	IconPortPS2                      Icon = "PortPS2"
+	IconPortDisplay                  Icon = "PortDisplay"
+	IconPortCGA                      Icon = "PortCGA"
+	IconPortVGA                      Icon = "PortVGA"
+	IconPortHDMI                     Icon = "PortHDMI"
+	IconPortDisplayPort              Icon = "PortDisplayPort"
+	IconPortInfrared                 Icon = "PortInfrared"
 
-	// list management
-	IconAdd
-	IconRemove
-	IconAddBookmark
-	IconRemoveBookmark
-	IconAddFavorite
-	IconRemoveFavorite
+	// actions: files
+	IconActionOpen                   Icon = "ActionOpen"
+	IconActionOpenIn                 Icon = "ActionOpenIn"
+	IconActionSave                   Icon = "ActionSave"
+	IconActionSaveAs                 Icon = "ActionSaveAs"
+	IconActionPrint                  Icon = "ActionPrint"
+	IconActionNew                    Icon = "ActionNew"
+	IconActionNewDirectory           Icon = "ActionNewDirectory"
+	IconActionDelete                 Icon = "ActionDelete"
+	IconActionRename                 Icon = "ActionRename"
+	IconActionGetInformation         Icon = "ActionGetInformation"
+	IconActionChangePermissions      Icon = "ActionChangePermissions"
+	IconActionRevert                 Icon = "ActionRevert"
 
-	// media
-	IconPlay
-	IconPause
-	IconStop
-	IconFastForward
-	IconRewind
-	IconToBeginning
-	IconToEnd
-	IconRecord
-	IconVolumeUp
-	IconVolumeDown
-	IconMute
+	// actions: list management
+	IconActionAdd                    Icon = "ActionAdd"
+	IconActionRemove                 Icon = "ActionRemove"
+	IconActionAddBookmark            Icon = "ActionAddBookmark"
+	IconActionRemoveBookmark         Icon = "ActionRemoveBookmark"
+	IconActionAddFavorite            Icon = "ActionAddFavorite"
+	IconActionRemoveFavorite         Icon = "ActionRemoveFavorite"
 
-	// editing
-	IconUndo
-	IconRedo
-	IconCut
-	IconCopy
-	IconPaste
-	IconFind
-	IconReplace
-	IconSelectAll
-	IconSelectNone
-	IconIncrement
-	IconDecrement
+	// actions: media
+	IconActionPlay                   Icon = "ActionPlay"
+	IconActionPause                  Icon = "ActionPause"
+	IconActionStop                   Icon = "ActionStop"
+	IconActionFastForward            Icon = "ActionFastForward"
+	IconActionRewind                 Icon = "ActionRewind"
+	IconActionToBeginning            Icon = "ActionToBeginning"
+	IconActionToEnd                  Icon = "ActionToEnd"
+	IconActionRecord                 Icon = "ActionRecord"
+	IconActionVolumeUp               Icon = "ActionVolumeUp"
+	IconActionVolumeDown             Icon = "ActionVolumeDown"
+	IconActionMute                   Icon = "ActionMute"
 
-	// window management
-	IconClose
-	IconQuit
-	IconIconify
-	IconShade
-	IconMaximize
-	IconFullScreen
-	IconRestore
+	// actions: editing
+	IconActionUndo                   Icon = "ActionUndo"
+	IconActionRedo                   Icon = "ActionRedo"
+	IconActionCut                    Icon = "ActionCut"
+	IconActionCopy                   Icon = "ActionCopy"
+	IconActionPaste                  Icon = "ActionPaste"
+	IconActionFind                   Icon = "ActionFind"
+	IconActionReplace                Icon = "ActionReplace"
+	IconActionSelectAll              Icon = "ActionSelectAll"
+	IconActionSelectNone             Icon = "ActionSelectNone"
+	IconActionIncrement              Icon = "ActionIncrement"
+	IconActionDecrement              Icon = "ActionDecrement"
 
-	// view controls
-	IconExpand
-	IconContract
-	IconBack
-	IconForward
-	IconUp
-	IconDown
-	IconReload
-	IconZoomIn
-	IconZoomOut
-	IconZoomReset
-	IconMove
-	IconResize
-	IconGoTo
+	// actions: window management
+	IconActionClose                  Icon = "ActionClose"
+	IconActionQuit                   Icon = "ActionQuit"
+	IconActionIconify                Icon = "ActionIconify"
+	IconActionShade                  Icon = "ActionShade"
+	IconActionMaximize               Icon = "ActionMaximize"
+	IconActionFullScreen             Icon = "ActionFullScreen"
+	IconActionRestore                Icon = "ActionRestore"
 
-	// tools
-	IconTransform
-	IconTranslate
-	IconRotate
-	IconScale
-	IconWarp
-	IconCornerPin
-	IconSelectRectangle
-	IconSelectEllipse
-	IconSelectLasso
-	IconSelectGeometric
-	IconSelectAuto
-	IconCrop
-	IconFill
-	IconGradient
-	IconPencil
-	IconBrush
-	IconEraser
-	IconText
-	IconEyedropper
+	// actions: view
+	IconActionExpand                 Icon = "ActionExpand"
+	IconActionContract               Icon = "ActionContract"
+	IconActionBack                   Icon = "ActionBack"
+	IconActionForward                Icon = "ActionForward"
+	IconActionUp                     Icon = "ActionUp"
+	IconActionDown                   Icon = "ActionDown"
+	IconActionReload                 Icon = "ActionReload"
+	IconActionZoomIn                 Icon = "ActionZoomIn"
+	IconActionZoomOut                Icon = "ActionZoomOut"
+	IconActionZoomReset              Icon = "ActionZoomReset"
+	IconActionMove                   Icon = "ActionMove"
+	IconActionResize                 Icon = "ActionResize"
+	IconActionGoTo                   Icon = "ActionGoTo"
 
-	// --- Status --- //
+	// actions: tools
+	IconActionTransform              Icon = "ActionTransform"
+	IconActionTranslate              Icon = "ActionTranslate"
+	IconActionRotate                 Icon = "ActionRotate"
+	IconActionScale                  Icon = "ActionScale"
+	IconActionWarp                   Icon = "ActionWarp"
+	IconActionCornerPin              Icon = "ActionCornerPin"
+	IconActionSelectRectangle        Icon = "ActionSelectRectangle"
+	IconActionSelectEllipse          Icon = "ActionSelectEllipse"
+	IconActionSelectLasso            Icon = "ActionSelectLasso"
+	IconActionSelectGeometric        Icon = "ActionSelectGeometric"
+	IconActionSelectAuto             Icon = "ActionSelectAuto"
+	IconActionCrop                   Icon = "ActionCrop"
+	IconActionFill                   Icon = "ActionFill"
+	IconActionGradient               Icon = "ActionGradient"
+	IconActionPencil                 Icon = "ActionPencil"
+	IconActionBrush                  Icon = "ActionBrush"
+	IconActionEraser                 Icon = "ActionEraser"
+	IconActionText                   Icon = "ActionText"
+	IconActionEyedropper             Icon = "ActionEyedropper"
 
-	// dialogs
-	IconInformation
-	IconQuestion
-	IconWarning
-	IconError
-	IconCancel
-	IconOkay
+	// status: dialog
+	IconStatusInformation            Icon = "StatusInformation"
+	IconStatusQuestion               Icon = "StatusQuestion"
+	IconStatusWarning                Icon = "StatusWarning"
+	IconStatusError                  Icon = "StatusError"
+	IconStatusCancel                 Icon = "StatusCancel"
+	IconStatusOkay                   Icon = "StatusOkay"
 
-	// network
-	IconCellSignal0
-	IconCellSignal1
-	IconCellSignal2
-	IconCellSignal3
-	IconWirelessSignal0
-	IconWirelessSignal1
-	IconWirelessSignal2
-	IconWirelessSignal3
+	// status: network
+	IconStatusCellSignal0            Icon = "StatusCellSignal0"
+	IconStatusCellSignal1            Icon = "StatusCellSignal1"
+	IconStatusCellSignal2            Icon = "StatusCellSignal2"
+	IconStatusCellSignal3            Icon = "StatusCellSignal3"
+	IconStatusWirelessSignal0        Icon = "StatusWirelessSignal0"
+	IconStatusWirelessSignal1        Icon = "StatusWirelessSignal1"
+	IconStatusWirelessSignal2        Icon = "StatusWirelessSignal2"
+	IconStatusWirelessSignal3        Icon = "StatusWirelessSignal3"
 
-	// power
-	IconBattery0
-	IconBattery1
-	IconBattery2
-	IconBattery3
-	IconBrightness0
-	IconBrightness1
-	IconBrightness2
-	IconBrightness3
+	// status: power
+	IconStatusBattery0               Icon = "StatusBattery0"
+	IconStatusBattery1               Icon = "StatusBattery1"
+	IconStatusBattery2               Icon = "StatusBattery2"
+	IconStatusBattery3               Icon = "StatusBattery3"
+	IconStatusBrightness0            Icon = "StatusBrightness0"
+	IconStatusBrightness1            Icon = "StatusBrightness1"
+	IconStatusBrightness2            Icon = "StatusBrightness2"
+	IconStatusBrightness3            Icon = "StatusBrightness3"
 
-	// media
-	IconVolume0
-	IconVolume1
-	IconVolume2
-	IconVolume3
+	// status: media
+	IconStatusVolume0                Icon = "StatusVolume0"
+	IconStatusVolume1                Icon = "StatusVolume1"
+	IconStatusVolume2                Icon = "StatusVolume2"
+	IconStatusVolume3                Icon = "StatusVolume3"
 )
 
-// String satisfies the fmt.Stringer interface.
-func (id Icon) String () string {
-	switch id {
-	case IconFile: return "File"
-	case IconDirectory: return "Directory"
-	case IconDirectoryFull: return "DirectoryFull"
-	case IconDownloads: return "Downloads"
-	case IconPhotos: return "Photos"
-	case IconBooks: return "Books"
-	case IconDocuments: return "Documents"
-	case IconRepositories: return "Repositories"
-	case IconMusic: return "Music"
-	case IconArchives: return "Archives"
-	case IconFonts: return "Fonts"
-	case IconBinaries: return "Binaries"
-	case IconVideos: return "Videos"
-	case Icon3DObjects: return "3DObjects"
-	case IconHistory: return "History"
-	case IconPreferences: return "Preferences"
-	case IconStorage: return "Storage"
-	case IconMagneticTape: return "MagneticTape"
-	case IconFloppyDisk: return "FloppyDisk"
-	case IconHardDisk: return "HardDisk"
-	case IconSolidStateDrive: return "SolidStateDrive"
-	case IconFlashDrive: return "FlashDrive"
-	case IconMemoryCard: return "MemoryCard"
-	case IconROMDisk: return "ROMDisk"
-	case IconRAMDisk: return "RAMDisk"
-	case IconCD: return "CD"
-	case IconDVD: return "DVD"
-	case IconNetwork: return "Network"
-	case IconLocalNetwork: return "LocalNetwork"
-	case IconInternet: return "Internet"
-	case IconEthernet: return "Ethernet"
-	case IconWireless: return "Wireless"
-	case IconCell: return "Cell"
-	case IconBluetooth: return "Bluetooth"
-	case IconRadio: return "Radio"
-	case IconDevice: return "Device"
-	case IconRouter: return "Router"
-	case IconServer: return "Server"
-	case IconDesktop: return "Desktop"
-	case IconLaptop: return "Laptop"
-	case IconTablet: return "Tablet"
-	case IconPhone: return "Phone"
-	case IconWatch: return "Watch"
-	case IconCamera: return "Camera"
-	case IconPeripheral: return "Peripheral"
-	case IconKeyboard: return "Keyboard"
-	case IconMouse: return "Mouse"
-	case IconMonitor: return "Monitor"
-	case IconWebcam: return "Webcam"
-	case IconMicrophone: return "Microphone"
-	case IconSpeaker: return "Speaker"
-	case IconPenTablet: return "PenTablet"
-	case IconTrackpad: return "Trackpad"
-	case IconController: return "Controller"
-	case IconPort: return "Port"
-	case IconEthernetPort: return "EthernetPort"
-	case IconUSBPort: return "USBPort"
-	case IconParallelPort: return "ParallelPort"
-	case IconSerialPort: return "SerialPort"
-	case IconPS2Port: return "PS2Port"
-	case IconDisplayConnector: return "DisplayConnector"
-	case IconCGAPort: return "CGAPort"
-	case IconVGAPort: return "VGAPort"
-	case IconHDMIPort: return "HDMIPort"
-	case IconDisplayPort: return "DisplayPort"
-	case IconInfrared: return "Infrared"
-	case IconOpen: return "Open"
-	case IconOpenIn: return "OpenIn"
-	case IconSave: return "Save"
-	case IconSaveAs: return "SaveAs"
-	case IconPrint: return "Print"
-	case IconNew: return "New"
-	case IconNewDirectory: return "NewDirectory"
-	case IconDelete: return "Delete"
-	case IconRename: return "Rename"
-	case IconGetInformation: return "GetInformation"
-	case IconChangePermissions: return "ChangePermissions"
-	case IconRevert: return "Revert"
-	case IconAdd: return "Add"
-	case IconRemove: return "Remove"
-	case IconAddBookmark: return "AddBookmark"
-	case IconRemoveBookmark: return "RemoveBookmark"
-	case IconAddFavorite: return "AddFavorite"
-	case IconRemoveFavorite: return "RemoveFavorite"
-	case IconPlay: return "Play"
-	case IconPause: return "Pause"
-	case IconStop: return "Stop"
-	case IconFastForward: return "FastForward"
-	case IconRewind: return "Rewind"
-	case IconToBeginning: return "ToBeginning"
-	case IconToEnd: return "ToEnd"
-	case IconRecord: return "Record"
-	case IconVolumeUp: return "VolumeUp"
-	case IconVolumeDown: return "VolumeDown"
-	case IconMute: return "Mute"
-	case IconUndo: return "Undo"
-	case IconRedo: return "Redo"
-	case IconCut: return "Cut"
-	case IconCopy: return "Copy"
-	case IconPaste: return "Paste"
-	case IconFind: return "Find"
-	case IconReplace: return "Replace"
-	case IconSelectAll: return "SelectAll"
-	case IconSelectNone: return "SelectNone"
-	case IconIncrement: return "Increment"
-	case IconDecrement: return "Decrement"
-	case IconClose: return "Close"
-	case IconQuit: return "Quit"
-	case IconIconify: return "Iconify"
-	case IconShade: return "Shade"
-	case IconMaximize: return "Maximize"
-	case IconFullScreen: return "FullScreen"
-	case IconRestore: return "Restore"
-	case IconExpand: return "Expand"
-	case IconContract: return "Contract"
-	case IconBack: return "Back"
-	case IconForward: return "Forward"
-	case IconUp: return "Up"
-	case IconDown: return "Down"
-	case IconReload: return "Reload"
-	case IconZoomIn: return "ZoomIn"
-	case IconZoomOut: return "ZoomOut"
-	case IconZoomReset: return "ZoomReset"
-	case IconMove: return "Move"
-	case IconResize: return "Resize"
-	case IconGoTo: return "GoTo"
-	case IconTransform: return "Transform"
-	case IconTranslate: return "Translate"
-	case IconRotate: return "Rotate"
-	case IconScale: return "Scale"
-	case IconWarp: return "Warp"
-	case IconCornerPin: return "CornerPin"
-	case IconSelectRectangle: return "SelectRectangle"
-	case IconSelectEllipse: return "SelectEllipse"
-	case IconSelectLasso: return "SelectLasso"
-	case IconSelectGeometric: return "SelectGeometric"
-	case IconSelectAuto: return "SelectAuto"
-	case IconCrop: return "Crop"
-	case IconFill: return "Fill"
-	case IconGradient: return "Gradient"
-	case IconPencil: return "Pencil"
-	case IconBrush: return "Brush"
-	case IconEraser: return "Eraser"
-	case IconText: return "Text"
-	case IconEyedropper: return "Eyedropper"
-	case IconInformation: return "Information"
-	case IconQuestion: return "Question"
-	case IconWarning: return "Warning"
-	case IconError: return "Error"
-	case IconCancel: return "Cancel"
-	case IconOkay: return "Okay"
-	case IconCellSignal0: return "CellSignal0"
-	case IconCellSignal1: return "CellSignal1"
-	case IconCellSignal2: return "CellSignal2"
-	case IconCellSignal3: return "CellSignal3"
-	case IconWirelessSignal0: return "WirelessSignal0"
-	case IconWirelessSignal1: return "WirelessSignal1"
-	case IconWirelessSignal2: return "WirelessSignal2"
-	case IconWirelessSignal3: return "WirelessSignal3"
-	case IconBattery0: return "Battery0"
-	case IconBattery1: return "Battery1"
-	case IconBattery2: return "Battery2"
-	case IconBattery3: return "Battery3"
-	case IconBrightness0: return "Brightness0"
-	case IconBrightness1: return "Brightness1"
-	case IconBrightness2: return "Brightness2"
-	case IconBrightness3: return "Brightness3"
-	case IconVolume0: return "Volume0"
-	case IconVolume1: return "Volume1"
-	case IconVolume2: return "Volume2"
-	case IconVolume3: return "Volume3"
-
-	default: return "Unknown"
-	}
-}
-
 // Texture returns a texture of the corresponding icon ID.
 func (id Icon) Texture (size IconSize) canvas.Texture {
 	if current == nil { return nil }
@@ -429,12 +276,3 @@ func MimeIcon (mime data.Mime, size IconSize) canvas.Texture {
 	if current == nil { return nil }
 	return current.MimeIcon(mime, size)
 }
-
-// ApplicationIcon describes the icon of the application.
-type ApplicationIcon tomo.ApplicationDescription
-
-// Texture returns a texture of the corresponding icon ID.
-func (icon ApplicationIcon) Texture (size IconSize) canvas.Texture {
-	if current == nil { return nil }
-	return current.ApplicationIcon(icon, size)
-}

theme/theme.go

@@ -65,7 +65,7 @@ func (id Color) RGBA () (r, g, b, a uint32) {
 	return current.RGBA(id)
 }
 
-// Theme is an object that can apply a visual style to different objects.
+// Theme can apply a visual style to different objects.
 type Theme interface {
 	// A word on textures:
 	//
@@ -91,9 +91,6 @@ type Theme interface {
 
 	// MimeIcon returns an icon corresponding to a MIME type.
 	MimeIcon (data.Mime, IconSize) canvas.Texture
-
-	// ApplicationIcon returns an icon corresponding to an application.
-	ApplicationIcon (ApplicationIcon, IconSize) canvas.Texture
 }
 
 var current Theme

tomo.go

@@ -12,8 +12,6 @@ var backend Backend
 // event loop in that order. This function blocks until Stop is called, or the
 // backend experiences a fatal error.
 func Run (callback func ()) error {
-	loadPlugins()
-
 	if backend != nil {
 		return errors.New("there is already a backend running")
 	}
@@ -57,6 +55,14 @@ func NewWindow (bounds image.Rectangle) (MainWindow, error) {
 	return backend.NewWindow(bounds)
 }
 
+// NewPlainWindow is like NewWindow, but it creates an undecorated window that
+// does not appear in window lists. It is intended for creating things like
+// docks, panels, etc.
+func NewPlainWindow (bounds image.Rectangle) (MainWindow, error) {
+	assertBackend()
+	return backend.NewPlainWindow(bounds)
+}
+
 // NewBox creates and returns a basic Box.
 func NewBox () Box {
 	assertBackend()

unix.go

@@ -1,26 +0,0 @@
-//go:build linux || darwin || freebsd
-
-package tomo
-
-import "os"
-import "strings"
-import "path/filepath"
-
-var userDataDir string
-
-func init () {
-	pathVariable := os.Getenv("TOMO_PLUGIN_PATH")
-	pluginPaths = strings.Split(pathVariable, ":")
-	pluginPaths = append (
-		pluginPaths,
-		"/usr/lib/tomo/plugins",
-		"/usr/local/lib/tomo/plugins")
-	homeDir, err := os.UserHomeDir()
-	if err == nil {
-		pluginPaths = append (
-			pluginPaths,
-			filepath.Join(homeDir, ".local/lib/tomo/plugins"))
-	}
-
-	userDataDir = filepath.Join(homeDir, ".local/share")
-}