isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-12-27 13:22:15 +00:00
Code Issues Packages Projects Releases Wiki Activity
c6977cdb13
mutter/doc/reference/cogl/cogl-docs.xml.in

200 lines
6.8 KiB
XML
Raw Normal View History

Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
2008-06-24 Matthew Allum <mallum@openedhand.com> * cogl/Makefile.am: * cogl/cogl-docs.sgml: * cogl/version.xml.in * clutter/version.xml.in Add full version (including minor) to docs. Add version to COGL docs
2008-06-24 10:38:18 +00:00
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
[docs] Rework the API reference version generation Clutter copies the gtk-doc from the usual gtk+ template, and has a version.xml.in containing only: @VERSION@ Without a newline at the end. Unfortunately, it appears that autoconf has started adding a newline to the generated version.xml which then is used as the payload for the "version" XML entity. Instead of using a secondary file we can make configure generate the whole clutter-docs.xml and cogl-docs.xml files from a template; this way we also get the ability to substitute more autoconf variables into the documentation -- if needs be.
2009-06-01 16:35:41 +00:00
<!ENTITY version "@VERSION@">
2008-06-24 Matthew Allum <mallum@openedhand.com> * cogl/Makefile.am: * cogl/cogl-docs.sgml: * cogl/version.xml.in * clutter/version.xml.in Add full version (including minor) to docs. Add version to COGL docs
2008-06-24 10:38:18 +00:00
]>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
2008-06-24 Matthew Allum <mallum@openedhand.com> * cogl/Makefile.am: * cogl/cogl-docs.sgml: * cogl/version.xml.in * clutter/version.xml.in Add full version (including minor) to docs. Add version to COGL docs
2008-06-24 10:38:18 +00:00
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<bookinfo>
docs: Use "Cogl" not "COGL" in Cogl API reference Cogl isn't an acronym so we should use "Cogl" instead of "COGL" in our documentation.
2010-08-25 19:33:27 +00:00
<title>Cogl Reference Manual</title>
<releaseinfo>for Cogl &version;</releaseinfo>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<copyright>
<year>2008</year>
<holder>OpenedHand LTD</holder>
</copyright>
[docs] Remove the version number from the title The version number in the title made sense when we were breaking API with every minor release. Now that we're API stable we can drop that and make the output in Devhelp and on the website slightly more good looking.
2009-08-13 15:15:04 +00:00
<copyright>
<year>2009</year>
docs: Add 2010 in COGL's Copyright notice While at it, fix the usage of <year> in <copyright> to let the stylesheet do the collation when having several years.
2010-02-08 19:18:36 +00:00
<year>2010</year>
[docs] Remove the version number from the title The version number in the title made sense when we were breaking API with every minor release. Now that we're API stable we can drop that and make the output in Devhelp and on the website slightly more good looking.
2009-08-13 15:15:04 +00:00
<holder>Intel Corporation</holder>
</copyright>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<legalnotice>
<para>
Permission is granted to copy, distribute and/or modify this
document under the terms of the <citetitle>GNU Free
Documentation License</citetitle>, Version 1.1 or any later
version published by the Free Software Foundation with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts. You may obtain a copy of the <citetitle>GNU Free
Documentation License</citetitle> from the Free Software
Foundation by visiting <ulink type="http"
url="http://www.fsf.org">their Web site</ulink> or by writing
to:
<address>
The Free Software Foundation, Inc.,
<street>59 Temple Place</street> - Suite 330,
docs: fix new line in the cogl xml top level document A comma in the FSF address is wrong. Supreme Offence.
2010-01-27 16:03:28 +00:00
<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>,
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<country>USA</country>
</address>
</para>
</legalnotice>
</bookinfo>
<chapter>
docs: update the overview paragraph for Cogl Instead of describing OpenGL as "a low level OpenGL abstraction library" it is now summarised as "modern 3D graphics API".
2010-08-25 21:31:30 +00:00
<title>Cogl - a modern 3D graphics API</title>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<section id="cogl-intro">
docs: Use "Cogl" not "COGL" in Cogl API reference Cogl isn't an acronym so we should use "Cogl" instead of "COGL" in our documentation.
2010-08-25 19:33:27 +00:00
<title>About Cogl</title>
2008-06-16 Matthew Allum <mallum@openedhand.com> * cogl/cogl-docs.sgml: Add an intro.
2008-06-16 16:31:08 +00:00
docs: update the overview paragraph for Cogl Instead of describing OpenGL as "a low level OpenGL abstraction library" it is now summarised as "modern 3D graphics API".
2010-08-25 21:31:30 +00:00
<para>Cogl is a modern 3D graphics API with associated utility
APIs designed to expose the features of 3D graphics hardware
using a more object oriented design than OpenGL. The library has
primarily been driven by the practical needs of Clutter but it
is not tied to any one toolkit or even constrained to developing
UI toolkits.</para>
2008-06-16 Matthew Allum <mallum@openedhand.com> * cogl/cogl-docs.sgml: Add an intro.
2008-06-16 16:31:08 +00:00
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
</section>
<xi:include href="xml/cogl.xml"/>
[docs] Various gtk-doc updates for Cogl This hides a number of internal structs and enums from the docs, and moves some functions to more appropriate sections as well as misc description updates (mostly for the vertex buffer api)
2009-02-06 11:16:42 +00:00
<xi:include href="xml/cogl-color.xml"/>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<xi:include href="xml/cogl-texture.xml"/>
[cogl-material] Support string based blending and layer combine descriptions Setting up layer combine functions and blend modes is very awkward to do programatically. This adds a parser for string based descriptions which are more consise and readable. E.g. a material layer combine function could now be given as: "RGBA = ADD (TEXTURE[A], PREVIOUS[RGB])" or "RGB = REPLACE (PREVIOUS)" "A = MODULATE (PREVIOUS, TEXTURE)" The simple syntax and grammar are only designed to expose standard fixed function hardware, more advanced combining must be done with shaders. This includes standalone documentation of blend strings covering the aspects that are common to blending and texture combining, and adds documentation with examples specific to the new cogl_material_set_blend() and cogl_material_layer_set_combine() functions. Note: The hope is to remove the now redundant bits of the material API before 1.0
2009-05-10 23:40:41 +00:00
<xi:include href="blend-strings.xml"/>
[doc] Hooks up cogl-material reference documentation Adds some more gtk-doc comments to cogl-material.h, and adds a new section to cogl-sections.txt
2008-12-22 16:19:49 +00:00
<xi:include href="xml/cogl-material.xml"/>
[docs] Various gtk-doc updates for Cogl This hides a number of internal structs and enums from the docs, and moves some functions to more appropriate sections as well as misc description updates (mostly for the vertex buffer api)
2009-02-06 11:16:42 +00:00
<xi:include href="xml/cogl-primitives.xml"/>
docs: Add a cogl-paths section The path primitives have a specific section, now, and gtk-doc is loudly complaining about it being defined but not referenced.
2010-07-02 16:48:19 +00:00
<xi:include href="xml/cogl-paths.xml"/>
docs: Add the "clipping" section to the COGL API reference All the clip-related API in COGL is missing from the API reference because the cogl-clipping section is not included inside the main index file.
2009-10-07 16:35:11 +00:00
<xi:include href="xml/cogl-clipping.xml"/>
[docs] Various gtk-doc updates for Cogl This hides a number of internal structs and enums from the docs, and moves some functions to more appropriate sections as well as misc description updates (mostly for the vertex buffer api)
2009-02-06 11:16:42 +00:00
<xi:include href="xml/cogl-vertex-buffer.xml"/>
<xi:include href="xml/cogl-matrix.xml"/>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
<xi:include href="xml/cogl-shaders.xml"/>
<xi:include href="xml/cogl-offscreen.xml"/>
2008-10-30 Emmanuele Bassi <ebassi@linux.intel.com> Bug 1209 - Move fixed point API in COGL * clutter/cogl/cogl-fixed.h: * clutter/cogl/cogl.h.in: * clutter/cogl/common/Makefile.am: * clutter/cogl/common/cogl-fixed.c: Add fixed point API, modelled after the ClutterFixed. The CoglFixed API supercedes the ClutterFixed one and avoids the dependency of COGL on Clutter's own API. * clutter/cogl/common/cogl-clip-stack.c: * clutter/cogl/common/cogl-primitives.c: * clutter/cogl/common/cogl-primitives.h: Update internal usage of ClutterFixed to CoglFixed. * clutter/cogl/gl/Makefile.am: * clutter/cogl/gl/cogl-primitives.c: * clutter/cogl/gl/cogl-texture.c: * clutter/cogl/gl/cogl.c: Ditto, in the GL implementation of the COGL API. * clutter/cogl/gles/Makefile.am: * clutter/cogl/gles/cogl-fbo.c: * clutter/cogl/gles/cogl-gles2-wrapper.c: * clutter/cogl/gles/cogl-primitives.c: * clutter/cogl/gles/cogl-texture.c: * clutter/cogl/gles/cogl.c: Ditto, in the GLES implementation of the COGL API. * clutter/pango/pangoclutter-glyph-cache.c: * clutter/pango/pangoclutter-glyph-cache.h: Ditto, in the Pango renderer glyphs cache. * clutter/clutter-fixed.c: * clutter/clutter-fixed.h: ClutterFixed and related API becomes a simple transition API for bindings and public Clutter API. * clutter/clutter-actor.c: * clutter/clutter-alpha.c: * clutter/clutter-backend.c: * clutter/clutter-behaviour-depth.c: * clutter/clutter-behaviour-ellipse.c: * clutter/clutter-behaviour-path.c: * clutter/clutter-behaviour-rotate.c: * clutter/clutter-behaviour-scale.c: * clutter/clutter-clone-texture.c: * clutter/clutter-color.c: * clutter/clutter-entry.c: * clutter/clutter-stage.c: * clutter/clutter-texture.c: * clutter/clutter-timeline.c: * clutter/clutter-units.h: Move from the internal usage of ClutterFixed to CoglFixed. * doc/reference/clutter/clutter-sections.txt: * doc/reference/cogl/cogl-docs.sgml: * doc/reference/cogl/cogl-sections.txt: Update the documentation. * tests/test-cogl-tex-tile.c: * tests/test-project.c: Fix tests after the API change * README: Add release notes.
2008-10-30 16:37:55 +00:00
<xi:include href="xml/cogl-fixed.xml"/>
2008-07-01 Emmanuele Bassi <ebassi@openedhand.com> * cogl/cogl-docs.sgml: Add an index to the COGL API reference and the licensing information.
2008-07-01 10:15:07 +00:00
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
</chapter>
2008-07-01 Emmanuele Bassi <ebassi@openedhand.com> * cogl/cogl-docs.sgml: Add an index to the COGL API reference and the licensing information.
2008-07-01 10:15:07 +00:00
cogl-buffer: add an abstract class around openGL's buffer objects Buffer objects are cool! This abstracts the buffer API first introduced by GL_ARB_vertex_buffer_object and then extended to other objects. The coglBuffer abstract class is intended to be the base class of all the buffer objects, letting the user map() buffers. If the underlying implementation does not support buffer objects (or only support VBO but not FBO for instance), fallback paths should be provided.
2010-01-10 17:28:24 +00:00
<chapter>
docs: Use "Cogl" not "COGL" in Cogl API reference Cogl isn't an acronym so we should use "Cogl" instead of "COGL" in our documentation.
2010-08-25 19:33:27 +00:00
<title>Cogl experimental API</title>
cogl-buffer: add an abstract class around openGL's buffer objects Buffer objects are cool! This abstracts the buffer API first introduced by GL_ARB_vertex_buffer_object and then extended to other objects. The coglBuffer abstract class is intended to be the base class of all the buffer objects, letting the user map() buffers. If the underlying implementation does not support buffer objects (or only support VBO but not FBO for instance), fallback paths should be provided.
2010-01-10 17:28:24 +00:00
<section id="cogl-experimental">
<title>About the experimental API</title>
docs: Use "Cogl" not "COGL" in Cogl API reference Cogl isn't an acronym so we should use "Cogl" instead of "COGL" in our documentation.
2010-08-25 19:33:27 +00:00
<para>Cogl has some experimental API developers are welcomed to play
cogl-buffer: add an abstract class around openGL's buffer objects Buffer objects are cool! This abstracts the buffer API first introduced by GL_ARB_vertex_buffer_object and then extended to other objects. The coglBuffer abstract class is intended to be the base class of all the buffer objects, letting the user map() buffers. If the underlying implementation does not support buffer objects (or only support VBO but not FBO for instance), fallback paths should be provided.
2010-01-10 17:28:24 +00:00
with. The main drawback when using those is that there is no API
stability guarantee, functions flagged as experimental could be changed
or removed in future versions of the library. To use this experimental
API you will need to define
<literal>COGL_ENABLE_EXPERIMENTAL_API</literal> before including
<filename class="headerfile">&lt;clutter/clutter.h&gt;</filename> or
<filename class="headerfile">&lt;cogl/cogl.h&gt;</filename>.</para>
</section>
<xi:include href="xml/cogl-buffer.xml"/>
math: Adds an experimental cogl_vector3_* API This adds a math utility API for handling 3 component, single precision float vectors with the following; mostly self explanatory functions: cogl_vector3_init cogl_vector3_init_zero cogl_vector3_equal cogl_vector3_equal_with_epsilon cogl_vector3_copy cogl_vector3_free cogl_vector3_invert cogl_vector3_add cogl_vector3_subtract cogl_vector3_multiply_scalar cogl_vector3_divide_scalar cogl_vector3_normalize cogl_vector3_magnitude cogl_vector3_cross_product cogl_vector3_dot_product cogl_vector3_distance Since the API is experimental you will need to define COGL_ENABLE_EXPERIMENTAL_API before including cogl.h if you want to use the API.
2010-05-20 13:54:44 +00:00
<xi:include href="xml/cogl-vector.xml"/>
docs: cogl-texture-3d wasn't listed as experimental The CoglTexture3D API is only available when defining COGL_ENABLE_EXPERIMENTAL_API so it should be listed in the experimental section of the API reference.
2010-08-25 19:36:20 +00:00
<xi:include href="xml/cogl-texture-3d.xml"/>
cogl-buffer: add an abstract class around openGL's buffer objects Buffer objects are cool! This abstracts the buffer API first introduced by GL_ARB_vertex_buffer_object and then extended to other objects. The coglBuffer abstract class is intended to be the base class of all the buffer objects, letting the user map() buffers. If the underlying implementation does not support buffer objects (or only support VBO but not FBO for instance), fallback paths should be provided.
2010-01-10 17:28:24 +00:00
</chapter>
docs: Put deprecated Cogl symbols into new section This adds a "Cogl deprecated API" chapter to the Cogl reference manual so we can group all the documentation for deprecated symbols together instead of having them clutter up the documentation of symbols we would rather developers used.
2010-09-23 14:45:27 +00:00
<chapter>
<title>Cogl deprecated API</title>
<section id="cogl-deprecated">
<title>About the deprecated API</title>
<para>Cogl has evolved from once being a thin abstraction over
OpenGL and GLES where a lot of OpenGL's state machine style APIs
were simply rebranded as Cogl API into the more distinguished API
style we have today. The result of this evolution though is that
some of the APIs are considered deprecated and because we plan to
remove them at the next opportunity we have to break the API
developers should aim to avoid these functions to keep their code
working with future major versions of Cogl.</para>
</section>
<xi:include href="xml/cogl-deprecated.xml"/>
<xi:include href="xml/cogl-texture-deprecated.xml"/>
<xi:include href="xml/cogl-material-deprecated.xml"/>
<xi:include href="xml/cogl-clipping-deprecated.xml"/>
<xi:include href="xml/cogl-vertex-buffer-deprecated.xml"/>
<xi:include href="xml/cogl-shaders-deprecated.xml"/>
<xi:include href="xml/cogl-offscreen-deprecated.xml"/>
</chapter>
docs: Fix up the Cogl API reference build
2010-09-03 16:15:22 +00:00
<chapter id="coglglossary">
docs: Add annotation glossary to the Cogl API reference It's the only way to let gtk-doc know that we're using annotations in the comments.
2010-09-03 15:52:06 +00:00
<title>Glossaries</title>
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
</chapter>
2008-07-01 Emmanuele Bassi <ebassi@openedhand.com> * cogl/cogl-docs.sgml: Add an index to the COGL API reference and the licensing information.
2008-07-01 10:15:07 +00:00
<index>
docs: Add indices to the Cogl API reference The Clutter API reference has an index of the symbols for each minor version, and a list of deprecated symbols. The Cogl API reference should have the same layout.
2009-11-19 14:30:01 +00:00
<title>Index of all symbols</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index>
<index role="deprecated">
<title>Index of deprecated symbols</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index>
<index role="0.8">
<title>Index of new symbols in 0.8</title>
<xi:include href="xml/api-index-0.8.xml"><xi:fallback /></xi:include>
</index>
<index role="1.0">
<title>Index of new symbols in 1.0</title>
<xi:include href="xml/api-index-1.0.xml"><xi:fallback /></xi:include>
</index>
<index role="1.2">
<title>Index of new symbols in 1.2</title>
<xi:include href="xml/api-index-1.2.xml"><xi:fallback /></xi:include>
2008-07-01 Emmanuele Bassi <ebassi@openedhand.com> * cogl/cogl-docs.sgml: Add an index to the COGL API reference and the licensing information.
2008-07-01 10:15:07 +00:00
</index>
docs: Add 1.4 index to the API references Now that master has branched for the 1.3 development cycle.
2010-03-25 09:45:59 +00:00
<index role="1.4">
<title>Index of new symbols in 1.4</title>
<xi:include href="xml/api-index-1.4.xml"><xi:fallback /></xi:include>
</index>
2008-07-01 Emmanuele Bassi <ebassi@openedhand.com> * cogl/cogl-docs.sgml: Add an index to the COGL API reference and the licensing information.
2008-07-01 10:15:07 +00:00
<appendix id="license">
<title>License</title>
<para>
This library is free software; you can redistribute it and/or
modify it under the terms of the <citetitle>GNU Library General
Public License</citetitle> as published by the Free Software
Foundation; either version 2 of the License, or (at your option)
any later version.
</para>
<para>
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
<citetitle>GNU Library General Public License</citetitle> for
more details.
</para>
<para>
You may obtain a copy of the <citetitle>GNU Library General
Public License</citetitle> from the Free Software Foundation by
visiting <ulink type="http" url="http://www.fsf.org">their Web
site</ulink> or by writing to:
<address>
Free Software Foundation, Inc.
<street>59 Temple Place</street> - Suite 330
<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
<country>USA</country>
</address>
</para>
</appendix>
Merged clutter-ivan branch into trunk. svn merge \ https://svn.o-hand.com/repos/clutter/trunk/clutter@2509 \ https://svn.o-hand.com/repos/clutter/branches/clutter-ivan@HEAD
2008-04-25 13:37:36 +00:00
</book>
Reference in New Issue Copy Permalink