mutter/doc/reference/cogl-2.0-experimental
Robert Bragg e9f721216e Add _primitive_draw to replace _framebuffer_draw_primitive
When splitting out the CoglPath api we saw that we would be left with
inconsistent drawing apis if the drawing apis in core Cogl were lumped
into the cogl_framebuffer_ api considering other Cogl sub-libraries or
that others will want to create higher level drawing apis outside of
Cogl but can't use the same namespace.

So that we can aim for a more consistent style this adds a
cogl_primitive_draw() api, comparable to cogl_path_fill() or
cogl_pango_show_layout() that's intended to replace
cogl_framebuffer_draw_primitive()

Note: the attribute and rectangle drawing apis are still in the
cogl_framebuffer_ namespace and this might potentially change but in
these cases there is no single object representing the thing being drawn
so it seems a more reasonable they they live in the framebuffer
namespace for now.

Note: the cogl_framebuffer_draw_primitive() api isn't removed by this
patch so it can more conveniently be cherry picked to the 1.16 branch so
we can mark it deprecated for a short while. Even though it's marked as
experimental api we know that there are people using the api so we'd
like to give them a chance to switch to the new api.

Reviewed-by: Neil Roberts <neil@linux.intel.com>

(cherry picked from commit 418912b93ff81a47f9b38114d05335ab76277c48)

Conflicts:
	cogl-pango/cogl-pango-display-list.c
	cogl/Makefile.am
	cogl/cogl-framebuffer.c
	cogl/cogl-pipeline-layer-state.h
	cogl/cogl2-path.c
	cogl/driver/gl/cogl-clip-stack-gl.c
2013-07-29 18:31:36 +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 Remove cogl-swap-chain.xml from cogl2-docs.xml 2013-07-04 11:50:31 +01:00
cogl-2.0-experimental-sections.txt Add _primitive_draw to replace _framebuffer_draw_primitive 2013-07-29 18:31:36 +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