![]() |
![]() |
![]() |
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