mutter/doc/reference/cogl-2.0-experimental
Neil Roberts 6d51a18e7c Add support for per-vertex point sizes
This adds a new function to enable per-vertex point size on a
pipeline. This can be set with
cogl_pipeline_set_per_vertex_point_size(). Once enabled the point size
can be set either by drawing with an attribute named
'cogl_point_size_in' or by writing to the 'cogl_point_size_out'
builtin from a snippet.

There is a feature flag which must be checked for before using
per-vertex point sizes. This will only be set on GL >= 2.0 or on GLES
2.0. GL will only let you set a per-vertex point size from GLSL by
writing to gl_PointSize. This is only available in GL2 and not in the
older GLSL extensions.

The per-vertex point size has its own pipeline state flag so that it
can be part of the state that affects vertex shader generation.

Having to enable the per vertex point size with a separate function is
a bit awkward. Ideally it would work like the color attribute where
you can just set it for every vertex in your primitive with
cogl_pipeline_set_color or set it per-vertex by just using the
attribute. This is harder to get working with the point size because
we need to generate a different vertex shader depending on what
attributes are bound. I think if we wanted to make this work
transparently we would still want to internally have a pipeline
property describing whether the shader was generated with per-vertex
support so that it would work with the shader cache correctly.
Potentially we could make the per-vertex property internal and
automatically make a weak pipeline whenever the attribute is bound.
However we would then also need to automatically detect when an
application is writing to cogl_point_size_out from a snippet.

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

(cherry picked from commit 8495d9c1c15ce389885a9356d965eabd97758115)

Conflicts:
	cogl/cogl-context.c
	cogl/cogl-pipeline-private.h
	cogl/cogl-pipeline.c
	cogl/cogl-private.h
	cogl/driver/gl/cogl-pipeline-progend-fixed.c
	cogl/driver/gl/gl/cogl-pipeline-progend-fixed-arbfp.c
2013-06-07 16:53:29 +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 build: update to build with automake 1.13 2013-01-22 18:00:05 +00: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