2006-05-29 08:59:36 +00:00
|
|
|
/*
|
|
|
|
|
* Clutter.
|
|
|
|
|
*
|
|
|
|
|
* An OpenGL based 'interactive canvas' library.
|
|
|
|
|
*
|
|
|
|
|
* Authored By Matthew Allum <mallum@openedhand.com>
|
|
|
|
|
*
|
|
|
|
|
* Copyright (C) 2006 OpenedHand
|
|
|
|
|
*
|
|
|
|
|
* 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
|
2008-10-30 17:04:34 +00:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
2006-05-29 08:59:36 +00:00
|
|
|
*/
|
|
|
|
|
|
2008-10-30 17:04:34 +00:00
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
|
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
|
|
|
#endif
|
|
|
|
|
|
2007-03-22 18:21:59 +00:00
|
|
|
#ifndef __CLUTTER_STAGE_H__
|
|
|
|
|
#define __CLUTTER_STAGE_H__
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2008-03-28 22:50:55 +00:00
|
|
|
#include <clutter/clutter-types.h>
|
2006-05-29 08:59:36 +00:00
|
|
|
#include <clutter/clutter-group.h>
|
|
|
|
|
#include <clutter/clutter-color.h>
|
|
|
|
|
#include <clutter/clutter-event.h>
|
2011-07-12 16:16:43 +00:00
|
|
|
#include <cairo.h>
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2006-05-29 08:59:36 +00:00
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
2007-11-21 11:55:26 +00:00
|
|
|
#define CLUTTER_TYPE_PERSPECTIVE (clutter_perspective_get_type ())
|
|
|
|
|
#define CLUTTER_TYPE_FOG (clutter_fog_get_type ())
|
|
|
|
|
#define CLUTTER_TYPE_STAGE (clutter_stage_get_type())
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2009-12-09 01:52:09 +00:00
|
|
|
#define CLUTTER_STAGE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), CLUTTER_TYPE_STAGE, ClutterStage))
|
|
|
|
|
#define CLUTTER_STAGE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), CLUTTER_TYPE_STAGE, ClutterStageClass))
|
|
|
|
|
#define CLUTTER_IS_STAGE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CLUTTER_TYPE_STAGE))
|
|
|
|
|
#define CLUTTER_IS_STAGE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), CLUTTER_TYPE_STAGE))
|
|
|
|
|
#define CLUTTER_STAGE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), CLUTTER_TYPE_STAGE, ClutterStageClass))
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2009-12-09 01:52:09 +00:00
|
|
|
#ifndef CLUTTER_DISABLE_DEPRECATED
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2008-01-18 11:25:47 +00:00
|
|
|
/**
|
|
|
|
|
* CLUTTER_STAGE_WIDTH:
|
|
|
|
|
*
|
2008-10-30 17:04:34 +00:00
|
|
|
* Macro that evaluates to the width of the default stage
|
2008-01-18 11:25:47 +00:00
|
|
|
*
|
|
|
|
|
* Since: 0.2
|
2009-12-09 01:52:09 +00:00
|
|
|
*
|
|
|
|
|
* Deprecated: 1.2: Use clutter_actor_get_width() instead
|
2008-01-18 11:25:47 +00:00
|
|
|
*/
|
2009-12-09 01:52:09 +00:00
|
|
|
#define CLUTTER_STAGE_WIDTH() (clutter_actor_get_width (clutter_stage_get_default ()))
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2008-01-18 11:25:47 +00:00
|
|
|
/**
|
|
|
|
|
* CLUTTER_STAGE_HEIGHT:
|
|
|
|
|
*
|
2008-10-30 17:04:34 +00:00
|
|
|
* Macro that evaluates to the height of the default stage
|
2008-01-18 11:25:47 +00:00
|
|
|
*
|
|
|
|
|
* Since: 0.2
|
2009-12-09 01:52:09 +00:00
|
|
|
*
|
|
|
|
|
* Deprecated: 1.2: use clutter_actor_get_height() instead
|
2008-01-18 11:25:47 +00:00
|
|
|
*/
|
2009-12-09 01:52:09 +00:00
|
|
|
#define CLUTTER_STAGE_HEIGHT() (clutter_actor_get_height (clutter_stage_get_default ()))
|
|
|
|
|
|
|
|
|
|
#endif /* !CLUTTER_DISABLE_DEPRECATED */
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2007-08-07 14:03:58 +00:00
|
|
|
typedef struct _ClutterPerspective ClutterPerspective;
|
2007-11-21 11:55:26 +00:00
|
|
|
typedef struct _ClutterFog ClutterFog;
|
|
|
|
|
|
2006-06-05 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-color.h:
* clutter-color.c: Reimplement ClutterColor as a boxed type;
add convenience API for color handling, like: add, subtract,
shade, HSL color-space conversion, packing and unpacking.
* clutter-private.h: Update ClutterMainContext, and export the
main context pointer here.
* clutter-rectangle.h:
* clutter-rectangle.c: Update the color-related code; make
clutter_rectangle_new() and empty constructor and provide
clutter_rectangle_new_with_color(); provide color setter
and getter API.
* clutter-label.h:
* clutter-label.c: Rename the "font" property to "font-name";
update the color-related code to the new ClutterColor object;
rename clutter_label_new() to clutter_label_new_with_text(),
and add setters and getters for the properties.
* clutter-marshal.list: Add VOID:OBJECT and VOID:BOXED marshallers
generators.
* clutter-stage.h:
* clutter-stage.c: Rework the API: provide a default constructor
for a singleton object, named clutter_stage_get_default(), which
supercedes the clutter_stage() function in clutter-main; provide
new events: button-press-event, button-release-event,
key-press-event and key-release-event; update the color-related
code;
(clutter_stage_snapshot): Allow negative width and height when
taking a snapshot (meaning: use full width/height).
(clutter_stage_get_element_at_pos): Rename clutter_stage_pick().
* clutter-element.c (clutter_element_paint): Clean up the
stage and color related code.
* clutter-event.h:
* clutter-event.c: Add generic ClutterAnyEvent type; add
clutter_event_new(), clutter_event_copy() and clutter_event_free();
make ClutterEvent a boxed type.
* clutter-main.h:
* clutter-main.c: Remove clutter_stage(); add clutter_main_quit(),
for cleanly quitting from clutter_main(); add multiple mainloops
support; allocate the ClutterCntx instead of adding it to the
stack; re-work the ClutterEvent dispatching.
* clutter-group.c (clutter_group_add), (clutter_group_remove): Keep
a reference on the element when added to a ClutterGroup.
* examples/rects.py
* examples/test.c:
* examples/test-text.c:
* examples/video-cube.c:
* examples/super-oh.c:
* examples/test-video.c: Update.
2006-06-05 13:38:31 +00:00
|
|
|
typedef struct _ClutterStageClass ClutterStageClass;
|
2007-03-22 18:21:59 +00:00
|
|
|
typedef struct _ClutterStagePrivate ClutterStagePrivate;
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2009-03-16 15:00:55 +00:00
|
|
|
/**
|
|
|
|
|
* ClutterStage:
|
|
|
|
|
*
|
|
|
|
|
* The #ClutterStage structure contains only private data
|
|
|
|
|
* and should be accessed using the provided API
|
|
|
|
|
*
|
|
|
|
|
* Since: 0.1
|
|
|
|
|
*/
|
2006-05-29 08:59:36 +00:00
|
|
|
struct _ClutterStage
|
|
|
|
|
{
|
2007-08-07 14:03:58 +00:00
|
|
|
/*< private >*/
|
2007-03-22 18:21:59 +00:00
|
|
|
ClutterGroup parent_instance;
|
2007-11-28 15:31:41 +00:00
|
|
|
|
2006-05-29 08:59:36 +00:00
|
|
|
ClutterStagePrivate *priv;
|
2007-11-28 15:31:41 +00:00
|
|
|
};
|
2009-03-16 15:00:55 +00:00
|
|
|
/**
|
|
|
|
|
* ClutterStageClass:
|
|
|
|
|
* @fullscreen: handler for the #ClutterStage::fullscreen signal
|
|
|
|
|
* @unfullscreen: handler for the #ClutterStage::unfullscreen signal
|
|
|
|
|
* @activate: handler for the #ClutterStage::activate signal
|
2010-11-18 14:14:37 +00:00
|
|
|
* @deactivate: handler for the #ClutterStage::deactivate signal
|
2010-01-12 15:44:28 +00:00
|
|
|
* @delete_event: handler for the #ClutterStage::delete-event signal
|
2009-03-16 15:00:55 +00:00
|
|
|
*
|
|
|
|
|
* The #ClutterStageClass structure contains only private data
|
|
|
|
|
*
|
|
|
|
|
* Since: 0.1
|
|
|
|
|
*/
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2007-11-28 15:31:41 +00:00
|
|
|
struct _ClutterStageClass
|
2006-05-29 08:59:36 +00:00
|
|
|
{
|
2007-08-07 14:03:58 +00:00
|
|
|
/*< private >*/
|
2006-05-29 08:59:36 +00:00
|
|
|
ClutterGroupClass parent_class;
|
|
|
|
|
|
2007-08-07 14:03:58 +00:00
|
|
|
/*< public >*/
|
2008-04-04 15:02:11 +00:00
|
|
|
/* signals */
|
|
|
|
|
void (* fullscreen) (ClutterStage *stage);
|
|
|
|
|
void (* unfullscreen) (ClutterStage *stage);
|
|
|
|
|
void (* activate) (ClutterStage *stage);
|
|
|
|
|
void (* deactivate) (ClutterStage *stage);
|
2006-06-05 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-color.h:
* clutter-color.c: Reimplement ClutterColor as a boxed type;
add convenience API for color handling, like: add, subtract,
shade, HSL color-space conversion, packing and unpacking.
* clutter-private.h: Update ClutterMainContext, and export the
main context pointer here.
* clutter-rectangle.h:
* clutter-rectangle.c: Update the color-related code; make
clutter_rectangle_new() and empty constructor and provide
clutter_rectangle_new_with_color(); provide color setter
and getter API.
* clutter-label.h:
* clutter-label.c: Rename the "font" property to "font-name";
update the color-related code to the new ClutterColor object;
rename clutter_label_new() to clutter_label_new_with_text(),
and add setters and getters for the properties.
* clutter-marshal.list: Add VOID:OBJECT and VOID:BOXED marshallers
generators.
* clutter-stage.h:
* clutter-stage.c: Rework the API: provide a default constructor
for a singleton object, named clutter_stage_get_default(), which
supercedes the clutter_stage() function in clutter-main; provide
new events: button-press-event, button-release-event,
key-press-event and key-release-event; update the color-related
code;
(clutter_stage_snapshot): Allow negative width and height when
taking a snapshot (meaning: use full width/height).
(clutter_stage_get_element_at_pos): Rename clutter_stage_pick().
* clutter-element.c (clutter_element_paint): Clean up the
stage and color related code.
* clutter-event.h:
* clutter-event.c: Add generic ClutterAnyEvent type; add
clutter_event_new(), clutter_event_copy() and clutter_event_free();
make ClutterEvent a boxed type.
* clutter-main.h:
* clutter-main.c: Remove clutter_stage(); add clutter_main_quit(),
for cleanly quitting from clutter_main(); add multiple mainloops
support; allocate the ClutterCntx instead of adding it to the
stack; re-work the ClutterEvent dispatching.
* clutter-group.c (clutter_group_add), (clutter_group_remove): Keep
a reference on the element when added to a ClutterGroup.
* examples/rects.py
* examples/test.c:
* examples/test-text.c:
* examples/video-cube.c:
* examples/super-oh.c:
* examples/test-video.c: Update.
2006-06-05 13:38:31 +00:00
|
|
|
|
2010-01-12 15:44:28 +00:00
|
|
|
gboolean (* delete_event) (ClutterStage *stage,
|
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
|
2007-06-16 21:15:31 +00:00
|
|
|
/*< private >*/
|
2006-06-05 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-color.h:
* clutter-color.c: Reimplement ClutterColor as a boxed type;
add convenience API for color handling, like: add, subtract,
shade, HSL color-space conversion, packing and unpacking.
* clutter-private.h: Update ClutterMainContext, and export the
main context pointer here.
* clutter-rectangle.h:
* clutter-rectangle.c: Update the color-related code; make
clutter_rectangle_new() and empty constructor and provide
clutter_rectangle_new_with_color(); provide color setter
and getter API.
* clutter-label.h:
* clutter-label.c: Rename the "font" property to "font-name";
update the color-related code to the new ClutterColor object;
rename clutter_label_new() to clutter_label_new_with_text(),
and add setters and getters for the properties.
* clutter-marshal.list: Add VOID:OBJECT and VOID:BOXED marshallers
generators.
* clutter-stage.h:
* clutter-stage.c: Rework the API: provide a default constructor
for a singleton object, named clutter_stage_get_default(), which
supercedes the clutter_stage() function in clutter-main; provide
new events: button-press-event, button-release-event,
key-press-event and key-release-event; update the color-related
code;
(clutter_stage_snapshot): Allow negative width and height when
taking a snapshot (meaning: use full width/height).
(clutter_stage_get_element_at_pos): Rename clutter_stage_pick().
* clutter-element.c (clutter_element_paint): Clean up the
stage and color related code.
* clutter-event.h:
* clutter-event.c: Add generic ClutterAnyEvent type; add
clutter_event_new(), clutter_event_copy() and clutter_event_free();
make ClutterEvent a boxed type.
* clutter-main.h:
* clutter-main.c: Remove clutter_stage(); add clutter_main_quit(),
for cleanly quitting from clutter_main(); add multiple mainloops
support; allocate the ClutterCntx instead of adding it to the
stack; re-work the ClutterEvent dispatching.
* clutter-group.c (clutter_group_add), (clutter_group_remove): Keep
a reference on the element when added to a ClutterGroup.
* examples/rects.py
* examples/test.c:
* examples/test-text.c:
* examples/video-cube.c:
* examples/super-oh.c:
* examples/test-video.c: Update.
2006-06-05 13:38:31 +00:00
|
|
|
/* padding for future expansion */
|
2010-01-12 15:44:28 +00:00
|
|
|
gpointer _padding_dummy[31];
|
2007-01-23 20:29:11 +00:00
|
|
|
};
|
|
|
|
|
|
2007-03-26 23:18:39 +00:00
|
|
|
|
|
|
|
|
|
2007-08-07 14:03:58 +00:00
|
|
|
/**
|
|
|
|
|
* ClutterPerspective:
|
2007-12-24 16:24:26 +00:00
|
|
|
* @fovy: the field of view angle, in degrees, in the y direction
|
|
|
|
|
* @aspect: the aspect ratio that determines the field of view in the x
|
|
|
|
|
* direction. The aspect ratio is the ratio of x (width) to y (height)
|
|
|
|
|
* @z_near: the distance from the viewer to the near clipping
|
|
|
|
|
* plane (always positive)
|
|
|
|
|
* @z_far: the distance from the viewer to the far clipping
|
|
|
|
|
* plane (always positive)
|
2007-08-07 14:03:58 +00:00
|
|
|
*
|
2007-12-24 16:24:26 +00:00
|
|
|
* Stage perspective definition. #ClutterPerspective is only used by
|
|
|
|
|
* the fixed point version of clutter_stage_set_perspective().
|
2007-08-07 14:03:58 +00:00
|
|
|
*
|
|
|
|
|
* Since: 0.4
|
|
|
|
|
*/
|
2007-03-26 23:18:39 +00:00
|
|
|
struct _ClutterPerspective
|
|
|
|
|
{
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
gfloat fovy;
|
|
|
|
|
gfloat aspect;
|
|
|
|
|
gfloat z_near;
|
|
|
|
|
gfloat z_far;
|
2007-05-25 10:56:09 +00:00
|
|
|
};
|
|
|
|
|
|
2007-11-21 11:55:26 +00:00
|
|
|
/**
|
|
|
|
|
* ClutterFog:
|
2007-12-24 16:24:26 +00:00
|
|
|
* @z_near: starting distance from the viewer to the near clipping
|
|
|
|
|
* plane (always positive)
|
|
|
|
|
* @z_far: final distance from the viewer to the far clipping
|
|
|
|
|
* plane (always positive)
|
2007-11-21 11:55:26 +00:00
|
|
|
*
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
* Fog settings used to create the depth cueing effect.
|
2007-11-21 11:55:26 +00:00
|
|
|
*
|
|
|
|
|
* Since: 0.6
|
|
|
|
|
*/
|
|
|
|
|
struct _ClutterFog
|
|
|
|
|
{
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
gfloat z_near;
|
|
|
|
|
gfloat z_far;
|
2007-11-21 11:55:26 +00:00
|
|
|
};
|
2007-08-07 14:03:58 +00:00
|
|
|
|
2007-11-21 11:55:26 +00:00
|
|
|
GType clutter_perspective_get_type (void) G_GNUC_CONST;
|
|
|
|
|
GType clutter_fog_get_type (void) G_GNUC_CONST;
|
2007-07-04 14:00:41 +00:00
|
|
|
GType clutter_stage_get_type (void) G_GNUC_CONST;
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2007-07-04 14:00:41 +00:00
|
|
|
ClutterActor *clutter_stage_get_default (void);
|
2008-04-04 15:02:11 +00:00
|
|
|
ClutterActor *clutter_stage_new (void);
|
|
|
|
|
|
2007-07-04 14:00:41 +00:00
|
|
|
void clutter_stage_set_color (ClutterStage *stage,
|
|
|
|
|
const ClutterColor *color);
|
|
|
|
|
void clutter_stage_get_color (ClutterStage *stage,
|
|
|
|
|
ClutterColor *color);
|
2007-05-25 10:56:09 +00:00
|
|
|
void clutter_stage_set_perspective (ClutterStage *stage,
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
ClutterPerspective *perspective);
|
2007-05-25 10:56:09 +00:00
|
|
|
void clutter_stage_get_perspective (ClutterStage *stage,
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
ClutterPerspective *perspective);
|
2009-06-09 13:05:03 +00:00
|
|
|
void clutter_stage_set_fullscreen (ClutterStage *stage,
|
|
|
|
|
gboolean fullscreen);
|
|
|
|
|
gboolean clutter_stage_get_fullscreen (ClutterStage *stage);
|
2007-07-04 14:00:41 +00:00
|
|
|
void clutter_stage_show_cursor (ClutterStage *stage);
|
|
|
|
|
void clutter_stage_hide_cursor (ClutterStage *stage);
|
|
|
|
|
|
|
|
|
|
ClutterActor *clutter_stage_get_actor_at_pos (ClutterStage *stage,
|
2009-04-24 14:05:02 +00:00
|
|
|
ClutterPickMode pick_mode,
|
2007-07-04 14:00:41 +00:00
|
|
|
gint x,
|
|
|
|
|
gint y);
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
guchar * clutter_stage_read_pixels (ClutterStage *stage,
|
2007-07-04 14:00:41 +00:00
|
|
|
gint x,
|
|
|
|
|
gint y,
|
|
|
|
|
gint width,
|
|
|
|
|
gint height);
|
|
|
|
|
gboolean clutter_stage_event (ClutterStage *stage,
|
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
|
2007-07-31 17:01:52 +00:00
|
|
|
void clutter_stage_set_title (ClutterStage *stage,
|
|
|
|
|
const gchar *title);
|
Eliminate G_CONST_RETURN
The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy.
We always used it to conform to the platform, at least for public-facing
API.
At first I assumed it has something to do with brain-damaged compilers
or with weird platforms where const was not really supported; sadly,
it's something much, much worse: it's a define that can be toggled at
compile-time to remove const from the signature of public API. This is a
truly terrifying feature that I assume was added in the past century,
and whose inception clearly had something to do with massive doses of
absynthe and opium — because any other explanation would make the
existence of such a feature even worse than assuming drugs had anything
to do with it.
Anyway, and pleasing the gods, this dubious feature is being
removed/deprecated in GLib; see bug:
https://bugzilla.gnome.org/show_bug.cgi?id=644611
Before deprecation, though, we should just remove its usage from the
whole API. We should especially remove its usage from Cally's internals,
since there it never made sense in the first place.
2011-06-07 14:49:20 +00:00
|
|
|
const gchar * clutter_stage_get_title (ClutterStage *stage);
|
2007-11-28 15:31:41 +00:00
|
|
|
void clutter_stage_set_user_resizable (ClutterStage *stage,
|
2007-07-31 17:01:52 +00:00
|
|
|
gboolean resizable);
|
|
|
|
|
gboolean clutter_stage_get_user_resizable (ClutterStage *stage);
|
2007-11-21 11:55:26 +00:00
|
|
|
void clutter_stage_set_use_fog (ClutterStage *stage,
|
|
|
|
|
gboolean fog);
|
|
|
|
|
gboolean clutter_stage_get_use_fog (ClutterStage *stage);
|
|
|
|
|
void clutter_stage_set_fog (ClutterStage *stage,
|
|
|
|
|
ClutterFog *fog);
|
[stage] Coalesce fog and perspective API
The fog and perspective API is currently split in two parts:
- the floating point version, using values
- the fixed point version, using structures
The relative properties are using the structure types, since they
are meant to set multiple values at the same time. Instead of
using bare values, the whole API should be coalesced into two
simple calls using structures to match the GObject properties.
Thus:
clutter_stage_set_fog (ClutterStage*, const ClutterFog*)
clutter_stage_get_fog (ClutterStage*, ClutterFog*)
clutter_stage_set_perspective (ClutterStage*, const ClutterPerspective*)
clutter_stage_get_perspective (ClutterStage*, ClutterPerspective*)
Which supercedes the fixed point and floating point variants.
More importantly, both ClutterFog and ClutterPerspective should
using floating point values, since that's what get passed to
COGL anyway.
ClutterFog should also drop the "density" member, since ClutterStage
only allows linear fog; non-linear fog distribution can be achieved
using a signal handler and calling cogl_set_fog() directly; this keeps
the API compact yet extensible.
Finally, there is no ClutterStage:fog so it should be added.
2009-03-09 17:24:44 +00:00
|
|
|
void clutter_stage_get_fog (ClutterStage *stage,
|
2007-11-21 11:55:26 +00:00
|
|
|
ClutterFog *fog);
|
2007-07-26 20:08:09 +00:00
|
|
|
|
2007-11-21 11:55:26 +00:00
|
|
|
void clutter_stage_set_key_focus (ClutterStage *stage,
|
|
|
|
|
ClutterActor *actor);
|
|
|
|
|
ClutterActor * clutter_stage_get_key_focus (ClutterStage *stage);
|
2008-03-28 22:50:55 +00:00
|
|
|
void clutter_stage_ensure_current (ClutterStage *stage);
|
|
|
|
|
void clutter_stage_queue_redraw (ClutterStage *stage);
|
2008-04-04 17:26:26 +00:00
|
|
|
gboolean clutter_stage_is_default (ClutterStage *stage);
|
2009-01-12 11:18:11 +00:00
|
|
|
void clutter_stage_ensure_viewport (ClutterStage *stage);
|
2009-06-09 15:29:29 +00:00
|
|
|
void clutter_stage_ensure_redraw (ClutterStage *stage);
|
2008-03-28 22:50:55 +00:00
|
|
|
|
2009-07-14 12:47:35 +00:00
|
|
|
void clutter_stage_set_throttle_motion_events (ClutterStage *stage,
|
|
|
|
|
gboolean throttle);
|
|
|
|
|
gboolean clutter_stage_get_throttle_motion_events (ClutterStage *stage);
|
|
|
|
|
|
2009-12-09 02:04:56 +00:00
|
|
|
void clutter_stage_set_use_alpha (ClutterStage *stage,
|
|
|
|
|
gboolean use_alpha);
|
|
|
|
|
gboolean clutter_stage_get_use_alpha (ClutterStage *stage);
|
|
|
|
|
|
2010-02-06 11:23:37 +00:00
|
|
|
void clutter_stage_set_minimum_size (ClutterStage *stage,
|
|
|
|
|
guint width,
|
|
|
|
|
guint height);
|
|
|
|
|
void clutter_stage_get_minimum_size (ClutterStage *stage,
|
|
|
|
|
guint *width,
|
|
|
|
|
guint *height);
|
|
|
|
|
|
2010-04-16 14:34:36 +00:00
|
|
|
void clutter_stage_set_no_clear_hint (ClutterStage *stage,
|
|
|
|
|
gboolean no_clear);
|
|
|
|
|
gboolean clutter_stage_get_no_clear_hint (ClutterStage *stage);
|
|
|
|
|
|
2010-12-28 17:37:18 +00:00
|
|
|
void clutter_stage_set_accept_focus (ClutterStage *stage,
|
|
|
|
|
gboolean accept_focus);
|
|
|
|
|
gboolean clutter_stage_get_accept_focus (ClutterStage *stage);
|
|
|
|
|
|
2011-06-20 10:41:28 +00:00
|
|
|
|
2011-07-12 16:16:43 +00:00
|
|
|
void clutter_stage_get_redraw_clip_bounds (ClutterStage *stage,
|
|
|
|
|
cairo_rectangle_int_t *clip);
|
|
|
|
|
|
2011-06-20 10:41:28 +00:00
|
|
|
void clutter_stage_set_motion_events_enabled (ClutterStage *stage,
|
|
|
|
|
gboolean enabled);
|
|
|
|
|
gboolean clutter_stage_get_motion_events_enabled (ClutterStage *stage);
|
|
|
|
|
|
2011-07-03 18:31:15 +00:00
|
|
|
#ifndef CLUTTER_DISABLE_DEPRECATED
|
|
|
|
|
|
2009-07-14 12:47:35 +00:00
|
|
|
/* Commodity macro, for mallum only */
|
2007-12-21 16:04:39 +00:00
|
|
|
#define clutter_stage_add(stage,actor) G_STMT_START { \
|
|
|
|
|
if (CLUTTER_IS_STAGE ((stage)) && CLUTTER_IS_ACTOR ((actor))) \
|
|
|
|
|
{ \
|
|
|
|
|
ClutterContainer *_container = (ClutterContainer *) (stage); \
|
|
|
|
|
ClutterActor *_actor = (ClutterActor *) (actor); \
|
|
|
|
|
clutter_container_add_actor (_container, _actor); \
|
|
|
|
|
} } G_STMT_END
|
|
|
|
|
|
2011-07-03 18:31:15 +00:00
|
|
|
#endif /* CLUTTER_DISABLE_DEPRECATED */
|
|
|
|
|
|
2006-05-29 08:59:36 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
2007-03-22 18:21:59 +00:00
|
|
|
#endif /* __CLUTTER_STAGE_H__ */
|