add the doc shooter to the docs dir as an uninstalled helper tool.

Mon Aug 23 17:19:19 2004  Jonathan Blandford  <jrb@redhat.com>

        * configure.in:
        * docs/tools/Makefile.am (clean-local): add the doc shooter to the
        docs dir as an uninstalled helper tool.

7 files changed, 754 insertions, 0 deletions

diff --git a/docs/tools/.cvsignore b/docs/tools/.cvsignore
new file mode 100644
index 000000000..3d6b0a9ae
--- /dev/null
+++ b/docs/tools/.cvsignore
@@ -0,0 +1,3 @@
+Makefile
+Makefile.in
+doc-shooter
diff --git a/docs/tools/Makefile.am b/docs/tools/Makefile.am
new file mode 100644
index 000000000..70c5d1578
--- /dev/null
+++ b/docs/tools/Makefile.am
@@ -0,0 +1,32 @@
+INCLUDES = 						\
+	-I$(top_srcdir) 				\
+	-I$(top_builddir)/gdk				\
+	-I$(top_srcdir)/gdk				\
+	-I$(top_srcdir)/gdk/x11				\
+	$(GTK_DEBUG_FLAGS)				\
+	$(GTK_DEP_CFLAGS)
+
+DEPS = 									\
+	$(top_builddir)/gdk-pixbuf/libgdk_pixbuf-$(GTK_API_VERSION).la	\
+	$(top_builddir)/gdk/$(gdktargetlib) 				\
+	$(top_builddir)/gtk/$(gtktargetlib)
+
+LDADDS = 								\
+	$(top_builddir)/gdk-pixbuf/libgdk_pixbuf-$(GTK_API_VERSION).la	\
+	$(top_builddir)/gdk/$(gdktargetlib)        			\
+	$(top_builddir)/gtk/$(gtktargetlib)
+
+noinst_PROGRAMS = 		\
+	doc-shooter
+
+doc_shooter_DEPENDENCIES = $(DEPS)
+doc_shooter_LDADD = $(LDADDS)
+doc_shooter_SOURCES=	\
+	shadow.c	\
+	shadow.h	\
+	shooter.c	\
+	widgets.c	\
+	widgets.h
+
+clean-local:
+	rm -f *.png
diff --git a/docs/tools/shadow.c b/docs/tools/shadow.c
new file mode 100644
index 000000000..67c31fe70
--- /dev/null
+++ b/docs/tools/shadow.c
@@ -0,0 +1,149 @@
+#include "shadow.h"
+#include <math.h>
+
+#define BLUR_RADIUS 5
+#define SHADOW_OFFSET (BLUR_RADIUS * 4 / 5)
+#define SHADOW_OPACITY 0.75
+
+typedef struct {
+  int size;
+  double *data;
+} ConvFilter;
+
+static double
+gaussian (double x, double y, double r)
+{
+    return ((1 / (2 * M_PI * r)) *
+	    exp ((- (x * x + y * y)) / (2 * r * r)));
+}
+
+static ConvFilter *
+create_blur_filter (int radius)
+{
+  ConvFilter *filter;
+  int x, y;
+  double sum;
+  
+  filter = g_new0 (ConvFilter, 1);
+  filter->size = radius * 2 + 1;
+  filter->data = g_new (double, filter->size * filter->size);
+
+  sum = 0.0;
+  
+  for (y = 0 ; y < filter->size; y++)
+    {
+      for (x = 0 ; x < filter->size; x++)
+	{
+	  sum += filter->data[y * filter->size + x] = gaussian (x - (filter->size >> 1),
+								y - (filter->size >> 1),
+								radius);
+	}
+    }
+
+  for (y = 0; y < filter->size; y++)
+    {
+      for (x = 0; x < filter->size; x++)
+	{
+	  filter->data[y * filter->size + x] /= sum;
+	}
+    }
+
+  return filter;
+  
+}
+
+static GdkPixbuf *
+create_shadow (GdkPixbuf *src)
+{
+  int x, y, i, j;
+  int width, height;
+  GdkPixbuf *dest;
+  static ConvFilter *filter = NULL;
+  int src_rowstride, dest_rowstride;
+  int src_bpp, dest_bpp;
+  
+  guchar *src_pixels, *dest_pixels;
+
+  if (!filter)
+    filter = create_blur_filter (BLUR_RADIUS);
+  
+  width = gdk_pixbuf_get_width (src) + BLUR_RADIUS * 2 + SHADOW_OFFSET;
+  height = gdk_pixbuf_get_height (src) + BLUR_RADIUS * 2 + SHADOW_OFFSET;
+
+  dest = gdk_pixbuf_new (gdk_pixbuf_get_colorspace (src),
+			 gdk_pixbuf_get_has_alpha (src),
+			 gdk_pixbuf_get_bits_per_sample (src),
+			 width, height);
+  gdk_pixbuf_fill (dest, 0);  
+  src_pixels = gdk_pixbuf_get_pixels (src);
+  src_rowstride = gdk_pixbuf_get_rowstride (src);
+  src_bpp = gdk_pixbuf_get_has_alpha (src) ? 4 : 3;
+  
+  dest_pixels = gdk_pixbuf_get_pixels (dest);
+  dest_rowstride = gdk_pixbuf_get_rowstride (dest);
+  dest_bpp = gdk_pixbuf_get_has_alpha (dest) ? 4 : 3;
+  
+  for (y = 0; y < height; y++)
+    {
+      for (x = 0; x < width; x++)
+	{
+	  int sumr = 0, sumg = 0, sumb = 0, suma = 0;
+
+	  for (i = 0; i < filter->size; i++)
+	    {
+	      for (j = 0; j < filter->size; j++)
+		{
+		  int src_x, src_y;
+
+		  src_y = -(BLUR_RADIUS + SHADOW_OFFSET) + y - (filter->size >> 1) + i;
+		  src_x = -(BLUR_RADIUS + SHADOW_OFFSET) + x - (filter->size >> 1) + j;
+
+		  if (src_y < 0 || src_y > gdk_pixbuf_get_height (src) ||
+		      src_x < 0 || src_x > gdk_pixbuf_get_width (src))
+		    continue;
+
+		  sumr += src_pixels [src_y * src_rowstride +
+				      src_x * src_bpp + 0] *
+		    filter->data [i * filter->size + j];
+		  sumg += src_pixels [src_y * src_rowstride +
+				      src_x * src_bpp + 1] * 
+		    filter->data [i * filter->size + j];
+
+		  sumb += src_pixels [src_y * src_rowstride +
+				      src_x * src_bpp + 2] * 
+		    filter->data [i * filter->size + j];
+		  
+		  if (src_bpp == 4)
+		    suma += src_pixels [src_y * src_rowstride +
+					src_x * src_bpp + 3] *
+		    filter->data [i * filter->size + j];
+
+		    
+		}
+	    }
+
+	  if (dest_bpp == 4)
+	    dest_pixels [y * dest_rowstride +
+			 x * dest_bpp + 3] = suma * SHADOW_OPACITY;
+
+	}
+    }
+  
+  return dest;
+}
+
+GdkPixbuf *
+create_shadowed_pixbuf (GdkPixbuf *src)
+{
+  GdkPixbuf *dest;
+  
+  dest = create_shadow (src);
+
+  gdk_pixbuf_composite (src, dest,
+			BLUR_RADIUS, BLUR_RADIUS,
+			gdk_pixbuf_get_width (src),
+			gdk_pixbuf_get_height (src),
+			BLUR_RADIUS, BLUR_RADIUS, 1.0, 1.0,
+			GDK_INTERP_NEAREST, 255);
+  return dest;
+}
diff --git a/docs/tools/shadow.h b/docs/tools/shadow.h
new file mode 100644
index 000000000..2f569cc34
--- /dev/null
+++ b/docs/tools/shadow.h
@@ -0,0 +1,8 @@
+#ifndef __SHADOW_H__
+#define __SHADOW_H__
+
+#include <gdk-pixbuf/gdk-pixbuf.h>
+
+GdkPixbuf *create_shadowed_pixbuf (GdkPixbuf *src);
+
+#endif /* __SHADOW_H__ */
diff --git a/docs/tools/shooter.c b/docs/tools/shooter.c
new file mode 100644
index 000000000..3c96c7565
--- /dev/null
+++ b/docs/tools/shooter.c
@@ -0,0 +1,229 @@
+#include <gdk/gdk.h>
+#include <gtk/gtk.h>
+#include <gdkx.h>
+#include <stdio.h>
+#include <errno.h>
+#include <sys/wait.h>
+#include <unistd.h>
+#include <X11/extensions/shape.h>
+
+#include <gdk-pixbuf/gdk-pixbuf.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <sys/wait.h>
+#include <signal.h>
+#include <unistd.h>
+#include <stdlib.h>
+#include <fcntl.h>
+#include <errno.h>
+#include <locale.h>
+#include "widgets.h"
+#include "shadow.h"
+
+#define MAXIMUM_WM_REPARENTING_DEPTH 4
+#ifndef _
+#define _(x) (x)
+#endif
+
+static Window
+find_toplevel_window (Window xid)
+{
+  Window root, parent, *children;
+  int nchildren;
+
+  do
+    {
+      if (XQueryTree (GDK_DISPLAY (), xid, &root,
+		      &parent, &children, &nchildren) == 0)
+	{
+	  g_warning ("Couldn't find window manager window");
+	  return 0;
+	}
+
+      if (root == parent)
+	return xid;
+
+      xid = parent;
+    }
+  while (TRUE);
+}
+
+static GdkPixbuf *
+add_border_to_shot (GdkPixbuf *pixbuf)
+{
+  GdkPixbuf *retval;
+
+  retval = gdk_pixbuf_new (GDK_COLORSPACE_RGB, TRUE, 8,
+			   gdk_pixbuf_get_width (pixbuf) + 2,
+			   gdk_pixbuf_get_height (pixbuf) + 2);
+
+  /* Fill with solid black */
+  gdk_pixbuf_fill (retval, 0xFF);
+  gdk_pixbuf_copy_area (pixbuf,
+			0, 0,
+			gdk_pixbuf_get_width (pixbuf),
+			gdk_pixbuf_get_height (pixbuf),
+			retval, 1, 1);
+
+  return retval;
+}
+
+static GdkPixbuf *
+remove_shaped_area (GdkPixbuf *pixbuf,
+		    Window     window)
+{
+  GdkPixbuf *retval;
+  XRectangle *rectangles;
+  int rectangle_count, rectangle_order;
+  int i;
+
+  retval = gdk_pixbuf_new (GDK_COLORSPACE_RGB, TRUE, 8,
+			   gdk_pixbuf_get_width (pixbuf),
+			   gdk_pixbuf_get_height (pixbuf));
+  
+  gdk_pixbuf_fill (retval, 0);
+  rectangles = XShapeGetRectangles (GDK_DISPLAY (), window,
+				    ShapeBounding, &rectangle_count, &rectangle_order);
+
+  for (i = 0; i < rectangle_count; i++)
+    {
+      int y, x;
+
+      for (y = rectangles[i].y; y < rectangles[i].y + rectangles[i].height; y++)
+	{
+	  guchar *src_pixels, *dest_pixels;
+
+	  src_pixels = gdk_pixbuf_get_pixels (pixbuf) +
+	    y * gdk_pixbuf_get_rowstride (pixbuf) +
+	    rectangles[i].x * (gdk_pixbuf_get_has_alpha (pixbuf) ? 4 : 3);
+	  dest_pixels = gdk_pixbuf_get_pixels (retval) +
+	    y * gdk_pixbuf_get_rowstride (retval) +
+	    rectangles[i].x * 4;
+
+	  for (x = rectangles[i].x; x < rectangles[i].x + rectangles[i].width; x++)
+	    {
+	      *dest_pixels++ = *src_pixels ++;
+	      *dest_pixels++ = *src_pixels ++;
+	      *dest_pixels++ = *src_pixels ++;
+	      *dest_pixels++ = 255;
+
+	      if (gdk_pixbuf_get_has_alpha (pixbuf))
+		src_pixels++;
+	    }
+	}
+    }
+
+  return retval;
+}
+
+static GdkPixbuf *
+take_window_shot (Window   child,
+		  gboolean include_decoration)
+{
+  GdkWindow *window;
+  Display *disp;
+  Window w, xid;
+  gint x_orig, y_orig;
+  gint x = 0, y = 0;
+  gint width, height;
+
+  GdkPixbuf *tmp, *tmp2;
+  GdkPixbuf *retval;
+
+  disp = GDK_DISPLAY ();
+  w = GDK_ROOT_WINDOW ();
+
+  if (include_decoration)
+    xid = find_toplevel_window (child);
+  else
+    xid = child;
+
+  window = gdk_window_foreign_new (xid);
+
+  gdk_drawable_get_size (window, &width, &height);
+  gdk_window_get_origin (window, &x_orig, &y_orig);
+
+  if (x_orig < 0)
+    {
+      x = - x_orig;
+      width = width + x_orig;
+      x_orig = 0;
+    }
+
+  if (y_orig < 0)
+    {
+      y = - y_orig;
+      height = height + y_orig;
+      y_orig = 0;
+    }
+
+  if (x_orig + width > gdk_screen_width ())
+    width = gdk_screen_width () - x_orig;
+
+  if (y_orig + height > gdk_screen_height ())
+    height = gdk_screen_height () - y_orig;
+
+  tmp = gdk_pixbuf_get_from_drawable (NULL, window, NULL,
+				      x, y, 0, 0, width, height);
+
+  if (include_decoration)
+    tmp2 = remove_shaped_area (tmp, xid);
+  else
+    tmp2 = add_border_to_shot (tmp);
+
+  retval = create_shadowed_pixbuf (tmp2);
+  g_object_unref (tmp);
+  g_object_unref (tmp2);
+
+  return retval;
+}
+
+int main (int argc, char **argv)
+{
+  GList *toplevels;
+  GdkPixbuf *screenshot = NULL;
+  GList *node;
+
+  /* If there's no DISPLAY, we silently error out.  We don't want to break
+   * headless builds. */
+  if (! gtk_init_check (&argc, &argv))
+    return 0;
+
+  toplevels = get_all_widgets ();
+
+  for (node = toplevels; node; node = g_list_next (node))
+    {
+      GdkWindow *window;
+      WidgetInfo *info;
+      XID id;
+      char *filename;
+
+      info = node->data;
+
+      gtk_widget_show (info->window);
+
+      window = info->window->window;
+
+      gtk_widget_show_now (info->window);
+      gtk_widget_draw (info->window, &(info->window->allocation));
+
+      while (gtk_events_pending ())
+	{
+	  gtk_main_iteration ();
+	}
+      sleep (1);
+      while (gtk_events_pending ())
+	{
+	  gtk_main_iteration ();
+	}
+
+      id = gdk_x11_drawable_get_xid (GDK_DRAWABLE (window));
+      screenshot = take_window_shot (id, info->include_decorations);
+      filename = g_strdup_printf ("./%s.png", info->name);
+      gdk_pixbuf_save (screenshot, filename, "png", NULL, NULL);
+      g_free(filename);
+      gtk_widget_hide (info->window);
+    }
+
+  return 0;
+}
diff --git a/docs/tools/widgets.c b/docs/tools/widgets.c
new file mode 100644
index 000000000..582de7997
--- /dev/null
+++ b/docs/tools/widgets.c
@@ -0,0 +1,316 @@
+#include "widgets.h"
+      
+
+static WidgetInfo *
+new_widget_info (const char *name,
+		 GtkWidget  *widget)
+{
+  WidgetInfo *info;
+
+  info = g_new0 (WidgetInfo, 1);
+  info->name = g_strdup (name);
+  info->window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
+  info->no_focus = TRUE;
+  info->include_decorations = FALSE;
+
+  gtk_widget_set_app_paintable (info->window, TRUE);
+  g_signal_connect (info->window, "focus", G_CALLBACK (gtk_true), NULL);
+  gtk_container_set_border_width (GTK_CONTAINER (info->window), 12);
+  gtk_widget_show_all (widget);
+  gtk_container_add (GTK_CONTAINER (info->window), widget);
+    
+  return info;
+}
+
+static WidgetInfo *
+create_button (void)
+{
+  GtkWidget *widget;
+  
+  widget = gtk_button_new_with_mnemonic ("_Button");
+
+  return new_widget_info ("button", widget);
+}
+
+static WidgetInfo *
+create_toggle_button (void)
+{
+  GtkWidget *widget;
+
+  widget = gtk_toggle_button_new_with_mnemonic ("_Toggle Button");
+  gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (widget), FALSE);
+
+  return new_widget_info ("toggle-button", widget);
+}
+
+static WidgetInfo *
+create_check_button (void)
+{
+  GtkWidget *widget;
+  
+  widget = gtk_check_button_new_with_mnemonic ("_Check Button");
+  gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (widget), TRUE);
+
+  return new_widget_info ("check-button", widget);
+}
+
+static WidgetInfo *
+create_entry (void)
+{
+  GtkWidget *widget;
+  
+  widget = gtk_entry_new ();
+  gtk_entry_set_text (GTK_ENTRY (widget), "Entry");
+  gtk_editable_set_position (GTK_EDITABLE (widget), -1);
+  
+  return  new_widget_info ("entry", widget);
+}
+
+static WidgetInfo *
+create_radio (void)
+{
+  GtkWidget *widget;
+  GtkWidget *radio;
+  
+  widget = gtk_vbox_new (FALSE, 3);
+  radio = gtk_radio_button_new_with_mnemonic (NULL, "Radio Button Item _One");
+  gtk_box_pack_start (GTK_BOX (widget), radio, FALSE, FALSE, 0);
+  radio = gtk_radio_button_new_with_mnemonic_from_widget (GTK_RADIO_BUTTON (radio), "Radio Button Item _Two");
+  gtk_box_pack_start (GTK_BOX (widget), radio, FALSE, FALSE, 0);
+  radio = gtk_radio_button_new_with_mnemonic_from_widget (GTK_RADIO_BUTTON (radio), "Radio Button Item T_hree");
+  gtk_box_pack_start (GTK_BOX (widget), radio, FALSE, FALSE, 0);
+
+  return new_widget_info ("radio-group", widget);
+}
+
+static WidgetInfo *
+create_label (void)
+{
+  GtkWidget *widget;
+
+  widget = gtk_label_new ("Label");
+
+  return new_widget_info ("label", widget);
+}
+
+static WidgetInfo *
+create_combo_box_entry (void)
+{
+  GtkWidget *widget;
+
+  widget = gtk_combo_box_entry_new_text ();
+  gtk_entry_set_text (GTK_ENTRY (GTK_BIN (widget)->child), "Combo Box Entry");
+
+
+  return new_widget_info ("combo-box-entry", widget);
+}
+
+static WidgetInfo *
+create_text_view (void)
+{
+  GtkWidget *widget;
+  GtkWidget *text_view;
+
+  widget = gtk_frame_new (NULL);
+  gtk_frame_set_shadow_type (GTK_FRAME (widget), GTK_SHADOW_IN);
+  text_view = gtk_text_view_new ();
+  gtk_container_add (GTK_CONTAINER (widget), text_view);
+  /* Bad hack to add some size to the widget */
+  gtk_text_buffer_set_text (gtk_text_view_get_buffer (GTK_TEXT_VIEW (text_view)),
+			    "Multiline             \nText\n\n", -1);
+  gtk_text_view_set_cursor_visible (GTK_TEXT_VIEW (text_view), FALSE);
+  
+  return new_widget_info ("multiline-text", widget);
+}
+
+static WidgetInfo *
+create_tree_view (void)
+{
+  GtkWidget *widget;
+  GtkWidget *tree_view;
+  GtkListStore *list_store;
+  GtkTreeIter iter;
+  WidgetInfo *info;
+
+  widget = gtk_frame_new (NULL);
+  gtk_frame_set_shadow_type (GTK_FRAME (widget), GTK_SHADOW_IN);
+  list_store = gtk_list_store_new (1, G_TYPE_STRING);
+  gtk_list_store_append (list_store, &iter);
+  gtk_list_store_set (list_store, &iter, 0, "Line One", -1);
+  gtk_list_store_append (list_store, &iter);
+  gtk_list_store_set (list_store, &iter, 0, "Line Two", -1);
+  gtk_list_store_append (list_store, &iter);
+  gtk_list_store_set (list_store, &iter, 0, "Line Three", -1);
+
+  tree_view = gtk_tree_view_new_with_model (GTK_TREE_MODEL (list_store));
+  gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (tree_view),
+					       0, "List and Tree",
+					       gtk_cell_renderer_text_new (),
+					       "text", 0, NULL);
+  gtk_container_add (GTK_CONTAINER (widget), tree_view);
+  
+  info = new_widget_info ("list-and-tree", widget);
+  info->no_focus = FALSE;
+
+  return info;
+}
+
+static WidgetInfo *
+create_color_button (void)
+{
+  GtkWidget *vbox;
+  GtkWidget *picker;
+  GtkWidget *align;
+  GdkColor color;
+
+  vbox = gtk_vbox_new (FALSE, 3);
+  align = gtk_alignment_new (0.5, 0.5, 0.0, 0.0);
+  color.red = 0x1e<<8;  /* Go Gagne! */
+  color.green = 0x90<<8;
+  color.blue = 0xff<<8;
+  picker = gtk_color_button_new_with_color (&color);
+  gtk_container_add (GTK_CONTAINER (align), picker);
+  gtk_box_pack_start (GTK_BOX (vbox), align, FALSE, FALSE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox),
+		      gtk_label_new ("Color Button"),
+		      FALSE, FALSE, 0);
+
+  return new_widget_info ("color-button", vbox);
+}
+
+static WidgetInfo *
+create_font_button (void)
+{
+  GtkWidget *vbox;
+  GtkWidget *picker;
+  GtkWidget *align;
+
+  vbox = gtk_vbox_new (FALSE, 3);
+  align = gtk_alignment_new (0.5, 0.5, 0.0, 0.0);
+  picker = gtk_font_button_new_with_font ("Sans Serif 10");
+  gtk_container_add (GTK_CONTAINER (align), picker);
+  gtk_box_pack_start (GTK_BOX (vbox), align, FALSE, FALSE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox),
+		      gtk_label_new ("Font Button"),
+		      FALSE, FALSE, 0);
+
+  return new_widget_info ("font-button", vbox);
+}
+
+static WidgetInfo *
+create_separator (void)
+{
+  GtkWidget *hbox;
+  GtkWidget *vbox;
+
+  vbox = gtk_vbox_new (FALSE, 3);
+  hbox = gtk_hbox_new (TRUE, 0);
+  gtk_box_pack_start (GTK_BOX (hbox),
+		      gtk_hseparator_new (),
+		      TRUE, TRUE, 0);
+  gtk_box_pack_start (GTK_BOX (hbox),
+		      gtk_vseparator_new (),
+		      TRUE, TRUE, 0);
+  gtk_widget_set_size_request (hbox, 200, 150);
+  gtk_box_pack_start (GTK_BOX (vbox), hbox, TRUE, TRUE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox),
+		      gtk_label_new ("Horizontal and Vertical Separators"),
+		      FALSE, FALSE, 0);
+  return new_widget_info ("separator", vbox);
+}
+
+static WidgetInfo *
+create_panes (void)
+{
+  GtkWidget *hbox;
+  GtkWidget *vbox;
+  GtkWidget *pane;
+
+  vbox = gtk_vbox_new (FALSE, 3);
+  hbox = gtk_hbox_new (TRUE, 12);
+  pane = gtk_hpaned_new ();
+  gtk_paned_pack1 (GTK_PANED (pane),
+		   g_object_new (GTK_TYPE_FRAME,
+				 "shadow", GTK_SHADOW_IN,
+				 NULL),
+		   FALSE, FALSE);
+  gtk_paned_pack2 (GTK_PANED (pane),
+		   g_object_new (GTK_TYPE_FRAME,
+				 "shadow", GTK_SHADOW_IN,
+				 NULL),
+		   FALSE, FALSE);
+  gtk_box_pack_start (GTK_BOX (hbox),
+		      pane,
+		      TRUE, TRUE, 0);
+  pane = gtk_vpaned_new ();
+  gtk_paned_pack1 (GTK_PANED (pane),
+		   g_object_new (GTK_TYPE_FRAME,
+				 "shadow", GTK_SHADOW_IN,
+				 NULL),
+		   FALSE, FALSE);
+  gtk_paned_pack2 (GTK_PANED (pane),
+		   g_object_new (GTK_TYPE_FRAME,
+				 "shadow", GTK_SHADOW_IN,
+				 NULL),
+		   FALSE, FALSE);
+  gtk_box_pack_start (GTK_BOX (hbox),
+		      pane,
+		      TRUE, TRUE, 0);
+  gtk_widget_set_size_request (hbox, 200, 150);
+  gtk_box_pack_start (GTK_BOX (vbox), hbox, TRUE, TRUE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox),
+		      gtk_label_new ("Horizontal and Vertical Panes"),
+		      FALSE, FALSE, 0);
+  return new_widget_info ("panes", vbox);
+}
+
+static WidgetInfo *
+create_frame (void)
+{
+  GtkWidget *widget;
+
+  widget = gtk_frame_new ("Frame");
+  gtk_widget_set_size_request (widget, 150, 150);
+
+  return new_widget_info ("frame", widget);
+}
+
+static WidgetInfo *
+create_window (void)
+{
+  WidgetInfo *info;
+  GtkWidget *widget;
+
+  widget = gtk_frame_new (NULL);
+  gtk_frame_set_shadow_type (GTK_FRAME (widget), GTK_SHADOW_NONE);
+  gtk_widget_set_size_request (widget, 150, 150);
+  info = new_widget_info ("window", widget);
+  info->include_decorations = TRUE;
+  gtk_window_set_title (GTK_WINDOW (info->window), "Window");
+
+  return info;
+}
+
+GList *
+get_all_widgets (void)
+{
+  GList *retval = NULL;
+
+  retval = g_list_prepend (retval, create_button ());
+  retval = g_list_prepend (retval, create_toggle_button ());
+  retval = g_list_prepend (retval, create_check_button ());
+  retval = g_list_prepend (retval, create_entry ());
+  retval = g_list_prepend (retval, create_radio ());
+  retval = g_list_prepend (retval, create_label ());
+  retval = g_list_prepend (retval, create_combo_box_entry ());
+  retval = g_list_prepend (retval, create_text_view ());
+  retval = g_list_prepend (retval, create_tree_view ());
+  retval = g_list_prepend (retval, create_color_button ());
+  retval = g_list_prepend (retval, create_font_button ());
+  retval = g_list_prepend (retval, create_separator ());
+  retval = g_list_prepend (retval, create_panes ());
+  retval = g_list_prepend (retval, create_frame ());
+  retval = g_list_prepend (retval, create_window ());
+  
+  return retval;
+}
diff --git a/docs/tools/widgets.h b/docs/tools/widgets.h
new file mode 100644
index 000000000..4540f313e
--- /dev/null
+++ b/docs/tools/widgets.h
@@ -0,0 +1,17 @@
+#ifndef __WIDGETS_H__
+#define __WIDGETS_H__
+
+#include <gtk/gtk.h>
+
+typedef struct WidgetInfo
+{
+  GtkWidget *window;
+  gchar *name;
+  gboolean no_focus;
+  gboolean include_decorations;
+} WidgetInfo;
+
+GList *get_all_widgets (void);
+
+
+#endif /* __WIDGETS_H__ */