/*
 * plugins.h
 * Copyright 2010-2012 John Lindgren
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice,
 *    this list of conditions, and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions, and the following disclaimer in the documentation
 *    provided with the distribution.
 *
 * This software is provided "as is" and without any warranty, express or
 * implied. In no event shall the authors be liable for any damages arising from
 * the use of this software.
 */

#ifndef LIBAUDCORE_PLUGINS_H
#define LIBAUDCORE_PLUGINS_H

#include <libaudcore/index.h>

enum class PluginType
{
    Transport,
    Playlist,
    Input,
    Effect,
    Output,
    Vis,
    General,
    Iface,
    count
};

class PluginHandle;

/* CAUTION: These functions are not thread safe. */

PluginHandle * aud_plugin_get_current(PluginType type);
bool aud_plugin_get_enabled(PluginHandle * plugin);
bool aud_plugin_enable(PluginHandle * plugin, bool enable);

int aud_plugin_send_message(PluginHandle * plugin, const char * code,
                            const void * data, int size);
void *
aud_plugin_get_gtk_widget(PluginHandle * plugin);       // returns (GtkWidget *)
void * aud_plugin_get_qt_widget(PluginHandle * plugin); // return (QWidget *)

PluginType aud_plugin_get_type(PluginHandle * plugin);
const char * aud_plugin_get_basename(PluginHandle * plugin);
PluginHandle * aud_plugin_lookup_basename(const char * basename);

const void * aud_plugin_get_header(PluginHandle * plugin);
PluginHandle * aud_plugin_by_header(const void * header);

const Index<PluginHandle *> & aud_plugin_list(PluginType type);
const Index<PluginHandle *> & aud_plugin_list_sorted(PluginType type);

const char * aud_plugin_get_name(PluginHandle * plugin);
bool aud_plugin_has_about(PluginHandle * plugin);
bool aud_plugin_has_configure(PluginHandle * plugin);

/* returns true to continue watching, false to stop */
typedef bool (*PluginWatchFunc)(PluginHandle * plugin, void * data);

void aud_plugin_add_watch(PluginHandle * plugin, PluginWatchFunc func,
                          void * data);
void aud_plugin_remove_watch(PluginHandle * plugin, PluginWatchFunc func,
                             void * data);

Index<const char *> aud_plugin_get_supported_extensions();
Index<const char *> aud_plugin_get_supported_mime_types();

#endif
