GIMP Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# gimpui

## Name

gimpui -- Common user interface functions. This header includes all other GIMP User Interface Library headers.

## Synopsis

    void        gimp_ui_init                    (const gchar *prog_name,
                                                 gboolean preview);

## Description

Common user interface functions. This header includes all other GIMP User Interface Library headers.

## Details

### gimp_ui_init ()

    void        gimp_ui_init                    (const gchar *prog_name,
                                                 gboolean preview);

This function initializes GTK+ with gtk_init(), instructs GDK not to use X shared memory if The GIMP was invoked with the --no-xshm command line option and initializes GDK's image rendering subsystem (GdkRGB) to follow the GIMP main program's colormap allocation/installation policy.

The GIMP's colormap policy can be determinded by the user with the gimprc variables `min_colors` and `install_cmap`.

`prog_name` : | The name of the plug-in which will be passed as argv[0] to gtk_init(). It's a convention to use the name of the executable and _not_ the PDB procedure name or something.
`preview` : | TRUE if the plug-in has some kind of preview in it's UI. Note that passing TRUE is recommended also if one of the used GIMP Library widgets contains a preview (like the image menu returned by gimp_image_menu_new()).

## See Also

gtk_init(), gdk_set_use_xshm(), gdk_rgb_set_min_colors(), gdk_rgb_set_install(), gdk_rgb_get_visual(), gdk_rgb_get_cmap(), gtk_widget_set_default_visual(), gtk_widget_set_default_colormap(), gtk_preview_set_gamma().

<<< Previous Page | Home | Up | Next Page >>>
GIMP User Interface Library | GimpChainButton