mutter/doc
Neil Roberts 9ee6dd240b cogl: Support retained paths
This adds three new API calls:

  CoglHandle cogl_path_get()
  void cogl_path_set(CoglHandle path)
  CoglHandle cogl_path_copy(CoglHandle path)

All of the fields relating to the path have been moved from the Cogl
context to a new CoglPath handle type. The cogl context now just
contains a CoglPath handle. All of the existing path commands
manipulate the data in the current path handle. cogl_path_new now just
creates a new path handle and unrefs the old one.

The path handle can be stored for later with cogl_path_get. The path
can then be copied with cogl_path_copy. Internally it implements
copy-on-write semantics with an extra optimisation that it will only
copy the data if the new path is modified, but not if the original
path is modified. It can do this because the only way to modify a path
is by appending to it so the copied path is able to store its own path
length and only render the nodes up to that length. For this to work
the copied path also needs to keep its own copies of the path extents
because the parent path may change these by adding nodes.

The clip stack now uses the cogl_path_copy mechanism to store paths in
the stack instead of directly copying the data. This should save some
memory and processing time.
2010-04-08 19:53:38 +01:00
..
common docs: Clean up the additional documentation build 2009-11-30 21:33:22 +00:00
cookbook build: Remove dist rule for non-existing image files 2010-01-03 20:25:07 +00:00
manual docs: Fix whitespace in the App manual stub 2010-02-06 10:49:33 +00:00
reference cogl: Support retained paths 2010-04-08 19:53:38 +01:00
clutter-actor-invariants.txt Enforce invariants on mapped, realized, visibility states 2009-04-24 15:27:19 +01:00
CODING_STYLE docs: Move documentation under doc/ 2009-12-01 10:16:25 +00:00
HACKING docs: Clarify usage of UTF-8 or ASCII art in commit messages 2010-01-15 17:32:46 +00:00
HACKING.backends docs: Update the HACKING.backends file 2010-03-04 18:07:04 +00:00
Makefile.am docs: Move documentation under doc/ 2009-12-01 10:16:25 +00:00
RELEASING docs: Move RELEASING under docs/ 2009-12-09 18:10:52 +00:00