GNOME.org
 

Release Cogl 1.15.2 (snapshot)

Good news, everyone!

A new Cogl snapshot (1.15.2) is now available.

Note: Since we were a bit late with this release, clutter 1.15.2
wasn't able to depend on this release and it means the Wayland support
is not in sync. This means if you require wayland support then you
will need to build from git for now instead of depending on these
snapshots - sorry about that.

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

Cogl 1.15.2                                                        2013-07-09

  • List of changes since Cogl 1.14.0

  » Lots of Wayland backend work, including updated compositor support
  » Updated cogland, a simple example wayland compositor using Cogl
  » Made the onscreen resize callback work the same as the frame callback
  » New cogl_onscreen_swap_buffers_with_damage api
  » New fence API
  » New Emscripten support (only basic at the moment)
  » Improved blend state tracking
  » New cogl_onscreen_add_dirty_callback() api for window systems
    that need to notify application of dirty/damaged regions that must
    be redrawn by the application
  » Started adding internal unit tests to complement the conformance
    tests
  » New support for per-vertex point sizes
  » New cogl-gst sub-library added enabling gstreamer integration into
    Cogl based applications. Notably the design is compatible with
    applications adding custom shader snippets to a CoglPipeline that
    handles video sampling so application will be able to chain
    together shader based affects without requiring intermediate
    renderers.
  » Adds HSL color conversion apis
  » The Conformance test suite can now be installed with a .test file
    enabling them to be run by the gnome-desktop-testing-runner for example.

  • Bugzilla bugs closed since 1.14.0:

  #691752 - add fence/sync API
  #696730 - Compile failure with 1.14.0 due to extra arg in bitmap functions
  #697330 - Fails to build with the gold linker due to missing reference to libm
  #699431 - [PATCH] xlib: Don't crash just because the display doesn't
expose RANDR
  #700088 - compile failure: 'wayland_surface' has incomplete type
  #702570 - cogl 1.16: Regression with event propagation in champlain
  #702942 - Install conformance tests
  #702999 - undefined reference to `wl_buffer_is_shm'
  #703553 - Add support for automake 1.14

Many thanks to:

  Neil Roberts
  Robert Bragg
  Andreas Oberritter
  Chris Cummins
  Damien Lespiau
  Emanuele Aina
  Plamena Manolova
  Roy.Li
  Adam Jackson
  Daniel Stone
  Inaki Larranaga Murgoitio
  Lionel Landwerlin
  Matthias Clasen
  Milo Casagrande
  Rico Tzschichholz
  Yosef Or Boczko

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

Tarballs can be downloaded from:

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

SHA256 Checksum:

3bdbdcc09ec4099bc1a01ab08efda1641dbfd627f2676592d0d20e45863c3ac4
cogl-1.15.2.tar.bz2

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

will include a signed 1.15.2 tag which points to a commit named:
  6ac58bdbc870807ed4e34d6d538f6eae568605c6

which can be verified with:
  git verify-tag 1.15.2

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

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:

  • 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:

  • GLib ≥ 2.32.0
     - for gtype integration
  • 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

The optional Cogl GStreamer library requires:

  • GStreamer 1.0

On X11, Cogl depends on the following extensions

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

For the Wayland backend, Cogl requires:
  • Wayland ≥ 1.0.0

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.15
The experimental 2.0 API is documented here:
  http://cogl3d.org/cogl2-reference/


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
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]