@girs/meta-4 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-4.d.ts +307 -0
  3. package/package.json +23 -23
package/meta-4.d.ts CHANGED
@@ -2387,6 +2387,7 @@ export namespace Meta {
2387
2387
  * instance.
2388
2388
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
2389
2389
  * @returns `true` if successful. If an error has occurred, this function will return `false` and set `error` appropriately if present.
2390
+ * @since 2.22
2390
2391
  */
2391
2392
  init(cancellable: Gio.Cancellable | null): boolean;
2392
2393
 
@@ -2430,6 +2431,7 @@ export namespace Meta {
2430
2431
  * on the result of `g_object_new()`, regardless of whether it is in fact a new
2431
2432
  * instance.
2432
2433
  * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
2434
+ * @since 2.22
2433
2435
  * @virtual
2434
2436
  */
2435
2437
  vfunc_init(cancellable: Gio.Cancellable | null): boolean;
@@ -2777,6 +2779,8 @@ export namespace Meta {
2777
2779
  * @param progress the progress factor
2778
2780
  * @param value return location for the animation value
2779
2781
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
2782
+ * @since 1.0
2783
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
2780
2784
  */
2781
2785
  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;
2782
2786
 
@@ -2784,6 +2788,7 @@ export namespace Meta {
2784
2788
  * Finds the {@link GObject.ParamSpec} for `property_name`
2785
2789
  * @param property_name the name of the animatable property to find
2786
2790
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
2791
+ * @since 1.4
2787
2792
  */
2788
2793
  find_property(property_name: string): GObject.ParamSpec;
2789
2794
 
@@ -2791,6 +2796,7 @@ export namespace Meta {
2791
2796
  * Retrieves the current state of `property_name` and sets `value` with it
2792
2797
  * @param property_name the name of the animatable property to retrieve
2793
2798
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
2799
+ * @since 1.4
2794
2800
  */
2795
2801
  get_initial_state(property_name: string, value: GObject.Value | any): void;
2796
2802
 
@@ -2808,6 +2814,7 @@ export namespace Meta {
2808
2814
  * @param interval a {@link Clutter.Interval} with the animation range
2809
2815
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
2810
2816
  * @returns `true` if the interpolation was successful, and `false` otherwise
2817
+ * @since 1.8
2811
2818
  */
2812
2819
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
2813
2820
 
@@ -2815,6 +2822,7 @@ export namespace Meta {
2815
2822
  * Sets the current state of `property_name` to `value`
2816
2823
  * @param property_name the name of the animatable property to set
2817
2824
  * @param value the value of the animatable property to set
2825
+ * @since 1.4
2818
2826
  */
2819
2827
  set_final_state(property_name: string, value: GObject.Value | any): void;
2820
2828
 
@@ -2833,6 +2841,8 @@ export namespace Meta {
2833
2841
  * @param final_value the final value of the animation interval
2834
2842
  * @param progress the progress factor
2835
2843
  * @param value return location for the animation value
2844
+ * @since 1.0
2845
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
2836
2846
  * @virtual
2837
2847
  */
2838
2848
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -2840,6 +2850,7 @@ export namespace Meta {
2840
2850
  /**
2841
2851
  * Finds the {@link GObject.ParamSpec} for `property_name`
2842
2852
  * @param property_name the name of the animatable property to find
2853
+ * @since 1.4
2843
2854
  * @virtual
2844
2855
  */
2845
2856
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -2848,6 +2859,7 @@ export namespace Meta {
2848
2859
  * Retrieves the current state of `property_name` and sets `value` with it
2849
2860
  * @param property_name the name of the animatable property to retrieve
2850
2861
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
2862
+ * @since 1.4
2851
2863
  * @virtual
2852
2864
  */
2853
2865
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -2865,6 +2877,7 @@ export namespace Meta {
2865
2877
  * @param property_name the name of the property to interpolate
2866
2878
  * @param interval a {@link Clutter.Interval} with the animation range
2867
2879
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
2880
+ * @since 1.8
2868
2881
  * @virtual
2869
2882
  */
2870
2883
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -2873,6 +2886,7 @@ export namespace Meta {
2873
2886
  * Sets the current state of `property_name` to `value`
2874
2887
  * @param property_name the name of the animatable property to set
2875
2888
  * @param value the value of the animatable property to set
2889
+ * @since 1.4
2876
2890
  * @virtual
2877
2891
  */
2878
2892
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -2887,6 +2901,8 @@ export namespace Meta {
2887
2901
  * deprecated virtual function. The default implementation will
2888
2902
  * call `clutter_actor_add_child()`.
2889
2903
  * @param actor the first {@link Clutter.Actor} to add
2904
+ * @since 0.4
2905
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
2890
2906
  */
2891
2907
  add_actor(actor: Clutter.Actor): void;
2892
2908
 
@@ -2901,6 +2917,7 @@ export namespace Meta {
2901
2917
  * @param child a {@link Clutter.Actor} that is a child of `container`.
2902
2918
  * @param property the name of the property to set.
2903
2919
  * @param value the value.
2920
+ * @since 0.8
2904
2921
  */
2905
2922
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
2906
2923
 
@@ -2910,6 +2927,7 @@ export namespace Meta {
2910
2927
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
2911
2928
  * @param child a {@link Clutter.Actor}
2912
2929
  * @param pspec a {@link GObject.ParamSpec}
2930
+ * @since 1.6
2913
2931
  */
2914
2932
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
2915
2933
 
@@ -2918,6 +2936,7 @@ export namespace Meta {
2918
2936
  * @param child a {@link Clutter.Actor} that is a child of `container`.
2919
2937
  * @param property the name of the property to set.
2920
2938
  * @param value the value.
2939
+ * @since 0.8
2921
2940
  */
2922
2941
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
2923
2942
 
@@ -2932,6 +2951,7 @@ export namespace Meta {
2932
2951
  *
2933
2952
  * Applications should not call this function.
2934
2953
  * @param actor a {@link Clutter.Actor}
2954
+ * @since 1.2
2935
2955
  */
2936
2956
  create_child_meta(actor: Clutter.Actor): void;
2937
2957
 
@@ -2945,6 +2965,7 @@ export namespace Meta {
2945
2965
  *
2946
2966
  * Applications should not call this function.
2947
2967
  * @param actor a {@link Clutter.Actor}
2968
+ * @since 1.2
2948
2969
  */
2949
2970
  destroy_child_meta(actor: Clutter.Actor): void;
2950
2971
 
@@ -2953,6 +2974,7 @@ export namespace Meta {
2953
2974
  * into any child container.
2954
2975
  * @param child_name the name of the requested child.
2955
2976
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
2977
+ * @since 0.6
2956
2978
  */
2957
2979
  find_child_by_name(child_name: string): Clutter.Actor;
2958
2980
 
@@ -2965,6 +2987,8 @@ export namespace Meta {
2965
2987
  * This function calls the {@link Clutter.ContainerIface}.foreach()
2966
2988
  * virtual function, which has been deprecated.
2967
2989
  * @param callback a function to be called for each child
2990
+ * @since 0.4
2991
+ * @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.
2968
2992
  */
2969
2993
  foreach(callback: Clutter.Callback): void;
2970
2994
 
@@ -2976,6 +3000,8 @@ export namespace Meta {
2976
3000
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
2977
3001
  * virtual function, which has been deprecated.
2978
3002
  * @param callback a function to be called for each child
3003
+ * @since 1.0
3004
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
2979
3005
  */
2980
3006
  foreach_with_internals(callback: Clutter.Callback): void;
2981
3007
 
@@ -2984,12 +3010,15 @@ export namespace Meta {
2984
3010
  * `container` specific state for `actor`.
2985
3011
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
2986
3012
  * @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
3013
+ * @since 0.8
2987
3014
  */
2988
3015
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
2989
3016
 
2990
3017
  /**
2991
3018
  * Retrieves all the children of `container`.
2992
3019
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
3020
+ * @since 0.4
3021
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
2993
3022
  */
2994
3023
  get_children(): Clutter.Actor[];
2995
3024
 
@@ -3001,6 +3030,8 @@ export namespace Meta {
3001
3030
  * `clutter_actor_set_child_below_sibling()`.
3002
3031
  * @param actor the actor to raise
3003
3032
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3033
+ * @since 0.6
3034
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3004
3035
  */
3005
3036
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3006
3037
 
@@ -3012,6 +3043,8 @@ export namespace Meta {
3012
3043
  * `clutter_actor_set_child_above_sibling()`.
3013
3044
  * @param actor the actor to raise
3014
3045
  * @param sibling the sibling to raise to, or `null` to raise to the top
3046
+ * @since 0.6
3047
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3015
3048
  */
3016
3049
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3017
3050
 
@@ -3025,12 +3058,16 @@ export namespace Meta {
3025
3058
  * deprecated virtual function. The default implementation will call
3026
3059
  * `clutter_actor_remove_child()`.
3027
3060
  * @param actor a {@link Clutter.Actor}
3061
+ * @since 0.4
3062
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3028
3063
  */
3029
3064
  remove_actor(actor: Clutter.Actor): void;
3030
3065
 
3031
3066
  /**
3032
3067
  * Sorts a container's children using their depth. This function should not
3033
3068
  * be normally used by applications.
3069
+ * @since 0.6
3070
+ * @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.
3034
3071
  */
3035
3072
  sort_depth_order(): void;
3036
3073
 
@@ -3056,6 +3093,8 @@ export namespace Meta {
3056
3093
  * deprecated virtual function. The default implementation will
3057
3094
  * call `clutter_actor_add_child()`.
3058
3095
  * @param actor the first {@link Clutter.Actor} to add
3096
+ * @since 0.4
3097
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
3059
3098
  * @virtual
3060
3099
  */
3061
3100
  vfunc_add(actor: Clutter.Actor): void;
@@ -3066,6 +3105,7 @@ export namespace Meta {
3066
3105
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
3067
3106
  * @param child a {@link Clutter.Actor}
3068
3107
  * @param pspec a {@link GObject.ParamSpec}
3108
+ * @since 1.6
3069
3109
  * @virtual
3070
3110
  */
3071
3111
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -3081,6 +3121,7 @@ export namespace Meta {
3081
3121
  *
3082
3122
  * Applications should not call this function.
3083
3123
  * @param actor a {@link Clutter.Actor}
3124
+ * @since 1.2
3084
3125
  * @virtual
3085
3126
  */
3086
3127
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -3095,6 +3136,7 @@ export namespace Meta {
3095
3136
  *
3096
3137
  * Applications should not call this function.
3097
3138
  * @param actor a {@link Clutter.Actor}
3139
+ * @since 1.2
3098
3140
  * @virtual
3099
3141
  */
3100
3142
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -3108,6 +3150,8 @@ export namespace Meta {
3108
3150
  * This function calls the {@link Clutter.ContainerIface}.foreach()
3109
3151
  * virtual function, which has been deprecated.
3110
3152
  * @param callback a function to be called for each child
3153
+ * @since 0.4
3154
+ * @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.
3111
3155
  * @virtual
3112
3156
  */
3113
3157
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -3120,6 +3164,8 @@ export namespace Meta {
3120
3164
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
3121
3165
  * virtual function, which has been deprecated.
3122
3166
  * @param callback a function to be called for each child
3167
+ * @since 1.0
3168
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
3123
3169
  * @virtual
3124
3170
  */
3125
3171
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -3128,6 +3174,7 @@ export namespace Meta {
3128
3174
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
3129
3175
  * `container` specific state for `actor`.
3130
3176
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3177
+ * @since 0.8
3131
3178
  * @virtual
3132
3179
  */
3133
3180
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -3140,6 +3187,8 @@ export namespace Meta {
3140
3187
  * `clutter_actor_set_child_below_sibling()`.
3141
3188
  * @param actor the actor to raise
3142
3189
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3190
+ * @since 0.6
3191
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3143
3192
  * @virtual
3144
3193
  */
3145
3194
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3152,6 +3201,8 @@ export namespace Meta {
3152
3201
  * `clutter_actor_set_child_above_sibling()`.
3153
3202
  * @param actor the actor to raise
3154
3203
  * @param sibling the sibling to raise to, or `null` to raise to the top
3204
+ * @since 0.6
3205
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3155
3206
  * @virtual
3156
3207
  */
3157
3208
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3166,6 +3217,8 @@ export namespace Meta {
3166
3217
  * deprecated virtual function. The default implementation will call
3167
3218
  * `clutter_actor_remove_child()`.
3168
3219
  * @param actor a {@link Clutter.Actor}
3220
+ * @since 0.4
3221
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3169
3222
  * @virtual
3170
3223
  */
3171
3224
  vfunc_remove(actor: Clutter.Actor): void;
@@ -3173,6 +3226,8 @@ export namespace Meta {
3173
3226
  /**
3174
3227
  * Sorts a container's children using their depth. This function should not
3175
3228
  * be normally used by applications.
3229
+ * @since 0.6
3230
+ * @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.
3176
3231
  * @virtual
3177
3232
  */
3178
3233
  vfunc_sort_depth_order(): void;
@@ -3180,6 +3235,7 @@ export namespace Meta {
3180
3235
  /**
3181
3236
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3182
3237
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
3238
+ * @since 0.6
3183
3239
  */
3184
3240
  get_id(): string;
3185
3241
 
@@ -3191,6 +3247,7 @@ export namespace Meta {
3191
3247
  * @param name the name of the node
3192
3248
  * @param node the JSON node to be parsed
3193
3249
  * @returns `true` if the node was successfully parsed, `false` otherwise.
3250
+ * @since 0.6
3194
3251
  */
3195
3252
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
3196
3253
 
@@ -3200,6 +3257,7 @@ export namespace Meta {
3200
3257
  * @param script the {@link Clutter.Script} creating the scriptable instance
3201
3258
  * @param name the name of the property
3202
3259
  * @param value the value of the property
3260
+ * @since 0.6
3203
3261
  */
3204
3262
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
3205
3263
 
@@ -3211,11 +3269,13 @@ export namespace Meta {
3211
3269
  * define a unique name for an object constructable using the UI
3212
3270
  * definition language parsed by {@link Clutter.Script}.
3213
3271
  * @param id_ the {@link Clutter.Script} id of the object
3272
+ * @since 0.6
3214
3273
  */
3215
3274
  set_id(id_: string): void;
3216
3275
 
3217
3276
  /**
3218
3277
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3278
+ * @since 0.6
3219
3279
  * @virtual
3220
3280
  */
3221
3281
  vfunc_get_id(): string;
@@ -3227,6 +3287,7 @@ export namespace Meta {
3227
3287
  * @param value the generic value to be set
3228
3288
  * @param name the name of the node
3229
3289
  * @param node the JSON node to be parsed
3290
+ * @since 0.6
3230
3291
  * @virtual
3231
3292
  */
3232
3293
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -3237,6 +3298,7 @@ export namespace Meta {
3237
3298
  * @param script the {@link Clutter.Script} creating the scriptable instance
3238
3299
  * @param name the name of the property
3239
3300
  * @param value the value of the property
3301
+ * @since 0.6
3240
3302
  * @virtual
3241
3303
  */
3242
3304
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -3249,6 +3311,7 @@ export namespace Meta {
3249
3311
  * define a unique name for an object constructable using the UI
3250
3312
  * definition language parsed by {@link Clutter.Script}.
3251
3313
  * @param id_ the {@link Clutter.Script} id of the object
3314
+ * @since 0.6
3252
3315
  * @virtual
3253
3316
  */
3254
3317
  vfunc_set_id(id_: string): void;
@@ -3397,6 +3460,8 @@ export namespace Meta {
3397
3460
  * @param progress the progress factor
3398
3461
  * @param value return location for the animation value
3399
3462
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
3463
+ * @since 1.0
3464
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
3400
3465
  */
3401
3466
  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;
3402
3467
 
@@ -3404,6 +3469,7 @@ export namespace Meta {
3404
3469
  * Finds the {@link GObject.ParamSpec} for `property_name`
3405
3470
  * @param property_name the name of the animatable property to find
3406
3471
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
3472
+ * @since 1.4
3407
3473
  */
3408
3474
  find_property(property_name: string): GObject.ParamSpec;
3409
3475
 
@@ -3411,6 +3477,7 @@ export namespace Meta {
3411
3477
  * Retrieves the current state of `property_name` and sets `value` with it
3412
3478
  * @param property_name the name of the animatable property to retrieve
3413
3479
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
3480
+ * @since 1.4
3414
3481
  */
3415
3482
  get_initial_state(property_name: string, value: GObject.Value | any): void;
3416
3483
 
@@ -3428,6 +3495,7 @@ export namespace Meta {
3428
3495
  * @param interval a {@link Clutter.Interval} with the animation range
3429
3496
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
3430
3497
  * @returns `true` if the interpolation was successful, and `false` otherwise
3498
+ * @since 1.8
3431
3499
  */
3432
3500
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
3433
3501
 
@@ -3435,6 +3503,7 @@ export namespace Meta {
3435
3503
  * Sets the current state of `property_name` to `value`
3436
3504
  * @param property_name the name of the animatable property to set
3437
3505
  * @param value the value of the animatable property to set
3506
+ * @since 1.4
3438
3507
  */
3439
3508
  set_final_state(property_name: string, value: GObject.Value | any): void;
3440
3509
 
@@ -3453,6 +3522,8 @@ export namespace Meta {
3453
3522
  * @param final_value the final value of the animation interval
3454
3523
  * @param progress the progress factor
3455
3524
  * @param value return location for the animation value
3525
+ * @since 1.0
3526
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
3456
3527
  * @virtual
3457
3528
  */
3458
3529
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -3460,6 +3531,7 @@ export namespace Meta {
3460
3531
  /**
3461
3532
  * Finds the {@link GObject.ParamSpec} for `property_name`
3462
3533
  * @param property_name the name of the animatable property to find
3534
+ * @since 1.4
3463
3535
  * @virtual
3464
3536
  */
3465
3537
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -3468,6 +3540,7 @@ export namespace Meta {
3468
3540
  * Retrieves the current state of `property_name` and sets `value` with it
3469
3541
  * @param property_name the name of the animatable property to retrieve
3470
3542
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
3543
+ * @since 1.4
3471
3544
  * @virtual
3472
3545
  */
3473
3546
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -3485,6 +3558,7 @@ export namespace Meta {
3485
3558
  * @param property_name the name of the property to interpolate
3486
3559
  * @param interval a {@link Clutter.Interval} with the animation range
3487
3560
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
3561
+ * @since 1.8
3488
3562
  * @virtual
3489
3563
  */
3490
3564
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -3493,6 +3567,7 @@ export namespace Meta {
3493
3567
  * Sets the current state of `property_name` to `value`
3494
3568
  * @param property_name the name of the animatable property to set
3495
3569
  * @param value the value of the animatable property to set
3570
+ * @since 1.4
3496
3571
  * @virtual
3497
3572
  */
3498
3573
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -3507,6 +3582,8 @@ export namespace Meta {
3507
3582
  * deprecated virtual function. The default implementation will
3508
3583
  * call `clutter_actor_add_child()`.
3509
3584
  * @param actor the first {@link Clutter.Actor} to add
3585
+ * @since 0.4
3586
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
3510
3587
  */
3511
3588
  add_actor(actor: Clutter.Actor): void;
3512
3589
 
@@ -3521,6 +3598,7 @@ export namespace Meta {
3521
3598
  * @param child a {@link Clutter.Actor} that is a child of `container`.
3522
3599
  * @param property the name of the property to set.
3523
3600
  * @param value the value.
3601
+ * @since 0.8
3524
3602
  */
3525
3603
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
3526
3604
 
@@ -3530,6 +3608,7 @@ export namespace Meta {
3530
3608
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
3531
3609
  * @param child a {@link Clutter.Actor}
3532
3610
  * @param pspec a {@link GObject.ParamSpec}
3611
+ * @since 1.6
3533
3612
  */
3534
3613
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
3535
3614
 
@@ -3538,6 +3617,7 @@ export namespace Meta {
3538
3617
  * @param child a {@link Clutter.Actor} that is a child of `container`.
3539
3618
  * @param property the name of the property to set.
3540
3619
  * @param value the value.
3620
+ * @since 0.8
3541
3621
  */
3542
3622
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
3543
3623
 
@@ -3552,6 +3632,7 @@ export namespace Meta {
3552
3632
  *
3553
3633
  * Applications should not call this function.
3554
3634
  * @param actor a {@link Clutter.Actor}
3635
+ * @since 1.2
3555
3636
  */
3556
3637
  create_child_meta(actor: Clutter.Actor): void;
3557
3638
 
@@ -3565,6 +3646,7 @@ export namespace Meta {
3565
3646
  *
3566
3647
  * Applications should not call this function.
3567
3648
  * @param actor a {@link Clutter.Actor}
3649
+ * @since 1.2
3568
3650
  */
3569
3651
  destroy_child_meta(actor: Clutter.Actor): void;
3570
3652
 
@@ -3573,6 +3655,7 @@ export namespace Meta {
3573
3655
  * into any child container.
3574
3656
  * @param child_name the name of the requested child.
3575
3657
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
3658
+ * @since 0.6
3576
3659
  */
3577
3660
  find_child_by_name(child_name: string): Clutter.Actor;
3578
3661
 
@@ -3585,6 +3668,8 @@ export namespace Meta {
3585
3668
  * This function calls the {@link Clutter.ContainerIface}.foreach()
3586
3669
  * virtual function, which has been deprecated.
3587
3670
  * @param callback a function to be called for each child
3671
+ * @since 0.4
3672
+ * @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.
3588
3673
  */
3589
3674
  foreach(callback: Clutter.Callback): void;
3590
3675
 
@@ -3596,6 +3681,8 @@ export namespace Meta {
3596
3681
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
3597
3682
  * virtual function, which has been deprecated.
3598
3683
  * @param callback a function to be called for each child
3684
+ * @since 1.0
3685
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
3599
3686
  */
3600
3687
  foreach_with_internals(callback: Clutter.Callback): void;
3601
3688
 
@@ -3604,12 +3691,15 @@ export namespace Meta {
3604
3691
  * `container` specific state for `actor`.
3605
3692
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3606
3693
  * @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
3694
+ * @since 0.8
3607
3695
  */
3608
3696
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
3609
3697
 
3610
3698
  /**
3611
3699
  * Retrieves all the children of `container`.
3612
3700
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
3701
+ * @since 0.4
3702
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
3613
3703
  */
3614
3704
  get_children(): Clutter.Actor[];
3615
3705
 
@@ -3621,6 +3711,8 @@ export namespace Meta {
3621
3711
  * `clutter_actor_set_child_below_sibling()`.
3622
3712
  * @param actor the actor to raise
3623
3713
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3714
+ * @since 0.6
3715
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3624
3716
  */
3625
3717
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3626
3718
 
@@ -3632,6 +3724,8 @@ export namespace Meta {
3632
3724
  * `clutter_actor_set_child_above_sibling()`.
3633
3725
  * @param actor the actor to raise
3634
3726
  * @param sibling the sibling to raise to, or `null` to raise to the top
3727
+ * @since 0.6
3728
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3635
3729
  */
3636
3730
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
3637
3731
 
@@ -3645,12 +3739,16 @@ export namespace Meta {
3645
3739
  * deprecated virtual function. The default implementation will call
3646
3740
  * `clutter_actor_remove_child()`.
3647
3741
  * @param actor a {@link Clutter.Actor}
3742
+ * @since 0.4
3743
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3648
3744
  */
3649
3745
  remove_actor(actor: Clutter.Actor): void;
3650
3746
 
3651
3747
  /**
3652
3748
  * Sorts a container's children using their depth. This function should not
3653
3749
  * be normally used by applications.
3750
+ * @since 0.6
3751
+ * @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.
3654
3752
  */
3655
3753
  sort_depth_order(): void;
3656
3754
 
@@ -3676,6 +3774,8 @@ export namespace Meta {
3676
3774
  * deprecated virtual function. The default implementation will
3677
3775
  * call `clutter_actor_add_child()`.
3678
3776
  * @param actor the first {@link Clutter.Actor} to add
3777
+ * @since 0.4
3778
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
3679
3779
  * @virtual
3680
3780
  */
3681
3781
  vfunc_add(actor: Clutter.Actor): void;
@@ -3686,6 +3786,7 @@ export namespace Meta {
3686
3786
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
3687
3787
  * @param child a {@link Clutter.Actor}
3688
3788
  * @param pspec a {@link GObject.ParamSpec}
3789
+ * @since 1.6
3689
3790
  * @virtual
3690
3791
  */
3691
3792
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -3701,6 +3802,7 @@ export namespace Meta {
3701
3802
  *
3702
3803
  * Applications should not call this function.
3703
3804
  * @param actor a {@link Clutter.Actor}
3805
+ * @since 1.2
3704
3806
  * @virtual
3705
3807
  */
3706
3808
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -3715,6 +3817,7 @@ export namespace Meta {
3715
3817
  *
3716
3818
  * Applications should not call this function.
3717
3819
  * @param actor a {@link Clutter.Actor}
3820
+ * @since 1.2
3718
3821
  * @virtual
3719
3822
  */
3720
3823
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -3728,6 +3831,8 @@ export namespace Meta {
3728
3831
  * This function calls the {@link Clutter.ContainerIface}.foreach()
3729
3832
  * virtual function, which has been deprecated.
3730
3833
  * @param callback a function to be called for each child
3834
+ * @since 0.4
3835
+ * @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.
3731
3836
  * @virtual
3732
3837
  */
3733
3838
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -3740,6 +3845,8 @@ export namespace Meta {
3740
3845
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
3741
3846
  * virtual function, which has been deprecated.
3742
3847
  * @param callback a function to be called for each child
3848
+ * @since 1.0
3849
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
3743
3850
  * @virtual
3744
3851
  */
3745
3852
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -3748,6 +3855,7 @@ export namespace Meta {
3748
3855
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
3749
3856
  * `container` specific state for `actor`.
3750
3857
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
3858
+ * @since 0.8
3751
3859
  * @virtual
3752
3860
  */
3753
3861
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -3760,6 +3868,8 @@ export namespace Meta {
3760
3868
  * `clutter_actor_set_child_below_sibling()`.
3761
3869
  * @param actor the actor to raise
3762
3870
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
3871
+ * @since 0.6
3872
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
3763
3873
  * @virtual
3764
3874
  */
3765
3875
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3772,6 +3882,8 @@ export namespace Meta {
3772
3882
  * `clutter_actor_set_child_above_sibling()`.
3773
3883
  * @param actor the actor to raise
3774
3884
  * @param sibling the sibling to raise to, or `null` to raise to the top
3885
+ * @since 0.6
3886
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
3775
3887
  * @virtual
3776
3888
  */
3777
3889
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -3786,6 +3898,8 @@ export namespace Meta {
3786
3898
  * deprecated virtual function. The default implementation will call
3787
3899
  * `clutter_actor_remove_child()`.
3788
3900
  * @param actor a {@link Clutter.Actor}
3901
+ * @since 0.4
3902
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
3789
3903
  * @virtual
3790
3904
  */
3791
3905
  vfunc_remove(actor: Clutter.Actor): void;
@@ -3793,6 +3907,8 @@ export namespace Meta {
3793
3907
  /**
3794
3908
  * Sorts a container's children using their depth. This function should not
3795
3909
  * be normally used by applications.
3910
+ * @since 0.6
3911
+ * @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.
3796
3912
  * @virtual
3797
3913
  */
3798
3914
  vfunc_sort_depth_order(): void;
@@ -3800,6 +3916,7 @@ export namespace Meta {
3800
3916
  /**
3801
3917
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3802
3918
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
3919
+ * @since 0.6
3803
3920
  */
3804
3921
  get_id(): string;
3805
3922
 
@@ -3811,6 +3928,7 @@ export namespace Meta {
3811
3928
  * @param name the name of the node
3812
3929
  * @param node the JSON node to be parsed
3813
3930
  * @returns `true` if the node was successfully parsed, `false` otherwise.
3931
+ * @since 0.6
3814
3932
  */
3815
3933
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
3816
3934
 
@@ -3820,6 +3938,7 @@ export namespace Meta {
3820
3938
  * @param script the {@link Clutter.Script} creating the scriptable instance
3821
3939
  * @param name the name of the property
3822
3940
  * @param value the value of the property
3941
+ * @since 0.6
3823
3942
  */
3824
3943
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
3825
3944
 
@@ -3831,11 +3950,13 @@ export namespace Meta {
3831
3950
  * define a unique name for an object constructable using the UI
3832
3951
  * definition language parsed by {@link Clutter.Script}.
3833
3952
  * @param id_ the {@link Clutter.Script} id of the object
3953
+ * @since 0.6
3834
3954
  */
3835
3955
  set_id(id_: string): void;
3836
3956
 
3837
3957
  /**
3838
3958
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
3959
+ * @since 0.6
3839
3960
  * @virtual
3840
3961
  */
3841
3962
  vfunc_get_id(): string;
@@ -3847,6 +3968,7 @@ export namespace Meta {
3847
3968
  * @param value the generic value to be set
3848
3969
  * @param name the name of the node
3849
3970
  * @param node the JSON node to be parsed
3971
+ * @since 0.6
3850
3972
  * @virtual
3851
3973
  */
3852
3974
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -3857,6 +3979,7 @@ export namespace Meta {
3857
3979
  * @param script the {@link Clutter.Script} creating the scriptable instance
3858
3980
  * @param name the name of the property
3859
3981
  * @param value the value of the property
3982
+ * @since 0.6
3860
3983
  * @virtual
3861
3984
  */
3862
3985
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -3869,6 +3992,7 @@ export namespace Meta {
3869
3992
  * define a unique name for an object constructable using the UI
3870
3993
  * definition language parsed by {@link Clutter.Script}.
3871
3994
  * @param id_ the {@link Clutter.Script} id of the object
3995
+ * @since 0.6
3872
3996
  * @virtual
3873
3997
  */
3874
3998
  vfunc_set_id(id_: string): void;
@@ -5675,6 +5799,8 @@ export namespace Meta {
5675
5799
  * @param progress the progress factor
5676
5800
  * @param value return location for the animation value
5677
5801
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
5802
+ * @since 1.0
5803
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
5678
5804
  */
5679
5805
  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;
5680
5806
 
@@ -5682,6 +5808,7 @@ export namespace Meta {
5682
5808
  * Finds the {@link GObject.ParamSpec} for `property_name`
5683
5809
  * @param property_name the name of the animatable property to find
5684
5810
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
5811
+ * @since 1.4
5685
5812
  */
5686
5813
  find_property(property_name: string): GObject.ParamSpec;
5687
5814
 
@@ -5689,6 +5816,7 @@ export namespace Meta {
5689
5816
  * Retrieves the current state of `property_name` and sets `value` with it
5690
5817
  * @param property_name the name of the animatable property to retrieve
5691
5818
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
5819
+ * @since 1.4
5692
5820
  */
5693
5821
  get_initial_state(property_name: string, value: GObject.Value | any): void;
5694
5822
 
@@ -5706,6 +5834,7 @@ export namespace Meta {
5706
5834
  * @param interval a {@link Clutter.Interval} with the animation range
5707
5835
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
5708
5836
  * @returns `true` if the interpolation was successful, and `false` otherwise
5837
+ * @since 1.8
5709
5838
  */
5710
5839
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
5711
5840
 
@@ -5713,6 +5842,7 @@ export namespace Meta {
5713
5842
  * Sets the current state of `property_name` to `value`
5714
5843
  * @param property_name the name of the animatable property to set
5715
5844
  * @param value the value of the animatable property to set
5845
+ * @since 1.4
5716
5846
  */
5717
5847
  set_final_state(property_name: string, value: GObject.Value | any): void;
5718
5848
 
@@ -5731,6 +5861,8 @@ export namespace Meta {
5731
5861
  * @param final_value the final value of the animation interval
5732
5862
  * @param progress the progress factor
5733
5863
  * @param value return location for the animation value
5864
+ * @since 1.0
5865
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
5734
5866
  * @virtual
5735
5867
  */
5736
5868
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -5738,6 +5870,7 @@ export namespace Meta {
5738
5870
  /**
5739
5871
  * Finds the {@link GObject.ParamSpec} for `property_name`
5740
5872
  * @param property_name the name of the animatable property to find
5873
+ * @since 1.4
5741
5874
  * @virtual
5742
5875
  */
5743
5876
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -5746,6 +5879,7 @@ export namespace Meta {
5746
5879
  * Retrieves the current state of `property_name` and sets `value` with it
5747
5880
  * @param property_name the name of the animatable property to retrieve
5748
5881
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
5882
+ * @since 1.4
5749
5883
  * @virtual
5750
5884
  */
5751
5885
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -5763,6 +5897,7 @@ export namespace Meta {
5763
5897
  * @param property_name the name of the property to interpolate
5764
5898
  * @param interval a {@link Clutter.Interval} with the animation range
5765
5899
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
5900
+ * @since 1.8
5766
5901
  * @virtual
5767
5902
  */
5768
5903
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -5771,6 +5906,7 @@ export namespace Meta {
5771
5906
  * Sets the current state of `property_name` to `value`
5772
5907
  * @param property_name the name of the animatable property to set
5773
5908
  * @param value the value of the animatable property to set
5909
+ * @since 1.4
5774
5910
  * @virtual
5775
5911
  */
5776
5912
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -5785,6 +5921,8 @@ export namespace Meta {
5785
5921
  * deprecated virtual function. The default implementation will
5786
5922
  * call `clutter_actor_add_child()`.
5787
5923
  * @param actor the first {@link Clutter.Actor} to add
5924
+ * @since 0.4
5925
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
5788
5926
  */
5789
5927
  add_actor(actor: Clutter.Actor): void;
5790
5928
 
@@ -5799,6 +5937,7 @@ export namespace Meta {
5799
5937
  * @param child a {@link Clutter.Actor} that is a child of `container`.
5800
5938
  * @param property the name of the property to set.
5801
5939
  * @param value the value.
5940
+ * @since 0.8
5802
5941
  */
5803
5942
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
5804
5943
 
@@ -5808,6 +5947,7 @@ export namespace Meta {
5808
5947
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
5809
5948
  * @param child a {@link Clutter.Actor}
5810
5949
  * @param pspec a {@link GObject.ParamSpec}
5950
+ * @since 1.6
5811
5951
  */
5812
5952
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
5813
5953
 
@@ -5816,6 +5956,7 @@ export namespace Meta {
5816
5956
  * @param child a {@link Clutter.Actor} that is a child of `container`.
5817
5957
  * @param property the name of the property to set.
5818
5958
  * @param value the value.
5959
+ * @since 0.8
5819
5960
  */
5820
5961
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
5821
5962
 
@@ -5830,6 +5971,7 @@ export namespace Meta {
5830
5971
  *
5831
5972
  * Applications should not call this function.
5832
5973
  * @param actor a {@link Clutter.Actor}
5974
+ * @since 1.2
5833
5975
  */
5834
5976
  create_child_meta(actor: Clutter.Actor): void;
5835
5977
 
@@ -5843,6 +5985,7 @@ export namespace Meta {
5843
5985
  *
5844
5986
  * Applications should not call this function.
5845
5987
  * @param actor a {@link Clutter.Actor}
5988
+ * @since 1.2
5846
5989
  */
5847
5990
  destroy_child_meta(actor: Clutter.Actor): void;
5848
5991
 
@@ -5851,6 +5994,7 @@ export namespace Meta {
5851
5994
  * into any child container.
5852
5995
  * @param child_name the name of the requested child.
5853
5996
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
5997
+ * @since 0.6
5854
5998
  */
5855
5999
  find_child_by_name(child_name: string): Clutter.Actor;
5856
6000
 
@@ -5863,6 +6007,8 @@ export namespace Meta {
5863
6007
  * This function calls the {@link Clutter.ContainerIface}.foreach()
5864
6008
  * virtual function, which has been deprecated.
5865
6009
  * @param callback a function to be called for each child
6010
+ * @since 0.4
6011
+ * @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.
5866
6012
  */
5867
6013
  foreach(callback: Clutter.Callback): void;
5868
6014
 
@@ -5874,6 +6020,8 @@ export namespace Meta {
5874
6020
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
5875
6021
  * virtual function, which has been deprecated.
5876
6022
  * @param callback a function to be called for each child
6023
+ * @since 1.0
6024
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
5877
6025
  */
5878
6026
  foreach_with_internals(callback: Clutter.Callback): void;
5879
6027
 
@@ -5882,12 +6030,15 @@ export namespace Meta {
5882
6030
  * `container` specific state for `actor`.
5883
6031
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
5884
6032
  * @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
6033
+ * @since 0.8
5885
6034
  */
5886
6035
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
5887
6036
 
5888
6037
  /**
5889
6038
  * Retrieves all the children of `container`.
5890
6039
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
6040
+ * @since 0.4
6041
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
5891
6042
  */
5892
6043
  get_children(): Clutter.Actor[];
5893
6044
 
@@ -5899,6 +6050,8 @@ export namespace Meta {
5899
6050
  * `clutter_actor_set_child_below_sibling()`.
5900
6051
  * @param actor the actor to raise
5901
6052
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
6053
+ * @since 0.6
6054
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
5902
6055
  */
5903
6056
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
5904
6057
 
@@ -5910,6 +6063,8 @@ export namespace Meta {
5910
6063
  * `clutter_actor_set_child_above_sibling()`.
5911
6064
  * @param actor the actor to raise
5912
6065
  * @param sibling the sibling to raise to, or `null` to raise to the top
6066
+ * @since 0.6
6067
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
5913
6068
  */
5914
6069
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
5915
6070
 
@@ -5923,12 +6078,16 @@ export namespace Meta {
5923
6078
  * deprecated virtual function. The default implementation will call
5924
6079
  * `clutter_actor_remove_child()`.
5925
6080
  * @param actor a {@link Clutter.Actor}
6081
+ * @since 0.4
6082
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
5926
6083
  */
5927
6084
  remove_actor(actor: Clutter.Actor): void;
5928
6085
 
5929
6086
  /**
5930
6087
  * Sorts a container's children using their depth. This function should not
5931
6088
  * be normally used by applications.
6089
+ * @since 0.6
6090
+ * @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.
5932
6091
  */
5933
6092
  sort_depth_order(): void;
5934
6093
 
@@ -5954,6 +6113,8 @@ export namespace Meta {
5954
6113
  * deprecated virtual function. The default implementation will
5955
6114
  * call `clutter_actor_add_child()`.
5956
6115
  * @param actor the first {@link Clutter.Actor} to add
6116
+ * @since 0.4
6117
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
5957
6118
  * @virtual
5958
6119
  */
5959
6120
  vfunc_add(actor: Clutter.Actor): void;
@@ -5964,6 +6125,7 @@ export namespace Meta {
5964
6125
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
5965
6126
  * @param child a {@link Clutter.Actor}
5966
6127
  * @param pspec a {@link GObject.ParamSpec}
6128
+ * @since 1.6
5967
6129
  * @virtual
5968
6130
  */
5969
6131
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -5979,6 +6141,7 @@ export namespace Meta {
5979
6141
  *
5980
6142
  * Applications should not call this function.
5981
6143
  * @param actor a {@link Clutter.Actor}
6144
+ * @since 1.2
5982
6145
  * @virtual
5983
6146
  */
5984
6147
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -5993,6 +6156,7 @@ export namespace Meta {
5993
6156
  *
5994
6157
  * Applications should not call this function.
5995
6158
  * @param actor a {@link Clutter.Actor}
6159
+ * @since 1.2
5996
6160
  * @virtual
5997
6161
  */
5998
6162
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -6006,6 +6170,8 @@ export namespace Meta {
6006
6170
  * This function calls the {@link Clutter.ContainerIface}.foreach()
6007
6171
  * virtual function, which has been deprecated.
6008
6172
  * @param callback a function to be called for each child
6173
+ * @since 0.4
6174
+ * @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.
6009
6175
  * @virtual
6010
6176
  */
6011
6177
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -6018,6 +6184,8 @@ export namespace Meta {
6018
6184
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
6019
6185
  * virtual function, which has been deprecated.
6020
6186
  * @param callback a function to be called for each child
6187
+ * @since 1.0
6188
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
6021
6189
  * @virtual
6022
6190
  */
6023
6191
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -6026,6 +6194,7 @@ export namespace Meta {
6026
6194
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
6027
6195
  * `container` specific state for `actor`.
6028
6196
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
6197
+ * @since 0.8
6029
6198
  * @virtual
6030
6199
  */
6031
6200
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -6038,6 +6207,8 @@ export namespace Meta {
6038
6207
  * `clutter_actor_set_child_below_sibling()`.
6039
6208
  * @param actor the actor to raise
6040
6209
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
6210
+ * @since 0.6
6211
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
6041
6212
  * @virtual
6042
6213
  */
6043
6214
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -6050,6 +6221,8 @@ export namespace Meta {
6050
6221
  * `clutter_actor_set_child_above_sibling()`.
6051
6222
  * @param actor the actor to raise
6052
6223
  * @param sibling the sibling to raise to, or `null` to raise to the top
6224
+ * @since 0.6
6225
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
6053
6226
  * @virtual
6054
6227
  */
6055
6228
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -6064,6 +6237,8 @@ export namespace Meta {
6064
6237
  * deprecated virtual function. The default implementation will call
6065
6238
  * `clutter_actor_remove_child()`.
6066
6239
  * @param actor a {@link Clutter.Actor}
6240
+ * @since 0.4
6241
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
6067
6242
  * @virtual
6068
6243
  */
6069
6244
  vfunc_remove(actor: Clutter.Actor): void;
@@ -6071,6 +6246,8 @@ export namespace Meta {
6071
6246
  /**
6072
6247
  * Sorts a container's children using their depth. This function should not
6073
6248
  * be normally used by applications.
6249
+ * @since 0.6
6250
+ * @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.
6074
6251
  * @virtual
6075
6252
  */
6076
6253
  vfunc_sort_depth_order(): void;
@@ -6078,6 +6255,7 @@ export namespace Meta {
6078
6255
  /**
6079
6256
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
6080
6257
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
6258
+ * @since 0.6
6081
6259
  */
6082
6260
  get_id(): string;
6083
6261
 
@@ -6089,6 +6267,7 @@ export namespace Meta {
6089
6267
  * @param name the name of the node
6090
6268
  * @param node the JSON node to be parsed
6091
6269
  * @returns `true` if the node was successfully parsed, `false` otherwise.
6270
+ * @since 0.6
6092
6271
  */
6093
6272
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
6094
6273
 
@@ -6098,6 +6277,7 @@ export namespace Meta {
6098
6277
  * @param script the {@link Clutter.Script} creating the scriptable instance
6099
6278
  * @param name the name of the property
6100
6279
  * @param value the value of the property
6280
+ * @since 0.6
6101
6281
  */
6102
6282
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
6103
6283
 
@@ -6109,11 +6289,13 @@ export namespace Meta {
6109
6289
  * define a unique name for an object constructable using the UI
6110
6290
  * definition language parsed by {@link Clutter.Script}.
6111
6291
  * @param id_ the {@link Clutter.Script} id of the object
6292
+ * @since 0.6
6112
6293
  */
6113
6294
  set_id(id_: string): void;
6114
6295
 
6115
6296
  /**
6116
6297
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
6298
+ * @since 0.6
6117
6299
  * @virtual
6118
6300
  */
6119
6301
  vfunc_get_id(): string;
@@ -6125,6 +6307,7 @@ export namespace Meta {
6125
6307
  * @param value the generic value to be set
6126
6308
  * @param name the name of the node
6127
6309
  * @param node the JSON node to be parsed
6310
+ * @since 0.6
6128
6311
  * @virtual
6129
6312
  */
6130
6313
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -6135,6 +6318,7 @@ export namespace Meta {
6135
6318
  * @param script the {@link Clutter.Script} creating the scriptable instance
6136
6319
  * @param name the name of the property
6137
6320
  * @param value the value of the property
6321
+ * @since 0.6
6138
6322
  * @virtual
6139
6323
  */
6140
6324
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -6147,6 +6331,7 @@ export namespace Meta {
6147
6331
  * define a unique name for an object constructable using the UI
6148
6332
  * definition language parsed by {@link Clutter.Script}.
6149
6333
  * @param id_ the {@link Clutter.Script} id of the object
6334
+ * @since 0.6
6150
6335
  * @virtual
6151
6336
  */
6152
6337
  vfunc_set_id(id_: string): void;
@@ -7672,6 +7857,8 @@ export namespace Meta {
7672
7857
  * @param progress the progress factor
7673
7858
  * @param value return location for the animation value
7674
7859
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
7860
+ * @since 1.0
7861
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
7675
7862
  */
7676
7863
  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;
7677
7864
 
@@ -7679,6 +7866,7 @@ export namespace Meta {
7679
7866
  * Finds the {@link GObject.ParamSpec} for `property_name`
7680
7867
  * @param property_name the name of the animatable property to find
7681
7868
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
7869
+ * @since 1.4
7682
7870
  */
7683
7871
  find_property(property_name: string): GObject.ParamSpec;
7684
7872
 
@@ -7686,6 +7874,7 @@ export namespace Meta {
7686
7874
  * Retrieves the current state of `property_name` and sets `value` with it
7687
7875
  * @param property_name the name of the animatable property to retrieve
7688
7876
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
7877
+ * @since 1.4
7689
7878
  */
7690
7879
  get_initial_state(property_name: string, value: GObject.Value | any): void;
7691
7880
 
@@ -7703,6 +7892,7 @@ export namespace Meta {
7703
7892
  * @param interval a {@link Clutter.Interval} with the animation range
7704
7893
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
7705
7894
  * @returns `true` if the interpolation was successful, and `false` otherwise
7895
+ * @since 1.8
7706
7896
  */
7707
7897
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
7708
7898
 
@@ -7710,6 +7900,7 @@ export namespace Meta {
7710
7900
  * Sets the current state of `property_name` to `value`
7711
7901
  * @param property_name the name of the animatable property to set
7712
7902
  * @param value the value of the animatable property to set
7903
+ * @since 1.4
7713
7904
  */
7714
7905
  set_final_state(property_name: string, value: GObject.Value | any): void;
7715
7906
 
@@ -7728,6 +7919,8 @@ export namespace Meta {
7728
7919
  * @param final_value the final value of the animation interval
7729
7920
  * @param progress the progress factor
7730
7921
  * @param value return location for the animation value
7922
+ * @since 1.0
7923
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
7731
7924
  * @virtual
7732
7925
  */
7733
7926
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -7735,6 +7928,7 @@ export namespace Meta {
7735
7928
  /**
7736
7929
  * Finds the {@link GObject.ParamSpec} for `property_name`
7737
7930
  * @param property_name the name of the animatable property to find
7931
+ * @since 1.4
7738
7932
  * @virtual
7739
7933
  */
7740
7934
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -7743,6 +7937,7 @@ export namespace Meta {
7743
7937
  * Retrieves the current state of `property_name` and sets `value` with it
7744
7938
  * @param property_name the name of the animatable property to retrieve
7745
7939
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
7940
+ * @since 1.4
7746
7941
  * @virtual
7747
7942
  */
7748
7943
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -7760,6 +7955,7 @@ export namespace Meta {
7760
7955
  * @param property_name the name of the property to interpolate
7761
7956
  * @param interval a {@link Clutter.Interval} with the animation range
7762
7957
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
7958
+ * @since 1.8
7763
7959
  * @virtual
7764
7960
  */
7765
7961
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -7768,6 +7964,7 @@ export namespace Meta {
7768
7964
  * Sets the current state of `property_name` to `value`
7769
7965
  * @param property_name the name of the animatable property to set
7770
7966
  * @param value the value of the animatable property to set
7967
+ * @since 1.4
7771
7968
  * @virtual
7772
7969
  */
7773
7970
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -7782,6 +7979,8 @@ export namespace Meta {
7782
7979
  * deprecated virtual function. The default implementation will
7783
7980
  * call `clutter_actor_add_child()`.
7784
7981
  * @param actor the first {@link Clutter.Actor} to add
7982
+ * @since 0.4
7983
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
7785
7984
  */
7786
7985
  add_actor(actor: Clutter.Actor): void;
7787
7986
 
@@ -7796,6 +7995,7 @@ export namespace Meta {
7796
7995
  * @param child a {@link Clutter.Actor} that is a child of `container`.
7797
7996
  * @param property the name of the property to set.
7798
7997
  * @param value the value.
7998
+ * @since 0.8
7799
7999
  */
7800
8000
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
7801
8001
 
@@ -7805,6 +8005,7 @@ export namespace Meta {
7805
8005
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
7806
8006
  * @param child a {@link Clutter.Actor}
7807
8007
  * @param pspec a {@link GObject.ParamSpec}
8008
+ * @since 1.6
7808
8009
  */
7809
8010
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
7810
8011
 
@@ -7813,6 +8014,7 @@ export namespace Meta {
7813
8014
  * @param child a {@link Clutter.Actor} that is a child of `container`.
7814
8015
  * @param property the name of the property to set.
7815
8016
  * @param value the value.
8017
+ * @since 0.8
7816
8018
  */
7817
8019
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
7818
8020
 
@@ -7827,6 +8029,7 @@ export namespace Meta {
7827
8029
  *
7828
8030
  * Applications should not call this function.
7829
8031
  * @param actor a {@link Clutter.Actor}
8032
+ * @since 1.2
7830
8033
  */
7831
8034
  create_child_meta(actor: Clutter.Actor): void;
7832
8035
 
@@ -7840,6 +8043,7 @@ export namespace Meta {
7840
8043
  *
7841
8044
  * Applications should not call this function.
7842
8045
  * @param actor a {@link Clutter.Actor}
8046
+ * @since 1.2
7843
8047
  */
7844
8048
  destroy_child_meta(actor: Clutter.Actor): void;
7845
8049
 
@@ -7848,6 +8052,7 @@ export namespace Meta {
7848
8052
  * into any child container.
7849
8053
  * @param child_name the name of the requested child.
7850
8054
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
8055
+ * @since 0.6
7851
8056
  */
7852
8057
  find_child_by_name(child_name: string): Clutter.Actor;
7853
8058
 
@@ -7860,6 +8065,8 @@ export namespace Meta {
7860
8065
  * This function calls the {@link Clutter.ContainerIface}.foreach()
7861
8066
  * virtual function, which has been deprecated.
7862
8067
  * @param callback a function to be called for each child
8068
+ * @since 0.4
8069
+ * @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.
7863
8070
  */
7864
8071
  foreach(callback: Clutter.Callback): void;
7865
8072
 
@@ -7871,6 +8078,8 @@ export namespace Meta {
7871
8078
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
7872
8079
  * virtual function, which has been deprecated.
7873
8080
  * @param callback a function to be called for each child
8081
+ * @since 1.0
8082
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
7874
8083
  */
7875
8084
  foreach_with_internals(callback: Clutter.Callback): void;
7876
8085
 
@@ -7879,12 +8088,15 @@ export namespace Meta {
7879
8088
  * `container` specific state for `actor`.
7880
8089
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
7881
8090
  * @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
8091
+ * @since 0.8
7882
8092
  */
7883
8093
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
7884
8094
 
7885
8095
  /**
7886
8096
  * Retrieves all the children of `container`.
7887
8097
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
8098
+ * @since 0.4
8099
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
7888
8100
  */
7889
8101
  get_children(): Clutter.Actor[];
7890
8102
 
@@ -7896,6 +8108,8 @@ export namespace Meta {
7896
8108
  * `clutter_actor_set_child_below_sibling()`.
7897
8109
  * @param actor the actor to raise
7898
8110
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8111
+ * @since 0.6
8112
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
7899
8113
  */
7900
8114
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
7901
8115
 
@@ -7907,6 +8121,8 @@ export namespace Meta {
7907
8121
  * `clutter_actor_set_child_above_sibling()`.
7908
8122
  * @param actor the actor to raise
7909
8123
  * @param sibling the sibling to raise to, or `null` to raise to the top
8124
+ * @since 0.6
8125
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
7910
8126
  */
7911
8127
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
7912
8128
 
@@ -7920,12 +8136,16 @@ export namespace Meta {
7920
8136
  * deprecated virtual function. The default implementation will call
7921
8137
  * `clutter_actor_remove_child()`.
7922
8138
  * @param actor a {@link Clutter.Actor}
8139
+ * @since 0.4
8140
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
7923
8141
  */
7924
8142
  remove_actor(actor: Clutter.Actor): void;
7925
8143
 
7926
8144
  /**
7927
8145
  * Sorts a container's children using their depth. This function should not
7928
8146
  * be normally used by applications.
8147
+ * @since 0.6
8148
+ * @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.
7929
8149
  */
7930
8150
  sort_depth_order(): void;
7931
8151
 
@@ -7951,6 +8171,8 @@ export namespace Meta {
7951
8171
  * deprecated virtual function. The default implementation will
7952
8172
  * call `clutter_actor_add_child()`.
7953
8173
  * @param actor the first {@link Clutter.Actor} to add
8174
+ * @since 0.4
8175
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
7954
8176
  * @virtual
7955
8177
  */
7956
8178
  vfunc_add(actor: Clutter.Actor): void;
@@ -7961,6 +8183,7 @@ export namespace Meta {
7961
8183
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
7962
8184
  * @param child a {@link Clutter.Actor}
7963
8185
  * @param pspec a {@link GObject.ParamSpec}
8186
+ * @since 1.6
7964
8187
  * @virtual
7965
8188
  */
7966
8189
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -7976,6 +8199,7 @@ export namespace Meta {
7976
8199
  *
7977
8200
  * Applications should not call this function.
7978
8201
  * @param actor a {@link Clutter.Actor}
8202
+ * @since 1.2
7979
8203
  * @virtual
7980
8204
  */
7981
8205
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -7990,6 +8214,7 @@ export namespace Meta {
7990
8214
  *
7991
8215
  * Applications should not call this function.
7992
8216
  * @param actor a {@link Clutter.Actor}
8217
+ * @since 1.2
7993
8218
  * @virtual
7994
8219
  */
7995
8220
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -8003,6 +8228,8 @@ export namespace Meta {
8003
8228
  * This function calls the {@link Clutter.ContainerIface}.foreach()
8004
8229
  * virtual function, which has been deprecated.
8005
8230
  * @param callback a function to be called for each child
8231
+ * @since 0.4
8232
+ * @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.
8006
8233
  * @virtual
8007
8234
  */
8008
8235
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -8015,6 +8242,8 @@ export namespace Meta {
8015
8242
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
8016
8243
  * virtual function, which has been deprecated.
8017
8244
  * @param callback a function to be called for each child
8245
+ * @since 1.0
8246
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
8018
8247
  * @virtual
8019
8248
  */
8020
8249
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -8023,6 +8252,7 @@ export namespace Meta {
8023
8252
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
8024
8253
  * `container` specific state for `actor`.
8025
8254
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
8255
+ * @since 0.8
8026
8256
  * @virtual
8027
8257
  */
8028
8258
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -8035,6 +8265,8 @@ export namespace Meta {
8035
8265
  * `clutter_actor_set_child_below_sibling()`.
8036
8266
  * @param actor the actor to raise
8037
8267
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8268
+ * @since 0.6
8269
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
8038
8270
  * @virtual
8039
8271
  */
8040
8272
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -8047,6 +8279,8 @@ export namespace Meta {
8047
8279
  * `clutter_actor_set_child_above_sibling()`.
8048
8280
  * @param actor the actor to raise
8049
8281
  * @param sibling the sibling to raise to, or `null` to raise to the top
8282
+ * @since 0.6
8283
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
8050
8284
  * @virtual
8051
8285
  */
8052
8286
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -8061,6 +8295,8 @@ export namespace Meta {
8061
8295
  * deprecated virtual function. The default implementation will call
8062
8296
  * `clutter_actor_remove_child()`.
8063
8297
  * @param actor a {@link Clutter.Actor}
8298
+ * @since 0.4
8299
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
8064
8300
  * @virtual
8065
8301
  */
8066
8302
  vfunc_remove(actor: Clutter.Actor): void;
@@ -8068,6 +8304,8 @@ export namespace Meta {
8068
8304
  /**
8069
8305
  * Sorts a container's children using their depth. This function should not
8070
8306
  * be normally used by applications.
8307
+ * @since 0.6
8308
+ * @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.
8071
8309
  * @virtual
8072
8310
  */
8073
8311
  vfunc_sort_depth_order(): void;
@@ -8075,6 +8313,7 @@ export namespace Meta {
8075
8313
  /**
8076
8314
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
8077
8315
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
8316
+ * @since 0.6
8078
8317
  */
8079
8318
  get_id(): string;
8080
8319
 
@@ -8086,6 +8325,7 @@ export namespace Meta {
8086
8325
  * @param name the name of the node
8087
8326
  * @param node the JSON node to be parsed
8088
8327
  * @returns `true` if the node was successfully parsed, `false` otherwise.
8328
+ * @since 0.6
8089
8329
  */
8090
8330
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
8091
8331
 
@@ -8095,6 +8335,7 @@ export namespace Meta {
8095
8335
  * @param script the {@link Clutter.Script} creating the scriptable instance
8096
8336
  * @param name the name of the property
8097
8337
  * @param value the value of the property
8338
+ * @since 0.6
8098
8339
  */
8099
8340
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
8100
8341
 
@@ -8106,11 +8347,13 @@ export namespace Meta {
8106
8347
  * define a unique name for an object constructable using the UI
8107
8348
  * definition language parsed by {@link Clutter.Script}.
8108
8349
  * @param id_ the {@link Clutter.Script} id of the object
8350
+ * @since 0.6
8109
8351
  */
8110
8352
  set_id(id_: string): void;
8111
8353
 
8112
8354
  /**
8113
8355
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
8356
+ * @since 0.6
8114
8357
  * @virtual
8115
8358
  */
8116
8359
  vfunc_get_id(): string;
@@ -8122,6 +8365,7 @@ export namespace Meta {
8122
8365
  * @param value the generic value to be set
8123
8366
  * @param name the name of the node
8124
8367
  * @param node the JSON node to be parsed
8368
+ * @since 0.6
8125
8369
  * @virtual
8126
8370
  */
8127
8371
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -8132,6 +8376,7 @@ export namespace Meta {
8132
8376
  * @param script the {@link Clutter.Script} creating the scriptable instance
8133
8377
  * @param name the name of the property
8134
8378
  * @param value the value of the property
8379
+ * @since 0.6
8135
8380
  * @virtual
8136
8381
  */
8137
8382
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -8144,6 +8389,7 @@ export namespace Meta {
8144
8389
  * define a unique name for an object constructable using the UI
8145
8390
  * definition language parsed by {@link Clutter.Script}.
8146
8391
  * @param id_ the {@link Clutter.Script} id of the object
8392
+ * @since 0.6
8147
8393
  * @virtual
8148
8394
  */
8149
8395
  vfunc_set_id(id_: string): void;
@@ -8290,6 +8536,8 @@ export namespace Meta {
8290
8536
  * @param progress the progress factor
8291
8537
  * @param value return location for the animation value
8292
8538
  * @returns `true` if the value has been validated and can be applied to the {@link Clutter.Animatable}, and `false` otherwise
8539
+ * @since 1.0
8540
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
8293
8541
  */
8294
8542
  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;
8295
8543
 
@@ -8297,6 +8545,7 @@ export namespace Meta {
8297
8545
  * Finds the {@link GObject.ParamSpec} for `property_name`
8298
8546
  * @param property_name the name of the animatable property to find
8299
8547
  * @returns The {@link GObject.ParamSpec} for the given property or `null`
8548
+ * @since 1.4
8300
8549
  */
8301
8550
  find_property(property_name: string): GObject.ParamSpec;
8302
8551
 
@@ -8304,6 +8553,7 @@ export namespace Meta {
8304
8553
  * Retrieves the current state of `property_name` and sets `value` with it
8305
8554
  * @param property_name the name of the animatable property to retrieve
8306
8555
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
8556
+ * @since 1.4
8307
8557
  */
8308
8558
  get_initial_state(property_name: string, value: GObject.Value | any): void;
8309
8559
 
@@ -8321,6 +8571,7 @@ export namespace Meta {
8321
8571
  * @param interval a {@link Clutter.Interval} with the animation range
8322
8572
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
8323
8573
  * @returns `true` if the interpolation was successful, and `false` otherwise
8574
+ * @since 1.8
8324
8575
  */
8325
8576
  interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, unknown];
8326
8577
 
@@ -8328,6 +8579,7 @@ export namespace Meta {
8328
8579
  * Sets the current state of `property_name` to `value`
8329
8580
  * @param property_name the name of the animatable property to set
8330
8581
  * @param value the value of the animatable property to set
8582
+ * @since 1.4
8331
8583
  */
8332
8584
  set_final_state(property_name: string, value: GObject.Value | any): void;
8333
8585
 
@@ -8346,6 +8598,8 @@ export namespace Meta {
8346
8598
  * @param final_value the final value of the animation interval
8347
8599
  * @param progress the progress factor
8348
8600
  * @param value return location for the animation value
8601
+ * @since 1.0
8602
+ * @deprecated since 1.8: Use `clutter_animatable_interpolate_value()` instead
8349
8603
  * @virtual
8350
8604
  */
8351
8605
  vfunc_animate_property(animation: Clutter.Animation, property_name: string, initial_value: unknown, final_value: unknown, progress: number, value: unknown): boolean;
@@ -8353,6 +8607,7 @@ export namespace Meta {
8353
8607
  /**
8354
8608
  * Finds the {@link GObject.ParamSpec} for `property_name`
8355
8609
  * @param property_name the name of the animatable property to find
8610
+ * @since 1.4
8356
8611
  * @virtual
8357
8612
  */
8358
8613
  vfunc_find_property(property_name: string): GObject.ParamSpec;
@@ -8361,6 +8616,7 @@ export namespace Meta {
8361
8616
  * Retrieves the current state of `property_name` and sets `value` with it
8362
8617
  * @param property_name the name of the animatable property to retrieve
8363
8618
  * @param value a {@link GObject.Value} initialized to the type of the property to retrieve
8619
+ * @since 1.4
8364
8620
  * @virtual
8365
8621
  */
8366
8622
  vfunc_get_initial_state(property_name: string, value: unknown): void;
@@ -8378,6 +8634,7 @@ export namespace Meta {
8378
8634
  * @param property_name the name of the property to interpolate
8379
8635
  * @param interval a {@link Clutter.Interval} with the animation range
8380
8636
  * @param progress the progress to use to interpolate between the initial and final values of the `interval`
8637
+ * @since 1.8
8381
8638
  * @virtual
8382
8639
  */
8383
8640
  vfunc_interpolate_value(property_name: string, interval: Clutter.Interval, progress: number): [boolean, GObject.Value | any];
@@ -8386,6 +8643,7 @@ export namespace Meta {
8386
8643
  * Sets the current state of `property_name` to `value`
8387
8644
  * @param property_name the name of the animatable property to set
8388
8645
  * @param value the value of the animatable property to set
8646
+ * @since 1.4
8389
8647
  * @virtual
8390
8648
  */
8391
8649
  vfunc_set_final_state(property_name: string, value: unknown): void;
@@ -8400,6 +8658,8 @@ export namespace Meta {
8400
8658
  * deprecated virtual function. The default implementation will
8401
8659
  * call `clutter_actor_add_child()`.
8402
8660
  * @param actor the first {@link Clutter.Actor} to add
8661
+ * @since 0.4
8662
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
8403
8663
  */
8404
8664
  add_actor(actor: Clutter.Actor): void;
8405
8665
 
@@ -8414,6 +8674,7 @@ export namespace Meta {
8414
8674
  * @param child a {@link Clutter.Actor} that is a child of `container`.
8415
8675
  * @param property the name of the property to set.
8416
8676
  * @param value the value.
8677
+ * @since 0.8
8417
8678
  */
8418
8679
  child_get_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
8419
8680
 
@@ -8423,6 +8684,7 @@ export namespace Meta {
8423
8684
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
8424
8685
  * @param child a {@link Clutter.Actor}
8425
8686
  * @param pspec a {@link GObject.ParamSpec}
8687
+ * @since 1.6
8426
8688
  */
8427
8689
  child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
8428
8690
 
@@ -8431,6 +8693,7 @@ export namespace Meta {
8431
8693
  * @param child a {@link Clutter.Actor} that is a child of `container`.
8432
8694
  * @param property the name of the property to set.
8433
8695
  * @param value the value.
8696
+ * @since 0.8
8434
8697
  */
8435
8698
  child_set_property(child: Clutter.Actor, property: string, value: GObject.Value | any): void;
8436
8699
 
@@ -8445,6 +8708,7 @@ export namespace Meta {
8445
8708
  *
8446
8709
  * Applications should not call this function.
8447
8710
  * @param actor a {@link Clutter.Actor}
8711
+ * @since 1.2
8448
8712
  */
8449
8713
  create_child_meta(actor: Clutter.Actor): void;
8450
8714
 
@@ -8458,6 +8722,7 @@ export namespace Meta {
8458
8722
  *
8459
8723
  * Applications should not call this function.
8460
8724
  * @param actor a {@link Clutter.Actor}
8725
+ * @since 1.2
8461
8726
  */
8462
8727
  destroy_child_meta(actor: Clutter.Actor): void;
8463
8728
 
@@ -8466,6 +8731,7 @@ export namespace Meta {
8466
8731
  * into any child container.
8467
8732
  * @param child_name the name of the requested child.
8468
8733
  * @returns The child actor with the requested name, or `null` if no actor with that name was found.
8734
+ * @since 0.6
8469
8735
  */
8470
8736
  find_child_by_name(child_name: string): Clutter.Actor;
8471
8737
 
@@ -8478,6 +8744,8 @@ export namespace Meta {
8478
8744
  * This function calls the {@link Clutter.ContainerIface}.foreach()
8479
8745
  * virtual function, which has been deprecated.
8480
8746
  * @param callback a function to be called for each child
8747
+ * @since 0.4
8748
+ * @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.
8481
8749
  */
8482
8750
  foreach(callback: Clutter.Callback): void;
8483
8751
 
@@ -8489,6 +8757,8 @@ export namespace Meta {
8489
8757
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
8490
8758
  * virtual function, which has been deprecated.
8491
8759
  * @param callback a function to be called for each child
8760
+ * @since 1.0
8761
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
8492
8762
  */
8493
8763
  foreach_with_internals(callback: Clutter.Callback): void;
8494
8764
 
@@ -8497,12 +8767,15 @@ export namespace Meta {
8497
8767
  * `container` specific state for `actor`.
8498
8768
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
8499
8769
  * @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
8770
+ * @since 0.8
8500
8771
  */
8501
8772
  get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
8502
8773
 
8503
8774
  /**
8504
8775
  * Retrieves all the children of `container`.
8505
8776
  * @returns a list of {@link Clutter.Actor}<!-- -->s. Use `g_list_free()` on the returned list when done.
8777
+ * @since 0.4
8778
+ * @deprecated since 1.10: Use `clutter_actor_get_children()` instead.
8506
8779
  */
8507
8780
  get_children(): Clutter.Actor[];
8508
8781
 
@@ -8514,6 +8787,8 @@ export namespace Meta {
8514
8787
  * `clutter_actor_set_child_below_sibling()`.
8515
8788
  * @param actor the actor to raise
8516
8789
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8790
+ * @since 0.6
8791
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
8517
8792
  */
8518
8793
  lower_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
8519
8794
 
@@ -8525,6 +8800,8 @@ export namespace Meta {
8525
8800
  * `clutter_actor_set_child_above_sibling()`.
8526
8801
  * @param actor the actor to raise
8527
8802
  * @param sibling the sibling to raise to, or `null` to raise to the top
8803
+ * @since 0.6
8804
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
8528
8805
  */
8529
8806
  raise_child(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
8530
8807
 
@@ -8538,12 +8815,16 @@ export namespace Meta {
8538
8815
  * deprecated virtual function. The default implementation will call
8539
8816
  * `clutter_actor_remove_child()`.
8540
8817
  * @param actor a {@link Clutter.Actor}
8818
+ * @since 0.4
8819
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
8541
8820
  */
8542
8821
  remove_actor(actor: Clutter.Actor): void;
8543
8822
 
8544
8823
  /**
8545
8824
  * Sorts a container's children using their depth. This function should not
8546
8825
  * be normally used by applications.
8826
+ * @since 0.6
8827
+ * @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.
8547
8828
  */
8548
8829
  sort_depth_order(): void;
8549
8830
 
@@ -8569,6 +8850,8 @@ export namespace Meta {
8569
8850
  * deprecated virtual function. The default implementation will
8570
8851
  * call `clutter_actor_add_child()`.
8571
8852
  * @param actor the first {@link Clutter.Actor} to add
8853
+ * @since 0.4
8854
+ * @deprecated since 1.10: Use `clutter_actor_add_child()` instead.
8572
8855
  * @virtual
8573
8856
  */
8574
8857
  vfunc_add(actor: Clutter.Actor): void;
@@ -8579,6 +8862,7 @@ export namespace Meta {
8579
8862
  * {@link Clutter.Container.SignalSignatures.child_notify | Clutter.Container::child-notify} signal.
8580
8863
  * @param child a {@link Clutter.Actor}
8581
8864
  * @param pspec a {@link GObject.ParamSpec}
8865
+ * @since 1.6
8582
8866
  * @virtual
8583
8867
  */
8584
8868
  vfunc_child_notify(child: Clutter.Actor, pspec: GObject.ParamSpec): void;
@@ -8594,6 +8878,7 @@ export namespace Meta {
8594
8878
  *
8595
8879
  * Applications should not call this function.
8596
8880
  * @param actor a {@link Clutter.Actor}
8881
+ * @since 1.2
8597
8882
  * @virtual
8598
8883
  */
8599
8884
  vfunc_create_child_meta(actor: Clutter.Actor): void;
@@ -8608,6 +8893,7 @@ export namespace Meta {
8608
8893
  *
8609
8894
  * Applications should not call this function.
8610
8895
  * @param actor a {@link Clutter.Actor}
8896
+ * @since 1.2
8611
8897
  * @virtual
8612
8898
  */
8613
8899
  vfunc_destroy_child_meta(actor: Clutter.Actor): void;
@@ -8621,6 +8907,8 @@ export namespace Meta {
8621
8907
  * This function calls the {@link Clutter.ContainerIface}.foreach()
8622
8908
  * virtual function, which has been deprecated.
8623
8909
  * @param callback a function to be called for each child
8910
+ * @since 0.4
8911
+ * @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.
8624
8912
  * @virtual
8625
8913
  */
8626
8914
  vfunc_foreach(callback: Clutter.Callback): void;
@@ -8633,6 +8921,8 @@ export namespace Meta {
8633
8921
  * This function calls the {@link Clutter.ContainerIface}.foreach_with_internals()
8634
8922
  * virtual function, which has been deprecated.
8635
8923
  * @param callback a function to be called for each child
8924
+ * @since 1.0
8925
+ * @deprecated since 1.10: See `clutter_container_foreach()`.
8636
8926
  * @virtual
8637
8927
  */
8638
8928
  vfunc_foreach_with_internals(callback: Clutter.Callback): void;
@@ -8641,6 +8931,7 @@ export namespace Meta {
8641
8931
  * Retrieves the {@link Clutter.ChildMeta} which contains the data about the
8642
8932
  * `container` specific state for `actor`.
8643
8933
  * @param actor a {@link Clutter.Actor} that is a child of `container`.
8934
+ * @since 0.8
8644
8935
  * @virtual
8645
8936
  */
8646
8937
  vfunc_get_child_meta(actor: Clutter.Actor): Clutter.ChildMeta;
@@ -8653,6 +8944,8 @@ export namespace Meta {
8653
8944
  * `clutter_actor_set_child_below_sibling()`.
8654
8945
  * @param actor the actor to raise
8655
8946
  * @param sibling the sibling to lower to, or `null` to lower to the bottom
8947
+ * @since 0.6
8948
+ * @deprecated since 1.10: Use `clutter_actor_set_child_below_sibling()` instead.
8656
8949
  * @virtual
8657
8950
  */
8658
8951
  vfunc_lower(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -8665,6 +8958,8 @@ export namespace Meta {
8665
8958
  * `clutter_actor_set_child_above_sibling()`.
8666
8959
  * @param actor the actor to raise
8667
8960
  * @param sibling the sibling to raise to, or `null` to raise to the top
8961
+ * @since 0.6
8962
+ * @deprecated since 1.10: Use `clutter_actor_set_child_above_sibling()` instead.
8668
8963
  * @virtual
8669
8964
  */
8670
8965
  vfunc_raise(actor: Clutter.Actor, sibling: Clutter.Actor | null): void;
@@ -8679,6 +8974,8 @@ export namespace Meta {
8679
8974
  * deprecated virtual function. The default implementation will call
8680
8975
  * `clutter_actor_remove_child()`.
8681
8976
  * @param actor a {@link Clutter.Actor}
8977
+ * @since 0.4
8978
+ * @deprecated since 1.10: Use `clutter_actor_remove_child()` instead.
8682
8979
  * @virtual
8683
8980
  */
8684
8981
  vfunc_remove(actor: Clutter.Actor): void;
@@ -8686,6 +8983,8 @@ export namespace Meta {
8686
8983
  /**
8687
8984
  * Sorts a container's children using their depth. This function should not
8688
8985
  * be normally used by applications.
8986
+ * @since 0.6
8987
+ * @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.
8689
8988
  * @virtual
8690
8989
  */
8691
8990
  vfunc_sort_depth_order(): void;
@@ -8693,6 +8992,7 @@ export namespace Meta {
8693
8992
  /**
8694
8993
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
8695
8994
  * @returns the id of the object. The returned string is owned by the scriptable object and should never be modified of freed
8995
+ * @since 0.6
8696
8996
  */
8697
8997
  get_id(): string;
8698
8998
 
@@ -8704,6 +9004,7 @@ export namespace Meta {
8704
9004
  * @param name the name of the node
8705
9005
  * @param node the JSON node to be parsed
8706
9006
  * @returns `true` if the node was successfully parsed, `false` otherwise.
9007
+ * @since 0.6
8707
9008
  */
8708
9009
  parse_custom_node(script: Clutter.Script, value: GObject.Value | any, name: string, node: Json.Node): boolean;
8709
9010
 
@@ -8713,6 +9014,7 @@ export namespace Meta {
8713
9014
  * @param script the {@link Clutter.Script} creating the scriptable instance
8714
9015
  * @param name the name of the property
8715
9016
  * @param value the value of the property
9017
+ * @since 0.6
8716
9018
  */
8717
9019
  set_custom_property(script: Clutter.Script, name: string, value: GObject.Value | any): void;
8718
9020
 
@@ -8724,11 +9026,13 @@ export namespace Meta {
8724
9026
  * define a unique name for an object constructable using the UI
8725
9027
  * definition language parsed by {@link Clutter.Script}.
8726
9028
  * @param id_ the {@link Clutter.Script} id of the object
9029
+ * @since 0.6
8727
9030
  */
8728
9031
  set_id(id_: string): void;
8729
9032
 
8730
9033
  /**
8731
9034
  * Retrieves the id of `scriptable` set using `clutter_scriptable_set_id()`.
9035
+ * @since 0.6
8732
9036
  * @virtual
8733
9037
  */
8734
9038
  vfunc_get_id(): string;
@@ -8740,6 +9044,7 @@ export namespace Meta {
8740
9044
  * @param value the generic value to be set
8741
9045
  * @param name the name of the node
8742
9046
  * @param node the JSON node to be parsed
9047
+ * @since 0.6
8743
9048
  * @virtual
8744
9049
  */
8745
9050
  vfunc_parse_custom_node(script: Clutter.Script, value: unknown, name: string, node: Json.Node): boolean;
@@ -8750,6 +9055,7 @@ export namespace Meta {
8750
9055
  * @param script the {@link Clutter.Script} creating the scriptable instance
8751
9056
  * @param name the name of the property
8752
9057
  * @param value the value of the property
9058
+ * @since 0.6
8753
9059
  * @virtual
8754
9060
  */
8755
9061
  vfunc_set_custom_property(script: Clutter.Script, name: string, value: unknown): void;
@@ -8762,6 +9068,7 @@ export namespace Meta {
8762
9068
  * define a unique name for an object constructable using the UI
8763
9069
  * definition language parsed by {@link Clutter.Script}.
8764
9070
  * @param id_ the {@link Clutter.Script} id of the object
9071
+ * @since 0.6
8765
9072
  * @virtual
8766
9073
  */
8767
9074
  vfunc_set_id(id_: string): void;