mutter/doc/reference/cogl-2.0-experimental
Neil Roberts 534e535a28 Use the Wayland embedded linked list implementation instead of BSD's
This removes cogl-queue.h and adds a copy of Wayland's embedded list
implementation. The advantage of the Wayland model is that it is much
simpler and so it is easier to follow. It also doesn't require
defining a typedef for every list type.

The downside is that there is only one list type which is a
doubly-linked list where the head has a pointer to both the beginning
and the end. The BSD implementation has many more combinations some of
which we were taking advantage of to reduce the size of critical
structs where we didn't need a pointer to the end of the list.

The corresponding changes to uses of cogl-queue.h are:

• COGL_STAILQ_* was used for onscreen the list of events and dirty
  notifications. This makes the size of the CoglContext grow by one
  pointer.

• COGL_TAILQ_* was used for fences.

• COGL_LIST_* for CoglClosures. In this case the list head now has an
  extra pointer which means CoglOnscreen will grow by the size of
  three pointers, but this doesn't seem like a particularly important
  struct to optimise for size anyway.

• COGL_LIST_* was used for the list of foreign GLES2 offscreens.

• COGL_TAILQ_* was used for the list of sub stacks in a
  CoglMemoryStack.

• COGL_LIST_* was used to track the list of layers that haven't had
  code generated yet while generating a fragment shader for a
  pipeline.

• COGL_LIST_* was used to track the pipeline hierarchy in CoglNode.

The last part is a bit more controversial because it increases the
size of CoglPipeline and CoglPipelineLayer by one pointer in order to
have the redundant tail pointer for the list head. Normally we try to
be very careful about the size of the CoglPipeline struct. Because
CoglPipeline is slice-allocated, this effectively ends up adding two
pointers to the size because GSlice rounds up to the size of two
pointers.

Reviewed-by: Robert Bragg <robert@linux.intel.com>

(cherry picked from commit 13abf613b15f571ba1fcf6d2eb831ffc6fa31324)

Conflicts:
	cogl/cogl-context-private.h
	cogl/cogl-context.c
	cogl/driver/gl/cogl-pipeline-fragend-glsl.c
	doc/reference/cogl-2.0-experimental/Makefile.am
2013-06-13 13:45:47 +01:00
..
blend-strings.xml Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00
cogl_ortho.png Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00
cogl-2.0-experimental-docs.xml.in Add fence API 2013-05-28 21:36:03 +01:00
cogl-2.0-experimental-sections.txt Add support for per-vertex point sizes 2013-06-07 16:53:29 +01:00
fill-rule-even-odd.png Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00
fill-rule-non-zero.png Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00
Makefile.am Use the Wayland embedded linked list implementation instead of BSD's 2013-06-13 13:45:47 +01:00
quad-indices-order.png Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00
quad-indices-triangles.png Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00