caa_c.h

Go to the documentation of this file.

/* --------------------------------------------------------------------------

   libcoverart - Client library to access MusicBrainz

   Copyright (C) 2012 Andrew Hawkins

   This file is part of libcoverart.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   libcoverart is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this library.  If not, see <http://www.gnu.org/licenses/>.

   THIS FILE IS AUTOMATICALLY GENERATED - DO NOT EDIT IT!

----------------------------------------------------------------------------*/



/*
    Things you should delete using the appropriate caa_xxx_delete() function:

    * The coverart object you create to do the actual work
    * The releaseinfo object returned from the caa_coverart_releaseinfo() function
    * Any image data returned from the caa_fetch_xxx functions
    * The return from any caa_xxx_clone() function

    Everything else remains managed by the library, and should not be deleted

    If in doubt, valgrind is a useful way to spot leaks or things being deleted
    when they shouldn't be.

*/

#ifndef _COVERART_MB_C_H
#define _COVERART_MB_C_H

#include "coverart/defines.h"

#ifdef __cplusplus
extern "C"
{
#endif
    

  typedef void *CaaCoverArt;
  typedef void *CaaImage;
  typedef void *CaaReleaseInfo;
  typedef void *CaaThumbnails;
  typedef void *CaaType;
  typedef void *CaaImageList;
  typedef void *CaaTypeList;

  void caa_coverart_delete(CaaCoverArt CoverArt);

  CaaCoverArt caa_coverart_clone(CaaCoverArt CoverArt);

  int caa_coverart_get_lasthttpcode(CaaCoverArt CoverArt);

  int caa_coverart_get_lasterrormessage(CaaCoverArt CoverArt, char *str, int len);

  int caa_coverart_get_version(CaaCoverArt CoverArt, char *str, int len);

/* --------------------------------------------------------------------------

   libcoverart - Client library to access MusicBrainz

   Copyright (C) 2012 Andrew Hawkins

   This file is part of libcoverart.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   libcoverart is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this library.  If not, see <http://www.gnu.org/licenses/>.

     $Id$

----------------------------------------------------------------------------*/

typedef void *CaaImageData;

    CaaCoverArt caa_coverart_new(const char *UserAgent);

    void caa_coverart_set_proxyhost(CaaCoverArt CoverArt, const char *ProxyHost);

    void caa_coverart_set_proxyport(CaaCoverArt CoverArt, int ProxyPort);

    void caa_coverart_set_proxyusername(CaaCoverArt CoverArt, const char *ProxyUserName);

    void caa_coverart_set_proxypassword(CaaCoverArt CoverArt, const char *ProxyPassword);

    CaaImageData caa_coverart_fetch_front(CaaCoverArt CoverArt, const char *ReleaseID);

    CaaImageData caa_coverart_fetch_back(CaaCoverArt CoverArt, const char *ReleaseID);

    typedef enum
    {
        eSize_Full=0,
        eSize_250=250,
        eSize_500=500
    } tImageSize;

    CaaImageData caa_coverart_fetch_image(CaaCoverArt CoverArt, const char *ReleaseID, const char *ImageID, tImageSize ImageSize);

    CaaReleaseInfo caa_coverart_releaseinfo(CaaCoverArt CoverArt, const char *ReleaseID);

    typedef enum
    {
            eCoverArt_Success=0,
            eCoverArt_ConnectionError,
            eCoverArt_Timeout,
            eCoverArt_AuthenticationError,
            eCoverArt_FetchError,
            eCoverArt_RequestError,
            eCoverArt_ResourceNotFound
    } tCoverArtResult;

    tCoverArtResult caa_coverart_get_lastresult(CaaCoverArt CoverArt);



  void caa_image_delete(CaaImage Image);

  CaaImage caa_image_clone(CaaImage Image);

  int caa_image_get_approved(CaaImage Image);

  int caa_image_get_back(CaaImage Image);

  int caa_image_get_comment(CaaImage Image, char *str, int len);

  int caa_image_get_edit(CaaImage Image);

  int caa_image_get_front(CaaImage Image);

  int caa_image_get_id(CaaImage Image, char *str, int len);

  int caa_image_get_image(CaaImage Image, char *str, int len);

  CaaThumbnails caa_image_get_thumbnails(CaaImage Image);

  CaaTypeList caa_image_get_typelist(CaaImage Image);

/* --------------------------------------------------------------------------

   libcoverart - Client library to access MusicBrainz

   Copyright (C) 2012 Andrew Hawkins

   This file is part of libcoverart.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   libcoverart is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this library.  If not, see <http://www.gnu.org/licenses/>.

     $Id$

----------------------------------------------------------------------------*/

  void caa_imagedata_delete(CaaImageData ImageData);

  CaaImageData caa_imagedata_clone(CaaImageData ImageData);

    int caa_imagedata_size(CaaImageData ImageData);

    unsigned char *caa_imagedata_data(CaaImageData ImageData);



  void caa_releaseinfo_delete(CaaReleaseInfo ReleaseInfo);

  CaaReleaseInfo caa_releaseinfo_clone(CaaReleaseInfo ReleaseInfo);

  int caa_releaseinfo_get_release(CaaReleaseInfo ReleaseInfo, char *str, int len);

  CaaImageList caa_releaseinfo_get_imagelist(CaaReleaseInfo ReleaseInfo);

  void caa_thumbnails_delete(CaaThumbnails Thumbnails);

  CaaThumbnails caa_thumbnails_clone(CaaThumbnails Thumbnails);

  int caa_thumbnails_get_large(CaaThumbnails Thumbnails, char *str, int len);

  int caa_thumbnails_get_small(CaaThumbnails Thumbnails, char *str, int len);

  void caa_type_delete(CaaType Type);

  CaaType caa_type_clone(CaaType Type);

  int caa_type_get_type(CaaType Type, char *str, int len);

  void caa_image_list_delete(CaaImageList List);

  int caa_image_list_size(CaaImageList List);

  CaaImage caa_image_list_item(CaaImageList List, int Item);

    int caa_image_list_get_count(CaaImageList List);

    int caa_image_list_get_offset(CaaImageList List);

  CaaImageList caa_image_list_clone(CaaImageList ImageList);

  void caa_type_list_delete(CaaTypeList List);

  int caa_type_list_size(CaaTypeList List);

  CaaType caa_type_list_item(CaaTypeList List, int Item);

    int caa_type_list_get_count(CaaTypeList List);

    int caa_type_list_get_offset(CaaTypeList List);

  CaaTypeList caa_type_list_clone(CaaTypeList TypeList);


#ifdef __cplusplus
}
#endif

#endif