Menu
▾
▴
[Plplot-cvs] SF.net SVN: plplot:[11205] trunk
|
From: <ai...@us...> - 2010-09-23 18:47:07
|
Revision: 11205
http://plplot.svn.sourceforge.net/plplot/?rev=11205&view=rev
Author: airwin
Date: 2010-09-23 18:47:00 +0000 (Thu, 23 Sep 2010)
Log Message:
-----------
Remove all references to the retired gnome and gnome2 bindings and the
retired gcw device and associated plplotcanvas applications from the
documentation.
Modified Paths:
--------------
trunk/doc/docbook/src/advanced.xml
trunk/doc/docbook/src/drivers.xml
trunk/doc/docbook/src/gui.xml
trunk/doc/docbook/src/libraries.xml
trunk/examples/c/README.plplotcanvas
Modified: trunk/doc/docbook/src/advanced.xml
===================================================================
--- trunk/doc/docbook/src/advanced.xml 2010-09-23 17:30:18 UTC (rev 11204)
+++ trunk/doc/docbook/src/advanced.xml 2010-09-23 18:47:00 UTC (rev 11205)
@@ -175,8 +175,6 @@
<row><entry>Conex vt320/tek emulator</entry><entry>conex</entry><entry>tek.c</entry></row>
<row><entry>DG300 Terminal</entry><entry>dg300</entry><entry>dg300.c</entry></row>
<row><entry>NeXT display (unsupported)</entry><entry>nx</entry><entry>next.c</entry></row>
- <row><entry>GNOME display</entry><entry>gnome</entry><entry>gnome.c</entry></row>
- <row><entry>GNOME Canvas Widget / Display</entry><entry>gcw</entry><entry>gcw.c</entry></row>
</tbody>
</tgroup>
</table>
@@ -1696,7 +1694,7 @@
western-European languages) and much better display of characters on
computer screens using anti-aliasing and hinting. Unicode fonts are
obtained by specifying a command-line option of -drvopt text for
- the devices (currently ps, psc, png, jpeg, gif, gcw, and wingcc)
+ the devices (currently ps, psc, png, jpeg, gif, and wingcc)
where it has been implemented.
</para>
<para>
Modified: trunk/doc/docbook/src/drivers.xml
===================================================================
--- trunk/doc/docbook/src/drivers.xml 2010-09-23 17:30:18 UTC (rev 11204)
+++ trunk/doc/docbook/src/drivers.xml 2010-09-23 18:47:00 UTC (rev 11205)
@@ -90,216 +90,7 @@
</para>
</sect1>
-
<!-- ================================================================== -->
- <!-- GCW -->
-
- <sect1 id="gcw-driver">
- <title>The GCW Driver (Gnome 2)</title>
-
- <para>
- The GCW driver draws plots into a tabbed Gnome window. The driver's
- features and user interface are described in
- <xref linkend="gcw-driver-basics" />. A specialized API allows
- interaction with the driver, and this is described in
- <xref linkend="gcw-driver-api" />.
- </para>
-
- <!-- GCW Driver Basics -->
-
- <sect2 id="gcw-driver-basics">
- <title>GCW Driver Basics</title>
-
- <para>
- The GCW driver plots each page into an individual tab within
- a Gnome window. The user interface built into the window allows
- a variety of actions. In particular, pages can be saved to files
- with extensions .ps, .psc, .png, .jpg, and .gif, which correspond
- to PLplot output driver devices described in
- <xref linkend="output-drivers" />.
- </para>
-
- <para>
- The GCW driver supports anti-aliasing and is unicode enabled.
- </para>
-
- <para>
- There are a variety of hot keys that may be used in the user interface:
- <itemizedlist>
- <listitem><para>Arrows : Change page</para></listitem>
- <listitem><para>+ : Zooms in</para></listitem>
- <listitem><para>- : Zooms out</para></listitem>
- <listitem><para>= : Zooms to 100%</para></listitem>
- <listitem><para>q : Quits</para></listitem>
- </itemizedlist>
- </para>
-
- <para>
- The available driver options (used with the
- <parameter>-drvopt</parameter> command-line argument) are:
- <itemizedlist>
- <listitem><para>
- text: Use TrueType fonts (0|1); default 1
- </para></listitem>
- <listitem><para>
- pixmap: Use pixmap for plotting lines and shades (0|1);
- default 1
- </para></listitem>
- <listitem><para>
- hrshsym: Use Hershey symbol set (0|1); default 0
- </para></listitem>
- </itemizedlist>
- </para>
-
- <para>
- The <parameter>text</parameter> option toggles between TrueType and
- Hershey fonts. The Hershey fonts provide a reference implementation
- for text representation in PLplot.
- </para>
-
- <para>
- The <parameter>hrshsym</parameter> option is used to indicate that
- symbols should be drawn using the Hershey fonts. This is
- useful when plots need to be saved to PostScript files, because
- the Type I fonts used by the PS and PSC devices do not support all
- Unicode symbols.
- </para>
-
- <para>
- Most of the command-line arguments described in
- <xref linkend="arguments" /> are also supported. Some key arguments
- for use with the GCW driver are:
- <itemizedlist>
- <listitem><para>
- geometry geom: Sets page size, in pixels (e.g. -geometry 400x300)
- </para></listitem>
- <listitem><para>
- nopixmap: Disables pixmap usage for plotting lines and shades
- </para></listitem>
- <listitem><para>
- portrait: Sets portrait mode (both orientation and aspect ratio)
- </para></listitem>
- </itemizedlist>
- </para>
-
- <para>
- The <parameter>nopixmap</parameter> option disables the use of
- the internal pixmap for drawing lines and shades, which will
- normally appear somewhat pixelated. The
- <parameter>nopixmap</parameter> option directs the driver to use
- anti-aliased vector graphics instead, resulting in higher quality
- plots but rendered at a slower speed. This option does not affect
- the quality of plots saved from the GCW user interface. Note that
- the TrueType fonts are always anti-aliased.
- </para>
-
- </sect2>
-
-
- <!-- GCW Driver API -->
-
- <sect2 id="gcw-driver-api">
- <title>GCW Driver API</title>
-
- <para>
- The GCW driver provides an additional API that allows for a higher
- degree of control by the user. The C API is described below, and
- bindings to other languages are described in
- *** NEEDS DOCUMENTATION ***.
- </para>
-
- <para>
- The function prototypes are defined in <filename>gcw.h</filename>.
- Programs that need access to this API must be linked against the
- libplplotgnome2d library rather than libplplotd. This is most easily
- accomplished using pkg-config; i.e.,
-
- <programlisting>
- gcc x01c.c -o x01c `pkg-config --cflags --libs plplotd-gnome2`
- </programlisting>
-
- You may need to remind pkg-config where to look for the
- plplotd-gnome2 file installed by PLplot; e.g.,
-
- <programlisting>
- gcc x01c.c -o x01c `PKG_CONFIG_PATH=/usr/local/lib/pkgconfig pkg-config --cflags --libs plplotd-gnome2`
- </programlisting>
- </para>
-
-
- <!-- gcw_use_text -->
-
- <sect3 id="gcw_use_text">
- <title><function>gcw_use_text</function>: Sets font usage.</title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>void gcw_use_text</function></funcdef>
- <paramdef><parameter>use_text</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Sets whether TrueType text or Hershey fonts are used.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>use_text</parameter> (<literal>PLINT</literal>, input)
- </term>
- <listitem><para>
- 1 for TrueType fonts (default), 0 for Hershey fonts.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- gcw_use_pixmap -->
-
- <sect3 id="gcw_use_pixmap">
- <title><function>gcw_use_pixmap</function>Sets pixmap usage.</title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>void gcw_use_pixmap</function></funcdef>
- <paramdef><parameter>use_pixmap</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Sets whether lines and shades are drawn to a pixmap,
- or instead as vector graphics.
- </para>
-
- <para>
- Lines and shade drawn to the pixmap may appear pixelated.
- Vector graphics are fully anti-aliased, but are rendered at a
- slower speed.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>use_pixmap</parameter>
- (<literal>PLINT</literal>, input)
- </term>
- <listitem><para>
- 1 to use pixmap (default), 0 for vector graphics instead.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
- </sect2>
- </sect1>
-
-
-
- <!-- ================================================================== -->
<!-- TK -->
@@ -349,7 +140,7 @@
<para>
The wxWidgets driver plots in a Frame provided by the wxWidgets
library. The driver is quite complete but lacks many of the GUI
- features of the TK or GCW drivers. All plots are available at once
+ features of the TK driver. All plots are available at once
an one can switch between all plots by pressing Alt-n. The
application can be quit with Alt-x. These functions are also
available in the menu. After the last plot one will advance again
Modified: trunk/doc/docbook/src/gui.xml
===================================================================
--- trunk/doc/docbook/src/gui.xml 2010-09-23 17:30:18 UTC (rev 11204)
+++ trunk/doc/docbook/src/gui.xml 2010-09-23 18:47:00 UTC (rev 11205)
@@ -36,594 +36,11 @@
<title>Embedding Plots in Graphical User Interfaces</title>
<para>
- This chapter describes how to embed plots in graphical user interfaces.
+ This chapter should describe how to embed plots in graphical user
+ interfaces. <xref linkend="extended-wish" /> does that for Tk, but
+ embedding plots in GTK+ and Qt GUI's NEEDS DOCUMENTATION. Until
+ that GTK+ and QT4 documentation is prepared, look at
+ examples/c/README.cairo and examples/c++/README.qt_example for
+ some proof-of-concept examples.
</para>
-
-
- <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
- <!-- PLPLOTCANVAS -->
-
- <sect1 id="plplotcanvas">
- <title>The PlplotCanvas Widget for Gnome/GTK Applications</title>
-
- <para>
- Plots can be embedded into Gnome/GTK applications by using the
- PlplotCanvas widget. Information on the GTK toolkit is provided
- at http://www.gtk.org/. PlplotCanvas is a subclass of the GnomeCanvas
- (see http://developer.gnome.org/doc/API/2.0/libgnomecanvas/index.html),
- and so includes all of its functionality. The specialized C API for
- PlplotCanvas is described in
- <xref linkend="plplotcanvas-api" />, and bindings to other languages
- are described in *** NEEDS DOCUMENTATION ***.
- </para>
-
-
- <!-- PlplotCanvas Basics -->
-
- <sect2 id="plplotcanvas-basics">
- <title>PlplotCanvas Basics</title>
-
- <para>
- The method declarations and data structures are defined in
- <filename>plplotcanvas.h</filename>. Programs using the PlplotCanvas
- widget must be linked against the
- <filename>libplplotgnome2d</filename> library
- rather than <filename>libplplotd</filename>. This is most easily
- accomplished using pkg-config; i.e.,
-
- <programlisting>
- gcc plplotcanvas_demo.c -o plplotcanvas_demo `pkg-config --cflags --libs plplotd-gnome2`
- </programlisting>
-
- You may need to remind pkg-config where to look for the
- <filename>plplotd-gnome2.pc</filename> file installed by PLplot; e.g.,
-
- <programlisting>
- gcc plplotcanvas_demo.c -o plplotcanvas_demo `PKG_CONFIG_PATH=/usr/local/lib/pkgconfig pkg-config --cflags --libs plplotd-gnome2`
- </programlisting>
- </para>
-
- <para>
- A specialized API is provided for PlplotCanvas and is described in
- <xref linkend="plplotcanvas-api" />. The API provides methods
- to create and manipulate PlplotCanvas widgets, in addition to
- object-oriented analogues for each of the PLplot functions.
- </para>
-
- <para>
- Example programs are provided that demonstrate the use of the
- PlplotCanvas widget in <xref linkend="plplotcanvas-examples" />.
- </para>
-
- </sect2>
-
-
- <!-- ================================================================== -->
-
- <sect2 id="plplotcanvas-api">
- <title>PlplotCanvas API</title>
-
- <para>
- The PlplotCanvas methods are as follows. Because PlplotCanvas is a
- GTK widget, GLib types (gint, gdouble, gboolean, etc) are sometimes
- used rather than PLplot types (PLINT, PLFLT, etc). See
- http://developer.gnome.org/doc/API/2.0/glib/index.html for more
- information on GLib and GLib types.
- </para>
-
- <!-- plplot_canvas_new -->
-
- <sect3 id="plplot_canvas_new">
-
- <title>
- <function>plplot_canvas_new</function>: Creates a new PlplotCanvas.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>
- PlplotCanvas* plplot_canvas_new
- </function></funcdef>
- <paramdef><parameter>void</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Returns a pointer to a new PlplotCanvas widget. Methods that
- apply to a PlplotCanvas are given next.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>void</parameter>
- </term>
- <listitem><para>
- There are no arguments for this method.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplot_canvas_plfunc -->
-
- <sect3 id="plplot_canvas_plfunc">
- <title>
- <function>plplot_canvas_plfunc</function>: PLplot function analogues.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>void plplot_canvas_plfunc</function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- <paramdef><parameter>...</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- The PLplot functions have analogue methods named like
- <function>plplot_canvas_plfunc</function>. For example, the
- PLplot function &plline; maps to
- <function>plplot_canvas_plline</function>. The
- <function>plplot_canvas_plfunc</function> methods
- should be used rather than the standard PLplot API when the
- PlplotCanvas is used.
- </para>
-
- <para>
- Lines drawn to the canvas are not shown until the page is
- advanced using <function>plplot_canvas_pladv</function>. The
- plot will remain on the canvas until the next page advance.
- </para>
-
- <para>
- The PLplot &plinit; and &plgstrm; functions are not used with
- PlplotCanvas because the <function>plplot_canvas_new</function>
- function does the necessary initialization and returns an
- object with a unique stream number.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>The canvas on which to operate.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>...</parameter>
- </term>
- <listitem><para>
- The list of arguments from the PLplot function analogue. The
- same types used in the PLplot function are used here.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplot_canvas_dispose -->
-
- <sect3 id="plplot_canvas_dispose">
- <title>
- <function>plplot_canvas_dispose</function>: Disposes the canvas.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>void plplot_canvas_dispose</function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Disposes the Canvas.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>The canvas to dispose.</para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplotcanvas_canvas_set_size -->
-
- <sect3 id ="plplot_canvas_set_size">
- <title>
- <function>plplot_canvas_set_size</function>: Sets the canvas size.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>
- void plplot_canvas_set_size
- </function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- <paramdef><parameter>width</parameter></paramdef>
- <paramdef><parameter>height</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Sets the PlplotCanvas widget width and height.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>The PlplotCanvas to size.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>width</parameter> (<literal>gint</literal>, input)
- </term>
- <listitem><para>The width, in pixels.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>height</parameter> (<literal>gint</literal>, input)
- </term>
- <listitem><para>The height, in pixels.</para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplot_canvas_use_text -->
-
- <sect3 id="plplot_canvas_use_text">
- <title>
- <function>plplot_canvas_use_text</function>: Sets text handling.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>void plplot_canvas_use_text</function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- <paramdef><parameter>use_text</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Sets whether TrueType text or Hershey fonts are used by the
- PlplotCanvas widget.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>The PlplotCanvas to set.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>use_text</parameter>
- (<literal>gboolean</literal>, input)
- </term>
- <listitem><para>
- TRUE for TrueType fonts (default), FALSE for Hershey fonts.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplot_canvas_use_pixmap -->
-
- <sect3 id="plplot_canvas_use_pixmap">
- <title>
- <function>plplot_canvas_use_pixmap</function>: Sets pixmap usage.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>void plplot_canvas_use_pixmap</function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- <paramdef><parameter>use_pixmap</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Sets whether lines and shades are drawn to a pixmap,
- or instead as vector graphics.
- </para>
-
- <para>
- Lines and shade drawn to the pixmap are not anti-aliased, and so may
- appear pixelated. Vector graphics are fully anti-aliased, but are
- rendered at a slower speed.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>The PlplotCanvas to set.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>use_pixmap</parameter>
- (<literal>gboolean</literal>, input)
- </term>
- <listitem><para>
- TRUE to use pixmap (default), FALSE for vector graphics instead.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplot_canvas_use_persistence -->
-
- <sect3 id="plplot_canvas_use_persistence">
- <title>
- <function>plplot_canvas_use_persistence</function>: Sets persistence
- of subsequent drawing operations.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>
- void plplot_canvas_use_persistence
- </function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- <paramdef><parameter>use_persistence</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Sets whether the subsequent drawing commands are persistent,
- or refreshed when the PLplot page is advanced. This feature
- is useful for plot animations, because the axes can be persistent
- rather than redrawn for each frame.
- </para>
-
- <para>
- Note that lines that are persistent are always anti-aliased and
- drawn at the front.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>The PlplotCanvas to set.</para></listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <parameter>use_persistence</parameter>
- (<literal>gboolean</literal>, input)
- </term>
- <listitem><para>
- TRUE for persistence, FALSE for erasing at new page (default).
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
-
- <!-- plplot_canvas_get_stream_number -->
-
- <sect3 id="plplot_canvas_get_stream_number">
- <title>
- <function>plplot_canvas_get_stream_number</function>: Retrieves the
- PLplot stream number.
- </title>
-
- <para>
- <funcsynopsis><funcprototype>
- <funcdef><function>
- PLINT plplot_canvas_get_stream_number
- </function></funcdef>
- <paramdef><parameter>canvas</parameter></paramdef>
- </funcprototype></funcsynopsis>
- </para>
-
- <para>
- Returns the stream number for the given Canvas. Although the
- concept of streams that exists in the standard PLplot API is not
- used here, the stream number provides a unique ID number for
- the given PlplotCanvas widget.
- </para>
-
- <variablelist>
- <varlistentry>
- <term>
- <parameter>canvas</parameter>
- (<literal>PlplotCanvas*</literal>, input)
- </term>
- <listitem><para>
- The canvas to retrieve the stream number from.
- </para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect3>
-
- </sect2>
-
-
-
- <!-- ================================================================== -->
-
- <sect2 id="plplotcanvas-examples">
- <title>PlplotCanvas Examples</title>
-
- <para>
-
- Two example programs are provided that demonstrate the use of the
- PlplotCanvas widget. They are:
-
- <itemizedlist>
- <listitem><para>
- plplotcanvas_demo: Demonstrates the basic usage of the
- PlplotCanvas to embed a plot in a Gnome application.
- </para></listitem>
- <listitem><para>
- plplotcanvas_animation: Demonstrates advanced multi-threaded
- dual-stream usage of the PlplotCanvas.
- </para></listitem>
- </itemizedlist>
- </para>
-
- <para>
- The code from plplotcanvas_demo.c is given below, and is explained
- in what follows.
- </para>
-
-
- <programlisting>
-
- #include <plplotcanvas.h>
- #include <gtk/gtk.h>
-
- /* The width and height of the plplot canvas widget */
- #define WIDTH 1000 /* 500 */
- #define HEIGHT 600 /* 300 */
-
- /* Delete event callback */
- gint delete_event( GtkWidget *widget,GdkEvent *event,gpointer data ) {
- return FALSE;
- }
-
- /* Destroy event calback */
- void destroy(GtkWidget *widget,gpointer data) {
- gtk_main_quit ();
- }
-
-
- int main(int argc,char *argv[] )
- {
-
- PlplotCanvas* canvas;
- GtkWidget *window;
-
- /* Parse the options */
- plparseopts(&argc, argv, PL_PARSE_FULL);
-
- /* The data to plot */
- double x[11] = {0,1,2,3,4,5,6,7,8,9,10};
- double y[11] = {0,0.1,0.4,0.9,1.6,2.6,3.6,4.9,6.4,8.1,10};
-
- /* Initialize gtk and the glib type system */
- gtk_init(&argc, &argv);
- g_type_init();
-
- /* Create the canvas and set its size; during the creation process,
- * the gcw driver is loaded into plplot, and plinit() is invoked.
- */
- canvas=plplot_canvas_new(TRUE);
- plplot_canvas_set_size(canvas,WIDTH,HEIGHT);
-
- /* Create a new window and stuff the canvas into it */
- window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
- gtk_container_set_border_width(GTK_CONTAINER(window),10);
- gtk_container_add(GTK_CONTAINER(window),GTK_WIDGET(canvas));
-
- /* Connect the signal handlers to the window decorations */
- g_signal_connect(G_OBJECT(window),"delete_event",
- G_CALLBACK(delete_event),NULL);
- g_signal_connect(G_OBJECT(window),"destroy",G_CALLBACK(destroy),NULL);
-
- /* Display everything */
- gtk_widget_show_all(window);
-
- /* Draw on the canvas with Plplot */
- plplot_canvas_pladv(canvas,0); /* Advance to first page */
- plplot_canvas_plcol0(canvas,15); /* Set color to black */
- plplot_canvas_plwid(canvas,2); /* Set the pen width */
- plplot_canvas_plvsta(canvas); /* Set the viewport */
- plplot_canvas_plwind(canvas,0.,10.,0.,10.); /* Set the window */
- plplot_canvas_plbox(canvas,"bcnst",0.,0,"bcnstv",0.,0); /* Set the box */
- plplot_canvas_pllab(canvas,"x-axis","y-axis","A Simple Plot"); /* Draw some labels */
-
- /* Draw the line */
- plplot_canvas_plcol0(canvas,1); /* Set the pen color */
- plplot_canvas_plline(canvas,11,x,y);
-
- /* Advancing the page finalizes this plot */
- plplot_canvas_pladv(canvas,0);
-
- /* Start the gtk main loop */
- gtk_main();
- }
- </programlisting>
-
-
- <para>
- So, what's going on here? After the preliminaries, the GTK and the
- GLib type system are initialized by calls to
- <function>gtk_init</function> and <function>g_type_init</function>.
- A PlplotCanvas is created using
- <function>plplot_canvas_new</function>, and it's size is set using
- <function>plplot_canvas_set_size</function>.
- </para>
-
- <para>
- Next, a window is created (<function>gtk_window_new</function>),
- the border is set (<function>gtk_set_border_width</function>),
- and the canvas is stuffed into the window
- (<function>gtk_container_add</function>).
- </para>
-
- <para>
- Callback functions are installed using
- <function>g_signal_connect</function> so that the window
- decorations respond. The window is set to display everything using
- <function>gtk_widget_show_all</function>.
- </para>
-
- <para>
- Now come the PLplot analogue commands. First, the page using is
- advanced using <function>plplot_canvas_pladv</function>. The pen
- color and width are set with <function>plplot_canvas_plcol0</function>
- and <function>plplot_canvas_plwid</function>,respectively. The PLplot
- viewport, window, box and labels are created using
- <function>plplot_canvas_plvpor</function>,
- <function>plplot_canvas_plwind</function>,
- <function>plplot_canvas_plbox</function> and
- <function>plplot_canvas_pllab</function>, respectively. A line is
- drawn on the canvas using <function>plplot_canvas_plline</function>,
- the page is advanced with <function>plplot_canvas_pladv</function>.
- </para>
-
- <para>
- Finally, the GTK main loop is entered using
- <function>gtk_main</function>, where it resides until the program
- is exited.
- </para>
-
- </sect2>
-
- </sect1>
-
-
- <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX -->
-
-
</chapter>
Modified: trunk/doc/docbook/src/libraries.xml
===================================================================
--- trunk/doc/docbook/src/libraries.xml 2010-09-23 17:30:18 UTC (rev 11204)
+++ trunk/doc/docbook/src/libraries.xml 2010-09-23 18:47:00 UTC (rev 11205)
@@ -2,7 +2,7 @@
<!--
libraries.xml: "The PLplot Libraries" chapter
-Copyright (C) 2009 Alan W. Irwin
+Copyright (C) 2009, 2010 Alan W. Irwin
Redistribution and use in source (XML DocBook) and "compiled" forms
(HTML, PDF, PostScript, DVI, TeXinfo and so forth) with or without
@@ -111,14 +111,6 @@
</row>
<row>
<entry>
- GNOME2 GUI
- </entry>
- <entry>
- libplplotgnome2
- </entry>
- </row>
- <row>
- <entry>
Tk GUI
</entry>
<entry>
Modified: trunk/examples/c/README.plplotcanvas
===================================================================
--- trunk/examples/c/README.plplotcanvas 2010-09-23 17:30:18 UTC (rev 11204)
+++ trunk/examples/c/README.plplotcanvas 2010-09-23 18:47:00 UTC (rev 11205)
@@ -2,6 +2,11 @@
PLPLOTCANVAS EXAMPLES
~~~~~~~~~~~~~~~~~~~~~
+N.B. gcw, gnome2, and pygcw have been retired since the 5.9.6 release.
+See README.release in the top-level directory for the reasons for this
+decision. Therefore, none of what follows (which depends upon gnome2)
+will work any more.
+
The PlplotCanvas examples are:
plplotcanvas_demo.c
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
