Remove application framework stuff

README.md

@@ -1,6 +1,5 @@
 # tomo
 
-WIP rewrite of tomo.
+[![Go Reference](https://pkg.go.dev/badge/git.tebibyte.media/tomo/tomo.svg)](https://pkg.go.dev/git.tebibyte.media/tomo/tomo)
 
-This module will serve as a wafer-thin collection of interfaces and glue code so
-that plugins will be an actual viable concept.
+Tomo is a lightweight GUI toolkit written in pure Go.

backend.go

@@ -3,6 +3,7 @@ package tomo
 import "sort"
 import "image"
 import "errors"
+import "git.tebibyte.media/tomo/tomo/canvas"
 
 // Backend is any Tomo implementation. Backends handle window creation, layout,
 // rendering, and events so that there can be as many platform-specific
@@ -10,12 +11,23 @@ import "errors"
 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
+
 	// Run runs the event loop until Stop() is called, or the backend
 	// experiences a fatal error.
 	Run () error

canvas/canvas.go

@@ -44,8 +44,9 @@ type Pen interface {
 	StrokeWeight (int)         // how thick the stroke is
 	StrokeAlign  (StrokeAlign) // where the stroke is drawn
 
-	Stroke (color.Color) // Sets the stroke to a solid color
-	Fill   (color.Color) // Sets the fill to a solid color
+	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
 }
 
 // Canvas is an image that supports drawing paths.

canvas/texture.go

@@ -0,0 +1,20 @@
+package canvas
+
+import "io"
+import "image"
+
+// Texture is a handle that points to a 2D raster image managed by the backend.
+type Texture interface {
+	image.Image
+
+	// Clip returns a smaller section of this texture, pointing to the same
+	// internal data.
+	Clip (image.Rectangle) Texture
+}
+
+// TextureCloser is a texture that can be closed. Anything that receives a
+// TextureCloser must close it after use.
+type TextureCloser interface {
+	Texture
+	io.Closer
+}

go.mod

@@ -2,4 +2,4 @@ module git.tebibyte.media/tomo/tomo
 
 go 1.20
 
-require golang.org/x/image v0.8.0
+require golang.org/x/image v0.11.0

go.sum

@@ -3,6 +3,8 @@ golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACk
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
 golang.org/x/image v0.8.0 h1:agUcRXV/+w6L9ryntYYsF2x9fQTMd4T8fiiYXAVW6Jg=
 golang.org/x/image v0.8.0/go.mod h1:PwLxp3opCYg4WR2WO9P0L6ESnsD6bLTWcw8zanLMVFM=
+golang.org/x/image v0.11.0 h1:ds2RoQvBvYTiJkwpSFDwCcDFNX7DqjL2WsUgTNk0Ooo=
+golang.org/x/image v0.11.0/go.mod h1:bglhjqbqVuEb9e9+eNR45Jfu7D+T4Qan+NhQk8Ck2P8=
 golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
 golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs=
 golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
@@ -26,6 +28,7 @@ golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
 golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
 golang.org/x/text v0.10.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE=
+golang.org/x/text v0.12.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
 golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=

object.go

@@ -104,7 +104,7 @@ type Align int; const (
 // Object is any obscreen object. Each object must be linked to a box, even if
 // it is that box.
 type Object interface {
-	Box () Box
+	GetBox () Box
 }
 
 // Box is a basic styled box.
@@ -132,6 +132,10 @@ type Box interface {
 	SetBounds      (image.Rectangle)
 	// SetColor sets the background color of this Box.
 	SetColor       (color.Color)
+	// SetTexture sets a repeating background texture. If the texture is
+	// transparent, it will be overlayed atop the color specified by
+	// SetColor().
+	SetTexture     (canvas.Texture)
 	// SetBorder sets the Border(s) of the box. The first Border will be the
 	// most outset, and the last Border will be the most inset.
 	SetBorder      (...Border)
@@ -212,7 +216,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.
@@ -254,11 +258,6 @@ 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.
@@ -271,13 +270,22 @@ type ContainerBox interface {
 	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.

theme/icon.go

@@ -0,0 +1,431 @@
+package theme
+
+import "git.tebibyte.media/tomo/tomo/data"
+import "git.tebibyte.media/tomo/tomo/canvas"
+
+// IconSize represents the size of an icon.
+type IconSize int; const (
+	IconSizeSmall IconSize = iota;
+	IconSizeMedium
+	IconSizeLarge
+)
+
+// String satisfies the fmt.Stringer interface.
+func (size IconSize) String () string {
+	switch size {
+	case IconSizeSmall:  return "small"
+	case IconSizeMedium: return "medium"
+	case IconSizeLarge:  return "large"
+	default:             return "unknown"
+	}
+}
+
+// TODO: the Icon type, along with its String method, needs to be codegen'd.
+
+// Icon represents an icon ID.
+type Icon int; const (
+	// --- Objects --- //
+
+	// files
+	IconFile Icon = iota
+	IconDirectory
+	IconDirectoryFull
+
+	// places
+	IconDownloads
+	IconPhotos
+	IconBooks
+	IconDocuments
+	IconRepositories
+	IconMusic
+	IconArchives
+	IconFonts
+	IconBinaries
+	IconVideos
+	Icon3DObjects
+	IconHistory
+	IconPreferences
+
+	// storage
+	IconStorage // generic
+	IconMagneticTape
+	IconFloppyDisk
+	IconHardDisk
+	IconSolidStateDrive
+	IconFlashDrive
+	IconMemoryCard
+	IconROMDisk
+	IconRAMDisk
+	IconCD
+	IconDVD
+
+	// network
+	IconNetwork // generic
+	IconLocalNetwork
+	IconInternet
+	IconEthernet
+	IconWireless
+	IconCell
+	IconBluetooth
+	IconRadio
+
+	// devices
+	IconDevice // generic
+	IconRouter
+	IconSwitch
+	IconServer
+	IconDesktop
+	IconLaptop
+	IconTablet
+	IconPhone
+	IconWatch
+	IconCamera
+
+	// peripherals
+	IconPeripheral // generic
+	IconKeyboard
+	IconMouse
+	IconMonitor
+	IconWebcam
+	IconMicrophone
+	IconSpeaker
+	IconPenTablet
+	IconTrackpad
+	IconController
+
+	// i/o
+	IconPort // generic
+	IconEthernetPort
+	IconUSBPort
+	IconParallelPort
+	IconSerialPort
+	IconPS2Port
+	IconDisplayConnector
+	IconCGAPort
+	IconVGAPort
+	IconHDMIPort
+	IconDisplayPort
+	IconInfrared
+
+	// --- Actions --- //
+
+	// files
+	IconOpen
+	IconOpenIn
+	IconSave
+	IconSaveAs
+	IconPrint
+	IconNew
+	IconNewDirectory
+	IconDelete
+	IconRename
+	IconGetInformation
+	IconChangePermissions
+	IconRevert
+
+	// list management
+	IconAdd
+	IconRemove
+	IconAddBookmark
+	IconRemoveBookmark
+	IconAddFavorite
+	IconRemoveFavorite
+
+	// media
+	IconPlay
+	IconPause
+	IconStop
+	IconFastForward
+	IconRewind
+	IconToBeginning
+	IconToEnd
+	IconRecord
+	IconVolumeUp
+	IconVolumeDown
+	IconMute
+
+	// editing
+	IconUndo
+	IconRedo
+	IconCut
+	IconCopy
+	IconPaste
+	IconFind
+	IconReplace
+	IconSelectAll
+	IconSelectNone
+	IconIncrement
+	IconDecrement
+
+	// window management
+	IconClose
+	IconQuit
+	IconIconify
+	IconShade
+	IconMaximize
+	IconFullScreen
+	IconRestore
+
+	// view controls
+	IconExpand
+	IconContract
+	IconBack
+	IconForward
+	IconUp
+	IconDown
+	IconReload
+	IconZoomIn
+	IconZoomOut
+	IconZoomReset
+	IconMove
+	IconResize
+	IconGoTo
+
+	// tools
+	IconTransform
+	IconTranslate
+	IconRotate
+	IconScale
+	IconWarp
+	IconCornerPin
+	IconSelectRectangle
+	IconSelectEllipse
+	IconSelectLasso
+	IconSelectGeometric
+	IconSelectAuto
+	IconCrop
+	IconFill
+	IconGradient
+	IconPencil
+	IconBrush
+	IconEraser
+	IconText
+	IconEyedropper
+
+	// --- Status --- //
+
+	// dialogs
+	IconInformation
+	IconQuestion
+	IconWarning
+	IconError
+	IconCancel
+	IconOkay
+
+	// network
+	IconCellSignal0
+	IconCellSignal1
+	IconCellSignal2
+	IconCellSignal3
+	IconWirelessSignal0
+	IconWirelessSignal1
+	IconWirelessSignal2
+	IconWirelessSignal3
+
+	// power
+	IconBattery0
+	IconBattery1
+	IconBattery2
+	IconBattery3
+	IconBrightness0
+	IconBrightness1
+	IconBrightness2
+	IconBrightness3
+
+	// media
+	IconVolume0
+	IconVolume1
+	IconVolume2
+	IconVolume3
+)
+
+// 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 }
+	return current.Icon(id, size)
+}
+
+// MimeIcon returns an icon corresponding to a MIME type.
+func MimeIcon (mime data.Mime, size IconSize) canvas.Texture {
+	if current == nil { return nil }
+	return current.MimeIcon(mime, size)
+}

theme/theme.go

@@ -1,14 +1,17 @@
 package theme
 
+import "fmt"
 import "git.tebibyte.media/tomo/tomo"
+import "git.tebibyte.media/tomo/tomo/data"
 import "git.tebibyte.media/tomo/tomo/event"
+import "git.tebibyte.media/tomo/tomo/canvas"
 
 // Role describes the role of an object.
 type Role struct {
 	// Package is an optional namespace field. If specified, it should be
 	// the package name or module name the object is from.
 	Package string
-	
+
 	// Object specifies what type of object it is. For example:
 	//   - TextInput
 	//   - Table
@@ -16,12 +19,24 @@ type Role struct {
 	//   - Dial
 	// This should correspond directly to the type name of the object.
 	Object string
+
+	// Variant is an optional field to be used when an object has one or
+	// more soft variants under one type. For example, an object "Slider"
+	// may have variations "horizontal" and "vertical".
+	Variant string
+}
+
+// String satisfies the fmt.Stringer interface.
+// It follows the format of:
+// Package.Object[Variant]
+func (r Role) String () string {
+	return fmt.Sprintf("%s.%s[%s]", r.Package, r.Object, r.Variant)
 }
 
 // R is shorthand for creating a Role structure.
-func R (pack, object string) Role {
-	return Role { Package: pack, Object: object }
-} 
+func R (pack, object, variant string) Role {
+	return Role { Package: pack, Object: object, Variant: variant }
+}
 
 // Color represents a color ID.
 type Color int; const (
@@ -32,6 +47,18 @@ type Color int; const (
 	ColorAccent
 )
 
+// String satisfies the fmt.Stringer interface.
+func (c Color) String () string {
+	switch c {
+	case ColorBackground: return "background"
+	case ColorForeground: return "foreground"
+	case ColorRaised:     return "raised"
+	case ColorSunken:     return "sunken"
+	case ColorAccent:     return "accent"
+	default:              return "unknown"
+	}
+}
+
 // RGBA satisfies the color.Color interface.
 func (id Color) RGBA () (r, g, b, a uint32) {
 	if current == nil { return }
@@ -40,13 +67,34 @@ func (id Color) RGBA () (r, g, b, a uint32) {
 
 // Theme is an object that can apply a visual style to different objects.
 type Theme interface {
+	// A word on textures:
+	//
+	// Because textures can be linked to some resource that is outside of
+	// the control of Go's garbage collector, methods of Theme must not
+	// allocate new copies of a texture each time they are called. It is
+	// fine to lazily load textures and save them for later use, but the
+	// same texture must never be allocated multiple times as this could
+	// cause a memory leak.
+	//
+	// As such, textures returned by these methods must be protected.
+	
 	// Apply applies the theme to the given object, according to the given
 	// role. This may register event listeners with the given object;
-	// closing the returned cookie will remove them.
+	// closing the returned cookie must remove them.
 	Apply (tomo.Object, Role) event.Cookie
-	
+
 	// RGBA returns the RGBA values of the corresponding color ID.
 	RGBA (Color) (r, g, b, a uint32)
+
+	// Icon returns a texture of the corresponding icon ID.
+	Icon (Icon, IconSize) canvas.Texture
+
+	// MimeIcon returns an icon corresponding to a MIME type.
+	MimeIcon (data.Mime, IconSize) canvas.Texture
+
+	// ApplicationIcon returns an icon corresponding to an application's
+	// name. This may return nil if there is no icon for that application.
+	ApplicationIcon (string, IconSize) canvas.Texture
 }
 
 var current Theme
@@ -63,4 +111,3 @@ func Apply (object tomo.Object, role Role) event.Cookie {
 	if current == nil { return event.NoCookie { } }
 	return current.Apply(object, role)
 }
-

tomo.go

@@ -3,6 +3,7 @@ package tomo
 import "sync"
 import "image"
 import "errors"
+import "git.tebibyte.media/tomo/tomo/canvas"
 
 var backendLock sync.Mutex
 var backend Backend
@@ -56,6 +57,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()
@@ -79,3 +88,10 @@ func NewContainerBox () ContainerBox {
 	assertBackend()
 	return backend.NewContainerBox()
 }
+
+// NewTexture creates a new texture from an image. When no longer in use, it
+// must be freed using Close().
+func NewTexture (source image.Image) canvas.TextureCloser {
+	assertBackend()
+	return backend.NewTexture(source)
+}

unix.go

@@ -6,6 +6,8 @@ import "os"
 import "strings"
 import "path/filepath"
 
+var userDataDir string
+
 func init () {
 	pathVariable := os.Getenv("TOMO_PLUGIN_PATH")
 	pluginPaths = strings.Split(pathVariable, ":")
@@ -19,4 +21,6 @@ func init () {
 			pluginPaths,
 			filepath.Join(homeDir, ".local/lib/tomo/plugins"))
 	}
+
+	userDataDir = filepath.Join(homeDir, ".local/share")
 }