nasin/application.go

package nasin

import "log"
import "image"
import "strings"
import "net/url"
import "git.tebibyte.media/tomo/tomo"
import "git.tebibyte.media/tomo/tomo/canvas"
import "git.tebibyte.media/tomo/nasin/internal/registrar"

// 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 () error
}

// ApplicationURLOpener is an application that can open a URL.
type ApplicationURLOpener interface {
	Application

	// OpenURL opens a new window with the contents of the given URL. If the
	// given URL is unsupported, it returns an error (for example, an image
	// viewer is not expected to open a text file). If the URL scheme is
	// empty, file:// is assumed.
	//
	// Applications should support the file:// scheme at the very least, and
	// should also support others like http:// and https:// if possible.
	OpenURL (*url.URL) error
}

// ApplicationDescription describes the name and type of an application.
type ApplicationDescription struct {
	// The name of the application.
	Name string

	// The ID of the application. This should be a well-known name, that is,
	// a reversed domain name owned by the author with the application name
	// as the subdomain.
	//
	// For example:
	//   com.example.Application
	ID string

	// Role describes what the application does.
	Role ApplicationRole
}

// String satisfies the fmt.Stringer interface.
func (application ApplicationDescription) String () string {
	if application.Name == "" {
		return string(application.Role)
	} else {
		return application.Name
	}
}

// ApplicationRole describes what an application does.
type ApplicationRole string; const (
	RoleUnknown           ApplicationRole = ""

	RoleWebBrowser        ApplicationRole = "Web Browser"
	RoleMesssanger        ApplicationRole = "Messsanger"
	RolePhone             ApplicationRole = "Phone"
	RoleMail              ApplicationRole = "Mail"

	RoleTerminalEmulator  ApplicationRole = "Terminal Emulator"
	RoleFileBrowser       ApplicationRole = "File Browser"
	RoleTextEditor        ApplicationRole = "Text Editor"

	RoleDocumentViewer    ApplicationRole = "Document Viewer"
	RoleWordProcessor     ApplicationRole = "Word Processor"
	RoleSpreadsheet       ApplicationRole = "Spreadsheet"
	RoleSlideshow         ApplicationRole = "Slideshow"
	RoleCalculator        ApplicationRole = "Calculator"

	RolePreferences       ApplicationRole = "Preferences"
	RoleProcessManager    ApplicationRole = "Process Manager"
	RoleSystemInformation ApplicationRole = "System Information"
	RoleManual            ApplicationRole = "Manual"

	RoleCamera            ApplicationRole = "Camera"
	RoleImageViewer       ApplicationRole = "Image Viewer"
	RoleMediaPlayer       ApplicationRole = "Media Player"
	RoleImageEditor       ApplicationRole = "Image Editor"
	RoleAudioEditor       ApplicationRole = "Audio Editor"
	RoleVideoEditor       ApplicationRole = "Video Editor"

	RoleClock             ApplicationRole = "Clock"
	RoleCalendar          ApplicationRole = "Calendar"
	RoleChecklist         ApplicationRole = "Checklist"
)

// Icon returns the icon ID for this role.
func (role ApplicationRole) Icon () tomo.Icon {
	if role == "" {
		return tomo.IconApplication
	} else {
		return tomo.Icon("Application" + strings.ReplaceAll(string(role), " ", ""))
	}
}

// RunApplication is like tomo.Run, but runs an application. If something fails
// to initialize, an error is written to the standard logger.
func RunApplication (application Application) {
	err := registrar.RegisterBackend()
	if err != nil { log.Fatal("nasin: could not register backend:", err) }
	err = tomo.Run(func () {
		err := registrar.SetTheme()
		if err != nil { log.Fatal("nasin: could not set theme:", err) }
		err = application.Init()
		if err != nil { log.Fatal("nasin: could not run application:", err) }
	})
	if err != nil { log.Fatal("nasin: could not run application:", err) }
}

// 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. The window's icon will be automatically set by
// looking for an icon with the name of the application's ID. If that is not
// found, the default icon for the application's ApplicationRole will used.
func NewApplicationWindow (application Application, bounds image.Rectangle) (tomo.Window, error) {
	window, err := tomo.NewWindow(bounds)
	if err != nil { return nil, err }
	description := application.Describe()
	window.SetTitle(description.Name)
	setApplicationWindowIcon(window, description)
	return window, nil
}

func setApplicationWindowIcon (window tomo.Window, description ApplicationDescription) {
	allSizes := func (icon tomo.Icon) (sizes []canvas.Texture) {
		small  := icon.Texture(tomo.IconSizeSmall)
		medium := icon.Texture(tomo.IconSizeMedium)
		large  := icon.Texture(tomo.IconSizeLarge)
		if small  != nil { sizes = append(sizes,  small) }
		if medium != nil { sizes = append(sizes, medium) }
		if large  != nil { sizes = append(sizes,  large) }
		return sizes
	}

	if sizes := allSizes(tomo.Icon(description.ID)); len(sizes) > 0 {
		window.SetIcon(sizes...)
		return
	}
	if sizes := allSizes(description.Role.Icon()); len(sizes) > 0 {
		window.SetIcon(sizes...)
		return
	}
}