[cairo] A diagram for criticism/comments

[Vladimir Vukicevic]

On Dec 12, 2007, at 1:04 PM, Donn wrote:

> Hi all,
> I have spent some time getting my thoughts in order, and tried to  
> sum-up my
> overview of Cairo (so far) in a diagram. I have attached it. If  
> anyone has
> the time to comment that would be great.
>
> I intend to use this in a tutorial (from a python pov) which I am  
> working on,
> slowly :)


Neat diagram!

Some comments:

- listing "move_to" "line_to" etc. under "Nouns" is kind of odd, since  
they are verbs themselves; you may as well include a Path in there and  
have paths be the Nouns, and "move_to" etc. be "Path Verbs".

- The "Source" is always a pattern, and "rgba_colour", "surface", and  
"gradient" are pattern types.  I wouldn't mention png images at all --  
they really are not relevant to cairo, and the png methods are in  
cairo just for convenience for testing.

- For the surface "array of pixels", PNG file is not a valid surface  
type (nor is GDK DrawingArea, which is really just Xlib, but that's  
closer than PNG file)

- "Bubbles" is an odd term, and i'm not sure if it's even really  
defined right there... like, calling save()/restore() doesn't do  
anything to the surface, whereas the image seems to imply that it  
overlays things in some way.  Not sure what I'd use instead of this,  
though.

    - Vlad