manpagez: man pages & more
html files: libgimpmodule
Home | html | info | man

GimpModule

GimpModule — A GTypeModule subclass which implements module loading using GModule.

Signals

Object Hierarchy

    GObject
    ╰── GTypeModule
        ╰── GimpModule

Implemented Interfaces

GimpModule implements GTypePlugin.

Description

A GTypeModule subclass which implements module loading using GModule.

Functions

GimpModuleQueryFunc ()

const GimpModuleInfo *
(*GimpModuleQueryFunc) (GTypeModule *module);

The signature of the query function a loadable GIMP module must implement. In the module, the function must be called gimp_module_query().

GimpModule will copy the returned GimpModuleInfo struct, so the module doesn't need to keep these values around (however in most cases the module will just return a pointer to a constant structure).

Parameters

module

The GimpModule responsible for this loadable module.

 

Returns

The GimpModuleInfo struct describing the module.


GimpModuleRegisterFunc ()

gboolean
(*GimpModuleRegisterFunc) (GTypeModule *module);

The signature of the register function a loadable GIMP module must implement. In the module, the function must be called gimp_module_register().

When this function is called, the module should register all the types it implements with the passed module .

Parameters

module

The GimpModule responsible for this loadable module.

 

Returns

TRUE on success, FALSE otherwise.


gimp_module_new ()

GimpModule *
gimp_module_new (const gchar *filename,
                 gboolean load_inhibit,
                 gboolean verbose);

Creates a new GimpModule instance.

Parameters

filename

The filename of a loadable module.

 

load_inhibit

Pass TRUE to exclude this module from auto-loading.

 

verbose

Pass TRUE to enable debugging output.

 

Returns

The new GimpModule object.


gimp_module_modified ()

void
gimp_module_modified (GimpModule *module);

Emits the "modified" signal. Call it whenever you have modified the module manually (which you shouldn't do).

Parameters

module

A GimpModule.

 

gimp_module_query_module ()

gboolean
gimp_module_query_module (GimpModule *module);

Queries the module without actually registering any of the types it may implement. After successful query, the info field of the GimpModule struct will be available for further inspection.

Parameters

module

A GimpModule.

 

Returns

TRUE on success.


gimp_module_set_load_inhibit ()

void
gimp_module_set_load_inhibit (GimpModule *module,
                              gboolean load_inhibit);

Sets the load_inhibit property if the module. Emits "modified".

Parameters

module

A GimpModule.

 

load_inhibit

Pass TRUE to exclude this module from auto-loading.

 

gimp_module_state_name ()

const gchar *
gimp_module_state_name (GimpModuleState state);

Returns the translated textual representation of a GimpModuleState. The returned string must not be freed.

Parameters

state

A GimpModuleState.

 

Returns

The state 's name.


gimp_module_register_enum ()

GType
gimp_module_register_enum (GTypeModule *module,
                           const gchar *name,
                           const GEnumValue *const_static_values);

gimp_module_register_enum is deprecated and should not be used in newly-written code.

This function is deprecated! Use g_type_module_register_enum() instead.

Parameters

module

a module

 

name

the name of the new enum type

 

const_static_values

the enum values

 

Returns

a new enum GType


gimp_module_info_new ()

GimpModuleInfo *
gimp_module_info_new (guint32 abi_version,
                      const gchar *purpose,
                      const gchar *author,
                      const gchar *version,
                      const gchar *copyright,
                      const gchar *date);

Creates a newly allocated GimpModuleInfo struct.

Parameters

abi_version

The GIMP_MODULE_ABI_VERSION the module was compiled against.

 

purpose

The module's general purpose.

 

author

The module's author.

 

version

The module's version.

 

copyright

The module's copyright.

 

date

The module's release date.

 

Returns

The new GimpModuleInfo struct.


gimp_module_info_copy ()

GimpModuleInfo *
gimp_module_info_copy (const GimpModuleInfo *info);

Copies a GimpModuleInfo struct.

Parameters

info

The GimpModuleInfo struct to copy.

 

Returns

The new copy.


gimp_module_info_free ()

void
gimp_module_info_free (GimpModuleInfo *info);

Frees the passed GimpModuleInfo.

Parameters

info

The GimpModuleInfo struct to free

 

gimp_module_error_quark ()

GQuark
gimp_module_error_quark (void);

This function is never called directly. Use GIMP_MODULE_ERROR() instead.

Returns

the GQuark that defines the GIMP module error domain.

Since: 2.8

Types and Values

GimpModule

typedef struct {
  gchar           *filename;     /* path to the module                       */
  gboolean         verbose;      /* verbose error reporting                  */
  GimpModuleState  state;        /* what's happened to the module            */
  gboolean         on_disk;      /* TRUE if file still exists                */
  gboolean         load_inhibit; /* user requests not to load at boot time   */

  /* stuff from now on may be NULL depending on the state the module is in   */
  GimpModuleInfo  *info;         /* returned values from module_query        */
  gchar           *last_module_error;
} GimpModule;

GimpModule is a generic mechanism to dynamically load modules into GIMP. It is a GTypeModule subclass, implementing module loading using GModule. GimpModule does not know which functionality is implemented by the modules, it just provides a framework to get arbitrary GType implementations loaded from disk.


GimpModuleInfo

typedef struct {
  guint32  abi_version;
  gchar   *purpose;
  gchar   *author;
  gchar   *version;
  gchar   *copyright;
  gchar   *date;
} GimpModuleInfo;

This structure contains information about a loadable module.

Members

guint32 abi_version;

The GIMP_MODULE_ABI_VERSION the module was compiled against.

 

gchar *purpose;

The module's general purpose.

 

gchar *author;

The module's author.

 

gchar *version;

The module's version.

 

gchar *copyright;

The module's copyright.

 

gchar *date;

The module's release date.

 

enum GimpModuleState

The possible states a GimpModule can be in.

Members

GIMP_MODULE_STATE_ERROR

Missing gimp_module_register() function or other error.

 

GIMP_MODULE_STATE_LOADED

An instance of a type implemented by this module is allocated.

 

GIMP_MODULE_STATE_LOAD_FAILED

gimp_module_register() returned FALSE.

 

GIMP_MODULE_STATE_NOT_LOADED

There are no instances allocated of types implemented by this module.

 

GIMP_MODULE_ERROR

#define GIMP_MODULE_ERROR (gimp_module_error_quark ())

enum GimpModuleError

Types of errors returned by modules

Members

GIMP_MODULE_FAILED

Generic error condition

 

GIMP_MODULE_ABI_VERSION

#define GIMP_MODULE_ABI_VERSION 0x0004

The version of the module system's ABI. Modules put this value into GimpModuleInfo's abi_version field so the code loading the modules can check if it was compiled against the same module ABI the modules are compiled against.

GIMP_MODULE_ABI_VERSION is incremented each time one of the following changes:


GIMP_MODULE_PARAM_SERIALIZE

#define GIMP_MODULE_PARAM_SERIALIZE (1 << (0 + G_PARAM_USER_SHIFT))

GIMP_MODULE_PARAM_SERIALIZE is deprecated and should not be used in newly-written code.

Signal Details

The “modified” signal

void
user_function (GimpModule *gimpmodule,
               gpointer    user_data)

Flags: Run First

See Also

GModule, GTypeModule

© manpagez.com 2000-2024
Individual documents may contain additional copyright information.