# Python Scripting

I assume you have a working knowledge of Python. FontForge implements two Python modules – one great huge one called `fontforge` which provides access to as much of FontForge’s functionality as I’ve had time to write, and one tiny one called `psMat` which provides quick access to some useful transformations expressed as PostScript matrices.

In python terms fontforge embeds python. It is possible to build fontforge so that it is also a python extension.

## FontForge Modules

- fontforge
  - Module attributes
  - Module functions
  - User Interface Module Functions
  - Point
  - Contour
  - Layer
  - Glyph Pen
  - Glyph
  - Selection
  - Private
  - Math
  - Font
- psMat

## Command line convenience

For convenience, Python commands given as a `-c` argument on the command line have the following code prepended:

    from sys import argv; from fontforge import *

Hence, the trivial script to convert a font can be written:

    fontforge -c 'open(argv[1]).generate(argv[2])'

## Trivial example

    import fontforge                                 #Load the module
    amb=fontforge.open("Ambrosia.sfd")               #Open a font
    amb.selection.select(("ranges",None),"A","Z")    #select A-Z
    amb.copy()                                       #Copy those glyphs into the clipboard

    n=fontforge.font()                               #Create a new font
    n.selection.select(("ranges",None),"A","Z")      #select A-Z of it
    n.paste()                                        #paste the glyphs above in
    print n["A"].foreground                          #test to see that something
                                                     #  actually got pasted
    n.fontname="NewFont"                             #Give the new font a name
    n.save("NewFont.sfd")                            #and save it.

## FontForge as a python extension

In addition to embedding Python, FontForge typically installs a Python module accessible to the system’s `python` executable, which can be accessed using:

    >>> import fontforge