<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body bgcolor="#ffffff" text="#000000">
I'm writing a Python program that uses the Cairo API.  The C++ API docs
(<a class="moz-txt-link-freetext" href="http://cairographics.org/manual">http://cairographics.org/manual</a>) have a rather loose correspondence to
the Python bindings.  The Python binding for Cairo doesn't seem to have
any documentation, at least I haven't been able to find any.<br>
<ul>
  <li>Is this an appropriate list to discuss Cairo for Python?</li>
  <li>I have some working code, and would like to contribute whatever
docs I can generate ... with whom should I correspond to get started?
I'd like to start by writing some docs for the Python API for Cairo.<br>
  </li>
</ul>
I used Glade to create the GUI, and libglade and PyGtk to bring it to
life.  Currently my Cairo code is invoked from expose_event.  I need to
develop a better understanding of how Cairo works.  The scant sample
programs that currently exist are not enough.  I'd be willing to
correspond with those who know, but aren't interested in spending much
time writing, so that I can write up more comprehensive docs for myself
and others.<br>
<br>
Some issues I'd like to address in the docs, with Python sample code,
are:<br>
<ul>
  <li>What does Cairo provide that we didn't have before?</li>
  <li>How is PangoCairo related to Cairo?</li>
  <li>How does the Cairo event model relate to GTK?</li>
  <li>General structure of various types of programs that use Cairo<br>
  </li>
  <li>What guidelines should one follow when writing Cairo animations?</li>
  <ul>
    <li>Timers and GObject</li>
    <li>Reducing flicker</li>
    <li>Resizing GTK components</li>
    <li>Context lifespan</li>
    <li>Pixbufs</li>
    <li>Layers<br>
    </li>
    <li>User space / device space mapping</li>
  </ul>
  <li>Which GTK events relate specifically to Cairo?</li>
  <li>Are there any special considerations for using Glade when working
with Cairo?</li>
</ul>
Mike<br>
<a class="moz-txt-link-freetext" href="http://mslinn.com">http://mslinn.com</a><br>
</body>
</html>