<div>Good news, everyone!</div><div><br></div><div>A new Cogl snapshot (1.9.8) is now available:</div><div><br></div><div>LATEST NEWS</div><div>-------------------------------------------------------------------------------</div>
<div><br></div><div>Cogl 1.9.8 2012-03-05</div><div><br></div><div> • List of changes since Cogl 1.9.6</div><div><br></div><div> » Various Visual Studio build fixes</div>
<div> » Correctly check for GL_EXT_packed_depth_stencil and support using</div><div> GL_OES_packed_depth_stencil on GLES2</div><div> » Correctly handle pre-multiplied alpha conversions when reading</div><div> back texture data.</div>
<div> » Added cogl_renderer_{get,set}_driver functions so the underlying</div><div> driver can be chosen programmatically.</div><div> » Revamped the conformance testing framework so that it</div><div> automatically runs every test against GLES2 as well as GL and also</div>
<div> against all of the pipeline backends and with npot textures</div><div> disabled.</div><div> » Add a conformance test for reading back an RGBA texture as</div><div> alpha-only</div><div> » Added support for converting between all of Cogl's supported pixel</div>
<div> formats including pre-multiplied alpha conversions.</div><div> » Added conformance tests for converting to and from all of the</div><div> supported formats.</div><div> » Added a public cogl_framebuffer_read_pixels_into_bitmap()</div>
<div> function which will effective read into a CoglPixelBuffer.</div><div> » CoglPixelBuffer was changed to no longer have associated width,</div><div> height and format information and instead we will rely on</div>
<div> CoglBitmap to track that informations. The relationship is</div><div> analogous how CoglAttributes relate to CoglAttributeBuffers</div><div> and means for example that a CoglPixelBuffer could now be used</div>
<div> to hold multiple images.</div><div> » Added public cogl_bitmap_get_{width,height,format,rowstride} api</div><div> » Added a public accessor for the underlying pixel buffer of a</div><div> CoglBitmap.</div><div>
» Added various missing cast macros for some buffer objects.</div><div> » Ported the Clutter based test-pixel-buffer test to be standalone.</div><div><br></div><div> • List of bugs fixed since Cogl 1.9.6</div><div><br>
</div><div> <a href="https://bugzilla.gnome.org">https://bugzilla.gnome.org</a>:</div><div><br></div><div> #666184 - framebuffer: Enable a single depth and stencil buffer for GLES</div><div> #670793 - Don't use cogl_get_draw_framebuffer when flushing pipeline state</div>
<div> #671016 - INVALID_ENUM errors in gnome-shell</div><div><br></div><div>Many thanks to:</div><div><br></div><div> Neil Roberts</div><div> Chun-wei Fan</div><div> Daniel Korostil</div><div> Martin Srebotnjak</div>
<div> Matej Urbančič</div><div> Matic Gradišer</div><div> Мирослав Николић</div><div><br></div><div>FETCHING THE RELEASE</div><div>-------------------------------------------------------------------------------</div><div>
<br></div><div>Tarballs can be downloaded from:</div><div><br></div><div> <a href="http://source.clutter-project.org/sources/cogl/1.9/">http://source.clutter-project.org/sources/cogl/1.9/</a></div><div> <a href="http://download.gnome.org/sources/cogl/1.9/">http://download.gnome.org/sources/cogl/1.9/</a></div>
<div><br></div><div>SHA256 Checksum:</div><div><br></div><div>27377d2ebe4021d0dc8aad5ff3532c6386bd103ea2b8142152195e0223d1d815 cogl-1.9.8.tar.bz2</div><div><br></div><div>Additionally, a git clone of the source tree:</div>
<div> git clone git://<a href="http://git.gnome.org/cogl">git.gnome.org/cogl</a></div><div><br></div><div>will include a signed 1.9.8 tag which points to a commit named:</div><div> 9fb7b18d10875bb3b5328309ce327005656204cd</div>
<div><br></div><div>which can be verified with:</div><div> git verify-tag 1.9.8</div><div><br></div><div>and can be checked out with a command such as:</div><div> git checkout -b build 1.9.8</div><div><br></div><div>DESCRIPTION</div>
<div>-------------------------------------------------------------------------------</div><div><br></div><div>Cogl is a small open source library for using 3D graphics hardware for</div><div>rendering. The API departs from the flat state machine style of OpenGL and is</div>
<div>designed to make it easy to write orthogonal components that can render without</div><div>stepping on each others toes.</div><div><br></div><div>As well as aiming for a nice API, we think having a single library as opposed</div>
<div>to an API specification like OpenGL has a few advantages too; like being</div><div>able to paper over the inconsistencies/bugs of different OpenGL</div><div>implementations in a centralized place, not to mention the myriad of OpenGL</div>
<div>extensions. It also means we are in a better position to provide utility</div><div>APIs that help software developers since they only need to be implemented</div><div>once and there is no risk of inconsistency between implementations.</div>
<div><br></div><div>Having other backends, besides OpenGL, such as drm, Gallium or D3D are</div><div>options we are interested in for the future.</div><div><br></div><div><br></div><div>REQUIREMENTS</div><div>-------------------------------------------------------------------------------</div>
<div><br></div><div>Cogl currently only requires:</div><div><br></div><div> • GLib ≥ 2.28.0</div><div> • OpenGL ≥ 1.3 (or 1.2 + multitexturing), or OpenGL ES 2.0 (or 1.1)</div><div> • GLX, AGL, WGL or an EGL implementation</div>
<div><br></div><div>Cogl also has optional dependencies:</div><div><br></div><div> • GDK-Pixbuf ≥ 2.0</div><div> - for image loading</div><div> • Cairo ≥ 1.10</div><div> - for debugging texture atlasing (debug builds only)</div>
<div><br></div><div>The optional Cogl Pango library requires:</div><div> • Cairo ≥ 1.10</div><div> • PangoCairo ≥ 1.20</div><div><br></div><div>On X11, Cogl depends on the following extensions</div><div><br></div><div> • XComposite ≥ 0.4</div>
<div> • XDamage</div><div> • XExt</div><div> • XFixes ≥ 3</div><div><br></div><div>When running with OpenGL, Cogl requires at least version 1.3</div><div>or 1.2 with the multitexturing extension. However to build Cogl</div>
<div>you will need the latest GL headers which can be obtained from:</div><div><br></div><div> <a href="http://www.khronos.org">http://www.khronos.org</a></div><div><br></div><div>If you are building the API reference you will also need:</div>
<div><br></div><div> • GTK-Doc ≥ 1.13</div><div><br></div><div>If you are building the additional documentation you will also need:</div><div><br></div><div> • xsltproc</div><div> • jw (optional, for generating PDFs)</div>
<div><br></div><div>If you are building the Introspection data you will also need:</div><div><br></div><div> • GObject-Introspection ≥ 0.9.5</div><div><br></div><div>GObject-Introspection is available from:</div><div><br>
</div><div> git://<a href="http://git.gnome.org/gobject-introspection">git.gnome.org/gobject-introspection</a></div><div><br></div><div>If you want support for profiling Cogl you will also need:</div><div><br></div><div>
• UProf ≥ 0.3</div><div><br></div><div>UProf is available from:</div><div><br></div><div> git://<a href="http://github.com/rib/UProf.git">github.com/rib/UProf.git</a></div><div><br></div><div><br></div><div><br></div><div>
DOCUMENTATION</div><div>-------------------------------------------------------------------------------</div><div><br></div><div>The 1.x API is documented here:</div><div> <a href="http://docs.clutter-project.org/docs/cogl/1.9">http://docs.clutter-project.org/docs/cogl/1.9</a></div>
<div>The experimental 2.0 API is documented here:</div><div> <a href="http://docs.clutter-project.org/docs/cogl-2.0-experimental/1.9">http://docs.clutter-project.org/docs/cogl-2.0-experimental/1.9</a></div><div><br></div>
<div><br></div><div>RELEASE NOTES</div><div>-------------------------------------------------------------------------------</div><div> - This is a development snapshot release so there are not API or ABI stability</div><div>
guarantees at this point for new APIs since the last stable release.</div><div><br></div><div> - This Cogl release exports a 1.x API (For third-party Clutter</div><div> developers to write custom actors) and an experimental 2.0 API which</div>
<div> allows standalone application development.</div><div><br></div><div> - Internally Clutter depends on the Cogl 2.0 experimental API so we maintain</div><div> runtime compatibility between the 1.x API and experimental 2.0 APIs, which</div>
<div> means developers can mix-and-match their use of the APIs in the same</div><div> process. API selection is done per-file by including a line like: '#define</div><div> COGL_ENABLE_EXPERIMENTAL_2_0_API' before including cogl.h or clutter.h.</div>
<div><br></div><div> - We recommend using the 2.0 API if you don't mind updating your code once in</div><div> a while as this API evolves and stabilizes. We promise not to break the 2.0</div><div> API during a 1.x stable cycle and hope that will encourage people to</div>
<div> experiment with it and give critical feedback! For example after releasing</div><div> 1.8, the 2.0 API will be stable for 1.8.1, 1.8.2, 1.8.3 etc, but may update</div><div> for 1.9/1.10.</div><div><br></div>
<div> - Because we export the 1.x and 2.0 APIs from one libcogl.so the library</div><div> versioning, and thus ABI, can only be considered as stable as our 2.0 API - </div><div> i.e. during a stable release 1.x cycle.</div>
<div><br></div><div> - Please report bugs using the Cogl Bugzilla product, at:</div><div> <a href="http://bugzilla.gnome.org/enter_bug.cgi?product=cogl">http://bugzilla.gnome.org/enter_bug.cgi?product=cogl</a></div>