brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
76f1a42ef8
mutter/clutter/deprecated/clutter-actor.h

89 lines
3.6 KiB
C
Raw Normal View History

build: Add inclusion guards and license notices
2011-12-28 18:32:00 +00:00
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
* Authored By Matthew Allum <mallum@openedhand.com>
*
* Copyright (C) 2006, 2007, 2008 OpenedHand Ltd
* Copyright (C) 2009, 2010 Intel Corp
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
#error "Only <clutter/clutter.h> can be included directly."
#endif
actor: Move deprecated symbols into separate headers The clutter-actor.h header is already pretty big, so let's try to keep the deprecated symbols out of it.
2011-11-02 12:47:46 +00:00
#ifndef __CLUTTER_ACTOR_DEPRECATED_H__
#define __CLUTTER_ACTOR_DEPRECATED_H__
#include <clutter/clutter-types.h>
G_BEGIN_DECLS
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10
actor: Deprecate [sg]et_geometry() These methods are short-hands for accessing the position and size, which are already shorthands for accessing the various dimensional and positional attributes. Plus, they use ClutterGeometry, which is a fairly bad data type for a rectangle.
2011-11-08 14:46:55 +00:00
void clutter_actor_set_geometry (ClutterActor *self,
const ClutterGeometry *geometry);
actor: Move deprecated symbols into separate headers The clutter-actor.h header is already pretty big, so let's try to keep the deprecated symbols out of it.
2011-11-02 12:47:46 +00:00
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_get_allocation_geometry)
actor: Deprecate [sg]et_geometry() These methods are short-hands for accessing the position and size, which are already shorthands for accessing the various dimensional and positional attributes. Plus, they use ClutterGeometry, which is a fairly bad data type for a rectangle.
2011-11-08 14:46:55 +00:00
void clutter_actor_get_geometry (ClutterActor *self,
ClutterGeometry *geometry);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_8
actor: Deprecate [sg]et_geometry() These methods are short-hands for accessing the position and size, which are already shorthands for accessing the various dimensional and positional attributes. Plus, they use ClutterGeometry, which is a fairly bad data type for a rectangle.
2011-11-08 14:46:55 +00:00
guint32 clutter_actor_get_gid (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_8
actor: Deprecate [sg]et_geometry() These methods are short-hands for accessing the position and size, which are already shorthands for accessing the various dimensional and positional attributes. Plus, they use ClutterGeometry, which is a fairly bad data type for a rectangle.
2011-11-08 14:46:55 +00:00
ClutterActor * clutter_get_actor_by_gid (guint32 id_);
actor: Move deprecated symbols into separate headers The clutter-actor.h header is already pretty big, so let's try to keep the deprecated symbols out of it.
2011-11-02 12:47:46 +00:00
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_remove_child() and clutter_actor_add_child())
actor: Deprecate the old parent modifiers The old API should not be used in newly written code; we have better methods for setting up and modifying the scene graph, now.
2011-12-18 21:18:27 +00:00
void clutter_actor_reparent (ClutterActor *self,
ClutterActor *new_parent);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_add_child)
actor: Deprecate the old parent modifiers The old API should not be used in newly written code; we have better methods for setting up and modifying the scene graph, now.
2011-12-18 21:18:27 +00:00
void clutter_actor_set_parent (ClutterActor *self,
ClutterActor *parent);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_remove_child)
actor: Deprecate the old parent modifiers The old API should not be used in newly written code; we have better methods for setting up and modifying the scene graph, now.
2011-12-18 21:18:27 +00:00
void clutter_actor_unparent (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_set_child_above_sibling)
Deprecate the old raise/lower API We have a replacement in ClutterActor, now. The old ClutterContainer API needs to be deprecated, and the raise() and lower() virtual functions need a default implementation, so we can check for implementations overriding them, by using the diagnostic mode like we do for add(), remove(), and foreach(). The sort_depth_order() virtual function just doesn't do anything, as it should have been made ages ago. The Actor wrappers for the Container methods also need to be deprecated.
2011-12-27 18:57:32 +00:00
void clutter_actor_raise (ClutterActor *self,
ClutterActor *below);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_set_child_below_sibling)
Deprecate the old raise/lower API We have a replacement in ClutterActor, now. The old ClutterContainer API needs to be deprecated, and the raise() and lower() virtual functions need a default implementation, so we can check for implementations overriding them, by using the diagnostic mode like we do for add(), remove(), and foreach(). The sort_depth_order() virtual function just doesn't do anything, as it should have been made ages ago. The Actor wrappers for the Container methods also need to be deprecated.
2011-12-27 18:57:32 +00:00
void clutter_actor_lower (ClutterActor *self,
ClutterActor *above);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_set_child_above_sibling() with NULL sibling)
Deprecate the old raise/lower API We have a replacement in ClutterActor, now. The old ClutterContainer API needs to be deprecated, and the raise() and lower() virtual functions need a default implementation, so we can check for implementations overriding them, by using the diagnostic mode like we do for add(), remove(), and foreach(). The sort_depth_order() virtual function just doesn't do anything, as it should have been made ages ago. The Actor wrappers for the Container methods also need to be deprecated.
2011-12-27 18:57:32 +00:00
void clutter_actor_raise_top (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_actor_set_child_below_sibling() with NULL sibling)
Deprecate the old raise/lower API We have a replacement in ClutterActor, now. The old ClutterContainer API needs to be deprecated, and the raise() and lower() virtual functions need a default implementation, so we can check for implementations overriding them, by using the diagnostic mode like we do for add(), remove(), and foreach(). The sort_depth_order() virtual function just doesn't do anything, as it should have been made ages ago. The Actor wrappers for the Container methods also need to be deprecated.
2011-12-27 18:57:32 +00:00
void clutter_actor_lower_bottom (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10
actor: Deprecated push/pop internal methods The concept of "internal child" only meant anything when we had a separate API for containers and actors. Now that we plugged that particular hole, we can drop all the hacks we used to have in place to work around its design limitations.
2012-01-03 14:36:32 +00:00
void clutter_actor_push_internal (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10
actor: Deprecated push/pop internal methods The concept of "internal child" only meant anything when we had a separate API for containers and actors. Now that we plugged that particular hole, we can drop all the hacks we used to have in place to work around its design limitations.
2012-01-03 14:36:32 +00:00
void clutter_actor_pop_internal (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10
actor: Deprecate show_all()/hide_all() The hide_all() method is pretty much pointless, as hiding an actor will automatically prevent its children from being painted. The show_all() method would only be marginally useful, if actors weren't set to be visible by default when added to another actor - which was the case when we introduced show_all() and hide_all().
2012-01-17 16:11:29 +00:00
void clutter_actor_show_all (ClutterActor *self);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 15:10:13 +00:00
CLUTTER_DEPRECATED_IN_1_10
actor: Deprecate show_all()/hide_all() The hide_all() method is pretty much pointless, as hiding an actor will automatically prevent its children from being painted. The show_all() method would only be marginally useful, if actors weren't set to be visible by default when added to another actor - which was the case when we introduced show_all() and hide_all().
2012-01-17 16:11:29 +00:00
void clutter_actor_hide_all (ClutterActor *self);
actor: Move deprecated symbols into separate headers The clutter-actor.h header is already pretty big, so let's try to keep the deprecated symbols out of it.
2011-11-02 12:47:46 +00:00
G_END_DECLS
#endif /* __CLUTTER_ACTOR_DEPRECATED_H__ */
Reference in New Issue Copy Permalink