@girs/cogl-11 4.3.0 → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +36 -41
  2. package/cogl-11.d.ts +376 -161
  3. package/package.json +7 -7
package/cogl-11.d.ts CHANGED
@@ -33,25 +33,25 @@ export namespace Cogl {
33
33
  /**
34
34
  * Data is the same size of a byte
35
35
  */
36
- BYTE,
36
+ BYTE = 5120,
37
37
  /**
38
38
  * Data is the same size of an
39
39
  * unsigned byte
40
40
  */
41
- UNSIGNED_BYTE,
41
+ UNSIGNED_BYTE = 5121,
42
42
  /**
43
43
  * Data is the same size of a short integer
44
44
  */
45
- SHORT,
45
+ SHORT = 5122,
46
46
  /**
47
47
  * Data is the same size of
48
48
  * an unsigned short integer
49
49
  */
50
- UNSIGNED_SHORT,
50
+ UNSIGNED_SHORT = 5123,
51
51
  /**
52
52
  * Data is the same size of a float
53
53
  */
54
- FLOAT,
54
+ FLOAT = 5126,
55
55
  }
56
56
 
57
57
 
@@ -69,15 +69,15 @@ export namespace Cogl {
69
69
  * Generic failure code, something went
70
70
  * wrong.
71
71
  */
72
- FAILED,
72
+ FAILED = 0,
73
73
  /**
74
74
  * Unknown image type.
75
75
  */
76
- UNKNOWN_TYPE,
76
+ UNKNOWN_TYPE = 1,
77
77
  /**
78
78
  * An image file was broken somehow.
79
79
  */
80
- CORRUPT_IMAGE,
80
+ CORRUPT_IMAGE = 2,
81
81
  }
82
82
 
83
83
 
@@ -90,20 +90,20 @@ export namespace Cogl {
90
90
  /**
91
91
  * Generic parse error
92
92
  */
93
- PARSE_ERROR,
93
+ PARSE_ERROR = 0,
94
94
  /**
95
95
  * Argument parse error
96
96
  */
97
- ARGUMENT_PARSE_ERROR,
97
+ ARGUMENT_PARSE_ERROR = 1,
98
98
  /**
99
99
  * Internal parser error
100
100
  */
101
- INVALID_ERROR,
101
+ INVALID_ERROR = 2,
102
102
  /**
103
103
  * Blend string not
104
104
  * supported by the GPU
105
105
  */
106
- GPU_UNSUPPORTED_ERROR,
106
+ GPU_UNSUPPORTED_ERROR = 3,
107
107
  }
108
108
 
109
109
 
@@ -121,41 +121,41 @@ export namespace Cogl {
121
121
  /**
122
122
  * Never passes.
123
123
  */
124
- NEVER,
124
+ NEVER = 512,
125
125
  /**
126
126
  * Passes if the fragment's depth
127
127
  * value is less than the value currently in the depth buffer.
128
128
  */
129
- LESS,
129
+ LESS = 513,
130
130
  /**
131
131
  * Passes if the fragment's depth
132
132
  * value is equal to the value currently in the depth buffer.
133
133
  */
134
- EQUAL,
134
+ EQUAL = 514,
135
135
  /**
136
136
  * Passes if the fragment's depth
137
137
  * value is less or equal to the value currently in the depth buffer.
138
138
  */
139
- LEQUAL,
139
+ LEQUAL = 515,
140
140
  /**
141
141
  * Passes if the fragment's depth
142
142
  * value is greater than the value currently in the depth buffer.
143
143
  */
144
- GREATER,
144
+ GREATER = 516,
145
145
  /**
146
146
  * Passes if the fragment's depth
147
147
  * value is not equal to the value currently in the depth buffer.
148
148
  */
149
- NOTEQUAL,
149
+ NOTEQUAL = 517,
150
150
  /**
151
151
  * Passes if the fragment's depth
152
152
  * value greater than or equal to the value currently in the depth buffer.
153
153
  */
154
- GEQUAL,
154
+ GEQUAL = 518,
155
155
  /**
156
156
  * Always passes.
157
157
  */
158
- ALWAYS,
158
+ ALWAYS = 519,
159
159
  }
160
160
 
161
161
 
@@ -172,37 +172,37 @@ export namespace Cogl {
172
172
  * {@link Cogl.IndicesType.INT} is supported in
173
173
  * `cogl_indices_new()`.
174
174
  */
175
- OGL_FEATURE_ID_UNSIGNED_INT_INDICES,
175
+ OGL_FEATURE_ID_UNSIGNED_INT_INDICES = 0,
176
176
  /**
177
177
  * Whether `cogl_buffer_map()` is
178
178
  * supported with CoglBufferAccess including read support.
179
179
  */
180
- OGL_FEATURE_ID_MAP_BUFFER_FOR_READ,
180
+ OGL_FEATURE_ID_MAP_BUFFER_FOR_READ = 1,
181
181
  /**
182
182
  * Whether `cogl_buffer_map()` is
183
183
  * supported with CoglBufferAccess including write support.
184
184
  */
185
- OGL_FEATURE_ID_MAP_BUFFER_FOR_WRITE,
186
- OGL_FEATURE_ID_FENCE,
185
+ OGL_FEATURE_ID_MAP_BUFFER_FOR_WRITE = 2,
186
+ OGL_FEATURE_ID_FENCE = 3,
187
187
  /**
188
188
  * Support for
189
189
  * {@link Cogl.TextureComponents.RG} as the internal components of a
190
190
  * texture.
191
191
  */
192
- OGL_FEATURE_ID_TEXTURE_RG,
192
+ OGL_FEATURE_ID_TEXTURE_RG = 4,
193
193
  /**
194
194
  * Available if the age of {@link Cogl.Onscreen} back
195
195
  * buffers are tracked and so `cogl_onscreen_get_buffer_age()` can be
196
196
  * expected to return age values other than 0.
197
197
  */
198
- OGL_FEATURE_ID_BUFFER_AGE,
199
- OGL_FEATURE_ID_TEXTURE_EGL_IMAGE_EXTERNAL,
198
+ OGL_FEATURE_ID_BUFFER_AGE = 5,
199
+ OGL_FEATURE_ID_TEXTURE_EGL_IMAGE_EXTERNAL = 6,
200
200
  /**
201
201
  * Whether blitting using
202
202
  * `cogl_blit_framebuffer()` is supported.
203
203
  */
204
- OGL_FEATURE_ID_BLIT_FRAMEBUFFER,
205
- OGL_FEATURE_ID_TIMESTAMP_QUERY,
204
+ OGL_FEATURE_ID_BLIT_FRAMEBUFFER = 7,
205
+ OGL_FEATURE_ID_TIMESTAMP_QUERY = 8,
206
206
  }
207
207
 
208
208
 
@@ -215,11 +215,11 @@ export namespace Cogl {
215
215
  * The event was not handled, continues the
216
216
  * processing
217
217
  */
218
- CONTINUE,
218
+ CONTINUE = 0,
219
219
  /**
220
220
  * Remove the event, stops the processing
221
221
  */
222
- REMOVE,
222
+ REMOVE = 1,
223
223
  }
224
224
 
225
225
 
@@ -247,7 +247,7 @@ export namespace Cogl {
247
247
  * acknowledged a frame and is ready for a
248
248
  * new frame to be created.
249
249
  */
250
- SYNC,
250
+ SYNC = 1,
251
251
  /**
252
252
  * Notifies that a frame has ended. This
253
253
  * is a good time for applications to
@@ -257,7 +257,7 @@ export namespace Cogl {
257
257
  * events should be expected after a
258
258
  * `COGL_FRAME_EVENT_COMPLETE` event.
259
259
  */
260
- COMPLETE,
260
+ COMPLETE = 2,
261
261
  }
262
262
 
263
263
 
@@ -265,7 +265,7 @@ export namespace Cogl {
265
265
  * @gir-type Enum
266
266
  */
267
267
  enum FramebufferError {
268
- FRAMEBUFFER_ERROR_ALLOCATE,
268
+ FRAMEBUFFER_ERROR_ALLOCATE = 0,
269
269
  }
270
270
 
271
271
 
@@ -277,11 +277,11 @@ export namespace Cogl {
277
277
  * @gir-type Enum
278
278
  */
279
279
  enum GraphicsResetStatus {
280
- NO_ERROR,
281
- GUILTY_CONTEXT_RESET,
282
- INNOCENT_CONTEXT_RESET,
283
- UNKNOWN_CONTEXT_RESET,
284
- PURGED_CONTEXT_RESET,
280
+ NO_ERROR = 0,
281
+ GUILTY_CONTEXT_RESET = 1,
282
+ INNOCENT_CONTEXT_RESET = 2,
283
+ UNKNOWN_CONTEXT_RESET = 3,
284
+ PURGED_CONTEXT_RESET = 4,
285
285
  }
286
286
 
287
287
 
@@ -301,15 +301,15 @@ export namespace Cogl {
301
301
  /**
302
302
  * Your indices are unsigned bytes
303
303
  */
304
- BYTE,
304
+ BYTE = 0,
305
305
  /**
306
306
  * Your indices are unsigned shorts
307
307
  */
308
- SHORT,
308
+ SHORT = 1,
309
309
  /**
310
310
  * Your indices are unsigned ints
311
311
  */
312
- INT,
312
+ INT = 2,
313
313
  }
314
314
 
315
315
 
@@ -324,41 +324,41 @@ export namespace Cogl {
324
324
  /**
325
325
  * Never let the fragment through.
326
326
  */
327
- NEVER,
327
+ NEVER = 512,
328
328
  /**
329
329
  * Let the fragment through if the incoming
330
330
  * alpha value is less than the reference alpha value
331
331
  */
332
- LESS,
332
+ LESS = 513,
333
333
  /**
334
334
  * Let the fragment through if the incoming
335
335
  * alpha value equals the reference alpha value
336
336
  */
337
- EQUAL,
337
+ EQUAL = 514,
338
338
  /**
339
339
  * Let the fragment through if the incoming
340
340
  * alpha value is less than or equal to the reference alpha value
341
341
  */
342
- LEQUAL,
342
+ LEQUAL = 515,
343
343
  /**
344
344
  * Let the fragment through if the incoming
345
345
  * alpha value is greater than the reference alpha value
346
346
  */
347
- GREATER,
347
+ GREATER = 516,
348
348
  /**
349
349
  * Let the fragment through if the incoming
350
350
  * alpha value does not equal the reference alpha value
351
351
  */
352
- NOTEQUAL,
352
+ NOTEQUAL = 517,
353
353
  /**
354
354
  * Let the fragment through if the incoming
355
355
  * alpha value is greater than or equal to the reference alpha value.
356
356
  */
357
- GEQUAL,
357
+ GEQUAL = 518,
358
358
  /**
359
359
  * Always let the fragment through.
360
360
  */
361
- ALWAYS,
361
+ ALWAYS = 519,
362
362
  }
363
363
 
364
364
 
@@ -372,19 +372,19 @@ export namespace Cogl {
372
372
  * Neither face will be
373
373
  * culled. This is the default.
374
374
  */
375
- NONE,
375
+ NONE = 0,
376
376
  /**
377
377
  * Front faces will be culled.
378
378
  */
379
- FRONT,
379
+ FRONT = 1,
380
380
  /**
381
381
  * Back faces will be culled.
382
382
  */
383
- BACK,
383
+ BACK = 2,
384
384
  /**
385
385
  * All faces will be culled.
386
386
  */
387
- BOTH,
387
+ BOTH = 3,
388
388
  }
389
389
 
390
390
 
@@ -401,38 +401,38 @@ export namespace Cogl {
401
401
  * Measuring in manhatten distance from the,
402
402
  * current pixel center, use the nearest texture texel
403
403
  */
404
- NEAREST,
404
+ NEAREST = 9728,
405
405
  /**
406
406
  * Use the weighted average of the 4 texels
407
407
  * nearest the current pixel center
408
408
  */
409
- LINEAR,
409
+ LINEAR = 9729,
410
410
  /**
411
411
  * Select the mimap level whose
412
412
  * texel size most closely matches the current pixel, and use the
413
413
  * {@link Cogl.PipelineFilter.NEAREST} criterion
414
414
  */
415
- NEAREST_MIPMAP_NEAREST,
415
+ NEAREST_MIPMAP_NEAREST = 9984,
416
416
  /**
417
417
  * Select the mimap level whose
418
418
  * texel size most closely matches the current pixel, and use the
419
419
  * {@link Cogl.PipelineFilter.LINEAR} criterion
420
420
  */
421
- LINEAR_MIPMAP_NEAREST,
421
+ LINEAR_MIPMAP_NEAREST = 9985,
422
422
  /**
423
423
  * Select the two mimap levels
424
424
  * whose texel size most closely matches the current pixel, use
425
425
  * the {@link Cogl.PipelineFilter.NEAREST} criterion on each one and take
426
426
  * their weighted average
427
427
  */
428
- NEAREST_MIPMAP_LINEAR,
428
+ NEAREST_MIPMAP_LINEAR = 9986,
429
429
  /**
430
430
  * Select the two mimap levels
431
431
  * whose texel size most closely matches the current pixel, use
432
432
  * the {@link Cogl.PipelineFilter.LINEAR} criterion on each one and take
433
433
  * their weighted average
434
434
  */
435
- LINEAR_MIPMAP_LINEAR,
435
+ LINEAR_MIPMAP_LINEAR = 9987,
436
436
  }
437
437
 
438
438
 
@@ -453,15 +453,15 @@ export namespace Cogl {
453
453
  * The texture will be repeated. This
454
454
  * is useful for example to draw a tiled background.
455
455
  */
456
- REPEAT,
457
- MIRRORED_REPEAT,
456
+ REPEAT = 10497,
457
+ MIRRORED_REPEAT = 33648,
458
458
  /**
459
459
  * The coordinates outside the
460
460
  * range 0→1 will sample copies of the edge pixels of the
461
461
  * texture. This is useful to avoid artifacts if only one copy of
462
462
  * the texture is being rendered.
463
463
  */
464
- CLAMP_TO_EDGE,
464
+ CLAMP_TO_EDGE = 33071,
465
465
  /**
466
466
  * Cogl will try to automatically
467
467
  * decide which of the above two to use. For `cogl_rectangle()`, it
@@ -472,7 +472,7 @@ export namespace Cogl {
472
472
  * layers that have point sprite coordinate generation enabled. This
473
473
  * is the default value.
474
474
  */
475
- AUTOMATIC,
475
+ AUTOMATIC = 519,
476
476
  }
477
477
 
478
478
 
@@ -480,8 +480,8 @@ export namespace Cogl {
480
480
  * @gir-type Enum
481
481
  */
482
482
  enum RendererError {
483
- XLIB_DISPLAY_OPEN,
484
- BAD_CONSTRAINT,
483
+ XLIB_DISPLAY_OPEN = 0,
484
+ BAD_CONSTRAINT = 1,
485
485
  }
486
486
 
487
487
 
@@ -508,11 +508,11 @@ export namespace Cogl {
508
508
  /**
509
509
  * A program for processing vertices
510
510
  */
511
- VERTEX,
511
+ VERTEX = 0,
512
512
  /**
513
513
  * A program for processing fragments
514
514
  */
515
- FRAGMENT,
515
+ FRAGMENT = 1,
516
516
  }
517
517
 
518
518
 
@@ -802,50 +802,50 @@ export namespace Cogl {
802
802
  * A hook for the entire vertex processing
803
803
  * stage of the pipeline.
804
804
  */
805
- VERTEX,
805
+ VERTEX = 0,
806
806
  /**
807
807
  * A hook for the vertex transformation.
808
808
  */
809
- VERTEX_TRANSFORM,
809
+ VERTEX_TRANSFORM = 1,
810
810
  /**
811
811
  * A hook for declaring global data
812
812
  * that can be shared with all other snippets that are on a vertex
813
813
  * hook.
814
814
  */
815
- VERTEX_GLOBALS,
815
+ VERTEX_GLOBALS = 2,
816
816
  /**
817
817
  * A hook for manipulating the point
818
818
  * size of a vertex. This is only used if
819
819
  * `cogl_pipeline_set_per_vertex_point_size()` is enabled on the
820
820
  * pipeline.
821
821
  */
822
- POINT_SIZE,
822
+ POINT_SIZE = 3,
823
823
  /**
824
824
  * A hook for the entire fragment
825
825
  * processing stage of the pipeline.
826
826
  */
827
- FRAGMENT,
827
+ FRAGMENT = 2048,
828
828
  /**
829
829
  * A hook for declaring global
830
830
  * data wthat can be shared with all other snippets that are on a
831
831
  * fragment hook.
832
832
  */
833
- FRAGMENT_GLOBALS,
833
+ FRAGMENT_GLOBALS = 2049,
834
834
  /**
835
835
  * A hook for applying the
836
836
  * layer matrix to a texture coordinate for a layer.
837
837
  */
838
- TEXTURE_COORD_TRANSFORM,
838
+ TEXTURE_COORD_TRANSFORM = 4096,
839
839
  /**
840
840
  * A hook for the fragment
841
841
  * processing of a particular layer.
842
842
  */
843
- LAYER_FRAGMENT,
843
+ LAYER_FRAGMENT = 6144,
844
844
  /**
845
845
  * A hook for the texture lookup
846
846
  * stage of a given layer in a pipeline.
847
847
  */
848
- TEXTURE_LOOKUP,
848
+ TEXTURE_LOOKUP = 6145,
849
849
  }
850
850
 
851
851
 
@@ -858,15 +858,15 @@ export namespace Cogl {
858
858
  /**
859
859
  * draw to both stereo buffers
860
860
  */
861
- BOTH,
861
+ BOTH = 0,
862
862
  /**
863
863
  * draw only to the left stereo buffer
864
864
  */
865
- LEFT,
865
+ LEFT = 1,
866
866
  /**
867
867
  * draw only to the left stereo buffer
868
868
  */
869
- RIGHT,
869
+ RIGHT = 2,
870
870
  }
871
871
 
872
872
 
@@ -896,12 +896,12 @@ export namespace Cogl {
896
896
  * You tried to use a feature or
897
897
  * configuration not currently available.
898
898
  */
899
- UNSUPPORTED,
899
+ UNSUPPORTED = 0,
900
900
  /**
901
901
  * You tried to allocate a resource
902
902
  * such as a texture and there wasn't enough memory.
903
903
  */
904
- NO_MEMORY,
904
+ NO_MEMORY = 1,
905
905
  }
906
906
 
907
907
 
@@ -914,25 +914,25 @@ export namespace Cogl {
914
914
  /**
915
915
  * Only the alpha component
916
916
  */
917
- A,
917
+ A = 1,
918
918
  /**
919
919
  * Red and green components. Note that
920
920
  * this can only be used if the {@link Cogl.FeatureID.OGL_FEATURE_ID_TEXTURE_RG} feature
921
921
  * is advertised.
922
922
  */
923
- RG,
923
+ RG = 2,
924
924
  /**
925
925
  * Red, green and blue components
926
926
  */
927
- RGB,
927
+ RGB = 3,
928
928
  /**
929
929
  * Red, green, blue and alpha components
930
930
  */
931
- RGBA,
931
+ RGBA = 4,
932
932
  /**
933
933
  * Only a depth component
934
934
  */
935
- DEPTH,
935
+ DEPTH = 5,
936
936
  }
937
937
 
938
938
 
@@ -945,17 +945,17 @@ export namespace Cogl {
945
945
  /**
946
946
  * Unsupported size
947
947
  */
948
- SIZE,
948
+ SIZE = 0,
949
949
  /**
950
950
  * Unsupported format
951
951
  */
952
- FORMAT,
953
- BAD_PARAMETER,
952
+ FORMAT = 1,
953
+ BAD_PARAMETER = 2,
954
954
  /**
955
955
  * A primitive texture type that is
956
956
  * unsupported by the driver was used
957
957
  */
958
- TYPE,
958
+ TYPE = 3,
959
959
  }
960
960
 
961
961
 
@@ -969,35 +969,35 @@ export namespace Cogl {
969
969
  * FIXME, equivalent to
970
970
  * <constant>GL_POINTS</constant>
971
971
  */
972
- POINTS,
972
+ POINTS = 0,
973
973
  /**
974
974
  * FIXME, equivalent to <constant>GL_LINES</constant>
975
975
  */
976
- LINES,
976
+ LINES = 1,
977
977
  /**
978
978
  * FIXME, equivalent to
979
979
  * <constant>GL_LINE_LOOP</constant>
980
980
  */
981
- LINE_LOOP,
981
+ LINE_LOOP = 2,
982
982
  /**
983
983
  * FIXME, equivalent to
984
984
  * <constant>GL_LINE_STRIP</constant>
985
985
  */
986
- LINE_STRIP,
986
+ LINE_STRIP = 3,
987
987
  /**
988
988
  * FIXME, equivalent to
989
989
  * <constant>GL_TRIANGLES</constant>
990
990
  */
991
- TRIANGLES,
991
+ TRIANGLES = 4,
992
992
  /**
993
993
  * FIXME, equivalent to
994
994
  * <constant>GL_TRIANGLE_STRIP</constant>
995
995
  */
996
- TRIANGLE_STRIP,
996
+ TRIANGLE_STRIP = 5,
997
997
  /**
998
998
  * FIXME, equivalent to <constant>GL_TRIANGLE_FAN</constant>
999
999
  */
1000
- TRIANGLE_FAN,
1000
+ TRIANGLE_FAN = 6,
1001
1001
  }
1002
1002
 
1003
1003
 
@@ -1011,11 +1011,11 @@ export namespace Cogl {
1011
1011
  /**
1012
1012
  * Vertices are in a clockwise order
1013
1013
  */
1014
- CLOCKWISE,
1014
+ CLOCKWISE = 0,
1015
1015
  /**
1016
1016
  * Vertices are in a counter-clockwise order
1017
1017
  */
1018
- COUNTER_CLOCKWISE,
1018
+ COUNTER_CLOCKWISE = 1,
1019
1019
  }
1020
1020
 
1021
1021
 
@@ -1023,37 +1023,59 @@ export namespace Cogl {
1023
1023
  * @gir-type Enum
1024
1024
  */
1025
1025
  enum WinsysFeature {
1026
- VBLANK_COUNTER,
1027
- VBLANK_WAIT,
1028
- TEXTURE_FROM_PIXMAP,
1029
- SWAP_BUFFERS_EVENT,
1030
- SWAP_REGION,
1031
- SWAP_REGION_THROTTLE,
1032
- SWAP_REGION_SYNCHRONIZED,
1033
- BUFFER_AGE,
1034
- SYNC_AND_COMPLETE_EVENT,
1035
- N_FEATURES,
1026
+ VBLANK_COUNTER = 0,
1027
+ VBLANK_WAIT = 1,
1028
+ TEXTURE_FROM_PIXMAP = 2,
1029
+ SWAP_BUFFERS_EVENT = 3,
1030
+ SWAP_REGION = 4,
1031
+ SWAP_REGION_THROTTLE = 5,
1032
+ SWAP_REGION_SYNCHRONIZED = 6,
1033
+ BUFFER_AGE = 7,
1034
+ SYNC_AND_COMPLETE_EVENT = 8,
1035
+ N_FEATURES = 9,
1036
1036
  }
1037
1037
 
1038
1038
 
1039
+ /**
1040
+ * @default 64
1041
+ */
1039
1042
  const AFIRST_BIT: number;
1040
1043
 
1044
+ /**
1045
+ * @default 16
1046
+ */
1041
1047
  const A_BIT: number;
1042
1048
 
1049
+ /**
1050
+ * @default 32
1051
+ */
1043
1052
  const BGR_BIT: number;
1044
1053
 
1054
+ /**
1055
+ * @default 256
1056
+ */
1045
1057
  const DEPTH_BIT: number;
1046
1058
 
1047
1059
  /**
1048
1060
  * The maximum number of planes of a pixel format (see also
1049
1061
  * `cogl_pixel_format_get_planes()`).
1062
+ * @default 4
1050
1063
  */
1051
1064
  const PIXEL_FORMAT_MAX_PLANES: number;
1052
1065
 
1066
+ /**
1067
+ * @default 128
1068
+ */
1053
1069
  const PREMULT_BIT: number;
1054
1070
 
1071
+ /**
1072
+ * @default 512
1073
+ */
1055
1074
  const STENCIL_BIT: number;
1056
1075
 
1076
+ /**
1077
+ * @default 127
1078
+ */
1057
1079
  const TEXTURE_MAX_WASTE: number;
1058
1080
 
1059
1081
  function blend_string_error_quark(): number;
@@ -1106,6 +1128,7 @@ export namespace Cogl {
1106
1128
  * @param dst_y Destination y position
1107
1129
  * @param width Width of region to copy
1108
1130
  * @param height Height of region to copy
1131
+ * @throws GLib.Error
1109
1132
  */
1110
1133
  function blit_framebuffer(framebuffer: Framebuffer, dst: Framebuffer, src_x: number, src_y: number, dst_x: number, dst_y: number, width: number, height: number): boolean;
1111
1134
 
@@ -1543,15 +1566,15 @@ export namespace Cogl {
1543
1566
  /**
1544
1567
  * Selects the primary color buffer
1545
1568
  */
1546
- COLOR,
1569
+ COLOR = 1,
1547
1570
  /**
1548
1571
  * Selects the depth buffer
1549
1572
  */
1550
- DEPTH,
1573
+ DEPTH = 2,
1551
1574
  /**
1552
1575
  * Selects the stencil buffer
1553
1576
  */
1554
- STENCIL,
1577
+ STENCIL = 4,
1555
1578
  }
1556
1579
 
1557
1580
 
@@ -1564,11 +1587,11 @@ export namespace Cogl {
1564
1587
  /**
1565
1588
  * FIXME
1566
1589
  */
1567
- WINDOW_BUFFER,
1590
+ WINDOW_BUFFER = 2,
1568
1591
  /**
1569
1592
  * FIXME
1570
1593
  */
1571
- OFFSCREEN_BUFFER,
1594
+ OFFSCREEN_BUFFER = 4,
1572
1595
  }
1573
1596
 
1574
1597
 
@@ -1576,8 +1599,8 @@ export namespace Cogl {
1576
1599
  * @gir-type Flags
1577
1600
  */
1578
1601
  enum EglImageFlags {
1579
- NONE,
1580
- NO_GET_DATA,
1602
+ NONE = 0,
1603
+ NO_GET_DATA = 1,
1581
1604
  }
1582
1605
 
1583
1606
 
@@ -1607,156 +1630,156 @@ export namespace Cogl {
1607
1630
  /**
1608
1631
  * Any format
1609
1632
  */
1610
- ANY,
1633
+ ANY = 0,
1611
1634
  /**
1612
1635
  * 8 bits alpha mask
1613
1636
  */
1614
- A_8,
1637
+ A_8 = 17,
1615
1638
  /**
1616
1639
  * RGB, 16 bits
1617
1640
  */
1618
- RGB_565,
1641
+ RGB_565 = 4,
1619
1642
  /**
1620
1643
  * RGBA, 16 bits
1621
1644
  */
1622
- RGBA_4444,
1645
+ RGBA_4444 = 21,
1623
1646
  /**
1624
1647
  * RGBA, 16 bits
1625
1648
  */
1626
- RGBA_5551,
1649
+ RGBA_5551 = 22,
1627
1650
  /**
1628
1651
  * Not currently supported
1629
1652
  */
1630
- YUV,
1653
+ YUV = 7,
1631
1654
  /**
1632
1655
  * Single luminance component
1633
1656
  */
1634
- G_8,
1657
+ G_8 = 8,
1635
1658
  /**
1636
1659
  * RG, 16 bits. Note that red-green textures
1637
1660
  * are only available if {@link Cogl.FeatureID.OGL_FEATURE_ID_TEXTURE_RG} is advertised.
1638
1661
  * See `cogl_texture_set_components()` for details.
1639
1662
  */
1640
- RG_88,
1663
+ RG_88 = 9,
1641
1664
  /**
1642
1665
  * RGB, 24 bits
1643
1666
  */
1644
- RGB_888,
1667
+ RGB_888 = 2,
1645
1668
  /**
1646
1669
  * BGR, 24 bits
1647
1670
  */
1648
- BGR_888,
1671
+ BGR_888 = 34,
1649
1672
  /**
1650
1673
  * RGBA, 32 bits
1651
1674
  */
1652
- RGBA_8888,
1675
+ RGBA_8888 = 19,
1653
1676
  /**
1654
1677
  * BGRA, 32 bits
1655
1678
  */
1656
- BGRA_8888,
1679
+ BGRA_8888 = 51,
1657
1680
  /**
1658
1681
  * ARGB, 32 bits
1659
1682
  */
1660
- ARGB_8888,
1683
+ ARGB_8888 = 83,
1661
1684
  /**
1662
1685
  * ABGR, 32 bits
1663
1686
  */
1664
- ABGR_8888,
1687
+ ABGR_8888 = 115,
1665
1688
  /**
1666
1689
  * RGBA, 32 bits, 10 bpc
1667
1690
  */
1668
- RGBA_1010102,
1691
+ RGBA_1010102 = 29,
1669
1692
  /**
1670
1693
  * BGRA, 32 bits, 10 bpc
1671
1694
  */
1672
- BGRA_1010102,
1673
- XRGB_2101010,
1695
+ BGRA_1010102 = 61,
1696
+ XRGB_2101010 = 77,
1674
1697
  /**
1675
1698
  * ARGB, 32 bits, 10 bpc
1676
1699
  */
1677
- ARGB_2101010,
1678
- XBGR_2101010,
1700
+ ARGB_2101010 = 93,
1701
+ XBGR_2101010 = 109,
1679
1702
  /**
1680
1703
  * ABGR, 32 bits, 10 bpc
1681
1704
  */
1682
- ABGR_2101010,
1705
+ ABGR_2101010 = 125,
1683
1706
  /**
1684
1707
  * RGBA half floating point, 64 bit
1685
1708
  */
1686
- RGBA_FP_16161616,
1709
+ RGBA_FP_16161616 = 27,
1687
1710
  /**
1688
1711
  * BGRA half floating point, 64 bit
1689
1712
  */
1690
- BGRA_FP_16161616,
1691
- XRGB_FP_16161616,
1713
+ BGRA_FP_16161616 = 59,
1714
+ XRGB_FP_16161616 = 75,
1692
1715
  /**
1693
1716
  * ARGB half floating point, 64 bit
1694
1717
  */
1695
- ARGB_FP_16161616,
1696
- XBGR_FP_16161616,
1718
+ ARGB_FP_16161616 = 91,
1719
+ XBGR_FP_16161616 = 107,
1697
1720
  /**
1698
1721
  * ABGR half floating point, 64 bit
1699
1722
  */
1700
- ABGR_FP_16161616,
1723
+ ABGR_FP_16161616 = 123,
1701
1724
  /**
1702
1725
  * Premultiplied RGBA, 32 bits
1703
1726
  */
1704
- RGBA_8888_PRE,
1727
+ RGBA_8888_PRE = 147,
1705
1728
  /**
1706
1729
  * Premultiplied BGRA, 32 bits
1707
1730
  */
1708
- BGRA_8888_PRE,
1731
+ BGRA_8888_PRE = 179,
1709
1732
  /**
1710
1733
  * Premultiplied ARGB, 32 bits
1711
1734
  */
1712
- ARGB_8888_PRE,
1735
+ ARGB_8888_PRE = 211,
1713
1736
  /**
1714
1737
  * Premultiplied ABGR, 32 bits
1715
1738
  */
1716
- ABGR_8888_PRE,
1739
+ ABGR_8888_PRE = 243,
1717
1740
  /**
1718
1741
  * Premultiplied RGBA, 16 bits
1719
1742
  */
1720
- RGBA_4444_PRE,
1743
+ RGBA_4444_PRE = 149,
1721
1744
  /**
1722
1745
  * Premultiplied RGBA, 16 bits
1723
1746
  */
1724
- RGBA_5551_PRE,
1747
+ RGBA_5551_PRE = 150,
1725
1748
  /**
1726
1749
  * Premultiplied RGBA, 32 bits, 10 bpc
1727
1750
  */
1728
- RGBA_1010102_PRE,
1751
+ RGBA_1010102_PRE = 157,
1729
1752
  /**
1730
1753
  * Premultiplied BGRA, 32 bits, 10 bpc
1731
1754
  */
1732
- BGRA_1010102_PRE,
1755
+ BGRA_1010102_PRE = 189,
1733
1756
  /**
1734
1757
  * Premultiplied ARGB, 32 bits, 10 bpc
1735
1758
  */
1736
- ARGB_2101010_PRE,
1759
+ ARGB_2101010_PRE = 221,
1737
1760
  /**
1738
1761
  * Premultiplied ABGR, 32 bits, 10 bpc
1739
1762
  */
1740
- ABGR_2101010_PRE,
1763
+ ABGR_2101010_PRE = 253,
1741
1764
  /**
1742
1765
  * Premultiplied RGBA half floating point, 64 bit
1743
1766
  */
1744
- RGBA_FP_16161616_PRE,
1767
+ RGBA_FP_16161616_PRE = 155,
1745
1768
  /**
1746
1769
  * Premultiplied BGRA half floating point, 64 bit
1747
1770
  */
1748
- BGRA_FP_16161616_PRE,
1771
+ BGRA_FP_16161616_PRE = 187,
1749
1772
  /**
1750
1773
  * Premultiplied ARGB half floating point, 64 bit
1751
1774
  */
1752
- ARGB_FP_16161616_PRE,
1775
+ ARGB_FP_16161616_PRE = 219,
1753
1776
  /**
1754
1777
  * Premultiplied ABGR half floating point, 64 bit
1755
1778
  */
1756
- ABGR_FP_16161616_PRE,
1757
- DEPTH_16,
1758
- DEPTH_32,
1759
- DEPTH_24_STENCIL_8,
1779
+ ABGR_FP_16161616_PRE = 251,
1780
+ DEPTH_16 = 265,
1781
+ DEPTH_32 = 259,
1782
+ DEPTH_24_STENCIL_8 = 771,
1760
1783
  }
1761
1784
 
1762
1785
 
@@ -1769,7 +1792,7 @@ export namespace Cogl {
1769
1792
  /**
1770
1793
  * Read from the color buffer
1771
1794
  */
1772
- READ_PIXELS_COLOR_BUFFER,
1795
+ READ_PIXELS_COLOR_BUFFER = 1,
1773
1796
  }
1774
1797
 
1775
1798
 
@@ -1809,27 +1832,32 @@ export namespace Cogl {
1809
1832
  * Parses an image file enough to extract the width and height
1810
1833
  * of the bitmap.
1811
1834
  * @param filename the file to check
1835
+ * @since 1.0
1812
1836
  */
1813
1837
  static get_size_from_file(filename: string): [boolean, number, number];
1814
1838
 
1815
1839
  // Methods
1816
1840
  /**
1817
1841
  * @returns the {@link Cogl.PixelFormat} that the data for the bitmap is in.
1842
+ * @since 1.10
1818
1843
  */
1819
1844
  get_format(): PixelFormat;
1820
1845
 
1821
1846
  /**
1822
1847
  * @returns the height of the bitmap
1848
+ * @since 1.10
1823
1849
  */
1824
1850
  get_height(): number;
1825
1851
 
1826
1852
  /**
1827
1853
  * @returns the rowstride of the bitmap. This is the number of bytes between the address of start of one row to the address of the next row in the image.
1854
+ * @since 1.10
1828
1855
  */
1829
1856
  get_rowstride(): number;
1830
1857
 
1831
1858
  /**
1832
1859
  * @returns the width of the bitmap
1860
+ * @since 1.10
1833
1861
  */
1834
1862
  get_width(): number;
1835
1863
  }
@@ -1936,6 +1964,7 @@ export namespace Cogl {
1936
1964
  * Gets the frame counter for the {@link Cogl.Onscreen} that corresponds
1937
1965
  * to this frame.
1938
1966
  * @returns The frame counter value
1967
+ * @since 1.14
1939
1968
  */
1940
1969
  get_frame_counter(): number;
1941
1970
 
@@ -1951,6 +1980,7 @@ export namespace Cogl {
1951
1980
  * <note>Some buggy Mesa drivers up to 9.0.1 may
1952
1981
  * incorrectly report non-monotonic timestamps.</note>
1953
1982
  * @returns the presentation time for the frame
1983
+ * @since 1.14
1954
1984
  */
1955
1985
  get_presentation_time_us(): number;
1956
1986
 
@@ -1964,6 +1994,7 @@ export namespace Cogl {
1964
1994
  * more reliable than using `cogl_frame_info_get_output()` followed by
1965
1995
  * `cogl_output_get_refresh_rate()`.</note>
1966
1996
  * @returns the refresh rate in Hertz
1997
+ * @since 1.14
1967
1998
  */
1968
1999
  get_refresh_rate(): number;
1969
2000
 
@@ -2068,6 +2099,7 @@ export namespace Cogl {
2068
2099
  * used. The disadvantage of relying on automatic allocation is that the
2069
2100
  * program will abort with an error message if there is an error during
2070
2101
  * automatic allocation.</note>
2102
+ * @since 1.8
2071
2103
  * @virtual
2072
2104
  */
2073
2105
  vfunc_allocate(): boolean;
@@ -2090,6 +2122,8 @@ export namespace Cogl {
2090
2122
  * program will abort with an error message if there is an error during
2091
2123
  * automatic allocation.</note>
2092
2124
  * @returns `true` if there were no error allocating the framebuffer, else `false`.
2125
+ * @since 1.8
2126
+ * @throws GLib.Error
2093
2127
  */
2094
2128
  allocate(): boolean;
2095
2129
 
@@ -2098,6 +2132,7 @@ export namespace Cogl {
2098
2132
  * that includes the color buffer then the specified `color` is used.
2099
2133
  * @param buffers A mask of {@link Cogl.BufferBit}<!-- -->'s identifying which auxiliary buffers to clear
2100
2134
  * @param color The color to clear the color buffer too if specified in `buffers`.
2135
+ * @since 1.8
2101
2136
  */
2102
2137
  clear(buffers: bigint | number, color: Color): void;
2103
2138
 
@@ -2109,6 +2144,7 @@ export namespace Cogl {
2109
2144
  * @param green The green component of color to clear the color buffer too if specified in `buffers`.
2110
2145
  * @param blue The blue component of color to clear the color buffer too if specified in `buffers`.
2111
2146
  * @param alpha The alpha component of color to clear the color buffer too if specified in `buffers`.
2147
+ * @since 1.8
2112
2148
  */
2113
2149
  clear4f(buffers: bigint | number, red: number, green: number, blue: number, alpha: number): void;
2114
2150
 
@@ -2130,6 +2166,7 @@ export namespace Cogl {
2130
2166
  * framebuffer, and it's not meaningful to try and discard the color buffer of
2131
2167
  * a {@link Cogl.Offscreen} framebuffer since they are single-buffered.
2132
2168
  * @param buffers A {@link Cogl.BufferBit} mask of which ancillary buffers you want to discard.
2169
+ * @since 1.8
2133
2170
  */
2134
2171
  discard_buffers(buffers: bigint | number): void;
2135
2172
 
@@ -2179,6 +2216,7 @@ export namespace Cogl {
2179
2216
  * @param y_2 y coordinate lower right on screen.
2180
2217
  * @param tex_coords An array containing groups of 4 float values: [s_1, t_1, s_2, t_2] that are interpreted as two texture coordinates; one for the top left texel, and one for the bottom right texel. Each value should be between 0.0 and 1.0, where the coordinate (0.0, 0.0) represents the top left of the texture, and (1.0, 1.0) the bottom right.
2181
2218
  * @param tex_coords_len The length of the `tex_coords` array. (For one layer and one group of texture coordinates, this would be 4)
2219
+ * @since 1.10
2182
2220
  */
2183
2221
  draw_multitextured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, tex_coords: number[], tex_coords_len: number): void;
2184
2222
 
@@ -2199,6 +2237,7 @@ export namespace Cogl {
2199
2237
  * @param y_1 Y coordinate of the top-left corner
2200
2238
  * @param x_2 X coordinate of the bottom-right corner
2201
2239
  * @param y_2 Y coordinate of the bottom-right corner
2240
+ * @since 1.10
2202
2241
  */
2203
2242
  draw_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number): void;
2204
2243
 
@@ -2225,6 +2264,7 @@ export namespace Cogl {
2225
2264
  * @param pipeline A {@link Cogl.Pipeline} state object
2226
2265
  * @param coordinates an array of coordinates containing groups of 4 float values: [x_1, y_1, x_2, y_2] that are interpreted as two position coordinates; one for the top left of the rectangle (x1, y1), and one for the bottom right of the rectangle (x2, y2).
2227
2266
  * @param n_rectangles number of rectangles defined in `coordinates`.
2267
+ * @since 1.10
2228
2268
  */
2229
2269
  draw_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
2230
2270
 
@@ -2264,6 +2304,7 @@ export namespace Cogl {
2264
2304
  * @param t_1 T texture coordinate of the top-left coorner
2265
2305
  * @param s_2 S texture coordinate of the bottom-right coorner
2266
2306
  * @param t_2 T texture coordinate of the bottom-right coorner
2307
+ * @since 1.10
2267
2308
  */
2268
2309
  draw_textured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, s_1: number, t_1: number, s_2: number, t_2: number): void;
2269
2310
 
@@ -2305,6 +2346,7 @@ export namespace Cogl {
2305
2346
  * @param pipeline A {@link Cogl.Pipeline} state object
2306
2347
  * @param coordinates an array containing groups of 8 float values: [x_1, y_1, x_2, y_2, s_1, t_1, s_2, t_2] that have the same meaning as the arguments for `cogl_framebuffer_draw_textured_rectangle()`.
2307
2348
  * @param n_rectangles number of rectangles to `coordinates` to draw
2349
+ * @since 1.10
2308
2350
  */
2309
2351
  draw_textured_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
2310
2352
 
@@ -2318,6 +2360,7 @@ export namespace Cogl {
2318
2360
  * One example might be for benchmarking purposes to be sure timing
2319
2361
  * measurements reflect the time that the GPU is busy for not just the time it
2320
2362
  * takes to queue rendering commands.
2363
+ * @since 1.10
2321
2364
  */
2322
2365
  finish(): void;
2323
2366
 
@@ -2339,18 +2382,21 @@ export namespace Cogl {
2339
2382
  * @param top Y position of the top clipping plane where it intersects the near clipping plane
2340
2383
  * @param z_near The distance to the near clipping plane (Must be positive)
2341
2384
  * @param z_far The distance to the far clipping plane (Must be positive)
2385
+ * @since 1.10
2342
2386
  */
2343
2387
  frustum(left: number, right: number, bottom: number, top: number, z_near: number, z_far: number): void;
2344
2388
 
2345
2389
  /**
2346
2390
  * Retrieves the number of alpha bits of `framebuffer`
2347
2391
  * @returns the number of bits
2392
+ * @since 1.8
2348
2393
  */
2349
2394
  get_alpha_bits(): number;
2350
2395
 
2351
2396
  /**
2352
2397
  * Retrieves the number of blue bits of `framebuffer`
2353
2398
  * @returns the number of bits
2399
+ * @since 1.8
2354
2400
  */
2355
2401
  get_blue_bits(): number;
2356
2402
 
@@ -2359,12 +2405,14 @@ export namespace Cogl {
2359
2405
  * instantiated within. This is the {@link Cogl.Context} that was passed to
2360
2406
  * `cogl_onscreen_new()` for example.
2361
2407
  * @returns The {@link Cogl.Context} that the given `framebuffer` was instantiated within.
2408
+ * @since 1.8
2362
2409
  */
2363
2410
  get_context(): Context;
2364
2411
 
2365
2412
  /**
2366
2413
  * Retrieves the number of depth bits of `framebuffer`
2367
2414
  * @returns the number of bits
2415
+ * @since 2.0
2368
2416
  */
2369
2417
  get_depth_bits(): number;
2370
2418
 
@@ -2372,6 +2420,7 @@ export namespace Cogl {
2372
2420
  * Queries whether depth buffer writing is enabled for `framebuffer`. This
2373
2421
  * can be controlled via `cogl_framebuffer_set_depth_write_enabled()`.
2374
2422
  * @returns `true` if depth writing is enabled or `false` if not.
2423
+ * @since 1.18
2375
2424
  */
2376
2425
  get_depth_write_enabled(): boolean;
2377
2426
 
@@ -2383,18 +2432,21 @@ export namespace Cogl {
2383
2432
  * display pipeline does not support dithering. This value only represents
2384
2433
  * the user's request for dithering.</note>
2385
2434
  * @returns `true` if dithering has been requested or `false` if not.
2435
+ * @since 1.8
2386
2436
  */
2387
2437
  get_dither_enabled(): boolean;
2388
2438
 
2389
2439
  /**
2390
2440
  * Retrieves the number of green bits of `framebuffer`
2391
2441
  * @returns the number of bits
2442
+ * @since 1.8
2392
2443
  */
2393
2444
  get_green_bits(): number;
2394
2445
 
2395
2446
  /**
2396
2447
  * Queries the current height of the given `framebuffer`.
2397
2448
  * @returns The height of `framebuffer`.
2449
+ * @since 1.8
2398
2450
  */
2399
2451
  get_height(): number;
2400
2452
 
@@ -2402,17 +2454,20 @@ export namespace Cogl {
2402
2454
 
2403
2455
  /**
2404
2456
  * Stores the current model-view matrix in `matrix`.
2457
+ * @since 1.10
2405
2458
  */
2406
2459
  get_modelview_matrix(): Graphene.Matrix;
2407
2460
 
2408
2461
  /**
2409
2462
  * Stores the current projection matrix in `matrix`.
2463
+ * @since 1.10
2410
2464
  */
2411
2465
  get_projection_matrix(): Graphene.Matrix;
2412
2466
 
2413
2467
  /**
2414
2468
  * Retrieves the number of red bits of `framebuffer`
2415
2469
  * @returns the number of bits
2470
+ * @since 1.8
2416
2471
  */
2417
2472
  get_red_bits(): number;
2418
2473
 
@@ -2430,6 +2485,7 @@ export namespace Cogl {
2430
2485
  * framebuffer has been allocated the value will reflect the actual
2431
2486
  * number of samples that will be made by the GPU.
2432
2487
  * @returns The number of point samples made per pixel when rasterizing geometry or 0 if single-sample rendering has been chosen.
2488
+ * @since 1.10
2433
2489
  */
2434
2490
  get_samples_per_pixel(): number;
2435
2491
 
@@ -2437,6 +2493,7 @@ export namespace Cogl {
2437
2493
  * Gets the current {@link Cogl.StereoMode}, which defines which stereo buffers
2438
2494
  * should be drawn to. See `cogl_framebuffer_set_stereo_mode()`.
2439
2495
  * @returns A {@link Cogl.StereoMode}
2496
+ * @since 1.20
2440
2497
  */
2441
2498
  get_stereo_mode(): StereoMode;
2442
2499
 
@@ -2445,6 +2502,7 @@ export namespace Cogl {
2445
2502
  * using `cogl_framebuffer_set_viewport()` or the default values which are 0, 0,
2446
2503
  * framebuffer_width and framebuffer_height. The values are written into the
2447
2504
  * given `viewport` array.
2505
+ * @since 1.8
2448
2506
  */
2449
2507
  get_viewport4fv(): number[];
2450
2508
 
@@ -2452,6 +2510,7 @@ export namespace Cogl {
2452
2510
  * Queries the height of the viewport as set using `cogl_framebuffer_set_viewport()`
2453
2511
  * or the default value which is the height of the framebuffer.
2454
2512
  * @returns The height of the viewport.
2513
+ * @since 1.8
2455
2514
  */
2456
2515
  get_viewport_height(): number;
2457
2516
 
@@ -2459,6 +2518,7 @@ export namespace Cogl {
2459
2518
  * Queries the width of the viewport as set using `cogl_framebuffer_set_viewport()`
2460
2519
  * or the default value which is the width of the framebuffer.
2461
2520
  * @returns The width of the viewport.
2521
+ * @since 1.8
2462
2522
  */
2463
2523
  get_viewport_width(): number;
2464
2524
 
@@ -2466,6 +2526,7 @@ export namespace Cogl {
2466
2526
  * Queries the x coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
2467
2527
  * or the default value which is 0.
2468
2528
  * @returns The x coordinate of the viewport origin.
2529
+ * @since 1.8
2469
2530
  */
2470
2531
  get_viewport_x(): number;
2471
2532
 
@@ -2473,17 +2534,20 @@ export namespace Cogl {
2473
2534
  * Queries the y coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
2474
2535
  * or the default value which is 0.
2475
2536
  * @returns The y coordinate of the viewport origin.
2537
+ * @since 1.8
2476
2538
  */
2477
2539
  get_viewport_y(): number;
2478
2540
 
2479
2541
  /**
2480
2542
  * Queries the current width of the given `framebuffer`.
2481
2543
  * @returns The width of `framebuffer`.
2544
+ * @since 1.8
2482
2545
  */
2483
2546
  get_width(): number;
2484
2547
 
2485
2548
  /**
2486
2549
  * Resets the current model-view matrix to the identity matrix.
2550
+ * @since 1.10
2487
2551
  */
2488
2552
  identity_matrix(): void;
2489
2553
 
@@ -2496,6 +2560,7 @@ export namespace Cogl {
2496
2560
  * @param y_2 The y coordinate for the second horizontal clipping plane
2497
2561
  * @param near The <emphasis>distance</emphasis> to the near clipping plane (will be <emphasis>negative</emphasis> if the plane is behind the viewer)
2498
2562
  * @param far The <emphasis>distance</emphasis> to the far clipping plane (will be <emphasis>negative</emphasis> if the plane is behind the viewer)
2563
+ * @since 1.10
2499
2564
  */
2500
2565
  orthographic(x_1: number, y_1: number, x_2: number, y_2: number, near: number, far: number): void;
2501
2566
 
@@ -2511,6 +2576,7 @@ export namespace Cogl {
2511
2576
  * @param aspect The (width over height) aspect ratio for display
2512
2577
  * @param z_near The distance to the near clipping plane (Must be positive, and must not be 0)
2513
2578
  * @param z_far The distance to the far clipping plane (Must be positive)
2579
+ * @since 1.10
2514
2580
  */
2515
2581
  perspective(fov_y: number, aspect: number, z_near: number, z_far: number): void;
2516
2582
 
@@ -2518,17 +2584,20 @@ export namespace Cogl {
2518
2584
  * Reverts the clipping region to the state before the last call to
2519
2585
  * `cogl_framebuffer_push_scissor_clip()`, `cogl_framebuffer_push_rectangle_clip()`
2520
2586
  * `cogl_framebuffer_push_path_clip()`, or `cogl_framebuffer_push_primitive_clip()`.
2587
+ * @since 1.10
2521
2588
  */
2522
2589
  pop_clip(): void;
2523
2590
 
2524
2591
  /**
2525
2592
  * Restores the model-view matrix on the top of the matrix stack.
2593
+ * @since 1.10
2526
2594
  */
2527
2595
  pop_matrix(): void;
2528
2596
 
2529
2597
  /**
2530
2598
  * Copies the current model-view matrix onto the matrix stack. The matrix
2531
2599
  * can later be restored with `cogl_framebuffer_pop_matrix()`.
2600
+ * @since 1.10
2532
2601
  */
2533
2602
  push_matrix(): void;
2534
2603
 
@@ -2545,6 +2614,7 @@ export namespace Cogl {
2545
2614
  * @param y_1 y coordinate for top left corner of the clip rectangle
2546
2615
  * @param x_2 x coordinate for bottom right corner of the clip rectangle
2547
2616
  * @param y_2 y coordinate for bottom right corner of the clip rectangle
2617
+ * @since 1.10
2548
2618
  */
2549
2619
  push_rectangle_clip(x_1: number, y_1: number, x_2: number, y_2: number): void;
2550
2620
 
@@ -2566,6 +2636,7 @@ export namespace Cogl {
2566
2636
  * @param y top edge of the clip rectangle in window coordinates
2567
2637
  * @param width width of the clip rectangle
2568
2638
  * @param height height of the clip rectangle
2639
+ * @since 1.10
2569
2640
  */
2570
2641
  push_scissor_clip(x: number, y: number, width: number, height: number): void;
2571
2642
 
@@ -2603,6 +2674,7 @@ export namespace Cogl {
2603
2674
  * @param format The pixel format to store the data in
2604
2675
  * @param pixels The address of the buffer to store the data in
2605
2676
  * @returns `true` if the read succeeded or `false` otherwise.
2677
+ * @since 1.10
2606
2678
  */
2607
2679
  read_pixels(x: number, y: number, width: number, height: number, format: PixelFormat, pixels: number): boolean;
2608
2680
 
@@ -2622,6 +2694,7 @@ export namespace Cogl {
2622
2694
  * @param source Identifies which auxiliary buffer you want to read (only COGL_READ_PIXELS_COLOR_BUFFER supported currently)
2623
2695
  * @param bitmap The bitmap to store the results in.
2624
2696
  * @returns `true` if the read succeeded or `false` otherwise. The function is only likely to fail if the bitmap points to a pixel buffer and it could not be mapped.
2697
+ * @since 1.10
2625
2698
  */
2626
2699
  read_pixels_into_bitmap(x: number, y: number, source: ReadPixelsFlags, bitmap: Bitmap): boolean;
2627
2700
 
@@ -2646,6 +2719,7 @@ export namespace Cogl {
2646
2719
  * If you are performing incremental updates to a framebuffer you
2647
2720
  * should consider using `cogl_framebuffer_resolve_samples_region()`
2648
2721
  * instead to avoid resolving redundant pixels.
2722
+ * @since 1.8
2649
2723
  */
2650
2724
  resolve_samples(): void;
2651
2725
 
@@ -2675,6 +2749,7 @@ export namespace Cogl {
2675
2749
  * @param y top-left y coordinate of region to resolve
2676
2750
  * @param width width of region to resolve
2677
2751
  * @param height height of region to resolve
2752
+ * @since 1.8
2678
2753
  */
2679
2754
  resolve_samples_region(x: number, y: number, width: number, height: number): void;
2680
2755
 
@@ -2688,6 +2763,7 @@ export namespace Cogl {
2688
2763
  * @param x X-component of vertex to rotate around.
2689
2764
  * @param y Y-component of vertex to rotate around.
2690
2765
  * @param z Z-component of vertex to rotate around.
2766
+ * @since 1.10
2691
2767
  */
2692
2768
  rotate(angle: number, x: number, y: number, z: number): void;
2693
2769
 
@@ -2695,6 +2771,7 @@ export namespace Cogl {
2695
2771
  * Multiplies the current model-view matrix by one that rotates
2696
2772
  * according to the rotation described by `euler`.
2697
2773
  * @param euler A {@link Graphene.Euler}
2774
+ * @since 2.0
2698
2775
  */
2699
2776
  rotate_euler(euler: Graphene.Euler): void;
2700
2777
 
@@ -2704,6 +2781,7 @@ export namespace Cogl {
2704
2781
  * @param x Amount to scale along the x-axis
2705
2782
  * @param y Amount to scale along the y-axis
2706
2783
  * @param z Amount to scale along the z-axis
2784
+ * @since 1.10
2707
2785
  */
2708
2786
  scale(x: number, y: number, z: number): void;
2709
2787
 
@@ -2715,6 +2793,7 @@ export namespace Cogl {
2715
2793
  *
2716
2794
  * Depth buffer writing is enabled by default.
2717
2795
  * @param depth_write_enabled `true` to enable depth writing or `false` to disable
2796
+ * @since 1.18
2718
2797
  */
2719
2798
  set_depth_write_enabled(depth_write_enabled: boolean): void;
2720
2799
 
@@ -2733,18 +2812,21 @@ export namespace Cogl {
2733
2812
  *
2734
2813
  * Dithering is enabled by default.
2735
2814
  * @param dither_enabled `true` to enable dithering or `false` to disable
2815
+ * @since 1.8
2736
2816
  */
2737
2817
  set_dither_enabled(dither_enabled: boolean): void;
2738
2818
 
2739
2819
  /**
2740
2820
  * Sets `matrix` as the new model-view matrix.
2741
2821
  * @param matrix the new model-view matrix
2822
+ * @since 1.10
2742
2823
  */
2743
2824
  set_modelview_matrix(matrix: Graphene.Matrix): void;
2744
2825
 
2745
2826
  /**
2746
2827
  * Sets `matrix` as the new projection matrix.
2747
2828
  * @param matrix the new projection matrix
2829
+ * @since 1.10
2748
2830
  */
2749
2831
  set_projection_matrix(matrix: Graphene.Matrix): void;
2750
2832
 
@@ -2782,6 +2864,7 @@ export namespace Cogl {
2782
2864
  * framebuffer has changed this can lead to redundant work being
2783
2865
  * done.</note>
2784
2866
  * @param samples_per_pixel The minimum number of samples per pixel
2867
+ * @since 1.8
2785
2868
  */
2786
2869
  set_samples_per_pixel(samples_per_pixel: number): void;
2787
2870
 
@@ -2794,6 +2877,7 @@ export namespace Cogl {
2794
2877
  * enabled. (See `cogl_onscreen_template_set_stereo_enabled()`,
2795
2878
  * `cogl_framebuffer_get_is_stereo()`.)
2796
2879
  * @param stereo_mode A {@link Cogl.StereoMode} specifying which stereo buffers should be drawn tow.
2880
+ * @since 1.20
2797
2881
  */
2798
2882
  set_stereo_mode(stereo_mode: StereoMode): void;
2799
2883
 
@@ -2817,12 +2901,14 @@ export namespace Cogl {
2817
2901
  * @param y The top-left y coordinate of the viewport origin (only integers supported currently)
2818
2902
  * @param width The width of the viewport (only integers supported currently)
2819
2903
  * @param height The height of the viewport (only integers supported currently)
2904
+ * @since 1.8
2820
2905
  */
2821
2906
  set_viewport(x: number, y: number, width: number, height: number): void;
2822
2907
 
2823
2908
  /**
2824
2909
  * Multiplies the current model-view matrix by the given matrix.
2825
2910
  * @param matrix the matrix to multiply with the current model-view
2911
+ * @since 1.10
2826
2912
  */
2827
2913
  transform(matrix: Graphene.Matrix): void;
2828
2914
 
@@ -2832,6 +2918,7 @@ export namespace Cogl {
2832
2918
  * @param x Distance to translate along the x-axis
2833
2919
  * @param y Distance to translate along the y-axis
2834
2920
  * @param z Distance to translate along the z-axis
2921
+ * @since 1.10
2835
2922
  */
2836
2923
  translate(x: number, y: number, z: number): void;
2837
2924
  }
@@ -3005,6 +3092,7 @@ export namespace Cogl {
3005
3092
  * explicitly checked to determine if Cogl is currently tracking the
3006
3093
  * age of {@link Cogl.Onscreen} back buffer contents. If this feature is
3007
3094
  * missing then this function will always return 0.</note>
3095
+ * @since 1.14
3008
3096
  * @virtual
3009
3097
  */
3010
3098
  vfunc_get_buffer_age(): number;
@@ -3061,6 +3149,7 @@ export namespace Cogl {
3061
3149
  * @param rectangles An array of integer 4-tuples representing damaged rectangles as (x, y, width, height) tuples.
3062
3150
  * @param n_rectangles The number of 4-tuples to be read from `rectangles`
3063
3151
  * @param info
3152
+ * @since 1.16
3064
3153
  * @virtual
3065
3154
  */
3066
3155
  vfunc_swap_buffers_with_damage(rectangles: number, n_rectangles: number, info: FrameInfo): void;
@@ -3078,6 +3167,7 @@ export namespace Cogl {
3078
3167
  * @param rectangles An array of integer 4-tuples representing rectangles as (x, y, width, height) tuples.
3079
3168
  * @param n_rectangles The number of 4-tuples to be read from `rectangles`
3080
3169
  * @param info
3170
+ * @since 1.10
3081
3171
  * @virtual
3082
3172
  */
3083
3173
  vfunc_swap_region(rectangles: number, n_rectangles: number, info: FrameInfo): void;
@@ -3103,6 +3193,7 @@ export namespace Cogl {
3103
3193
  * @param callback A callback function to call for dirty events
3104
3194
  * @param destroy An optional callback to destroy `user_data` when the `callback` is removed or `onscreen` is freed.
3105
3195
  * @returns a {@link Cogl.OnscreenDirtyClosure} pointer that can be used to remove the callback and associated `user_data` later.
3196
+ * @since 1.16
3106
3197
  */
3107
3198
  add_dirty_callback(callback: OnscreenDirtyCallback, destroy: UserDataDestroyCallback | null): OnscreenDirtyClosure;
3108
3199
 
@@ -3133,6 +3224,7 @@ export namespace Cogl {
3133
3224
  * @param callback A callback function to call for frame events
3134
3225
  * @param destroy An optional callback to destroy `user_data` when the `callback` is removed or `onscreen` is freed.
3135
3226
  * @returns a {@link Cogl.FrameClosure} pointer that can be used to remove the callback and associated `user_data` later.
3227
+ * @since 1.14
3136
3228
  */
3137
3229
  add_frame_callback(callback: FrameCallback, destroy: UserDataDestroyCallback | null): FrameClosure;
3138
3230
 
@@ -3176,6 +3268,7 @@ export namespace Cogl {
3176
3268
  * age of {@link Cogl.Onscreen} back buffer contents. If this feature is
3177
3269
  * missing then this function will always return 0.</note>
3178
3270
  * @returns The age of the buffer contents or 0 when the buffer contents are undefined.
3271
+ * @since 1.14
3179
3272
  */
3180
3273
  get_buffer_age(): number;
3181
3274
 
@@ -3185,6 +3278,7 @@ export namespace Cogl {
3185
3278
  * `cogl_onscreen_swap_buffers()` or `cogl_onscreen_swap_region()`
3186
3279
  * is called.
3187
3280
  * @returns the current frame counter value
3281
+ * @since 1.14
3188
3282
  */
3189
3283
  get_frame_counter(): number;
3190
3284
 
@@ -3203,6 +3297,7 @@ export namespace Cogl {
3203
3297
  * requests e.g. to show an already visible window. This also means
3204
3298
  * that it's acceptable to alternatively use native APIs to show and
3205
3299
  * hide windows without confusing Cogl.</note>
3300
+ * @since 2.0
3206
3301
  */
3207
3302
  hide(): void;
3208
3303
 
@@ -3224,6 +3319,7 @@ export namespace Cogl {
3224
3319
  * `cogl_onscreen_add_dirty_callback()` to destroy the user data then
3225
3320
  * this will also get called.
3226
3321
  * @param closure A {@link Cogl.OnscreenDirtyClosure} returned from `cogl_onscreen_add_dirty_callback()`
3322
+ * @since 1.16
3227
3323
  */
3228
3324
  remove_dirty_callback(closure: OnscreenDirtyClosure): void;
3229
3325
 
@@ -3235,6 +3331,7 @@ export namespace Cogl {
3235
3331
  * `cogl_onscreen_add_frame_callback()` to destroy the user data then
3236
3332
  * this will get called.
3237
3333
  * @param closure A {@link Cogl.FrameClosure} returned from `cogl_onscreen_add_frame_callback()`
3334
+ * @since 1.14
3238
3335
  */
3239
3336
  remove_frame_callback(closure: FrameClosure): void;
3240
3337
 
@@ -3259,6 +3356,7 @@ export namespace Cogl {
3259
3356
  * requests e.g. to show an already visible window. This also means
3260
3357
  * that it's acceptable to alternatively use native APIs to show and
3261
3358
  * hide windows without confusing Cogl.</note>
3359
+ * @since 2.0
3262
3360
  */
3263
3361
  show(): void;
3264
3362
 
@@ -3278,6 +3376,7 @@ export namespace Cogl {
3278
3376
  * render a full buffer for every frame.</note>
3279
3377
  * @param frame_info
3280
3378
  * @param user_data
3379
+ * @since 1.10
3281
3380
  */
3282
3381
  swap_buffers(frame_info: FrameInfo, user_data: null): void;
3283
3382
 
@@ -3323,6 +3422,7 @@ export namespace Cogl {
3323
3422
  * @param n_rectangles The number of 4-tuples to be read from `rectangles`
3324
3423
  * @param info
3325
3424
  * @param user_data
3425
+ * @since 1.16
3326
3426
  */
3327
3427
  swap_buffers_with_damage(rectangles: number, n_rectangles: number, info: FrameInfo, user_data: null): void;
3328
3428
 
@@ -3340,6 +3440,7 @@ export namespace Cogl {
3340
3440
  * @param n_rectangles The number of 4-tuples to be read from `rectangles`
3341
3441
  * @param info
3342
3442
  * @param user_data
3443
+ * @since 1.10
3343
3444
  */
3344
3445
  swap_region(rectangles: number, n_rectangles: number, info: FrameInfo, user_data: null): void;
3345
3446
  }
@@ -3383,6 +3484,7 @@ export namespace Cogl {
3383
3484
  * and need to be added with `cogl_pipeline_add_snippet()` instead.
3384
3485
  * @param layer The layer to hook the snippet to
3385
3486
  * @param snippet A {@link Cogl.Snippet}
3487
+ * @since 1.10
3386
3488
  */
3387
3489
  add_layer_snippet(layer: number, snippet: Snippet): void;
3388
3490
 
@@ -3392,6 +3494,7 @@ export namespace Cogl {
3392
3494
  * `snippet`. Note that some hook points are specific to a layer and
3393
3495
  * must be added with `cogl_pipeline_add_layer_snippet()` instead.
3394
3496
  * @param snippet The {@link Cogl.Snippet} to add to the vertex processing hook
3497
+ * @since 1.10
3395
3498
  */
3396
3499
  add_snippet(snippet: Snippet): void;
3397
3500
 
@@ -3405,32 +3508,38 @@ export namespace Cogl {
3405
3508
  * keep track of a pipelines ancestry which we may use to help minimize GPU
3406
3509
  * state changes.
3407
3510
  * @returns a pointer to the newly allocated {@link Cogl.Pipeline}
3511
+ * @since 2.0
3408
3512
  */
3409
3513
  copy(): Pipeline;
3410
3514
 
3411
3515
  /**
3412
3516
  * Iterates all the layer indices of the given `pipeline`.
3413
3517
  * @param callback A {@link Cogl.PipelineLayerCallback} to be called for each layer index
3518
+ * @since 2.0
3414
3519
  */
3415
3520
  foreach_layer(callback: PipelineLayerCallback): void;
3416
3521
 
3417
3522
  /**
3418
3523
  * @returns The alpha test function of `pipeline`.
3524
+ * @since 2.0
3419
3525
  */
3420
3526
  get_alpha_test_function(): PipelineAlphaFunc;
3421
3527
 
3422
3528
  /**
3423
3529
  * @returns The alpha test reference value of `pipeline`.
3530
+ * @since 2.0
3424
3531
  */
3425
3532
  get_alpha_test_reference(): number;
3426
3533
 
3427
3534
  /**
3428
3535
  * Retrieves the current pipeline color.
3536
+ * @since 2.0
3429
3537
  */
3430
3538
  get_color(): Color;
3431
3539
 
3432
3540
  /**
3433
3541
  * @returns the cull face mode that was previously set with `cogl_pipeline_set_cull_face_mode()`. Status: Unstable
3542
+ * @since 2.0
3434
3543
  */
3435
3544
  get_cull_face_mode(): PipelineCullFaceMode;
3436
3545
 
@@ -3443,6 +3552,7 @@ export namespace Cogl {
3443
3552
  * {@link Cogl.Winding.CLOCKWISE} sets them to be clockwise. The default is
3444
3553
  * {@link Cogl.Winding.COUNTER_CLOCKWISE}.
3445
3554
  * @returns The `pipeline` front face winding Status: Unstable
3555
+ * @since 2.0
3446
3556
  */
3447
3557
  get_front_face_winding(): Winding;
3448
3558
 
@@ -3455,6 +3565,7 @@ export namespace Cogl {
3455
3565
  * changed using `cogl_pipeline_set_layer_filters()`.
3456
3566
  * @param layer_index the layer number to change.
3457
3567
  * @returns The magnification {@link Cogl.PipelineFilter} for the specified layer.
3568
+ * @since 1.10
3458
3569
  */
3459
3570
  get_layer_mag_filter(layer_index: number): PipelineFilter;
3460
3571
 
@@ -3467,6 +3578,7 @@ export namespace Cogl {
3467
3578
  * changed using `cogl_pipeline_set_layer_filters()`.
3468
3579
  * @param layer_index the layer number to change.
3469
3580
  * @returns The minification {@link Cogl.PipelineFilter} for the specified layer.
3581
+ * @since 1.10
3470
3582
  */
3471
3583
  get_layer_min_filter(layer_index: number): PipelineFilter;
3472
3584
 
@@ -3475,12 +3587,14 @@ export namespace Cogl {
3475
3587
  * texture layer.
3476
3588
  * @param layer_index the layer number to check.
3477
3589
  * @returns whether the texture coordinates will be replaced with point sprite coordinates.
3590
+ * @since 2.0
3478
3591
  */
3479
3592
  get_layer_point_sprite_coords_enabled(layer_index: number): boolean;
3480
3593
 
3481
3594
  /**
3482
3595
  * @param layer_index the index of the layer
3483
3596
  * @returns the texture that was set for the given layer of the pipeline or `null` if no texture was set.
3597
+ * @since 1.10
3484
3598
  */
3485
3599
  get_layer_texture(layer_index: number): Texture;
3486
3600
 
@@ -3489,6 +3603,7 @@ export namespace Cogl {
3489
3603
  * layer.
3490
3604
  * @param layer_index the layer number to change.
3491
3605
  * @returns the wrap mode for the 's' coordinate of texture lookups on this layer.
3606
+ * @since 1.6
3492
3607
  */
3493
3608
  get_layer_wrap_mode_s(layer_index: number): PipelineWrapMode;
3494
3609
 
@@ -3497,17 +3612,20 @@ export namespace Cogl {
3497
3612
  * layer.
3498
3613
  * @param layer_index the layer number to change.
3499
3614
  * @returns the wrap mode for the 't' coordinate of texture lookups on this layer.
3615
+ * @since 1.6
3500
3616
  */
3501
3617
  get_layer_wrap_mode_t(layer_index: number): PipelineWrapMode;
3502
3618
 
3503
3619
  /**
3504
3620
  * Retrieves the number of layers defined for the given `pipeline`
3505
3621
  * @returns the number of layers
3622
+ * @since 2.0
3506
3623
  */
3507
3624
  get_n_layers(): number;
3508
3625
 
3509
3626
  /**
3510
3627
  * @returns `true` if the pipeline has per-vertex point size enabled or `false` otherwise. The per-vertex point size can be enabled with `cogl_pipeline_set_per_vertex_point_size()`.
3628
+ * @since 2.0
3511
3629
  */
3512
3630
  get_per_vertex_point_size(): boolean;
3513
3631
 
@@ -3515,6 +3633,7 @@ export namespace Cogl {
3515
3633
  * Get the size of points drawn when {@link Cogl.VerticesMode.POINTS} is
3516
3634
  * used with the vertex buffer API.
3517
3635
  * @returns the point size of the `pipeline`.
3636
+ * @since 2.0
3518
3637
  */
3519
3638
  get_point_size(): number;
3520
3639
 
@@ -3530,6 +3649,7 @@ export namespace Cogl {
3530
3649
  * before calling this function.
3531
3650
  * @param uniform_name The name of a uniform
3532
3651
  * @returns A integer representing the location of the given uniform.
3652
+ * @since 2.0
3533
3653
  */
3534
3654
  get_uniform_location(uniform_name: string): number;
3535
3655
 
@@ -3537,12 +3657,14 @@ export namespace Cogl {
3537
3657
  * Queries what user program has been associated with the given
3538
3658
  * `pipeline` using `cogl_pipeline_set_user_program()`.
3539
3659
  * @returns The current user program or `null`.
3660
+ * @since 2.0
3540
3661
  */
3541
3662
  get_user_program(): Handle;
3542
3663
 
3543
3664
  /**
3544
3665
  * This function removes a layer from your pipeline
3545
3666
  * @param layer_index Specifies the layer you want to remove
3667
+ * @since 1.10
3546
3668
  */
3547
3669
  remove_layer(layer_index: number): void;
3548
3670
 
@@ -3556,6 +3678,7 @@ export namespace Cogl {
3556
3678
  * The default is {@link Cogl.PipelineAlphaFunc.ALWAYS}
3557
3679
  * @param alpha_func A `CoglPipelineAlphaFunc` constant
3558
3680
  * @param alpha_reference A reference point that the chosen alpha function uses to compare incoming fragments to.
3681
+ * @since 2.0
3559
3682
  */
3560
3683
  set_alpha_test_function(alpha_func: PipelineAlphaFunc, alpha_reference: number): void;
3561
3684
 
@@ -3627,6 +3750,8 @@ export namespace Cogl {
3627
3750
  * is in premultiplied form.
3628
3751
  * @param blend_string A <link linkend="cogl-Blend-Strings">Cogl blend string</link> describing the desired blend function.
3629
3752
  * @returns `true` if the blend string was successfully parsed, and the described blending is supported by the underlying driver/hardware. If there was an error, `false` is returned and `error` is set accordingly (if present).
3753
+ * @since 2.0
3754
+ * @throws GLib.Error
3630
3755
  */
3631
3756
  set_blend(blend_string: string): boolean;
3632
3757
 
@@ -3634,6 +3759,7 @@ export namespace Cogl {
3634
3759
  * When blending is setup to reference a CONSTANT blend factor then
3635
3760
  * blending will depend on the constant set with this function.
3636
3761
  * @param constant_color The constant color you want
3762
+ * @since 2.0
3637
3763
  */
3638
3764
  set_blend_constant(constant_color: Color): void;
3639
3765
 
@@ -3647,6 +3773,7 @@ export namespace Cogl {
3647
3773
  *
3648
3774
  * The default value is (1.0, 1.0, 1.0, 1.0)
3649
3775
  * @param color The components of the color
3776
+ * @since 2.0
3650
3777
  */
3651
3778
  set_color(color: Color): void;
3652
3779
 
@@ -3658,6 +3785,7 @@ export namespace Cogl {
3658
3785
  * @param green The green component
3659
3786
  * @param blue The blue component
3660
3787
  * @param alpha The alpha component
3788
+ * @since 2.0
3661
3789
  */
3662
3790
  set_color4f(red: number, green: number, blue: number, alpha: number): void;
3663
3791
 
@@ -3669,6 +3797,7 @@ export namespace Cogl {
3669
3797
  * @param green The green component
3670
3798
  * @param blue The blue component
3671
3799
  * @param alpha The alpha component
3800
+ * @since 2.0
3672
3801
  */
3673
3802
  set_color4ub(red: number, green: number, blue: number, alpha: number): void;
3674
3803
 
@@ -3688,6 +3817,7 @@ export namespace Cogl {
3688
3817
  *
3689
3818
  * Status: Unstable
3690
3819
  * @param cull_face_mode The new mode to set
3820
+ * @since 2.0
3691
3821
  */
3692
3822
  set_cull_face_mode(cull_face_mode: PipelineCullFaceMode): void;
3693
3823
 
@@ -3702,6 +3832,7 @@ export namespace Cogl {
3702
3832
  *
3703
3833
  * Status: Unstable
3704
3834
  * @param front_winding the winding order
3835
+ * @since 2.0
3705
3836
  */
3706
3837
  set_front_face_winding(front_winding: Winding): void;
3707
3838
 
@@ -3785,6 +3916,8 @@ export namespace Cogl {
3785
3916
  * @param layer_index Specifies the layer you want define a combine function for
3786
3917
  * @param blend_string A <link linkend="cogl-Blend-Strings">Cogl blend string</link> describing the desired texture combine function.
3787
3918
  * @returns `true` if the blend string was successfully parsed, and the described texture combining is supported by the underlying driver and or hardware. On failure, `false` is returned and `error` is set
3919
+ * @since 2.0
3920
+ * @throws GLib.Error
3788
3921
  */
3789
3922
  set_layer_combine(layer_index: number, blend_string: string): boolean;
3790
3923
 
@@ -3793,6 +3926,7 @@ export namespace Cogl {
3793
3926
  * description then you can use this function to define its value.
3794
3927
  * @param layer_index Specifies the layer you want to specify a constant used for texture combining
3795
3928
  * @param constant The constant color you want
3929
+ * @since 2.0
3796
3930
  */
3797
3931
  set_layer_combine_constant(layer_index: number, constant: Color): void;
3798
3932
 
@@ -3807,6 +3941,7 @@ export namespace Cogl {
3807
3941
  * @param layer_index the layer number to change.
3808
3942
  * @param min_filter the filter used when scaling a texture down.
3809
3943
  * @param mag_filter the filter used when magnifying a texture.
3944
+ * @since 1.10
3810
3945
  */
3811
3946
  set_layer_filters(layer_index: number, min_filter: PipelineFilter, mag_filter: PipelineFilter): void;
3812
3947
 
@@ -3815,6 +3950,7 @@ export namespace Cogl {
3815
3950
  * and rotate a single layer of a pipeline used to fill your geometry.
3816
3951
  * @param layer_index the index for the layer inside `pipeline`
3817
3952
  * @param matrix the transformation matrix for the layer
3953
+ * @since 1.10
3818
3954
  */
3819
3955
  set_layer_matrix(layer_index: number, matrix: Graphene.Matrix): void;
3820
3956
 
@@ -3834,6 +3970,7 @@ export namespace Cogl {
3834
3970
  * specify the texture type so that any pipeline copies can share the
3835
3971
  * internal texture type state for efficiency.
3836
3972
  * @param layer_index The layer number to modify
3973
+ * @since 1.10
3837
3974
  */
3838
3975
  set_layer_null_texture(layer_index: number): void;
3839
3976
 
@@ -3847,6 +3984,8 @@ export namespace Cogl {
3847
3984
  * @param layer_index the layer number to change.
3848
3985
  * @param enable whether to enable point sprite coord generation.
3849
3986
  * @returns `true` if the function succeeds, `false` otherwise.
3987
+ * @since 2.0
3988
+ * @throws GLib.Error
3850
3989
  */
3851
3990
  set_layer_point_sprite_coords_enabled(layer_index: number, enable: boolean): boolean;
3852
3991
 
@@ -3863,6 +4002,7 @@ export namespace Cogl {
3863
4002
  * `cogl_pipeline_set_layer_wrap_mode_t()` separately.
3864
4003
  * @param layer_index the layer number to change.
3865
4004
  * @param mode the new wrap mode
4005
+ * @since 2.0
3866
4006
  */
3867
4007
  set_layer_wrap_mode(layer_index: number, mode: PipelineWrapMode): void;
3868
4008
 
@@ -3870,6 +4010,7 @@ export namespace Cogl {
3870
4010
  * Sets the wrap mode for the 's' coordinate of texture lookups on this layer.
3871
4011
  * @param layer_index the layer number to change.
3872
4012
  * @param mode the new wrap mode
4013
+ * @since 2.0
3873
4014
  */
3874
4015
  set_layer_wrap_mode_s(layer_index: number, mode: PipelineWrapMode): void;
3875
4016
 
@@ -3877,6 +4018,7 @@ export namespace Cogl {
3877
4018
  * Sets the wrap mode for the 't' coordinate of texture lookups on this layer.
3878
4019
  * @param layer_index the layer number to change.
3879
4020
  * @param mode the new wrap mode
4021
+ * @since 2.0
3880
4022
  */
3881
4023
  set_layer_wrap_mode_t(layer_index: number, mode: PipelineWrapMode): void;
3882
4024
 
@@ -3893,6 +4035,8 @@ export namespace Cogl {
3893
4035
  * undefined.
3894
4036
  * @param enable whether to enable per-vertex point size
3895
4037
  * @returns `true` if the change succeeded or `false` otherwise
4038
+ * @since 2.0
4039
+ * @throws GLib.Error
3896
4040
  */
3897
4041
  set_per_vertex_point_size(enable: boolean): boolean;
3898
4042
 
@@ -3910,6 +4054,7 @@ export namespace Cogl {
3910
4054
  * if an application wants to draw points it must make sure to use a
3911
4055
  * pipeline that has an explicit point size set on it.
3912
4056
  * @param point_size the new point size.
4057
+ * @since 2.0
3913
4058
  */
3914
4059
  set_point_size(point_size: number): void;
3915
4060
 
@@ -3926,6 +4071,7 @@ export namespace Cogl {
3926
4071
  * uniform.
3927
4072
  * @param uniform_location The uniform's location identifier
3928
4073
  * @param value The new value for the uniform
4074
+ * @since 2.0
3929
4075
  */
3930
4076
  set_uniform_1f(uniform_location: number, value: number): void;
3931
4077
 
@@ -3942,6 +4088,7 @@ export namespace Cogl {
3942
4088
  * uniform or a sampler uniform.
3943
4089
  * @param uniform_location The uniform's location identifier
3944
4090
  * @param value The new value for the uniform
4091
+ * @since 2.0
3945
4092
  */
3946
4093
  set_uniform_1i(uniform_location: number, value: number): void;
3947
4094
 
@@ -3962,6 +4109,7 @@ export namespace Cogl {
3962
4109
  * @param n_components The number of components in the corresponding uniform's type
3963
4110
  * @param count The number of values to set
3964
4111
  * @param value Pointer to the new values to set
4112
+ * @since 2.0
3965
4113
  */
3966
4114
  set_uniform_float(uniform_location: number, n_components: number, count: number, value: number): void;
3967
4115
 
@@ -3982,6 +4130,7 @@ export namespace Cogl {
3982
4130
  * @param n_components The number of components in the corresponding uniform's type
3983
4131
  * @param count The number of values to set
3984
4132
  * @param value Pointer to the new values to set
4133
+ * @since 2.0
3985
4134
  */
3986
4135
  set_uniform_int(uniform_location: number, n_components: number, count: number, value: number): void;
3987
4136
 
@@ -4008,6 +4157,7 @@ export namespace Cogl {
4008
4157
  * @param count The number of values to set
4009
4158
  * @param transpose Whether to transpose the matrix
4010
4159
  * @param value Pointer to the new values to set
4160
+ * @since 2.0
4011
4161
  */
4012
4162
  set_uniform_matrix(uniform_location: number, dimensions: number, count: number, transpose: boolean, value: number): void;
4013
4163
 
@@ -4048,6 +4198,7 @@ export namespace Cogl {
4048
4198
  * meantime we hope this will handle most practical GLSL and ARBfp
4049
4199
  * requirements.
4050
4200
  * @param program A {@link Cogl.Handle} to a linked CoglProgram
4201
+ * @since 2.0
4051
4202
  */
4052
4203
  set_user_program(program: Handle): void;
4053
4204
  }
@@ -4085,26 +4236,31 @@ export namespace Cogl {
4085
4236
  // Methods
4086
4237
  /**
4087
4238
  * @returns the source string that was set with `cogl_snippet_set_declarations()` or `null` if none was set.
4239
+ * @since 1.10
4088
4240
  */
4089
4241
  get_declarations(): string;
4090
4242
 
4091
4243
  /**
4092
4244
  * @returns the hook that was set when `cogl_snippet_new()` was called.
4245
+ * @since 1.10
4093
4246
  */
4094
4247
  get_hook(): SnippetHook;
4095
4248
 
4096
4249
  /**
4097
4250
  * @returns the source string that was set with `cogl_snippet_set_post()` or `null` if none was set.
4251
+ * @since 1.10
4098
4252
  */
4099
4253
  get_post(): string;
4100
4254
 
4101
4255
  /**
4102
4256
  * @returns the source string that was set with `cogl_snippet_set_pre()` or `null` if none was set.
4257
+ * @since 1.10
4103
4258
  */
4104
4259
  get_pre(): string;
4105
4260
 
4106
4261
  /**
4107
4262
  * @returns the source string that was set with `cogl_snippet_set_replace()` or `null` if none was set.
4263
+ * @since 1.10
4108
4264
  */
4109
4265
  get_replace(): string;
4110
4266
 
@@ -4118,6 +4274,7 @@ export namespace Cogl {
4118
4274
  * to its first pipeline. After that the snippet should be considered
4119
4275
  * immutable.
4120
4276
  * @param declarations The new source string for the declarations section of this snippet.
4277
+ * @since 1.10
4121
4278
  */
4122
4279
  set_declarations(declarations: string): void;
4123
4280
 
@@ -4131,6 +4288,7 @@ export namespace Cogl {
4131
4288
  * to its first pipeline. After that the snippet should be considered
4132
4289
  * immutable.
4133
4290
  * @param post The new source string for the post section of this snippet.
4291
+ * @since 1.10
4134
4292
  */
4135
4293
  set_post(post: string): void;
4136
4294
 
@@ -4144,6 +4302,7 @@ export namespace Cogl {
4144
4302
  * to its first pipeline. After that the snippet should be considered
4145
4303
  * immutable.
4146
4304
  * @param pre The new source string for the pre section of this snippet.
4305
+ * @since 1.10
4147
4306
  */
4148
4307
  set_pre(pre: string): void;
4149
4308
 
@@ -4157,6 +4316,7 @@ export namespace Cogl {
4157
4316
  * to its first pipeline. After that the snippet should be considered
4158
4317
  * immutable.
4159
4318
  * @param replace The new source string for the replace section of this snippet.
4319
+ * @since 1.10
4160
4320
  */
4161
4321
  set_replace(replace: string): void;
4162
4322
  }
@@ -4209,6 +4369,7 @@ export namespace Cogl {
4209
4369
  * the texture, or if the texture is attached to a {@link Cogl.Offscreen}
4210
4370
  * framebuffer and rendered too.</note>
4211
4371
  * @returns `true` if the texture was successfully allocated, otherwise `false` and `error` will be updated if it wasn't `null`.
4372
+ * @throws GLib.Error
4212
4373
  */
4213
4374
  allocate(): boolean;
4214
4375
 
@@ -4220,6 +4381,7 @@ export namespace Cogl {
4220
4381
  * is {@link Cogl.TextureComponents.RGBA}. The other constructors which take
4221
4382
  * a %CoglBitmap or a data pointer default to the same components as
4222
4383
  * the pixel format of the data.
4384
+ * @since 1.18
4223
4385
  */
4224
4386
  get_components(): TextureComponents;
4225
4387
 
@@ -4266,6 +4428,7 @@ export namespace Cogl {
4266
4428
  *
4267
4429
  * By default the pre-multipled state is `TRUE`.
4268
4430
  * @returns `true` if red, green and blue components are internally stored pre-multiplied by the alpha value or `false` if not.
4431
+ * @since 1.18
4269
4432
  */
4270
4433
  get_premultiplied(): boolean;
4271
4434
 
@@ -4303,6 +4466,7 @@ export namespace Cogl {
4303
4466
  * an image format as long as {@link Cogl.TextureComponents.RG} isn't used
4304
4467
  * as the texture's components.
4305
4468
  * @param components
4469
+ * @since 1.18
4306
4470
  */
4307
4471
  set_components(components: TextureComponents): void;
4308
4472
 
@@ -4354,6 +4518,7 @@ export namespace Cogl {
4354
4518
  * @param data the source data, pointing to the first top-left pixel to set
4355
4519
  * @param level The mipmap level to update (Normally 0 for the largest, base texture)
4356
4520
  * @returns `true` if the data upload was successful, and `false` otherwise
4521
+ * @throws GLib.Error
4357
4522
  */
4358
4523
  set_data(format: PixelFormat, rowstride: number, data: Uint8Array | string, level: number): boolean;
4359
4524
 
@@ -4380,6 +4545,7 @@ export namespace Cogl {
4380
4545
  *
4381
4546
  * By default the `premultipled` state is `TRUE`.
4382
4547
  * @param premultiplied Whether any internally stored red, green or blue components are pre-multiplied by an alpha component.
4548
+ * @since 1.18
4383
4549
  */
4384
4550
  set_premultiplied(premultiplied: boolean): void;
4385
4551
 
@@ -4417,6 +4583,7 @@ export namespace Cogl {
4417
4583
  * @param dst_height height of destination region to write. (Must be less than or equal to the bitmap height)
4418
4584
  * @param bitmap The source bitmap to read from
4419
4585
  * @returns `true` if the subregion upload was successful, and `false` otherwise
4586
+ * @since 1.8
4420
4587
  */
4421
4588
  set_region_from_bitmap(src_x: number, src_y: number, dst_x: number, dst_y: number, dst_width: number, dst_height: number, bitmap: Bitmap): boolean;
4422
4589
  }
@@ -4461,6 +4628,7 @@ export namespace Cogl {
4461
4628
  * the texture, or if the texture is attached to a {@link Cogl.Offscreen}
4462
4629
  * framebuffer and rendered too.</note>
4463
4630
  * @returns `true` if the texture was successfully allocated, otherwise `false` and `error` will be updated if it wasn't `null`.
4631
+ * @throws GLib.Error
4464
4632
  */
4465
4633
  allocate(): boolean;
4466
4634
 
@@ -4472,6 +4640,7 @@ export namespace Cogl {
4472
4640
  * is {@link Cogl.TextureComponents.RGBA}. The other constructors which take
4473
4641
  * a %CoglBitmap or a data pointer default to the same components as
4474
4642
  * the pixel format of the data.
4643
+ * @since 1.18
4475
4644
  */
4476
4645
  get_components(): TextureComponents;
4477
4646
 
@@ -4518,6 +4687,7 @@ export namespace Cogl {
4518
4687
  *
4519
4688
  * By default the pre-multipled state is `TRUE`.
4520
4689
  * @returns `true` if red, green and blue components are internally stored pre-multiplied by the alpha value or `false` if not.
4690
+ * @since 1.18
4521
4691
  */
4522
4692
  get_premultiplied(): boolean;
4523
4693
 
@@ -4555,6 +4725,7 @@ export namespace Cogl {
4555
4725
  * an image format as long as {@link Cogl.TextureComponents.RG} isn't used
4556
4726
  * as the texture's components.
4557
4727
  * @param components
4728
+ * @since 1.18
4558
4729
  */
4559
4730
  set_components(components: TextureComponents): void;
4560
4731
 
@@ -4606,6 +4777,7 @@ export namespace Cogl {
4606
4777
  * @param data the source data, pointing to the first top-left pixel to set
4607
4778
  * @param level The mipmap level to update (Normally 0 for the largest, base texture)
4608
4779
  * @returns `true` if the data upload was successful, and `false` otherwise
4780
+ * @throws GLib.Error
4609
4781
  */
4610
4782
  set_data(format: PixelFormat, rowstride: number, data: Uint8Array | string, level: number): boolean;
4611
4783
 
@@ -4632,6 +4804,7 @@ export namespace Cogl {
4632
4804
  *
4633
4805
  * By default the `premultipled` state is `TRUE`.
4634
4806
  * @param premultiplied Whether any internally stored red, green or blue components are pre-multiplied by an alpha component.
4807
+ * @since 1.18
4635
4808
  */
4636
4809
  set_premultiplied(premultiplied: boolean): void;
4637
4810
 
@@ -4669,6 +4842,7 @@ export namespace Cogl {
4669
4842
  * @param dst_height height of destination region to write. (Must be less than or equal to the bitmap height)
4670
4843
  * @param bitmap The source bitmap to read from
4671
4844
  * @returns `true` if the subregion upload was successful, and `false` otherwise
4845
+ * @since 1.8
4672
4846
  */
4673
4847
  set_region_from_bitmap(src_x: number, src_y: number, dst_x: number, dst_y: number, dst_width: number, dst_height: number, bitmap: Bitmap): boolean;
4674
4848
  }
@@ -4697,6 +4871,7 @@ export namespace Cogl {
4697
4871
  * parameter, when using {@link Cogl.Color}<!-- -->s as keys in a {@link GLib.HashTable}.
4698
4872
  * @param v1 a {@link Cogl.Color}
4699
4873
  * @param v2 a {@link Cogl.Color}
4874
+ * @since 1.0
4700
4875
  */
4701
4876
  static equal(v1: null, v2: null): boolean;
4702
4877
 
@@ -4706,6 +4881,7 @@ export namespace Cogl {
4706
4881
  * @param hue hue value, in the 0 .. 360 range
4707
4882
  * @param saturation saturation value, in the 0 .. 1 range
4708
4883
  * @param luminance luminance value, in the 0 .. 1 range
4884
+ * @since 1.16
4709
4885
  */
4710
4886
  static init_from_hsl(hue: number, saturation: number, luminance: number): Color;
4711
4887
 
@@ -4713,11 +4889,13 @@ export namespace Cogl {
4713
4889
  /**
4714
4890
  * Creates a copy of `color`
4715
4891
  * @returns a newly-allocated {@link Cogl.Color}. Use `cogl_color_free()` to free the allocate resources
4892
+ * @since 1.0
4716
4893
  */
4717
4894
  copy(): Color;
4718
4895
 
4719
4896
  /**
4720
4897
  * Frees the resources allocated by `cogl_color_new()` and `cogl_color_copy()`
4898
+ * @since 1.0
4721
4899
  */
4722
4900
  free(): void;
4723
4901
 
@@ -4725,6 +4903,7 @@ export namespace Cogl {
4725
4903
  * Retrieves the alpha channel of `color` as a fixed point
4726
4904
  * value between 0 and 1.0.
4727
4905
  * @returns the alpha channel of the passed color
4906
+ * @since 1.0
4728
4907
  */
4729
4908
  get_alpha(): number;
4730
4909
 
@@ -4732,6 +4911,7 @@ export namespace Cogl {
4732
4911
  * Retrieves the alpha channel of `color` as a byte value
4733
4912
  * between 0 and 255
4734
4913
  * @returns the alpha channel of the passed color
4914
+ * @since 1.0
4735
4915
  */
4736
4916
  get_alpha_byte(): number;
4737
4917
 
@@ -4739,6 +4919,7 @@ export namespace Cogl {
4739
4919
  * Retrieves the alpha channel of `color` as a floating point
4740
4920
  * value between 0.0 and 1.0
4741
4921
  * @returns the alpha channel of the passed color
4922
+ * @since 1.0
4742
4923
  */
4743
4924
  get_alpha_float(): number;
4744
4925
 
@@ -4746,6 +4927,7 @@ export namespace Cogl {
4746
4927
  * Retrieves the blue channel of `color` as a fixed point
4747
4928
  * value between 0 and 1.0.
4748
4929
  * @returns the blue channel of the passed color
4930
+ * @since 1.0
4749
4931
  */
4750
4932
  get_blue(): number;
4751
4933
 
@@ -4753,6 +4935,7 @@ export namespace Cogl {
4753
4935
  * Retrieves the blue channel of `color` as a byte value
4754
4936
  * between 0 and 255
4755
4937
  * @returns the blue channel of the passed color
4938
+ * @since 1.0
4756
4939
  */
4757
4940
  get_blue_byte(): number;
4758
4941
 
@@ -4760,6 +4943,7 @@ export namespace Cogl {
4760
4943
  * Retrieves the blue channel of `color` as a floating point
4761
4944
  * value between 0.0 and 1.0
4762
4945
  * @returns the blue channel of the passed color
4946
+ * @since 1.0
4763
4947
  */
4764
4948
  get_blue_float(): number;
4765
4949
 
@@ -4767,6 +4951,7 @@ export namespace Cogl {
4767
4951
  * Retrieves the green channel of `color` as a fixed point
4768
4952
  * value between 0 and 1.0.
4769
4953
  * @returns the green channel of the passed color
4954
+ * @since 1.0
4770
4955
  */
4771
4956
  get_green(): number;
4772
4957
 
@@ -4774,6 +4959,7 @@ export namespace Cogl {
4774
4959
  * Retrieves the green channel of `color` as a byte value
4775
4960
  * between 0 and 255
4776
4961
  * @returns the green channel of the passed color
4962
+ * @since 1.0
4777
4963
  */
4778
4964
  get_green_byte(): number;
4779
4965
 
@@ -4781,6 +4967,7 @@ export namespace Cogl {
4781
4967
  * Retrieves the green channel of `color` as a floating point
4782
4968
  * value between 0.0 and 1.0
4783
4969
  * @returns the green channel of the passed color
4970
+ * @since 1.0
4784
4971
  */
4785
4972
  get_green_float(): number;
4786
4973
 
@@ -4788,6 +4975,7 @@ export namespace Cogl {
4788
4975
  * Retrieves the red channel of `color` as a fixed point
4789
4976
  * value between 0 and 1.0.
4790
4977
  * @returns the red channel of the passed color
4978
+ * @since 1.0
4791
4979
  */
4792
4980
  get_red(): number;
4793
4981
 
@@ -4795,6 +4983,7 @@ export namespace Cogl {
4795
4983
  * Retrieves the red channel of `color` as a byte value
4796
4984
  * between 0 and 255
4797
4985
  * @returns the red channel of the passed color
4986
+ * @since 1.0
4798
4987
  */
4799
4988
  get_red_byte(): number;
4800
4989
 
@@ -4802,6 +4991,7 @@ export namespace Cogl {
4802
4991
  * Retrieves the red channel of `color` as a floating point
4803
4992
  * value between 0.0 and 1.0
4804
4993
  * @returns the red channel of the passed color
4994
+ * @since 1.0
4805
4995
  */
4806
4996
  get_red_float(): number;
4807
4997
 
@@ -4811,12 +5001,14 @@ export namespace Cogl {
4811
5001
  * @param green value of the green channel, between 0 and 1.0
4812
5002
  * @param blue value of the blue channel, between 0 and 1.0
4813
5003
  * @param alpha value of the alpha channel, between 0 and 1.0
5004
+ * @since 1.4
4814
5005
  */
4815
5006
  init_from_4f(red: number, green: number, blue: number, alpha: number): void;
4816
5007
 
4817
5008
  /**
4818
5009
  * Sets the values of the passed channels into a {@link Cogl.Color}
4819
5010
  * @param color_array a pointer to an array of 4 float color components
5011
+ * @since 1.4
4820
5012
  */
4821
5013
  init_from_4fv(color_array: number): void;
4822
5014
 
@@ -4826,6 +5018,7 @@ export namespace Cogl {
4826
5018
  * @param green value of the green channel, between 0 and 255
4827
5019
  * @param blue value of the blue channel, between 0 and 255
4828
5020
  * @param alpha value of the alpha channel, between 0 and 255
5021
+ * @since 1.4
4829
5022
  */
4830
5023
  init_from_4ub(red: number, green: number, blue: number, alpha: number): void;
4831
5024
 
@@ -4833,78 +5026,91 @@ export namespace Cogl {
4833
5026
  * Converts a non-premultiplied color to a pre-multiplied color. For
4834
5027
  * example, semi-transparent red is (1.0, 0, 0, 0.5) when non-premultiplied
4835
5028
  * and (0.5, 0, 0, 0.5) when premultiplied.
5029
+ * @since 1.0
4836
5030
  */
4837
5031
  premultiply(): void;
4838
5032
 
4839
5033
  /**
4840
5034
  * Sets the alpha channel of `color` to `alpha`.
4841
5035
  * @param alpha a float value between 0.0f and 1.0f
5036
+ * @since 1.4
4842
5037
  */
4843
5038
  set_alpha(alpha: number): void;
4844
5039
 
4845
5040
  /**
4846
5041
  * Sets the alpha channel of `color` to `alpha`.
4847
5042
  * @param alpha a byte value between 0 and 255
5043
+ * @since 1.4
4848
5044
  */
4849
5045
  set_alpha_byte(alpha: number): void;
4850
5046
 
4851
5047
  /**
4852
5048
  * Sets the alpha channel of `color` to `alpha`.
4853
5049
  * @param alpha a float value between 0.0f and 1.0f
5050
+ * @since 1.4
4854
5051
  */
4855
5052
  set_alpha_float(alpha: number): void;
4856
5053
 
4857
5054
  /**
4858
5055
  * Sets the blue channel of `color` to `blue`.
4859
5056
  * @param blue a float value between 0.0f and 1.0f
5057
+ * @since 1.4
4860
5058
  */
4861
5059
  set_blue(blue: number): void;
4862
5060
 
4863
5061
  /**
4864
5062
  * Sets the blue channel of `color` to `blue`.
4865
5063
  * @param blue a byte value between 0 and 255
5064
+ * @since 1.4
4866
5065
  */
4867
5066
  set_blue_byte(blue: number): void;
4868
5067
 
4869
5068
  /**
4870
5069
  * Sets the blue channel of `color` to `blue`.
4871
5070
  * @param blue a float value between 0.0f and 1.0f
5071
+ * @since 1.4
4872
5072
  */
4873
5073
  set_blue_float(blue: number): void;
4874
5074
 
4875
5075
  /**
4876
5076
  * Sets the green channel of `color` to `green`.
4877
5077
  * @param green a float value between 0.0f and 1.0f
5078
+ * @since 1.4
4878
5079
  */
4879
5080
  set_green(green: number): void;
4880
5081
 
4881
5082
  /**
4882
5083
  * Sets the green channel of `color` to `green`.
4883
5084
  * @param green a byte value between 0 and 255
5085
+ * @since 1.4
4884
5086
  */
4885
5087
  set_green_byte(green: number): void;
4886
5088
 
4887
5089
  /**
4888
5090
  * Sets the green channel of `color` to `green`.
4889
5091
  * @param green a float value between 0.0f and 1.0f
5092
+ * @since 1.4
4890
5093
  */
4891
5094
  set_green_float(green: number): void;
4892
5095
 
4893
5096
  /**
4894
5097
  * Sets the red channel of `color` to `red`.
4895
5098
  * @param red a float value between 0.0f and 1.0f
5099
+ * @since 1.4
4896
5100
  */
4897
5101
  set_red(red: number): void;
4898
5102
 
4899
5103
  /**
4900
5104
  * Sets the red channel of `color` to `red`.
4901
5105
  * @param red a byte value between 0 and 255
5106
+ * @since 1.4
4902
5107
  */
4903
5108
  set_red_byte(red: number): void;
4904
5109
 
4905
5110
  /**
4906
5111
  * Sets the red channel of `color` to `red`.
4907
5112
  * @param red a float value between 0.0f and 1.0f
5113
+ * @since 1.4
4908
5114
  */
4909
5115
  set_red_float(red: number): void;
4910
5116
 
@@ -4913,6 +5119,7 @@ export namespace Cogl {
4913
5119
  *
4914
5120
  * The `hue` value is in the 0 .. 360 range. The `luminance` and
4915
5121
  * `saturation` values are in the 0 .. 1 range.
5122
+ * @since 1.16
4916
5123
  */
4917
5124
  to_hsl(): [number, number, number];
4918
5125
 
@@ -4920,6 +5127,7 @@ export namespace Cogl {
4920
5127
  * Converts a pre-multiplied color to a non-premultiplied color. For
4921
5128
  * example, semi-transparent red is (0.5, 0, 0, 0.5) when premultiplied
4922
5129
  * and (1.0, 0, 0, 0.5) when non-premultiplied.
5130
+ * @since 1.4
4923
5131
  */
4924
5132
  unpremultiply(): void;
4925
5133
  }
@@ -5182,6 +5390,7 @@ export namespace Cogl {
5182
5390
  * the texture, or if the texture is attached to a {@link Cogl.Offscreen}
5183
5391
  * framebuffer and rendered too.</note>
5184
5392
  * @returns `true` if the texture was successfully allocated, otherwise `false` and `error` will be updated if it wasn't `null`.
5393
+ * @throws GLib.Error
5185
5394
  */
5186
5395
  allocate(): boolean;
5187
5396
 
@@ -5193,6 +5402,7 @@ export namespace Cogl {
5193
5402
  * is {@link Cogl.TextureComponents.RGBA}. The other constructors which take
5194
5403
  * a %CoglBitmap or a data pointer default to the same components as
5195
5404
  * the pixel format of the data.
5405
+ * @since 1.18
5196
5406
  */
5197
5407
  get_components(): TextureComponents;
5198
5408
 
@@ -5239,6 +5449,7 @@ export namespace Cogl {
5239
5449
  *
5240
5450
  * By default the pre-multipled state is `TRUE`.
5241
5451
  * @returns `true` if red, green and blue components are internally stored pre-multiplied by the alpha value or `false` if not.
5452
+ * @since 1.18
5242
5453
  */
5243
5454
  get_premultiplied(): boolean;
5244
5455
 
@@ -5276,6 +5487,7 @@ export namespace Cogl {
5276
5487
  * an image format as long as {@link Cogl.TextureComponents.RG} isn't used
5277
5488
  * as the texture's components.
5278
5489
  * @param components
5490
+ * @since 1.18
5279
5491
  */
5280
5492
  set_components(components: TextureComponents): void;
5281
5493
 
@@ -5327,6 +5539,7 @@ export namespace Cogl {
5327
5539
  * @param data the source data, pointing to the first top-left pixel to set
5328
5540
  * @param level The mipmap level to update (Normally 0 for the largest, base texture)
5329
5541
  * @returns `true` if the data upload was successful, and `false` otherwise
5542
+ * @throws GLib.Error
5330
5543
  */
5331
5544
  set_data(format: PixelFormat, rowstride: number, data: Uint8Array | string, level: number): boolean;
5332
5545
 
@@ -5353,6 +5566,7 @@ export namespace Cogl {
5353
5566
  *
5354
5567
  * By default the `premultipled` state is `TRUE`.
5355
5568
  * @param premultiplied Whether any internally stored red, green or blue components are pre-multiplied by an alpha component.
5569
+ * @since 1.18
5356
5570
  */
5357
5571
  set_premultiplied(premultiplied: boolean): void;
5358
5572
 
@@ -5390,6 +5604,7 @@ export namespace Cogl {
5390
5604
  * @param dst_height height of destination region to write. (Must be less than or equal to the bitmap height)
5391
5605
  * @param bitmap The source bitmap to read from
5392
5606
  * @returns `true` if the subregion upload was successful, and `false` otherwise
5607
+ * @since 1.8
5393
5608
  */
5394
5609
  set_region_from_bitmap(src_x: number, src_y: number, dst_x: number, dst_y: number, dst_width: number, dst_height: number, bitmap: Bitmap): boolean;
5395
5610
  }