interactive/depth: Drop deprecated API

interactive/*: Update the API usage

Drop some deprecated methods.

Deprecate ClutterStage:color

ClutterActor has a background-color property, now; we should use it for
the Stage, re-implement the color property in terms of background-color.
and deprecate the Stage property.

docs: Use ClutterTimeline:repeat-count instead of :loop

timeline: Move deprecated methods into a separate header

animation: Do not use deprecated timeline methods

cookbook: Use clutter_timeline_set_repeat_count()

timeline: Add repeat-count

Being able to easily set the number of repeats has been a request for
the animation framework for some time now. The usual way to implement
this is: connect to the ::completed signal, use a static counter, and
stop the timeline when the counter hits a specific spot.

In the same light as the :auto-reverse property, we can make it easier
to implement this common functionality by adding a :repeat-count
property that, when set, limits the amount of loops that a Timeline can
perform before stopping itself.

In fact, we can implement the :loop property in terms of the
:repeat-count property just by using a sentinel value mapping to
"infinity", and map loop=FALSE to repeat-count=0, and loop=TRUE to
repeat-count=-1.

timeline: Deprecate the clone() method

The clutter_timeline_clone() method was a pretty dumb idea when it was
introduced, back when we still had the ClutterEffectTemplate and the
clutter_effect_* animation API. It has since become an API wart: we
cannot change or add new properties to be cloned without the risk of
breaking existing code. All in all, cloning a GObject is just a matter
of calling g_object_new() with the wanted properties.

Let's deprecate this throwback of the Olden Days™, so that we can remove
it for good once we break for 2.0.

Clean up clutter-timeline.h

Re-align everything to allow expansion, and move the only "protected"
function to the clutter-master-clock.h private header.

actor-meta: Correct annotations for vfuncs

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

actor: Fix some broken annotations

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

Update the Clutter moduleset

actor: Implement remove_all_children using ActorIter

The remove_all_children() method is an ideal candidate for using the
ActorIter API; the end result is more compact and easy to follow.

input-device: Do not use weak references with actors

Use the ClutterActor::destroy signal.

stage: Do not use weak refs with actors

ClutterActor provides a signal for notifying destruction: using weak
references is neither indicated nor recommended.

stage: Clean up

Remove some ifdeffed out dead code, and some duplication.

text: Fix regression

When the ClutterTextBuffer support inside ClutterText was merged, it
introduced a regression that was identified and fixed in bug 659116.

The optimization to not paint empty ClutterText actors is only valid
is the actor is not editable, or if the cursor is not visible.

build: Fix platform_linux check

Missing * at the end.

As a side effect, this commit enables the ABI check when running make
check inside the clutter/ directory.

Update config.h.win32(.in)

Make it more like the config.h(.in) in terms of the entries to check.

Update Visual C++ property sheets

-Stop installing the cookbook items for now
-Reflect on newly added and deprecated public headers

Update Clutter Visual C++ projects

Link also to GIO as the GResource APIs from GIO is now being used

Add abicheck.sh

Courtesy of GLib and GTK+. The abicheck.sh is a simple, Linux-only,
script to check that we're not leaking private symbols, or that the
clutter.symbols file hasn't been updated.

In theory, it should go inside the distcheck phase.

symbols: Update

Add a bunch of missing public symbols, and remove some cruft.

build: Identify the Linux hosts

This gives us a nice conditional, like the one we have on Windows and
OSX.

Mark internal symbol as private

A bunch of private symbols have escaped into the SO; let's rectify this
situation by using the '_' private prefix, or making them static as they
should have been.

conform/actor: Add unit for the Container signals

ClutterActor should be emitting signals defined on the ClutterContainer
interface, as well as ensuring that manipulating the scene graph is
still possible from within them.

The new unit checks that we're emitting signals, by implementing
something similar to the Bin class available in toolkits like gtk, st,
and mx — i.e. a container that can only hold one child at any given
point.

clutter-backend: Use the Cogl main loop mechanism

Cogl now requires that all applications integrate their main loop with
Cogl so that it can listen for events from winsys. This patch just
adds Cogl's GSource to the main loop.

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

Updates use of Cogl in line with api changes

Some of Cogl's experimental apis have changed so that the buffer apis
now need to be passed a context argument and some drawing apis have been
replaced with cogl_framebuffer_ drawing apis that take explicit
framebuffer and pipeline arguments.

These changes were made as part of Cogl moving towards a more stateless
api that doesn't rely on a global context.

This patch updates Clutter to work with the latest Cogl api and bumps
the required Cogl version to 1.9.5.

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

actor: Add ClutterActorIter.destroy()

Similar to the clutter_actor_iter_remove(), but it'll call destroy()
instead of remove_child().

We can also reimplement the ::destroy default handler using it, and make
it more compact.

actor: Add a default handler for ::destroy

Now that ClutterActor can be instantiated, we need to do the right
thing, and destroy its children when it is destroyed.

docs: Update the Container interface documentation

The API reference should be more explicit about which parts of the
interface should be overridden, and which are deprecated.

conform/actor-graph: Add more cases

The actor-insert unit is not exercising the whole API and its allowed
arguments; this let sneak in the buglet found in bug 669730.

actor: Fix add_child_at_index() for negative index

There is a typo in the check for a negative index: the index variable
should be index_, not index - unfortunately, the latter can still be
resolved to index(3), so compiler and linker are perfectly happy.

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

Updated Serbian translation

text: Avoid changing the contents when possible

An editable ClutterText will reset the selection and cursor whenever the
contents are changed — even if those contents are the same. As this may
confuse the user, we should check if we're setting the exact same string,
and bail out if necessary.

text: Fix annotations

Both set_text() and set_markup() have relaxed their preconditions on a
non-NULL string as their argument, so we need to update the annotations.

text: Style cleanups

Inline wrapper functions, and remove deep nested if's.

interactive/text-field: Modernize

text: Add the coords_to_position() method

The reverse of position_to_coords().

While providing documentation on how to implement it using the
PangoLayout API, I realized that the verbosity of it all, plus the usage
of the Pango API, was not worth it, and decided to expose the method we
are using internally.

docs: Fix up Since annotation

We only use stable releases for "since" tags.

Post-release version bump to 1.9.11

Release 1.9.10 (snapshot)

docs: Update release notes

Fixed clutter_state_remove_key_internal() to propagate the is_inert state

This was causing warnings when calling g_object_weak_unref on an
already finalized object.

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

Fix Makefile to properly include clutter-backend-eglnative.h in the disted tarball

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

model: Drop GValueArray usage

We can use a plain C array of GValues when deserializing a ClutterModel
implementation from a ClutterScript description.

list-model: Migrate from GValueArray

GValueArray is on its way to deprecation in GLib; as far as the
ListModel class is concerned, a plain C array of GValue is a perfectly
suitable replacement for the GValueArray usage. It actually is an
improvement, given that it's going to take less memory.

Clean up clutter-actor.h

It's time, we delayed far too long.

interactive/actor: Show event and animation API

docs: Clarify actor map and unmap methods

ClutterActor stopped requiring to override the map and unmap virtual
functions some time ago.

Now that ClutterActor implements the Container interface, overriding map
and unmap to control the MAPPED state of the children is pretty much
going to be a source of bugs and misunderstandings.

Plus, the ordering of the unmap, destroy, dispose, and finalize calls
should be be documented properly.

The documentation should clarify all that.

docs: Update the actor invariants

• Clear up what's deprecated.
• Remove mentions of set_parent/unparent, and use add_child/remove_child
  instead.
• Clarify that reparent may not touch the MAPPED state.

introspection: add some missing annotations

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

Clean up the clutter API reference Makefile.am

docs: Add an image for the XIncluded code

docs: Add private macro CLUTTER_PRIVATE_FIELD

docs: XInclude test-actor inside the Actor's description

docs: Add an example to the Actor description

actor: Add diagnostic message for "behaviours" in ClutterScript

Behaviours have long since been deprecated; we should notify the user
that still uses behaviours in ClutterScript definitions.

actor: Do not unmap/unrealize twice on destruction

When calling clutter_actor_destroy(), ClutterActor calls
update_map_state() on itself to unset the REALIZED and MAPPED states,
prior to running the dispose() implementation.

The default dispose() will call remove_child() (either directly or
through the Container implementation), which will check for the MAPPED
state and then run update_map_state() again. We use the previously set
MAPPED state to decide whether or not the parent should queue for a
relayout/redraw when removing a visible children.

If the MAPPED flag was cleared prior to remove_child(), though, it'll
always be unset by the time we get to remove_child(), and this will
cause missing redraws/relayouts; we were ignoring this prior the
post-First Apocalypse changes because we were doing:

  if (was_mapped)
    clutter_actor_queue_relayout (parent);

  clutter_actor_queue_redraw (parent);

which is obviously wrong. Once I removed that glaring brain damage from
the remove_child() implementation, bugs started appearing — bugs that
were probably the reason why we introduced that brain damage in the
first place, instead of checking the source of those bugs.

The obvious fix is to avoid clearing up the actor's state on destroy()
until we remove the actor from its parent. This also reduces the amount
of work we do, and the code paths that can potentially go wrong.

actor: Move ClutterShader-related code out of clutter-actor.c

Since the code dealing with ClutterShader is pretty self-contained, now,
we can safely move it outside of the main ClutterActor source file and
into its own. This will allow us to just drop a bunch of files when
branching for 2.0.

x11: Remove CLUTTER_DISABLE_DEPRECATED usage

Switch to CLUTTER_DEPRECATED and CLUTTER_DEPRECATED_FOR.

texture: Deprecate YUV setter

The YUV support depends on the driver support, and not only not many
drivers support YUV natively: the supported colorspaces are pretty much
useless.

The proper way to do YUV to RGB colorspace conversion on the GPU is to
use a fragment shader; for that, ClutterTexture and Cogl provide enough
API to achieve a good result - see the Clutter-GStreamer implementation,
for instance.

texture: It's bytes per pixel, not bits

Clarify the error message when checking the bpp argument.

Use ClutterActorIter inside layout managers

Whenever it is possible, or convenient.

Updated Traditional Chinese translation(Hong Kong and Taiwan)

Updated Slovenian translation

docs: Mention the DELEGATE_LAYOUT flag in set_allocation()

With code examples.

group: Set the NO_LAYOUT flag

Since FixedLayout won't do that for us any more, and we have Group users
and Group subclasses that may be relying on it.

fixed-layout: Remove the NO_LAYOUT flag set

ClutterFixedLayout is the default layout manager for ClutterActor.

Existing subclasses of ClutterActor will get a fixed layout manager
regardless of whether they are going to use it, but since it sets the
CLUTTER_ACTOR_NO_LAYOUT flag, it will introduce regressions on actors
that perform their own layout management.

The CLUTTER_ACTOR_NO_LAYOUT flag was a bit of a mistake in the first
place, as it was introduced as a last minute workaround in the 1.0
process to deal with broken stuff in Moblin. It's going to be a target
for deprecation towards a removal when we start the 2.0 process.

Fix spelling in Clutter Cookbook: ouest -> west

box: Use the ActorIter API

And remove a useless override of the pick() virtual function while we're
at it.

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

stage: Use the iterator API instead of the DOM one

Whenever we're iterating over the children of the Stage we can now use
the ClutterActorIter API.

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

actor: Add ClutterActorIter

Iterating over children and ancestors of an actor is a relatively common
operation. Currently, you only have one option: start a for() loop, get
the first child of the actor, and advance to the next sibling for the
list of children; or start a for() loop and advance to the parent of the
actor.

These operations can be easily done through the ClutterActor API, but
they all require going through the public API, and performing multiple
type checks on the arguments.

Along with the DOM API, it would be nice to have an ancillary, utility
API that uses an iterator structure to hold the state, and can be
advanced in a loop.

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

box: Restore the ::destroy handler

During the gutting of ClutterBox, the destroy and dispose implementation
were removed. The former, especially, destroyed all children - which
usually meant that the redraw queues for the childre was cleared as
well. The removal introduced crashes when a Box was destroyed while its
children were still queueing redraws.

conform: Avoid a deadlock

Something is causing a deadlock when using clutter_threads_* API inside
the offscreen redirect conformance test. The conformance tests are
pretty insane anyway, so for the time being, let's put g_timeout_add()
back in while we figure out the issue.

tests: Update to use the symbolic button names

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

docs: Update to show the symbolic button names

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

drag-action: Use the symbolic constants for the button

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

event: Add symbolic names for left, middle, and right buttons

Symbolic names are better than magic numbers, even if they are
well-established and won't likely change.

This maps to a commit in GTK+ that introduced the same names; it
was decided to go for PRIMARY, MIDDLE, and SECONDARY because of
the confusion that may arise when the button order gets flipped
in left-handed configurations - the "left" button (i.e. 1) becomes
the right-most button, and the "right" button (i.e. 3) becomes
the left-most button.

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

doc/cookbook: Remove dead link

Remove unused variable

wayland: Correctly support fullscreening before the stage is realized

Rather than just call into wl_shell_surface_set_fullscreen we must repeat all
the steps to correctly fullscreen the surface.

wayland: Force a redraw of the stage to get the new sized buffer attached

wayland: Use new stage state manipulation functions

wayland: Refine fullscreen/unfullscreen to emit the state change events

Also update the code to set the size of the stage to set it to the size of the
output. In future versions of the Wayland protocol we'll get a configure
message advising of us of the size we can be to achieve fullscreen.

wayland: Support programmatically resizing the stage

This will call into Cogl and ask it to resize the framebuffer which will then
update the underlying EGL surface.

wayland: Support setting fullscreen before the stage is realized

wayland: Implement set_fullscreen vfunc in ClutterStageWayland

wayland: Include the Wayland surface and shell surface in ClutterStageWayland

wayland: Save the output mode so that it can be used to fullscreen windows

x11: Unbreak the build

The stage wrapper is on the ClutterStageCogl instance.

Merge branch 'stage-state'

* stage-state:
  docs: Update ClutterStageState flags
  wayland: Use the Stage state tracking
  gdk: Use the Stage state tracking
  win32: Use the Stage state tracking
  x11: Use the Stage state tracking
  osx: Use the Stage state tracking
  stage: Add state tracking

docs: Update ClutterStageState flags

wayland: Use the Stage state tracking

gdk: Use the Stage state tracking

win32: Use the Stage state tracking

x11: Use the Stage state tracking

osx: Use the Stage state tracking

stage: Add state tracking

State changes on the Stage are currently deferred to the windowing
system backends, but the code is generally the same, and it should
be abstracted neatly inside the Stage class itself.

There's also the extra caveat for backends that state changes on a
Stage must also emit a ClutterEvent of type CLUTTER_STAGE_STATE, a
requirement that needlessly complicates the backend code.