Raw buffer representing content to save
Length of buffer
to use
MIME type for buffer
Output file name (not URI) to save converted content to
Save filename
to target
as JPEG format. The filename
may not be
a JPEG in the first place.
Original file name (not URI) to convert
Output file name (not URI) to save converted content to
Gets the files pointing to cache files suitable for storing the media
art provided by the artist,
title
and file
arguments. cache_file
will point to a location in the XDG user cache directory, meanwhile
local_file
will point to a cache file that resides in the same
filesystem than file
.
The file
provided is required if local_file
is to be returned.
The local_file
relates to a location on the media the local file
system or media storage it is found on, so for example, if you have
a mounted volume with MP3s on it in
local_file
will point to a URI that looks like
The cache_file
is very different to the local_file,
the
cache_file
relates to a symlink stored in XDG cache directories
for the user. A cache_file
would be expected to look like
When done, both #GFiles must be freed with g_object_unref() if non-%NULL.
the artist
the title
the prefix for cache files, for example "album"
a #GFile representing the actual media art or %NULL
This function calls media_art_get_file() by creating a #GFile for
uri
and passing the same arguments to media_art_get_file(). For more
details about what this function does, see media_art_get_file().
Get the path to media art for a given resource. Newly allocated
data returned in cache_path
and local_uri
must be freed with g_free().
the artist
the title
the prefix, for example "album"
the uri of the file or %NULL
This function facilitates a plugin's need to create any internal caches before anything else is done. This function must exist in each plugin and is called immediately after the plugin is loaded. Conversely, media_art_plugin_shutdown() is called before tear down of the plugin system or plugin itself.
The maximum width that an image is allowed to be
This function facilitates a plugin's need to clean up any internal caches. This function must exist in each plugin and is called immediately after the plugin is loaded. Conversely, media_art_plugin_init() is called after the plugin is loaded.
Removes media art for given album/artist provided.
artist the media art belongs to
album the media art belongs or %NULL
Strip a albumname or artistname string to prepare it for calculating the media art path with it. Certain characters and charactersets will be stripped and a newly allocated string returned which you must free with g_free().
This functions is used internally by media_art_get_file() and media_art_get_path(). You will not normally need to call it yourself.
This function provides the following features:
#
$^&*+=|/"'?~;original string
This function performs the same operation as media_art_file_to_jpeg() with the exception that a raw
buffer
can be used instead providinglen
and thebuffer_mime
too.