gtkimreg(3) · carta

NAME

gtkimreg - 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/share/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