API reference

The OLPC platform includes a large number of libraries and services. This page attempts to gather links to reference works which can be used when programming the XO laptops.

Platform Requirements

• Human interaction guidelines (HIG) for Sugar activities
• Activity Bundles describes the packaging structure
• Understanding sugar code provides an overview of how Sugar interacts with activities, including startup and shutdown, useful to understand the environment in which your activity will run
• Bitfrost summary (full spec) the security system which will control activities and their interaction with the system and other users

• Software components is a somewhat old document describing the various pieces of software and libraries involved in the system.

Python Libraries

Where official reference documentation isn't available, PyDoc-generated documentation is provided. You can generate local copies of the PyDoc-generated documentation from a running official image. Script is available via bzr branch http://www.vrplumber.com/bzr/autodoc

GUI Libraries

Libraries for creating standard Windows-Icon-Menu-Pointer (WIMP) GUI applications.

• Sugar Architecture (PyDoc) -- core UI and service libraries
  • Activity Support -- support mechanisms for writing activities
  • Graphics -- UI library based on Hippo Canvas
  • Presence Chat P2P-- activity's interfaces to the Telepathy engine
  • Clipboard -- activity's interface to the UI's clipboard interface
  • Datastore -- activity's interface to the datastore service
• Gtk, (PyDoc) -- GUI library underlying the Sugar UI, includes the Accessibility Toolkit (ATK) (PyDoc) and the GObject (PyDoc) non-GUI core library
• Hippo Canvas -- canvas mechanism used by the Sugar.graphics libraries
• Cairo (PyDoc) -- Low-level vector graphics rendering library
• RSVG -- Library for rendering SVG text from files/strings onto Cairo Canvases
• Pango -- text layout and rendering engine

High-Level Widgets

GUI (GTK) controls which expose the functionality of entire complex applications for use by other projects.

• Abiword -- GTK widget embedding the Abiword Word-Processor
• HulaHop -- embeds a Gecko 1.9 (Firefox 3.0 ocore) rendering widget XXX confirm that's what it really is
• Evince -- PDF (and similar) document viewer as a GTK widget

Multimedia Libraries

Libraries that deal with multimedia and gaming functionality.

• GStreamer (PyDoc) -- multimedia streaming library
• CSound -- the CSound audio-generation library
• OLPC Games -- PyGame wrapper that makes working within the OLPC-XO environment relatively straightforward (Strongly recommended for PyGame usage on the XO!)
• PyGame -- GUI library suitable for Sprite-based 2D game development

Communications and Networking

Libraries for connecting to other processes, either on the local machine or across the network

• D-BUS (PyDoc) -- desktop messaging (Remote Procedure Call (RPC) and Asynchronous Signalling) engine
• Telepathy -- buddy and connection management including cross-machine RPC over D-BUS
• PyXPCOM -- Library for controlling XPCOM applications (currently just XULRunner on the XO) XXX Should be available, but doesn't appear to be (that is, import xpcom doesn't work)

Support Libraries

Libraries which aren't neither GUI nor multi-media

• SECore -- search engine implementation
• JSON -- Javascript Object Notation parser/linearisation library
• UrlGrabber -- url downloading library
• OLPC -- the data-store implementation

Extraneous Libraries

Libraries which are present in the current builds, but not particularly "part" of the Sugar environment and which may be removed eventually.

• Yum -- package manager for RPM-based distributions
• RPM -- RPM manipulation library