[cairo] When Should You Call cairo_surface_flush?

[Bryce Harrington]

On Thu, Mar 19, 2015 at 12:27:05PM +1300, Lawrence D'Oliveiro wrote:
> On Wed, 18 Mar 2015 15:51:20 -0700, Bryce Harrington wrote:
> 
> > index 89345f5..bfe3fa1 100644
> > --- a/src/cairo-surface.c
> > +++ b/src/cairo-surface.c
> > @@ -1554,12 +1554,12 @@ _cairo_surface_flush (cairo_surface_t
> > *surface, unsigned flags)
> >   * cairo_surface_flush:
> >   * @surface: a #cairo_surface_t
> >   *
> > - * Do any pending drawing for the surface and also restore any
> > - * temporary modifications cairo has made to the surface's
> > - * state. This function must be called before switching from
> > - * drawing on the surface with cairo to drawing on it directly
> > - * with native APIs. If the surface doesn't support direct access,
> > - * then this function does nothing.
> > + * Do any pending drawing for the surface and also restore any temporary
> > + * modifications cairo has made to the surface's state. This function
> > + * must be called before switching from drawing on the surface with
> > + * cairo to drawing on it directly with native APIs, or accessing its
> > + * memory outside of Cairo. If the surface doesn't support direct
> > + * access, then this function does nothing.
> >   *
> >   * Since: 1.0
> >   **/
> 
> Love the service. :)

Better to read it as a hint.  ;-)

But in this case I'm hoping Uli or someone can sanity check before I
land it.

> -- 
> cairo mailing list
> cairo at cairographics.org
> http://lists.cairographics.org/mailman/listinfo/cairo