sungmg/mutter-performance-source
1
0
Fork 0
Code Activity
mutter-performance-source/doc/reference/clutter/Makefile.am

186 lines
5.9 KiB
Makefile
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
## Process this file with automake to produce Makefile.in
# We require automake 1.6 at least.
AUTOMAKE_OPTIONS = 1.6
# This is a blank Makefile.am for using gtk-doc.
# Copy this to your project's API docs directory and modify the variables to
# suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples
# of using the various options.
# The name of the module, e.g. 'glib'.
DOC_MODULE=clutter
# The top-level SGML file. You can change this if you want to.
2008-11-17 Emmanuele Bassi <ebassi@linux.intel.com> Bug 1014 - Clutter Animation API Improvements * clutter/Makefile.am: * clutter/clutter.h: Update the build * clutter/clutter-types.h: Add AnimationMode, an enumeration for easing functions. * clutter/clutter-alpha.[ch]: Add the :mode property to control the function bound to an Alpha instance using an enumeration value. Also add six new alpha functions: - ease-in, ease-out, ease-in-out - sine-in, sine-out, sine-in-out * clutter/clutter-deprecated.h: Deprecate the #defines for the alpha functions. They will be replaced by entries in the ClutterAnimationMode. * clutter/clutter-interval.[ch]: Add ClutterInterval, an object for defining, validating and computing an interval between two values. * clutter/clutter-animation.[ch]: Add ClutterAnimation, an object responsible for animation the properties of a single actor along an interval of values. ClutterAnimation memory management is automatic. A simple wrapper method for ClutterActor is provided: clutter_actor_animate() which will create, or update, an animation for the passed actor. * clutter/clutter-debug.h: * clutter/clutter-main.c: Add a new 'animation' debug note. * clutter/clutter-script.c: Clean up the alpha functions whitelist, and add the new functions. * doc/reference/clutter/Makefile.am: * doc/reference/clutter/clutter-sections.txt: Update the API reference. * doc/reference/clutter/clutter-animation.xml: Renamed to doc/reference/clutter/clutter-animation-tutorial.xml to avoid clashes with the ClutterAnimation section. * doc/reference/clutter/clutter-docs.sgml: Renamed to doc/reference/clutter/clutter-docs.xml, as it was an XML file and not a SGML file. * tests/Makefile.am: * tests/interactive/Makefile.am: * tests/interactive/test-animation.c: * tests/interactive/test-easing.c: Add two tests for the new simple animation API and the easing functions. * tests/interactive/test-actors.c: * tests/interactive/test-behave.c: * tests/interactive/test-depth.c: * tests/interactive/test-effects.c: * tests/interactive/test-layout.c: * tests/interactive/test-multistage.c: * tests/interactive/test-paint-wrapper.c: * tests/interactive/test-rotate.c: * tests/interactive/test-scale.c: * tests/interactive/test-texture-quality.c: * tests/interactive/test-threads.c: * tests/interactive/test-viewport.c: Update interactive tests to the deprecations and new alpha API.
2008-11-18 09:50:03 +00:00
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.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
# The directory containing the source code. Relative to $(srcdir).
# gtk-doc will search all .c & .h files beneath here for inline comments
# documenting the functions and macros.
# e.g. DOC_SOURCE_DIR=../../../gtk
DOC_SOURCE_DIR=../../../clutter
# Extra options to pass to gtkdoc-scangobj. Not normally needed.
SCANGOBJ_OPTIONS=--type-init-func="clutter_base_init()"
# Extra options to supply to gtkdoc-scan.
Intial Re-layout of the Cogl source code and introduction of a Cogl Winsys As part of an incremental process to have Cogl be a standalone project we want to re-consider how we organise the Cogl source code. Currently this is the structure I'm aiming for: cogl/ cogl/ <put common source here> winsys/ cogl-glx.c cogl-wgl.c driver/ gl/ gles/ os/ ? utils/ cogl-fixed cogl-matrix-stack? cogl-journal? cogl-primitives? pango/ The new winsys component is a starting point for migrating window system code (i.e. x11,glx,wgl,osx,egl etc) from Clutter to Cogl. The utils/ and pango/ directories aren't added by this commit, but they are noted because I plan to add them soon. Overview of the planned structure: * The winsys/ API is the API that binds OpenGL to a specific window system, be that X11 or win32 etc. Example are glx, wgl and egl. Much of the logic under clutter/{glx,osx,win32 etc} should migrate here. * Note there is also the idea of a winsys-base that may represent a window system for which there are multiple winsys APIs. An example of this is x11, since glx and egl may both be used with x11. (currently only Clutter has the idea of a winsys-base) * The driver/ represents a specific varient of OpenGL. Currently we have "gl" representing OpenGL 1.4-2.1 (mostly fixed function) and "gles" representing GLES 1.1 (fixed funciton) and 2.0 (fully shader based) * Everything under cogl/ should fundamentally be supporting access to the GPU. Essentially Cogl's most basic requirement is to provide a nice GPU Graphics API and drawing a line between this and the utility functionality we add to support Clutter should help keep this lean and maintainable. * Code under utils/ as suggested builds on cogl/ adding more convenient APIs or mechanism to optimize special cases. Broadly speaking you can compare cogl/ to OpenGL and utils/ to GLU. * clutter/pango will be moved to clutter/cogl/pango How some of the internal configure.ac/pkg-config terminology has changed: backendextra -> CLUTTER_WINSYS_BASE # e.g. "x11" backendextralib -> CLUTTER_WINSYS_BASE_LIB # e.g. "x11/libclutter-x11.la" clutterbackend -> {CLUTTER,COGL}_WINSYS # e.g. "glx" CLUTTER_FLAVOUR -> {CLUTTER,COGL}_WINSYS clutterbackendlib -> CLUTTER_WINSYS_LIB CLUTTER_COGL -> COGL_DRIVER # e.g. "gl" Note: The CLUTTER_FLAVOUR and CLUTTER_COGL defines are kept for apps As the first thing to take advantage of the new winsys component in Cogl; cogl_get_proc_address() has been moved from cogl/{gl,gles}/cogl.c into cogl/common/cogl.c and this common implementation first trys _cogl_winsys_get_proc_address() but if that fails then it falls back to gmodule.
2009-07-28 01:02:02 +00:00
# e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
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
SCAN_OPTIONS=--deprecated-guards="CLUTTER_DISABLE_DEPRECATED"
# Extra options to supply to gtkdoc-mkdb.
# e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
[docs] Use the --name-space option Now that we depend on gtk-doc 1.11 we can use the --name-space command line option for the mkdb utility.
2009-02-20 11:58:04 +00:00
MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=clutter
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
# Extra options to supply to gtkdoc-mktmpl
# e.g. MKTMPL_OPTIONS=--only-section-tmpl
MKTMPL_OPTIONS=
# Extra options to supply to gtkdoc-fixref. Not normally needed.
# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
FIXXREF_OPTIONS=\
--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \
[docs] Add fixxref for Cairo symbols Let gtk-doc resolve the Cairo types and symbols to the installed Cairo documentation.
2009-09-09 15:15:54 +00:00
--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \
--extra-dir=$(CAIRO_PREFIX)/share/gtk-doc/html/cairo \
build: Update the API reference build Add the Cogl prefix to the fix-cross-references script options, and update the location of the extra headers.
2011-06-20 12:56:46 +00:00
--extra-dir=$(PANGO_PREFIX)/share/gtk-doc/html/pango \
--extra-dir=$(COGL_PREFIX)/share/gtk-doc/html/cogl
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
# Used for dependencies. The docs will be rebuilt if any of these change.
# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h
# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c
build: Update the API reference build Add the Cogl prefix to the fix-cross-references script options, and update the location of the extra headers.
2011-06-20 12:56:46 +00:00
HFILE_GLOB=\
$(top_srcdir)/clutter/*.h \
docs: Various fixes for gtk-doc
2010-06-30 14:50:47 +00:00
$(top_builddir)/clutter/*.h \
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
$(top_srcdir)/clutter/x11/clutter-x11.h \
[docs] Pick up backend-specific API The various backend API outside from clutter-x11.h and clutter-win32.h is documented but not picked up by gtk-doc.
2009-03-18 17:06:56 +00:00
$(top_srcdir)/clutter/x11/clutter-x11-texture-pixmap.h \
build: Update the API reference build Add the Cogl prefix to the fix-cross-references script options, and update the location of the extra headers.
2011-06-20 12:56:46 +00:00
$(top_srcdir)/clutter/cogl/clutter-glx-texture-pixmap.h \
$(top_srcdir)/clutter/cogl/clutter-egl.h \
$(top_srcdir)/clutter/cogl/clutter-cex100.h \
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
$(top_srcdir)/clutter/win32/clutter-win32.h
build: Update the API reference build Add the Cogl prefix to the fix-cross-references script options, and update the location of the extra headers.
2011-06-20 12:56:46 +00:00
CFILE_GLOB=\
$(top_srcdir)/clutter/*.c \
$(top_srcdir)/clutter/cogl/*.c \
[docs] Pick up backend-specific API The various backend API outside from clutter-x11.h and clutter-win32.h is documented but not picked up by gtk-doc.
2009-03-18 17:06:56 +00:00
$(top_srcdir)/clutter/x11/*.c \
build: Update the API reference build Add the Cogl prefix to the fix-cross-references script options, and update the location of the extra headers.
2011-06-20 12:56:46 +00:00
$(top_srcdir)/clutter/win32/*.c
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
# Header files to ignore when scanning.
# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
IGNORE_HFILES=\
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter.h \
Miscellaneous documentation fixes
2010-05-19 15:10:05 +00:00
clutter-actor-meta-private.h \
gtk-doc: Fixes for the API references
2010-11-08 16:01:19 +00:00
clutter-actor-private.h \
clutter-backend-private.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-bezier.h \
color: Add named, global colors Since EGA colors are apparently all the rage in other toolkits, Clutter should not be left out. On top of the usual CGA/EGA palette the static colors also include the Tango Icon palette, which at least is more pleasant to the eye. Static colors are accessed through an enumeration by using clutter_color_get_static(), or using the short-hand pre-processor macros. http://bugzilla.clutter-project.org/show_bug.cgi?id=2066
2010-04-06 09:54:20 +00:00
clutter-color-static.h \
docs: Ignore clutter-config.h when scanning headers
2011-01-19 17:54:28 +00:00
clutter-config.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-debug.h \
clutter-deprecated.h \
gtk-doc: Fixes for the API references
2010-11-08 16:01:19 +00:00
clutter-device-manager-private.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-enum-types.h \
docs: Fill out documentation for new symbols
2011-01-18 14:09:04 +00:00
clutter-event-translator.h \
docs: Fix up new symbols for the API reference
2011-06-09 14:40:57 +00:00
clutter-flatten-effect.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-id-pool.h \
clutter-keysyms.h \
keysyms: Update the macros to CLUTTER_KEY_* The keysyms defines in clutter-keysyms.h are generated from the X11 key symbols headers by doing the equivalent of a pass of sed from XK_* to CLUTTER_*. This might lead to namespace collisions, down the road. Instead, we should use the CLUTTER_KEY_* namespace. This commit includes the script, taken from GDK, that parses the X11 key symbols and generates two headers: - clutter-keysyms.h: the default included header, with CLUTTER_KEY_* - clutter-keysyms-compat.h: the compatibility header, with CLUTTER_* The compat.h header file is included if CLUTTER_DISABLE_DEPRECATED is not defined - essentially deprecating all the old key symbols. This does not change any ABI and, assuming that an application or library is not compiling with CLUTTER_DISABLE_DEPRECATED, the source compatibility is still guaranteed.
2010-09-10 12:41:49 +00:00
clutter-keysyms-compat.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-keysyms-table.h \
clutter-marshal.h \
clutter-master-clock.h \
clutter-model-private.h \
gtk-doc: Fixes for the API references
2010-11-08 16:01:19 +00:00
clutter-paint-volume-private.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-private.h \
clutter-profile.h \
clutter-script-private.h \
gtk-doc: Fixes for the API references
2010-11-08 16:01:19 +00:00
clutter-stage-manager-private.h \
clutter-stage-private.h \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
clutter-stage-window.h \
clutter-timeout-interval.h \
docs: Add Cally API reference
2010-07-05 12:59:36 +00:00
cally \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
cogl \
docs: Documentation fixes
2010-12-09 15:06:12 +00:00
evdev \
docs: Ignore clutter-profile.h
2010-01-15 14:47:20 +00:00
osx \
x11 \
gtk-doc: Fixes for the API references
2010-11-08 16:01:19 +00:00
wayland \
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
win32
EXTRA_HFILES=\
[build] Use top_srcdir instead of relative paths
2009-06-10 13:24:33 +00:00
$(top_srcdir)/clutter/x11/clutter-x11.h \
$(top_srcdir)/clutter/x11/clutter-x11-texture-pixmap.h \
build: Update the API reference build Add the Cogl prefix to the fix-cross-references script options, and update the location of the extra headers.
2011-06-20 12:56:46 +00:00
$(top_srcdir)/clutter/cogl/clutter-glx-texture-pixmap.h \
$(top_srcdir)/clutter/cogl/clutter-egl.h \
$(top_srcdir)/clutter/cogl/clutter-cex100.h \
reference: Add a Wayland section
2010-11-08 16:15:23 +00:00
$(top_srcdir)/clutter/wayland/clutter-wayland.h \
[build] Use top_srcdir instead of relative paths
2009-06-10 13:24:33 +00:00
$(top_srcdir)/clutter/win32/clutter-win32.h
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
# Images to copy into HTML directory.
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
HTML_IMAGES=\
actor-box.png \
docs: Add visual cue for Animator's key frames We should explain what a "key frame" is for ClutterAnimator, possibly with some sort of visual cue. This allows me to demonstrate my poor skills at using Inkscape, as well as my overall bad taste for graphics design.
2010-02-25 17:09:55 +00:00
animator-key-frames.png \
docs: Add images for layout managers It's easier to show the layout manager policy with a simple screen shot coming from our interactive tests.
2009-10-23 16:32:18 +00:00
bin-layout.png \
box-layout.png \
docs: Add introductory section on Constraints Use the snap-constraint code for the example code and screenshot.
2010-11-15 15:02:07 +00:00
constraints-example.png \
[docs] Update the easing modes documentation The ClutterAlpha API reference page should also list the easing modes Clutter provides by default, by showing the curves used by each entry in the AnimationMode enumeration. We can also remove the incomplete graph showing the old alpha functions.
2009-01-20 18:13:36 +00:00
easing-modes.png \
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
event-flow.png \
docs: Add images for layout managers It's easier to show the layout manager policy with a simple screen shot coming from our interactive tests.
2009-10-23 16:32:18 +00:00
flow-layout-horizontal.png \
flow-layout-vertical.png \
clutter-actor: Add an 'offscreen-redirect' property This adds a property which can be used to redirect the actor through an FBO before painting so that it becomes flattened in an image. The image can be used as a cache to avoid having to repaint the actor if something unrelated in the scene changes. It can also be used to implement correct opacity even if the actor has overlapping primitives. The property is an enum that takes three values: CLUTTER_OFFSCREEN_REDIRECT_NEVER: The default behaviour which is to never flatten the actor. CLUTTER_OFFSCREEN_REDIRECT_ALWAYS: The actor is always redirected through an FBO. CLUTTER_OFFSCREEN_REDIRECT_ONLY_FOR_OPACITY: The actor is only redirected through an FBO if the paint opacity is not 255. This value would be used if the actor wants correct opacity. It will avoid the overhead of using an FBO whenever the actor is fully opaque. The property is implemented by installing a ClutterFlattenEffect. ClutterFlattenEffect is a new internal class which subclasses ClutterOffscreen to redirect the painting to an FBO. When ClutterOffscreen paints, the effect sets an opacity override on the actor so that the image will always contain the actor at full opacity. The opacity is then applied to the resulting image before painting it to the stage. This means the actor does not need to be redrawn while the opacity is being animated. The effect has a high internal priority so that it will always occur before any other effects and it gets hidden from the application.
2011-02-28 15:05:51 +00:00
path-alpha-func.png \
offscreen-redirect.png
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
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
content_files= \
[docs] Add more collateral documentation * Add the main Glossary for Clutter terms * Add the annotation glossary, as generated by gtk-doc * Add the objects index and tree
2009-09-03 15:51:14 +00:00
glossary.xml \
2008-06-26 Emmanuele Bassi <ebassi@openedhand.com> * clutter/clutter-overview.xml: Split the overview into its own file, so we gtk-doc can linkify all class names. * clutter/building-clutter.xml: Split the building instructions into its own file, for better maintainability. * clutter/clutter-animation.xml: * clutter/creating-behaviours.xml: * clutter/subclassing-ClutterActor.xml: Rename from SGML to XML; these were not SGML files anyway, but templates. * clutter/clutter-docs.sgml: Use XInclude instead of the ugly entities hack. * clutter/Makefile.am: Update the build.
2008-06-26 09:02:58 +00:00
subclassing-ClutterActor.xml \
2008-11-17 Emmanuele Bassi <ebassi@linux.intel.com> Bug 1014 - Clutter Animation API Improvements * clutter/Makefile.am: * clutter/clutter.h: Update the build * clutter/clutter-types.h: Add AnimationMode, an enumeration for easing functions. * clutter/clutter-alpha.[ch]: Add the :mode property to control the function bound to an Alpha instance using an enumeration value. Also add six new alpha functions: - ease-in, ease-out, ease-in-out - sine-in, sine-out, sine-in-out * clutter/clutter-deprecated.h: Deprecate the #defines for the alpha functions. They will be replaced by entries in the ClutterAnimationMode. * clutter/clutter-interval.[ch]: Add ClutterInterval, an object for defining, validating and computing an interval between two values. * clutter/clutter-animation.[ch]: Add ClutterAnimation, an object responsible for animation the properties of a single actor along an interval of values. ClutterAnimation memory management is automatic. A simple wrapper method for ClutterActor is provided: clutter_actor_animate() which will create, or update, an animation for the passed actor. * clutter/clutter-debug.h: * clutter/clutter-main.c: Add a new 'animation' debug note. * clutter/clutter-script.c: Clean up the alpha functions whitelist, and add the new functions. * doc/reference/clutter/Makefile.am: * doc/reference/clutter/clutter-sections.txt: Update the API reference. * doc/reference/clutter/clutter-animation.xml: Renamed to doc/reference/clutter/clutter-animation-tutorial.xml to avoid clashes with the ClutterAnimation section. * doc/reference/clutter/clutter-docs.sgml: Renamed to doc/reference/clutter/clutter-docs.xml, as it was an XML file and not a SGML file. * tests/Makefile.am: * tests/interactive/Makefile.am: * tests/interactive/test-animation.c: * tests/interactive/test-easing.c: Add two tests for the new simple animation API and the easing functions. * tests/interactive/test-actors.c: * tests/interactive/test-behave.c: * tests/interactive/test-depth.c: * tests/interactive/test-effects.c: * tests/interactive/test-layout.c: * tests/interactive/test-multistage.c: * tests/interactive/test-paint-wrapper.c: * tests/interactive/test-rotate.c: * tests/interactive/test-scale.c: * tests/interactive/test-texture-quality.c: * tests/interactive/test-threads.c: * tests/interactive/test-viewport.c: Update interactive tests to the deprecations and new alpha API.
2008-11-18 09:50:03 +00:00
clutter-animation-tutorial.xml \
2008-06-26 Emmanuele Bassi <ebassi@openedhand.com> * clutter/clutter-overview.xml: Split the overview into its own file, so we gtk-doc can linkify all class names. * clutter/building-clutter.xml: Split the building instructions into its own file, for better maintainability. * clutter/clutter-animation.xml: * clutter/creating-behaviours.xml: * clutter/subclassing-ClutterActor.xml: Rename from SGML to XML; these were not SGML files anyway, but templates. * clutter/clutter-docs.sgml: Use XInclude instead of the ugly entities hack. * clutter/Makefile.am: Update the build.
2008-06-26 09:02:58 +00:00
creating-behaviours.xml \
clutter-overview.xml \
[docs] Document envvars and command line switches Clutter uses checks on various environment variables and installs various command line switches. The API reference should list them and document them both.
2009-02-23 13:44:03 +00:00
building-clutter.xml \
[docs] Add an initial porting guide The Clutter API reference should have a section on how to port applications from older version of Clutter to the new API. The first guide deals on how to port animations created with ClutterEffect to clutter_actor_animate().
2009-06-23 14:25:16 +00:00
running-clutter.xml \
[docs] Add a Path migration guide ClutterBehaviourPath has been changed and ClutterBehaviourBspline has been removed; now we use ClutterPath everywhere we need to describe a path. This warrants a chapter in the migration guide.
2009-09-09 15:01:07 +00:00
migrating-ClutterEffect.xml \
docs: Add Behaviour migration guide
2010-11-10 13:15:06 +00:00
migrating-ClutterPath.xml \
migrating-ClutterBehaviour.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
# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
# These files must be listed here *and* in content_files
# e.g. expand_content_files=running.sgml
expand_content_files= \
[docs] Add more collateral documentation * Add the main Glossary for Clutter terms * Add the annotation glossary, as generated by gtk-doc * Add the objects index and tree
2009-09-03 15:51:14 +00:00
glossary.xml \
2008-06-26 Emmanuele Bassi <ebassi@openedhand.com> * clutter/clutter-overview.xml: Split the overview into its own file, so we gtk-doc can linkify all class names. * clutter/building-clutter.xml: Split the building instructions into its own file, for better maintainability. * clutter/clutter-animation.xml: * clutter/creating-behaviours.xml: * clutter/subclassing-ClutterActor.xml: Rename from SGML to XML; these were not SGML files anyway, but templates. * clutter/clutter-docs.sgml: Use XInclude instead of the ugly entities hack. * clutter/Makefile.am: Update the build.
2008-06-26 09:02:58 +00:00
subclassing-ClutterActor.xml \
2008-11-17 Emmanuele Bassi <ebassi@linux.intel.com> Bug 1014 - Clutter Animation API Improvements * clutter/Makefile.am: * clutter/clutter.h: Update the build * clutter/clutter-types.h: Add AnimationMode, an enumeration for easing functions. * clutter/clutter-alpha.[ch]: Add the :mode property to control the function bound to an Alpha instance using an enumeration value. Also add six new alpha functions: - ease-in, ease-out, ease-in-out - sine-in, sine-out, sine-in-out * clutter/clutter-deprecated.h: Deprecate the #defines for the alpha functions. They will be replaced by entries in the ClutterAnimationMode. * clutter/clutter-interval.[ch]: Add ClutterInterval, an object for defining, validating and computing an interval between two values. * clutter/clutter-animation.[ch]: Add ClutterAnimation, an object responsible for animation the properties of a single actor along an interval of values. ClutterAnimation memory management is automatic. A simple wrapper method for ClutterActor is provided: clutter_actor_animate() which will create, or update, an animation for the passed actor. * clutter/clutter-debug.h: * clutter/clutter-main.c: Add a new 'animation' debug note. * clutter/clutter-script.c: Clean up the alpha functions whitelist, and add the new functions. * doc/reference/clutter/Makefile.am: * doc/reference/clutter/clutter-sections.txt: Update the API reference. * doc/reference/clutter/clutter-animation.xml: Renamed to doc/reference/clutter/clutter-animation-tutorial.xml to avoid clashes with the ClutterAnimation section. * doc/reference/clutter/clutter-docs.sgml: Renamed to doc/reference/clutter/clutter-docs.xml, as it was an XML file and not a SGML file. * tests/Makefile.am: * tests/interactive/Makefile.am: * tests/interactive/test-animation.c: * tests/interactive/test-easing.c: Add two tests for the new simple animation API and the easing functions. * tests/interactive/test-actors.c: * tests/interactive/test-behave.c: * tests/interactive/test-depth.c: * tests/interactive/test-effects.c: * tests/interactive/test-layout.c: * tests/interactive/test-multistage.c: * tests/interactive/test-paint-wrapper.c: * tests/interactive/test-rotate.c: * tests/interactive/test-scale.c: * tests/interactive/test-texture-quality.c: * tests/interactive/test-threads.c: * tests/interactive/test-viewport.c: Update interactive tests to the deprecations and new alpha API.
2008-11-18 09:50:03 +00:00
clutter-animation-tutorial.xml \
2008-06-26 Emmanuele Bassi <ebassi@openedhand.com> * clutter/clutter-overview.xml: Split the overview into its own file, so we gtk-doc can linkify all class names. * clutter/building-clutter.xml: Split the building instructions into its own file, for better maintainability. * clutter/clutter-animation.xml: * clutter/creating-behaviours.xml: * clutter/subclassing-ClutterActor.xml: Rename from SGML to XML; these were not SGML files anyway, but templates. * clutter/clutter-docs.sgml: Use XInclude instead of the ugly entities hack. * clutter/Makefile.am: Update the build.
2008-06-26 09:02:58 +00:00
creating-behaviours.xml \
clutter-overview.xml \
[docs] Document envvars and command line switches Clutter uses checks on various environment variables and installs various command line switches. The API reference should list them and document them both.
2009-02-23 13:44:03 +00:00
building-clutter.xml \
[docs] Add an initial porting guide The Clutter API reference should have a section on how to port applications from older version of Clutter to the new API. The first guide deals on how to port animations created with ClutterEffect to clutter_actor_animate().
2009-06-23 14:25:16 +00:00
running-clutter.xml \
[docs] Add a Path migration guide ClutterBehaviourPath has been changed and ClutterBehaviourBspline has been removed; now we use ClutterPath everywhere we need to describe a path. This warrants a chapter in the migration guide.
2009-09-09 15:01:07 +00:00
migrating-ClutterEffect.xml \
docs: Add Behaviour migration guide
2010-11-10 13:15:06 +00:00
migrating-ClutterPath.xml \
migrating-ClutterBehaviour.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
# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
# Only needed if you are using gtkdoc-scangobj to dynamically query widget
# signals and properties.
# e.g. INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS)
# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib)
build: Fix out of tree gtk-doc generation Various headers are build in builddirs (clutter-marshal.h, mkenums headers and cogl-define.h) so we need to add the corresponding include paths for gtk-doc to build its scanner.
2010-06-03 12:48:53 +00:00
INCLUDES=-I$(top_srcdir) -I$(top_srcdir)/clutter -I$(top_srcdir)/clutter/cogl -I$(top_builddir) -I$(top_builddir)/clutter -I$(top_builddir)/clutter/cogl $(CLUTTER_CFLAGS)
build: distinguish CLUTTER_WINSYS and CLUTTER_SONAME_INFIX This adds a separate variable name "CLUTTER_SONAME_INFIX" to define the infix for the clutter library that gets linked. Currently the WINSYS corresponds to the directory we enter when building to compile the window system and input support, but it is desirable to be able to define multiple flavours that use the same WINSYS but should result in different library names. For example we are planning to combine the eglx and eglnative window systems into one "egl" winsys but we will need to preserve the current library names for the eglx and eglnative flavours.
2010-06-18 00:25:46 +00:00
GTKDOC_LIBS=$(top_builddir)/clutter/libclutter-@CLUTTER_SONAME_INFIX@-@CLUTTER_API_VERSION@.la $(CLUTTER_LIBS)
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
# This includes the standard gtk-doc make rules, copied by gtkdocize.
include $(top_srcdir)/gtk-doc.make
# Other files to distribute
# e.g. EXTRA_DIST += version.xml.in
2008-04-28 Emmanuele Bassi <ebassi@openedhand.com> * clutter/clutter-docs.sgml: Add index for the 0.8 symbols. * clutter/Makefile.am: * cogl/Makefile.am: Revert back, as EXTRA_DIST has been defined by gtk-doc.make and automake-1.9 complains loudly about a redefinition of EXTRA_DIST.
2008-04-28 15:22:54 +00:00
EXTRA_DIST += \
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
actor-box.png \
docs: Add visual cue for Animator's key frames We should explain what a "key frame" is for ClutterAnimator, possibly with some sort of visual cue. This allows me to demonstrate my poor skills at using Inkscape, as well as my overall bad taste for graphics design.
2010-02-25 17:09:55 +00:00
animator-key-frames.png \
animator-key-frames.svg \
docs: Add images for layout managers It's easier to show the layout manager policy with a simple screen shot coming from our interactive tests.
2009-10-23 16:32:18 +00:00
bin-layout.png \
box-layout.png \
docs: Add introductory section on Constraints Use the snap-constraint code for the example code and screenshot.
2010-11-15 15:02:07 +00:00
constraints-example.png \
[docs] Update the easing modes documentation The ClutterAlpha API reference page should also list the easing modes Clutter provides by default, by showing the curves used by each entry in the AnimationMode enumeration. We can also remove the incomplete graph showing the old alpha functions.
2009-01-20 18:13:36 +00:00
easing-modes.png \
easing-modes.svg \
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
event-flow.png \
docs: Add images for layout managers It's easier to show the layout manager policy with a simple screen shot coming from our interactive tests.
2009-10-23 16:32:18 +00:00
flow-layout-horizontal.png \
flow-layout-vertical.png \
clutter-actor: Add an 'offscreen-redirect' property This adds a property which can be used to redirect the actor through an FBO before painting so that it becomes flattened in an image. The image can be used as a cache to avoid having to repaint the actor if something unrelated in the scene changes. It can also be used to implement correct opacity even if the actor has overlapping primitives. The property is an enum that takes three values: CLUTTER_OFFSCREEN_REDIRECT_NEVER: The default behaviour which is to never flatten the actor. CLUTTER_OFFSCREEN_REDIRECT_ALWAYS: The actor is always redirected through an FBO. CLUTTER_OFFSCREEN_REDIRECT_ONLY_FOR_OPACITY: The actor is only redirected through an FBO if the paint opacity is not 255. This value would be used if the actor wants correct opacity. It will avoid the overhead of using an FBO whenever the actor is fully opaque. The property is implemented by installing a ClutterFlattenEffect. ClutterFlattenEffect is a new internal class which subclasses ClutterOffscreen to redirect the painting to an FBO. When ClutterOffscreen paints, the effect sets an opacity override on the actor so that the image will always contain the actor at full opacity. The opacity is then applied to the resulting image before painting it to the stage. This means the actor does not need to be redrawn while the opacity is being animated. The effect has a high internal priority so that it will always occur before any other effects and it gets hidden from the application.
2011-02-28 15:05:51 +00:00
path-alpha-func.png \
offscreen-redirect.png
Copy permalink