Class
ClutterStage
Description [src]
class Clutter.Stage : Clutter.Actor
implements Atk.ImplementorIface, Clutter.Animatable {
/* No available fields */
}
Top level visual element to which actors are placed.
ClutterStage
is a top level ‘window’ on which child actors are placed
and manipulated.
ClutterStage
is a proxy actor, wrapping the backend-specific implementation
(a StageWindow
) of the windowing system. It is possible to subclass
ClutterStage
, as long as every overridden virtual function chains up to the
parent class corresponding function.
Instance methods
clutter_stage_ensure_viewport
Ensures that the GL viewport is updated with the current stage window size.
clutter_stage_get_actor_at_pos
Checks the scene at the coordinates x
and y
and returns a pointer
to the ClutterActor
at those coordinates. The result is the actor which
would be at the specified location on the next redraw, and is not
necessarily that which was there on the previous redraw. This allows the
function to perform chronologically correctly after any queued changes to
the scene, and even if nothing has been drawn.
clutter_stage_get_capture_final_size
Get the size of the framebuffer one must pass to
clutter_stage_paint_to_buffer()
or clutter_stage_paint_to_framebuffer()
would be used with the same rect
.
clutter_stage_get_device_actor
Retrieves the ClutterActor
underneath the pointer or touch point
of device
and sequence
.
clutter_stage_get_event_actor
Retrieves the current focus actor for an event. This is the key focus for key events and other events directed to the key focus, or the actor directly under the coordinates of a device or touch sequence.
clutter_stage_grab
Grabs input onto a certain actor. Events will be propagated as usual inside its hierarchy.
clutter_stage_grab_inactive
Creates an inactive grab. The grab will become effective
after clutter_grab_activate()
.
clutter_stage_read_pixels
Makes a screenshot of the stage in RGBA 8bit data, returns a
linear buffer with width
* 4 as rowstride.
clutter_stage_set_key_focus
Sets the key focus on actor
. An actor with key focus will receive
all the key events. If actor
is NULL
, the stage will receive focus.
Methods inherited from ClutterActor (220)
Methods inherited from ClutterAnimatable (5)
Properties
Clutter.Stage:key-focus
The ClutterActor
that will receive key events from the underlying
windowing system.
Clutter.Stage:perspective
The parameters used for the perspective projection from 3D coordinates to 2D.
Properties inherited from ClutterActor (74)
Signals
Clutter.Stage::after-paint
The signal is emitted after the stage is painted, but before the results are displayed on the screen.0.
Clutter.Stage::gl-video-memory-purged
Signals that the underlying GL driver has had its texture memory purged so anything presently held in texture memory is now invalidated, and likely corrupt. It needs redrawing.
Clutter.Stage::prepare-frame
The signal is emitted after the stage is updated, before the stage is painted, even if it will not be painted.
Clutter.Stage::skipped-paint
The ::skipped-paint signal is emitted after relayout, if no damage was posted and the paint was skipped.