/*
    Album Art plugin for DeaDBeeF
    Copyright (C) 2009-2011 Viktor Semykin <thesame.ml@gmail.com>
    Copyright (C) 2009-2013 Alexey Yakovenko <waker@users.sourceforge.net>

    This software is provided 'as-is', without any express or implied
    warranty.  In no event will the authors be held liable for any damages
    arising from the use of this software.

    Permission is granted to anyone to use this software for any purpose,
    including commercial applications, and to alter it and redistribute it
    freely, subject to the following restrictions:

    1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.

    2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.

    3. This notice may not be removed or altered from any source distribution.
*/
module deadbeef.artwork;

import deadbeef.deadbeef;

enum DDB_ARTWORK_VERSION = 3;

alias artwork_callback = void function(in char *fname, in char *artist, in char *album, void *user_data);

struct DB_artwork_plugin_t {
	DB_misc_t plugin;
	// returns filename of cached image, or NULL
	char* function(in char *fname, in char *artist, in char *album, int size, artwork_callback callback, void *user_data) get_album_art;

	// this has to be called to clear queue on exit, before caller terminates
	// `fast=1' means "don't wait, just flush queue"
	void function(int fast) reset;

	// returns path to default album art
	immutable char * function() get_default_cover;

	// synchronously get filename
	char* function(in char *fname, in char *artist, in char *album, int size) get_album_art_sync;

	// creates full path string for cache storage
	void function(char *path, int size, in char *album, in char *artist, int img_size) make_cache_path;

	// creates full path string for cache storage
	int function(char *path, int size, in char *fname, in char *album, in char *artist, int img_size) make_cache_path2;
}