Manual/Plugins

From Knotter
Jump to navigation Jump to search

Available Plugins

There are no available plugins as of now.

Plugin Structure

A plugin is described by a JSON file containing the metadata for the given plugin.

The JSON contains an object with the following fields:

name
Recommended, an unique string that identifies the plugin.
If missing is deduced from the file name.
type
Mandatory. Plugin type, see below for valid values.
If missing or with an invalid value the plugin won't be loaded.
description
Recommended. A textual description of the use of the plugin.
author
Suggested, name of the author of the plugin.
version
Suggested, plugin version.
license
Suggested, short identifier of the software license covering the plugin.
icon
Optional, a named icon form the theme or a file name.
How this is used can change depending on the plugin type.
script
Mandatory (Optional if type is "test"). Location of the script file that is to be executed by the plugin. The location is considered relative to the directory containing the JSON file.
See Scripting for a description of the language.

The following fields are added at runtime and will be overwritten if present in the JSON file:

plugin_file
Absolute path to the plugin JSON file.
plugin_dir
Directory containing the JSON file.

Plugin Locations

Plugins are searched in the available data directories, the following directories are always searched:

  • datadir as per configure.sh.
  • current working directory/data
  • executable directory/data

Other directories depend on the system and Qt version. Check Help → About → Plugins for details

Plugin Types

test
A plugin for testing has no other use.
cusp
A new cusp style.

Planned Plugin Types

insert
Inserts new shapes
transform
Operates on the selection
edge
A new edge type;