Tracker Miner Library Reference Manual: Thumbnailer management

## Thumbnailer management Thumbnailer management — Request the thumbnailer service creates or updates thumbnails. |

## Synopsis

    #include <libtracker-miner/tracker-miner.h>

    gboolean            tracker_thumbnailer_cleanup         (const gchar *uri_prefix);
    gboolean            tracker_thumbnailer_init            (void);
    gboolean            tracker_thumbnailer_move_add        (const gchar *from_uri,
                                                             const gchar *mime_type,
                                                             const gchar *to_uri);
    gboolean            tracker_thumbnailer_remove_add      (const gchar *uri,
                                                             const gchar *mime_type);
    void                tracker_thumbnailer_send            (void);
    void                tracker_thumbnailer_shutdown        (void);

## Description

This is a convenience API using D-Bus for creating and updating thumbnails for files being mined. It is also used to create thumbnails for album art found embedded in some medias.

This follows the thumbnailer specification: http://live.gnome.org/ThumbnailerSpec

## Details

### tracker_thumbnailer_cleanup ()

    gboolean            tracker_thumbnailer_cleanup         (const gchar *uri_prefix);

Tells thumbnailer to cleanup all thumbnails under `uri_prefix`.

`uri_prefix` : | URI prefix
Returns : | TRUE if successfully reported, FALSE otherwise.

Since 0.8

### tracker_thumbnailer_init ()

    gboolean            tracker_thumbnailer_init            (void);

Initializes the thumbnailer connection.

Returns : | TRUE if connection was successfully initialized, FALSE otherwise.

Since 0.8

### tracker_thumbnailer_move_add ()

    gboolean            tracker_thumbnailer_move_add        (const gchar *from_uri,
                                                             const gchar *mime_type,
                                                             const gchar *to_uri);

Adds a new request to tell the thumbnailer that `from_uri` was moved to `to_uri`. Stored requests can be sent with `tracker_thumbnailer_send()`.

`from_uri` : | URI of the file before the move
`mime_type` : | mime-type of the file
`to_uri` : | URI of the file after the move
Returns : | TRUE if successfully stored to be reported, FALSE otherwise.

Since 0.8

### tracker_thumbnailer_remove_add ()

    gboolean            tracker_thumbnailer_remove_add      (const gchar *uri,
                                                             const gchar *mime_type);

Adds a new request to tell the thumbnailer that `uri` was removed. Stored requests can be sent with `tracker_thumbnailer_send()`.

`uri` : | URI of the file
`mime_type` : | mime-type of the file
Returns : | TRUE if successfully stored to be reported, FALSE otherwise.

Since 0.8

### tracker_thumbnailer_send ()

    void                tracker_thumbnailer_send            (void);

Sends to the thumbnailer all stored requests.

Since 0.8

### tracker_thumbnailer_shutdown ()

    void                tracker_thumbnailer_shutdown        (void);

Shuts down the thumbnailer connection.

Since 0.8