![]() |
![]() |
![]() |
lomo Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
LomoEMArt; LomoEMArtClass; LomoEMArtClassPrivate; void lomo_em_art_cancel (LomoEMArt *art
,LomoEMArtSearch *search
); LomoEMArtBackend * lomo_em_art_class_add_backend (LomoEMArtClass *art_class
,gchar *name
,LomoEMArtBackendFunc search
,LomoEMArtBackendFunc cancel
,GDestroyNotify notify
,gpointer data
); void lomo_em_art_class_remove_backend (LomoEMArtClass *art_class
,LomoEMArtBackend *backend
); LomoEMArt * lomo_em_art_new (void
); LomoEMArtSearch * lomo_em_art_search (LomoEMArt *art
,LomoStream *stream
,LomoEMArtSearchCallback callback
,gpointer data
);
LomoEMArt is the way to discover art metadata for LomoStream. It provides a
pair of functions for start and cancel searches: lomo_em_art_search()
and
lomo_em_art_cancel()
. All instaces of LomoEMArt share the same backends, if one
LomoEMArtBackend is added all instances are able to use it.
Example 1. Basic flow for search
LomoEMArtSearch *_search; void callback(LomoEMArtSearch *search) { const gchar *art_uri = lomo_em_art_search_get_result(search); [do something with art_uri] *_search = NULL; } [your code] *_search = lomo_em_art_search(art, stream, callback, data); // Save search variable for eventual cancelation [your code]
void lomo_em_art_cancel (LomoEMArt *art
,LomoEMArtSearch *search
);
Cancels a running search, after cancel/stop any running backend, the
callback parameter from lomo_em_art_search()
will be called appling the same
rules.
|
An LomoEMArt |
|
A running LomoEMArtSearch |
LomoEMArtBackend * lomo_em_art_class_add_backend (LomoEMArtClass *art_class
,gchar *name
,LomoEMArtBackendFunc search
,LomoEMArtBackendFunc cancel
,GDestroyNotify notify
,gpointer data
);
Adds a new backend to LomoEMArtClass, see lomo_em_art_backend_new()
for details.
Note that this function adds backend to the class instead of the instance.
|
An LomoEMArtClass |
|
An (unique) name for the backend |
|
Search function |
|
Cancel function |
|
Notify function |
|
User data |
Returns : |
The newly created add added LomoEMArtBackend. [transfer none] |
void lomo_em_art_class_remove_backend (LomoEMArtClass *art_class
,LomoEMArtBackend *backend
);
Removes backend from all instances of art_class
. backend
should be the
object previously created with lomo_em_art_class_add_backend()
.
|
An LomoEMArtClass |
|
An LomoEMArtBackend. [transfer full] |
LomoEMArt * lomo_em_art_new (void
);
Creates a new LomoEMArt object
Returns : |
The LomoEMArt object |
LomoEMArtSearch * lomo_em_art_search (LomoEMArt *art
,LomoStream *stream
,LomoEMArtSearchCallback callback
,gpointer data
);
Search art data for stream
. callback
will be called after the search is
finished, callback
must NOT free any resource from LomoEMArt or related
objects
|
An LomoEMArt |
|
LomoStream |
|
Function to be called after search is finished |
|
User data for callback
|
Returns : |
LomoEMArtSearch object representing the search. [transfer none] |