[openvrml-commit] openvrml/lib/gtkglext/docs/reference/gtkglext .cvsignore, NONE, 1.2.2.1 Makefile.

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/openvrml/openvrml/lib/gtkglext/docs/reference/gtkglext
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv7146/lib/gtkglext/docs/reference/gtkglext

Added Files:
      Tag: OpenVRML-0_16-BRANCH
	.cvsignore Makefile.am building.sgml gtkglext-docs.sgml 
	gtkglext-overrides.txt gtkglext-sections.txt gtkglext.types 
	running.sgml version.xml.in 
Log Message:
Build/package the GtkPlug application separately from the Mozilla plug-in.  The Mozilla plug-in is just one possible client for this application.

--- NEW FILE: .cvsignore ---
Makefile.in
gtkglext-decl.txt
gtkglext-decl-list.txt
gtkglext-undocumented.txt
gtkglext-unused.txt
gtkglext.args
gtkglext.hierarchy
gtkglext.interfaces
gtkglext.prerequisites
gtkglext.signals
html
html.stamp
sgml.stamp
tmpl.stamp
version.xml
xml

--- NEW FILE: gtkglext-docs.sgml ---
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [

<!ENTITY version SYSTEM "version.xml">

<!ENTITY gtkglext-gdkgldefs SYSTEM "xml/gdkgldefs.xml">
<!ENTITY gtkglext-gdkglversion SYSTEM "xml/gdkglversion.xml">
<!ENTITY gtkglext-gdkgltokens SYSTEM "xml/gdkgltokens.xml">
<!ENTITY gtkglext-gdkglinit SYSTEM "xml/gdkglinit.xml">
<!ENTITY gtkglext-gdkglquery SYSTEM "xml/gdkglquery.xml">
<!ENTITY gtkglext-gdkglconfig SYSTEM "xml/gdkglconfig.xml">
<!ENTITY gtkglext-gdkglcontext SYSTEM "xml/gdkglcontext.xml">
<!ENTITY gtkglext-gdkgldrawable SYSTEM "xml/gdkgldrawable.xml">
<!ENTITY gtkglext-gdkglpixmap SYSTEM "xml/gdkglpixmap.xml">
<!ENTITY gtkglext-gdkglwindow SYSTEM "xml/gdkglwindow.xml">
<!ENTITY gtkglext-gdkglfont SYSTEM "xml/gdkglfont.xml">
<!ENTITY gtkglext-gdkglshapes SYSTEM "xml/gdkglshapes.xml">
<!ENTITY gtkglext-gdkglx SYSTEM "xml/gdkglx.xml">

<!ENTITY gtkglext-gtkgldefs SYSTEM "xml/gtkgldefs.xml">
<!ENTITY gtkglext-gtkglversion SYSTEM "xml/gtkglversion.xml">
<!ENTITY gtkglext-gtkglinit SYSTEM "xml/gtkglinit.xml">
<!ENTITY gtkglext-gtkglwidget SYSTEM "xml/gtkglwidget.xml">

<!ENTITY gtkglext-Building SYSTEM "building.sgml">
<!ENTITY gtkglext-Running SYSTEM "running.sgml">

]>

<book id="index">
  <bookinfo>
    <title>GtkGLExt Reference Manual</title>
    <releaseinfo>for GtkGLExt &version;</releaseinfo>
  </bookinfo>

  <part id="Overview">
    <title>GtkGLExt Overview</title>
    &gtkglext-Building;
    &gtkglext-Running;
  </part>

  <part id="GdkGLExt-API">
    <title>GdkGLExt API Reference</title>
    &gtkglext-gdkglinit;
    &gtkglext-gdkglquery;
    &gtkglext-gdkglconfig;
    &gtkglext-gdkglcontext;
    &gtkglext-gdkgldrawable;
    &gtkglext-gdkglpixmap;
    &gtkglext-gdkglwindow;
    &gtkglext-gdkglfont;
    &gtkglext-gdkglshapes;
    &gtkglext-gdkgltokens;
    &gtkglext-gdkglx;
    &gtkglext-gdkglversion;
  </part>

  <part id="GtkGLExt-API">
    <title>GtkGLExt API Reference</title>
    &gtkglext-gtkglinit;
    &gtkglext-gtkglwidget;
    &gtkglext-gtkglversion;
  </part>

</book>

--- NEW FILE: running.sgml ---
<refentry id="gtkglext-running" revision="11 Dec 2002">
<refmeta>
<refentrytitle>Running GtkGLExt Applications</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GtkGLExt Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Running GtkGLExt Applications</refname>
<refpurpose>
How to run and debug your GtkGLExt application
</refpurpose>
</refnamediv>

<refsect1>
<title>Running and debugging GtkGLExt Applications</title>

<refsect2>
<title>Common command line options</title>

<para>
All GtkGLExt applications support the following command line
options. These are removed from <literal>argv</literal> by
<link linkend="gtk-gl-init">gtk_gl_init()</link>.
</para>

<formalpara>
<title><systemitem>--gtk-gl-install-colormap</systemitem></title>

<para>
Install OpenGL window's colormap to the top-level window.
If window manager doesn't watch the WM_COLORMAP_WINDOWS property on
the top-level window, we have to set OpenGL window's colormap to the
top-level window, especially in color index mode (color index mode
uses own private colormap).
</para>
</formalpara>

<formalpara>
<title><systemitem>--gtk-gl-debug <replaceable>options</replaceable></systemitem></title>

<para>
A list of <link linkend="GTK-GL-Debug-Options">debug options</link> 
to turn on in addition to those specified in the
<envar>GTK_GL_DEBUG</envar> environment variable. 
This option is only available if GtkGLExt has been configured with
<option>--enable-debug=yes</option>.
</para>
</formalpara>

<formalpara>
<title><systemitem>--gtk-gl-no-debug <replaceable>options</replaceable></systemitem></title>

<para>
A list of <link linkend="GTK-GL-Debug-Options">debug options</link> 
to turn off.
This option is only available if GtkGLExt has been configured with
<option>--enable-debug=yes</option>.
</para>
</formalpara>

<para>
The following options are really used by GdkGLExt library.
</para>

<formalpara>
<title><systemitem>--gdk-gl-no-standard-colormap</systemitem></title>

<para>
This option disables GdkGLExt library to find a standard RGB colormap
using XmuLookupStandardColormap(). If your application gets a BadColor
X Window System error, try this option.
On Solaris 2.4 and 2.5, they have a bug in XmuLookupStandardColormap()
implementation. If your application gets a BadMatch X Window System
error from XCreateWindow(), pass this option to avoid using broken
XmuLookupStandardColormap(). Sun fixed this bug in Solaris 2.6.
</para>
</formalpara>

<formalpara>
<title><systemitem>--gdk-gl-force-indirect</systemitem></title>

<para>
Users can force GdkGLExt library to use indirect rendering context.
If your application has a problem with hardware acceleration, try 
this option.
</para>
</formalpara>

<formalpara>
<title><systemitem>--gdk-gl-debug <replaceable>options</replaceable></systemitem></title>

<para>
A list of <link linkend="GDK-GL-Debug-Options">debug options</link> 
to turn on in addition to those 
specified in the <envar>GDK_GL_DEBUG</envar> environment variable. 
This option is only available if GtkGLExt has been configured with
<option>--enable-debug=yes</option>.
</para>
</formalpara>

<formalpara>
<title><systemitem>--gdk-gl-no-debug <replaceable>options</replaceable></systemitem></title>

<para>
A list of <link linkend="GDK-GL-Debug-Options">debug options</link> 
to turn off.
This option is only available if GtkGLExt has been configured with
<option>--enable-debug=yes</option>.
</para>
</formalpara>

</refsect2>

<refsect2>
<title>Environment variables</title>

<para> 
GtkGLExt inspects the following environment variables.
</para>

<formalpara>
  <title><envar>GTK_GL_INSTALL_COLORMAP</envar></title>

  <para>
    If this variable is set to 1, GtkGLExt will try to install
    colormap to the top-level window.
    If window manager doesn't watch the WM_COLORMAP_WINDOWS property on
    the top-level window, we have to set OpenGL window's colormap to the
    top-level window.
  </para>
</formalpara>

<formalpara id="GTK-GL-Debug-Options">
  <title><envar>GTK_GL_DEBUG</envar></title>

  <para>
  If GtkGLExt has been configured with <option>--enable-debug=yes</option>,
  this variable can be set to a list of debug options, which cause
  GtkGLExt library to print out different types of debugging
  information.
  <variablelist>
    <varlistentry>
      <term>misc</term>
      <listitem><para>Miscellaneous information</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>func</term>
      <listitem><para>Show function call information</para></listitem>
    </varlistentry>
  </variablelist>
  The special value <literal>all</literal> can be used to turn on all debug options.
  </para>
</formalpara>

<formalpara>
  <title><envar>GDK_GL_NO_STANDARD_COLORMAP</envar></title>

  <para>
    If this variable is set to 1, GdkGLExt library doesn't try to
    find a standard RGB colormap using XmuLookupStandardColormap().
    If your application gets a BadColor X Window System error,
    try to set this environment variable.
    On Solaris 2.4 and 2.5, they have a bug in XmuLookupStandardColormap()
    implementation. If your application gets a BadMatch X Window
    System error from XCreateWindow(), set this environment variable
    to avoid using broken XmuLookupStandardColormap(). Sun fixed this
    bug in Solaris 2.6.
  </para>
</formalpara>

<formalpara>
  <title><envar>GDK_GL_FORCE_INDIRECT</envar></title>

  <para>
    If this variable is set to 1, GdkGLExt library uses indirect
    rendering context. If your application has a problem with
    hardware acceleration, try to set this environment variable.
  </para>
</formalpara>

<formalpara id="GDK-GL-Debug-Options">
  <title><envar>GDK_GL_DEBUG</envar></title>

  <para>
  If GtkGLExt has been configured with <option>--enable-debug=yes</option>,
  this variable can be set to a list of debug options, which cause
  GdkGLExt library to print out different types of debugging
  information.
  <variablelist>
    <varlistentry>
      <term>misc</term>
      <listitem><para>Miscellaneous information</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>func</term>
      <listitem><para>Show function call information</para></listitem>
    </varlistentry>
    <varlistentry>
      <term>impl</term>
      <listitem><para>Show window system specific (GLX, WGL) function call information</para></listitem>
    </varlistentry>
  </variablelist>
  The special value <literal>all</literal> can be used to turn on all debug options.
  </para>
</formalpara>

</refsect2>

</refsect1>

</refentry>

--- NEW FILE: building.sgml ---
<refentry id="gtkglext-building" revision="11 Dec 2001">
<refmeta>
<refentrytitle>Compiling the GtkGLExt libraries</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GtkGLExt Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Compiling the GtkGLExt Libraries</refname>
<refpurpose>
How to compile GtkGLExt
</refpurpose>
</refnamediv>
  <refsect1 id="overview">
    <title>Building GtkGLExt on UNIX-like systems</title>
    <para>
      This chapter covers building and installing GtkGLExt on UNIX and
      UNIX-like systems such as Linux. Compiling GtkGLExt on Microsoft
      Windows is different in detail and somewhat more difficult to
      get going since the necessary tools aren't included with
      the operating system.
    </para>
    <para>
      On UNIX-like systems GtkGLExt uses the standard GNU build system,
      using <application>autoconf</application> for package
      configuration and resolving portability issues,
      <application>automake</application> for building makefiles that
      comply with the GNU Coding Standards, and
      <application>libtool</application> for building shared libraries
      on multiple platforms.
    </para>
    <para>
      If you are building GtkGLExt from the distributed source packages,
      then won't need these tools installed; the necessary pieces
      of the tools are already included in the source packages. But
      it's useful to know a bit about how packages that use these
      tools work. A source package is distributed as 
      <literal>tar.gz</literal> or <literal>tar.bz2</literal> file
      which you unpack into a directory full of the source files as follows:
    </para>
    <programlisting>
      tar zxvf gtkglext-x.y.z.tar.gz

      tar jxvf gtkglext-x.y.z.tar.bz2
    </programlisting>
    <para>
      In the toplevel of the directory that is created, there will be
      a shell script called <filename>configure</filename> which
      you then run to take the template makefiles called
      <filename>Makefile.in</filename> in the package and create
      makefiles customized for your operating system. The <filename>configure</filename>
      script can be passed various command line arguments to determine how
      the package is built and installed. The most commonly useful
      argument is the <systemitem>--prefix</systemitem> argument which
      determines where the package is installed. To install a package
      in <filename>/opt/gtk</filename> you would run configure as:
    </para>
    <programlisting>
      ./configure --prefix=/opt/gtk
    </programlisting>
    <para>
      A full list of options can be found by running
      <filename>configure</filename> with the
      <systemitem>--help</systemitem> argument. In general, the defaults are
      right and should be trusted. After you've run
      <filename>configure</filename>, you then run the
      <command>make</command> command to build the package and install
      it.
    </para>
    <programlisting>
      make
      make install
    </programlisting>
    <para>
      If you don't have permission to write to the directory you are
      installing in, you may have to change to root temporarily before
      running <literal>make install</literal>. Also, if you are
      installing in a system directory, on some systems (such as
      Linux), you will need to run <command>ldconfig</command> after
      <literal>make install</literal> so that the newly installed
      libraries will be found.
    </para>
    <para>
      If you want to compile example programs shipped with the source
      package, run the following command.
    </para>
    <programlisting>
      make examples
    </programlisting>
    <para>
      Several environment variables are useful to pass to set before
      running configure. <envar>CPPFLAGS</envar> contains options to
      pass to the C compiler, and is used to tell the compiler where
      to look for include files. The <envar>LDFLAGS</envar> variable
      is used in a similar fashion for the linker. Finally the
      <envar>PKG_CONFIG_PATH</envar> environment variable contains
      a search path that <command>pkg-config</command> (see below)
      uses when looking for for file describing how to compile
      programs using different libraries. If you were installing GTK+
      and it's dependencies into <filename>/opt/gtk</filename>,
      you might want to set these variables as:
    </para>
    <programlisting>
      CPPFLAGS="-I/opt/gtk/include"
      LDFLAGS="-L/opt/gtk/lib"
      PKG_CONFIG_PATH="/opt/gtk/lib/pkgconfig"
      export CPPFLAGS LDFLAGS PKG_CONFIG_PATH
    </programlisting>
    <para>
      You may also need to set the <envar>LD_LIBRARY_PATH</envar>
      environment variable so the systems dynamic linker can find
      the newly installed libraries, and the <envar>PATH</envar>
      environment program so that utility binaries installed by
      the various libraries will be found.
    </para>
    <programlisting>
      LD_LIBRARY_PATH="/opt/gtk/lib"
      PATH="/opt/gtk/bin:$PATH"
      export LD_LIBRARY_PATH PATH
    </programlisting>
  </refsect1>
  <refsect1 id="dependencies">
    <title>Dependencies</title>
    <para>
      Before you can compile the GtkGLExt library, you need to have
      various other tools and libraries installed on your
      system. The two tools needed during the build process (as
      differentiated from the tools used in when creating GTK+
      mentioned above such as <application>autoconf</application>)
      are <command>pkg-config</command> and GNU make.
    </para>
    <itemizedlist>
      <listitem>
	<para>
	  <ulink
	  url="http://www.freedesktop.org/software/pkgconfig/">pkg-config</ulink>
	  is a tool for tracking the compilation flags needed for
	  libraries that is used by the GTK+ libraries. (For each
	  library, a small <literal>.pc</literal> text file is
	  installed in a standard location that contains the
	  compilation flags needed for that library along with version
	  number information.)
	</para>
      </listitem>
      <listitem>
	<para>
	  The GtkGLExt makefiles will mostly work with different versions
	  of <command>make</command>, however, there tends to be
	  a few incompatibilities, so we recommend installing
          <ulink url="http://www.gnu.org/software/make">GNU make</ulink>
          if you don't already have it on your system
	  and using it. (It may be called <command>gmake</command>
	  rather than <command>make</command>.)
	</para>
      </listitem>
      <listitem>
	<para>
	  <ulink url="http://www.gtk.org/">GTK+</ulink>
          -- The GIMP Toolkit -- version 2.0 or above.
	</para>
      </listitem>
      <listitem>
	<para>
          OpenGL or <ulink url="http://www.mesa3d.org/">Mesa</ulink>.
	</para>
      </listitem>
    </itemizedlist>
  </refsect1>
  <refsect1 id="extra-configuration-options">
    <title>Extra Configuration Options</title>

      <para>
        In addition to the normal options, the
	<command>configure</command> script for the GtkGLExt
	supports the following additional arguments.

	<cmdsynopsis>
	  <command>configure</command>

	  <group>
	    <arg>--with-gl-prefix=DIR</arg>
	  </group>
	  <group>
	    <arg>--with-gl-includedir=DIR</arg>
	  </group>
	  <group>
	    <arg>--with-gl-libdir=DIR</arg>
	  </group>
	  <group>
	    <arg>--enable-debug=[no|minimum|yes]</arg>
	  </group>
	  <group>
	    <arg>--disable-gtk-doc</arg>
	    <arg>--enable-gtk-doc</arg>
	  </group>
	  <group>
	    <arg>--with-html-dir=PATH</arg>
	  </group>
	  <group>
	    <arg>--with-gdktarget=[x11|win32]</arg>
	  </group>
	</cmdsynopsis>
      </para>

      <formalpara>
        <title><systemitem>--with-gl-prefix=DIR</systemitem></title>

        <para>
	  Directory where OpenGL (Mesa) is installed.
	  The default is 'auto'.
        </para>
      </formalpara>

      <formalpara>
        <title><systemitem>--with-gl-includedir=DIR</systemitem></title>

        <para>
	  Directory where OpenGL (Mesa) header files are installed.
	  The default is 'auto'.
        </para>
      </formalpara>

      <formalpara>
        <title><systemitem>--with-gl-libdir=DIR</systemitem></title>

        <para>
	  Directory where OpenGL (Mesa) libraries are installed.
	  The default is 'auto'.
        </para>
      </formalpara>

      <formalpara>
        <title><systemitem>--enable-debug</systemitem></title>

        <para>
         Turns on various amounts of debugging support. Setting this to 'no' 
	 disables g_assert(), g_return_if_fail(), g_return_val_if_fail() and
         all cast checks between different object types. Setting it to 'minimum'
         disables only cast checks. Setting it to 'yes' enables 
         <link linkend="GTK-GL-Debug-Options">runtime debugging</link>. 
         The default is 'minimum'.
         Note that 'no' is fast, but dangerous as it tends to destabilize 
         even mostly bug-free software by changing the effect of many bugs 
         from simple warnings into fatal crashes. Thus 
         <option>--enable-debug=no</option> should <emphasis>not</emphasis> 
         be used for stable releases of GtkGLExt.
        </para>
      </formalpara>

      <formalpara>
	<title><systemitem>--disable-gtk-doc</systemitem> and
	  <systemitem>--enable-gtk-doc</systemitem></title>

	<para>
	  The <application>gtk-doc</application> package is
	  used to generate the reference documentation included
	  with GtkGLExt. By default support for
	  <application>gtk-doc</application> 
	  is disabled because it requires various extra dependencies
	  to be installed. If you have
	  <application>gtk-doc</application> installed and
	  are modifying GtkGLExt, you may want to enable
	  <application>gtk-doc</application> support by passing
	  in <systemitem>--enable-gtk-doc</systemitem>. If not
	  enabled, pre-generated HTML files distributed with GtkGLExt
	  will be installed.
	</para>
      </formalpara>

      <formalpara>
        <title><systemitem>--with-html-dir</systemitem></title>

        <para>
         Path to installed the reference documentation. The default is
         <filename>${datadir}/gtk-doc/html</filename>.
        </para>
      </formalpara>

      <formalpara>
	<title><systemitem>--with-gdktarget</systemitem></title>

	<para>
          Toggles between the supported backends for GdkGLExt. 
          The default is x11, unless the platform is Windows, in which
	  case the default is win32.
	</para>
      </formalpara>

    </refsect1>

</refentry>

<!-- Local Variables: -->
<!-- sgml-parent-document: ("gtk-docs.sgml" "chapter" "refentry")  -->
<!-- End: -->

--- NEW FILE: gtkglext-sections.txt ---

<INCLUDE>gdk/gdkgl.h</INCLUDE>

<SECTION>
<FILE>gdkgl</FILE>
</SECTION>

<SECTION>
<FILE>gdkgldefs</FILE>
GDK_GL_VAR
</SECTION>

<SECTION>
<FILE>gdkglversion</FILE>
GDKGLEXT_MAJOR_VERSION
GDKGLEXT_MINOR_VERSION
GDKGLEXT_MICRO_VERSION
GDKGLEXT_INTERFACE_AGE
GDKGLEXT_BINARY_AGE
GDKGLEXT_CHECK_VERSION
gdkglext_major_version
gdkglext_minor_version
gdkglext_micro_version
gdkglext_interface_age
gdkglext_binary_age
</SECTION>

<SECTION>
<FILE>gdkglinit</FILE>
gdk_gl_init
gdk_gl_init_check
gdk_gl_parse_args
</SECTION>

<SECTION>
<FILE>gdkglquery</FILE>
GdkGLProc
gdk_gl_query_extension
gdk_gl_query_extension_for_display
gdk_gl_query_version
gdk_gl_query_version_for_display
gdk_gl_query_gl_extension
gdk_gl_get_proc_address
</SECTION>

<SECTION>
<FILE>gdkglconfig</FILE>
GdkGLConfigMode
GdkGLConfig
gdk_gl_config_new
gdk_gl_config_new_for_screen
gdk_gl_config_new_by_mode
gdk_gl_config_new_by_mode_for_screen
gdk_gl_config_get_screen
gdk_gl_config_get_attrib
gdk_gl_config_get_colormap
gdk_gl_config_get_visual
gdk_gl_config_get_depth
gdk_gl_config_get_layer_plane
gdk_gl_config_get_n_aux_buffers
gdk_gl_config_get_n_sample_buffers
gdk_gl_config_is_rgba
gdk_gl_config_is_double_buffered
gdk_gl_config_is_stereo
gdk_gl_config_has_alpha
gdk_gl_config_has_depth_buffer
gdk_gl_config_has_stencil_buffer
gdk_gl_config_has_accum_buffer

<SUBSECTION Standard>
GDK_TYPE_GL_CONFIG_MODE
GdkGLConfigClass
GDK_GL_CONFIG
GDK_IS_GL_CONFIG
GDK_TYPE_GL_CONFIG
GDK_GL_CONFIG_CLASS
GDK_IS_GL_CONFIG_CLASS
GDK_GL_CONFIG_GET_CLASS

<SUBSECTION Private>
gdk_gl_config_mode_get_type
gdk_gl_config_get_type
</SECTION>

<SECTION>
<FILE>gdkglcontext</FILE>
GdkGLContext
gdk_gl_context_new
gdk_gl_context_destroy
gdk_gl_context_copy
gdk_gl_context_get_gl_drawable
gdk_gl_context_get_gl_config
gdk_gl_context_get_share_list
gdk_gl_context_is_direct
gdk_gl_context_get_render_type
gdk_gl_context_get_current

<SUBSECTION Standard>
GdkGLContextClass
GDK_GL_CONTEXT
GDK_IS_GL_CONTEXT
GDK_TYPE_GL_CONTEXT
GDK_GL_CONTEXT_CLASS
GDK_IS_GL_CONTEXT_CLASS
GDK_GL_CONTEXT_GET_CLASS

<SUBSECTION Private>
gdk_gl_context_get_type
</SECTION>

<SECTION>
<FILE>gdkgldrawable</FILE>
GdkGLDrawable
gdk_gl_drawable_make_current
gdk_gl_drawable_is_double_buffered
gdk_gl_drawable_swap_buffers
gdk_gl_drawable_wait_gl
gdk_gl_drawable_wait_gdk
gdk_gl_drawable_gl_begin
gdk_gl_drawable_gl_end
gdk_gl_drawable_get_gl_config
gdk_gl_drawable_get_size
gdk_gl_drawable_get_current

<SUBSECTION Standard>
GdkGLDrawableClass
GDK_GL_DRAWABLE
GDK_IS_GL_DRAWABLE
GDK_TYPE_GL_DRAWABLE
GDK_GL_DRAWABLE_CLASS
GDK_IS_GL_DRAWABLE_CLASS
GDK_GL_DRAWABLE_GET_CLASS

<SUBSECTION Private>
gdk_gl_drawable_get_type
</SECTION>

<SECTION>
<FILE>gdkglpixmap</FILE>
GdkGLPixmap
gdk_gl_pixmap_new
gdk_gl_pixmap_destroy
gdk_gl_pixmap_get_pixmap
gdk_pixmap_set_gl_capability
gdk_pixmap_unset_gl_capability
gdk_pixmap_is_gl_capable
gdk_pixmap_get_gl_pixmap
gdk_pixmap_get_gl_drawable

<SUBSECTION Standard>
GdkGLPixmapClass
GDK_GL_PIXMAP
GDK_IS_GL_PIXMAP
GDK_TYPE_GL_PIXMAP
GDK_GL_PIXMAP_CLASS
GDK_IS_GL_PIXMAP_CLASS
GDK_GL_PIXMAP_GET_CLASS

<SUBSECTION Private>
gdk_gl_pixmap_get_type
</SECTION>

<SECTION>
<FILE>gdkglwindow</FILE>
GdkGLWindow
gdk_gl_window_new
gdk_gl_window_destroy
gdk_gl_window_get_window
gdk_window_set_gl_capability
gdk_window_unset_gl_capability
gdk_window_is_gl_capable
gdk_window_get_gl_window
gdk_window_get_gl_drawable

<SUBSECTION Standard>
GdkGLWindowClass
GDK_GL_WINDOW
GDK_IS_GL_WINDOW
GDK_TYPE_GL_WINDOW
GDK_GL_WINDOW_CLASS
GDK_IS_GL_WINDOW_CLASS
GDK_GL_WINDOW_GET_CLASS

<SUBSECTION Private>
gdk_gl_window_get_type
</SECTION>

<SECTION>
<FILE>gdkglfont</FILE>
gdk_gl_font_use_pango_font
gdk_gl_font_use_pango_font_for_display
</SECTION>

<SECTION>
<FILE>gdkglshapes</FILE>
gdk_gl_draw_cube
gdk_gl_draw_sphere
gdk_gl_draw_cone
gdk_gl_draw_torus
gdk_gl_draw_tetrahedron
gdk_gl_draw_octahedron
gdk_gl_draw_dodecahedron
gdk_gl_draw_icosahedron
gdk_gl_draw_teapot
</SECTION>

<SECTION>
<FILE>gdkgltokens</FILE>
GDK_GL_SUCCESS
GDK_GL_ATTRIB_LIST_NONE
GdkGLConfigAttrib
GDK_GL_DONT_CARE
GDK_GL_NONE
GdkGLConfigCaveat
GdkGLVisualType
GdkGLTransparentType
GdkGLDrawableTypeMask
GdkGLRenderTypeMask
GdkGLBufferMask
GdkGLConfigError
GdkGLRenderType
GdkGLDrawableAttrib
GdkGLPbufferAttrib
GdkGLEventMask
GdkGLEventType
GdkGLDrawableType

<SUBSECTION Standard>
GDK_TYPE_GL_CONFIG_ATTRIB
GDK_TYPE_GL_CONFIG_CAVEAT
GDK_TYPE_GL_VISUAL_TYPE
GDK_TYPE_GL_TRANSPARENT_TYPE
GDK_TYPE_GL_DRAWABLE_TYPE_MASK
GDK_TYPE_GL_RENDER_TYPE_MASK
GDK_TYPE_GL_BUFFER_MASK
GDK_TYPE_GL_CONFIG_ERROR
GDK_TYPE_GL_RENDER_TYPE
GDK_TYPE_GL_DRAWABLE_ATTRIB
GDK_TYPE_GL_PBUFFER_ATTRIB
GDK_TYPE_GL_EVENT_MASK
GDK_TYPE_GL_EVENT_TYPE
GDK_TYPE_GL_DRAWABLE_TYPE

<SUBSECTION Private>
gdk_gl_config_attrib_get_type
gdk_gl_config_caveat_get_type
gdk_gl_visual_type_get_type
gdk_gl_transparent_type_get_type
gdk_gl_drawable_type_mask_get_type
gdk_gl_render_type_mask_get_type
gdk_gl_buffer_mask_get_type
gdk_gl_config_error_get_type
gdk_gl_render_type_get_type
gdk_gl_drawable_attrib_get_type
gdk_gl_pbuffer_attrib_get_type
gdk_gl_event_mask_get_type
gdk_gl_event_type_get_type
gdk_gl_drawable_type_get_type
</SECTION>

<INCLUDE>gdk/x11/gdkglx.h</INCLUDE>

<SECTION>
<FILE>gdkglx</FILE>
gdk_x11_gl_query_glx_extension
gdk_x11_gl_config_new_from_visualid
gdk_x11_gl_config_new_from_visualid_for_screen
gdk_x11_gl_config_get_xdisplay
gdk_x11_gl_config_get_screen_number
gdk_x11_gl_config_get_xvinfo
gdk_x11_gl_config_is_mesa_glx
gdk_x11_gl_context_foreign_new
gdk_x11_gl_context_get_glxcontext
gdk_x11_gl_pixmap_get_glxpixmap
gdk_x11_gl_window_get_glxwindow
GDK_GL_CONFIG_XDISPLAY
GDK_GL_CONFIG_SCREEN_XNUMBER
GDK_GL_CONFIG_XVINFO
GDK_GL_CONFIG_XCOLORMAP
GDK_GL_CONTEXT_GLXCONTEXT
GDK_GL_PIXMAP_GLXPIXMAP
GDK_GL_WINDOW_GLXWINDOW
</SECTION>

<INCLUDE>gtk/gtkgl.h</INCLUDE>

<SECTION>
<FILE>gtkgl</FILE>
</SECTION>

<SECTION>
<FILE>gtkgldefs</FILE>
GTK_GL_VAR
</SECTION>

<SECTION>
<FILE>gtkglversion</FILE>
GTKGLEXT_MAJOR_VERSION
GTKGLEXT_MINOR_VERSION
GTKGLEXT_MICRO_VERSION
GTKGLEXT_INTERFACE_AGE
GTKGLEXT_BINARY_AGE
GTKGLEXT_CHECK_VERSION
gtkglext_major_version
gtkglext_minor_version
gtkglext_micro_version
gtkglext_interface_age
gtkglext_binary_age
</SECTION>

<SECTION>
<FILE>gtkglinit</FILE>
gtk_gl_init
gtk_gl_init_check
gtk_gl_parse_args
</SECTION>

<SECTION>
<FILE>gtkglwidget</FILE>
gtk_widget_set_gl_capability
gtk_widget_is_gl_capable
gtk_widget_get_gl_config
gtk_widget_create_gl_context
gtk_widget_get_gl_context
gtk_widget_get_gl_window
gtk_widget_get_gl_drawable
</SECTION>

--- NEW FILE: version.xml.in ---
@GTKGLEXT_VERSION@

--- NEW FILE: Makefile.am ---
## -*- Makefile -*-
## Makefile.am for gtkglext/docs/reference/gtkglext

GTKDOC_CFLAGS = \
	-I$(top_srcdir)			\
	-I$(top_srcdir)/gdk		\
	-I$(top_srcdir)/gtk		\
	-I$(top_builddir)		\
	-I$(top_builddir)/gdk		\
	-I$(top_builddir)/gtk		\
	$(GTKGLEXT_DEBUG_FLAGS)		\
	$(GTKGLEXT_DEP_CFLAGS)

GTKDOC_LIBS = \
	$(top_builddir)/gdk/$(gdkglext_targetlib)	\
	$(top_builddir)/gtk/$(gtkglext_targetlib)

# The name of the module, e.g. 'glib'.
DOC_MODULE = gtkglext

# The top-level SGML file. Change it if you want.
DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml

# The directory containing the source code. Relative to $(srcdir).
# gtk-doc will search all .c & .h files beneath here for inline comments
# documenting functions and macros.
DOC_SOURCE_DIR = ../../..

# Extra options to pass to gtkdoc-scanobj or gtkdoc-scangobj.
SCANOBJ_OPTIONS =

# Extra options to supply to gtkdoc-scan.
SCAN_OPTIONS =

# Extra options to supply to gtkdoc-mkdb.
MKDB_OPTIONS = --sgml-mode --output-format=xml

# Extra options to supply to gtkdoc-fixref.
FIXXREF_OPTIONS =

# Used for dependencies.
HFILE_GLOB = $(top_srcdir)/gdk/*.h $(top_srcdir)/gdk/x11/gdkglx.h $(top_srcdir)/gtk/*.h
CFILE_GLOB = $(top_srcdir)/gdk/*.c $(top_srcdir)/gdk/x11/*.c $(top_srcdir)/gtk/*.c

# Header files to ignore when scanning.
IGNORE_HFILES = \
	config.h		\
	docs			\
	examples		\
	glext			\
	x11			\
	win32			\
	gdkglext-config.h	\
	gdkglprivate.h		\
	gdkgldebug.h		\
	gdkglglext.h		\
	gtkglprivate.h		\
	gtkgldebug.h

# Extra files to add when scanning (relative to $srcdir)
EXTRA_HFILES = \
	../../../gdk/x11/gdkglx.h

# Images to copy into HTML directory.
HTML_IMAGES =

# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
content_files = \
	$(top_srcdir)/docs/reference/gtkglext/version.xml	\
	building.sgml	\
	running.sgml

# Other files to distribute.
extra_files = \
	version.xml.in

$(top_srcdir)/docs/reference/gtkglext/version.xml:
	cp $(top_builddir)/docs/reference/gtkglext/version.xml $@

include $(top_srcdir)/gtk-doc.make

--- NEW FILE: gtkglext.types ---
#include <gdk/gdkgl.h>

gdk_gl_config_get_type
gdk_gl_context_get_type
gdk_gl_drawable_get_type
gdk_gl_pixmap_get_type
gdk_gl_window_get_type

--- NEW FILE: gtkglext-overrides.txt ---