Updated Traditional Chinese translation(Hong Kong and Taiwan)

Updated POTFILES.in

Updated Belarusian translation.

Add brightness/contrast effect

The ClutterBrightnessContrastEffect effect class allows changing the
brightness and contrast levels of an actor.

Modified-by: Emmanuele Bassi <ebassi@linux.intel.com>
Modified-by: Neil Roberts <neil@linux.intel.com>
https://bugzilla.gnome.org/show_bug.cgi?id=656156

cally/text: Constify string members

build: Increase the anal-retentiveness of the maintainer flags

The new rules have already caught a couple of issues.

build: Remove maintainer flags from test build

Part of the test infrastructure relies on relaxed build conditions, so
there's no point to enforce the anal retentive maintainer flags.

Fix missing/redundant declarations

cally: Fix redundant declarations

snap-constraint: Fix typo that broke the get_edges() method

We were declaring a get_edges() method, but the definition was called
get_edge().

x11/device-manager-core: Avoid a signed/unsigned comparison

x11/keymap: Avoid a signed/unsigned comparison

x11/backend: Ensure that pre/post parse hooks are not exposed

Not even as private methods.

Try to avoid duplicate declarations for profile macros

We can use the __COUNTER__ macro or, failing that, the __LINE__ macro to
ensure that we don't declare dummy variables more than once with the
same name.

gdk: Add missing declaration of clutter_gdk_get_default_display()

Updated Galician translations

Updated Spanish translation

Updated Bulgarian translation

osx: Call finishLaunching on post-parse

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

texture: Fix the async loop ceiling

The comment says that we're going to load textures in a loop until we
still have work to do, or if one iteration took more than 5
milliseconds, to avoid blowing up our frame budget, but the check is for
5 seconds, which is hardly a sensible value.

Assamese translation completed

interactive/text-field: Use :background-color

Instead of a custom paint signal handler.

text: Use the background color when painting

If the ClutterActor:background-color-set property is set to TRUE.

text: Center the cursor caret

We remove 2 pixels from the height of the cursor, but we should also
remove the same amount from the position on the y axis, so that the
cursor caret appears centered in the allocated height.

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

Updated Slovenian translation

script: Support translatable strings for properties

ClutterScript should be able to automatically call gettext() and friends
on strings loaded from a UI definition, prior to passing the string to
the object it is constructing.

The basic implementation is trivial:

  - set a translation domain on the ClutterScript instance
  - mark the translatable strings inside the JSON data, like:

      "property" : {
        "translatable" : true,
        "string" : "a translatable string"
      }

The hard part is now getting the tools we use to extract the
translatable strings to understand the JSON format we use inside
ClutterScript.

Annotate clutter_threads_add_repaint_func_full()

Add missing enumeration type to clutter.symbols

master-clock: Add frame budget diagnostic messages

Let's keep a budget of 16.6 milliseconds per frame, and reduce it by the
amount of time spent in each phase of the frame processing. If any phase
goes over the allocated budget then we use the diagnostic mode
facilities to warn the app developer.

master-clock: Clean up the frame processing

Split out every phase into its own function, to ensure that the sequence
of operation is clear and easy to follow.

Improve repaint functions

It is sometimes useful to be able to have better control on when a
repaint function is called. Currently, all repaint functions are called
prior to the stages update phase of the frame processing.

We can introduce flags to represent the point in the frame update
process in which we wish Clutter called the repaint function.

As a bonus, we can also add a flag that causes adding a repaint function
to spin the master clock.

Post-release version bump to 1.9.15

Release Clutter 1.9.14 (snapshot)

docs: Updates to the API reference

Update the release notes

actor: Ensure static scope to allocation-changed arguments

In theory, handlers connected to the ::allocation-changed signal may be
able to modify the actor's real allocation and allocation flags,
especially now that we use STATIC_SCOPE; let's avoid this, so that we
don't regret it later.

tests: Remove test-cogl-pixel-buffer

This has been converted to a Cogl-based test in the cogl source tree
so there is no need to maintain it here anymore.

Reviewed-by: Robert Bragg <robert@linux.intel.com>

conformance/invariants: Test that visibility is not recursive

The show and hide methods should not recurse; that is the job of
show_all and hide_all, which are deprecated.

stage: Fix up a copy-and-paste train wreck

The show and hide implementation inside ClutterStage ended up being
recursive, and the hide implementation would actually show the children
of the stage unconditionally.

Whoopsie.

conform/actor-invariants: Add tests for show-on-set-parent

The show-on-set-parent flag is mental, but it needs to be tested better
than just checking for it always been set to TRUE.

Assamese translation completed

actor: Annotate the allocation-changed signal

The ActorBox passed to the ::allocation-changed signal should be
annotated as STATIC_SCOPE, given that it's a pointer to a structure
inside ClutterActorPrivate - hence there's no risk of it actually being
freed from a signal handler. This allows the GSignal machinery to avoid
a costly copy/free for each signal emission.

Updated Telugu Translations

ClutterActor: clear redraw entry before emitting signals

If the redraw entry is not cleared, queueing a redraw from a signal
handler could reinsert the same object in the stage redraw list,
causing the segfault later (as the object is immediately freed)

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

input: Add a check on the argument

symbols: Add missing InputDevice symbol

Make clutter-stage-window.h a private header

It should have never been public in the first place; nothing can
implement the ClutterStageWindow interface and use it, so this is
not a break.

Fix compilation

Hide a symbol if we're not compiling with Wayland compositor support.

clutter-wayland-surface: Add padding to the class struct

This just adds some padding pointers so that we can later add more
virtual functions without breaking ABI.

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

clutter-input-device-wayland: Include clutter-stage-private.h

This was giving a warning about using _clutter_stage_update_state
without declaring it.

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

wayland-surface: don't queue redraw on buffer attach

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

evdev: Adds api to release/reclaim the evdev devices

Clutter applications using evdev are typically fullscreen applications
associated with a single virtual termainal. When switching away from
the applications associated tty then Clutter should stop managing all
evdev devices and re-probe for devices when the application regains
focus by switching back to the tty. To facilitate this, this patch
adds clutter_evdev_release_devices() and clutter_evdev_reclaim_devices()
functions.

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

wayland/x11: Set constraints on the CoglRenderer

When using the Wayland backend this sets a constraint that the
CoglRenderer selects the Wayland EGL winsys.

When a Wayland compositor display is set it now also sets a constraint
that the render should use EGL because only EGL renderers will set up
the required wl_drm global object.

The X11 backend now sets the X11 constraint.

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

device-manager-core-x11: Create core input devices as x11

The core input devices when XInput doesn't work were being created as
generic ClutterInputDevices instead of ClutterInputDeviceX11s. This
meant the keycode_to_evdev virtual wouldn't work.

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

Add an input device function to convert keycodes to evdev codes

This adds a virtual function to ClutterInputDevice to translate a
keycode from the hardware_keycode member of ClutterKeyEvent to an
evdev keycode. The function can fail so that input backends that don't
have a sensible way to translate to evdev keycodes can return FALSE.
There are implementations for evdev, wayland and X. The X
implementation assumes that the X server is using an evdev driver in
which case the hardware keycodes are the evdev codes plus 8.

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

evdev: Associate devices with the first created stage

Because evdev isn't associated with the display system, it doesn't
have any easy way to associate an input device with a stage.
Previously Clutter would never set a stage for an input device and
leave it up to the application to set it. To make it easier for
applications which just have a single fullscreen stage (which is
probably the most common use case for evdev) the device manager now
associates all input devices with the first stage that is created
unless something has already set a stage.

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

Updates in line with latest wayland protocol

The shm buffer format enum values were renamed and the explicitly
premultiplied format was dropped since it's now assumed if the buffer
has an alpha component then it's premultiplied.

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

clutter-wayland-surface: Remove the pick method

The pick method doesn't do anything special over the default pick
method provided by ClutterActor so there's no need to implement it.

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

wayland-surface: removes unused origin variable

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

wayland-surface: Adds queue-damage-redraw signal

This adds a signal that's emitted whenever a wayland surface is damaged
that allows sub-classes to override the default handler to change
how clipped redraws are queued if the sub-class doesn't simply draw
a rectangle. The signal can also be used just to track damage.

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

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.