1999-11-04 07:30:04 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
2000-09-07 18:17:06 +00:00
|
|
|
Module Interface
|
1999-11-04 07:30:04 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2001-11-14 22:39:35 +00:00
|
|
|
Extending &gdk-pixbuf;
|
1999-11-04 07:30:04 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-03-03 23:29:50 +00:00
|
|
|
<!-- ##### USER_FUNCTION ModuleFillVtableFunc ##### -->
|
|
|
|
<para>
|
2001-10-30 23:58:00 +00:00
|
|
|
Defines the type of the function used to set the vtable of a
|
|
|
|
#GdkPixbufModule when it is loaded.
|
2001-03-03 23:29:50 +00:00
|
|
|
</para>
|
|
|
|
|
2001-10-30 23:58:00 +00:00
|
|
|
@module: a #GdkPixbufModule.
|
2001-03-03 23:29:50 +00:00
|
|
|
|
|
|
|
|
2000-10-29 08:03:34 +00:00
|
|
|
<!-- ##### USER_FUNCTION ModulePreparedNotifyFunc ##### -->
|
|
|
|
<para>
|
2001-10-30 23:58:00 +00:00
|
|
|
Defines the type of the function that gets called once the initial
|
|
|
|
setup of @pixbuf is done.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
#GdkPixbufLoader uses a function of this type to emit the
|
|
|
|
"<link linkend="GdkPixbufLoader-area-prepared">area_prepared</link>"
|
|
|
|
signal.
|
2000-10-29 08:03:34 +00:00
|
|
|
</para>
|
|
|
|
|
2001-10-31 00:20:15 +00:00
|
|
|
@pixbuf: the #GdkPixbuf that is currently being loaded.
|
|
|
|
@anim: if an animation is being loaded, the #GdkPixbufAnimation, else %NULL.
|
2001-10-30 23:58:00 +00:00
|
|
|
@user_data: the loader.
|
2000-10-29 08:03:34 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### USER_FUNCTION ModuleUpdatedNotifyFunc ##### -->
|
|
|
|
<para>
|
2001-10-30 23:58:00 +00:00
|
|
|
Defines the type of the function that gets called every time a region
|
|
|
|
of @pixbuf is updated.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
#GdkPixbufLoader uses a function of this type to emit the
|
|
|
|
"<link linkend="GdkPixbufLoader-area-updated">area_updated</link>"
|
|
|
|
signal.
|
2000-10-29 08:03:34 +00:00
|
|
|
</para>
|
|
|
|
|
2001-10-31 00:20:15 +00:00
|
|
|
@pixbuf: the #GdkPixbuf that is currently being loaded.
|
2001-10-30 23:58:00 +00:00
|
|
|
@x: the X origin of the updated area.
|
|
|
|
@y: the Y origin of the updated area.
|
|
|
|
@width: the width of the updated area.
|
|
|
|
@height: the height of the updated area.
|
|
|
|
@user_data: the loader.
|
2000-10-29 08:03:34 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GdkPixbufModule ##### -->
|
|
|
|
<para>
|
2001-10-30 23:58:00 +00:00
|
|
|
A #GdkPixbufModule contains the necessary functions to load and save
|
|
|
|
images in a certain file format.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
A #GdkPixbufModule can be loaded dynamically from a #GModule.
|
|
|
|
Each loadable module must contain a #ModuleFillVtableFunc function named
|
2001-11-03 18:49:43 +00:00
|
|
|
<function>gdk_pixbuf__<replaceable>module_name</replaceable>_fill_vtable</function>.
|
2001-10-30 23:58:00 +00:00
|
|
|
It will get called when the module is loaded and must set the function
|
|
|
|
pointers of the #GdkPixbufModule.
|
2000-10-29 08:03:34 +00:00
|
|
|
</para>
|
|
|
|
|
2001-10-30 23:58:00 +00:00
|
|
|
@module_name: the name of the module, usually the same as the
|
|
|
|
usual file extension for images of this type, eg. "xpm", "jpeg" or "png".
|
|
|
|
@format_check: checks if the given data is the beginning of a valid image
|
|
|
|
in the format supported by the module.
|
2001-10-31 00:20:15 +00:00
|
|
|
@module: the loaded #GModule.
|
2001-10-30 23:58:00 +00:00
|
|
|
@load: loads an image from a file.
|
|
|
|
@load_xpm_data: loads an image from data in memory.
|
2001-10-31 00:20:15 +00:00
|
|
|
@begin_load: begins an incremental load.
|
2001-10-30 23:58:00 +00:00
|
|
|
@stop_load: stops an incremental load.
|
|
|
|
@load_increment: continues an incremental load.
|
|
|
|
@load_animation: loads an animation from a file.
|
|
|
|
@save: saves a #GdkPixbuf to a file.
|
2000-10-29 08:03:34 +00:00
|
|
|
|