album_art.h

Go to the documentation of this file.

class NOVTABLE album_art_data : public service_base {
public:
    virtual const void * get_ptr() const = 0;
    virtual t_size get_size() const = 0;

    static bool equals(album_art_data const & v1, album_art_data const & v2) {
        const t_size s = v1.get_size();
        if (s != v2.get_size()) return false;
        return memcmp(v1.get_ptr(), v2.get_ptr(),s) == 0;
    }
    bool operator==(const album_art_data & other) const {return equals(*this,other);}
    bool operator!=(const album_art_data & other) const {return !equals(*this,other);}

    FB2K_MAKE_SERVICE_INTERFACE(album_art_data,service_base);
};

typedef service_ptr_t<album_art_data> album_art_data_ptr;

namespace album_art_ids {
    static const GUID cover_front = { 0xf1e66f4e, 0xfe09, 0x4b94, { 0x91, 0xa3, 0x67, 0xc2, 0x3e, 0xd1, 0x44, 0x5e } };
    static const GUID cover_back = { 0xcb552d19, 0x86d5, 0x434c, { 0xac, 0x77, 0xbb, 0x24, 0xed, 0x56, 0x7e, 0xe4 } };
    static const GUID disc = { 0x3dba9f36, 0xf928, 0x4fa4, { 0x87, 0x9c, 0xd3, 0x40, 0x47, 0x59, 0x58, 0x7e } };
    static const GUID icon = { 0x74cdf5b4, 0x7053, 0x4b3d, { 0x9a, 0x3c, 0x54, 0x69, 0xf5, 0x82, 0x6e, 0xec } };
    static const GUID artist = { 0x9a654042, 0xacd1, 0x43f7, { 0xbf, 0xcf, 0xd3, 0xec, 0xf, 0xfe, 0x40, 0xfa } };

};

PFC_DECLARE_EXCEPTION(exception_album_art_not_found,exception_io_not_found,"Attached picture not found");
PFC_DECLARE_EXCEPTION(exception_album_art_unsupported_entry,exception_io_data,"Unsupported attached picture entry");

PFC_DECLARE_EXCEPTION(exception_album_art_unsupported_format,exception_io_data,"Attached picture operations not supported for this file format");

class NOVTABLE album_art_extractor_instance : public service_base {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_extractor_instance,service_base);
public:
    virtual album_art_data_ptr query(const GUID & p_what,abort_callback & p_abort) = 0;

    bool query(const GUID & what, album_art_data::ptr & out, abort_callback & abort) {
        try { out = query(what, abort); return true; } catch(exception_album_art_not_found) { return false; }
    }
};

class NOVTABLE album_art_editor_instance : public album_art_extractor_instance {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_editor_instance,album_art_extractor_instance);
public:
    virtual void set(const GUID & p_what,album_art_data_ptr p_data,abort_callback & p_abort) = 0;

    virtual void remove(const GUID & p_what) = 0;

    virtual void commit(abort_callback & p_abort) = 0;
};

class NOVTABLE album_art_editor_instance_v2 : public album_art_editor_instance {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_editor_instance_v2, album_art_editor_instance);
public:
    virtual void remove_all() = 0;
};

typedef service_ptr_t<album_art_extractor_instance> album_art_extractor_instance_ptr;
typedef service_ptr_t<album_art_editor_instance> album_art_editor_instance_ptr;

class NOVTABLE album_art_extractor : public service_base {
public:
    virtual bool is_our_path(const char * p_path,const char * p_extension) = 0;
    
    virtual album_art_extractor_instance_ptr open(file_ptr p_filehint,const char * p_path,abort_callback & p_abort) = 0;

    static bool g_get_interface(service_ptr_t<album_art_extractor> & out,const char * path);
    static bool g_is_supported_path(const char * path);
    static album_art_extractor_instance_ptr g_open(file_ptr p_filehint,const char * p_path,abort_callback & p_abort);
    static album_art_extractor_instance_ptr g_open_allowempty(file_ptr p_filehint,const char * p_path,abort_callback & p_abort);

    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(album_art_extractor);
};

class NOVTABLE album_art_editor : public service_base {
public:
    virtual bool is_our_path(const char * p_path,const char * p_extension) = 0;

    virtual album_art_editor_instance_ptr open(file_ptr p_filehint,const char * p_path,abort_callback & p_abort) = 0;

    static bool g_get_interface(service_ptr_t<album_art_editor> & out,const char * path);
    static bool g_is_supported_path(const char * path);

    static album_art_editor_instance_ptr g_open(file_ptr p_filehint,const char * p_path,abort_callback & p_abort);

    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(album_art_editor);
};


class NOVTABLE tag_processor_album_art_utils : public service_base {
public:

    virtual album_art_extractor_instance_ptr open(file_ptr p_file,abort_callback & p_abort) = 0;

    virtual album_art_editor_instance_ptr edit(file_ptr p_file,abort_callback & p_abort) = 0;

    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(tag_processor_album_art_utils)
};


class NOVTABLE album_art_path_list : public service_base {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_path_list, service_base)
public:
    virtual const char * get_path(t_size index) const = 0;
    virtual t_size get_count() const = 0;
};

class NOVTABLE album_art_extractor_instance_v2 : public album_art_extractor_instance {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_extractor_instance_v2, album_art_extractor_instance)
public:
    virtual album_art_path_list::ptr query_paths(const GUID & p_what, abort_callback & p_abort) = 0;
};


class NOVTABLE album_art_manager_v2 : public service_base {
    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(album_art_manager_v2)
public:
    virtual album_art_extractor_instance_v2::ptr open(metadb_handle_list_cref items, pfc::list_base_const_t<GUID> const & ids, abort_callback & abort) = 0;
    
    virtual album_art_extractor_instance_v2::ptr open_stub(abort_callback & abort) = 0;
};


class NOVTABLE album_art_fallback : public service_base {
    FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(album_art_fallback)
public:
    virtual album_art_extractor_instance_v2::ptr open(metadb_handle_list_cref items, pfc::list_base_const_t<GUID> const & ids, abort_callback & abort) = 0;
};

class NOVTABLE album_art_manager_config : public service_base {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_manager_config, service_base)
public:
    virtual bool get_external_pattern(pfc::string_base & out, const GUID & type) = 0;
    virtual bool use_embedded_pictures() = 0;
    virtual bool use_fallbacks() = 0;
};

class NOVTABLE album_art_manager_v3 : public album_art_manager_v2 {
    FB2K_MAKE_SERVICE_INTERFACE(album_art_manager_v3, album_art_manager_v2)
public:
    virtual album_art_extractor_instance_v2::ptr open_v3(metadb_handle_list_cref items, pfc::list_base_const_t<GUID> const & ids, album_art_manager_config::ptr config, abort_callback & abort) = 0;
};