~darkxst/ubuntu/raring/cogl/lp1163025
» Revision
8
: doc/reference/cogl-2.0-experimental/html/cogl-2.0-experimental-Pipeline.html
« back to all changes in this revision
Viewing changes to doc/reference/cogl-2.0-experimental/html/cogl-2.0-experimental-Pipeline.html
- browse files at revision 8
- compare with another revision
- download diff
- download tarball
- view history from revision 8
- Committer: Package Import Robot
- Author(s): Jeremy Bicha
- Date: 2012-03-13 19:11:11 UTC
- mfrom: (1.1.4)
- Revision ID: package-import@ubuntu.com-20120313191111-3hgk529qkh9m6uk2
Tags: 1.9.8-0ubuntu1
* New upstream release (LP: #941617)
* Updated symbols & library name for soname update
* debian/control.in: Bump minimum glib to 2.28
* debian/patches/02_disable_armv5t_specific_optimization.patch: Disabled
* Updated symbols & library name for soname update
* debian/control.in: Bump minimum glib to 2.28
* debian/patches/02_disable_armv5t_specific_optimization.patch: Disabled
- files added:
- .pc/.quilt_patches
- build/win32
- build/win32/vs10
- build/win32/vs9
- cogl/gl-prototypes
- files removed:
- .pc/02_disable_armv5t_specific_optimization.patch
- .pc/02_disable_armv5t_specific_optimization.patch/cogl
- files modified:
- .pc/applied-patches
added
removed
doc/reference/cogl-2.0-experimental/html/cogl-2.0-experimental-Pipeline.html
7
7
<link rel="home" href="index.html" title="Cogl 2.0 Reference Manual">
8
8
<link rel="up" href="cogl-pipeline-apis.html" title="Setting Up A GPU Pipeline">
9
9
<link rel="prev" href="cogl-Blend-Strings.html" title="Blend Strings">
10
<link rel="next" href="cogl-buffer-apis.html" title="Allocating GPU Memory">
11
<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
10
<link rel="next" href="cogl-2.0-experimental-Shader-snippets.html" title="Shader snippets">
11
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
18
18
<td><a accesskey="u" href="cogl-pipeline-apis.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
20
<th width="100%" align="center">Cogl 2.0 Reference Manual</th>
21
<td><a accesskey="n" href="cogl-buffer-apis.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
21
<td><a accesskey="n" href="cogl-2.0-experimental-Shader-snippets.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
22
</tr>
23
23
<tr><td colspan="5" class="shortcuts">
24
24
<a href="#cogl-2.0-experimental-Pipeline.synopsis" class="shortcut">Top</a>
38
38
</tr></table></div>
39
39
<div class="refsynopsisdiv">
40
40
<a name="cogl-2.0-experimental-Pipeline.synopsis"></a><h2>Synopsis</h2>
41
<pre class="synopsis">#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-new" title="cogl_pipeline_new">cogl_pipeline_new</a>
42
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-copy" title="cogl_pipeline_copy">cogl_pipeline_copy</a>
43
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-is-pipeline" title="cogl_is_pipeline">cogl_is_pipeline</a>
44
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color" title="cogl_pipeline_set_color">cogl_pipeline_set_color</a>
45
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color4ub" title="cogl_pipeline_set_color4ub">cogl_pipeline_set_color4ub</a>
46
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color4f" title="cogl_pipeline_set_color4f">cogl_pipeline_set_color4f</a>
47
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-color" title="cogl_pipeline_get_color">cogl_pipeline_get_color</a>
48
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-ambient" title="cogl_pipeline_set_ambient">cogl_pipeline_set_ambient</a>
49
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-ambient" title="cogl_pipeline_get_ambient">cogl_pipeline_get_ambient</a>
50
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-diffuse" title="cogl_pipeline_set_diffuse">cogl_pipeline_set_diffuse</a>
51
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-diffuse" title="cogl_pipeline_get_diffuse">cogl_pipeline_get_diffuse</a>
52
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-ambient-and-diffuse" title="cogl_pipeline_set_ambient_and_diffuse">cogl_pipeline_set_ambient_and_diffuse</a>
53
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-emission" title="cogl_pipeline_set_emission">cogl_pipeline_set_emission</a>
54
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-emission" title="cogl_pipeline_get_emission">cogl_pipeline_get_emission</a>
55
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-specular" title="cogl_pipeline_set_specular">cogl_pipeline_set_specular</a>
56
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-specular" title="cogl_pipeline_get_specular">cogl_pipeline_get_specular</a>
57
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-shininess" title="cogl_pipeline_set_shininess">cogl_pipeline_set_shininess</a>
58
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-shininess" title="cogl_pipeline_get_shininess">cogl_pipeline_get_shininess</a>
59
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-alpha-test-function" title="cogl_pipeline_set_alpha_test_function">cogl_pipeline_set_alpha_test_function</a>
41
<pre class="synopsis"><span class="returnvalue">CoglPipeline</span> * <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-new" title="cogl_pipeline_new ()">cogl_pipeline_new</a> (<em class="parameter"><code><span class="type">CoglContext</span> *context</code></em>);
42
<span class="returnvalue">CoglPipeline</span> * <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-copy" title="cogl_pipeline_copy ()">cogl_pipeline_copy</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *source</code></em>);
43
<span class="returnvalue">gboolean</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-is-pipeline" title="cogl_is_pipeline ()">cogl_is_pipeline</a> (<em class="parameter"><code><a href="../cogl/cogl-General-API.html#CoglHandle"><span class="type">CoglHandle</span></a> handle</code></em>);
44
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color" title="cogl_pipeline_set_color ()">cogl_pipeline_set_color</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
45
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *color</code></em>);
46
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color4ub" title="cogl_pipeline_set_color4ub ()">cogl_pipeline_set_color4ub</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
47
<em class="parameter"><code><span class="type">guint8</span> red</code></em>,
48
<em class="parameter"><code><span class="type">guint8</span> green</code></em>,
49
<em class="parameter"><code><span class="type">guint8</span> blue</code></em>,
50
<em class="parameter"><code><span class="type">guint8</span> alpha</code></em>);
51
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color4f" title="cogl_pipeline_set_color4f ()">cogl_pipeline_set_color4f</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
52
<em class="parameter"><code><span class="type">float</span> red</code></em>,
53
<em class="parameter"><code><span class="type">float</span> green</code></em>,
54
<em class="parameter"><code><span class="type">float</span> blue</code></em>,
55
<em class="parameter"><code><span class="type">float</span> alpha</code></em>);
56
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-color" title="cogl_pipeline_get_color ()">cogl_pipeline_get_color</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
57
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *color</code></em>);
58
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-ambient" title="cogl_pipeline_set_ambient ()">cogl_pipeline_set_ambient</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
59
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *ambient</code></em>);
60
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-ambient" title="cogl_pipeline_get_ambient ()">cogl_pipeline_get_ambient</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
61
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *ambient</code></em>);
62
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-diffuse" title="cogl_pipeline_set_diffuse ()">cogl_pipeline_set_diffuse</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
63
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *diffuse</code></em>);
64
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-diffuse" title="cogl_pipeline_get_diffuse ()">cogl_pipeline_get_diffuse</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
65
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *diffuse</code></em>);
66
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-ambient-and-diffuse" title="cogl_pipeline_set_ambient_and_diffuse ()">cogl_pipeline_set_ambient_and_diffuse</a>
67
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
68
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *color</code></em>);
69
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-emission" title="cogl_pipeline_set_emission ()">cogl_pipeline_set_emission</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
70
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *emission</code></em>);
71
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-emission" title="cogl_pipeline_get_emission ()">cogl_pipeline_get_emission</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
72
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *emission</code></em>);
73
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-specular" title="cogl_pipeline_set_specular ()">cogl_pipeline_set_specular</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
74
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *specular</code></em>);
75
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-specular" title="cogl_pipeline_get_specular ()">cogl_pipeline_get_specular</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
76
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *specular</code></em>);
77
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-shininess" title="cogl_pipeline_set_shininess ()">cogl_pipeline_set_shininess</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
78
<em class="parameter"><code><span class="type">float</span> shininess</code></em>);
79
<span class="returnvalue">float</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-shininess" title="cogl_pipeline_get_shininess ()">cogl_pipeline_get_shininess</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);
80
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-alpha-test-function" title="cogl_pipeline_set_alpha_test_function ()">cogl_pipeline_set_alpha_test_function</a>
81
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
82
<em class="parameter"><code><span class="type">CoglPipelineAlphaFunc</span> alpha_func</code></em>,
83
<em class="parameter"><code><span class="type">float</span> alpha_reference</code></em>);
60
84
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#COGL-BLEND-STRING-ERROR:CAPS" title="COGL_BLEND_STRING_ERROR">COGL_BLEND_STRING_ERROR</a>
61
85
enum <a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglBlendStringError" title="enum CoglBlendStringError">CoglBlendStringError</a>;
62
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-blend" title="cogl_pipeline_set_blend">cogl_pipeline_set_blend</a>
63
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-blend-constant" title="cogl_pipeline_set_blend_constant">cogl_pipeline_set_blend_constant</a>
64
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-point-size" title="cogl_pipeline_set_point_size">cogl_pipeline_set_point_size</a>
65
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-point-size" title="cogl_pipeline_get_point_size">cogl_pipeline_get_point_size</a>
66
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-color-mask" title="cogl_pipeline_get_color_mask">cogl_pipeline_get_color_mask</a>
67
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color-mask" title="cogl_pipeline_set_color_mask">cogl_pipeline_set_color_mask</a>
68
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-texture" title="cogl_pipeline_set_layer_texture">cogl_pipeline_set_layer_texture</a>
69
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-filters" title="cogl_pipeline_set_layer_filters">cogl_pipeline_set_layer_filters</a>
70
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode" title="cogl_pipeline_set_layer_wrap_mode">cogl_pipeline_set_layer_wrap_mode</a>
71
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-s" title="cogl_pipeline_set_layer_wrap_mode_s">cogl_pipeline_set_layer_wrap_mode_s</a>
72
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-t" title="cogl_pipeline_set_layer_wrap_mode_t">cogl_pipeline_set_layer_wrap_mode_t</a>
73
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-p" title="cogl_pipeline_set_layer_wrap_mode_p">cogl_pipeline_set_layer_wrap_mode_p</a>
74
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-combine" title="cogl_pipeline_set_layer_combine">cogl_pipeline_set_layer_combine</a>
75
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-combine-constant" title="cogl_pipeline_set_layer_combine_constant">cogl_pipeline_set_layer_combine_constant</a>
76
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-matrix" title="cogl_pipeline_set_layer_matrix">cogl_pipeline_set_layer_matrix</a>
77
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-point-sprite-coords-enabled" title="cogl_pipeline_set_layer_point_sprite_coords_enabled">cogl_pipeline_set_layer_point_sprite_coords_enabled</a>
78
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-layer-point-sprite-coords-enabled" title="cogl_pipeline_get_layer_point_sprite_coords_enabled">cogl_pipeline_get_layer_point_sprite_coords_enabled</a>
79
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-remove-layer" title="cogl_pipeline_remove_layer">cogl_pipeline_remove_layer</a>
80
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-n-layers" title="cogl_pipeline_get_n_layers">cogl_pipeline_get_n_layers</a>
81
#define <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-foreach-layer" title="cogl_pipeline_foreach_layer">cogl_pipeline_foreach_layer</a>
86
<span class="returnvalue">gboolean</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-blend" title="cogl_pipeline_set_blend ()">cogl_pipeline_set_blend</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
87
<em class="parameter"><code>const <span class="type">char</span> *blend_string</code></em>,
88
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
89
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-blend-constant" title="cogl_pipeline_set_blend_constant ()">cogl_pipeline_set_blend_constant</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
90
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *constant_color</code></em>);
91
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-point-size" title="cogl_pipeline_set_point_size ()">cogl_pipeline_set_point_size</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
92
<em class="parameter"><code><span class="type">float</span> point_size</code></em>);
93
<span class="returnvalue">float</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-point-size" title="cogl_pipeline_get_point_size ()">cogl_pipeline_get_point_size</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);
94
<a class="link" href="cogl-2.0-experimental-Common-Types.html#CoglColorMask" title="enum CoglColorMask"><span class="returnvalue">CoglColorMask</span></a> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-color-mask" title="cogl_pipeline_get_color_mask ()">cogl_pipeline_get_color_mask</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);
95
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color-mask" title="cogl_pipeline_set_color_mask ()">cogl_pipeline_set_color_mask</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
96
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Common-Types.html#CoglColorMask" title="enum CoglColorMask"><span class="type">CoglColorMask</span></a> color_mask</code></em>);
97
enum <a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglPipelineCullFaceMode" title="enum CoglPipelineCullFaceMode">CoglPipelineCullFaceMode</a>;
98
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-cull-face-mode" title="cogl_pipeline_set_cull_face_mode ()">cogl_pipeline_set_cull_face_mode</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
99
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglPipelineCullFaceMode" title="enum CoglPipelineCullFaceMode"><span class="type">CoglPipelineCullFaceMode</span></a> cull_face_mode</code></em>);
100
enum <a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglWinding" title="enum CoglWinding">CoglWinding</a>;
101
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-front-face-winding" title="cogl_pipeline_set_front_face_winding ()">cogl_pipeline_set_front_face_winding</a>
102
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
103
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglWinding" title="enum CoglWinding"><span class="type">CoglWinding</span></a> front_winding</code></em>);
104
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-texture" title="cogl_pipeline_set_layer_texture ()">cogl_pipeline_set_layer_texture</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
105
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
106
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-The-Texture-Interface.html#CoglTexture" title="CoglTexture"><span class="type">CoglTexture</span></a> *texture</code></em>);
107
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-null-texture" title="cogl_pipeline_set_layer_null_texture ()">cogl_pipeline_set_layer_null_texture</a>
108
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
109
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
110
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-The-Texture-Interface.html#CoglTextureType" title="enum CoglTextureType"><span class="type">CoglTextureType</span></a> texure_type</code></em>);
111
<a class="link" href="cogl-2.0-experimental-The-Texture-Interface.html#CoglTexture" title="CoglTexture"><span class="returnvalue">CoglTexture</span></a> * <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-layer-texture" title="cogl_pipeline_get_layer_texture ()">cogl_pipeline_get_layer_texture</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
112
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);
113
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-filters" title="cogl_pipeline_set_layer_filters ()">cogl_pipeline_set_layer_filters</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
114
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
115
<em class="parameter"><code><span class="type">CoglPipelineFilter</span> min_filter</code></em>,
116
<em class="parameter"><code><span class="type">CoglPipelineFilter</span> mag_filter</code></em>);
117
<span class="returnvalue">CoglPipelineFilter</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-layer-min-filter" title="cogl_pipeline_get_layer_min_filter ()">cogl_pipeline_get_layer_min_filter</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
118
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);
119
<span class="returnvalue">CoglPipelineFilter</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-layer-mag-filter" title="cogl_pipeline_get_layer_mag_filter ()">cogl_pipeline_get_layer_mag_filter</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
120
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);
121
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode" title="cogl_pipeline_set_layer_wrap_mode ()">cogl_pipeline_set_layer_wrap_mode</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
122
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
123
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);
124
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-s" title="cogl_pipeline_set_layer_wrap_mode_s ()">cogl_pipeline_set_layer_wrap_mode_s</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
125
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
126
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);
127
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-t" title="cogl_pipeline_set_layer_wrap_mode_t ()">cogl_pipeline_set_layer_wrap_mode_t</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
128
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
129
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);
130
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-p" title="cogl_pipeline_set_layer_wrap_mode_p ()">cogl_pipeline_set_layer_wrap_mode_p</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
131
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
132
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);
133
<span class="returnvalue">gboolean</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-combine" title="cogl_pipeline_set_layer_combine ()">cogl_pipeline_set_layer_combine</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
134
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
135
<em class="parameter"><code>const <span class="type">char</span> *blend_string</code></em>,
136
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
137
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-combine-constant" title="cogl_pipeline_set_layer_combine_constant ()">cogl_pipeline_set_layer_combine_constant</a>
138
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
139
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
140
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *constant</code></em>);
141
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-matrix" title="cogl_pipeline_set_layer_matrix ()">cogl_pipeline_set_layer_matrix</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
142
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
143
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Matrices.html#CoglMatrix" title="CoglMatrix"><span class="type">CoglMatrix</span></a> *matrix</code></em>);
144
<span class="returnvalue">gboolean</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-point-sprite-coords-enabled" title="cogl_pipeline_set_layer_point_sprite_coords_enabled ()">cogl_pipeline_set_layer_point_sprite_coords_enabled</a>
145
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
146
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
147
<em class="parameter"><code><span class="type">gboolean</span> enable</code></em>,
148
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);
149
<span class="returnvalue">gboolean</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-layer-point-sprite-coords-enabled" title="cogl_pipeline_get_layer_point_sprite_coords_enabled ()">cogl_pipeline_get_layer_point_sprite_coords_enabled</a>
150
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
151
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);
152
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-remove-layer" title="cogl_pipeline_remove_layer ()">cogl_pipeline_remove_layer</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
153
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);
154
<span class="returnvalue">int</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-n-layers" title="cogl_pipeline_get_n_layers ()">cogl_pipeline_get_n_layers</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);
155
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-foreach-layer" title="cogl_pipeline_foreach_layer ()">cogl_pipeline_foreach_layer</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
156
<em class="parameter"><code><span class="type">CoglPipelineLayerCallback</span> callback</code></em>,
157
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>);
158
<span class="returnvalue">int</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-uniform-location" title="cogl_pipeline_get_uniform_location ()">cogl_pipeline_get_uniform_location</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
159
<em class="parameter"><code>const <span class="type">char</span> *uniform_name</code></em>);
160
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-uniform-1f" title="cogl_pipeline_set_uniform_1f ()">cogl_pipeline_set_uniform_1f</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
161
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
162
<em class="parameter"><code><span class="type">float</span> value</code></em>);
163
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-uniform-1i" title="cogl_pipeline_set_uniform_1i ()">cogl_pipeline_set_uniform_1i</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
164
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
165
<em class="parameter"><code><span class="type">int</span> value</code></em>);
166
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-uniform-float" title="cogl_pipeline_set_uniform_float ()">cogl_pipeline_set_uniform_float</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
167
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
168
<em class="parameter"><code><span class="type">int</span> n_components</code></em>,
169
<em class="parameter"><code><span class="type">int</span> count</code></em>,
170
<em class="parameter"><code>const <span class="type">float</span> *value</code></em>);
171
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-uniform-int" title="cogl_pipeline_set_uniform_int ()">cogl_pipeline_set_uniform_int</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
172
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
173
<em class="parameter"><code><span class="type">int</span> n_components</code></em>,
174
<em class="parameter"><code><span class="type">int</span> count</code></em>,
175
<em class="parameter"><code>const <span class="type">int</span> *value</code></em>);
176
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-uniform-matrix" title="cogl_pipeline_set_uniform_matrix ()">cogl_pipeline_set_uniform_matrix</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
177
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
178
<em class="parameter"><code><span class="type">int</span> dimensions</code></em>,
179
<em class="parameter"><code><span class="type">int</span> count</code></em>,
180
<em class="parameter"><code><span class="type">gboolean</span> transpose</code></em>,
181
<em class="parameter"><code>const <span class="type">float</span> *value</code></em>);
182
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-add-snippet" title="cogl_pipeline_add_snippet ()">cogl_pipeline_add_snippet</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
183
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Shader-snippets.html#CoglSnippet" title="CoglSnippet"><span class="type">CoglSnippet</span></a> *snippet</code></em>);
184
<span class="returnvalue">void</span> <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-add-layer-snippet" title="cogl_pipeline_add_layer_snippet ()">cogl_pipeline_add_layer_snippet</a> (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
185
<em class="parameter"><code><span class="type">int</span> layer</code></em>,
186
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Shader-snippets.html#CoglSnippet" title="CoglSnippet"><span class="type">CoglSnippet</span></a> *snippet</code></em>);
82
187
</pre>
83
188
</div>
84
189
<div class="refsect1">
96
201
<div class="refsect1">
97
202
<a name="cogl-2.0-experimental-Pipeline.details"></a><h2>Details</h2>
98
203
<div class="refsect2">
99
<a name="cogl-pipeline-new"></a><h3>cogl_pipeline_new</h3>
100
<pre class="programlisting">#define cogl_pipeline_new cogl_pipeline_new_EXP
101
</pre>
204
<a name="cogl-pipeline-new"></a><h3>cogl_pipeline_new ()</h3>
205
<pre class="programlisting"><span class="returnvalue">CoglPipeline</span> * cogl_pipeline_new (<em class="parameter"><code><span class="type">CoglContext</span> *context</code></em>);</pre>
102
206
<p>
103
207
Allocates and initializes a default simple pipeline that will color
104
208
a primitive white.
105
209
</p>
106
210
<div class="variablelist"><table border="0">
107
211
<col align="left" valign="top">
108
<tbody><tr>
212
<tbody>
213
<tr>
214
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
215
<td>a <span class="type">CoglContext</span>
216
</td>
217
</tr>
218
<tr>
109
219
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
110
220
<td>a pointer to a new <span class="type">CoglPipeline</span>
111
221
</td>
112
</tr></tbody>
222
</tr>
223
</tbody>
113
224
</table></div>
114
225
<p class="since">Since 2.0</p>
115
226
<p class="stability">Stability Level: Unstable</p>
116
227
</div>
117
228
<hr>
118
229
<div class="refsect2">
119
<a name="cogl-pipeline-copy"></a><h3>cogl_pipeline_copy</h3>
120
<pre class="programlisting">#define cogl_pipeline_copy cogl_pipeline_copy_EXP
121
</pre>
230
<a name="cogl-pipeline-copy"></a><h3>cogl_pipeline_copy ()</h3>
231
<pre class="programlisting"><span class="returnvalue">CoglPipeline</span> * cogl_pipeline_copy (<em class="parameter"><code><span class="type">CoglPipeline</span> *source</code></em>);</pre>
122
232
<p>
123
233
Creates a new pipeline with the configuration copied from the
124
234
source pipeline.
125
235
</p>
126
236
<p>
127
237
We would strongly advise developers to always aim to use
128
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-copy" title="cogl_pipeline_copy"><code class="function">cogl_pipeline_copy()</code></a> instead of <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-new" title="cogl_pipeline_new"><code class="function">cogl_pipeline_new()</code></a> whenever there will
238
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-copy" title="cogl_pipeline_copy ()"><code class="function">cogl_pipeline_copy()</code></a> instead of <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-new" title="cogl_pipeline_new ()"><code class="function">cogl_pipeline_new()</code></a> whenever there will
129
239
be any similarity between two pipelines. Copying a pipeline helps Cogl
130
240
keep track of a pipelines ancestry which we may use to help minimize GPU
131
241
state changes.
149
259
</div>
150
260
<hr>
151
261
<div class="refsect2">
152
<a name="cogl-is-pipeline"></a><h3>cogl_is_pipeline</h3>
153
<pre class="programlisting">#define cogl_is_pipeline cogl_is_pipeline_EXP
154
</pre>
262
<a name="cogl-is-pipeline"></a><h3>cogl_is_pipeline ()</h3>
263
<pre class="programlisting"><span class="returnvalue">gboolean</span> cogl_is_pipeline (<em class="parameter"><code><a href="../cogl/cogl-General-API.html#CoglHandle"><span class="type">CoglHandle</span></a> handle</code></em>);</pre>
155
264
<p>
156
265
Gets whether the given handle references an existing pipeline object.
157
266
</p>
165
274
<tr>
166
275
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
167
276
<td>
168
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the handle references a <span class="type">CoglPipeline</span>,
169
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td>
277
<code class="literal">TRUE</code> if the handle references a <span class="type">CoglPipeline</span>,
278
<code class="literal">FALSE</code> otherwise</td>
170
279
</tr>
171
280
</tbody>
172
281
</table></div>
175
284
</div>
176
285
<hr>
177
286
<div class="refsect2">
178
<a name="cogl-pipeline-set-color"></a><h3>cogl_pipeline_set_color</h3>
179
<pre class="programlisting">#define cogl_pipeline_set_color cogl_pipeline_set_color_EXP
180
</pre>
287
<a name="cogl-pipeline-set-color"></a><h3>cogl_pipeline_set_color ()</h3>
288
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_color (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
289
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *color</code></em>);</pre>
181
290
<p>
182
291
Sets the basic color of the pipeline, used when no lighting is enabled.
183
292
</p>
208
317
</div>
209
318
<hr>
210
319
<div class="refsect2">
211
<a name="cogl-pipeline-set-color4ub"></a><h3>cogl_pipeline_set_color4ub</h3>
212
<pre class="programlisting">#define cogl_pipeline_set_color4ub cogl_pipeline_set_color4ub_EXP
213
</pre>
320
<a name="cogl-pipeline-set-color4ub"></a><h3>cogl_pipeline_set_color4ub ()</h3>
321
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_color4ub (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
322
<em class="parameter"><code><span class="type">guint8</span> red</code></em>,
323
<em class="parameter"><code><span class="type">guint8</span> green</code></em>,
324
<em class="parameter"><code><span class="type">guint8</span> blue</code></em>,
325
<em class="parameter"><code><span class="type">guint8</span> alpha</code></em>);</pre>
214
326
<p>
215
327
Sets the basic color of the pipeline, used when no lighting is enabled.
216
328
</p>
247
359
</div>
248
360
<hr>
249
361
<div class="refsect2">
250
<a name="cogl-pipeline-set-color4f"></a><h3>cogl_pipeline_set_color4f</h3>
251
<pre class="programlisting">#define cogl_pipeline_set_color4f cogl_pipeline_set_color4f_EXP
252
</pre>
362
<a name="cogl-pipeline-set-color4f"></a><h3>cogl_pipeline_set_color4f ()</h3>
363
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_color4f (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
364
<em class="parameter"><code><span class="type">float</span> red</code></em>,
365
<em class="parameter"><code><span class="type">float</span> green</code></em>,
366
<em class="parameter"><code><span class="type">float</span> blue</code></em>,
367
<em class="parameter"><code><span class="type">float</span> alpha</code></em>);</pre>
253
368
<p>
254
369
Sets the basic color of the pipeline, used when no lighting is enabled.
255
370
</p>
286
401
</div>
287
402
<hr>
288
403
<div class="refsect2">
289
<a name="cogl-pipeline-get-color"></a><h3>cogl_pipeline_get_color</h3>
290
<pre class="programlisting">#define cogl_pipeline_get_color cogl_pipeline_get_color_EXP
291
</pre>
404
<a name="cogl-pipeline-get-color"></a><h3>cogl_pipeline_get_color ()</h3>
405
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_get_color (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
406
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *color</code></em>);</pre>
292
407
<p>
293
408
Retrieves the current pipeline color.
294
409
</p>
311
426
</div>
312
427
<hr>
313
428
<div class="refsect2">
314
<a name="cogl-pipeline-set-ambient"></a><h3>cogl_pipeline_set_ambient</h3>
315
<pre class="programlisting">#define cogl_pipeline_set_ambient cogl_pipeline_set_ambient_EXP
316
</pre>
429
<a name="cogl-pipeline-set-ambient"></a><h3>cogl_pipeline_set_ambient ()</h3>
430
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_ambient (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
431
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *ambient</code></em>);</pre>
317
432
<p>
318
433
Sets the pipeline's ambient color, in the standard OpenGL lighting
319
434
model. The ambient color affects the overall color of the object.
344
459
</div>
345
460
<hr>
346
461
<div class="refsect2">
347
<a name="cogl-pipeline-get-ambient"></a><h3>cogl_pipeline_get_ambient</h3>
348
<pre class="programlisting">#define cogl_pipeline_get_ambient cogl_pipeline_get_ambient_EXP
349
</pre>
462
<a name="cogl-pipeline-get-ambient"></a><h3>cogl_pipeline_get_ambient ()</h3>
463
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_get_ambient (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
464
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *ambient</code></em>);</pre>
350
465
<p>
351
466
Retrieves the current ambient color for <em class="parameter"><code>pipeline</code></em>
352
467
</p>
368
483
</div>
369
484
<hr>
370
485
<div class="refsect2">
371
<a name="cogl-pipeline-set-diffuse"></a><h3>cogl_pipeline_set_diffuse</h3>
372
<pre class="programlisting">#define cogl_pipeline_set_diffuse cogl_pipeline_set_diffuse_EXP
373
</pre>
486
<a name="cogl-pipeline-set-diffuse"></a><h3>cogl_pipeline_set_diffuse ()</h3>
487
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_diffuse (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
488
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *diffuse</code></em>);</pre>
374
489
<p>
375
490
Sets the pipeline's diffuse color, in the standard OpenGL lighting
376
491
model. The diffuse color is most intense where the light hits the
397
512
</div>
398
513
<hr>
399
514
<div class="refsect2">
400
<a name="cogl-pipeline-get-diffuse"></a><h3>cogl_pipeline_get_diffuse</h3>
401
<pre class="programlisting">#define cogl_pipeline_get_diffuse cogl_pipeline_get_diffuse_EXP
402
</pre>
515
<a name="cogl-pipeline-get-diffuse"></a><h3>cogl_pipeline_get_diffuse ()</h3>
516
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_get_diffuse (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
517
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *diffuse</code></em>);</pre>
403
518
<p>
404
519
Retrieves the current diffuse color for <em class="parameter"><code>pipeline</code></em>
405
520
</p>
421
536
</div>
422
537
<hr>
423
538
<div class="refsect2">
424
<a name="cogl-pipeline-set-ambient-and-diffuse"></a><h3>cogl_pipeline_set_ambient_and_diffuse</h3>
425
<pre class="programlisting">#define cogl_pipeline_set_ambient_and_diffuse</pre>
539
<a name="cogl-pipeline-set-ambient-and-diffuse"></a><h3>cogl_pipeline_set_ambient_and_diffuse ()</h3>
540
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_ambient_and_diffuse
541
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
542
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *color</code></em>);</pre>
426
543
<p>
427
544
Conveniently sets the diffuse and ambient color of <em class="parameter"><code>pipeline</code></em> at the same
428
time. See <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-ambient" title="cogl_pipeline_set_ambient"><code class="function">cogl_pipeline_set_ambient()</code></a> and <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-diffuse" title="cogl_pipeline_set_diffuse"><code class="function">cogl_pipeline_set_diffuse()</code></a>.
545
time. See <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-ambient" title="cogl_pipeline_set_ambient ()"><code class="function">cogl_pipeline_set_ambient()</code></a> and <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-diffuse" title="cogl_pipeline_set_diffuse ()"><code class="function">cogl_pipeline_set_diffuse()</code></a>.
429
546
</p>
430
547
<p>
431
548
The default ambient color is (0.2, 0.2, 0.2, 1.0)
451
568
</div>
452
569
<hr>
453
570
<div class="refsect2">
454
<a name="cogl-pipeline-set-emission"></a><h3>cogl_pipeline_set_emission</h3>
455
<pre class="programlisting">#define cogl_pipeline_set_emission cogl_pipeline_set_emission_EXP
456
</pre>
571
<a name="cogl-pipeline-set-emission"></a><h3>cogl_pipeline_set_emission ()</h3>
572
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_emission (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
573
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *emission</code></em>);</pre>
457
574
<p>
458
575
Sets the pipeline's emissive color, in the standard OpenGL lighting
459
576
model. It will look like the surface is a light source emitting this
480
597
</div>
481
598
<hr>
482
599
<div class="refsect2">
483
<a name="cogl-pipeline-get-emission"></a><h3>cogl_pipeline_get_emission</h3>
484
<pre class="programlisting">#define cogl_pipeline_get_emission cogl_pipeline_get_emission_EXP
485
</pre>
600
<a name="cogl-pipeline-get-emission"></a><h3>cogl_pipeline_get_emission ()</h3>
601
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_get_emission (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
602
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *emission</code></em>);</pre>
486
603
<p>
487
604
Retrieves the pipelines current emission color.
488
605
</p>
504
621
</div>
505
622
<hr>
506
623
<div class="refsect2">
507
<a name="cogl-pipeline-set-specular"></a><h3>cogl_pipeline_set_specular</h3>
508
<pre class="programlisting">#define cogl_pipeline_set_specular cogl_pipeline_set_specular_EXP
509
</pre>
624
<a name="cogl-pipeline-set-specular"></a><h3>cogl_pipeline_set_specular ()</h3>
625
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_specular (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
626
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *specular</code></em>);</pre>
510
627
<p>
511
628
Sets the pipeline's specular color, in the standard OpenGL lighting
512
629
model. The intensity of the specular color depends on the viewport
533
650
</div>
534
651
<hr>
535
652
<div class="refsect2">
536
<a name="cogl-pipeline-get-specular"></a><h3>cogl_pipeline_get_specular</h3>
537
<pre class="programlisting">#define cogl_pipeline_get_specular cogl_pipeline_get_specular_EXP
538
</pre>
653
<a name="cogl-pipeline-get-specular"></a><h3>cogl_pipeline_get_specular ()</h3>
654
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_get_specular (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
655
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *specular</code></em>);</pre>
539
656
<p>
540
657
Retrieves the pipelines current specular color.
541
658
</p>
557
674
</div>
558
675
<hr>
559
676
<div class="refsect2">
560
<a name="cogl-pipeline-set-shininess"></a><h3>cogl_pipeline_set_shininess</h3>
561
<pre class="programlisting">#define cogl_pipeline_set_shininess cogl_pipeline_set_shininess_EXP
562
</pre>
677
<a name="cogl-pipeline-set-shininess"></a><h3>cogl_pipeline_set_shininess ()</h3>
678
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_shininess (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
679
<em class="parameter"><code><span class="type">float</span> shininess</code></em>);</pre>
563
680
<p>
564
681
Sets the shininess of the pipeline, in the standard OpenGL lighting
565
682
model, which determines the size of the specular highlights. A
587
704
</div>
588
705
<hr>
589
706
<div class="refsect2">
590
<a name="cogl-pipeline-get-shininess"></a><h3>cogl_pipeline_get_shininess</h3>
591
<pre class="programlisting">#define cogl_pipeline_get_shininess cogl_pipeline_get_shininess_EXP
592
</pre>
707
<a name="cogl-pipeline-get-shininess"></a><h3>cogl_pipeline_get_shininess ()</h3>
708
<pre class="programlisting"><span class="returnvalue">float</span> cogl_pipeline_get_shininess (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);</pre>
593
709
<p>
594
710
Retrieves the pipelines current emission color.
595
711
</p>
611
727
</div>
612
728
<hr>
613
729
<div class="refsect2">
614
<a name="cogl-pipeline-set-alpha-test-function"></a><h3>cogl_pipeline_set_alpha_test_function</h3>
615
<pre class="programlisting">#define cogl_pipeline_set_alpha_test_function</pre>
730
<a name="cogl-pipeline-set-alpha-test-function"></a><h3>cogl_pipeline_set_alpha_test_function ()</h3>
731
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_alpha_test_function
732
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
733
<em class="parameter"><code><span class="type">CoglPipelineAlphaFunc</span> alpha_func</code></em>,
734
<em class="parameter"><code><span class="type">float</span> alpha_reference</code></em>);</pre>
616
735
<p>
617
736
Before a primitive is blended with the framebuffer, it goes through an
618
737
alpha test stage which lets you discard fragments based on the current
650
769
<pre class="programlisting">#define COGL_BLEND_STRING_ERROR (cogl_blend_string_error_quark ())
651
770
</pre>
652
771
<p>
653
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> domain for blend string parser errors
772
<span class="type">GError</span> domain for blend string parser errors
654
773
</p>
655
774
<p class="since">Since 1.0</p>
656
775
</div>
697
816
</div>
698
817
<hr>
699
818
<div class="refsect2">
700
<a name="cogl-pipeline-set-blend"></a><h3>cogl_pipeline_set_blend</h3>
701
<pre class="programlisting">#define cogl_pipeline_set_blend cogl_pipeline_set_blend_EXP
702
</pre>
819
<a name="cogl-pipeline-set-blend"></a><h3>cogl_pipeline_set_blend ()</h3>
820
<pre class="programlisting"><span class="returnvalue">gboolean</span> cogl_pipeline_set_blend (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
821
<em class="parameter"><code>const <span class="type">char</span> *blend_string</code></em>,
822
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
703
823
<p>
704
824
If not already familiar; please refer <a class="link" href="cogl-Blend-Strings.html" title="Blend Strings">here</a>
705
825
for an overview of what blend strings are, and their syntax.
719
839
<tbody>
720
840
<tr>
721
841
<td class="listing_lines" align="right"><pre>1</pre></td>
722
<td class="listing_code"><pre class="programlisting"><span class="symbol"><</span><span class="normal">channel</span><span class="symbol">-</span><span class="normal">mask</span><span class="symbol">>=</span><span class="function">ADD</span><span class="symbol">(</span><span class="normal">SRC_COLOR</span><span class="symbol">*(<</span><span class="normal">factor</span><span class="symbol">>),</span><span class="normal"> DST_COLOR</span><span class="symbol">*(<</span><span class="normal">factor</span><span class="symbol">>))</span></pre></td>
842
<td class="listing_code"><pre class="programlisting"><channel-mask>=ADD(SRC_COLOR*(<factor>), DST_COLOR*(<factor>))</pre></td>
723
843
</tr>
724
844
</tbody>
725
845
</table>
733
853
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
734
854
<li class="listitem"><p>SRC_COLOR: The color of the in comming fragment</p></li>
735
855
<li class="listitem"><p>DST_COLOR: The color of the framebuffer</p></li>
736
<li class="listitem"><p>CONSTANT: The constant set via <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-blend-constant" title="cogl_pipeline_set_blend_constant"><code class="function">cogl_pipeline_set_blend_constant()</code></a></p></li>
856
<li class="listitem"><p>CONSTANT: The constant set via <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-blend-constant" title="cogl_pipeline_set_blend_constant ()"><code class="function">cogl_pipeline_set_blend_constant()</code></a></p></li>
737
857
</ul></div>
738
858
<p>
739
859
</p>
797
917
<tbody>
798
918
<tr>
799
919
<td class="listing_lines" align="right"><pre>1</pre></td>
800
<td class="listing_code"><pre class="programlisting"><span class="normal">RGBA </span><span class="symbol">=</span><span class="normal"> </span><span class="function">ADD</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">SRC_COLOR</span><span class="symbol">,</span><span class="normal"> DST_COLOR</span><span class="symbol">*(</span><span class="number">1</span><span class="symbol">-</span><span class="normal">SRC_COLOR</span><span class="symbol">[</span><span class="normal">A</span><span class="symbol">]))</span></pre></td>
920
<td class="listing_code"><pre class="programlisting">RGBA = ADD (SRC_COLOR, DST_COLOR*(<span class="number">1</span>-SRC_COLOR[A]))</pre></td>
801
921
</tr>
802
922
</tbody>
803
923
</table>
823
943
</tr>
824
944
<tr>
825
945
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
826
<td>return location for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> that may report lack of driver
946
<td>return location for a <span class="type">GError</span> that may report lack of driver
827
947
support if you give separate blend string statements for the alpha
828
948
channel and RGB channels since some drivers, or backends such as
829
GLES 1.1, don't support this feature. May be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case a
949
GLES 1.1, don't support this feature. May be <code class="literal">NULL</code>, in which case a
830
950
warning will be printed out using GLib's logging facilities if an
831
951
error is encountered.</td>
832
952
</tr>
833
953
<tr>
834
954
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
835
955
<td>
836
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the blend string was successfully parsed, and the
956
<code class="literal">TRUE</code> if the blend string was successfully parsed, and the
837
957
described blending is supported by the underlying driver/hardware. If
838
there was an error, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>error</code></em> is set accordingly (if
958
there was an error, <code class="literal">FALSE</code> is returned and <em class="parameter"><code>error</code></em> is set accordingly (if
839
959
present).</td>
840
960
</tr>
841
961
</tbody>
845
965
</div>
846
966
<hr>
847
967
<div class="refsect2">
848
<a name="cogl-pipeline-set-blend-constant"></a><h3>cogl_pipeline_set_blend_constant</h3>
849
<pre class="programlisting">#define cogl_pipeline_set_blend_constant cogl_pipeline_set_blend_constant_EXP
850
</pre>
968
<a name="cogl-pipeline-set-blend-constant"></a><h3>cogl_pipeline_set_blend_constant ()</h3>
969
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_blend_constant (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
970
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *constant_color</code></em>);</pre>
851
971
<p>
852
972
When blending is setup to reference a CONSTANT blend factor then
853
973
blending will depend on the constant set with this function.
870
990
</div>
871
991
<hr>
872
992
<div class="refsect2">
873
<a name="cogl-pipeline-set-point-size"></a><h3>cogl_pipeline_set_point_size</h3>
874
<pre class="programlisting">#define cogl_pipeline_set_point_size cogl_pipeline_set_point_size_EXP
875
</pre>
993
<a name="cogl-pipeline-set-point-size"></a><h3>cogl_pipeline_set_point_size ()</h3>
994
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_point_size (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
995
<em class="parameter"><code><span class="type">float</span> point_size</code></em>);</pre>
876
996
<p>
877
997
Changes the size of points drawn when <a href="../cogl/cogl-Vertex-Buffers.html#COGL-VERTICES-MODE-POINTS:CAPS"><code class="literal">COGL_VERTICES_MODE_POINTS</code></a> is
878
998
used with the vertex buffer API. Note that typically the GPU will
900
1020
</div>
901
1021
<hr>
902
1022
<div class="refsect2">
903
<a name="cogl-pipeline-get-point-size"></a><h3>cogl_pipeline_get_point_size</h3>
904
<pre class="programlisting">#define cogl_pipeline_get_point_size cogl_pipeline_get_point_size_EXP
905
</pre>
1023
<a name="cogl-pipeline-get-point-size"></a><h3>cogl_pipeline_get_point_size ()</h3>
1024
<pre class="programlisting"><span class="returnvalue">float</span> cogl_pipeline_get_point_size (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);</pre>
906
1025
<p>
907
1026
Get the size of points drawn when <a href="../cogl/cogl-Vertex-Buffers.html#COGL-VERTICES-MODE-POINTS:CAPS"><code class="literal">COGL_VERTICES_MODE_POINTS</code></a> is
908
1027
used with the vertex buffer API.
925
1044
</div>
926
1045
<hr>
927
1046
<div class="refsect2">
928
<a name="cogl-pipeline-get-color-mask"></a><h3>cogl_pipeline_get_color_mask</h3>
929
<pre class="programlisting">#define cogl_pipeline_get_color_mask cogl_pipeline_get_color_mask_EXP
930
</pre>
1047
<a name="cogl-pipeline-get-color-mask"></a><h3>cogl_pipeline_get_color_mask ()</h3>
1048
<pre class="programlisting"><a class="link" href="cogl-2.0-experimental-Common-Types.html#CoglColorMask" title="enum CoglColorMask"><span class="returnvalue">CoglColorMask</span></a> cogl_pipeline_get_color_mask (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);</pre>
931
1049
<p>
932
1050
Gets the current <a class="link" href="cogl-2.0-experimental-Common-Types.html#CoglColorMask" title="enum CoglColorMask"><span class="type">CoglColorMask</span></a> of which channels would be written to the
933
1051
current framebuffer. Each bit set in the mask means that the
952
1070
</div>
953
1071
<hr>
954
1072
<div class="refsect2">
955
<a name="cogl-pipeline-set-color-mask"></a><h3>cogl_pipeline_set_color_mask</h3>
956
<pre class="programlisting">#define cogl_pipeline_set_color_mask cogl_pipeline_set_color_mask_EXP
957
</pre>
1073
<a name="cogl-pipeline-set-color-mask"></a><h3>cogl_pipeline_set_color_mask ()</h3>
1074
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_color_mask (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1075
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Common-Types.html#CoglColorMask" title="enum CoglColorMask"><span class="type">CoglColorMask</span></a> color_mask</code></em>);</pre>
958
1076
<p>
959
1077
Defines a bit mask of which color channels should be written to the
960
1078
current framebuffer. If a bit is set in <em class="parameter"><code>color_mask</code></em> that means that
979
1097
</div>
980
1098
<hr>
981
1099
<div class="refsect2">
982
<a name="cogl-pipeline-set-layer-texture"></a><h3>cogl_pipeline_set_layer_texture</h3>
983
<pre class="programlisting">#define cogl_pipeline_set_layer_texture cogl_pipeline_set_layer_texture_EXP
984
</pre>
985
</div>
986
<hr>
987
<div class="refsect2">
988
<a name="cogl-pipeline-set-layer-filters"></a><h3>cogl_pipeline_set_layer_filters</h3>
989
<pre class="programlisting">#define cogl_pipeline_set_layer_filters cogl_pipeline_set_layer_filters_EXP
990
</pre>
1100
<a name="CoglPipelineCullFaceMode"></a><h3>enum CoglPipelineCullFaceMode</h3>
1101
<pre class="programlisting">typedef enum
1102
{
1103
COGL_PIPELINE_CULL_FACE_MODE_NONE,
1104
COGL_PIPELINE_CULL_FACE_MODE_FRONT,
1105
COGL_PIPELINE_CULL_FACE_MODE_BACK,
1106
COGL_PIPELINE_CULL_FACE_MODE_BOTH
1107
} CoglPipelineCullFaceMode;
1108
</pre>
1109
<p>
1110
Specifies which faces should be culled. This can be set on a
1111
pipeline using <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-cull-face-mode" title="cogl_pipeline_set_cull_face_mode ()"><code class="function">cogl_pipeline_set_cull_face_mode()</code></a>.
1112
</p>
1113
<div class="variablelist"><table border="0">
1114
<col align="left" valign="top">
1115
<tbody>
1116
<tr>
1117
<td><p><a name="COGL-PIPELINE-CULL-FACE-MODE-NONE:CAPS"></a><span class="term"><code class="literal">COGL_PIPELINE_CULL_FACE_MODE_NONE</code></span></p></td>
1118
<td>Neither face will be
1119
culled. This is the default.
1120
</td>
1121
</tr>
1122
<tr>
1123
<td><p><a name="COGL-PIPELINE-CULL-FACE-MODE-FRONT:CAPS"></a><span class="term"><code class="literal">COGL_PIPELINE_CULL_FACE_MODE_FRONT</code></span></p></td>
1124
<td>Front faces will be culled.
1125
</td>
1126
</tr>
1127
<tr>
1128
<td><p><a name="COGL-PIPELINE-CULL-FACE-MODE-BACK:CAPS"></a><span class="term"><code class="literal">COGL_PIPELINE_CULL_FACE_MODE_BACK</code></span></p></td>
1129
<td>Back faces will be culled.
1130
</td>
1131
</tr>
1132
<tr>
1133
<td><p><a name="COGL-PIPELINE-CULL-FACE-MODE-BOTH:CAPS"></a><span class="term"><code class="literal">COGL_PIPELINE_CULL_FACE_MODE_BOTH</code></span></p></td>
1134
<td>All faces will be culled.
1135
</td>
1136
</tr>
1137
</tbody>
1138
</table></div>
1139
</div>
1140
<hr>
1141
<div class="refsect2">
1142
<a name="cogl-pipeline-set-cull-face-mode"></a><h3>cogl_pipeline_set_cull_face_mode ()</h3>
1143
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_cull_face_mode (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1144
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglPipelineCullFaceMode" title="enum CoglPipelineCullFaceMode"><span class="type">CoglPipelineCullFaceMode</span></a> cull_face_mode</code></em>);</pre>
1145
<p>
1146
Sets which faces will be culled when drawing. Face culling can be
1147
used to increase efficiency by avoiding drawing faces that would
1148
get overridden. For example, if a model has gaps so that it is
1149
impossible to see the inside then faces which are facing away from
1150
the screen will never be seen so there is no point in drawing
1151
them. This can be acheived by setting the cull face mode to
1152
<a class="link" href="cogl-2.0-experimental-Pipeline.html#COGL-PIPELINE-CULL-FACE-MODE-BACK:CAPS"><code class="literal">COGL_PIPELINE_CULL_FACE_MODE_BACK</code></a>.
1153
</p>
1154
<p>
1155
Face culling relies on the primitives being drawn with a specific
1156
order to represent which faces are facing inside and outside the
1157
model. This order can be specified by calling
1158
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-front-face-winding" title="cogl_pipeline_set_front_face_winding ()"><code class="function">cogl_pipeline_set_front_face_winding()</code></a>.
1159
</p>
1160
<p>
1161
Status: Unstable
1162
</p>
1163
<div class="variablelist"><table border="0">
1164
<col align="left" valign="top">
1165
<tbody>
1166
<tr>
1167
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1168
<td>A <span class="type">CoglPipeline</span>
1169
</td>
1170
</tr>
1171
<tr>
1172
<td><p><span class="term"><em class="parameter"><code>cull_face_mode</code></em> :</span></p></td>
1173
<td>The new mode to set</td>
1174
</tr>
1175
</tbody>
1176
</table></div>
1177
<p class="since">Since 2.0</p>
1178
</div>
1179
<hr>
1180
<div class="refsect2">
1181
<a name="CoglWinding"></a><h3>enum CoglWinding</h3>
1182
<pre class="programlisting">typedef enum
1183
{
1184
COGL_WINDING_CLOCKWISE,
1185
COGL_WINDING_COUNTER_CLOCKWISE
1186
} CoglWinding;
1187
</pre>
1188
<p>
1189
Enum used to represent the two directions of rotation. This can be
1190
used to set the front face for culling by calling
1191
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-front-face-winding" title="cogl_pipeline_set_front_face_winding ()"><code class="function">cogl_pipeline_set_front_face_winding()</code></a>.
1192
</p>
1193
<div class="variablelist"><table border="0">
1194
<col align="left" valign="top">
1195
<tbody>
1196
<tr>
1197
<td><p><a name="COGL-WINDING-CLOCKWISE:CAPS"></a><span class="term"><code class="literal">COGL_WINDING_CLOCKWISE</code></span></p></td>
1198
<td>Vertices are in a clockwise order
1199
</td>
1200
</tr>
1201
<tr>
1202
<td><p><a name="COGL-WINDING-COUNTER-CLOCKWISE:CAPS"></a><span class="term"><code class="literal">COGL_WINDING_COUNTER_CLOCKWISE</code></span></p></td>
1203
<td>Vertices are in a counter-clockwise order
1204
</td>
1205
</tr>
1206
</tbody>
1207
</table></div>
1208
</div>
1209
<hr>
1210
<div class="refsect2">
1211
<a name="cogl-pipeline-set-front-face-winding"></a><h3>cogl_pipeline_set_front_face_winding ()</h3>
1212
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_front_face_winding
1213
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1214
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Pipeline.html#CoglWinding" title="enum CoglWinding"><span class="type">CoglWinding</span></a> front_winding</code></em>);</pre>
1215
<p>
1216
The order of the vertices within a primitive specifies whether it
1217
is considered to be front or back facing. This function specifies
1218
which order is considered to be the front
1219
faces. <a class="link" href="cogl-2.0-experimental-Pipeline.html#COGL-WINDING-COUNTER-CLOCKWISE:CAPS"><code class="literal">COGL_WINDING_COUNTER_CLOCKWISE</code></a> sets the front faces to
1220
primitives with vertices in a counter-clockwise order and
1221
<a class="link" href="cogl-2.0-experimental-Pipeline.html#COGL-WINDING-CLOCKWISE:CAPS"><code class="literal">COGL_WINDING_CLOCKWISE</code></a> sets them to be clockwise. The default is
1222
<a class="link" href="cogl-2.0-experimental-Pipeline.html#COGL-WINDING-COUNTER-CLOCKWISE:CAPS"><code class="literal">COGL_WINDING_COUNTER_CLOCKWISE</code></a>.
1223
</p>
1224
<p>
1225
Status: Unstable
1226
</p>
1227
<p class="since">Since 2.0</p>
1228
</div>
1229
<hr>
1230
<div class="refsect2">
1231
<a name="cogl-pipeline-set-layer-texture"></a><h3>cogl_pipeline_set_layer_texture ()</h3>
1232
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_texture (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1233
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1234
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-The-Texture-Interface.html#CoglTexture" title="CoglTexture"><span class="type">CoglTexture</span></a> *texture</code></em>);</pre>
1235
</div>
1236
<hr>
1237
<div class="refsect2">
1238
<a name="cogl-pipeline-set-layer-null-texture"></a><h3>cogl_pipeline_set_layer_null_texture ()</h3>
1239
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_null_texture
1240
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1241
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1242
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-The-Texture-Interface.html#CoglTextureType" title="enum CoglTextureType"><span class="type">CoglTextureType</span></a> texure_type</code></em>);</pre>
1243
<p>
1244
Sets the texture for this layer to be the default texture for the
1245
given type. This is equivalent to calling
1246
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-texture" title="cogl_pipeline_set_layer_texture ()"><code class="function">cogl_pipeline_set_layer_texture()</code></a> with <code class="literal">NULL</code> for the texture
1247
argument except that you can also specify the type of default
1248
texture to use. The default texture is a 1x1 pixel white texture.
1249
</p>
1250
<p>
1251
This function is mostly useful if you want to create a base
1252
pipeline that you want to create multiple copies from using
1253
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-copy" title="cogl_pipeline_copy ()"><code class="function">cogl_pipeline_copy()</code></a>. In that case this function can be used to
1254
specify the texture type so that any pipeline copies can share the
1255
internal texture type state for efficiency.
1256
</p>
1257
<div class="variablelist"><table border="0">
1258
<col align="left" valign="top">
1259
<tbody>
1260
<tr>
1261
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1262
<td>A <span class="type">CoglPipeline</span>
1263
</td>
1264
</tr>
1265
<tr>
1266
<td><p><span class="term"><em class="parameter"><code>layer_index</code></em> :</span></p></td>
1267
<td>The layer number to modify</td>
1268
</tr>
1269
<tr>
1270
<td><p><span class="term"><em class="parameter"><code>texture_type</code></em> :</span></p></td>
1271
<td>The type of the default texture to use</td>
1272
</tr>
1273
</tbody>
1274
</table></div>
1275
<p class="since">Since 1.10</p>
1276
<p class="stability">Stability Level: Unstable</p>
1277
</div>
1278
<hr>
1279
<div class="refsect2">
1280
<a name="cogl-pipeline-get-layer-texture"></a><h3>cogl_pipeline_get_layer_texture ()</h3>
1281
<pre class="programlisting"><a class="link" href="cogl-2.0-experimental-The-Texture-Interface.html#CoglTexture" title="CoglTexture"><span class="returnvalue">CoglTexture</span></a> * cogl_pipeline_get_layer_texture (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1282
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);</pre>
1283
<div class="variablelist"><table border="0">
1284
<col align="left" valign="top">
1285
<tbody>
1286
<tr>
1287
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1288
<td>A <span class="type">CoglPipeline</span> object</td>
1289
</tr>
1290
<tr>
1291
<td><p><span class="term"><em class="parameter"><code>layer_index</code></em> :</span></p></td>
1292
<td>the index of the layer</td>
1293
</tr>
1294
<tr>
1295
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1296
<td>the texture that was set for the given layer of the
1297
pipeline or <code class="literal">NULL</code> if no texture was set.</td>
1298
</tr>
1299
</tbody>
1300
</table></div>
1301
<p class="since">Since 1.10</p>
1302
<p class="stability">Stability Level: Unstable</p>
1303
</div>
1304
<hr>
1305
<div class="refsect2">
1306
<a name="cogl-pipeline-set-layer-filters"></a><h3>cogl_pipeline_set_layer_filters ()</h3>
1307
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_filters (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1308
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1309
<em class="parameter"><code><span class="type">CoglPipelineFilter</span> min_filter</code></em>,
1310
<em class="parameter"><code><span class="type">CoglPipelineFilter</span> mag_filter</code></em>);</pre>
991
1311
<p>
992
1312
Changes the decimation and interpolation filters used when a texture is
993
1313
drawn at other scales than 100%.
1013
1333
</tr>
1014
1334
</tbody>
1015
1335
</table></div>
1016
</div>
1017
<hr>
1018
<div class="refsect2">
1019
<a name="cogl-pipeline-set-layer-wrap-mode"></a><h3>cogl_pipeline_set_layer_wrap_mode</h3>
1020
<pre class="programlisting">#define cogl_pipeline_set_layer_wrap_mode</pre>
1336
<p class="since">Since 1.10</p>
1337
<p class="stability">Stability Level: Unstable</p>
1338
</div>
1339
<hr>
1340
<div class="refsect2">
1341
<a name="cogl-pipeline-get-layer-min-filter"></a><h3>cogl_pipeline_get_layer_min_filter ()</h3>
1342
<pre class="programlisting"><span class="returnvalue">CoglPipelineFilter</span> cogl_pipeline_get_layer_min_filter (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1343
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);</pre>
1344
<p>
1345
Retrieves the currently set minification <span class="type">CoglPipelineFilter</span> set on
1346
the specified layer. The miniifcation filter determines how the
1347
layer should be sampled when down-scaled.
1348
</p>
1349
<p>
1350
The default filter is <code class="literal">COGL_PIPELINE_FILTER_LINEAR</code> but this can be
1351
changed using <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-filters" title="cogl_pipeline_set_layer_filters ()"><code class="function">cogl_pipeline_set_layer_filters()</code></a>.
1352
</p>
1353
<div class="variablelist"><table border="0">
1354
<col align="left" valign="top">
1355
<tbody>
1356
<tr>
1357
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1358
<td>A <span class="type">CoglPipeline</span> object</td>
1359
</tr>
1360
<tr>
1361
<td><p><span class="term"><em class="parameter"><code>layer_index</code></em> :</span></p></td>
1362
<td>the layer number to change.</td>
1363
</tr>
1364
<tr>
1365
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1366
<td>The minification <span class="type">CoglPipelineFilter</span> for the
1367
specified layer.</td>
1368
</tr>
1369
</tbody>
1370
</table></div>
1371
<p class="since">Since 1.10</p>
1372
<p class="stability">Stability Level: Unstable</p>
1373
</div>
1374
<hr>
1375
<div class="refsect2">
1376
<a name="cogl-pipeline-get-layer-mag-filter"></a><h3>cogl_pipeline_get_layer_mag_filter ()</h3>
1377
<pre class="programlisting"><span class="returnvalue">CoglPipelineFilter</span> cogl_pipeline_get_layer_mag_filter (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1378
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);</pre>
1379
<p>
1380
Retrieves the currently set magnification <span class="type">CoglPipelineFilter</span> set on
1381
the specified layer. The magnification filter determines how the
1382
layer should be sampled when up-scaled.
1383
</p>
1384
<p>
1385
The default filter is <code class="literal">COGL_PIPELINE_FILTER_LINEAR</code> but this can be
1386
changed using <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-filters" title="cogl_pipeline_set_layer_filters ()"><code class="function">cogl_pipeline_set_layer_filters()</code></a>.
1387
</p>
1388
<div class="variablelist"><table border="0">
1389
<col align="left" valign="top">
1390
<tbody>
1391
<tr>
1392
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1393
<td>A <span class="type">CoglPipeline</span> object</td>
1394
</tr>
1395
<tr>
1396
<td><p><span class="term"><em class="parameter"><code>layer_index</code></em> :</span></p></td>
1397
<td>the layer number to change.</td>
1398
</tr>
1399
<tr>
1400
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1401
<td>The magnification <span class="type">CoglPipelineFilter</span> for the
1402
specified layer.</td>
1403
</tr>
1404
</tbody>
1405
</table></div>
1406
<p class="since">Since 1.10</p>
1407
<p class="stability">Stability Level: Unstable</p>
1408
</div>
1409
<hr>
1410
<div class="refsect2">
1411
<a name="cogl-pipeline-set-layer-wrap-mode"></a><h3>cogl_pipeline_set_layer_wrap_mode ()</h3>
1412
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_wrap_mode (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1413
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1414
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);</pre>
1021
1415
<p>
1022
1416
Sets the wrap mode for all three coordinates of texture lookups on
1023
1417
this layer. This is equivalent to calling
1024
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-s" title="cogl_pipeline_set_layer_wrap_mode_s"><code class="function">cogl_pipeline_set_layer_wrap_mode_s()</code></a>,
1025
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-t" title="cogl_pipeline_set_layer_wrap_mode_t"><code class="function">cogl_pipeline_set_layer_wrap_mode_t()</code></a> and
1026
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-p" title="cogl_pipeline_set_layer_wrap_mode_p"><code class="function">cogl_pipeline_set_layer_wrap_mode_p()</code></a> separately.
1418
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-s" title="cogl_pipeline_set_layer_wrap_mode_s ()"><code class="function">cogl_pipeline_set_layer_wrap_mode_s()</code></a>,
1419
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-t" title="cogl_pipeline_set_layer_wrap_mode_t ()"><code class="function">cogl_pipeline_set_layer_wrap_mode_t()</code></a> and
1420
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-layer-wrap-mode-p" title="cogl_pipeline_set_layer_wrap_mode_p ()"><code class="function">cogl_pipeline_set_layer_wrap_mode_p()</code></a> separately.
1027
1421
</p>
1028
1422
<div class="variablelist"><table border="0">
1029
1423
<col align="left" valign="top">
1043
1437
</tbody>
1044
1438
</table></div>
1045
1439
<p class="since">Since 2.0</p>
1440
<p class="stability">Stability Level: Unstable</p>
1046
1441
</div>
1047
1442
<hr>
1048
1443
<div class="refsect2">
1049
<a name="cogl-pipeline-set-layer-wrap-mode-s"></a><h3>cogl_pipeline_set_layer_wrap_mode_s</h3>
1050
<pre class="programlisting">#define cogl_pipeline_set_layer_wrap_mode_s</pre>
1444
<a name="cogl-pipeline-set-layer-wrap-mode-s"></a><h3>cogl_pipeline_set_layer_wrap_mode_s ()</h3>
1445
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_wrap_mode_s (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1446
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1447
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);</pre>
1051
1448
<p>
1052
1449
Sets the wrap mode for the 's' coordinate of texture lookups on this layer.
1053
1450
</p>
1069
1466
</tbody>
1070
1467
</table></div>
1071
1468
<p class="since">Since 2.0</p>
1469
<p class="stability">Stability Level: Unstable</p>
1072
1470
</div>
1073
1471
<hr>
1074
1472
<div class="refsect2">
1075
<a name="cogl-pipeline-set-layer-wrap-mode-t"></a><h3>cogl_pipeline_set_layer_wrap_mode_t</h3>
1076
<pre class="programlisting">#define cogl_pipeline_set_layer_wrap_mode_t</pre>
1473
<a name="cogl-pipeline-set-layer-wrap-mode-t"></a><h3>cogl_pipeline_set_layer_wrap_mode_t ()</h3>
1474
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_wrap_mode_t (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1475
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1476
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);</pre>
1077
1477
<p>
1078
1478
Sets the wrap mode for the 't' coordinate of texture lookups on this layer.
1079
1479
</p>
1095
1495
</tbody>
1096
1496
</table></div>
1097
1497
<p class="since">Since 2.0</p>
1498
<p class="stability">Stability Level: Unstable</p>
1098
1499
</div>
1099
1500
<hr>
1100
1501
<div class="refsect2">
1101
<a name="cogl-pipeline-set-layer-wrap-mode-p"></a><h3>cogl_pipeline_set_layer_wrap_mode_p</h3>
1102
<pre class="programlisting">#define cogl_pipeline_set_layer_wrap_mode_p</pre>
1502
<a name="cogl-pipeline-set-layer-wrap-mode-p"></a><h3>cogl_pipeline_set_layer_wrap_mode_p ()</h3>
1503
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_wrap_mode_p (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1504
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1505
<em class="parameter"><code><span class="type">CoglPipelineWrapMode</span> mode</code></em>);</pre>
1103
1506
<p>
1104
1507
Sets the wrap mode for the 'p' coordinate of texture lookups on
1105
1508
this layer. 'p' is the third coordinate.
1122
1525
</tbody>
1123
1526
</table></div>
1124
1527
<p class="since">Since 2.0</p>
1528
<p class="stability">Stability Level: Unstable</p>
1125
1529
</div>
1126
1530
<hr>
1127
1531
<div class="refsect2">
1128
<a name="cogl-pipeline-set-layer-combine"></a><h3>cogl_pipeline_set_layer_combine</h3>
1129
<pre class="programlisting">#define cogl_pipeline_set_layer_combine cogl_pipeline_set_layer_combine_EXP
1130
</pre>
1532
<a name="cogl-pipeline-set-layer-combine"></a><h3>cogl_pipeline_set_layer_combine ()</h3>
1533
<pre class="programlisting"><span class="returnvalue">gboolean</span> cogl_pipeline_set_layer_combine (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1534
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1535
<em class="parameter"><code>const <span class="type">char</span> *blend_string</code></em>,
1536
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
1131
1537
<p>
1132
1538
If not already familiar; you can refer
1133
1539
<a class="link" href="cogl-Blend-Strings.html" title="Blend Strings">here</a> for an overview of what blend
1182
1588
<tr>
1183
1589
<td><p><span class="term">PRIMARY</span></p></td>
1184
1590
<td>Use the color of the pipeline as set with
1185
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color" title="cogl_pipeline_set_color"><code class="function">cogl_pipeline_set_color()</code></a>
1591
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color" title="cogl_pipeline_set_color ()"><code class="function">cogl_pipeline_set_color()</code></a>
1186
1592
</td>
1187
1593
</tr>
1188
1594
<tr>
1189
1595
<td><p><span class="term">PREVIOUS</span></p></td>
1190
1596
<td>Either use the texture color from the previous layer, or
1191
1597
if this is layer 0, use the color of the pipeline as set with
1192
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color" title="cogl_pipeline_set_color"><code class="function">cogl_pipeline_set_color()</code></a>
1598
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-color" title="cogl_pipeline_set_color ()"><code class="function">cogl_pipeline_set_color()</code></a>
1193
1599
</td>
1194
1600
</tr>
1195
1601
</tbody>
1206
1612
<tbody>
1207
1613
<tr>
1208
1614
<td class="listing_lines" align="right"><pre>1</pre></td>
1209
<td class="listing_code"><pre class="programlisting"><span class="normal">RGBA </span><span class="symbol">=</span><span class="normal"> </span><span class="function">MODULATE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">PREVIOUS</span><span class="symbol">,</span><span class="normal"> TEXTURE</span><span class="symbol">)</span></pre></td>
1615
<td class="listing_code"><pre class="programlisting">RGBA = MODULATE (PREVIOUS, TEXTURE)</pre></td>
1210
1616
</tr>
1211
1617
</tbody>
1212
1618
</table>
1220
1626
<tbody>
1221
1627
<tr>
1222
1628
<td class="listing_lines" align="right"><pre>1</pre></td>
1223
<td class="listing_code"><pre class="programlisting"><span class="normal">RGBA </span><span class="symbol">=</span><span class="normal"> </span><span class="function">INTERPOLATE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">PREVIOUS</span><span class="symbol">,</span><span class="normal"> TEXTURE</span><span class="symbol">,</span><span class="normal"> CONSTANT</span><span class="symbol">[</span><span class="normal">A</span><span class="symbol">])</span></pre></td>
1629
<td class="listing_code"><pre class="programlisting">RGBA = INTERPOLATE (PREVIOUS, TEXTURE, CONSTANT[A])</pre></td>
1224
1630
</tr>
1225
1631
</tbody>
1226
1632
</table>
1254
1660
</tr>
1255
1661
<tr>
1256
1662
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1257
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> that may report parse errors or lack of GPU/driver
1258
support. May be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case a warning will be printed out if an
1663
<td>A <span class="type">GError</span> that may report parse errors or lack of GPU/driver
1664
support. May be <code class="literal">NULL</code>, in which case a warning will be printed out if an
1259
1665
error is encountered.</td>
1260
1666
</tr>
1261
1667
<tr>
1262
1668
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1263
1669
<td>
1264
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the blend string was successfully parsed, and the
1670
<code class="literal">TRUE</code> if the blend string was successfully parsed, and the
1265
1671
described texture combining is supported by the underlying driver and
1266
or hardware. On failure, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>error</code></em> is set</td>
1672
or hardware. On failure, <code class="literal">FALSE</code> is returned and <em class="parameter"><code>error</code></em> is set</td>
1267
1673
</tr>
1268
1674
</tbody>
1269
1675
</table></div>
1270
1676
<p class="since">Since 2.0</p>
1677
<p class="stability">Stability Level: Unstable</p>
1271
1678
</div>
1272
1679
<hr>
1273
1680
<div class="refsect2">
1274
<a name="cogl-pipeline-set-layer-combine-constant"></a><h3>cogl_pipeline_set_layer_combine_constant</h3>
1275
<pre class="programlisting">#define cogl_pipeline_set_layer_combine_constant</pre>
1681
<a name="cogl-pipeline-set-layer-combine-constant"></a><h3>cogl_pipeline_set_layer_combine_constant ()</h3>
1682
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_combine_constant
1683
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1684
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1685
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Color-Type.html#CoglColor" title="struct CoglColor"><span class="type">CoglColor</span></a> *constant</code></em>);</pre>
1276
1686
<p>
1277
1687
When you are using the 'CONSTANT' color source in a layer combine
1278
1688
description then you can use this function to define its value.
1296
1706
</tbody>
1297
1707
</table></div>
1298
1708
<p class="since">Since 2.0</p>
1709
<p class="stability">Stability Level: Unstable</p>
1299
1710
</div>
1300
1711
<hr>
1301
1712
<div class="refsect2">
1302
<a name="cogl-pipeline-set-layer-matrix"></a><h3>cogl_pipeline_set_layer_matrix</h3>
1303
<pre class="programlisting">#define cogl_pipeline_set_layer_matrix cogl_pipeline_set_layer_matrix_EXP
1304
</pre>
1713
<a name="cogl-pipeline-set-layer-matrix"></a><h3>cogl_pipeline_set_layer_matrix ()</h3>
1714
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_layer_matrix (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1715
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1716
<em class="parameter"><code>const <a class="link" href="cogl-2.0-experimental-Matrices.html#CoglMatrix" title="CoglMatrix"><span class="type">CoglMatrix</span></a> *matrix</code></em>);</pre>
1305
1717
<p>
1306
1718
This function lets you set a matrix that can be used to e.g. translate
1307
1719
and rotate a single layer of a pipeline used to fill your geometry.
1324
1736
</tr>
1325
1737
</tbody>
1326
1738
</table></div>
1739
<p class="since">Since 1.10</p>
1740
<p class="stability">Stability Level: Unstable</p>
1327
1741
</div>
1328
1742
<hr>
1329
1743
<div class="refsect2">
1330
<a name="cogl-pipeline-set-layer-point-sprite-coords-enabled"></a><h3>cogl_pipeline_set_layer_point_sprite_coords_enabled</h3>
1331
<pre class="programlisting">#define cogl_pipeline_set_layer_point_sprite_coords_enabled</pre>
1744
<a name="cogl-pipeline-set-layer-point-sprite-coords-enabled"></a><h3>cogl_pipeline_set_layer_point_sprite_coords_enabled ()</h3>
1745
<pre class="programlisting"><span class="returnvalue">gboolean</span> cogl_pipeline_set_layer_point_sprite_coords_enabled
1746
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1747
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>,
1748
<em class="parameter"><code><span class="type">gboolean</span> enable</code></em>,
1749
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
1332
1750
<p>
1333
When rendering points, if <em class="parameter"><code>enable</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then the texture
1751
When rendering points, if <em class="parameter"><code>enable</code></em> is <code class="literal">TRUE</code> then the texture
1334
1752
coordinates for this layer will be replaced with coordinates that
1335
1753
vary from 0.0 to 1.0 across the primitive. The top left of the
1336
1754
point will have the coordinates 0.0,0.0 and the bottom right will
1337
have 1.0,1.0. If <em class="parameter"><code>enable</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then the coordinates will be
1755
have 1.0,1.0. If <em class="parameter"><code>enable</code></em> is <code class="literal">FALSE</code> then the coordinates will be
1338
1756
fixed for the entire point.
1339
1757
</p>
1340
1758
<p>
1341
1759
This function will only work if <a href="../cogl/cogl-General-API.html#COGL-FEATURE-POINT-SPRITE:CAPS"><code class="literal">COGL_FEATURE_POINT_SPRITE</code></a> is
1342
1760
available. If the feature is not available then the function will
1343
return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <em class="parameter"><code>error</code></em>.
1761
return <code class="literal">FALSE</code> and set <em class="parameter"><code>error</code></em>.
1344
1762
</p>
1345
1763
<div class="variablelist"><table border="0">
1346
1764
<col align="left" valign="top">
1364
1782
<tr>
1365
1783
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1366
1784
<td>
1367
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the function succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1785
<code class="literal">TRUE</code> if the function succeeds, <code class="literal">FALSE</code> otherwise.</td>
1368
1786
</tr>
1369
1787
</tbody>
1370
1788
</table></div>
1371
1789
<p class="since">Since 2.0</p>
1790
<p class="stability">Stability Level: Unstable</p>
1372
1791
</div>
1373
1792
<hr>
1374
1793
<div class="refsect2">
1375
<a name="cogl-pipeline-get-layer-point-sprite-coords-enabled"></a><h3>cogl_pipeline_get_layer_point_sprite_coords_enabled</h3>
1376
<pre class="programlisting">#define cogl_pipeline_get_layer_point_sprite_coords_enabled</pre>
1794
<a name="cogl-pipeline-get-layer-point-sprite-coords-enabled"></a><h3>cogl_pipeline_get_layer_point_sprite_coords_enabled ()</h3>
1795
<pre class="programlisting"><span class="returnvalue">gboolean</span> cogl_pipeline_get_layer_point_sprite_coords_enabled
1796
(<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1797
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);</pre>
1377
1798
<p>
1378
1799
Gets whether point sprite coordinate generation is enabled for this
1379
1800
texture layer.
1397
1818
</tbody>
1398
1819
</table></div>
1399
1820
<p class="since">Since 2.0</p>
1821
<p class="stability">Stability Level: Unstable</p>
1400
1822
</div>
1401
1823
<hr>
1402
1824
<div class="refsect2">
1403
<a name="cogl-pipeline-remove-layer"></a><h3>cogl_pipeline_remove_layer</h3>
1404
<pre class="programlisting">#define cogl_pipeline_remove_layer cogl_pipeline_remove_layer_EXP
1405
</pre>
1825
<a name="cogl-pipeline-remove-layer"></a><h3>cogl_pipeline_remove_layer ()</h3>
1826
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_remove_layer (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1827
<em class="parameter"><code><span class="type">int</span> layer_index</code></em>);</pre>
1406
1828
<p>
1407
1829
This function removes a layer from your pipeline
1408
1830
</p>
1419
1841
</tr>
1420
1842
</tbody>
1421
1843
</table></div>
1844
<p class="since">Since 1.10</p>
1845
<p class="stability">Stability Level: Unstable</p>
1422
1846
</div>
1423
1847
<hr>
1424
1848
<div class="refsect2">
1425
<a name="cogl-pipeline-get-n-layers"></a><h3>cogl_pipeline_get_n_layers</h3>
1426
<pre class="programlisting">#define cogl_pipeline_get_n_layers cogl_pipeline_get_n_layers_EXP
1427
</pre>
1849
<a name="cogl-pipeline-get-n-layers"></a><h3>cogl_pipeline_get_n_layers ()</h3>
1850
<pre class="programlisting"><span class="returnvalue">int</span> cogl_pipeline_get_n_layers (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>);</pre>
1428
1851
<p>
1429
1852
Retrieves the number of layers defined for the given <em class="parameter"><code>pipeline</code></em>
1430
1853
</p>
1442
1865
</tbody>
1443
1866
</table></div>
1444
1867
<p class="since">Since 2.0</p>
1868
<p class="stability">Stability Level: Unstable</p>
1445
1869
</div>
1446
1870
<hr>
1447
1871
<div class="refsect2">
1448
<a name="cogl-pipeline-foreach-layer"></a><h3>cogl_pipeline_foreach_layer</h3>
1449
<pre class="programlisting">#define cogl_pipeline_foreach_layer cogl_pipeline_foreach_layer_EXP
1450
</pre>
1872
<a name="cogl-pipeline-foreach-layer"></a><h3>cogl_pipeline_foreach_layer ()</h3>
1873
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_foreach_layer (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1874
<em class="parameter"><code><span class="type">CoglPipelineLayerCallback</span> callback</code></em>,
1875
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>);</pre>
1451
1876
<p>
1452
1877
Iterates all the layer indices of the given <em class="parameter"><code>pipeline</code></em>.
1453
1878
</p>
1472
1897
<p class="since">Since 2.0</p>
1473
1898
<p class="stability">Stability Level: Unstable</p>
1474
1899
</div>
1900
<hr>
1901
<div class="refsect2">
1902
<a name="cogl-pipeline-get-uniform-location"></a><h3>cogl_pipeline_get_uniform_location ()</h3>
1903
<pre class="programlisting"><span class="returnvalue">int</span> cogl_pipeline_get_uniform_location (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1904
<em class="parameter"><code>const <span class="type">char</span> *uniform_name</code></em>);</pre>
1905
<p>
1906
This is used to get an integer representing the uniform with the
1907
name <em class="parameter"><code>uniform_name</code></em>. The integer can be passed to functions such as
1908
<a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-set-uniform-1f" title="cogl_pipeline_set_uniform_1f ()"><code class="function">cogl_pipeline_set_uniform_1f()</code></a> to set the value of a uniform.
1909
</p>
1910
<p>
1911
This function will always return a valid integer. Ie, unlike
1912
OpenGL, it does not return -1 if the uniform is not available in
1913
this pipeline so it can not be used to test whether uniforms are
1914
present. It is not necessary to set the program on the pipeline
1915
before calling this function.
1916
</p>
1917
<div class="variablelist"><table border="0">
1918
<col align="left" valign="top">
1919
<tbody>
1920
<tr>
1921
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1922
<td>A <span class="type">CoglPipeline</span> object</td>
1923
</tr>
1924
<tr>
1925
<td><p><span class="term"><em class="parameter"><code>uniform_name</code></em> :</span></p></td>
1926
<td>The name of a uniform</td>
1927
</tr>
1928
<tr>
1929
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1930
<td>A integer representing the location of the given uniform.</td>
1931
</tr>
1932
</tbody>
1933
</table></div>
1934
<p class="since">Since 2.0</p>
1935
<p class="stability">Stability Level: Unstable</p>
1936
</div>
1937
<hr>
1938
<div class="refsect2">
1939
<a name="cogl-pipeline-set-uniform-1f"></a><h3>cogl_pipeline_set_uniform_1f ()</h3>
1940
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_uniform_1f (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1941
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
1942
<em class="parameter"><code><span class="type">float</span> value</code></em>);</pre>
1943
<p>
1944
Sets a new value for the uniform at <em class="parameter"><code>uniform_location</code></em>. If this
1945
pipeline has a user program attached and is later used as a source
1946
for drawing, the given value will be assigned to the uniform which
1947
can be accessed from the shader's source. The value for
1948
<em class="parameter"><code>uniform_location</code></em> should be retrieved from the string name of the
1949
uniform by calling <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-uniform-location" title="cogl_pipeline_get_uniform_location ()"><code class="function">cogl_pipeline_get_uniform_location()</code></a>.
1950
</p>
1951
<p>
1952
This function should be used to set uniforms that are of type
1953
float. It can also be used to set a single member of a float array
1954
uniform.
1955
</p>
1956
<div class="variablelist"><table border="0">
1957
<col align="left" valign="top">
1958
<tbody>
1959
<tr>
1960
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
1961
<td>A <span class="type">CoglPipeline</span> object</td>
1962
</tr>
1963
<tr>
1964
<td><p><span class="term"><em class="parameter"><code>uniform_location</code></em> :</span></p></td>
1965
<td>The uniform's location identifier</td>
1966
</tr>
1967
<tr>
1968
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1969
<td>The new value for the uniform</td>
1970
</tr>
1971
</tbody>
1972
</table></div>
1973
<p class="since">Since 2.0</p>
1974
<p class="stability">Stability Level: Unstable</p>
1975
</div>
1976
<hr>
1977
<div class="refsect2">
1978
<a name="cogl-pipeline-set-uniform-1i"></a><h3>cogl_pipeline_set_uniform_1i ()</h3>
1979
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_uniform_1i (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
1980
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
1981
<em class="parameter"><code><span class="type">int</span> value</code></em>);</pre>
1982
<p>
1983
Sets a new value for the uniform at <em class="parameter"><code>uniform_location</code></em>. If this
1984
pipeline has a user program attached and is later used as a source
1985
for drawing, the given value will be assigned to the uniform which
1986
can be accessed from the shader's source. The value for
1987
<em class="parameter"><code>uniform_location</code></em> should be retrieved from the string name of the
1988
uniform by calling <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-uniform-location" title="cogl_pipeline_get_uniform_location ()"><code class="function">cogl_pipeline_get_uniform_location()</code></a>.
1989
</p>
1990
<p>
1991
This function should be used to set uniforms that are of type
1992
int. It can also be used to set a single member of a int array
1993
uniform or a sampler uniform.
1994
</p>
1995
<div class="variablelist"><table border="0">
1996
<col align="left" valign="top">
1997
<tbody>
1998
<tr>
1999
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
2000
<td>A <span class="type">CoglPipeline</span> object</td>
2001
</tr>
2002
<tr>
2003
<td><p><span class="term"><em class="parameter"><code>uniform_location</code></em> :</span></p></td>
2004
<td>The uniform's location identifier</td>
2005
</tr>
2006
<tr>
2007
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2008
<td>The new value for the uniform</td>
2009
</tr>
2010
</tbody>
2011
</table></div>
2012
<p class="since">Since 2.0</p>
2013
<p class="stability">Stability Level: Unstable</p>
2014
</div>
2015
<hr>
2016
<div class="refsect2">
2017
<a name="cogl-pipeline-set-uniform-float"></a><h3>cogl_pipeline_set_uniform_float ()</h3>
2018
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_uniform_float (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
2019
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
2020
<em class="parameter"><code><span class="type">int</span> n_components</code></em>,
2021
<em class="parameter"><code><span class="type">int</span> count</code></em>,
2022
<em class="parameter"><code>const <span class="type">float</span> *value</code></em>);</pre>
2023
<p>
2024
Sets new values for the uniform at <em class="parameter"><code>uniform_location</code></em>. If this
2025
pipeline has a user program attached and is later used as a source
2026
for drawing, the given values will be assigned to the uniform which
2027
can be accessed from the shader's source. The value for
2028
<em class="parameter"><code>uniform_location</code></em> should be retrieved from the string name of the
2029
uniform by calling <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-uniform-location" title="cogl_pipeline_get_uniform_location ()"><code class="function">cogl_pipeline_get_uniform_location()</code></a>.
2030
</p>
2031
<p>
2032
This function can be used to set any floating point type uniform,
2033
including float arrays and float vectors. For example, to set a
2034
single vec4 uniform you would use 4 for <em class="parameter"><code>n_components</code></em> and 1 for
2035
<em class="parameter"><code>count</code></em>. To set an array of 8 float values, you could use 1 for
2036
<em class="parameter"><code>n_components</code></em> and 8 for <em class="parameter"><code>count</code></em>.
2037
</p>
2038
<div class="variablelist"><table border="0">
2039
<col align="left" valign="top">
2040
<tbody>
2041
<tr>
2042
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
2043
<td>A <span class="type">CoglPipeline</span> object</td>
2044
</tr>
2045
<tr>
2046
<td><p><span class="term"><em class="parameter"><code>uniform_location</code></em> :</span></p></td>
2047
<td>The uniform's location identifier</td>
2048
</tr>
2049
<tr>
2050
<td><p><span class="term"><em class="parameter"><code>n_components</code></em> :</span></p></td>
2051
<td>The number of components in the corresponding uniform's type</td>
2052
</tr>
2053
<tr>
2054
<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
2055
<td>The number of values to set</td>
2056
</tr>
2057
<tr>
2058
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2059
<td>Pointer to the new values to set</td>
2060
</tr>
2061
</tbody>
2062
</table></div>
2063
<p class="since">Since 2.0</p>
2064
<p class="stability">Stability Level: Unstable</p>
2065
</div>
2066
<hr>
2067
<div class="refsect2">
2068
<a name="cogl-pipeline-set-uniform-int"></a><h3>cogl_pipeline_set_uniform_int ()</h3>
2069
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_uniform_int (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
2070
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
2071
<em class="parameter"><code><span class="type">int</span> n_components</code></em>,
2072
<em class="parameter"><code><span class="type">int</span> count</code></em>,
2073
<em class="parameter"><code>const <span class="type">int</span> *value</code></em>);</pre>
2074
<p>
2075
Sets new values for the uniform at <em class="parameter"><code>uniform_location</code></em>. If this
2076
pipeline has a user program attached and is later used as a source
2077
for drawing, the given values will be assigned to the uniform which
2078
can be accessed from the shader's source. The value for
2079
<em class="parameter"><code>uniform_location</code></em> should be retrieved from the string name of the
2080
uniform by calling <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-uniform-location" title="cogl_pipeline_get_uniform_location ()"><code class="function">cogl_pipeline_get_uniform_location()</code></a>.
2081
</p>
2082
<p>
2083
This function can be used to set any integer type uniform,
2084
including int arrays and int vectors. For example, to set a single
2085
ivec4 uniform you would use 4 for <em class="parameter"><code>n_components</code></em> and 1 for
2086
<em class="parameter"><code>count</code></em>. To set an array of 8 int values, you could use 1 for
2087
<em class="parameter"><code>n_components</code></em> and 8 for <em class="parameter"><code>count</code></em>.
2088
</p>
2089
<div class="variablelist"><table border="0">
2090
<col align="left" valign="top">
2091
<tbody>
2092
<tr>
2093
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
2094
<td>A <span class="type">CoglPipeline</span> object</td>
2095
</tr>
2096
<tr>
2097
<td><p><span class="term"><em class="parameter"><code>uniform_location</code></em> :</span></p></td>
2098
<td>The uniform's location identifier</td>
2099
</tr>
2100
<tr>
2101
<td><p><span class="term"><em class="parameter"><code>n_components</code></em> :</span></p></td>
2102
<td>The number of components in the corresponding uniform's type</td>
2103
</tr>
2104
<tr>
2105
<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
2106
<td>The number of values to set</td>
2107
</tr>
2108
<tr>
2109
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2110
<td>Pointer to the new values to set</td>
2111
</tr>
2112
</tbody>
2113
</table></div>
2114
<p class="since">Since 2.0</p>
2115
<p class="stability">Stability Level: Unstable</p>
2116
</div>
2117
<hr>
2118
<div class="refsect2">
2119
<a name="cogl-pipeline-set-uniform-matrix"></a><h3>cogl_pipeline_set_uniform_matrix ()</h3>
2120
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_set_uniform_matrix (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
2121
<em class="parameter"><code><span class="type">int</span> uniform_location</code></em>,
2122
<em class="parameter"><code><span class="type">int</span> dimensions</code></em>,
2123
<em class="parameter"><code><span class="type">int</span> count</code></em>,
2124
<em class="parameter"><code><span class="type">gboolean</span> transpose</code></em>,
2125
<em class="parameter"><code>const <span class="type">float</span> *value</code></em>);</pre>
2126
<p>
2127
Sets new values for the uniform at <em class="parameter"><code>uniform_location</code></em>. If this
2128
pipeline has a user program attached and is later used as a source
2129
for drawing, the given values will be assigned to the uniform which
2130
can be accessed from the shader's source. The value for
2131
<em class="parameter"><code>uniform_location</code></em> should be retrieved from the string name of the
2132
uniform by calling <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-get-uniform-location" title="cogl_pipeline_get_uniform_location ()"><code class="function">cogl_pipeline_get_uniform_location()</code></a>.
2133
</p>
2134
<p>
2135
This function can be used to set any matrix type uniform, including
2136
matrix arrays. For example, to set a single mat4 uniform you would
2137
use 4 for <em class="parameter"><code>dimensions</code></em> and 1 for <em class="parameter"><code>count</code></em>. To set an array of 8
2138
mat3 values, you could use 3 for <em class="parameter"><code>dimensions</code></em> and 8 for <em class="parameter"><code>count</code></em>.
2139
</p>
2140
<p>
2141
If <em class="parameter"><code>transpose</code></em> is <code class="literal">FALSE</code> then the matrix is expected to be in
2142
column-major order or if it is <code class="literal">TRUE</code> then the matrix is in
2143
row-major order. You can pass a <a class="link" href="cogl-2.0-experimental-Matrices.html#CoglMatrix" title="CoglMatrix"><span class="type">CoglMatrix</span></a> by calling by passing
2144
the result of <a class="link" href="cogl-2.0-experimental-Matrices.html#cogl-matrix-get-array" title="cogl_matrix_get_array ()"><code class="function">cogl_matrix_get_array()</code></a> in <em class="parameter"><code>value</code></em> and setting
2145
<em class="parameter"><code>transpose</code></em> to <code class="literal">FALSE</code>.
2146
</p>
2147
<div class="variablelist"><table border="0">
2148
<col align="left" valign="top">
2149
<tbody>
2150
<tr>
2151
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
2152
<td>A <span class="type">CoglPipeline</span> object</td>
2153
</tr>
2154
<tr>
2155
<td><p><span class="term"><em class="parameter"><code>uniform_location</code></em> :</span></p></td>
2156
<td>The uniform's location identifier</td>
2157
</tr>
2158
<tr>
2159
<td><p><span class="term"><em class="parameter"><code>dimensions</code></em> :</span></p></td>
2160
<td>The size of the matrix</td>
2161
</tr>
2162
<tr>
2163
<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
2164
<td>The number of values to set</td>
2165
</tr>
2166
<tr>
2167
<td><p><span class="term"><em class="parameter"><code>transpose</code></em> :</span></p></td>
2168
<td>Whether to transpose the matrix</td>
2169
</tr>
2170
<tr>
2171
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2172
<td>Pointer to the new values to set</td>
2173
</tr>
2174
</tbody>
2175
</table></div>
2176
<p class="since">Since 2.0</p>
2177
<p class="stability">Stability Level: Unstable</p>
2178
</div>
2179
<hr>
2180
<div class="refsect2">
2181
<a name="cogl-pipeline-add-snippet"></a><h3>cogl_pipeline_add_snippet ()</h3>
2182
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_add_snippet (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
2183
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Shader-snippets.html#CoglSnippet" title="CoglSnippet"><span class="type">CoglSnippet</span></a> *snippet</code></em>);</pre>
2184
<p>
2185
Adds a shader snippet to <em class="parameter"><code>pipeline</code></em>. The snippet will wrap around or
2186
replace some part of the pipeline as defined by the hook point in
2187
<em class="parameter"><code>snippet</code></em>. Note that some hook points are specific to a layer and
2188
must be added with <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-add-layer-snippet" title="cogl_pipeline_add_layer_snippet ()"><code class="function">cogl_pipeline_add_layer_snippet()</code></a> instead.
2189
</p>
2190
<div class="variablelist"><table border="0">
2191
<col align="left" valign="top">
2192
<tbody>
2193
<tr>
2194
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
2195
<td>A <span class="type">CoglPipeline</span>
2196
</td>
2197
</tr>
2198
<tr>
2199
<td><p><span class="term"><em class="parameter"><code>snippet</code></em> :</span></p></td>
2200
<td>The <a class="link" href="cogl-2.0-experimental-Shader-snippets.html#CoglSnippet" title="CoglSnippet"><span class="type">CoglSnippet</span></a> to add to the vertex processing hook</td>
2201
</tr>
2202
</tbody>
2203
</table></div>
2204
<p class="since">Since 1.10</p>
2205
<p class="stability">Stability Level: Unstable</p>
2206
</div>
2207
<hr>
2208
<div class="refsect2">
2209
<a name="cogl-pipeline-add-layer-snippet"></a><h3>cogl_pipeline_add_layer_snippet ()</h3>
2210
<pre class="programlisting"><span class="returnvalue">void</span> cogl_pipeline_add_layer_snippet (<em class="parameter"><code><span class="type">CoglPipeline</span> *pipeline</code></em>,
2211
<em class="parameter"><code><span class="type">int</span> layer</code></em>,
2212
<em class="parameter"><code><a class="link" href="cogl-2.0-experimental-Shader-snippets.html#CoglSnippet" title="CoglSnippet"><span class="type">CoglSnippet</span></a> *snippet</code></em>);</pre>
2213
<p>
2214
Adds a shader snippet that will hook on to the given layer of the
2215
pipeline. The exact part of the pipeline that the snippet wraps
2216
around depends on the hook that is given to
2217
<a class="link" href="cogl-2.0-experimental-Shader-snippets.html#cogl-snippet-new" title="cogl_snippet_new ()"><code class="function">cogl_snippet_new()</code></a>. Note that some hooks can't be used with a layer
2218
and need to be added with <a class="link" href="cogl-2.0-experimental-Pipeline.html#cogl-pipeline-add-snippet" title="cogl_pipeline_add_snippet ()"><code class="function">cogl_pipeline_add_snippet()</code></a> instead.
2219
</p>
2220
<div class="variablelist"><table border="0">
2221
<col align="left" valign="top">
2222
<tbody>
2223
<tr>
2224
<td><p><span class="term"><em class="parameter"><code>pipeline</code></em> :</span></p></td>
2225
<td>A <span class="type">CoglPipeline</span>
2226
</td>
2227
</tr>
2228
<tr>
2229
<td><p><span class="term"><em class="parameter"><code>layer</code></em> :</span></p></td>
2230
<td>The layer to hook the snippet to</td>
2231
</tr>
2232
<tr>
2233
<td><p><span class="term"><em class="parameter"><code>snippet</code></em> :</span></p></td>
2234
<td>A <a class="link" href="cogl-2.0-experimental-Shader-snippets.html#CoglSnippet" title="CoglSnippet"><span class="type">CoglSnippet</span></a>
2235
</td>
2236
</tr>
2237
</tbody>
2238
</table></div>
2239
<p class="since">Since 1.10</p>
2240
<p class="stability">Stability Level: Unstable</p>
2241
</div>
1475
2242
</div>
1476
2243
</div>
1477
2244
<div class="footer">
1478
2245
<hr>
1479
Generated by GTK-Doc V1.16.1</div>
2246
Generated by GTK-Doc V1.17.1</div>
1480
2247
</body>
1481
2248
</html>
b'\\ No newline at end of file'
Loggerhead is a web-based interface for Breezy
Version: 2.0.1