diff --git a/devel-docs/ChangeLog b/devel-docs/ChangeLog index ab251e19d8..a23940db5d 100644 --- a/devel-docs/ChangeLog +++ b/devel-docs/ChangeLog @@ -1,3 +1,11 @@ +Sat Feb 5 16:22:21 CET 2000 Sven Neumann + + * README: more help + + * libgimp/.cvsignore + * libgimp/libgimp-decl.txt + * libgimp/tmpl/gimpwidgets.sgml: updated after changes to libgimp + Fre Feb 4 16:18:39 CET 2000 Sven Neumann * libgimp/Makefile.am: I'm still tweaking it a bit... diff --git a/devel-docs/README b/devel-docs/README index a3578bfe96..7bb5b9bc9a 100644 --- a/devel-docs/README +++ b/devel-docs/README @@ -65,6 +65,7 @@ PATH. If everything was set up correctly running a simple make should do the trick and generate the SGML and HTML files for you. + In most cases you will work on the documentation by adding or editing comment blocks in the C source and by editing the template SGML files in the tmpl dir. The following steps @@ -76,3 +77,26 @@ make sgml - Creates the SGML files from the templates found make html - Build HTML pages out of the SGML files. + +If the source was changed (real changes as described above), +you will need to perform the following two steps before you can +rebuild the sgml and html files: + +make scan - Scans the header files and builds and runs a + binary that asks the GtkObjects to describe + themselves. That way the hierarchy of widgets, + arguments and signals are determined. If you + have added new objects, you will have to update + the MODULE.types files accordingly before you + perform this step. + +make templates - Merges the changes into the templates. This will + output warnings about any declarations which have + been added/removed. Update the MODULE-sections.txt + to include the new functions etc. in the + appropriate sections, and delete ones which are + no longer available. Run "make templates" again + until there are no warnings output. + + + diff --git a/devel-docs/libgimp/.cvsignore b/devel-docs/libgimp/.cvsignore index 468e73b289..9fe1361957 100644 --- a/devel-docs/libgimp/.cvsignore +++ b/devel-docs/libgimp/.cvsignore @@ -2,5 +2,6 @@ Makefile Makefile.in libgimp.html libgimp-decl-list.txt +libgimp-unused.txt html sgml diff --git a/devel-docs/libgimp/libgimp-decl.txt b/devel-docs/libgimp/libgimp-decl.txt index dfd27a0853..834791350b 100644 --- a/devel-docs/libgimp/libgimp-decl.txt +++ b/devel-docs/libgimp/libgimp-decl.txt @@ -1,142 +1,3 @@ - -GimpColorDisplayInit -void -void - - -GimpColorDisplayNew -gpointer -int type - - -GimpColorDisplayClone -gpointer -gpointer cd_ID - - -GimpColorDisplayConvert -void -gpointer cd_ID, - guchar *buf, - int width, - int height, - int bpp, - int bpl - - -GimpColorDisplayDestroy -void -gpointer cd_ID - - -GimpColorDisplayFinalize -void -void - - -GimpColorDisplayLoadState -void -gpointer cd_ID, - Parasite *state - - -GimpColorDisplaySaveState -Parasite * -gpointer cd_ID - - -GimpColorDisplayConfigure -void -gpointer cd_ID, - GFunc ok_func, - gpointer ok_data, - GFunc cancel_func, - gpointer cancel_data - - -GimpColorDisplayConfigureCancel -void -gpointer cd_ID - - -GimpColorDisplayMethods - - -GimpColorDisplayMethods -struct GimpColorDisplayMethods -{ - GimpColorDisplayInit init; - GimpColorDisplayNew new; - GimpColorDisplayClone clone; - GimpColorDisplayConvert convert; - GimpColorDisplayDestroy destroy; - GimpColorDisplayFinalize finalize; - GimpColorDisplayLoadState load; - GimpColorDisplaySaveState save; - GimpColorDisplayConfigure configure; - GimpColorDisplayConfigureCancel cancel; -}; - - -gimp_color_display_register -gboolean -const char *name,GimpColorDisplayMethods *methods - - -gimp_color_display_unregister -gboolean -const char *name - - -GimpColorSelector_Callback -void -void *data, int r, int g, int b - - -GimpColorSelector_NewFunc -GtkWidget * -int r, int g, int b, - GimpColorSelector_Callback cb, - void *data, - void **selector_data - - -GimpColorSelector_FreeFunc -void -void *selector_data - - -GimpColorSelector_SetColorFunc -void -void *selector_data, - int r, int g, int b, - int set_current - - -GimpColorSelectorMethods - - -GimpColorSelectorMethods -struct GimpColorSelectorMethods { - GimpColorSelector_NewFunc new; - GimpColorSelector_FreeFunc free; - GimpColorSelector_SetColorFunc setcolor; -}; - - -GimpColorSelectorID -typedef void *GimpColorSelectorID; - - -gimp_color_selector_register -GimpColorSelectorID -const char *name,const char *help_page,GimpColorSelectorMethods *methods - - -gimp_color_selector_unregister -gboolean -GimpColorSelectorID id,void (*callback)(void *data),void *data - GIMPVAR # define GIMPVAR __declspec(dllexport) @@ -1438,87 +1299,6 @@ gchar *help_data void gchar *help_data - -GIMP_TYPE_CHAIN_BUTTON -#define GIMP_TYPE_CHAIN_BUTTON (gimp_chain_button_get_type ()) - - -GIMP_CHAIN_BUTTON -#define GIMP_CHAIN_BUTTON(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_CHAIN_BUTTON, GimpChainButton)) - - -GIMP_CHAIN_BUTTON_CLASS -#define GIMP_CHAIN_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_CHAIN_BUTTON, GimpChainButtonClass)) - - -GIMP_IS_CHAIN_BUTTON -#define GIMP_IS_CHAIN_BUTTON(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_CHAIN_BUTTON)) - - -GIMP_IS_CHAIN_BUTTON_CLASS -#define GIMP_IS_CHAIN_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_CHAIN_BUTTON)) - - -GimpChainButton - - -GimpChainButtonClass - - -GimpChainPosition -typedef enum -{ - GIMP_CHAIN_TOP, - GIMP_CHAIN_LEFT, - GIMP_CHAIN_BOTTOM, - GIMP_CHAIN_RIGHT -} GimpChainPosition; - - -GimpChainButton -struct GimpChainButton -{ - GtkTable table; - - GimpChainPosition position; - GtkWidget *button; - GtkWidget *line1; - GtkWidget *line2; - GtkWidget *pixmap; - GdkPixmap *broken; - GdkBitmap *broken_mask; - GdkPixmap *chain; - GdkBitmap *chain_mask; - gboolean active; -}; - - -GimpChainButtonClass -struct GimpChainButtonClass -{ - GtkButtonClass parent_class; -}; - - -gimp_chain_button_get_type -GtkType -void - - -gimp_chain_button_new -GtkWidget * -GimpChainPosition position - - -gimp_chain_button_set_active -void -GimpChainButton *gcb,gboolean is_active - - -gimp_chain_button_get_active -gboolean -GimpChainButton *gcb - GimpAddMaskType typedef enum @@ -2203,257 +1983,6 @@ typedef GimpPDBStatusType GStatusType; RUN_WITH_LAST_VALS #define RUN_WITH_LAST_VALS GIMP_RUN_WITH_LAST_VALS - -gimp_directory -char * -void - - -gimp_personal_rc_file -char * -char *basename - - -gimp_data_directory -char * -void - - -gimp_gtkrc -char * -void - - -GIMP_TYPE_FILE_SELECTION -#define GIMP_TYPE_FILE_SELECTION (gimp_file_selection_get_type ()) - - -GIMP_FILE_SELECTION -#define GIMP_FILE_SELECTION(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_FILE_SELECTION, GimpFileSelection)) - - -GIMP_FILE_SELECTION_CLASS -#define GIMP_FILE_SELECTION_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_FILE_SELECTION, GimpFileSelectionClass)) - - -GIMP_IS_FILE_SELECTION -#define GIMP_IS_FILE_SELECTION(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_FILE_SELECTION)) - - -GIMP_IS_FILE_SELECTION_CLASS -#define GIMP_IS_FILE_SELECTION_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_FILE_SELECTION)) - - -GimpFileSelection - - -GimpFileSelectionClass - - -GimpFileSelection -struct GimpFileSelection -{ - GtkVBox hbox; - - GtkWidget *file_exists; - GtkWidget *entry; - GtkWidget *browse_button; - - GtkWidget *file_selection; - - GdkPixmap *yes_pixmap; - GdkBitmap *yes_mask; - GdkPixmap *no_pixmap; - GdkBitmap *no_mask; - - gchar *title; - gboolean dir_only; - gboolean check_valid; -}; - - -GimpFileSelectionClass -struct GimpFileSelectionClass -{ - GtkHBoxClass parent_class; - - void (* filename_changed) (GimpFileSelection *gfs); -}; - - -gimp_file_selection_get_type -GtkType -void - - -gimp_file_selection_new -GtkWidget * -gchar *title,gchar *filename,gboolean dir_only,gboolean check_valid - - -gimp_file_selection_get_filename -gchar * -GimpFileSelection *gfs - - -gimp_file_selection_set_filename -void -GimpFileSelection *gfs,gchar *filename - - -GIMP_MIN_IMAGE_SIZE -#define GIMP_MIN_IMAGE_SIZE 1 - - -GIMP_MAX_IMAGE_SIZE -#define GIMP_MAX_IMAGE_SIZE 16777216 - - -GIMP_MIN_RESOLUTION -#define GIMP_MIN_RESOLUTION (1.0 / 65536.0) - - -GIMP_MAX_RESOLUTION -#define GIMP_MAX_RESOLUTION 65536.0 - - -GIMP_CHECK_SIZE -#define GIMP_CHECK_SIZE 8 - - -GIMP_CHECK_SIZE_SM -#define GIMP_CHECK_SIZE_SM 4 - - -GIMP_CHECK_DARK -#define GIMP_CHECK_DARK (1.0 / 3.0) - - -GIMP_CHECK_LIGHT -#define GIMP_CHECK_LIGHT (2.0 / 3.0) - - -G_PI -#define G_PI 3.14159265358979323846 - - -G_PI_2 -#define G_PI_2 1.57079632679489661923 - - -G_PI_4 -#define G_PI_4 0.78539816339744830962 - - -G_SQRT2 -#define G_SQRT2 1.4142135623730951 - - -G_MAXRAND -#define G_MAXRAND G_MAXINT - - -G_MAXRAND -#define G_MAXRAND RAND_MAX - - -RINT -#define RINT(x) rint(x) - - -RINT -#define RINT(x) floor ((x) + 0.5) - - -ROUND -#define ROUND(x) ((int) ((x) + 0.5)) - - -SQR -#define SQR(x) ((x) * (x)) - - -MAX255 -#define MAX255(a) ((a) | (((a) & 256) - (((a) & 256) >> 8))) - - -CLAMP0255 -#define CLAMP0255(a) CLAMP(a,0,255) - - -GimpMatrix[3][3] -typedef double GimpMatrix[3][3]; - - -gimp_matrix_transform_point -void -GimpMatrix, double, double,double *, double * - - -gimp_matrix_mult -void -GimpMatrix, GimpMatrix - - -gimp_matrix_identity -void -GimpMatrix - - -gimp_matrix_translate -void -GimpMatrix, double, double - - -gimp_matrix_scale -void -GimpMatrix, double, double - - -gimp_matrix_rotate -void -GimpMatrix, double - - -gimp_matrix_xshear -void -GimpMatrix, double - - -gimp_matrix_yshear -void -GimpMatrix, double - - -gimp_matrix_determinant -double -GimpMatrix - - -gimp_matrix_invert -void -GimpMatrix m, GimpMatrix m_inv - - -gimp_matrix_duplicate -void -GimpMatrix src, GimpMatrix target - - -gimp_matrix_is_diagonal -int -GimpMatrix m - - -gimp_matrix_is_identity -int -GimpMatrix m - - -gimp_matrix_is_simple -int -GimpMatrix m - GimpConstraintFunc gint @@ -2625,95 +2154,6 @@ void * popup_pnt, gchar * pname gint void * popup_pnt - -GimpModuleStatus -typedef enum { - GIMP_MODULE_OK, - GIMP_MODULE_UNLOAD -} GimpModuleStatus; - - -GimpModuleInfo -typedef struct { - void *shutdown_data; - const char *purpose; - const char *author; - const char *version; - const char *copyright; - const char *date; -} GimpModuleInfo; - - -GIMP_TYPE_PATH_EDITOR -#define GIMP_TYPE_PATH_EDITOR (gimp_path_editor_get_type ()) - - -GIMP_PATH_EDITOR -#define GIMP_PATH_EDITOR(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_PATH_EDITOR, GimpPathEditor)) - - -GIMP_PATH_EDITOR_CLASS -#define GIMP_PATH_EDITOR_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_PATH_EDITOR, GimpPathEditorClass)) - - -GIMP_IS_PATH_EDITOR -#define GIMP_IS_PATH_EDITOR(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_PATH_EDITOR)) - - -GIMP_IS_PATH_EDITOR_CLASS -#define GIMP_IS_PATH_EDITOR_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_PATH_EDITOR)) - - -GimpPathEditor - - -GimpPathEditorClass - - -GimpPathEditor -struct GimpPathEditor -{ - GtkVBox vbox; - - GtkWidget *upper_hbox; - - GtkWidget *new_button; - GtkWidget *up_button; - GtkWidget *down_button; - GtkWidget *delete_button; - - GtkWidget *file_selection; - - GtkWidget *dir_list; - - GtkWidget *selected_item; - gint number_of_items; -}; - - -GimpPathEditorClass -struct GimpPathEditorClass -{ - GtkVBoxClass parent_class; - - void (* path_changed) (GimpPathEditor *gpe); -}; - - -gimp_path_editor_get_type -GtkType -void - - -gimp_path_editor_new -GtkWidget * -gchar *filesel_title,gchar *path - - -gimp_path_editor_get_path -gchar * -GimpPathEditor *gpe - GP_VERSION #define GP_VERSION 0x0003 @@ -2956,309 +2396,6 @@ GIOChannel *channel int GIOChannel *channel - -GIMP_TYPE_SIZE_ENTRY -#define GIMP_TYPE_SIZE_ENTRY (gimp_size_entry_get_type ()) - - -GIMP_SIZE_ENTRY -#define GIMP_SIZE_ENTRY(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_SIZE_ENTRY, GimpSizeEntry)) - - -GIMP_SIZE_ENTRY_CLASS -#define GIMP_SIZE_ENTRY_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_SIZE_ENTRY, GimpSizeEntryClass)) - - -GIMP_IS_SIZE_ENTRY -#define GIMP_IS_SIZE_ENTRY(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_SIZE_ENTRY)) - - -GIMP_IS_SIZE_ENTRY_CLASS -#define GIMP_IS_SIZE_ENTRY_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_SIZE_ENTRY)) - - -GimpSizeEntry - - -GimpSizeEntryClass - - -GimpSizeEntryUP -typedef enum -{ - GIMP_SIZE_ENTRY_UPDATE_NONE = 0, - GIMP_SIZE_ENTRY_UPDATE_SIZE = 1, - GIMP_SIZE_ENTRY_UPDATE_RESOLUTION = 2 -} GimpSizeEntryUP; - - -GimpSizeEntryField - - -GimpSizeEntry -struct GimpSizeEntry -{ - GtkTable table; - - GSList *fields; - gint number_of_fields; - - GtkWidget *unitmenu; - GUnit unit; - gboolean menu_show_pixels; - gboolean menu_show_percent; - - gboolean show_refval; - GimpSizeEntryUP update_policy; -}; - - -GimpSizeEntryClass -struct GimpSizeEntryClass -{ - GtkTableClass parent_class; - - void (* value_changed) (GimpSizeEntry *gse); - void (* refval_changed) (GimpSizeEntry *gse); - void (* unit_changed) (GimpSizeEntry *gse); -}; - - -gimp_size_entry_get_type -GtkType -void - - -gimp_size_entry_new -GtkWidget * -gint number_of_fields,GUnit unit,gchar *unit_format,gboolean menu_show_pixels,gboolean menu_show_percent,gboolean show_refval,gint spinbutton_usize,GimpSizeEntryUP update_policy - - -gimp_size_entry_add_field -void -GimpSizeEntry *gse,GtkSpinButton *value_spinbutton,GtkSpinButton *refval_spinbutton - - -gimp_size_entry_attach_label -void -GimpSizeEntry *gse,gchar *text,gint row,gint column,gfloat alignment - - -gimp_size_entry_set_resolution -void -GimpSizeEntry *gse,gint field,gdouble resolution,guint keep_size - - -gimp_size_entry_set_size -void -GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper - - -gimp_size_entry_set_value_boundaries -void -GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper - - -gimp_size_entry_get_value -gdouble -GimpSizeEntry *gse,gint field - - -gimp_size_entry_set_value -void -GimpSizeEntry *gse,gint field,gdouble value - - -gimp_size_entry_set_refval_boundaries -void -GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper - - -gimp_size_entry_set_refval_digits -void -GimpSizeEntry *gse,gint field,gint digits - - -gimp_size_entry_get_refval -gdouble -GimpSizeEntry *gse,gint field - - -gimp_size_entry_set_refval -void -GimpSizeEntry *gse,gint field,gdouble refval - - -gimp_size_entry_get_unit -GUnit -GimpSizeEntry *gse - - -gimp_size_entry_set_unit -void -GimpSizeEntry *gse,GUnit unit - - -gimp_size_entry_grab_focus -void -GimpSizeEntry *gse - - -GUnit -typedef enum -{ - UNIT_PIXEL = 0, - UNIT_INCH = 1, - UNIT_MM = 2, - UNIT_POINT = 3, - UNIT_PICA = 4, - UNIT_END = 5, /* never use UNIT_END but - * gimp_unit_get_number_of_units() instead - */ - - UNIT_PERCENT = 65536 /* this one does not really belong here but it's - * convenient to use the unit system for the - * various strings (symbol, singular, ...) - * - * you can only ask it for it's strings, asking for - * factor, digits or deletion_flag will produce - * an error. - */ -} GUnit; - - -gimp_unit_get_number_of_units -gint -void - - -gimp_unit_get_number_of_built_in_units -gint -void - - -gimp_unit_new -GUnit -gchar *identifier,gdouble factor,gint digits,gchar *symbol,gchar *abbreviation,gchar *singular,gchar *plural - - -gimp_unit_get_deletion_flag -guint -GUnit unit - - -gimp_unit_set_deletion_flag -void -GUnit unit,guint deletion_flag - - -gimp_unit_get_factor -gdouble -GUnit unit - - -gimp_unit_get_digits -gint -GUnit unit - - -gimp_unit_get_identifier -gchar * -GUnit unit - - -gimp_unit_get_symbol -gchar * -GUnit unit - - -gimp_unit_get_abbreviation -gchar * -GUnit unit - - -gimp_unit_get_singular -gchar * -GUnit unit - - -gimp_unit_get_plural -gchar * -GUnit unit - - -GIMP_TYPE_UNIT_MENU -#define GIMP_TYPE_UNIT_MENU (gimp_unit_menu_get_type ()) - - -GIMP_UNIT_MENU -#define GIMP_UNIT_MENU(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_UNIT_MENU, GimpUnitMenu)) - - -GIMP_UNIT_MENU_CLASS -#define GIMP_UNIT_MENU_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_UNIT_MENU, GimpUnitMenuClass)) - - -GIMP_IS_UNIT_MENU -#define GIMP_IS_UNIT_MENU(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_UNIT_MENU)) - - -GIMP_IS_UNIT_MENU_CLASS -#define GIMP_IS_UNIT_MENU_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_UNIT_MENU)) - - -GimpUnitMenu - - -GimpUnitMenuClass - - -GimpUnitMenu -struct GimpUnitMenu -{ - GtkOptionMenu optionmenu; - - /* private */ - GtkWidget *selection; - GtkWidget *clist; - - /* public */ - gchar *format; - GUnit unit; - - gboolean show_pixels; - gboolean show_percent; -}; - - -GimpUnitMenuClass -struct GimpUnitMenuClass -{ - GtkOptionMenuClass parent_class; - - void (* unit_changed) (GimpUnitMenu *gum); -}; - - -gimp_unit_menu_get_type -GtkType -void - - -gimp_unit_menu_new -GtkWidget * -gchar *format,GUnit unit,gboolean show_pixels,gboolean show_percent,gboolean show_custom - - -gimp_unit_menu_set_unit -void -GimpUnitMenu *gum,GUnit unit - - -gimp_unit_menu_get_unit -GUnit -GimpUnitMenu *gum - WireMessage @@ -3405,70 +2542,79 @@ GIOChannel *channel,gdouble *data,gint count int GIOChannel *channel,gchar **data,gint count - -GSerialType -typedef enum { - GSERIAL_END = 0, /* for internal use only */ - GSERIAL_INT8 = 1, - GSERIAL_INT16 = 2, - GSERIAL_INT32 = 3, - GSERIAL_FLOAT = 4, /* 32 bit IEEE fp value */ - GSERIAL_DOUBLE = 5, /* 64 bit IEEE fp value */ - GSERIAL_STRING = 101, - GSERIAL_INT8ARRAY = 102, - GSERIAL_INT16ARRAY = 103, - GSERIAL_INT32ARRAY = 104, - GSERIAL_FLOATARRAY = 105, - GSERIAL_DOUBLEARRAY = 106, - GSERIAL_LAST_TYPE = 107 -} GSerialType; - - -GSerialItem - - -GSerialDescription - + +GimpMatrix[3][3] +typedef double GimpMatrix[3][3]; + -g_new_serial_item -GSerialItem * -GSerialType type, gulong offset,gint32 length, gulong length_offset - - -g_serial_item -#define g_serial_item(type, struct_, member) \ - g_new_serial_item(type, G_STRUCT_OFFSET(struct_, member), 0, 0) - - -g_serial_array -#define g_serial_array(type, struct_, member, length) \ - g_new_serial_item(type, G_STRUCT_OFFSET(struct_, member), length, 0) - - -g_serial_vlen_array -#define g_serial_vlen_array(type, struct_, member, length_member) \ - g_new_serial_item(type, G_STRUCT_OFFSET(struct_, member), -1, \ - G_STRUCT_OFFSET(struct_, length_member)) - - -g_new_serial_description -GSerialDescription * -char *name, ... - - -g_free_serial_description +gimp_matrix_transform_point void -GSerialDescription * +GimpMatrix, double, double,double *, double * -g_serialize -long -GSerialDescription *d, void **output, void *struct_data +gimp_matrix_mult +void +GimpMatrix, GimpMatrix -g_deserialize -long -GSerialDescription *d, void *output, void *serial +gimp_matrix_identity +void +GimpMatrix + + +gimp_matrix_translate +void +GimpMatrix, double, double + + +gimp_matrix_scale +void +GimpMatrix, double, double + + +gimp_matrix_rotate +void +GimpMatrix, double + + +gimp_matrix_xshear +void +GimpMatrix, double + + +gimp_matrix_yshear +void +GimpMatrix, double + + +gimp_matrix_determinant +double +GimpMatrix + + +gimp_matrix_invert +void +GimpMatrix m, GimpMatrix m_inv + + +gimp_matrix_duplicate +void +GimpMatrix src, GimpMatrix target + + +gimp_matrix_is_diagonal +int +GimpMatrix m + + +gimp_matrix_is_identity +int +GimpMatrix m + + +gimp_matrix_is_simple +int +GimpMatrix m PARASITE_PERSISTENT @@ -3576,11 +2722,820 @@ struct Parasite * responsible for tracking byte order */ }; + +GSerialType +typedef enum { + GSERIAL_END = 0, /* for internal use only */ + GSERIAL_INT8 = 1, + GSERIAL_INT16 = 2, + GSERIAL_INT32 = 3, + GSERIAL_FLOAT = 4, /* 32 bit IEEE fp value */ + GSERIAL_DOUBLE = 5, /* 64 bit IEEE fp value */ + GSERIAL_STRING = 101, + GSERIAL_INT8ARRAY = 102, + GSERIAL_INT16ARRAY = 103, + GSERIAL_INT32ARRAY = 104, + GSERIAL_FLOATARRAY = 105, + GSERIAL_DOUBLEARRAY = 106, + GSERIAL_LAST_TYPE = 107 +} GSerialType; + + +GSerialItem + + +GSerialDescription + + +g_new_serial_item +GSerialItem * +GSerialType type, gulong offset,gint32 length, gulong length_offset + + +g_serial_item +#define g_serial_item(type, struct_, member) \ + g_new_serial_item(type, G_STRUCT_OFFSET(struct_, member), 0, 0) + + +g_serial_array +#define g_serial_array(type, struct_, member, length) \ + g_new_serial_item(type, G_STRUCT_OFFSET(struct_, member), length, 0) + + +g_serial_vlen_array +#define g_serial_vlen_array(type, struct_, member, length_member) \ + g_new_serial_item(type, G_STRUCT_OFFSET(struct_, member), -1, \ + G_STRUCT_OFFSET(struct_, length_member)) + + +g_new_serial_description +GSerialDescription * +char *name, ... + + +g_free_serial_description +void +GSerialDescription * + + +g_serialize +long +GSerialDescription *d, void **output, void *struct_data + + +g_deserialize +long +GSerialDescription *d, void *output, void *serial + + +GimpColorSelector_Callback +void +void *data, int r, int g, int b + + +GimpColorSelector_NewFunc +GtkWidget * +int r, int g, int b, + GimpColorSelector_Callback cb, + void *data, + void **selector_data + + +GimpColorSelector_FreeFunc +void +void *selector_data + + +GimpColorSelector_SetColorFunc +void +void *selector_data, + int r, int g, int b, + int set_current + + +GimpColorSelectorMethods + + +GimpColorSelectorMethods +struct GimpColorSelectorMethods { + GimpColorSelector_NewFunc new; + GimpColorSelector_FreeFunc free; + GimpColorSelector_SetColorFunc setcolor; +}; + + +GimpColorSelectorID +typedef void *GimpColorSelectorID; + + +gimp_color_selector_register +GimpColorSelectorID +const char *name,const char *help_page,GimpColorSelectorMethods *methods + + +gimp_color_selector_unregister +gboolean +GimpColorSelectorID id,void (*callback)(void *data),void *data + + +GimpModuleStatus +typedef enum { + GIMP_MODULE_OK, + GIMP_MODULE_UNLOAD +} GimpModuleStatus; + + +GimpModuleInfo +typedef struct { + void *shutdown_data; + const char *purpose; + const char *author; + const char *version; + const char *copyright; + const char *date; +} GimpModuleInfo; + + +GUnit +typedef enum +{ + UNIT_PIXEL = 0, + UNIT_INCH = 1, + UNIT_MM = 2, + UNIT_POINT = 3, + UNIT_PICA = 4, + UNIT_END = 5, /* never use UNIT_END but + * gimp_unit_get_number_of_units() instead + */ + + UNIT_PERCENT = 65536 /* this one does not really belong here but it's + * convenient to use the unit system for the + * various strings (symbol, singular, ...) + * + * you can only ask it for it's strings, asking for + * factor, digits or deletion_flag will produce + * an error. + */ +} GUnit; + + +gimp_unit_get_number_of_units +gint +void + + +gimp_unit_get_number_of_built_in_units +gint +void + + +gimp_unit_new +GUnit +gchar *identifier,gdouble factor,gint digits,gchar *symbol,gchar *abbreviation,gchar *singular,gchar *plural + + +gimp_unit_get_deletion_flag +guint +GUnit unit + + +gimp_unit_set_deletion_flag +void +GUnit unit,guint deletion_flag + + +gimp_unit_get_factor +gdouble +GUnit unit + + +gimp_unit_get_digits +gint +GUnit unit + + +gimp_unit_get_identifier +gchar * +GUnit unit + + +gimp_unit_get_symbol +gchar * +GUnit unit + + +gimp_unit_get_abbreviation +gchar * +GUnit unit + + +gimp_unit_get_singular +gchar * +GUnit unit + + +gimp_unit_get_plural +gchar * +GUnit unit + + +GIMP_TYPE_UNIT_MENU +#define GIMP_TYPE_UNIT_MENU (gimp_unit_menu_get_type ()) + + +GIMP_UNIT_MENU +#define GIMP_UNIT_MENU(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_UNIT_MENU, GimpUnitMenu)) + + +GIMP_UNIT_MENU_CLASS +#define GIMP_UNIT_MENU_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_UNIT_MENU, GimpUnitMenuClass)) + + +GIMP_IS_UNIT_MENU +#define GIMP_IS_UNIT_MENU(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_UNIT_MENU)) + + +GIMP_IS_UNIT_MENU_CLASS +#define GIMP_IS_UNIT_MENU_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_UNIT_MENU)) + + +GimpUnitMenu + + +GimpUnitMenuClass + + +GimpUnitMenu +struct GimpUnitMenu +{ + GtkOptionMenu optionmenu; + + /* private */ + GtkWidget *selection; + GtkWidget *clist; + + /* public */ + gchar *format; + GUnit unit; + + gboolean show_pixels; + gboolean show_percent; +}; + + +gimp_unit_menu_get_type +GtkType +void + + +gimp_unit_menu_new +GtkWidget * +gchar *format,GUnit unit,gboolean show_pixels,gboolean show_percent,gboolean show_custom + + +gimp_unit_menu_set_unit +void +GimpUnitMenu *gum,GUnit unit + + +gimp_unit_menu_get_unit +GUnit +GimpUnitMenu *gum + + +GIMP_TYPE_SIZE_ENTRY +#define GIMP_TYPE_SIZE_ENTRY (gimp_size_entry_get_type ()) + + +GIMP_SIZE_ENTRY +#define GIMP_SIZE_ENTRY(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_SIZE_ENTRY, GimpSizeEntry)) + + +GIMP_SIZE_ENTRY_CLASS +#define GIMP_SIZE_ENTRY_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_SIZE_ENTRY, GimpSizeEntryClass)) + + +GIMP_IS_SIZE_ENTRY +#define GIMP_IS_SIZE_ENTRY(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_SIZE_ENTRY)) + + +GIMP_IS_SIZE_ENTRY_CLASS +#define GIMP_IS_SIZE_ENTRY_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_SIZE_ENTRY)) + + +GimpSizeEntry + + +GimpSizeEntryClass + + +GimpSizeEntryUP +typedef enum +{ + GIMP_SIZE_ENTRY_UPDATE_NONE = 0, + GIMP_SIZE_ENTRY_UPDATE_SIZE = 1, + GIMP_SIZE_ENTRY_UPDATE_RESOLUTION = 2 +} GimpSizeEntryUP; + + +GimpSizeEntryField + + +GimpSizeEntry +struct GimpSizeEntry +{ + GtkTable table; + + GSList *fields; + gint number_of_fields; + + GtkWidget *unitmenu; + GUnit unit; + gboolean menu_show_pixels; + gboolean menu_show_percent; + + gboolean show_refval; + GimpSizeEntryUP update_policy; +}; + + +gimp_size_entry_get_type +GtkType +void + + +gimp_size_entry_new +GtkWidget * +gint number_of_fields,GUnit unit,gchar *unit_format,gboolean menu_show_pixels,gboolean menu_show_percent,gboolean show_refval,gint spinbutton_usize,GimpSizeEntryUP update_policy + + +gimp_size_entry_add_field +void +GimpSizeEntry *gse,GtkSpinButton *value_spinbutton,GtkSpinButton *refval_spinbutton + + +gimp_size_entry_attach_label +void +GimpSizeEntry *gse,gchar *text,gint row,gint column,gfloat alignment + + +gimp_size_entry_set_resolution +void +GimpSizeEntry *gse,gint field,gdouble resolution,guint keep_size + + +gimp_size_entry_set_size +void +GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper + + +gimp_size_entry_set_value_boundaries +void +GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper + + +gimp_size_entry_get_value +gdouble +GimpSizeEntry *gse,gint field + + +gimp_size_entry_set_value +void +GimpSizeEntry *gse,gint field,gdouble value + + +gimp_size_entry_set_refval_boundaries +void +GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper + + +gimp_size_entry_set_refval_digits +void +GimpSizeEntry *gse,gint field,gint digits + + +gimp_size_entry_get_refval +gdouble +GimpSizeEntry *gse,gint field + + +gimp_size_entry_set_refval +void +GimpSizeEntry *gse,gint field,gdouble refval + + +gimp_size_entry_get_unit +GUnit +GimpSizeEntry *gse + + +gimp_size_entry_set_unit +void +GimpSizeEntry *gse,GUnit unit + + +gimp_size_entry_grab_focus +void +GimpSizeEntry *gse + + +GIMP_TYPE_CHAIN_BUTTON +#define GIMP_TYPE_CHAIN_BUTTON (gimp_chain_button_get_type ()) + + +GIMP_CHAIN_BUTTON +#define GIMP_CHAIN_BUTTON(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_CHAIN_BUTTON, GimpChainButton)) + + +GIMP_CHAIN_BUTTON_CLASS +#define GIMP_CHAIN_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_CHAIN_BUTTON, GimpChainButtonClass)) + + +GIMP_IS_CHAIN_BUTTON +#define GIMP_IS_CHAIN_BUTTON(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_CHAIN_BUTTON)) + + +GIMP_IS_CHAIN_BUTTON_CLASS +#define GIMP_IS_CHAIN_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_CHAIN_BUTTON)) + + +GimpChainButton + + +GimpChainButtonClass + + +GimpChainPosition +typedef enum +{ + GIMP_CHAIN_TOP, + GIMP_CHAIN_LEFT, + GIMP_CHAIN_BOTTOM, + GIMP_CHAIN_RIGHT +} GimpChainPosition; + + +GimpChainButton +struct GimpChainButton +{ + GtkTable table; + + GimpChainPosition position; + GtkWidget *button; + GtkWidget *line1; + GtkWidget *line2; + GtkWidget *pixmap; + GdkPixmap *broken; + GdkBitmap *broken_mask; + GdkPixmap *chain; + GdkBitmap *chain_mask; + gboolean active; +}; + + +gimp_chain_button_get_type +GtkType +void + + +gimp_chain_button_new +GtkWidget * +GimpChainPosition position + + +gimp_chain_button_set_active +void +GimpChainButton *gcb,gboolean is_active + + +gimp_chain_button_get_active +gboolean +GimpChainButton *gcb + + +G_PI +#define G_PI 3.14159265358979323846 + + +G_PI_2 +#define G_PI_2 1.57079632679489661923 + + +G_PI_4 +#define G_PI_4 0.78539816339744830962 + + +G_SQRT2 +#define G_SQRT2 1.4142135623730951 + + +G_MAXRAND +#define G_MAXRAND G_MAXINT + + +G_MAXRAND +#define G_MAXRAND RAND_MAX + + +RINT +#define RINT(x) rint(x) + + +RINT +#define RINT(x) floor ((x) + 0.5) + + +ROUND +#define ROUND(x) ((int) ((x) + 0.5)) + + +SQR +#define SQR(x) ((x) * (x)) + + +MAX255 +#define MAX255(a) ((a) | (((a) & 256) - (((a) & 256) >> 8))) + + +CLAMP0255 +#define CLAMP0255(a) CLAMP(a,0,255) + + +gimp_directory +char * +void + + +gimp_personal_rc_file +char * +char *basename + + +gimp_data_directory +char * +void + + +gimp_gtkrc +char * +void + + +GimpColorDisplayInit +void +void + + +GimpColorDisplayNew +gpointer +int type + + +GimpColorDisplayClone +gpointer +gpointer cd_ID + + +GimpColorDisplayConvert +void +gpointer cd_ID, + guchar *buf, + int width, + int height, + int bpp, + int bpl + + +GimpColorDisplayDestroy +void +gpointer cd_ID + + +GimpColorDisplayFinalize +void +void + + +GimpColorDisplayLoadState +void +gpointer cd_ID, + Parasite *state + + +GimpColorDisplaySaveState +Parasite * +gpointer cd_ID + + +GimpColorDisplayConfigure +void +gpointer cd_ID, + GFunc ok_func, + gpointer ok_data, + GFunc cancel_func, + gpointer cancel_data + + +GimpColorDisplayConfigureCancel +void +gpointer cd_ID + + +GimpColorDisplayMethods + + +GimpColorDisplayMethods +struct GimpColorDisplayMethods +{ + GimpColorDisplayInit init; + GimpColorDisplayNew new; + GimpColorDisplayClone clone; + GimpColorDisplayConvert convert; + GimpColorDisplayDestroy destroy; + GimpColorDisplayFinalize finalize; + GimpColorDisplayLoadState load; + GimpColorDisplaySaveState save; + GimpColorDisplayConfigure configure; + GimpColorDisplayConfigureCancel cancel; +}; + + +gimp_color_display_register +gboolean +const char *name,GimpColorDisplayMethods *methods + + +gimp_color_display_unregister +gboolean +const char *name + + +GIMP_MIN_IMAGE_SIZE +#define GIMP_MIN_IMAGE_SIZE 1 + + +GIMP_MAX_IMAGE_SIZE +#define GIMP_MAX_IMAGE_SIZE 16777216 + + +GIMP_MIN_RESOLUTION +#define GIMP_MIN_RESOLUTION (1.0 / 65536.0) + + +GIMP_MAX_RESOLUTION +#define GIMP_MAX_RESOLUTION 65536.0 + + +GIMP_CHECK_SIZE +#define GIMP_CHECK_SIZE 8 + + +GIMP_CHECK_SIZE_SM +#define GIMP_CHECK_SIZE_SM 4 + + +GIMP_CHECK_DARK +#define GIMP_CHECK_DARK (1.0 / 3.0) + + +GIMP_CHECK_LIGHT +#define GIMP_CHECK_LIGHT (2.0 / 3.0) + + +GIMP_TYPE_FILE_SELECTION +#define GIMP_TYPE_FILE_SELECTION (gimp_file_selection_get_type ()) + + +GIMP_FILE_SELECTION +#define GIMP_FILE_SELECTION(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_FILE_SELECTION, GimpFileSelection)) + + +GIMP_FILE_SELECTION_CLASS +#define GIMP_FILE_SELECTION_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_FILE_SELECTION, GimpFileSelectionClass)) + + +GIMP_IS_FILE_SELECTION +#define GIMP_IS_FILE_SELECTION(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_FILE_SELECTION)) + + +GIMP_IS_FILE_SELECTION_CLASS +#define GIMP_IS_FILE_SELECTION_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_FILE_SELECTION)) + + +GimpFileSelection + + +GimpFileSelectionClass + + +GimpFileSelection +struct GimpFileSelection +{ + GtkVBox hbox; + + GtkWidget *file_exists; + GtkWidget *entry; + GtkWidget *browse_button; + + GtkWidget *file_selection; + + GdkPixmap *yes_pixmap; + GdkBitmap *yes_mask; + GdkPixmap *no_pixmap; + GdkBitmap *no_mask; + + gchar *title; + gboolean dir_only; + gboolean check_valid; +}; + + +gimp_file_selection_get_type +GtkType +void + + +gimp_file_selection_new +GtkWidget * +gchar *title,gchar *filename,gboolean dir_only,gboolean check_valid + + +gimp_file_selection_get_filename +gchar * +GimpFileSelection *gfs + + +gimp_file_selection_set_filename +void +GimpFileSelection *gfs,gchar *filename + + +GIMP_TYPE_PATH_EDITOR +#define GIMP_TYPE_PATH_EDITOR (gimp_path_editor_get_type ()) + + +GIMP_PATH_EDITOR +#define GIMP_PATH_EDITOR(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_PATH_EDITOR, GimpPathEditor)) + + +GIMP_PATH_EDITOR_CLASS +#define GIMP_PATH_EDITOR_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_PATH_EDITOR, GimpPathEditorClass)) + + +GIMP_IS_PATH_EDITOR +#define GIMP_IS_PATH_EDITOR(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_PATH_EDITOR)) + + +GIMP_IS_PATH_EDITOR_CLASS +#define GIMP_IS_PATH_EDITOR_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_PATH_EDITOR)) + + +GimpPathEditor + + +GimpPathEditorClass + + +GimpPathEditor +struct GimpPathEditor +{ + GtkVBox vbox; + + GtkWidget *upper_hbox; + + GtkWidget *new_button; + GtkWidget *up_button; + GtkWidget *down_button; + GtkWidget *delete_button; + + GtkWidget *file_selection; + + GtkWidget *dir_list; + + GtkWidget *selected_item; + gint number_of_items; +}; + + +gimp_path_editor_get_type +GtkType +void + + +gimp_path_editor_new +GtkWidget * +gchar *filesel_title,gchar *path + + +gimp_path_editor_get_path +gchar * +GimpPathEditor *gpe + PIXPIPE_MAXDIM #define PIXPIPE_MAXDIM 4 - + PixPipeParams typedef struct { gint step; @@ -3596,7 +3551,7 @@ typedef struct { gchar *selection[PIXPIPE_MAXDIM]; gboolean free_selection_string; } PixPipeParams; - + pixpipeparams_init void @@ -3816,15 +3771,6 @@ gint32*,gint32*,gchar*,gint GimpColorButtonClass - -GimpColorButtonClass -struct GimpColorButtonClass -{ - GtkButtonClass parent_class; - - void (* color_changed) (GimpColorButton *gcb); -}; - gimp_color_button_get_type GtkType @@ -4001,12 +3947,12 @@ GtkObject **adjustment,gfloat value,gfloat low gimp_scale_entry_new GtkObject * -GtkTable *table,gint column,gint row,gchar *text,gint scale_usize,gint spinbutton_usize,gfloat value,gfloat lower,gfloat upper,gfloat step_increment,gfloat page_increment,guint digits,gchar *tooltip,gchar *private_tip +GtkTable *table,gint column,gint row,gchar *text,gint scale_usize,gint spinbutton_usize,gfloat value,gfloat lower,gfloat upper,gfloat step_increment,gfloat page_increment,guint digits,gboolean constrain,gfloat unconstrained_lower,gfloat unconstrained_upper,gchar *tooltip,gchar *private_tip gimp_random_seed_new GtkWidget * -gint *seed,gint *use_time,gint time_true,gint time_false +gint *seed,GtkWidget **seed_spinbutton,gint *use_time,GtkWidget **time_button,gint time_true,gint time_false gimp_coordinates_new diff --git a/devel-docs/libgimp/tmpl/gimpwidgets.sgml b/devel-docs/libgimp/tmpl/gimpwidgets.sgml index 7129d0037d..12cdf8570b 100644 --- a/devel-docs/libgimp/tmpl/gimpwidgets.sgml +++ b/devel-docs/libgimp/tmpl/gimpwidgets.sgml @@ -96,6 +96,9 @@ gimpwidgets @step_increment: @page_increment: @digits: +@constrain: +@unconstrained_lower: +@unconstrained_upper: @tooltip: @private_tip: @Returns: @@ -107,7 +110,9 @@ gimpwidgets @seed: +@seed_spinbutton: @use_time: +@time_button: @time_true: @time_false: @Returns: