brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
d3afe4308a
mutter/clutter/clutter/clutter-content.h

95 lines
3.2 KiB
C
Raw Normal View History

Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
content: Make vfuncs optional The virtual functions on the ClutterContent interface should provide hooks for application code, not be the actual implementation.
2012-02-04 12:49:49 +00:00
* Copyright (C) 2012 Intel Corporation.
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
*
* 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/>.
*
* Author:
* Emmanuele Bassi <ebassi@linux.intel.com>
*/
Move header inclusion guard at the top GCC has some optimization for the inclusion guard, but they only work if the check is the outermost one. We're fairly inconsistent because of historical reasons, so we should ensure that we follow the same pattern in every public header.
2015-07-07 14:51:13 +00:00
#ifndef __CLUTTER_CONTENT_H__
#define __CLUTTER_CONTENT_H__
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
#error "Only <clutter/clutter.h> can be included directly."
#endif
#include <clutter/clutter-types.h>
G_BEGIN_DECLS
clutter: Content: Use G_DECLARE_INTERFACE() It cuts away a bit of the GObject boilerplate, gives us support for `g_autoptr`, and removes the typedef hack inside clutter-content.c. https://gitlab.gnome.org/GNOME/mutter/merge_requests/380
2019-01-08 14:16:47 +00:00
#define CLUTTER_TYPE_CONTENT (clutter_content_get_type ())
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
clutter: Content: Use G_DECLARE_INTERFACE() It cuts away a bit of the GObject boilerplate, gives us support for `g_autoptr`, and removes the typedef hack inside clutter-content.c. https://gitlab.gnome.org/GNOME/mutter/merge_requests/380
2019-01-08 14:16:47 +00:00
CLUTTER_EXPORT
G_DECLARE_INTERFACE (ClutterContent, clutter_content, CLUTTER, CONTENT, GObject)
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
/**
clutter: Content: Use G_DECLARE_INTERFACE() It cuts away a bit of the GObject boilerplate, gives us support for `g_autoptr`, and removes the typedef hack inside clutter-content.c. https://gitlab.gnome.org/GNOME/mutter/merge_requests/380
2019-01-08 14:16:47 +00:00
* ClutterContentInterface:
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
* @get_preferred_size: virtual function; should be overridden by subclasses
* of #ClutterContent that have a natural size
* @paint_content: virtual function; called each time the content needs to
* paint itself
* @attached: virtual function; called each time a #ClutterContent is attached
content: Make vfuncs optional The virtual functions on the ClutterContent interface should provide hooks for application code, not be the actual implementation.
2012-02-04 12:49:49 +00:00
* to a #ClutterActor.
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
* @detached: virtual function; called each time a #ClutterContent is detached
content: Make vfuncs optional The virtual functions on the ClutterContent interface should provide hooks for application code, not be the actual implementation.
2012-02-04 12:49:49 +00:00
* from a #ClutterActor.
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
* @invalidate: virtual function; called each time a #ClutterContent state
content: Make vfuncs optional The virtual functions on the ClutterContent interface should provide hooks for application code, not be the actual implementation.
2012-02-04 12:49:49 +00:00
* is changed.
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
*
clutter: Content: Use G_DECLARE_INTERFACE() It cuts away a bit of the GObject boilerplate, gives us support for `g_autoptr`, and removes the typedef hack inside clutter-content.c. https://gitlab.gnome.org/GNOME/mutter/merge_requests/380
2019-01-08 14:16:47 +00:00
* The #ClutterContentInterface structure contains only
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
* private data.
*
* Since: 1.10
*/
clutter: Content: Use G_DECLARE_INTERFACE() It cuts away a bit of the GObject boilerplate, gives us support for `g_autoptr`, and removes the typedef hack inside clutter-content.c. https://gitlab.gnome.org/GNOME/mutter/merge_requests/380
2019-01-08 14:16:47 +00:00
struct _ClutterContentInterface
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
{
/*< private >*/
GTypeInterface g_iface;
/*< public >*/
gboolean (* get_preferred_size) (ClutterContent *content,
gfloat *width,
gfloat *height);
void (* paint_content) (ClutterContent *content,
ClutterActor *actor,
ClutterPaintNode *node);
void (* attached) (ClutterContent *content,
ClutterActor *actor);
void (* detached) (ClutterContent *content,
ClutterActor *actor);
void (* invalidate) (ClutterContent *content);
clutter/content: Add clutter_content_invalidate_size() ClutterContent has the ability to dictate the layout of any given actor, through the CLUTTER_REQUEST_CONTENT_SIZE request mode. However, there is no way for ClutterContent implementations to notify their attached actors that the content size changed. Add a new optional ClutterContent.invalidate_size() vfunc and clutter_content_invalidate_size(). https://gitlab.gnome.org/GNOME/mutter/merge_requests/405
2018-12-27 01:17:29 +00:00
void (* invalidate_size) (ClutterContent *content);
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
};
clutter: Remove clutter specific version Use the mutter version when something is still needed.
2018-05-22 21:01:54 +00:00
CLUTTER_EXPORT
content: Make get_preferred_size() public
2012-03-08 14:05:48 +00:00
gboolean clutter_content_get_preferred_size (ClutterContent *content,
gfloat *width,
gfloat *height);
clutter: Remove clutter specific version Use the mutter version when something is still needed.
2018-05-22 21:01:54 +00:00
CLUTTER_EXPORT
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
void clutter_content_invalidate (ClutterContent *content);
clutter/content: Add clutter_content_invalidate_size() ClutterContent has the ability to dictate the layout of any given actor, through the CLUTTER_REQUEST_CONTENT_SIZE request mode. However, there is no way for ClutterContent implementations to notify their attached actors that the content size changed. Add a new optional ClutterContent.invalidate_size() vfunc and clutter_content_invalidate_size(). https://gitlab.gnome.org/GNOME/mutter/merge_requests/405
2018-12-27 01:17:29 +00:00
CLUTTER_EXPORT
void clutter_content_invalidate_size (ClutterContent *content);
Add ClutterContent ClutterContent is an interface for creating delegate objects that handle what an actor is going to paint. Since they are a newly added type, they only hook into the new PaintNode based API. The position and size of the content is controlled in part by the content's own preferred size, and by the ClutterContentGravity enumeration.
2012-02-01 18:33:55 +00:00
G_END_DECLS
#endif /* __CLUTTER_CONTENT_H__ */
Reference in New Issue Copy Permalink