@girs/meta-3 4.3.0 → 4.4.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 +1 -1
  2. package/meta-3.d.ts +313 -0
  3. package/package.json +23 -23
package/meta-3.d.ts CHANGED
@@ -2403,6 +2403,7 @@ export namespace Meta {
2403
2403
  * instance.
2404
2404
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
2405
2405
  * @returns `true` if successful. If an error has occurred, this function will return `false` and set `error` appropriately if present.
2406
+ * @since 2.22
2406
2407
  */
2407
2408
  init(cancellable: Gio.Cancellable | null): boolean;
2408
2409
 
@@ -2446,6 +2447,7 @@ export namespace Meta {
2446
2447
  * on the result of `g_object_new()`, regardless of whether it is in fact a new
2447
2448
  * instance.
2448
2449
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
2450
+ * @since 2.22
2449
2451
  * @virtual
2450
2452
  */
2451
2453
  vfunc_init(cancellable: Gio.Cancellable | null): boolean;
@@ -2792,6 +2794,8 @@ export namespace Meta {
2792
2794
  * @param progress the progress factor
2793
2795
  * @param value return location for the animation value
2794
2796
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
2797
+ * @since 1.0
2798
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
2795
2799
  */
2796
2800
  animate_property(animation: Clutter.Animation, property_name: string, initial_value: GObject.Value | any, final_value: GObject.Value | any, progress: number, value: GObject.Value | any): boolean;
2797
2801
 
@@ -2799,6 +2803,7 @@ export namespace Meta {
2799
2803
  * Finds the {@link GObject.ParamSpec} for `property_name`
2800
2804
  * @param property_name the name of the animatable property to find
2801
2805
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
2806
+ * @since 1.4
2802
2807
  */
2803
2808
  find_property(property_name: string): GObject.ParamSpec;
2804
2809
 
@@ -2806,6 +2811,7 @@ export namespace Meta {
2806
2811
  * Retrieves the current state of `property_name` and sets `value` with it
2807
2812
  * @param property_name the name of the animatable property to retrieve
2808
2813
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
2814
+ * @since 1.4
2809
2815
  */
2810
2816
  get_initial_state(property_name: string, value: GObject.Value | any): void;
2811
2817
 
@@ -2823,6 +2829,7 @@ export namespace Meta {
2823
2829
  * @param interval a {@link Clutter.Interval} with the animation range
2824
2830
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
2825
2831
  * @returns `true` if the interpolation was successful, and `false` otherwise
2832
+ * @since 1.8
2826
2833
  */
2827
2834
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
2828
2835
 
@@ -2830,6 +2837,7 @@ export namespace Meta {
2830
2837
  * Sets the current state of `property_name` to `value`
2831
2838
  * @param property_name the name of the animatable property to set
2832
2839
  * @param value the value of the animatable property to set
2840
+ * @since 1.4
2833
2841
  */
2834
2842
  set_final_state(property_name: string, value: GObject.Value | any): void;
2835
2843
 
@@ -2848,6 +2856,8 @@ export namespace Meta {
2848
2856
  * @param final_value the final value of the animation interval
2849
2857
  * @param progress the progress factor
2850
2858
  * @param value return location for the animation value
2859
+ * @since 1.0
2860
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
2851
2861
  * @virtual
2852
2862
  */
2853
2863
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -2855,6 +2865,7 @@ export namespace Meta {
2855
2865
  /**
2856
2866
  * Finds the {@link GObject.ParamSpec} for `property_name`
2857
2867
  * @param property_name the name of the animatable property to find
2868
+ * @since 1.4
2858
2869
  * @virtual
2859
2870
  */
2860
2871
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -2863,6 +2874,7 @@ export namespace Meta {
2863
2874
  * Retrieves the current state of `property_name` and sets `value` with it
2864
2875
  * @param property_name the name of the animatable property to retrieve
2865
2876
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
2877
+ * @since 1.4
2866
2878
  * @virtual
2867
2879
  */
2868
2880
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -2880,6 +2892,7 @@ export namespace Meta {
2880
2892
  * @param property_name the name of the property to interpolate
2881
2893
  * @param interval a {@link Clutter.Interval} with the animation range
2882
2894
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
2895
+ * @since 1.8
2883
2896
  * @virtual
2884
2897
  */
2885
2898
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -2888,6 +2901,7 @@ export namespace Meta {
2888
2901
  * Sets the current state of `property_name` to `value`
2889
2902
  * @param property_name the name of the animatable property to set
2890
2903
  * @param value the value of the animatable property to set
2904
+ * @since 1.4
2891
2905
  * @virtual
2892
2906
  */
2893
2907
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -2902,6 +2916,8 @@ export namespace Meta {
2902
2916
  * deprecated virtual function. The default implementation will
2903
2917
  * call `clutter_actor_add_child()`.
2904
2918
  * @param actor the first {@link Clutter.Actor} to add
2919
+ * @since 0.4
2920
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
2905
2921
  */
2906
2922
  add_actor(actor: Clutter.Actor): void;
2907
2923
 
@@ -2916,6 +2932,7 @@ export namespace Meta {
2916
2932
  * @param child a {@link Clutter.Actor} that is a child of `container`.
2917
2933
  * @param property the name of the property to set.
2918
2934
  * @param value the value.
2935
+ * @since 0.8
2919
2936
  */
2920
2937
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
2921
2938
 
@@ -2925,6 +2942,7 @@ export namespace Meta {
2925
2942
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
2926
2943
  * @param child a {@link Clutter.Actor}
2927
2944
  * @param pspec a {@link GObject.ParamSpec}
2945
+ * @since 1.6
2928
2946
  */
2929
2947
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
2930
2948
 
@@ -2933,6 +2951,7 @@ export namespace Meta {
2933
2951
  * @param child a {@link Clutter.Actor} that is a child of `container`.
2934
2952
  * @param property the name of the property to set.
2935
2953
  * @param value the value.
2954
+ * @since 0.8
2936
2955
  */
2937
2956
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
2938
2957
 
@@ -2947,6 +2966,7 @@ export namespace Meta {
2947
2966
  *
2948
2967
  * Applications should not call this function.
2949
2968
  * @param actor a {@link Clutter.Actor}
2969
+ * @since 1.2
2950
2970
  */
2951
2971
  create_child_meta(actor: Clutter.Actor): void;
2952
2972
 
@@ -2960,6 +2980,7 @@ export namespace Meta {
2960
2980
  *
2961
2981
  * Applications should not call this function.
2962
2982
  * @param actor a {@link Clutter.Actor}
2983
+ * @since 1.2
2963
2984
  */
2964
2985
  destroy_child_meta(actor: Clutter.Actor): void;
2965
2986
 
@@ -2968,6 +2989,7 @@ export namespace Meta {
2968
2989
  * into any child container.
2969
2990
  * @param child_name the name of the requested child.
2970
2991
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
2992
+ * @since 0.6
2971
2993
  */
2972
2994
  find_child_by_name(child_name: string): Clutter.Actor;
2973
2995
 
@@ -2980,6 +3002,8 @@ export namespace Meta {
2980
3002
  * This function calls the {@link Clutter.ContainerIface}.foreach()
2981
3003
  * virtual function, which has been deprecated.
2982
3004
  * @param callback a function to be called for each child
3005
+ * @since 0.4
3006
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
2983
3007
  */
2984
3008
  foreach(callback: Clutter.Callback): void;
2985
3009
 
@@ -2991,6 +3015,8 @@ export namespace Meta {
2991
3015
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
2992
3016
  * virtual function, which has been deprecated.
2993
3017
  * @param callback a function to be called for each child
3018
+ * @since 1.0
3019
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
2994
3020
  */
2995
3021
  foreach_with_internals(callback: Clutter.Callback): void;
2996
3022
 
@@ -2999,12 +3025,15 @@ export namespace Meta {
2999
3025
  * `container` specific state for `actor`.
3000
3026
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3001
3027
  * @returns the {@link Clutter.ChildMeta} for the `actor` child of `container` or `null` if the specifiec actor does not exist or the container is not configured to provide {@link Clutter.ChildMeta}<!-- -->s
3028
+ * @since 0.8
3002
3029
  */
3003
3030
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
3004
3031
 
3005
3032
  /**
3006
3033
  * Retrieves all the children of `container`.
3007
3034
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
3035
+ * @since 0.4
3036
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
3008
3037
  */
3009
3038
  get_children(): Clutter.Actor[];
3010
3039
 
@@ -3016,6 +3045,8 @@ export namespace Meta {
3016
3045
  * `clutter_actor_set_child_below_sibling()`.
3017
3046
  * @param actor the actor to raise
3018
3047
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3048
+ * @since 0.6
3049
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3019
3050
  */
3020
3051
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3021
3052
 
@@ -3027,6 +3058,8 @@ export namespace Meta {
3027
3058
  * `clutter_actor_set_child_above_sibling()`.
3028
3059
  * @param actor the actor to raise
3029
3060
  * @param sibling the sibling to raise to, or `null` to raise to the top
3061
+ * @since 0.6
3062
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3030
3063
  */
3031
3064
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3032
3065
 
@@ -3040,12 +3073,16 @@ export namespace Meta {
3040
3073
  * deprecated virtual function. The default implementation will call
3041
3074
  * `clutter_actor_remove_child()`.
3042
3075
  * @param actor a {@link Clutter.Actor}
3076
+ * @since 0.4
3077
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3043
3078
  */
3044
3079
  remove_actor(actor: Clutter.Actor): void;
3045
3080
 
3046
3081
  /**
3047
3082
  * Sorts a container's children using their depth. This function should not
3048
3083
  * be normally used by applications.
3084
+ * @since 0.6
3085
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
3049
3086
  */
3050
3087
  sort_depth_order(): void;
3051
3088
 
@@ -3071,6 +3108,8 @@ export namespace Meta {
3071
3108
  * deprecated virtual function. The default implementation will
3072
3109
  * call `clutter_actor_add_child()`.
3073
3110
  * @param actor the first {@link Clutter.Actor} to add
3111
+ * @since 0.4
3112
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
3074
3113
  * @virtual
3075
3114
  */
3076
3115
  vfunc_add(actor: Clutter.Actor): void;
@@ -3081,6 +3120,7 @@ export namespace Meta {
3081
3120
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
3082
3121
  * @param child a {@link Clutter.Actor}
3083
3122
  * @param pspec a {@link GObject.ParamSpec}
3123
+ * @since 1.6
3084
3124
  * @virtual
3085
3125
  */
3086
3126
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -3096,6 +3136,7 @@ export namespace Meta {
3096
3136
  *
3097
3137
  * Applications should not call this function.
3098
3138
  * @param actor a {@link Clutter.Actor}
3139
+ * @since 1.2
3099
3140
  * @virtual
3100
3141
  */
3101
3142
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -3110,6 +3151,7 @@ export namespace Meta {
3110
3151
  *
3111
3152
  * Applications should not call this function.
3112
3153
  * @param actor a {@link Clutter.Actor}
3154
+ * @since 1.2
3113
3155
  * @virtual
3114
3156
  */
3115
3157
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -3123,6 +3165,8 @@ export namespace Meta {
3123
3165
  * This function calls the {@link Clutter.ContainerIface}.foreach()
3124
3166
  * virtual function, which has been deprecated.
3125
3167
  * @param callback a function to be called for each child
3168
+ * @since 0.4
3169
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
3126
3170
  * @virtual
3127
3171
  */
3128
3172
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -3135,6 +3179,8 @@ export namespace Meta {
3135
3179
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
3136
3180
  * virtual function, which has been deprecated.
3137
3181
  * @param callback a function to be called for each child
3182
+ * @since 1.0
3183
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
3138
3184
  * @virtual
3139
3185
  */
3140
3186
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -3143,6 +3189,7 @@ export namespace Meta {
3143
3189
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
3144
3190
  * `container` specific state for `actor`.
3145
3191
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3192
+ * @since 0.8
3146
3193
  * @virtual
3147
3194
  */
3148
3195
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -3155,6 +3202,8 @@ export namespace Meta {
3155
3202
  * `clutter_actor_set_child_below_sibling()`.
3156
3203
  * @param actor the actor to raise
3157
3204
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3205
+ * @since 0.6
3206
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3158
3207
  * @virtual
3159
3208
  */
3160
3209
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3167,6 +3216,8 @@ export namespace Meta {
3167
3216
  * `clutter_actor_set_child_above_sibling()`.
3168
3217
  * @param actor the actor to raise
3169
3218
  * @param sibling the sibling to raise to, or `null` to raise to the top
3219
+ * @since 0.6
3220
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3170
3221
  * @virtual
3171
3222
  */
3172
3223
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3181,6 +3232,8 @@ export namespace Meta {
3181
3232
  * deprecated virtual function. The default implementation will call
3182
3233
  * `clutter_actor_remove_child()`.
3183
3234
  * @param actor a {@link Clutter.Actor}
3235
+ * @since 0.4
3236
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3184
3237
  * @virtual
3185
3238
  */
3186
3239
  vfunc_remove(actor: Clutter.Actor): void;
@@ -3188,6 +3241,8 @@ export namespace Meta {
3188
3241
  /**
3189
3242
  * Sorts a container's children using their depth. This function should not
3190
3243
  * be normally used by applications.
3244
+ * @since 0.6
3245
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
3191
3246
  * @virtual
3192
3247
  */
3193
3248
  vfunc_sort_depth_order(): void;
@@ -3195,6 +3250,7 @@ export namespace Meta {
3195
3250
  /**
3196
3251
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3197
3252
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
3253
+ * @since 0.6
3198
3254
  */
3199
3255
  get_id(): string;
3200
3256
 
@@ -3206,6 +3262,7 @@ export namespace Meta {
3206
3262
  * @param name the name of the node
3207
3263
  * @param node the JSON node to be parsed
3208
3264
  * @returns `true` if the node was successfully parsed, `false` otherwise.
3265
+ * @since 0.6
3209
3266
  */
3210
3267
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
3211
3268
 
@@ -3215,6 +3272,7 @@ export namespace Meta {
3215
3272
  * @param script the {@link Clutter.Script} creating the scriptable instance
3216
3273
  * @param name the name of the property
3217
3274
  * @param value the value of the property
3275
+ * @since 0.6
3218
3276
  */
3219
3277
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
3220
3278
 
@@ -3226,11 +3284,13 @@ export namespace Meta {
3226
3284
  * define a unique name for an object constructable using the UI
3227
3285
  * definition language parsed by {@link Clutter.Script}.
3228
3286
  * @param id_ the {@link Clutter.Script} id of the object
3287
+ * @since 0.6
3229
3288
  */
3230
3289
  set_id(id_: string): void;
3231
3290
 
3232
3291
  /**
3233
3292
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3293
+ * @since 0.6
3234
3294
  * @virtual
3235
3295
  */
3236
3296
  vfunc_get_id(): string;
@@ -3242,6 +3302,7 @@ export namespace Meta {
3242
3302
  * @param value the generic value to be set
3243
3303
  * @param name the name of the node
3244
3304
  * @param node the JSON node to be parsed
3305
+ * @since 0.6
3245
3306
  * @virtual
3246
3307
  */
3247
3308
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -3252,6 +3313,7 @@ export namespace Meta {
3252
3313
  * @param script the {@link Clutter.Script} creating the scriptable instance
3253
3314
  * @param name the name of the property
3254
3315
  * @param value the value of the property
3316
+ * @since 0.6
3255
3317
  * @virtual
3256
3318
  */
3257
3319
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -3264,6 +3326,7 @@ export namespace Meta {
3264
3326
  * define a unique name for an object constructable using the UI
3265
3327
  * definition language parsed by {@link Clutter.Script}.
3266
3328
  * @param id_ the {@link Clutter.Script} id of the object
3329
+ * @since 0.6
3267
3330
  * @virtual
3268
3331
  */
3269
3332
  vfunc_set_id(id_: string): void;
@@ -3411,6 +3474,8 @@ export namespace Meta {
3411
3474
  * @param progress the progress factor
3412
3475
  * @param value return location for the animation value
3413
3476
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
3477
+ * @since 1.0
3478
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
3414
3479
  */
3415
3480
  animate_property(animation: Clutter.Animation, property_name: string, initial_value: GObject.Value | any, final_value: GObject.Value | any, progress: number, value: GObject.Value | any): boolean;
3416
3481
 
@@ -3418,6 +3483,7 @@ export namespace Meta {
3418
3483
  * Finds the {@link GObject.ParamSpec} for `property_name`
3419
3484
  * @param property_name the name of the animatable property to find
3420
3485
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
3486
+ * @since 1.4
3421
3487
  */
3422
3488
  find_property(property_name: string): GObject.ParamSpec;
3423
3489
 
@@ -3425,6 +3491,7 @@ export namespace Meta {
3425
3491
  * Retrieves the current state of `property_name` and sets `value` with it
3426
3492
  * @param property_name the name of the animatable property to retrieve
3427
3493
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
3494
+ * @since 1.4
3428
3495
  */
3429
3496
  get_initial_state(property_name: string, value: GObject.Value | any): void;
3430
3497
 
@@ -3442,6 +3509,7 @@ export namespace Meta {
3442
3509
  * @param interval a {@link Clutter.Interval} with the animation range
3443
3510
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
3444
3511
  * @returns `true` if the interpolation was successful, and `false` otherwise
3512
+ * @since 1.8
3445
3513
  */
3446
3514
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
3447
3515
 
@@ -3449,6 +3517,7 @@ export namespace Meta {
3449
3517
  * Sets the current state of `property_name` to `value`
3450
3518
  * @param property_name the name of the animatable property to set
3451
3519
  * @param value the value of the animatable property to set
3520
+ * @since 1.4
3452
3521
  */
3453
3522
  set_final_state(property_name: string, value: GObject.Value | any): void;
3454
3523
 
@@ -3467,6 +3536,8 @@ export namespace Meta {
3467
3536
  * @param final_value the final value of the animation interval
3468
3537
  * @param progress the progress factor
3469
3538
  * @param value return location for the animation value
3539
+ * @since 1.0
3540
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
3470
3541
  * @virtual
3471
3542
  */
3472
3543
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -3474,6 +3545,7 @@ export namespace Meta {
3474
3545
  /**
3475
3546
  * Finds the {@link GObject.ParamSpec} for `property_name`
3476
3547
  * @param property_name the name of the animatable property to find
3548
+ * @since 1.4
3477
3549
  * @virtual
3478
3550
  */
3479
3551
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -3482,6 +3554,7 @@ export namespace Meta {
3482
3554
  * Retrieves the current state of `property_name` and sets `value` with it
3483
3555
  * @param property_name the name of the animatable property to retrieve
3484
3556
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
3557
+ * @since 1.4
3485
3558
  * @virtual
3486
3559
  */
3487
3560
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -3499,6 +3572,7 @@ export namespace Meta {
3499
3572
  * @param property_name the name of the property to interpolate
3500
3573
  * @param interval a {@link Clutter.Interval} with the animation range
3501
3574
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
3575
+ * @since 1.8
3502
3576
  * @virtual
3503
3577
  */
3504
3578
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -3507,6 +3581,7 @@ export namespace Meta {
3507
3581
  * Sets the current state of `property_name` to `value`
3508
3582
  * @param property_name the name of the animatable property to set
3509
3583
  * @param value the value of the animatable property to set
3584
+ * @since 1.4
3510
3585
  * @virtual
3511
3586
  */
3512
3587
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -3521,6 +3596,8 @@ export namespace Meta {
3521
3596
  * deprecated virtual function. The default implementation will
3522
3597
  * call `clutter_actor_add_child()`.
3523
3598
  * @param actor the first {@link Clutter.Actor} to add
3599
+ * @since 0.4
3600
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
3524
3601
  */
3525
3602
  add_actor(actor: Clutter.Actor): void;
3526
3603
 
@@ -3535,6 +3612,7 @@ export namespace Meta {
3535
3612
  * @param child a {@link Clutter.Actor} that is a child of `container`.
3536
3613
  * @param property the name of the property to set.
3537
3614
  * @param value the value.
3615
+ * @since 0.8
3538
3616
  */
3539
3617
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
3540
3618
 
@@ -3544,6 +3622,7 @@ export namespace Meta {
3544
3622
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
3545
3623
  * @param child a {@link Clutter.Actor}
3546
3624
  * @param pspec a {@link GObject.ParamSpec}
3625
+ * @since 1.6
3547
3626
  */
3548
3627
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
3549
3628
 
@@ -3552,6 +3631,7 @@ export namespace Meta {
3552
3631
  * @param child a {@link Clutter.Actor} that is a child of `container`.
3553
3632
  * @param property the name of the property to set.
3554
3633
  * @param value the value.
3634
+ * @since 0.8
3555
3635
  */
3556
3636
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
3557
3637
 
@@ -3566,6 +3646,7 @@ export namespace Meta {
3566
3646
  *
3567
3647
  * Applications should not call this function.
3568
3648
  * @param actor a {@link Clutter.Actor}
3649
+ * @since 1.2
3569
3650
  */
3570
3651
  create_child_meta(actor: Clutter.Actor): void;
3571
3652
 
@@ -3579,6 +3660,7 @@ export namespace Meta {
3579
3660
  *
3580
3661
  * Applications should not call this function.
3581
3662
  * @param actor a {@link Clutter.Actor}
3663
+ * @since 1.2
3582
3664
  */
3583
3665
  destroy_child_meta(actor: Clutter.Actor): void;
3584
3666
 
@@ -3587,6 +3669,7 @@ export namespace Meta {
3587
3669
  * into any child container.
3588
3670
  * @param child_name the name of the requested child.
3589
3671
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
3672
+ * @since 0.6
3590
3673
  */
3591
3674
  find_child_by_name(child_name: string): Clutter.Actor;
3592
3675
 
@@ -3599,6 +3682,8 @@ export namespace Meta {
3599
3682
  * This function calls the {@link Clutter.ContainerIface}.foreach()
3600
3683
  * virtual function, which has been deprecated.
3601
3684
  * @param callback a function to be called for each child
3685
+ * @since 0.4
3686
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
3602
3687
  */
3603
3688
  foreach(callback: Clutter.Callback): void;
3604
3689
 
@@ -3610,6 +3695,8 @@ export namespace Meta {
3610
3695
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
3611
3696
  * virtual function, which has been deprecated.
3612
3697
  * @param callback a function to be called for each child
3698
+ * @since 1.0
3699
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
3613
3700
  */
3614
3701
  foreach_with_internals(callback: Clutter.Callback): void;
3615
3702
 
@@ -3618,12 +3705,15 @@ export namespace Meta {
3618
3705
  * `container` specific state for `actor`.
3619
3706
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3620
3707
  * @returns the {@link Clutter.ChildMeta} for the `actor` child of `container` or `null` if the specifiec actor does not exist or the container is not configured to provide {@link Clutter.ChildMeta}<!-- -->s
3708
+ * @since 0.8
3621
3709
  */
3622
3710
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
3623
3711
 
3624
3712
  /**
3625
3713
  * Retrieves all the children of `container`.
3626
3714
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
3715
+ * @since 0.4
3716
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
3627
3717
  */
3628
3718
  get_children(): Clutter.Actor[];
3629
3719
 
@@ -3635,6 +3725,8 @@ export namespace Meta {
3635
3725
  * `clutter_actor_set_child_below_sibling()`.
3636
3726
  * @param actor the actor to raise
3637
3727
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3728
+ * @since 0.6
3729
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3638
3730
  */
3639
3731
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3640
3732
 
@@ -3646,6 +3738,8 @@ export namespace Meta {
3646
3738
  * `clutter_actor_set_child_above_sibling()`.
3647
3739
  * @param actor the actor to raise
3648
3740
  * @param sibling the sibling to raise to, or `null` to raise to the top
3741
+ * @since 0.6
3742
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3649
3743
  */
3650
3744
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3651
3745
 
@@ -3659,12 +3753,16 @@ export namespace Meta {
3659
3753
  * deprecated virtual function. The default implementation will call
3660
3754
  * `clutter_actor_remove_child()`.
3661
3755
  * @param actor a {@link Clutter.Actor}
3756
+ * @since 0.4
3757
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3662
3758
  */
3663
3759
  remove_actor(actor: Clutter.Actor): void;
3664
3760
 
3665
3761
  /**
3666
3762
  * Sorts a container's children using their depth. This function should not
3667
3763
  * be normally used by applications.
3764
+ * @since 0.6
3765
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
3668
3766
  */
3669
3767
  sort_depth_order(): void;
3670
3768
 
@@ -3690,6 +3788,8 @@ export namespace Meta {
3690
3788
  * deprecated virtual function. The default implementation will
3691
3789
  * call `clutter_actor_add_child()`.
3692
3790
  * @param actor the first {@link Clutter.Actor} to add
3791
+ * @since 0.4
3792
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
3693
3793
  * @virtual
3694
3794
  */
3695
3795
  vfunc_add(actor: Clutter.Actor): void;
@@ -3700,6 +3800,7 @@ export namespace Meta {
3700
3800
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
3701
3801
  * @param child a {@link Clutter.Actor}
3702
3802
  * @param pspec a {@link GObject.ParamSpec}
3803
+ * @since 1.6
3703
3804
  * @virtual
3704
3805
  */
3705
3806
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -3715,6 +3816,7 @@ export namespace Meta {
3715
3816
  *
3716
3817
  * Applications should not call this function.
3717
3818
  * @param actor a {@link Clutter.Actor}
3819
+ * @since 1.2
3718
3820
  * @virtual
3719
3821
  */
3720
3822
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -3729,6 +3831,7 @@ export namespace Meta {
3729
3831
  *
3730
3832
  * Applications should not call this function.
3731
3833
  * @param actor a {@link Clutter.Actor}
3834
+ * @since 1.2
3732
3835
  * @virtual
3733
3836
  */
3734
3837
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -3742,6 +3845,8 @@ export namespace Meta {
3742
3845
  * This function calls the {@link Clutter.ContainerIface}.foreach()
3743
3846
  * virtual function, which has been deprecated.
3744
3847
  * @param callback a function to be called for each child
3848
+ * @since 0.4
3849
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
3745
3850
  * @virtual
3746
3851
  */
3747
3852
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -3754,6 +3859,8 @@ export namespace Meta {
3754
3859
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
3755
3860
  * virtual function, which has been deprecated.
3756
3861
  * @param callback a function to be called for each child
3862
+ * @since 1.0
3863
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
3757
3864
  * @virtual
3758
3865
  */
3759
3866
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -3762,6 +3869,7 @@ export namespace Meta {
3762
3869
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
3763
3870
  * `container` specific state for `actor`.
3764
3871
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3872
+ * @since 0.8
3765
3873
  * @virtual
3766
3874
  */
3767
3875
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -3774,6 +3882,8 @@ export namespace Meta {
3774
3882
  * `clutter_actor_set_child_below_sibling()`.
3775
3883
  * @param actor the actor to raise
3776
3884
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3885
+ * @since 0.6
3886
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3777
3887
  * @virtual
3778
3888
  */
3779
3889
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3786,6 +3896,8 @@ export namespace Meta {
3786
3896
  * `clutter_actor_set_child_above_sibling()`.
3787
3897
  * @param actor the actor to raise
3788
3898
  * @param sibling the sibling to raise to, or `null` to raise to the top
3899
+ * @since 0.6
3900
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3789
3901
  * @virtual
3790
3902
  */
3791
3903
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3800,6 +3912,8 @@ export namespace Meta {
3800
3912
  * deprecated virtual function. The default implementation will call
3801
3913
  * `clutter_actor_remove_child()`.
3802
3914
  * @param actor a {@link Clutter.Actor}
3915
+ * @since 0.4
3916
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3803
3917
  * @virtual
3804
3918
  */
3805
3919
  vfunc_remove(actor: Clutter.Actor): void;
@@ -3807,6 +3921,8 @@ export namespace Meta {
3807
3921
  /**
3808
3922
  * Sorts a container's children using their depth. This function should not
3809
3923
  * be normally used by applications.
3924
+ * @since 0.6
3925
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
3810
3926
  * @virtual
3811
3927
  */
3812
3928
  vfunc_sort_depth_order(): void;
@@ -3814,6 +3930,7 @@ export namespace Meta {
3814
3930
  /**
3815
3931
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3816
3932
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
3933
+ * @since 0.6
3817
3934
  */
3818
3935
  get_id(): string;
3819
3936
 
@@ -3825,6 +3942,7 @@ export namespace Meta {
3825
3942
  * @param name the name of the node
3826
3943
  * @param node the JSON node to be parsed
3827
3944
  * @returns `true` if the node was successfully parsed, `false` otherwise.
3945
+ * @since 0.6
3828
3946
  */
3829
3947
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
3830
3948
 
@@ -3834,6 +3952,7 @@ export namespace Meta {
3834
3952
  * @param script the {@link Clutter.Script} creating the scriptable instance
3835
3953
  * @param name the name of the property
3836
3954
  * @param value the value of the property
3955
+ * @since 0.6
3837
3956
  */
3838
3957
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
3839
3958
 
@@ -3845,11 +3964,13 @@ export namespace Meta {
3845
3964
  * define a unique name for an object constructable using the UI
3846
3965
  * definition language parsed by {@link Clutter.Script}.
3847
3966
  * @param id_ the {@link Clutter.Script} id of the object
3967
+ * @since 0.6
3848
3968
  */
3849
3969
  set_id(id_: string): void;
3850
3970
 
3851
3971
  /**
3852
3972
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3973
+ * @since 0.6
3853
3974
  * @virtual
3854
3975
  */
3855
3976
  vfunc_get_id(): string;
@@ -3861,6 +3982,7 @@ export namespace Meta {
3861
3982
  * @param value the generic value to be set
3862
3983
  * @param name the name of the node
3863
3984
  * @param node the JSON node to be parsed
3985
+ * @since 0.6
3864
3986
  * @virtual
3865
3987
  */
3866
3988
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -3871,6 +3993,7 @@ export namespace Meta {
3871
3993
  * @param script the {@link Clutter.Script} creating the scriptable instance
3872
3994
  * @param name the name of the property
3873
3995
  * @param value the value of the property
3996
+ * @since 0.6
3874
3997
  * @virtual
3875
3998
  */
3876
3999
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -3883,6 +4006,7 @@ export namespace Meta {
3883
4006
  * define a unique name for an object constructable using the UI
3884
4007
  * definition language parsed by {@link Clutter.Script}.
3885
4008
  * @param id_ the {@link Clutter.Script} id of the object
4009
+ * @since 0.6
3886
4010
  * @virtual
3887
4011
  */
3888
4012
  vfunc_set_id(id_: string): void;
@@ -4266,6 +4390,7 @@ export namespace Meta {
4266
4390
  /**
4267
4391
  * Gets the {@link Gio.DBusObject} that `interface_` belongs to, if any.
4268
4392
  * @returns A {@link Gio.DBusObject} or `null`. The returned reference should be freed with `g_object_unref()`.
4393
+ * @since 2.32
4269
4394
  */
4270
4395
  get_object(): Gio.DBusObject | null;
4271
4396
 
@@ -4278,6 +4403,7 @@ export namespace Meta {
4278
4403
  * For example, {@link Gio.DBusProxy} implements {@link Gio.DBusInterface} but allows for a `null`
4279
4404
  * {@link Gio.DBusInterfaceInfo}.
4280
4405
  * @returns A {@link Gio.DBusInterfaceInfo}. Do not free.
4406
+ * @since 2.30
4281
4407
  */
4282
4408
  get_info(): Gio.DBusInterfaceInfo | null;
4283
4409
 
@@ -4292,11 +4418,13 @@ export namespace Meta {
4292
4418
  *
4293
4419
  * Note that `interface_` will hold a weak reference to `object`.
4294
4420
  * @param object A {@link Gio.DBusObject} or `null`.
4421
+ * @since 2.30
4295
4422
  */
4296
4423
  set_object(object: Gio.DBusObject | null): void;
4297
4424
 
4298
4425
  /**
4299
4426
  * Gets the {@link Gio.DBusObject} that `interface_` belongs to, if any.
4427
+ * @since 2.32
4300
4428
  * @virtual
4301
4429
  */
4302
4430
  vfunc_dup_object(): Gio.DBusObject | null;
@@ -4309,6 +4437,7 @@ export namespace Meta {
4309
4437
  * construction of `interface_` and is also not made available otherwise.
4310
4438
  * For example, {@link Gio.DBusProxy} implements {@link Gio.DBusInterface} but allows for a `null`
4311
4439
  * {@link Gio.DBusInterfaceInfo}.
4440
+ * @since 2.30
4312
4441
  * @virtual
4313
4442
  */
4314
4443
  vfunc_get_info(): Gio.DBusInterfaceInfo | null;
@@ -4325,6 +4454,7 @@ export namespace Meta {
4325
4454
  *
4326
4455
  * Note that `interface_` will hold a weak reference to `object`.
4327
4456
  * @param object A {@link Gio.DBusObject} or `null`.
4457
+ * @since 2.30
4328
4458
  * @virtual
4329
4459
  */
4330
4460
  vfunc_set_object(object: Gio.DBusObject | null): void;
@@ -5703,6 +5833,8 @@ export namespace Meta {
5703
5833
  * @param progress the progress factor
5704
5834
  * @param value return location for the animation value
5705
5835
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
5836
+ * @since 1.0
5837
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
5706
5838
  */
5707
5839
  animate_property(animation: Clutter.Animation, property_name: string, initial_value: GObject.Value | any, final_value: GObject.Value | any, progress: number, value: GObject.Value | any): boolean;
5708
5840
 
@@ -5710,6 +5842,7 @@ export namespace Meta {
5710
5842
  * Finds the {@link GObject.ParamSpec} for `property_name`
5711
5843
  * @param property_name the name of the animatable property to find
5712
5844
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
5845
+ * @since 1.4
5713
5846
  */
5714
5847
  find_property(property_name: string): GObject.ParamSpec;
5715
5848
 
@@ -5717,6 +5850,7 @@ export namespace Meta {
5717
5850
  * Retrieves the current state of `property_name` and sets `value` with it
5718
5851
  * @param property_name the name of the animatable property to retrieve
5719
5852
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
5853
+ * @since 1.4
5720
5854
  */
5721
5855
  get_initial_state(property_name: string, value: GObject.Value | any): void;
5722
5856
 
@@ -5734,6 +5868,7 @@ export namespace Meta {
5734
5868
  * @param interval a {@link Clutter.Interval} with the animation range
5735
5869
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
5736
5870
  * @returns `true` if the interpolation was successful, and `false` otherwise
5871
+ * @since 1.8
5737
5872
  */
5738
5873
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
5739
5874
 
@@ -5741,6 +5876,7 @@ export namespace Meta {
5741
5876
  * Sets the current state of `property_name` to `value`
5742
5877
  * @param property_name the name of the animatable property to set
5743
5878
  * @param value the value of the animatable property to set
5879
+ * @since 1.4
5744
5880
  */
5745
5881
  set_final_state(property_name: string, value: GObject.Value | any): void;
5746
5882
 
@@ -5759,6 +5895,8 @@ export namespace Meta {
5759
5895
  * @param final_value the final value of the animation interval
5760
5896
  * @param progress the progress factor
5761
5897
  * @param value return location for the animation value
5898
+ * @since 1.0
5899
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
5762
5900
  * @virtual
5763
5901
  */
5764
5902
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -5766,6 +5904,7 @@ export namespace Meta {
5766
5904
  /**
5767
5905
  * Finds the {@link GObject.ParamSpec} for `property_name`
5768
5906
  * @param property_name the name of the animatable property to find
5907
+ * @since 1.4
5769
5908
  * @virtual
5770
5909
  */
5771
5910
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -5774,6 +5913,7 @@ export namespace Meta {
5774
5913
  * Retrieves the current state of `property_name` and sets `value` with it
5775
5914
  * @param property_name the name of the animatable property to retrieve
5776
5915
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
5916
+ * @since 1.4
5777
5917
  * @virtual
5778
5918
  */
5779
5919
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -5791,6 +5931,7 @@ export namespace Meta {
5791
5931
  * @param property_name the name of the property to interpolate
5792
5932
  * @param interval a {@link Clutter.Interval} with the animation range
5793
5933
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
5934
+ * @since 1.8
5794
5935
  * @virtual
5795
5936
  */
5796
5937
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -5799,6 +5940,7 @@ export namespace Meta {
5799
5940
  * Sets the current state of `property_name` to `value`
5800
5941
  * @param property_name the name of the animatable property to set
5801
5942
  * @param value the value of the animatable property to set
5943
+ * @since 1.4
5802
5944
  * @virtual
5803
5945
  */
5804
5946
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -5813,6 +5955,8 @@ export namespace Meta {
5813
5955
  * deprecated virtual function. The default implementation will
5814
5956
  * call `clutter_actor_add_child()`.
5815
5957
  * @param actor the first {@link Clutter.Actor} to add
5958
+ * @since 0.4
5959
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
5816
5960
  */
5817
5961
  add_actor(actor: Clutter.Actor): void;
5818
5962
 
@@ -5827,6 +5971,7 @@ export namespace Meta {
5827
5971
  * @param child a {@link Clutter.Actor} that is a child of `container`.
5828
5972
  * @param property the name of the property to set.
5829
5973
  * @param value the value.
5974
+ * @since 0.8
5830
5975
  */
5831
5976
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
5832
5977
 
@@ -5836,6 +5981,7 @@ export namespace Meta {
5836
5981
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
5837
5982
  * @param child a {@link Clutter.Actor}
5838
5983
  * @param pspec a {@link GObject.ParamSpec}
5984
+ * @since 1.6
5839
5985
  */
5840
5986
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
5841
5987
 
@@ -5844,6 +5990,7 @@ export namespace Meta {
5844
5990
  * @param child a {@link Clutter.Actor} that is a child of `container`.
5845
5991
  * @param property the name of the property to set.
5846
5992
  * @param value the value.
5993
+ * @since 0.8
5847
5994
  */
5848
5995
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
5849
5996
 
@@ -5858,6 +6005,7 @@ export namespace Meta {
5858
6005
  *
5859
6006
  * Applications should not call this function.
5860
6007
  * @param actor a {@link Clutter.Actor}
6008
+ * @since 1.2
5861
6009
  */
5862
6010
  create_child_meta(actor: Clutter.Actor): void;
5863
6011
 
@@ -5871,6 +6019,7 @@ export namespace Meta {
5871
6019
  *
5872
6020
  * Applications should not call this function.
5873
6021
  * @param actor a {@link Clutter.Actor}
6022
+ * @since 1.2
5874
6023
  */
5875
6024
  destroy_child_meta(actor: Clutter.Actor): void;
5876
6025
 
@@ -5879,6 +6028,7 @@ export namespace Meta {
5879
6028
  * into any child container.
5880
6029
  * @param child_name the name of the requested child.
5881
6030
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
6031
+ * @since 0.6
5882
6032
  */
5883
6033
  find_child_by_name(child_name: string): Clutter.Actor;
5884
6034
 
@@ -5891,6 +6041,8 @@ export namespace Meta {
5891
6041
  * This function calls the {@link Clutter.ContainerIface}.foreach()
5892
6042
  * virtual function, which has been deprecated.
5893
6043
  * @param callback a function to be called for each child
6044
+ * @since 0.4
6045
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
5894
6046
  */
5895
6047
  foreach(callback: Clutter.Callback): void;
5896
6048
 
@@ -5902,6 +6054,8 @@ export namespace Meta {
5902
6054
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
5903
6055
  * virtual function, which has been deprecated.
5904
6056
  * @param callback a function to be called for each child
6057
+ * @since 1.0
6058
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
5905
6059
  */
5906
6060
  foreach_with_internals(callback: Clutter.Callback): void;
5907
6061
 
@@ -5910,12 +6064,15 @@ export namespace Meta {
5910
6064
  * `container` specific state for `actor`.
5911
6065
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
5912
6066
  * @returns the {@link Clutter.ChildMeta} for the `actor` child of `container` or `null` if the specifiec actor does not exist or the container is not configured to provide {@link Clutter.ChildMeta}<!-- -->s
6067
+ * @since 0.8
5913
6068
  */
5914
6069
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
5915
6070
 
5916
6071
  /**
5917
6072
  * Retrieves all the children of `container`.
5918
6073
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
6074
+ * @since 0.4
6075
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
5919
6076
  */
5920
6077
  get_children(): Clutter.Actor[];
5921
6078
 
@@ -5927,6 +6084,8 @@ export namespace Meta {
5927
6084
  * `clutter_actor_set_child_below_sibling()`.
5928
6085
  * @param actor the actor to raise
5929
6086
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
6087
+ * @since 0.6
6088
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
5930
6089
  */
5931
6090
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
5932
6091
 
@@ -5938,6 +6097,8 @@ export namespace Meta {
5938
6097
  * `clutter_actor_set_child_above_sibling()`.
5939
6098
  * @param actor the actor to raise
5940
6099
  * @param sibling the sibling to raise to, or `null` to raise to the top
6100
+ * @since 0.6
6101
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
5941
6102
  */
5942
6103
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
5943
6104
 
@@ -5951,12 +6112,16 @@ export namespace Meta {
5951
6112
  * deprecated virtual function. The default implementation will call
5952
6113
  * `clutter_actor_remove_child()`.
5953
6114
  * @param actor a {@link Clutter.Actor}
6115
+ * @since 0.4
6116
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
5954
6117
  */
5955
6118
  remove_actor(actor: Clutter.Actor): void;
5956
6119
 
5957
6120
  /**
5958
6121
  * Sorts a container's children using their depth. This function should not
5959
6122
  * be normally used by applications.
6123
+ * @since 0.6
6124
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
5960
6125
  */
5961
6126
  sort_depth_order(): void;
5962
6127
 
@@ -5982,6 +6147,8 @@ export namespace Meta {
5982
6147
  * deprecated virtual function. The default implementation will
5983
6148
  * call `clutter_actor_add_child()`.
5984
6149
  * @param actor the first {@link Clutter.Actor} to add
6150
+ * @since 0.4
6151
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
5985
6152
  * @virtual
5986
6153
  */
5987
6154
  vfunc_add(actor: Clutter.Actor): void;
@@ -5992,6 +6159,7 @@ export namespace Meta {
5992
6159
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
5993
6160
  * @param child a {@link Clutter.Actor}
5994
6161
  * @param pspec a {@link GObject.ParamSpec}
6162
+ * @since 1.6
5995
6163
  * @virtual
5996
6164
  */
5997
6165
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -6007,6 +6175,7 @@ export namespace Meta {
6007
6175
  *
6008
6176
  * Applications should not call this function.
6009
6177
  * @param actor a {@link Clutter.Actor}
6178
+ * @since 1.2
6010
6179
  * @virtual
6011
6180
  */
6012
6181
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -6021,6 +6190,7 @@ export namespace Meta {
6021
6190
  *
6022
6191
  * Applications should not call this function.
6023
6192
  * @param actor a {@link Clutter.Actor}
6193
+ * @since 1.2
6024
6194
  * @virtual
6025
6195
  */
6026
6196
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -6034,6 +6204,8 @@ export namespace Meta {
6034
6204
  * This function calls the {@link Clutter.ContainerIface}.foreach()
6035
6205
  * virtual function, which has been deprecated.
6036
6206
  * @param callback a function to be called for each child
6207
+ * @since 0.4
6208
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
6037
6209
  * @virtual
6038
6210
  */
6039
6211
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -6046,6 +6218,8 @@ export namespace Meta {
6046
6218
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
6047
6219
  * virtual function, which has been deprecated.
6048
6220
  * @param callback a function to be called for each child
6221
+ * @since 1.0
6222
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
6049
6223
  * @virtual
6050
6224
  */
6051
6225
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -6054,6 +6228,7 @@ export namespace Meta {
6054
6228
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
6055
6229
  * `container` specific state for `actor`.
6056
6230
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
6231
+ * @since 0.8
6057
6232
  * @virtual
6058
6233
  */
6059
6234
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -6066,6 +6241,8 @@ export namespace Meta {
6066
6241
  * `clutter_actor_set_child_below_sibling()`.
6067
6242
  * @param actor the actor to raise
6068
6243
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
6244
+ * @since 0.6
6245
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
6069
6246
  * @virtual
6070
6247
  */
6071
6248
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -6078,6 +6255,8 @@ export namespace Meta {
6078
6255
  * `clutter_actor_set_child_above_sibling()`.
6079
6256
  * @param actor the actor to raise
6080
6257
  * @param sibling the sibling to raise to, or `null` to raise to the top
6258
+ * @since 0.6
6259
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
6081
6260
  * @virtual
6082
6261
  */
6083
6262
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -6092,6 +6271,8 @@ export namespace Meta {
6092
6271
  * deprecated virtual function. The default implementation will call
6093
6272
  * `clutter_actor_remove_child()`.
6094
6273
  * @param actor a {@link Clutter.Actor}
6274
+ * @since 0.4
6275
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
6095
6276
  * @virtual
6096
6277
  */
6097
6278
  vfunc_remove(actor: Clutter.Actor): void;
@@ -6099,6 +6280,8 @@ export namespace Meta {
6099
6280
  /**
6100
6281
  * Sorts a container's children using their depth. This function should not
6101
6282
  * be normally used by applications.
6283
+ * @since 0.6
6284
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
6102
6285
  * @virtual
6103
6286
  */
6104
6287
  vfunc_sort_depth_order(): void;
@@ -6106,6 +6289,7 @@ export namespace Meta {
6106
6289
  /**
6107
6290
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
6108
6291
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
6292
+ * @since 0.6
6109
6293
  */
6110
6294
  get_id(): string;
6111
6295
 
@@ -6117,6 +6301,7 @@ export namespace Meta {
6117
6301
  * @param name the name of the node
6118
6302
  * @param node the JSON node to be parsed
6119
6303
  * @returns `true` if the node was successfully parsed, `false` otherwise.
6304
+ * @since 0.6
6120
6305
  */
6121
6306
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
6122
6307
 
@@ -6126,6 +6311,7 @@ export namespace Meta {
6126
6311
  * @param script the {@link Clutter.Script} creating the scriptable instance
6127
6312
  * @param name the name of the property
6128
6313
  * @param value the value of the property
6314
+ * @since 0.6
6129
6315
  */
6130
6316
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
6131
6317
 
@@ -6137,11 +6323,13 @@ export namespace Meta {
6137
6323
  * define a unique name for an object constructable using the UI
6138
6324
  * definition language parsed by {@link Clutter.Script}.
6139
6325
  * @param id_ the {@link Clutter.Script} id of the object
6326
+ * @since 0.6
6140
6327
  */
6141
6328
  set_id(id_: string): void;
6142
6329
 
6143
6330
  /**
6144
6331
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
6332
+ * @since 0.6
6145
6333
  * @virtual
6146
6334
  */
6147
6335
  vfunc_get_id(): string;
@@ -6153,6 +6341,7 @@ export namespace Meta {
6153
6341
  * @param value the generic value to be set
6154
6342
  * @param name the name of the node
6155
6343
  * @param node the JSON node to be parsed
6344
+ * @since 0.6
6156
6345
  * @virtual
6157
6346
  */
6158
6347
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -6163,6 +6352,7 @@ export namespace Meta {
6163
6352
  * @param script the {@link Clutter.Script} creating the scriptable instance
6164
6353
  * @param name the name of the property
6165
6354
  * @param value the value of the property
6355
+ * @since 0.6
6166
6356
  * @virtual
6167
6357
  */
6168
6358
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -6175,6 +6365,7 @@ export namespace Meta {
6175
6365
  * define a unique name for an object constructable using the UI
6176
6366
  * definition language parsed by {@link Clutter.Script}.
6177
6367
  * @param id_ the {@link Clutter.Script} id of the object
6368
+ * @since 0.6
6178
6369
  * @virtual
6179
6370
  */
6180
6371
  vfunc_set_id(id_: string): void;
@@ -7427,6 +7618,8 @@ export namespace Meta {
7427
7618
  * @param progress the progress factor
7428
7619
  * @param value return location for the animation value
7429
7620
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
7621
+ * @since 1.0
7622
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
7430
7623
  */
7431
7624
  animate_property(animation: Clutter.Animation, property_name: string, initial_value: GObject.Value | any, final_value: GObject.Value | any, progress: number, value: GObject.Value | any): boolean;
7432
7625
 
@@ -7434,6 +7627,7 @@ export namespace Meta {
7434
7627
  * Finds the {@link GObject.ParamSpec} for `property_name`
7435
7628
  * @param property_name the name of the animatable property to find
7436
7629
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
7630
+ * @since 1.4
7437
7631
  */
7438
7632
  find_property(property_name: string): GObject.ParamSpec;
7439
7633
 
@@ -7441,6 +7635,7 @@ export namespace Meta {
7441
7635
  * Retrieves the current state of `property_name` and sets `value` with it
7442
7636
  * @param property_name the name of the animatable property to retrieve
7443
7637
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
7638
+ * @since 1.4
7444
7639
  */
7445
7640
  get_initial_state(property_name: string, value: GObject.Value | any): void;
7446
7641
 
@@ -7458,6 +7653,7 @@ export namespace Meta {
7458
7653
  * @param interval a {@link Clutter.Interval} with the animation range
7459
7654
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
7460
7655
  * @returns `true` if the interpolation was successful, and `false` otherwise
7656
+ * @since 1.8
7461
7657
  */
7462
7658
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
7463
7659
 
@@ -7465,6 +7661,7 @@ export namespace Meta {
7465
7661
  * Sets the current state of `property_name` to `value`
7466
7662
  * @param property_name the name of the animatable property to set
7467
7663
  * @param value the value of the animatable property to set
7664
+ * @since 1.4
7468
7665
  */
7469
7666
  set_final_state(property_name: string, value: GObject.Value | any): void;
7470
7667
 
@@ -7483,6 +7680,8 @@ export namespace Meta {
7483
7680
  * @param final_value the final value of the animation interval
7484
7681
  * @param progress the progress factor
7485
7682
  * @param value return location for the animation value
7683
+ * @since 1.0
7684
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
7486
7685
  * @virtual
7487
7686
  */
7488
7687
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -7490,6 +7689,7 @@ export namespace Meta {
7490
7689
  /**
7491
7690
  * Finds the {@link GObject.ParamSpec} for `property_name`
7492
7691
  * @param property_name the name of the animatable property to find
7692
+ * @since 1.4
7493
7693
  * @virtual
7494
7694
  */
7495
7695
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -7498,6 +7698,7 @@ export namespace Meta {
7498
7698
  * Retrieves the current state of `property_name` and sets `value` with it
7499
7699
  * @param property_name the name of the animatable property to retrieve
7500
7700
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
7701
+ * @since 1.4
7501
7702
  * @virtual
7502
7703
  */
7503
7704
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -7515,6 +7716,7 @@ export namespace Meta {
7515
7716
  * @param property_name the name of the property to interpolate
7516
7717
  * @param interval a {@link Clutter.Interval} with the animation range
7517
7718
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
7719
+ * @since 1.8
7518
7720
  * @virtual
7519
7721
  */
7520
7722
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -7523,6 +7725,7 @@ export namespace Meta {
7523
7725
  * Sets the current state of `property_name` to `value`
7524
7726
  * @param property_name the name of the animatable property to set
7525
7727
  * @param value the value of the animatable property to set
7728
+ * @since 1.4
7526
7729
  * @virtual
7527
7730
  */
7528
7731
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -7537,6 +7740,8 @@ export namespace Meta {
7537
7740
  * deprecated virtual function. The default implementation will
7538
7741
  * call `clutter_actor_add_child()`.
7539
7742
  * @param actor the first {@link Clutter.Actor} to add
7743
+ * @since 0.4
7744
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
7540
7745
  */
7541
7746
  add_actor(actor: Clutter.Actor): void;
7542
7747
 
@@ -7551,6 +7756,7 @@ export namespace Meta {
7551
7756
  * @param child a {@link Clutter.Actor} that is a child of `container`.
7552
7757
  * @param property the name of the property to set.
7553
7758
  * @param value the value.
7759
+ * @since 0.8
7554
7760
  */
7555
7761
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
7556
7762
 
@@ -7560,6 +7766,7 @@ export namespace Meta {
7560
7766
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
7561
7767
  * @param child a {@link Clutter.Actor}
7562
7768
  * @param pspec a {@link GObject.ParamSpec}
7769
+ * @since 1.6
7563
7770
  */
7564
7771
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
7565
7772
 
@@ -7568,6 +7775,7 @@ export namespace Meta {
7568
7775
  * @param child a {@link Clutter.Actor} that is a child of `container`.
7569
7776
  * @param property the name of the property to set.
7570
7777
  * @param value the value.
7778
+ * @since 0.8
7571
7779
  */
7572
7780
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
7573
7781
 
@@ -7582,6 +7790,7 @@ export namespace Meta {
7582
7790
  *
7583
7791
  * Applications should not call this function.
7584
7792
  * @param actor a {@link Clutter.Actor}
7793
+ * @since 1.2
7585
7794
  */
7586
7795
  create_child_meta(actor: Clutter.Actor): void;
7587
7796
 
@@ -7595,6 +7804,7 @@ export namespace Meta {
7595
7804
  *
7596
7805
  * Applications should not call this function.
7597
7806
  * @param actor a {@link Clutter.Actor}
7807
+ * @since 1.2
7598
7808
  */
7599
7809
  destroy_child_meta(actor: Clutter.Actor): void;
7600
7810
 
@@ -7603,6 +7813,7 @@ export namespace Meta {
7603
7813
  * into any child container.
7604
7814
  * @param child_name the name of the requested child.
7605
7815
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
7816
+ * @since 0.6
7606
7817
  */
7607
7818
  find_child_by_name(child_name: string): Clutter.Actor;
7608
7819
 
@@ -7615,6 +7826,8 @@ export namespace Meta {
7615
7826
  * This function calls the {@link Clutter.ContainerIface}.foreach()
7616
7827
  * virtual function, which has been deprecated.
7617
7828
  * @param callback a function to be called for each child
7829
+ * @since 0.4
7830
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
7618
7831
  */
7619
7832
  foreach(callback: Clutter.Callback): void;
7620
7833
 
@@ -7626,6 +7839,8 @@ export namespace Meta {
7626
7839
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
7627
7840
  * virtual function, which has been deprecated.
7628
7841
  * @param callback a function to be called for each child
7842
+ * @since 1.0
7843
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
7629
7844
  */
7630
7845
  foreach_with_internals(callback: Clutter.Callback): void;
7631
7846
 
@@ -7634,12 +7849,15 @@ export namespace Meta {
7634
7849
  * `container` specific state for `actor`.
7635
7850
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
7636
7851
  * @returns the {@link Clutter.ChildMeta} for the `actor` child of `container` or `null` if the specifiec actor does not exist or the container is not configured to provide {@link Clutter.ChildMeta}<!-- -->s
7852
+ * @since 0.8
7637
7853
  */
7638
7854
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
7639
7855
 
7640
7856
  /**
7641
7857
  * Retrieves all the children of `container`.
7642
7858
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
7859
+ * @since 0.4
7860
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
7643
7861
  */
7644
7862
  get_children(): Clutter.Actor[];
7645
7863
 
@@ -7651,6 +7869,8 @@ export namespace Meta {
7651
7869
  * `clutter_actor_set_child_below_sibling()`.
7652
7870
  * @param actor the actor to raise
7653
7871
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
7872
+ * @since 0.6
7873
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
7654
7874
  */
7655
7875
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
7656
7876
 
@@ -7662,6 +7882,8 @@ export namespace Meta {
7662
7882
  * `clutter_actor_set_child_above_sibling()`.
7663
7883
  * @param actor the actor to raise
7664
7884
  * @param sibling the sibling to raise to, or `null` to raise to the top
7885
+ * @since 0.6
7886
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
7665
7887
  */
7666
7888
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
7667
7889
 
@@ -7675,12 +7897,16 @@ export namespace Meta {
7675
7897
  * deprecated virtual function. The default implementation will call
7676
7898
  * `clutter_actor_remove_child()`.
7677
7899
  * @param actor a {@link Clutter.Actor}
7900
+ * @since 0.4
7901
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
7678
7902
  */
7679
7903
  remove_actor(actor: Clutter.Actor): void;
7680
7904
 
7681
7905
  /**
7682
7906
  * Sorts a container's children using their depth. This function should not
7683
7907
  * be normally used by applications.
7908
+ * @since 0.6
7909
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
7684
7910
  */
7685
7911
  sort_depth_order(): void;
7686
7912
 
@@ -7706,6 +7932,8 @@ export namespace Meta {
7706
7932
  * deprecated virtual function. The default implementation will
7707
7933
  * call `clutter_actor_add_child()`.
7708
7934
  * @param actor the first {@link Clutter.Actor} to add
7935
+ * @since 0.4
7936
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
7709
7937
  * @virtual
7710
7938
  */
7711
7939
  vfunc_add(actor: Clutter.Actor): void;
@@ -7716,6 +7944,7 @@ export namespace Meta {
7716
7944
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
7717
7945
  * @param child a {@link Clutter.Actor}
7718
7946
  * @param pspec a {@link GObject.ParamSpec}
7947
+ * @since 1.6
7719
7948
  * @virtual
7720
7949
  */
7721
7950
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -7731,6 +7960,7 @@ export namespace Meta {
7731
7960
  *
7732
7961
  * Applications should not call this function.
7733
7962
  * @param actor a {@link Clutter.Actor}
7963
+ * @since 1.2
7734
7964
  * @virtual
7735
7965
  */
7736
7966
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -7745,6 +7975,7 @@ export namespace Meta {
7745
7975
  *
7746
7976
  * Applications should not call this function.
7747
7977
  * @param actor a {@link Clutter.Actor}
7978
+ * @since 1.2
7748
7979
  * @virtual
7749
7980
  */
7750
7981
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -7758,6 +7989,8 @@ export namespace Meta {
7758
7989
  * This function calls the {@link Clutter.ContainerIface}.foreach()
7759
7990
  * virtual function, which has been deprecated.
7760
7991
  * @param callback a function to be called for each child
7992
+ * @since 0.4
7993
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
7761
7994
  * @virtual
7762
7995
  */
7763
7996
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -7770,6 +8003,8 @@ export namespace Meta {
7770
8003
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
7771
8004
  * virtual function, which has been deprecated.
7772
8005
  * @param callback a function to be called for each child
8006
+ * @since 1.0
8007
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
7773
8008
  * @virtual
7774
8009
  */
7775
8010
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -7778,6 +8013,7 @@ export namespace Meta {
7778
8013
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
7779
8014
  * `container` specific state for `actor`.
7780
8015
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
8016
+ * @since 0.8
7781
8017
  * @virtual
7782
8018
  */
7783
8019
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -7790,6 +8026,8 @@ export namespace Meta {
7790
8026
  * `clutter_actor_set_child_below_sibling()`.
7791
8027
  * @param actor the actor to raise
7792
8028
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8029
+ * @since 0.6
8030
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
7793
8031
  * @virtual
7794
8032
  */
7795
8033
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -7802,6 +8040,8 @@ export namespace Meta {
7802
8040
  * `clutter_actor_set_child_above_sibling()`.
7803
8041
  * @param actor the actor to raise
7804
8042
  * @param sibling the sibling to raise to, or `null` to raise to the top
8043
+ * @since 0.6
8044
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
7805
8045
  * @virtual
7806
8046
  */
7807
8047
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -7816,6 +8056,8 @@ export namespace Meta {
7816
8056
  * deprecated virtual function. The default implementation will call
7817
8057
  * `clutter_actor_remove_child()`.
7818
8058
  * @param actor a {@link Clutter.Actor}
8059
+ * @since 0.4
8060
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
7819
8061
  * @virtual
7820
8062
  */
7821
8063
  vfunc_remove(actor: Clutter.Actor): void;
@@ -7823,6 +8065,8 @@ export namespace Meta {
7823
8065
  /**
7824
8066
  * Sorts a container's children using their depth. This function should not
7825
8067
  * be normally used by applications.
8068
+ * @since 0.6
8069
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
7826
8070
  * @virtual
7827
8071
  */
7828
8072
  vfunc_sort_depth_order(): void;
@@ -7830,6 +8074,7 @@ export namespace Meta {
7830
8074
  /**
7831
8075
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
7832
8076
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
8077
+ * @since 0.6
7833
8078
  */
7834
8079
  get_id(): string;
7835
8080
 
@@ -7841,6 +8086,7 @@ export namespace Meta {
7841
8086
  * @param name the name of the node
7842
8087
  * @param node the JSON node to be parsed
7843
8088
  * @returns `true` if the node was successfully parsed, `false` otherwise.
8089
+ * @since 0.6
7844
8090
  */
7845
8091
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
7846
8092
 
@@ -7850,6 +8096,7 @@ export namespace Meta {
7850
8096
  * @param script the {@link Clutter.Script} creating the scriptable instance
7851
8097
  * @param name the name of the property
7852
8098
  * @param value the value of the property
8099
+ * @since 0.6
7853
8100
  */
7854
8101
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
7855
8102
 
@@ -7861,11 +8108,13 @@ export namespace Meta {
7861
8108
  * define a unique name for an object constructable using the UI
7862
8109
  * definition language parsed by {@link Clutter.Script}.
7863
8110
  * @param id_ the {@link Clutter.Script} id of the object
8111
+ * @since 0.6
7864
8112
  */
7865
8113
  set_id(id_: string): void;
7866
8114
 
7867
8115
  /**
7868
8116
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
8117
+ * @since 0.6
7869
8118
  * @virtual
7870
8119
  */
7871
8120
  vfunc_get_id(): string;
@@ -7877,6 +8126,7 @@ export namespace Meta {
7877
8126
  * @param value the generic value to be set
7878
8127
  * @param name the name of the node
7879
8128
  * @param node the JSON node to be parsed
8129
+ * @since 0.6
7880
8130
  * @virtual
7881
8131
  */
7882
8132
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -7887,6 +8137,7 @@ export namespace Meta {
7887
8137
  * @param script the {@link Clutter.Script} creating the scriptable instance
7888
8138
  * @param name the name of the property
7889
8139
  * @param value the value of the property
8140
+ * @since 0.6
7890
8141
  * @virtual
7891
8142
  */
7892
8143
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -7899,6 +8150,7 @@ export namespace Meta {
7899
8150
  * define a unique name for an object constructable using the UI
7900
8151
  * definition language parsed by {@link Clutter.Script}.
7901
8152
  * @param id_ the {@link Clutter.Script} id of the object
8153
+ * @since 0.6
7902
8154
  * @virtual
7903
8155
  */
7904
8156
  vfunc_set_id(id_: string): void;
@@ -8044,6 +8296,8 @@ export namespace Meta {
8044
8296
  * @param progress the progress factor
8045
8297
  * @param value return location for the animation value
8046
8298
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
8299
+ * @since 1.0
8300
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
8047
8301
  */
8048
8302
  animate_property(animation: Clutter.Animation, property_name: string, initial_value: GObject.Value | any, final_value: GObject.Value | any, progress: number, value: GObject.Value | any): boolean;
8049
8303
 
@@ -8051,6 +8305,7 @@ export namespace Meta {
8051
8305
  * Finds the {@link GObject.ParamSpec} for `property_name`
8052
8306
  * @param property_name the name of the animatable property to find
8053
8307
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
8308
+ * @since 1.4
8054
8309
  */
8055
8310
  find_property(property_name: string): GObject.ParamSpec;
8056
8311
 
@@ -8058,6 +8313,7 @@ export namespace Meta {
8058
8313
  * Retrieves the current state of `property_name` and sets `value` with it
8059
8314
  * @param property_name the name of the animatable property to retrieve
8060
8315
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
8316
+ * @since 1.4
8061
8317
  */
8062
8318
  get_initial_state(property_name: string, value: GObject.Value | any): void;
8063
8319
 
@@ -8075,6 +8331,7 @@ export namespace Meta {
8075
8331
  * @param interval a {@link Clutter.Interval} with the animation range
8076
8332
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
8077
8333
  * @returns `true` if the interpolation was successful, and `false` otherwise
8334
+ * @since 1.8
8078
8335
  */
8079
8336
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
8080
8337
 
@@ -8082,6 +8339,7 @@ export namespace Meta {
8082
8339
  * Sets the current state of `property_name` to `value`
8083
8340
  * @param property_name the name of the animatable property to set
8084
8341
  * @param value the value of the animatable property to set
8342
+ * @since 1.4
8085
8343
  */
8086
8344
  set_final_state(property_name: string, value: GObject.Value | any): void;
8087
8345
 
@@ -8100,6 +8358,8 @@ export namespace Meta {
8100
8358
  * @param final_value the final value of the animation interval
8101
8359
  * @param progress the progress factor
8102
8360
  * @param value return location for the animation value
8361
+ * @since 1.0
8362
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
8103
8363
  * @virtual
8104
8364
  */
8105
8365
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -8107,6 +8367,7 @@ export namespace Meta {
8107
8367
  /**
8108
8368
  * Finds the {@link GObject.ParamSpec} for `property_name`
8109
8369
  * @param property_name the name of the animatable property to find
8370
+ * @since 1.4
8110
8371
  * @virtual
8111
8372
  */
8112
8373
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -8115,6 +8376,7 @@ export namespace Meta {
8115
8376
  * Retrieves the current state of `property_name` and sets `value` with it
8116
8377
  * @param property_name the name of the animatable property to retrieve
8117
8378
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
8379
+ * @since 1.4
8118
8380
  * @virtual
8119
8381
  */
8120
8382
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -8132,6 +8394,7 @@ export namespace Meta {
8132
8394
  * @param property_name the name of the property to interpolate
8133
8395
  * @param interval a {@link Clutter.Interval} with the animation range
8134
8396
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
8397
+ * @since 1.8
8135
8398
  * @virtual
8136
8399
  */
8137
8400
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -8140,6 +8403,7 @@ export namespace Meta {
8140
8403
  * Sets the current state of `property_name` to `value`
8141
8404
  * @param property_name the name of the animatable property to set
8142
8405
  * @param value the value of the animatable property to set
8406
+ * @since 1.4
8143
8407
  * @virtual
8144
8408
  */
8145
8409
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -8154,6 +8418,8 @@ export namespace Meta {
8154
8418
  * deprecated virtual function. The default implementation will
8155
8419
  * call `clutter_actor_add_child()`.
8156
8420
  * @param actor the first {@link Clutter.Actor} to add
8421
+ * @since 0.4
8422
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
8157
8423
  */
8158
8424
  add_actor(actor: Clutter.Actor): void;
8159
8425
 
@@ -8168,6 +8434,7 @@ export namespace Meta {
8168
8434
  * @param child a {@link Clutter.Actor} that is a child of `container`.
8169
8435
  * @param property the name of the property to set.
8170
8436
  * @param value the value.
8437
+ * @since 0.8
8171
8438
  */
8172
8439
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
8173
8440
 
@@ -8177,6 +8444,7 @@ export namespace Meta {
8177
8444
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
8178
8445
  * @param child a {@link Clutter.Actor}
8179
8446
  * @param pspec a {@link GObject.ParamSpec}
8447
+ * @since 1.6
8180
8448
  */
8181
8449
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
8182
8450
 
@@ -8185,6 +8453,7 @@ export namespace Meta {
8185
8453
  * @param child a {@link Clutter.Actor} that is a child of `container`.
8186
8454
  * @param property the name of the property to set.
8187
8455
  * @param value the value.
8456
+ * @since 0.8
8188
8457
  */
8189
8458
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
8190
8459
 
@@ -8199,6 +8468,7 @@ export namespace Meta {
8199
8468
  *
8200
8469
  * Applications should not call this function.
8201
8470
  * @param actor a {@link Clutter.Actor}
8471
+ * @since 1.2
8202
8472
  */
8203
8473
  create_child_meta(actor: Clutter.Actor): void;
8204
8474
 
@@ -8212,6 +8482,7 @@ export namespace Meta {
8212
8482
  *
8213
8483
  * Applications should not call this function.
8214
8484
  * @param actor a {@link Clutter.Actor}
8485
+ * @since 1.2
8215
8486
  */
8216
8487
  destroy_child_meta(actor: Clutter.Actor): void;
8217
8488
 
@@ -8220,6 +8491,7 @@ export namespace Meta {
8220
8491
  * into any child container.
8221
8492
  * @param child_name the name of the requested child.
8222
8493
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
8494
+ * @since 0.6
8223
8495
  */
8224
8496
  find_child_by_name(child_name: string): Clutter.Actor;
8225
8497
 
@@ -8232,6 +8504,8 @@ export namespace Meta {
8232
8504
  * This function calls the {@link Clutter.ContainerIface}.foreach()
8233
8505
  * virtual function, which has been deprecated.
8234
8506
  * @param callback a function to be called for each child
8507
+ * @since 0.4
8508
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
8235
8509
  */
8236
8510
  foreach(callback: Clutter.Callback): void;
8237
8511
 
@@ -8243,6 +8517,8 @@ export namespace Meta {
8243
8517
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
8244
8518
  * virtual function, which has been deprecated.
8245
8519
  * @param callback a function to be called for each child
8520
+ * @since 1.0
8521
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
8246
8522
  */
8247
8523
  foreach_with_internals(callback: Clutter.Callback): void;
8248
8524
 
@@ -8251,12 +8527,15 @@ export namespace Meta {
8251
8527
  * `container` specific state for `actor`.
8252
8528
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
8253
8529
  * @returns the {@link Clutter.ChildMeta} for the `actor` child of `container` or `null` if the specifiec actor does not exist or the container is not configured to provide {@link Clutter.ChildMeta}<!-- -->s
8530
+ * @since 0.8
8254
8531
  */
8255
8532
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
8256
8533
 
8257
8534
  /**
8258
8535
  * Retrieves all the children of `container`.
8259
8536
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
8537
+ * @since 0.4
8538
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
8260
8539
  */
8261
8540
  get_children(): Clutter.Actor[];
8262
8541
 
@@ -8268,6 +8547,8 @@ export namespace Meta {
8268
8547
  * `clutter_actor_set_child_below_sibling()`.
8269
8548
  * @param actor the actor to raise
8270
8549
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8550
+ * @since 0.6
8551
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
8271
8552
  */
8272
8553
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
8273
8554
 
@@ -8279,6 +8560,8 @@ export namespace Meta {
8279
8560
  * `clutter_actor_set_child_above_sibling()`.
8280
8561
  * @param actor the actor to raise
8281
8562
  * @param sibling the sibling to raise to, or `null` to raise to the top
8563
+ * @since 0.6
8564
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
8282
8565
  */
8283
8566
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
8284
8567
 
@@ -8292,12 +8575,16 @@ export namespace Meta {
8292
8575
  * deprecated virtual function. The default implementation will call
8293
8576
  * `clutter_actor_remove_child()`.
8294
8577
  * @param actor a {@link Clutter.Actor}
8578
+ * @since 0.4
8579
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
8295
8580
  */
8296
8581
  remove_actor(actor: Clutter.Actor): void;
8297
8582
 
8298
8583
  /**
8299
8584
  * Sorts a container's children using their depth. This function should not
8300
8585
  * be normally used by applications.
8586
+ * @since 0.6
8587
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
8301
8588
  */
8302
8589
  sort_depth_order(): void;
8303
8590
 
@@ -8323,6 +8610,8 @@ export namespace Meta {
8323
8610
  * deprecated virtual function. The default implementation will
8324
8611
  * call `clutter_actor_add_child()`.
8325
8612
  * @param actor the first {@link Clutter.Actor} to add
8613
+ * @since 0.4
8614
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
8326
8615
  * @virtual
8327
8616
  */
8328
8617
  vfunc_add(actor: Clutter.Actor): void;
@@ -8333,6 +8622,7 @@ export namespace Meta {
8333
8622
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
8334
8623
  * @param child a {@link Clutter.Actor}
8335
8624
  * @param pspec a {@link GObject.ParamSpec}
8625
+ * @since 1.6
8336
8626
  * @virtual
8337
8627
  */
8338
8628
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -8348,6 +8638,7 @@ export namespace Meta {
8348
8638
  *
8349
8639
  * Applications should not call this function.
8350
8640
  * @param actor a {@link Clutter.Actor}
8641
+ * @since 1.2
8351
8642
  * @virtual
8352
8643
  */
8353
8644
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -8362,6 +8653,7 @@ export namespace Meta {
8362
8653
  *
8363
8654
  * Applications should not call this function.
8364
8655
  * @param actor a {@link Clutter.Actor}
8656
+ * @since 1.2
8365
8657
  * @virtual
8366
8658
  */
8367
8659
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -8375,6 +8667,8 @@ export namespace Meta {
8375
8667
  * This function calls the {@link Clutter.ContainerIface}.foreach()
8376
8668
  * virtual function, which has been deprecated.
8377
8669
  * @param callback a function to be called for each child
8670
+ * @since 0.4
8671
+ * @deprecated since 1.10: Use `clutter_actor_get_first_child()` or `clutter_actor_get_last_child()` to retrieve the beginning of the list of children, and `clutter_actor_get_next_sibling()` and `clutter_actor_get_previous_sibling()` to iterate over it; alternatively, use the {@link Clutter.ActorIter} API.
8378
8672
  * @virtual
8379
8673
  */
8380
8674
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -8387,6 +8681,8 @@ export namespace Meta {
8387
8681
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
8388
8682
  * virtual function, which has been deprecated.
8389
8683
  * @param callback a function to be called for each child
8684
+ * @since 1.0
8685
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
8390
8686
  * @virtual
8391
8687
  */
8392
8688
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -8395,6 +8691,7 @@ export namespace Meta {
8395
8691
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
8396
8692
  * `container` specific state for `actor`.
8397
8693
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
8694
+ * @since 0.8
8398
8695
  * @virtual
8399
8696
  */
8400
8697
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -8407,6 +8704,8 @@ export namespace Meta {
8407
8704
  * `clutter_actor_set_child_below_sibling()`.
8408
8705
  * @param actor the actor to raise
8409
8706
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8707
+ * @since 0.6
8708
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
8410
8709
  * @virtual
8411
8710
  */
8412
8711
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -8419,6 +8718,8 @@ export namespace Meta {
8419
8718
  * `clutter_actor_set_child_above_sibling()`.
8420
8719
  * @param actor the actor to raise
8421
8720
  * @param sibling the sibling to raise to, or `null` to raise to the top
8721
+ * @since 0.6
8722
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
8422
8723
  * @virtual
8423
8724
  */
8424
8725
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -8433,6 +8734,8 @@ export namespace Meta {
8433
8734
  * deprecated virtual function. The default implementation will call
8434
8735
  * `clutter_actor_remove_child()`.
8435
8736
  * @param actor a {@link Clutter.Actor}
8737
+ * @since 0.4
8738
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
8436
8739
  * @virtual
8437
8740
  */
8438
8741
  vfunc_remove(actor: Clutter.Actor): void;
@@ -8440,6 +8743,8 @@ export namespace Meta {
8440
8743
  /**
8441
8744
  * Sorts a container's children using their depth. This function should not
8442
8745
  * be normally used by applications.
8746
+ * @since 0.6
8747
+ * @deprecated since 1.10: The {@link Clutter.ContainerIface}.sort_depth_order() virtual function should not be used any more; the default implementation in {@link Clutter.Container} does not do anything.
8443
8748
  * @virtual
8444
8749
  */
8445
8750
  vfunc_sort_depth_order(): void;
@@ -8447,6 +8752,7 @@ export namespace Meta {
8447
8752
  /**
8448
8753
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
8449
8754
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
8755
+ * @since 0.6
8450
8756
  */
8451
8757
  get_id(): string;
8452
8758
 
@@ -8458,6 +8764,7 @@ export namespace Meta {
8458
8764
  * @param name the name of the node
8459
8765
  * @param node the JSON node to be parsed
8460
8766
  * @returns `true` if the node was successfully parsed, `false` otherwise.
8767
+ * @since 0.6
8461
8768
  */
8462
8769
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
8463
8770
 
@@ -8467,6 +8774,7 @@ export namespace Meta {
8467
8774
  * @param script the {@link Clutter.Script} creating the scriptable instance
8468
8775
  * @param name the name of the property
8469
8776
  * @param value the value of the property
8777
+ * @since 0.6
8470
8778
  */
8471
8779
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
8472
8780
 
@@ -8478,11 +8786,13 @@ export namespace Meta {
8478
8786
  * define a unique name for an object constructable using the UI
8479
8787
  * definition language parsed by {@link Clutter.Script}.
8480
8788
  * @param id_ the {@link Clutter.Script} id of the object
8789
+ * @since 0.6
8481
8790
  */
8482
8791
  set_id(id_: string): void;
8483
8792
 
8484
8793
  /**
8485
8794
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
8795
+ * @since 0.6
8486
8796
  * @virtual
8487
8797
  */
8488
8798
  vfunc_get_id(): string;
@@ -8494,6 +8804,7 @@ export namespace Meta {
8494
8804
  * @param value the generic value to be set
8495
8805
  * @param name the name of the node
8496
8806
  * @param node the JSON node to be parsed
8807
+ * @since 0.6
8497
8808
  * @virtual
8498
8809
  */
8499
8810
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -8504,6 +8815,7 @@ export namespace Meta {
8504
8815
  * @param script the {@link Clutter.Script} creating the scriptable instance
8505
8816
  * @param name the name of the property
8506
8817
  * @param value the value of the property
8818
+ * @since 0.6
8507
8819
  * @virtual
8508
8820
  */
8509
8821
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -8516,6 +8828,7 @@ export namespace Meta {
8516
8828
  * define a unique name for an object constructable using the UI
8517
8829
  * definition language parsed by {@link Clutter.Script}.
8518
8830
  * @param id_ the {@link Clutter.Script} id of the object
8831
+ * @since 0.6
8519
8832
  * @virtual
8520
8833
  */
8521
8834
  vfunc_set_id(id_: string): void;