Go to file
Neil Roberts 8a752d674b deform-effect: Use CoglPrimitives instead of CoglVertexBuffers
This changes ClutterDeformEffect to use a CoglAttributeBuffer with a
CoglPrimitive instead of the old CoglVertexBuffer. The old vertex
buffer code is now implemented in terms of the attribute buffer code
and it will eventually be deprecated. Using CoglPrimitives should be
slightly more efficient.

This also changes the struct we store the vertices to be
CoglVertexP3T2C4 instead of CoglTextureVertex. The latter is
technically not compatible with neither vertex buffers nor attribute
buffers because it contains a CoglColor and the internal members of
that are private so it is not valid to assume it contains 4 bytes and
use that as an attribute. Also it contains padding so it ends up
redundantly creating a larger buffer. CoglTextureVertex is in the
public API for the deform_vertex virtual so we still have to maintain
that. Instead of directly manipulating the array to upload, the
application is now passed a stack allocated temporary struct which
gets converted to a CoglVertexP3T2C4. This also means that we can map
the buffer as write only and still let the application read-write the
vertex.

The paint debug code to draw line strips for the deform mesh was
previously trying to set a red source material. However this wasn't
working because the material color was being overwritten by the color
attribute in the vertex buffer. This patch fixes that by creating a
seperate primitive for the lines and not adding the color
attribute. The lines code was also drawing both the front and back
indices. I don't think that entirely makes sense so I've just changed
it to draw only the front indices. Maybe painting both would make more
sense if backface culling was still enabled.

https://bugzilla.gnome.org/show_bug.cgi?id=663636
2011-11-15 11:14:59 +00:00
build mingw-fetch-dependencies: Mirror the changes made to the Cogl version 2011-09-21 13:47:28 +01:00
clutter deform-effect: Use CoglPrimitives instead of CoglVertexBuffers 2011-11-15 11:14:59 +00:00
doc Merge branch 'deprecate-default-stage' 2011-11-14 11:07:54 +00:00
po Updated Galician translations 2011-11-13 18:52:21 +01:00
tests performance/*: Do not use clutter_stage_get_default() 2011-11-10 15:37:51 +00:00
.gitignore Add a CEx100-specific backend 2011-11-10 14:55:03 +00:00
autogen.sh autogen.sh: make autoreconf use automake-1.11 when available 2010-12-30 12:08:28 +00:00
ChangeLog.pre-git-import build: Put back ChangeLog.pre-git-import to unbreak distcheck 2011-06-13 23:15:17 +01:00
clutter.doap doap: fix a typo in a url 2011-05-13 21:45:34 +01:00
configure.ac build: Disable evdev input by default 2011-11-10 17:59:17 +00:00
COPYING Update the COPYING file 2011-08-15 17:16:54 +01:00
Makefile.am tests: Add performance tracking framework 2011-07-04 17:27:48 +01:00
NEWS Release Clutter 1.7.90 (1.8.0-rc1) 2011-09-12 13:16:03 +01:00
README.in Merge branch 'deprecate-default-stage' 2011-11-14 11:07:54 +00:00
README.md docs: Fix README.md to match README.in 2011-05-06 16:44:40 +01:00

Clutter

What is Clutter?

Clutter is an open source software library for creating fast, compelling, portable, and dynamic graphical user interfaces.

Requirements

Clutter currently requires:

On X11, Clutter depends on the following extensions:

  • XComposite
  • XDamage
  • XExt
  • XFixes
  • XInput (1.x or 2.x)
  • XKB

If you are building the API reference you will also need:

If you are building the additional documentation you will also need:

  • xsltproc
  • jw (optional, for generating PDFs)

If you are building the Introspection data you will also need:

If you want support for profiling Clutter you will also need:

Resources

The official Clutter website is:

    http://www.clutter-project.org/

The API references for the latest stable release are available at:

    http://docs.clutter-project.org/docs/clutter/stable/
    http://docs.clutter-project.org/docs/cogl/stable/
    http://docs.clutter-project.org/docs/cally/stable/

The Clutter Cookbook is available at:

    http://docs.clutter-project.org/docs/clutter-cookbook/

New releases of Clutter are available at:

    http://source.clutter-project.org/sources/clutter/

The Clutter blog is available at:

    http://www.clutter-project.org/blog/

To subscribe to the Clutter mailing lists and read the archives, use the Mailman web interface available at:

    http://lists.clutter-project.org/

New bug page on Bugzilla:

    http://bugzilla.gnome.org/enter_bug.cgi?product=clutter

Clutter is licensed under the terms of the GNU Lesser General Public License, version 2.1 or (at your option) later: see the COPYING file for more information.

Building and Installation

To build Clutter from a release tarball, the usual autotool triad should be followed:

  1. ./configure
  2. make
  3. make install

To build Clutter from a Git clone, run the autogen.sh script instead of the configure one. The autogen.sh script will run the configure script for you, unless the NOCONFIGURE environment variable is set to a non-empty value.

See also the BuildingClutter page on the wiki.

Versioning

Clutter uses the common "Linux kernel" versioning system, where even-numbered minor versions are stable and odd-numbered minor versions are development snapshots.

Different major versions break both API and ABI but are parallel installable. The same major version with differing minor version is expected to be ABI compatible with other minor versions; differing micro versions are meant just for bug fixing. On odd minor versions the newly added API might still change.

The micro version indicates the origin of the release: even micro numbers are only used for released archives; odd micro numbers are only used on the Git repository.

Contributing

If you want to hack on and improve Clutter check the HACKING file for general implementation guidelines, and the HACKING.backends for backend-specific implementation issues.

The CODING_STYLE file contains the rules for writing code conformant to the style guidelines used throughout Clutter. Remember: the coding style is mandatory; patches not conforming to it will be rejected by default.

The usual workflow for contributions should be:

  1. Fork the repository
  2. Create a branch (git checkout -b my_work)
  3. Commit your changes (git commit -am "Added my awesome feature")
  4. Push to the branch (git push origin my_work)
  5. Create an Bug with a link to your branch
  6. Sit back, relax and wait for feedback and eventual merge

Bugs

Bugs should be reported to the Clutter Bugzilla at:

    http://bugzilla.gnome.org/enter_bug.cgi?product=clutter

You will need a Bugzilla account.

In the report you should include:

  • what system you're running Clutter on;
  • which version of Clutter you are using;
  • which version of GLib and OpenGL (or OpenGL ES) you are using;
  • which video card and which drivers you are using, including output of glxinfo and xdpyinfo (if applicable);
  • how to reproduce the bug.

If you cannot reproduce the bug with one of the tests that come with Clutter source code, you should include a small test case displaying the bad behaviour.

If the bug exposes a crash, the exact text printed out and a stack trace obtained using gdb are greatly appreciated.