Release Cogl 1.13.4 (snapshot)

[Neil Roberts <neil linux intel com>]

Good news, everyone!

A new Cogl snapshot towards the the 1.14 release is now available
(1.13.4). This is expected to remain ABI compatible until 1.14.0 is
released.

LATEST NEWS
-------------------------------------------------------------------------------

Cogl 1.13.4                                                        2013-02-21

  • List of changes since Cogl 1.13.2

  » New CoglOutput API to query information about displays.
  » New API for querying frame timing information in a frame callback.
  » New API for querying the buffer age of an onscreen framebuffer.
  » Fixed building the GLES2 driver without the GL driver.
  » Fixed X errors when Cogl is used after an onscreen is destroyed.
  » Fixed API used by Clutter-GST to query the number of texture units.
  » Fixed the soname for the libcogl-pango2 library
  » Fixed building with MinGW32

  • Bugzilla bugs closed since 1.13.2:

  #669122 - Clipped redraws and tearing
  #692420 - Build fails on Mac OS Mountain Lion:
            error: 'GL_NUM_EXTENSIONS' undeclared 
  #693360 - cogl-pango: Fix some doc/introspection comments
  #693612 - cogl-pango: wrong rendering on the second line of an
            underlined layout
  #693696 - Fix startup with gnome-shell and cogl-1.14
  #693894 - COGL_TEST_ONSCREEN=0 results in onscreen conformance testing
  #694164 - Don't use GL_MAP_INVALIDATE_RANGE_BIT on READ_BIT buffers

Many thanks to:

  Robert Bragg
  Owen W. Taylor
  Jasper St. Pierre
  Piotr Drąg
  Adam Jackson
  Adel Gadllah
  Daniel Martinez
  Gheyret Kenji
  Jerome Glisse

FETCHING THE RELEASE
-------------------------------------------------------------------------------

Tarballs can be downloaded from:

  http://download.gnome.org/sources/cogl/1.13/

SHA256 Checksum:

b98a49324110f5f55cbdcff10a43d6b67f2d1ddb45ae831e2636ac6f6394f52f
cogl-1.13.4.tar.bz2

Additionally, a git clone of the source tree:
  git clone git://git.gnome.org/cogl

will include a signed 1.13.4 tag which points to a commit named:
  72847ad8e22220a169775c96499179ef5218e0bc

which can be verified with:
  git verify-tag 1.13.4

and can be checked out with a command such as:
  git checkout -b build 1.13.4

DESCRIPTION
-------------------------------------------------------------------------------

Cogl is a small open source library for using 3D graphics hardware for
rendering. The API departs from the flat state machine style of OpenGL and is
designed to make it easy to write orthogonal components that can render without
stepping on each others toes.

As well as aiming for a nice API, we think having a single library as opposed
to an API specification like OpenGL has a few advantages too; like being
able to paper over the inconsistencies/bugs of different OpenGL
implementations in a centralized place, not to mention the myriad of OpenGL
extensions. It also means we are in a better position to provide utility
APIs that help software developers since they only need to be implemented
once and there is no risk of inconsistency between implementations.

Having other backends, besides OpenGL, such as drm, Gallium or D3D are
options we are interested in for the future.


REQUIREMENTS
-------------------------------------------------------------------------------

Cogl currently only requires:

  • GLib ≥ 2.32.0
  • OpenGL ≥ 1.3 (or 1.2 + multitexturing), or OpenGL ES 2.0 (or 1.1)
  • GLX, AGL, WGL or an EGL implementation

Cogl also has optional dependencies:

  • GDK-Pixbuf ≥ 2.0
     - for image loading
  • Cairo ≥ 1.10
     - for debugging texture atlasing (debug builds only)

The optional Cogl Pango library requires:
  • Cairo ≥ 1.10
  • PangoCairo ≥ 1.20

On X11, Cogl depends on the following extensions

  • XComposite ≥ 0.4
  • XDamage
  • XExt
  • XFixes ≥ 3

When running with OpenGL, Cogl requires at least version 1.3
or 1.2 with the multitexturing extension. However to build Cogl
you will need the latest GL headers which can be obtained from:

  http://www.khronos.org

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

  • GTK-Doc ≥ 1.13

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:

  • GObject-Introspection ≥ 0.9.5

GObject-Introspection is available from:

  git://git.gnome.org/gobject-introspection

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

  • UProf ≥ 0.3

UProf is available from:

  git://github.com/rib/UProf.git



DOCUMENTATION
-------------------------------------------------------------------------------

The 1.x stable API is documented here:
  http://developer.gnome.org/cogl/stable/
The 1.x development API is documented here:
  http://developer.gnome.org/cogl/1.13

The experimental 2.0 API is currently not hosted online but can be built
by passing the --enable-gtk-doc option to ./configure when building.


RELEASE NOTES
-------------------------------------------------------------------------------
  - This is a development snapshot release so there are not API or ABI stability
    guarantees at this point for new APIs since the last stable release.

  - This Cogl release exports a 1.x API (For third-party Clutter
    developers to write custom actors) and an experimental 2.0 API which
    allows standalone application development.

  - Internally Clutter depends on the Cogl 2.0 experimental API so we maintain
    runtime compatibility between the 1.x API and experimental 2.0 APIs, which
    means developers can mix-and-match their use of the APIs in the same
    process.  API selection is done per-file by including a line like: '#define
    COGL_ENABLE_EXPERIMENTAL_2_0_API' before including cogl.h or clutter.h.

  - We recommend using the 2.0 API if you don't mind updating your code once in
    a while as this API evolves and stabilizes. We promise not to break the 2.0
    API during a 1.x stable cycle and hope that will encourage people to
    experiment with it and give critical feedback! For example after releasing
    1.8, the 2.0 API will be stable for 1.8.1, 1.8.2, 1.8.3 etc, but may update
    for 1.9/1.10.

  - Because we export the 1.x and 2.0 APIs from one libcogl.so the library
    versioning, and thus ABI, can only be considered as stable as our 2.0 API - 
    i.e. during a stable release 1.x cycle.

  - Please report bugs using the Cogl Bugzilla product, at:
    http://bugzilla.gnome.org/enter_bug.cgi?product=cogl
---------------------------------------------------------------------
Intel Corporation (UK) Limited
Registered No. 1134945 (England)
Registered Office: Pipers Way, Swindon SN3 1RJ
VAT No: 860 2173 47

This e-mail and any attachments may contain confidential material for
the sole use of the intended recipient(s). Any review or distribution
by others is strictly prohibited. If you are not the intended
recipient, please contact the sender and delete all copies.