Reference

libgtkimreg(3)

GTK+ widget to select region of a (GdkImlib) image

NAME

libgtkimreg - GTK+ widget to select region of a (GdkImlib) image

SYNOPSIS

#include <gtk/gtkimreg.h>

GtkType gtk_imreg_get_type (void);
GtkWidget* gtk_imreg_new (const gchar * title, GdkImlibImage * im, int rw, int rh, GtkWidget * user_area);
gint gtk_imreg_get_left (GtkImReg * imreg);
gint gtk_imreg_get_top (GtkImReg * imreg);
gint gtk_imreg_get_right (GtkImReg * imreg);
gint gtk_imreg_get_bottom (GtkImReg * imreg);
gint gtk_imreg_get (GtkImReg * imreg, gint * le, gint * to, gint * ri, gint * bo);
gint gtk_imreg_set_left (GtkImReg * imreg, gint left);
gint gtk_imreg_set_top (GtkImReg * imreg, gint top);
gint gtk_imreg_set_right (GtkImReg * imreg, gint right);
gint gtk_imreg_set_bottom (GtkImReg * imreg, gint bottom);
gint gtk_imreg_set (GtkImReg * imreg, gint left, gint top, gint right, gint bottom);

DESCRIPTION

Select an area in an image given as GdkImlib structure and obtain the coordinates of this image. The user_area can be NULL or an user supplied widget to add certain functionality.
The gtk_imreg_get_ functions are useful in an OK-callback to obtain the chosen coordinates. The gtk_imreg_set_ functions enable the user to preset a region selection.

EXAMPLE

See testimreg.c which is shipped with the sources. In a Debian system you can find it under
/usr/doc/libgtkimreg-dev/example/testimreg
next to an appropriate Makefile and an image example.

REQUIRES

GTK+ 1.2, GdkImlib 1.9.2 or higher

AUTHOR

Andreas Tille <[email protected]>
http://www.physik.uni-halle.de/~e2od5

Address at home:

Gartenstraße 8
D-38855 Wernigerode
GERMANY

Address at university:

Martin-Luther-Universität Halle/Wittenberg
Fachbereich Physik
Experimentalphysik II
Friedeman-Bach-Platz 6
D-06108 Halle / Saale
GERMANY