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.

Bug 662071-[Win32]-Don't init the Big Clutter Lock

Since the Windows GUI system is assuming multithreadedness, initializing
locks after entering the GUI portion on Windows is likely to cause
problems[1][2], which results many Clutter programs to crash due to
releasing resources that they did not own.

[1]: Multi-threaded use of GTK+ on Win32 in README.win32 of GTK+
     source package
[2]: Explanation of Windows GUI system regarding its multithreadness
     assumptions-
     http://mail.gnome.org/archives/gtk-list/2011-June/msg00005.html

Updated Spanish translation

Updated Hebrew translation (Initialized PO file).

docs: Document the behaviour in case of init failure

Or, better, the fact that the behaviour of any Clutter function will be
undefined in case the initialization fails.

The value returned by clutter_init() and friends has to be handled
properly.

Updated Slovenian translation

Updated Norwegian bokmål translation

build: Remove the GLES configuration option

The selector for GLES 1.1 or 2.0 is all in Cogl, now.

build: remove the experimental_image var from configure

Since the image backend is something now dealt with by Cogl there is no
need to check the experimental status of the backend in the Clutter
configure script.

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

blur: don't accumulate texture padding twice

This removes the create_texture implementation for ClutterBlurEffect
because we already account for padding in the get_paint_volume
implementation so we were creating textures larger than necessary.

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

build: Don't actually check for glx for glx flavour

GLX is now totally abstracted by Cogl so the "glx" flavour is actually
only used to determine the soname of clutter now so we don't actually
have to check for the glx header or that libGL provides any GLX symbols.

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

Avoid the shadowing of 'clone'

The clone() call can creep into the build environment, so it's a good
thing to avoid using 'clone' as a variable name.

tests: Use the portable cogl wrappers for GLSL builtins

Instead of directly using the GLSL names for the builtins in the
shaders for test-shader and test-pick, this makes it use the Cogl
wrapper names instead. That way it will be portable to GLES2 as well.

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

docs: Improve documentation of LayoutManager

Especially with regards to layout properties and their usage inside a
ClutterScript UI definition.

docs: Clean up the 'running Clutter apps' chapter

Remove mentions of clutter_redraw()

debug: Clean up debugging notes

interactive: Use the newly added CLUTTER_ALIGN_BOTH value

We center a lot of stuff using ClutterAlignConstraints.

align-constraint: Add CLUTTER_ALIGN_BOTH

Just like ClutterBindConstraint has two shorthand enumerations for binding
position and size and avoid using multiple instances, ClutterAlignConstraint
should have a way to align an actor with the same alignment factor on both
axis at the same time; this is especially useful for centering actors.

Updaged Galician translations

Tag all deprecated symbols using CLUTTER_DEPRECATED

This requires some minor surgery in the build to disable the deprecation
warnings in the deprecated classes.

Bump up the dependency on gtk-doc

build: Strip out G_DISABLE_DEPRECATED

We have compiler warnings, now.

Disable deprecation warnings for the test suite

We test deprecated functionality as well as current one, so we need to
enable all symbols and disable the deprecation warnings.

debug: Move paint-deform-tiles to CLUTTER_PAINT

The CLUTTER_DEBUG class of debugging flags is meant for debugging notes,
while the CLUTTER_PAINT debugging flags are for changing the output of
the paint cycle. Painting the DeformEffect tiles should go in the latter.

docs: Include test-threads.c in the API reference

We can use the test-threads.c interactive test as part of the documentation
on how to use threads with Clutter.

interactive/threads: Clean up

Add some comments explaining why we use idle handlers to update the UI,
and update to the newest API in GLib master.

Updated POTFILES.in

Avoid using deprecated API internally

Use the proper API to implement deprecated functions.

texture: Disable deprecation warnings

Sadly, ClutterTexture is still using internally deprecated API, like
clutter_actor_get_shader().

Remove _clutter_shader_release_all()

This function is called when the backend is being disposed - as a way
of releasing all ClutterShader. This doesn't take into account three
things:

  - ClutterShader is deprecated
  - the Backend is *never* disposed
  - once the process terminates, all its resources are automatically
    released by the OS

So the _clutter_shader_release_all() function is a pointless exercise
in futility.

tests: Fix some compiler warnings

tests: Disable deprecation warnings

interactive/threads: Use G_PRIVATE_INIT

Though strictly not necessary, we should be using the proper init macro
for GPrivate.

Remove some compiler warnings

Some issues found using clang as the compiler.

Fix included header

build: Disable deprecation warnings with --enable-deprecated

Just like we turn everything on with --disable-deprecated, we have to
turn everything off with --enable-deprecated. This means disabling the
deprecation warnings from the compiler as well.

Add a Clutter-specific deprecation macro for symbols

Just like GLIB_DEPRECATED and GLIB_DEPRECATED_FOR, Clutter should have
its own wrappers for G_DEPRECATED and G_DEPRECATED_FOR, to allow opting
out of deprecation warnings.

Deprecation warnings are enabled by default, now, even when building
Clutter.

Fix duplicate typedef of ClutterAlpha

Caught on OS X but not on my Fedora machine. Weird.

Do not leak strings from GKeyFile

The string getters always copy, so we need to free the returned
values.

docs: Fixes to build the API reference

Move more typedefs into clutter-types.h

Move all enumerations to a separate file

This should allow sharing types, and we can avoid glib-mkenums thrawling
the whole repository for enumerations.

Move clutter-fixed.[ch] to the deprecated section

Move ClutterBehaviour to the deprecated section

Minor header surgery to ClutterBehaviour

This moves a couple of definitions to the common types header, and makes
sure that ClutterBehaviour subclasses include clutter-behaviour.h first,
so that their types can be fully expanded without necessarily have the
ClutterBehaviour header header included by their public headers. This is
the necessary prelude to have clutter-behaviour.[ch] moved to the
deprecated section.

Move ClutterBehaviour subclasses to the deprecated section

Moving ClutterBehaviour itself will require some minor header surgery,
so we'll do that next.

docs: Move deprecated classes out of the way

The deprecated sections should be much more prominently separated from
the current API; we can use a new part inside the main reference index
for this.

Move ClutterShader to the deprecated section

Move ClutterScore to the deprecated section

Move timeout pool to the deprecated section

build: Move deprecated code into its own prefix

The code that has been deprecated should live into its own directory,
both in the repository and when installed. This should make it clear
which functionality is actually maintained and which is not.

We start with an oldie: the frame source API.

interactive/threads: Fix up after deprecations

The GThread API has undergone a massive restructuring, and the fallout
is still being processed.

docs: Document the settings.ini file

Describe the location, groups, and keys of the settings.ini file used by
Clutter.

Show lib and sysconfdir in the configure summary

Add more sections to the Clutter configuration file

On top of the existing "Settings" group in the settings.ini file we
should have two more groups:

  Environment   - contains all the configuration possible through
                  environment variables
  Debug         - contains all the possible debug variables

Add a configuration file for ClutterSettings

ClutterSettings should be able to load its initial state by using
configuration files in SYSCONFDIR and XDG_CONFIG_HOME. This allows
Clutter to have a system (and user) configuration on platforms that
do not have XSETTINGS bridges.

Deprecate clutter_[sg]et_font_flags()

We already have two mechanisms for controlling the font rendering
quality on a per-application basis:

  • ClutterSettings properties
  • clutter_backend_set_font_options()

The font flags were always a stop-gap solution, and one that tried to
simplify a fairly complex issue beyond the point of actually being
useful.

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

Deprecate clutter_clear_glyph_cache()

This is a wrapper function for API that has long since been public.

Deprecate clutter_get_input_device_for_id()

We have the ClutterDeviceManager methods for that.