## The Available Commands

The Plugin installs a builtin Module "scribus". Thus to use the extensions to the Python language you must do a "import scribus" or "from scribus import *".

Scripter provides functions to control scribus and to manipulate objects on the canvas. Each function is documented individually below. A few things are common across most of the interface. Most functions operate on frames. Frames are identified by their name, a string - they are not real Python objects. Many functions take an optional (non-keyword) parameter, a frame name. Many exceptions are also common across most functions. These are not currently documented in the docstring for each function.

- Many functions will raise a NoDocOpenError if you try to use them without a document to operate on.
- If you do not pass a frame name to a function that requires one, the function will use the currently selected frame, if any, or raise a NoValidObjectError if it can't find anything to operate on.
- Many functions will raise WrongFrameTypeError if you try to use them on a frame type that they do not make sense with. For example, setting the text colour on a graphics frame doesn't make sense, and will result in this exception being raised.
- Errors resulting from calls to the underlying Python API will be passed through unaltered. As such, the list of exceptions thrown by any function as provided here and in its docstring is incomplete.

Details of what exceptions each function may throw are provided on the function's documentation.

Conventions used in this Document:

number
  means that "number" is an ordinary Interger or Floating Point Number.
"name"
  means that "name" is a String Literal or Variable.
list
  means that "list" is a Python List.

Variables in angled Brackets are optional.

## Exceptions

exceptions.Exception
  ScribusException
    NameExistsError
    NoDocOpenError
    NoValidObjectError
    NotFoundError
    WrongFrameTypeError

### NameExistsError

class NameExistsError(ScribusException)

Method resolution order:
  NameExistsError
  ScribusException
  exceptions.Exception

Methods inherited from exceptions.Exception:

__getitem__(...)

__init__(...)

__str__(...)

### NoDocOpenError

class NoDocOpenError(ScribusException)

Method resolution order:
  NoDocOpenError
  ScribusException
  exceptions.Exception

Methods inherited from exceptions.Exception:

__getitem__(...)

__init__(...)

__str__(...)

### NoValidObjectError

class NoValidObjectError(ScribusException)

Method resolution order:
  NoValidObjectError
  ScribusException
  exceptions.Exception

Methods inherited from exceptions.Exception:

__getitem__(...)

__init__(...)

__str__(...)

### NotFoundError

class NotFoundError(ScribusException)

Method resolution order:
  NotFoundError
  ScribusException
  exceptions.Exception

Methods inherited from exceptions.Exception:

__getitem__(...)

__init__(...)

__str__(...)

### ScribusException

class ScribusException(exceptions.Exception) Methods inherited from exceptions.Exception:

__getitem__(...)

__init__(...)

__str__(...)

### WrongFrameTypeError

class WrongFrameTypeError(ScribusException)

Method resolution order:
  WrongFrameTypeError
  ScribusException
  exceptions.Exception

Methods inherited from exceptions.Exception:

__getitem__(...)
__init__(...)
__str__(...)