2008-03-26 Neil Roberts <neil@o-hand.com>
+ * clutter/win32/clutter-win32.h: Added gtk-doc documentation for
+ the Win32 backend section.
+
+ * clutter/win32/clutter-stage-win32.c
+ (clutter_win32_get_stage_window): Fixed punctuation in the
+ documentation.
+
+ * README: Added notes about the Win32 backend.
+
+2008-03-26 Neil Roberts <neil@o-hand.com>
+
* clutter/win32/clutter-event-win32.c (clutter_event_check):
Removed the pointless parameter in the call to check_msg_pending.
(check_msg_pending): Fixed to use PeekMessageW instead of
* GdkPixbuf
* Pango >= 1.18
* OpenGL >= 1.2 or OpenGL ES 1.1
- * GLX, SDL or an EGL Implementation
+ * GLX, SDL, WGL or an EGL Implementation
The official website is:
http://www.clutter-project.org
Assume target hardware has no floating point unit. Useful only
for embedded targets such as ARM.
- --with-flavour=[glx/eglx/eglnative/sdl/osx]
+ --with-flavour=[glx/eglx/eglnative/sdl/osx/win32]
Select the Clutter backend: (default=glx)
glx: Fully featured GLX backend. Using Open GL.
osx: OS X backend. (experimental)
+ win32:
+ Windows WGL backend
+
VERSIONING
====
Release Notes for Clutter 0.8
-------------------------------
+* There is now an experimental native Win32 WGL backend.
+
* Some more focused timeline unit tests have been added and some tweaks to
timeline semantics were made; E.g. For a 10 frame timeline here are some
points about the semantics:
* clutter_win32_get_stage_window:
* @stage: a #ClutterStage
*
- * Gets the stages window handle
+ * Gets the stage's window handle
*
* Return value: An HWND for the stage window.
*
* Boston, MA 02111-1307, USA.
*/
+/**
+ * SECTION:clutter-win32
+ * @short_description: Win32 specific API
+ *
+ * The Win32 backend for Clutter provides some specific API, allowing
+ * integration with the Win32 API for embedding and manipulating the
+ * stage window.
+ *
+ * The ClutterWin32 API is available since Clutter 0.8
+ */
+
#ifndef __CLUTTER_WIN32_H__
#define __CLUTTER_WIN32_H__
+2008-03-26 Neil Roberts <neil@o-hand.com>
+
+ * clutter-sections.txt: Added a section for the Win32 specific
+ API.
+
+ * clutter-docs.sgml: Added comments about the Win32 backend.
+
+ * Makefile.am: Added bits to ignore the headers for the Win32
+ backend.
+
2008-03-18 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-section.txt: Update after API change in ClutterScore.
# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h
# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c
HFILE_GLOB=$(top_srcdir)/clutter/*.h \
- $(top_srcdir)/clutter/x11/clutter-x11.h
+ $(top_srcdir)/clutter/x11/clutter-x11.h \
+ $(top_srcdir)/clutter/win32/clutter-win32.h
CFILE_GLOB=$(top_srcdir)/clutter/*.c
# Header files to ignore when scanning.
x11 \
json \
pango \
- sdl
+ sdl \
+ win32
EXTRA_HFILES=\
- ../../clutter/x11/clutter-x11.h
+ ../../clutter/x11/clutter-x11.h \
+ ../../clutter/win32/clutter-win32.h
# Images to copy into HTML directory.
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
</listitem>
<term>Backend Windowing System Library</term>
<listitem>
- <para>GLX, EGL (1.1), SDL and Cocoa (OS X)</para>
+ <para>GLX, EGL (1.1), SDL, Cocoa (OS X) and WGL (Windows)</para>
</listitem>
<term>Graphics Rendering </term>
<listitem>
will need to first install the required dependencies.
</para>
<para>
- Clutter on Windows currently uses the SDL backend for windowing
+ There are currently two backends that are supported on
+ Windows. One uses the Win32 and WGL APIs directly and the
+ other is built on top of SDL. You must choose one of the
+ backends when running the configure script using the
+ following argument:
+ <variablelist>
+ <varlistentry>
+ <term>--with-flavour=[win32/sdl]</term>
+ <listitem>
+ <para>Select the Clutter backend; default=glx.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
</section>
<xi:include href="xml/clutter-backend.xml"/>
<xi:include href="xml/clutter-x11.xml"/>
-
+ <xi:include href="xml/clutter-win32.xml"/>
</part>
<part>
</SECTION>
<SECTION>
+<FILE>clutter-win32</FILE>
+<TITLE>Win32 Specific Support</TITLE>
+clutter_win32_get_stage_window
+</SECTION>
+
+<SECTION>
<FILE>clutter-version</FILE>
<TITLE>Versioning Macros</TITLE>
CLUTTER_MAJOR_VERSION