| Entangle Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
struct EntanglePixbufLoader; struct EntanglePixbufLoaderClass; gboolean entangle_pixbuf_loader_is_ready (EntanglePixbufLoader *loader,EntangleImage *image); GdkPixbuf * entangle_pixbuf_loader_get_pixbuf (EntanglePixbufLoader *loader,EntangleImage *image); GExiv2Metadata * entangle_pixbuf_loader_get_metadata (EntanglePixbufLoader *loader,EntangleImage *image); gboolean entangle_pixbuf_loader_load (EntanglePixbufLoader *loader,EntangleImage *image); gboolean entangle_pixbuf_loader_unload (EntanglePixbufLoader *loader,EntangleImage *image); void entangle_pixbuf_loader_trigger_reload (EntanglePixbufLoader *loader); void entangle_pixbuf_loader_set_colour_transform (EntanglePixbufLoader *loader,EntangleColourProfileTransform *transform); EntangleColourProfileTransform * entangle_pixbuf_loader_get_colour_transform (EntanglePixbufLoader *loader); void entangle_pixbuf_loader_set_workers (EntanglePixbufLoader *loader,int count); int entangle_pixbuf_loader_get_workers (EntanglePixbufLoader *loader);
GObject +----EntanglePixbufLoader +----EntangleImageLoader +----EntangleThumbnailLoader
"colour-transform" EntangleColourProfileTransform* : Read / Write "with-metadata" gboolean : Read / Write / Construct Only "workers" gint : Read / Write / Construct Only
"metadata-loaded" :Run First"metadata-unloaded" :Run First"pixbuf-loaded" :Run First"pixbuf-unloaded" :Run First
struct EntanglePixbufLoaderClass {
GObjectClass parent_class;
void (*pixbuf_loaded)(EntanglePixbufLoader *loader, EntangleImage *image);
void (*metadata_loaded)(EntanglePixbufLoader *loader, EntangleImage *image);
void (*pixbuf_unloaded)(EntanglePixbufLoader *loader, EntangleImage *image);
void (*metadata_unloaded)(EntanglePixbufLoader *loader, EntangleImage *image);
GdkPixbuf *(*pixbuf_load)(EntanglePixbufLoader *loader, EntangleImage *image,
GExiv2Metadata **metadata);
};
gboolean entangle_pixbuf_loader_is_ready (EntanglePixbufLoader *loader,EntangleImage *image);
Determine if the image has completed loading. Normally it is better to wait for the 'pixbuf-loaded' or 'metadata-loaded' signals than to use this method. The return value of this method may be out of date if another thread concurrently requests unload of the image
|
the pixbuf loader |
|
the camera image |
Returns : |
a true value if the image is currently loaded |
GdkPixbuf * entangle_pixbuf_loader_get_pixbuf (EntanglePixbufLoader *loader,EntangleImage *image);
Get the loaded pixbuf for image, if any. If this is
called before the 'pixbuf-loaded' signal is emitted
then it will likely return NULL.
|
the pixbuf loader. [transfer none] |
|
the camera image. [transfer none] |
Returns : |
the pixbuf. [allow-none][transfer none] |
GExiv2Metadata * entangle_pixbuf_loader_get_metadata (EntanglePixbufLoader *loader,EntangleImage *image);
Get the loaded metadata for image, if any. If this is
called before the 'metadata-loaded' signal is emitted
then it will likely return NULL.
|
the pixbuf loader. [transfer none] |
|
the camera image. [transfer none] |
Returns : |
the metadata. [allow-none][transfer none] |
gboolean entangle_pixbuf_loader_load (EntanglePixbufLoader *loader,EntangleImage *image);
Request that loader have its pixbuf and metadata loaded.
The loading of the data may take place asynchronously
and the 'pixbuf-loaded' and 'metadata-loaded' signals
will be emitted when completed.
|
the pixbuf loader. [transfer none] |
|
the camera image. [transfer none] |
Returns : |
a true value if the image was queued for loading |
gboolean entangle_pixbuf_loader_unload (EntanglePixbufLoader *loader,EntangleImage *image);
Indicate that image is no longer required and can have its
pixbuf / metadata unloaded. The unloading of the data may
take place asynchronously and the 'pixbuf-unloaded' and
'metadata-unloaded' signals will be emitted when completed.
|
the pixbuf loader. [transfer none] |
|
the camera image. [transfer none] |
Returns : |
a true value if the image was unloaded |
void entangle_pixbuf_loader_trigger_reload
(EntanglePixbufLoader *loader);
Request a mass reload of the data associated with all images
|
the image loader |
void entangle_pixbuf_loader_set_colour_transform (EntanglePixbufLoader *loader,EntangleColourProfileTransform *transform);
Set the colour profile transform that will be applied when loading images. This will trigger a mass-reload of all existing images to update their colour profile
|
the pixbuf loader |
|
the new colour profile transform |
EntangleColourProfileTransform * entangle_pixbuf_loader_get_colour_transform
(EntanglePixbufLoader *loader);
Get the colour transform that will be applied when loading images
|
the pixbuf loader |
Returns : |
the colour profile transform. [allow-none][transfer none] |
void entangle_pixbuf_loader_set_workers (EntanglePixbufLoader *loader,int count);
Set the maximum number of worker threads for the pixbuf loader
|
the pixbuf loader |
|
the new limit on workers |
int entangle_pixbuf_loader_get_workers (EntanglePixbufLoader *loader);
Get the number of worker threads associated with the loader
|
the pixbuf loader |
Returns : |
the maximum number of worker threads |
"colour-transform" property"colour-transform" EntangleColourProfileTransform* : Read / Write
Colour profile transformation.
"with-metadata" property"with-metadata" gboolean : Read / Write / Construct Only
Load image metadata.
Default value: FALSE
"workers" property"workers" gint : Read / Write / Construct Only
Number of worker threads to load pixbufs.
Allowed values: [1,64]
Default value: 1
"metadata-loaded" signalvoid user_function (EntanglePixbufLoader *entanglepixbufloader,
EntangleImage *arg1,
gpointer user_data) : Run First
"metadata-unloaded" signalvoid user_function (EntanglePixbufLoader *entanglepixbufloader,
EntangleImage *arg1,
gpointer user_data) : Run First
"pixbuf-loaded" signalvoid user_function (EntanglePixbufLoader *entanglepixbufloader,
EntangleImage *arg1,
gpointer user_data) : Run First
"pixbuf-unloaded" signalvoid user_function (EntanglePixbufLoader *entanglepixbufloader,
EntangleImage *arg1,
gpointer user_data) : Run First