docs: fix some headers paths

build: Disable evdev input by default

It's an experimental input backend, so it should be enabled explicitly.

docs: Update the release notes in the README

osx: Clean up the backend implementation

Instead of implementing create_stage() and a constructor for
ClutterStageOSX, we can use the default implementations in
ClutterBackend, and spare us some code duplication.

wayland/backend: Remove create_stage()

The create_stage() implementation in ClutterBackendWayland isn't doing
anything special, so we can fall back to the default one.

build: Clean up the configuration summary

List the input backends, and remove the EGL backend options.

backend: Clean up the device manager creation

Create the device manager during the event initialization, where it
makes sense.

This allows us to get rid of the per-backend get_device_manager()
virtual function, and just store the DeviceManager pointer into the
ClutterBackend structure.

*/backend: Clean up the stage creation

Use the default implementation of create_stage() wherever possible.

backend: Provide a default create_stage()

We can now safely create a ClutterStageWindow in the shared code path,
instead of deferring to the backend.

stage-window: Add :backend and :wrapper properties

All StageWindow implementation already have back pointers, but we need a
unified API to actually set them from the generic code path; we can use
properties on the StageWindow interface — though this requires fixing
all backends at the same time, to avoid GObject complaining.

gdk/backend: Fix an invalid chain up

*/backend: Store the StageWindow implementation type

backend: Store the type of the StageWindow implementation

We can use it later on to create it and provide a default create_stage()
implementation.

egl/backend: Clean up

The "EGL native" backend is just a short-hand for a pure Cogl backend,
using whatever input mechanism was enabled at run-time.

Add a CEx100-specific backend

Instead of piggybacking on the EGL backend, let's create a small
ClutterBackend for the CEx100 platforms. This allows us to handle the
CEx100-specific details in a much cleaner way.

cogl/backend: Remove the ClutterBackendCogl class

All the functionality that ClutterBackendCogl provided has been moved
into ClutterBackend itself, so there is no need to have this class
around in the source.

Cogl-based backends can derive directly from ClutterBackend.

cogl/backend: Remove pre/post_parse

The CLUTTER_VBLANK environment variable is now handled in the common
code path.

Remove per-backend CLUTTER_VBLANK envvar

We have a global flag we can use.

main: Add a sync-to-vblank global flag

It replaces the per-backend CLUTTER_VBLANK environment variable.

backend: Provide a default get_features() implementation

Continue gutting ClutterBackendCogl; get_features() is the last bit that
still does something, but now we can use the Cogl API.

win32/backend: Use the default context creation

The win32 backend doesn't do anything special on context creation, so we
can just use the default implementation provided by ClutterBackend.

gdk/backend: Use the context creation hooks

Same as it has happened to the X11 backend.

x11/backend: Use the context creation hooks

Don't replace create_context(): given that the X11 backend already uses
Cogl for the context creation, we can just provide the right data
structures ourselves.

backend: Provide a default create_context()

Since we use Cogl for the context creation we can now provide a default
context creation that should just work, plus a couple of hooks to allow
plugging into the creation sequence for platforms supported by Cogl that
require special handling — like foreign displays or alpha-enabled swap
chains.

The various backends have now two choices: either replace the
create_context() in its entirety, or plug themselves into the default
context creation.

backend: Fix up the input backend detection ordering

And add a missing 'else' in the OSX check, to avoid a g_error().

Add a 'null' input backend symbol

We should have an input backend symbol that thoroughly disables all
input event handling.

backend: Unify the event initialization

Input backends are, in some cases, independent from the windowing system
backends; we can initialize input handling using a model similar to what
we use for windowing backends, including an environment variable and
compile-/run-time checks.

This model allows us to remove the backend-specific init_events(), and
use a generic implementation directly inside the base ClutterBackend
class, thus further reducing the backend-specific code that every
platform has to implement.

This requires some minor surgery to every single backend, to make sure
that the function exposed to initialize the event loop is similar and
performs roughly the same operations.

win32/backend: Remove ensure_context()

We have a fallback, now.

win32/stage: Implement get_active_framebuffer()

wayland/backend: Remove empty ensure_context()

There is a default fallback, now.

cogl/backend: Remove ensure_context()

We have a default implementation for it, now.

backend: Provide an implementation of ensure_backend()

We can do it for all Cogl-based backends.

conform/color: Check invalid strings

We need to make sure to fail consistently for invalid strings.

color: Validate hex formats

Right now, we pass through to Pango unrecognized hexadecimal formats
when parsing colors from strings. Since we parse all possible formats
ourselves, we can do validation ourselves as well, and avoid the Pango
path.

conform/color: Test hsla() format

clutter-stage-x11: Make sure to set geometry x and y

Otherwise, we could be dealing with uninitialized values, causing
havoc all over the place.

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

Minor whitespace fix for clutter color parsing of hsla(h,s,l,a)

Previously, if there was whitespace between "l" and the comma before the
alpha value, parsing would fail.  This patch allows that whitespace
making it consistent with whitespace being allowed everywhere else.

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

cally: Use the proper role for password entries

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

main: Add a debug note when reading the settings file

So that's easier to track in the debug log.

actor: Deprecate [sg]et_geometry()

These methods are short-hands for accessing the position and size,
which are already shorthands for accessing the various dimensional
and positional attributes. Plus, they use ClutterGeometry, which is a
fairly bad data type for a rectangle.

Replace usage of [sg]et_geometry()

The set_geometry() and get_geometry() methods are going to be
deprecated.

Replace ClutterGeometry with cairo_rectangle_int_t

We still use ClutterGeometry internally in a couple of places, but we
should really move away from that flawed rectangle data type, and use
the Cairo one.

Sadly, we still have some public API that we cannot remove yet.

build: Remove mention of missing file

There is no clutter-event-gdk.h in the build.

main: Deprecate clutter_set_default_frame_rate()

Setting the default frame rate does not do anything even remotely
useful, unless synchronization to the vertical refresh rate is also
disabled - which can only be done through environment variable or
through configuration file. Having a programmatic way to change the
default frame rate is, thus, completely pointless.

Changing the default frame rate through environment variable and
configuration file is still allowed.

osx/stage: Fix compilation

We need to include clutter-stage-window.h.

build: Ensure libdir exists before installing to it

docs: Fixes for the API reference build

tests: Remove #undef CLUTTER_DISABLE_DEPRECATED

We need to test deprecated API as well, and we don't use a guard any
more in the build.

Remove CLUTTER_DISABLE_DEPRECATED from the build flags

We don't use it any more.

Remove CLUTTER_DISABLE_DEPRECATED guard

Except for macros, we now entirely depend on the deprecation warnings
instead of a guard.

docs: Fix a wrongly named argument

stage: Move the deprecated macros to a separate header

The clutter-stage.h header still has a bunch of macros that have, for
reasons unknown[*], survived the 1.0 API cut and have long since been
deprecated. Let's hide them under the deprecated/ carpet and let us
never speak of them ever again.

[*] pretty sure alcohol or other psychotropic substances were involved
but I take the 5th on that.

build: Fix compilation

group: Move deprecated macro into its own header

Don't use a -deprecated suffix for headers

They are already in the deprecated/ directory, the suffix is redundant,
and there is no chance of collision.

Move clutter-keysyms-compat.h to the deprecated section

No reason to have it lingering in the main section.

x11/backend: Use an internal GError

Don't just return the error from Cogl, but proxy it so that it has the
correct error domain and code.

build: Clean up the per-backend summary

build: Use AC_CACHE_SAVE

Delimit the points in the configure script that should save the state,
so that running the script multiple times doesn't require starting from
scratch even if it didn't terminate successfully.

build: Disable tslib by default

The event handling through tslib hasn't been tested in a while, and it
hasn't been ported to the device manager machinery either. We are still
considering whether or not it should be entirely removed, since evdev is
supposed to be a better way to handle events not coming from an existing
windowing system.

interactive/pixmap: Make sure to work only on the X11 backend

Even if the test has been successfully compiled against the X11 backend,
we need to ensure that it is actually running against it, otherwise bad
things will happen.

interactive/devices: Build unconditionally

The test-devices interactive test does not rely on the X11 API being
present any more, after the introduction of the device manager API.

Clean up the windowing system defines

Instead of defining new symbols for the windowing systems enabled at
configure time, we can reuse the same symbols for both the compile time
and run time checks, e.g.:

  #ifdef CLUTTER_WINDOWING_X11
    if (clutter_check_windowing_backend (CLUTTER_WINDOWING_X11))
      /* use the clutter_x11_* API */
    else
  #endif
  #ifdef CLUTTER_WINDOWING_WIN32
    if (clutter_check_windowing_backend (CLUTTER_WINDOWING_WIN32))
      /* use the clutter_win32_* API */
  #endif

This scheme allows us to ensure that the input system namespace is free
for us to use and select at run time in later versions of Clutter.

Clean up the backend creation

Move it to its own function.

build: Make sure to remove colliding shared libraries

The compatibility links should take over any existing installed
shared library with the same soname, to avoid ldd creating stale
links.

docs: Update the README section on configure switches

build: Implement proper platform checking

Perform the check for enabling platform-specific backends conditionally
on the 'check' value, instead of unconditionally.

Also, rename the configure switches for the backends to have a '-backend'
suffix, to avoid collisions and provide a more descriptive name.

build: Improve the compat libs rule

Use the same commands libtool uses when installing symbolic links for
the shared libraries.

gdk/events: Clean up the event handling code

We need debugging notes, to see what's happening when handling events.

We need to queue a (clipped) redraw when receiving a GDK_EXPOSE event.

We need to check the device (both master and source) of the event using
the GdkEvent API, and pass them to the ClutterEvent using the
corresponding Clutter API.

egl: First attempt at cleaning up the EGL native backend

At least, let's make it compile when built along with the other
backends. In reality, it still needs to be verified as working.

build: Move EGL-related files under egl/

Including the clutter-cex100.h.in header.

build: Move clutter-event-tslib.c out of egl/

Prepare for a full tslib device manager.

Coding style and cosmetic fixes

Minimal cosmetic fix to the configure output

Remove the X11-specific bit in ClutterStageCogl

Let's use a new virtual function in ClutterStageWindow to check whether
a platform-specific implementation does support clipped redraws.

gdk: Fix Stage foreign window support

The code is generally wrong, and does not work. We need to skip the
GdkWindow creation when we have a foreing window, but we still need to
create the Cogl onscreen buffer and connect it to the GdkWindow's native
resource.

gdk: Allow disabling event retrieval

Just like the other backends can disable the internal event handling,
and use clutter_<backend>_handle_event() to do the native → Clutter
event translation.

Cosmetic fixes

Allow checking the backend type at run-time

Portable code should be allowed to check type backend currently being
used, so that it can use platform-specific API (not just Clutter's).

We don't want to go down the GDK route, with public types for
ClutterBackend and ClutterStageWindow implementations, and use the type
system, e.g.:

  #ifdef GDK_WINDOWING_X11
    if (GDK_IS_WINDOW_X11 (window))
      use_x11_api (window);
    else
  #endif
  #ifdef GDK_WINDOWING_WIN32
    if (GDK_IS_WINDOW_WIN32 (window))
      use_win32_api (window);
    else
  #endif
    g_critical ("Unsupported backend");

This system would make us expose the backend system, and we want to
still reserve us the option to change the backend system to increase its
granularity — e.g. choosing different input event systems regardless of
the windowing system.

This commit adds a simple function that checks the backend type against
a symbolic constant — the same constant string that can be used to
select the backend at run-time through the CLUTTER_BACKEND environment
variable.

Implement multi-backend support

The Clutter backend split is opaque enough that should allow us to just
build all possible backends inside the same shared object, and select
the wanted backend at initialization time.

This requires some work in the build system, as well as the
initialization code, to remove duplicate functions that might cause
conflicts at build and link time. We also need to defer all the checks
of the internal state of the platform-specific API to run-time type
checks.

Rework the interaction between the Cogl and GDK / X11 backends.

Previously, the Cogl backend was at times a subclass of the X11
backend, and at times a standalone one. Now it is the other way
round, with GDK and X11 backends providing the concrete classes,
layered on top of the generic Cogl backend. A new EglNative backend
was introduced for direct to framebuffer rendering. This greatly
simplifies the API design (at the expense of some casts needed)
and reduces the amount of #ifdefs, without duplicating code.

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

Add a new GDK backend

This commit introduces a new flavour for Clutter, that uses GDK
for handling all window system specific interactions (except for
creating the cogl context, as cogl does not know about GDK), including
in particular events. This is not compatible with the X11 (glx)
flavour, and this is reflected by the different soname (libclutter-gdk-1.0.so),
as all X11 specific functions and classes are not available. If you
wish to be compatible, you should check for CLUTTER_WINDOWING_X11.
Other than that, this backend should be on feature parity with X11,
including XInput 2, XSettings and EMWH (with much, much less code)

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

cogl: fallback to non-transparent stages if unsupported

If our check of the CoglOnscreenTemplate during initialization fails
then we disable the request for an alpha component in the swap chain and
try the check again.

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

build: Bump up Cogl dependency

The newly added cogl-xlib.h header is available since Cogl 1.9, so we
need to bump up the dependency.

tslib: Remove mention of clutter-stage-egl.h

That header has long since disappeared from the build.

utils: Remove CLUTTER_DISABLE_DEPRECATED

We use deprecation warnings now.

texture: Remove CLUTTER_DISABLE_DEPRECATED

We use deprecation warnings now.

stage-manager: Remove CLUTTER_DISABLE_DEPRECATED

We use deprecation warnings now.

cairo-texture: Remove CLUTTER_DISABLE_DEPRECATED

We use deprecation warnings now.

animatable: Remove CLUTTER_DISABLE_DEPRECATED

We use deprecation warnings, now.

cairo-texture: Use an internal function for create_region()

Avoid double argument checking, and a deprecation warning when
implementing create() as a wrapper around create_region(), by using
a simple internal function.

actor: Move deprecated symbols into separate headers

The clutter-actor.h header is already pretty big, so let's try to keep
the deprecated symbols out of it.

backend: Move deprecated symbols to a separate header

main: Move deprecated symbols to a separate header

The number of deprecations in clutter-main.h makes the header harder to
parse, and more confusing. We can use a separate header under the
deprecated subdirectory to hold all the deprecated symbols.

cogl: include <cogl/cogl-xlib.h> for xlib specific symbols

Since Xlib.h is such a terrible citizen when it comes to symbol
namespacing it's not desirable to include Xlib.h if it is not absolutely
required. Cogl now has a standalone cogl-xlib.h that should be included
whenever any xlib specific symbols are required.

This patch updates clutter to include <cogl/cogl-xlib.h> wherever
clutter needs to use xlib specific cogl apis.

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

profile: Disable deprecation warnings

We use an atexit() handler to print out the profile report coming from
Uprof. The g_atexit() call has been deprecated by GLib, but since this
use case is pretty specific and it's not meant to be turned on by
default (or distributed) then we can safely disable the deprecation
warnings inside clutter-profile.c.

backend: Remove atexit handlers

The g_atexit() function has been deprecated in GLib as it is a fairly
bad idea in basically all cases.

We could probably use a GCC destructor if we didn't care about
portability, but for the time being we just remove the atexit() handler
that disposed the backend.

cairo-texture: Drop the half pixel rounding

Calling ceilf() should be enough.

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

Updated Bulgarian translation

docs: Clarify CLUTTER_ACTOR_IS_MAPPED

There are a couple of gotchas in the 'mapped' flag that are not properly
documented, or are documented only in the actor_invariants.txt file; we
should have a proper description in the API reference as well, to avoid
confusion.