wayland-surface: Add cogl-texture property

This adds a "cogl-texture" gobject property so that a compositor may
listen for notifications of changes to the texture used to paint.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

clutter-wayland-surface: Rename the width/height properties

This patch renames the width/height properties to
surface-width/surface-height so that they won't override the
width/height properties of ClutterActor which have different
semantics.

Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

configure: Adds xkb-utils automake conditional

This adds a NEEDS_XKB_UTILS automake conditional that's set to true if
either the wayland backend is enabled or the evdev input backend is
enabled since they both depend on clutter-xkb-utils.c and we need
to avoid listing the file twice since that leads to duplicate symbols
and the build fails.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

wayland-surface: Set actor size on buffer attach

When a new buffer is attached and we update the width and height
properties for the surface we now also call clutter_actor_set_size()

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

wayland-surface: Adds _get_surface function

This adds a clutter_wayland_surface_get_surface() function for querying
the struct wl_surface * associated with a ClutterWaylandSurface.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

wayland-surface: Make _set_surface api public

This exposes a clutter_wayland_surface_set_surface() function. The
implementation ignores requests to re-set the same surface and since now
has code to cleanup old surface state before setting the new surface.
(previously the surface was construct only so this wasn't necessary)

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

wayland-surface: Cleanup properly in _dispose

When disposing a ClutterWaylandSurface we now make sure to unref any
pipeline we created and unref any surface buffer textures we created.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

wayland-surface: remove unused damage array

There was a GArray member named damage that wasn't being used which this
patch removes.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

configure: fix --enable-evdev-input documentation

The --help documentation for ./configure was listing a spurious
--with-evdev option when it should list --enable-evdev-input.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

wayland: install wayland compositor headers + pkgconfig file

If wayland compositor support has been enabled then we make sure to
install the corresponding public headers and a
clutter-wayland-compositor.pc pkgconfig file.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

Remove test-wayland-surface

In a separate branch, this test has become quite complicated and
involves multiple files and its own configure options. Instead of
cluttering up the clutter source tree it has now been moved to its own
repo at:

 http://github.com/clutter-project/test-wayland-surface

Reviewed-by: Emmanuele Bassi <ebassi@linux.intel.com>

Updated Brazilian Portuguese translation

docs: Refresh the layout managers example image

Drop the window decoration and pointer; drop the double image for the
FlowLayout class; add an image for the TableLayout class.

docs: Update the actor example image

interactive/actor: Add margin usage example

build: Remove clutter-version.h.win32.in

The clutter-version.h header file is now completely generic, and does
not need to be masked by a Windows-specific header when building under
MSVC.

Annotate the exported version variables

When using MSVC we need to annotate the variables that are going to be
exported.

actor: Do not check for child destruction in add_child_internal()

We currently check for the IN_DESTRUCTION flag inside the
add_child_internal() function.

This check disallows calling methods that change the stacking order
within the destruction sequence, by triggering a critical warning first,
and leaving the actor in an undefined state, which then ends up being
caught by an assertion.

The reproducible sequence is:

  - actor gets destroyed;
  - another actor, linked to the first, will try to change the
    stacking order of the first actor;
  - changing the stacking order is a composite operation composed
    by the following steps:
    1. ref() the child;
    2. remove_child_internal(), which removes the reference;
    3. add_child_internal(), which adds a reference;
  - the state of the actor is not changed between (2) and (3), as
    it could be an expensive recomputation;
  - if (3) bails out, then the actor is in an undefined state, but
    still alive;
  - the destruction sequence terminates, but the actor is unparented
    while its state indicates being parented instead.
  - assertion failure.

The obvious fix would be to decompose each set_child_*_sibling() method
into proper remove_child()/add_child(), with state validation; this may
cause excessive work, though, and trigger a cascade of other bugs in
code that assumes that a change in the stacking order is an atomic
operation.

Another potential fix is to just remove this check here, and let code
doing stacking order changes inside the destruction sequence of an actor
continue doing the work.

The third fix is to silently bail out early from every
set_child_*_sibling() and set_child_at_index() method, and avoid doing
work.

I have a preference for the second solution, since it involves the least
amount of work, and the least amount of code duplication.

See bug: https://bugzilla.gnome.org/show_bug.cgi?id=670647

a11y: Not compute extents for actors without an stage

This solves a crash on GNOME Shell, as compute the extents
for some StWidgets could lead to call st_widget_get_theme_node,
and it is a fatal error to call this on a widget that it not
beed added to a stage.

a11y: Stop to use ClutterActor::name as default accessible-name

ClutterActor::name is mostly used for debugging purposes

Update VS property sheets

Update the "installation" of headers...

Update clutter-version.h.win32(.in)

Make it like the clutter-version.h.in template.  Since we aren't having
Windows-specific items in here (such as CLUTTER_FLAVOUR), perhaps we
could get the dllexport stuff in clutter-version.h.in, where it can be
used when necessary, and this file would be gone.

interactive: Remove test-shader

ClutterShader is deprecated, and we already have various tests for the
shader API, both for Cogl and for ClutterShaderEffect.

interactive: Remove test-fullscreen

The stage state test also has a fullscreen option, and it's a better
test all around.

interactive: Remove test-actor-clone

Another clone of the venerable test-actors - but test-actor already uses
ClutterClone, so there's really little point in it.

interactive: Remove test-behave

ClutterBehaviour and friends are deprecated, there's no point in having
an interactive test, and it may be misleading.

docs: Document the versioning macros

Annotate all functions available since 1.10

docs: Add new macros to the sections file

Move clutter-util.h into the deprecated section

Add a deprecated header for ClutterCairoTexture

Add a deprecated header for ClutterTexture

Add deprecated header for ClutterAnimation

Add a deprecated header for ClutterAnimatable

Add deprecated header for ClutterStageManager

Update the deprecation macros

Use the new versioned macros instead of the generic ones.

Add flexible versioning scheme

GLib introduced macros that allows defining the lower and upper bounds
of the API to be used by application code.

The lower bound allows to define the minimum version that will trigger
deprecation warnings; the upper bound defines the maximum version that
will trigger compiler warnings for unavailable symbols.

This scheme allows gradually porting application code to a new version
of the API, especially in case of resynchronization after multiple
development cycles.

Require GLib ≥ 2.31.19

For the new deprecation and versioning macros.

Move macros to their own headers

conformance: Clean up

Remove the last inconsistent bits.

conformance: Rename the source files

It's the conformance test suite: there's no need to namespace the files,
just like there's no need to namespace the units.

This commit does not change the Cogl tests: they will be moved to Cogl
over time, and it's easier to do if we leave them as they are.

conform: Clean up test names

Drop the 'test-' prefix: it's the conformance test suite, we know it's
full of tests.

actor: Add a method for computing the default paint volume

Now that ClutterActor has a default paint volume, subclasses may wish
to retrieve it without chaining up to the parent's implementation of
the get_paint_volume() function.

The get_default_paint_volume() returns a ClutterPaintVolume pointer
to the paint volume as computed by the default implementation of the
get_paint_volume() virtual function; it can only be used immediately,
as it's not guaranteed to survive across multiple frames.

paint-volume: Add a union method for boxes

Creating PaintVolume instances is not possible, and it's not recommended
anyway. It is, though, necessary to union paint volumes, especially with
2D boxes, in some cases.

Clutter should provide a simple convenience function that allows
unioning volumes to boxes in a moderately efficient way.

https://bugzilla.gnome.org/show_bug.cgi?id=670021

cookbook/examples: Modernize the code

Use new and non-deprecated methods.

Updated Bulgarian translation

Uploaded Ukranian

Uyghur translation

Updated Belarusian translation.

Updated Galician translations

Updated Slovenian translation

Updated Serbian translation

build: Make abicheck.sh backend-aware

It should be possible to adapt the abicheck.sh script so that it
actually tests the ABI of libclutter-1.0.so taking into account
the backends that were compiled into Clutter, and avoid expected
failures if Clutter was not built with a specific backend.

https://bugzilla.gnome.org/show_bug.cgi?id=670680

Clean up the included headers

Especially inside ClutterStage.

build: Fix the header order

The "keep the list sorted" comment on the list of headers is there not
for fun, or because I'm anal-retentive like that.

Updated Spanish translation

Post-release version bump to 1.9.13

Release Clutter 1.9.12 (snapshot)

docs: Documentation fixes

docs: Document ClutterTextBuffer structures

docs: Fix unused symbols

build: Bump up Cogl dependency

We use the latest stable snapshot.

Fix compiler warning

docs: "Soft" deprecation of ClutterAlpha

We cannot deprecate ClutterAlpha yet. We cannot also implement
ClutterAlpha in terms of ClutterTimeline, because multiple Alpha
instances can be attached to the same Timeline. So we can start
with a "soft" deprecation: just a warning in the documentation
stating that ClutterAlpha will be deprecated, and removed, in the
future, and that newly-written code should use ClutterTimeline
instead.

Fix the progress function scope annotation

animation: Deprecate Alpha usage

We can use ClutterTimeline and its progress mode inside
ClutterAnimation; obviously, we have to maintain the invariants because
of the ClutterAnimation:alpha property, but if all you set is the :mode
property using one of the Clutter animation modes then we can skip the
ClutterAlpha entirely.

timeline: Add progress functions

The whole progress computation should not be done using a separate
class: it should be part of the Timeline class.

Move the easing functions to their own file

Instead of having the easing functions be dependent of ClutterAlpha, and
static to the clutter-alpha.c source file, we should make them generic
and move them to their own internal header and source files. This will
allow to re-use them in the near future.

drag-action: Use the motion event when passing the drag threshold

This avoids a critical warning, but it also makes the dragging more
fluid in case of threshold crossing.

https://bugzilla.gnome.org/show_bug.cgi?id=670402

Reduce our internal dependence on the Cogl 1.x api

Since Cogl has started restricting what cogl 1.x api is exposed when
COGL_ENABLE_EXPERIMENTAL_2_0_API is defined and since we build all
Clutter internals with COGL_ENABLE_EXPERIMENTAL_2_0_API defined this
patch makes a first pass at reducing our internal use of the Cogl 1.x
api.

The most notable api that's no longer exposed to us internally is
the cogl_material_ api so this switches all Clutter internals to use the
cogl_pipeline_ api instead. This patch also makes quite a bit of
progress removing internal uses of CoglHandle although there is still
more to go.

Pass context to cogl_texture_pixmap_x11_new() api

The experimental cogl_texture_pixmap_x11_new() api was recently changed
to take an explicit context argument and return a GError on failures.
This updates Clutter's use of the api accordingly.

Loosen the guard around clutter_backend_get_cogl_context

We were only exposing clutter_backend_get_cogl_context() if
COGL_ENABLE_EXPERIMENTAL_2_0_API had been defined but the CoglContext
api is also available if COGL_ENABLE_EXPERIMENTAL_API has been defined.

As it was it meant that code opting into the experimental Cogl api
but not limiting to the 2.0 only api would have to #define
COGL_ENABLE_EXPERIMENTAL_2_0_API before including clutter.h but make
sure it wasn't defined when including cogl.h which was particularly
awkward.

Rename cogl_framebuffer_swap_* apis to cogl_onscreen_swap_*

Recently the cogl_framebuffer_swap_* apis were moved into the
cogl_onscreen_* namespace since only CoglOnscreen framebuffers can be
double buffered. This renames all uses of the cogl_framebuffer_swap_*
apis in Clutter.

Pass a CoglContext when calling cogl_pipeline_new

The experimental cogl_pipeline_new() api was recently changed so it
explicitly takes a CoglContext. This updates all calls to
cogl_pipeline_new() in clutter accordingly.

Updated Galician translations

Updated Bulgarian translation

Updated Danish translation

Updated Belarusian translation

clutter-drop-action: annotation fixes for some signals

https://bugzilla.gnome.org/show_bug.cgi?id=670433

Updated Lithuanian translation

Updated Slovenian translation

a11y: remove Container explanation

That explanation is outdated after the last changes on clutter

a11y: proper ATK role for ClutterStage

ATK_ROLE_CANVAS is not a suitable role, as the user (in general) can't
draw on the Stage. CallyStage implements AtkWindow, so the proper role
is ATK_ROLE_WINDOW

a11y: redoing focus stuff

Removing atkcomponent, focus_tracker, etc. Emitting focus state change
from the stage. Now things are more simple, and stop to use some
of the soon-to-be-deprecated signals on ATK.

docs: Note when new ClutterBindCoordinate values were added

The shorthands for position and size were added in 1.6.

interactive/layout: Update to modern API

No need to override Container. Actually, no need to use the Container
API at all. This also removes a bunch of leaks.

ClutterBindConstraint: Add CLUTTER_BIND_ALL coordinate

Add a CLUTTER_BIND_ALL that binds both size and position.

x11/stage: Allow setting fullscreen hint before realize

It should be possible to do:

  clutter_stage_set_fullscreen (stage, TRUE);
  clutter_actor_show (stage);

and have the stage be full screen as soon as it is shown.

Currently, we need to call clutter_actor_realize() prior to calling
set_fullscreen(), otherwise the backing X window will not be set,
and ClutterStageX11 will silently discard the change.

If set_fullscreen() was called prior to realization, ClutterStageX11
should delay setting the fullscreen hint until the realize() chain
has been successfully executed.

http://bugzilla.clutter-project.org/show_bug.cgi?id=2515

conform/invariants: Clean up

Use modern API, and add a minimal check that hiding an actor will cause
it to unmap.

Updated Spanish translation

x11: adjust size to minimal size when realizing

If you execute the following sequence :

stage = clutter_stage_new ();
clutter_actor_set_size (stage, 1280, 800);
clutter_actor_realize (stage);

Then you end up creating an onscreen buffer of size 1280x800 but
ClutterStageX11 storing the stage size at 640x480.

This patch resync the 2 implementation by using the ClutterStage's
size in both classes when realizing.

Signed-off-by: Lionel Landwerlin <llandwerlin@gmail.com>
https://bugzilla.gnome.org/show_bug.cgi?id=667540

effects: Delay the creation of the base pipeline

Unconditionally creating CoglPipeline and CoglSnippets inside the class
initialization functions does not seem to be enough when dealing with
headless builds.

Our last resort is to lazily create the base pipeline the first time we
try to copy it, during the instance initialization.

Updated Serbian translation

actor: Correct get_paint_volume for an actor with no children and no clip

We do not need to repaint the entire stage if an actor has no children
and no clip.

clutter.symbols: Fix up symbols

Do not check for features inside class initialization

The class initialization function may be called when Clutter hasn't been
fully initialized — for instance, when scanning the source with gtk-doc
or with the introspection scanner.

interactive/actor: Add more animations

Rotation along the Y axis and depth change.

interactive/actor: Use a BoxLayout

As it was intended.

box-layout: Fix allocation brain farts

The allocation code for BoxLayout contains a sequence of brain farts
that make it barely working since the synchronization of the layout
algorithm to the one in GtkBox.

The origin of the layout is inverted, and it doesn't take into
consideration a modified allocation origin (for actors the provide
padding or margin).

The pack-start property is broken, and it only works because we walk the
children list backwards; this horribly breaks when a child changes
visibility. Plus, we count invisible children, which leads to
allocations getting insane origins (either close to -MAX_FLOAT or
MAX_FLOAT).

Finally, the allocation is applied twice even for non-animated cases.

https://bugzilla.gnome.org/show_bug.cgi?id=669291

ClutterStage: notify "key-focus" change on clutter_stage_emit_key_focus_event