cookbook: Added layouts section and introduction

layout-manager: Do not emit layout-changed on thaw

When thawing a LayoutManager, do not emit the ::layout-changed signal
since it might still be in the middle of a relayout.

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

animator: Remove redundant parenthesis

animator: Improve the key value copy

Use the same code used elsewhere in Clutter when dealing with values
that can be copied or transformed.

state: Return a boolean when getting the key value

Since the copy might fail, we should return a boolean value and not just
warn on the console - similarly to what ClutterAnimator does.

clutter.modules: Fix UProf id

clutter.modules: Fix the uprof repository

UProf has moved.

text: Do not set the markup unconditionally

When setting :use-markup we always pass the contents of the Text actor
to clutter_text_set_markup_internal(); if string contains any markup,
this ends up being parsed and used - even when :use-markup is set to
FALSE.

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

cogl-material: Unref the texture when reverting authority

When the texture is set on a layer so that it is back to the parent's
texture it would clear the texture change flag but it wouldn't unref
the texture. The free function for a material layer does not unref the
texture if the change flag is cleared so the texture would end up
leaking. This happens for ClutterTexture because it disposes the
texture by setting layer 0 of the material to COGL_INVALID_HANDLE
which ends up the same as the default material.

cookbook: Make the table of content have a depth of 2

Instead of showing Problem/Solution/Discussion for each recipe, let's
just show the title of those recipes.

cookbook: Remove the note about indenting <xi:include>

It's not necessary now to special case the indentation of includes as
the XSLT for the cookbook strips leading and trailing space automaticaly
for us.

cookbook: Close a tag, making xsltproc happier

A </function> tag was not closed.

cookbook: Add a recipe on how to create sub-textures

Fiddle with Cogl textures to create a new ClutterTexture that only
displays a rectangular region of a bigger ClutterTexture.

cookbook: Strip leading and trailing space inside programlisting

It's a XSL FAQ to be able to chomp text nodes and we just have to copy
and paste a XSLT 1.0 solution from:
  http://dpawson.co.uk/xsl/sect2/N8321.html#d11325e833

Let's then empower our cookbook customization layer to chomp text nodes,
children of programlisting.

cookbook: Add text.xml to the list of XML files

text.xml was feeling lonely and forgotten, that's fixed now.

cookbook: Add the source XML files as dependencies in the Makefile rules

The generated cookbook files (either HTML or PDF) do not only depend on
clutter-cookbok.xml but also on all the chapters that compose the
cookbook. Add this dependency to the Makefile rules to have make rebuild
the book when a chapter changes.

Since XML_FILES is now the list of source files, move recipe-template.xml
to EXTRA_DIST.

material: only deference layer->texture for authority

In _cogl_material_layer_pre_paint we were mistakenly dereferencing the
layer->texture member for the passed layer instead of dereferencing the
texture state authority which was causing crashes in some cases.

layout-manager: Freeze ::layout-changed when creating LayoutMeta

LayoutMeta instances are created lazily. If an actor is added to a
container with a layout manager then the first time the layout manager
might be creating the LayoutMeta instance could be during the allocation
cycle caused by calling clutter_actor_show(). When a LayoutMeta is
instantiated for the first time, a list of properties can be set - and
this might lead to the emission of the ::layout-changed signal. The
signal is, most typically, going to cause a relayout to be queued, and a
warning will be printed on the terminal.

We should freeze the emission of the ::layout-changed signal during the
creation of the LayoutMeta instances, and thaw it after that.

bin-layout: Add a text to the test

We have a rectangle, a cairo texture and a texture. Let's go add a text
actor as well.

texture: Update the request mode depending on the size

If a Texture has been set to:

  • keep its size synchronized with the image data
  • maintain the aspect ratio of the image data

then it should also change its request mode depending on the orientation
of the image data, so that layout managers have a fighting chance of
sizing it correctly.

texture: Make the :filename property readable

UI builders and other tools are be interested in the file used to load
the image data.

Post-release version bump to 1.3.11

Release 1.3.10

cookbook: Fix the text-shadow recipe

Fill out the recipe and add more comments to the example code.

po: Remove the requirement for LINGUAS and ChangeLog

We don't use ChangeLogs and the LINGUAS file is replaced by the
AS_ALL_LINGUAS m4 macro.

osx: Fixed stage resize policy

Added initialization of minimum window size property on Cocoa
side. This property works when user change window size by mouse
dragging. But when size is changed by clutter_actor_set_size this
property will not help and was added another check in
clutter_stage_osx_resize. Also osx_get_geometry was refactoried
because it returns incorrect values in many cases but now size is
saved in [Window reshape] in requisition_width/height and this value
will be returned in any case to frontend.

test: Fixed test-rotate for osx platfom

There was a bug in clutter-shader-effect. We have to set to zero new object
of type GValue before we can use it in g_value_init.

osx: added resolution initialization in backend

It's important step of initialization because all features calls from
font rendering libs based on this parameter. By default it equals to
-1 and test-text-cache test crashes in this case.

osx: Fixed warnings in osx event implementation

Added willResize delegate for osx stage.

By default a clutter stage is not user resizable and this delegate
controls this option while resizing the stage.

Fixed lack of reaction for keyboard events after showing stage on osx.

Trick with hiding view while showing the stage affects on responder
chain. The main view ceases to be first responder and we should
manually set first responder.

Fixed incorrect size return in osx stage if stage resizable by user.

For some reasons width&height was equal to 1 if flag user-resizable
was true.

osx: Added size initialization for stage

After stage creation it's size can be changed by user and it should be
taken into account in clutter_stage_osx_realize.

test: fixed uninitialized variable in test-cogl-point-sprites

osx: Fixed problem with freezing application while checking behaviour.

Problem was in incorrect application initialization.
[NSApplication sharedApplication] should be call in backend init(not
in init stage). It doesn't require any data and only makes a
connection to window server.

osx: Fixed bug with creating context twice.

We should assign context and pixel_format vars to null to avoid
multiple context creation.

osx: added create_context function in backend

Cleanup clutter_backend_osx_post_parse function and move context
initialization to clutter_backend_osx_create_context. The OpenGL pixel
format attributes were taken as is. Also move bringing application to
foreground in clutter_stage_osx_realize, it seems there is best place
for it.

osx: Implemented hide cursor backend implementation

Add implementation for hide cursor in stage. Also added using this
feature in test-animator.

Added .DS_Store and test logs messages to git ignore

osx: Added missed function declaration for stage

Added empty functions for cursor and window resize functional with
notes FIXME and also they are added to iface.

osx: Remove drawing call while showing stage and add viewport init

Viewport didn't initialized before OGL drawing and it causes crash on
assert so added viewport initalization to
clutter_stage_osx_realize. Also showing the stage causes drawing
function but other part of the system(in particular conformance tests)
don't expect it and aren't ready at this moment.

osx: Fixed crash while features initialization

Clearing current context couses incorrect work of glGetString function
and all next GL functions that use it work incorrectly.

glx: Add more debugging notes

Should help debug the GLX visual selection.

docs: Further clarifications

Mention the XFixes extension for compositors using input regions to let
events "pass through" the stage.

Thanks to: Robert Bragg <robert@linux.intel.com>

docs: Clarify the event retrieval disable behaviour

When we disable the event retrieval, we now just disable the X11 event
source, not the event selection. We need to make that clear to
applications, especially compositors, which might expect complete
control over the selection.

glx: Unconditionally select X11/GLX events

Currently, we select input events and GLX events conditionally,
depending on whether the user has disabled event retrieval.

We should, instead, unconditionally select input events even with event
retrieval disabled because we need to guarantee that the Clutter
internal state is maintained when calling clutter_x11_handle_event()
without requiring applications or embedding toolkits to select events
themselves. If we did that, we'd have to document the events to be
selected, and also update applications and embedding toolkits each time
we added a new mask, or a new class of events - something that's clearly
not possible.

See:

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

for the rationale of why we did conditional selection. It is now clear
that a compositor should clear out the input region, since it cannot
assume a perfectly clean slate coming from us.

See:

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

for an example of things that break if we do conditional event
selection on GLX events. In that specific case, the X11 server ≤ 1.8
always pushed GLX events on the queue, even without selecting them; this
has been fixed in the X11 server ≥ 1.9, which means that applications
like Mutter or toolkit integration libraries like Clutter-GTK would stop
working on recent Intel drivers providing the GLX_INTEL_swap_event
extension.

This change has been tested with Mutter and Clutter-GTK.

Merge remote branch 'elliot/cookbook-animations-rotating'

* elliot/cookbook-animations-rotating:
  cookbook: Added recipe for animated rotation of an actor
  cookbook: Add explanation about including code samples
  cookbook: Make filename used in video example consistent
  cookbook: Add example code for animated rotation

cogl-program: gles2: bind programs lazily as for GL

This makes the gles2 cogl_program_use consistent with the GL version by
not binding the program immediately and instead leaving it to
cogl-material.c to bind the program when actually drawing something.

gles2: Have CoglProgram track uniforms per program

Previously custom uniforms were tracked in _CoglGles2Wrapper but as part
of a process to consolidate the gl/gles2 shader code it seems to make
sense for this state to be tracked in the CoglProgram object instead.

http://bugzilla.o-hand.com/show_bug.cgi?id=2179

cogl-shader: unifies the driver/{gl,gles} shader files

The per driver implementations of cogl-shader.c had become almost
identical we now have a single cogl/cogl-shader.c instead.

cogl-shader: Store the CoglShaderType in CoglShader

Instead of having to query GL and translate the GL enum into a
CoglShaderType each time cogl_shader_get_type is called we now keep
track of the type in CoglShader.

cogl: don't include cogl-debug.h in cogl.h or install

cogl-debug.h is an internal header so it shouldn't have been included by
cogl.h and the header shouldn't be installed either.

configure.ac: when checking for gl2ext.h include gl2.h

This makes sure we include gl2.h when looking for gl2ext.h since
gl2ext.h can't always be used standalone.

animatable: Allow passing a NULL animation

The Animatable interface was created specifically for the Animation
class. It turns out that it might be fairly useful to others - such as
ClutterAnimator and ClutterState.

The newly-added API in this cycle for querying and accessing custom
properties should not require that we pass a ClutterAnimation to the
implementations: the Animatable itself should be enough.

This is necessary to allow language bindings to wrap
clutter_actor_animate() correctly and do type validation and
demarshalling between native values and GValues; an Animation instance
is not available until the animate() call returns, and validation must
be performed before that happens.

There is nothing we can do about the animate_property() virtual
function - but in that case we might want to be able to access the
animation from an Animatable implementation to get the Interval for
the property, just like ClutterActor does in order to animate
ClutterActorMeta objects.

docs: Fix the BindConstraint example

A constraint was created but not added to the actor.

conform: Move the Score test to the conformance suite

The interactive test for ClutterScore is really meant to be run as part
of the conformance test suite, so we should move it there.

x11: Split out conditions and warnings

XGetGeometry is a great piece of API, since it gets a lot of stuff that
are moderately *not* geometry related - the root window, and the depth
being two.

Since we have multiple conditions depending on the result of that call
we should split them up depending on the actual error - and each of them
should have a separate error message. This makes debugging simpler.

actor: Make set_flags() safe from unrefs

It's possible - though not recommended - that user code causes the
destruction of an actor in one of the notification handlers for
flag-based properties. We should protect the multiple notification
emission with g_object_ref/unref.

Require g-i 0.6.14

The 0.6.14 is the last 0.6 release, before the format changes; we build
with both 0.6 and 0.9, so we should depend to the former and not the
latter.

cookbook: Added recipe for animated rotation of an actor

New recipe covering how to animate rotation of
an actor (in all axes).

Covers various factors affecting rotation animation
(like orientation of axes, parent rotation/orientation),
as well as trying to make rotations easier to visualise
(e.g. describing how rotation direction is affected by
those factors, how a rotation can be expected to look
when animated). Uses implicit animations for code examples.

Also refers to a full code example which uses ClutterState.

cookbook: Add explanation about including code samples

Updated the "Contributing" section to explain how to include
a full code sample at the end of a recipe.

cookbook: Make filename used in video example consistent

Fixed video filename in sample markup to match the
guidelines given in the "Contributing" section.

cookbook: Add example code for animated rotation

Add example code demonstrating how to rotate in the x,y,z
axes using ClutterState. Integrated with build.

modules: Bump cairo to 1.9.12

And add poppler.

effect: fix conversion from degrees to radians

gles/cogl-shader.c: Store the shader type in CoglShader

Nothing was storing the shader type when a shader was created so it
would get confused about whether it was a custom vertex or fragment
shader.

Also the 'type' member of CoglShader was a GLenum but the only place
that read it was treating it as if it was CoglShaderType. This changes
it be CoglShaderType.

test-shader: Unref the ClutterShader after setting it on an actor

Otherwise the test leaks the shader object and the underlying GLSL
program.

Plug the leaking CoglProgram and CoglShader

_cogl_program_free and _cogl_shader_free never freed the struct their
structs so it would end up leaking a little bit.

configure.ac: Fix the missing COGL_HAS_GLES[12] defines

In 7fae8ac051 the two cogl-defines.h files from GLES and GL were
unified. However this missed out the COGL_HAS_GLES[12] defines from
GLES. The configure.ac still made an AC_SUBST for the right version
but the replacement was never put in any headers. This fixes it so
that instead of directly calling AC_SUBST the value is now put into a
variable which later gets added to COGL_DEFINES so that it will end up
in cogl-defines.h

Fix a small typo in configure.ac for the COGL_DEFINES variable

There was an initializer for the COGL_DEFINES variable which sets it
to the empty value before it is filled in. The name of the variable
wasn't spelt right so it wouldn't work properly. This doesn't really
matter because it would default to empty anyway.

test-shader: The tex_coord varying is now an array under GLES2

Since the GLES2 wrapper grew support for multi-texturing, the
tex_coord varying variable defined in the vertex shader is actually an
array of texture coordinates so it ought to match in the fragment
shader in test-shader. This seemed to work anyway under Mesa/Intel but
under NVidia it does not so I don't think it's safe to assume that
linking a non-array varying with an array will work.

cogl-bitmap-pixbuf: Avoid copying the buffer in more circumstances

When loading an RGB image GdkPixbuf will pad the rowstride so that the
beginning of each row is aligned to 4 bytes. This was causing us to
fallback to the code that copies the buffer. It is probably safe to
avoid copying the buffer if we can detect that the rowstride is simply
an alignment of the packed rowstride.

This also changes the copying fallback code so that it uses the
aligned rowstride. However it is now extremely unlikely that the
fallback code would ever be used.

cogl-bitmap-pixbuf: Fix the rowstride used when copying a GdkPixbuf

In commit b780413e5ae4b the GdkPixbuf loading code was changed so that
if it needs to copy the pixbuf then it would tightly pack it. However
it was still using the rowstride from the pixbuf so the image would
end up skewed. This fixes it to use the real rowstride.

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

cogl-material: Don't map the shininess value to [0,1]

In OpenGL the 'shininess' lighting parameter is floating point value
limited to the range 0.0→128.0. This number is used to affect the size
of the specular highlight. Cogl materials used to only accept a number
between 0.0 and 1.0 which then gets multiplied by 128.0 before sending
to GL. I think the assumption was that this is just a weird GL quirk
so we don't expose it. However the value is used as an exponent to
raise the attenuation to a power so there is no conceptual limit to
the value.

This removes the mapping and changes some of the documentation.

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

cogl-material: Always reset the GLSL program to zero when flushing

When flushing a fixed-function or arbfp material it would always call
disable_glsl to try to get rid of the previous GLSL shader. This is
needed even if current_use_program_type is not GLSL because if an
application calls cogl_program_uniform then Cogl will have to bind the
program to set the uniform. If this happens then it won't update
current_use_program_type presumably because the enabled state of arbfp
is still valid.

The problem was that disable_glsl would only select program zero when
the current_use_program_type is set to GLSL which wouldn't be the case
if cogl_program_uniform was called. This patch changes it to just
directly call _cogl_gl_use_program_wrapper(0) instead of having a
separate disable_glsl function. The current program is cached in the
cogl context anyway so it shouldn't cause any extra unnecessary GL
calls.

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

po: Add de.po

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

Fixed more set using *_get_* typos.

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

docs: Improve the text of X11 event-related functions

We need to make sure that people disabling event handling in Clutter
call clutter_x11_handle_event() to update Clutter's internal state.

Minor fix to the documentation for clutter_texture_get_sync_size

The documentation was recursively referring to itself causing a stack
overflow in the reader's brain.

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

build: Depend on g-i 0.9.0

The introspection format changed, so we should depend on the new one.

Clean up the private flags for ClutterActor

Provide macros to quickly query a flag, and remove all namespacing
except the initial 'CLUTTER'.

x11: Add more checks to set_stage_foreign()

Check all the pre-requisites to avoid segfaults later on.

x11: Clean up TexturePixmap header and private data structure

Align the header file and use bitfields instead of booleans.

cogl-material: Consider the shader when deciding if materials equate

_cogl_material_equal was ignoring the user shader state so rectangles
with different shaders would get batched together.

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

stage: Ignore redraws on destroyed stages

We might get requests to redraw even during destruction; we should
ignore them and do some NULL checks instead of blindly invoking
functions.

stage-window: Add argument guards

Validate the arguments passed to StageWindow's methods.

po: Re-sync Makefile.in.in

Use the one that ships with gtk+.

cookbook: Fix key press to examine modifers correctly

The simple key press example in the cookbook used a brittle
and incorrect switch statement to test modifier values. Instead,
use logical "&" of the state with the modifiers we're interested
in to check which keys were pressed.

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

cookbook: Use TESTS_DATA_DIR

We need the correct location for redhand.png if we want to load it
in textures-reflection.

cookbook: Add image and example for text-shadow

cookbook: Include the textures-reflection example code

Add a section at the end of the recipe containing the full code of the
example.

cogl-material-arbfp: Use separate buffers when calling g_ascii_dtostr

g_ascii_dtostr was being used in four separate arguments to
g_string_append_printf but all invocations of it were using the same
buffer. This would end up with all of the arguments having the same
value which would depend on whichever order the compiler evaluates
them in. This patches changes it to use a multi-dimensional array and
a loop to fill in the separate buffers.

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

cookbook: Add an empty recipe for shadows under text

Currently, it's just an example and an image, but it should be easy to
flesh it out properly for the "Text" chapter.

cookbook: Add example code

The cookbook should also include fully functional code examples. We can
even XInclude them into the docbook XML itself.

The examples should be built with the coobook, so that we can always
make sure they are up to date.

Add gmo files to the Git ignore list

material-arbfp: Use locale-independent double to string conversion

The ARBfp programs are created with a printf() wrapper, which usually
fails in non-en locales as soon as you start throwing things like
floating point values in the mix.

We should use the g_ascii_dtostr() function which places a double into a
string buffer in a locale-independent way.

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

cookbook: Use the right tag for the screenshot

Screenshots should be using the <screenshot> tag, not the <figure> one.

Merge remote branch 'elliot/cookbook-actor-opacity'

Conflicts:
doc/cookbook/Makefile.am

cookbook: Add a missing image to the list

Merge remote branch 'elliot/cookbook-include-videos'

* elliot/cookbook-include-videos:
  cookbook: Tweak so that videos sit inside a paragraph for better spacing
  docs: Note the P_() macro in the HACKING file
  cookbook: Added support for inline video

Conflicts:
doc/cookbook/Makefile.am