cddb_disc.h

Go to the documentation of this file.

/*
    $Id: cddb_disc.h,v 1.21 2005/07/09 08:32:48 airborne Exp $

    Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>

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

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA  02111-1307, USA.
*/

#ifndef CDDB_DISC_H
#define CDDB_DISC_H 1

#ifdef __cplusplus
    extern "C" {
#endif


#include <cddb/cddb_track.h>


#define FRAMES_PER_SECOND 75

#define FRAMES_TO_SECONDS(f) ((f) / FRAMES_PER_SECOND)

#define SECONDS_TO_FRAMES(s) ((s) * FRAMES_PER_SECOND)

typedef enum {
    CDDB_CAT_DATA = 0,          
    CDDB_CAT_FOLK,              
    CDDB_CAT_JAZZ,              
    CDDB_CAT_MISC,              
    CDDB_CAT_ROCK,              
    CDDB_CAT_COUNTRY,           
    CDDB_CAT_BLUES,             
    CDDB_CAT_NEWAGE,            
    CDDB_CAT_REGGAE,            
    CDDB_CAT_CLASSICAL,         
    CDDB_CAT_SOUNDTRACK,        
    CDDB_CAT_INVALID,           
    CDDB_CAT_LAST               
} cddb_cat_t;

extern const char *CDDB_CATEGORY[CDDB_CAT_LAST];

typedef struct cddb_disc_s cddb_disc_t;


/* --- construction / destruction */


cddb_disc_t *cddb_disc_new(void);

void cddb_disc_destroy(cddb_disc_t *disc);

cddb_disc_t *cddb_disc_clone(const cddb_disc_t *disc);


/* --- track manipulation */


void cddb_disc_add_track(cddb_disc_t *disc, cddb_track_t *track);

cddb_track_t *cddb_disc_get_track(const cddb_disc_t *disc, int track_no);

cddb_track_t *cddb_disc_get_track_first(cddb_disc_t *disc);

cddb_track_t *cddb_disc_get_track_next(cddb_disc_t *disc);


/* --- setters / getters --- */


unsigned int cddb_disc_get_discid(const cddb_disc_t *disc);

void cddb_disc_set_discid(cddb_disc_t *disc, unsigned int id);

cddb_cat_t cddb_disc_get_category(const cddb_disc_t *disc);

void cddb_disc_set_category(cddb_disc_t *disc, cddb_cat_t cat);

const char *cddb_disc_get_category_str(cddb_disc_t *disc);

void cddb_disc_set_category_str(cddb_disc_t *disc, const char *cat);

const char *cddb_disc_get_genre(const cddb_disc_t *disc);

void cddb_disc_set_genre(cddb_disc_t *disc, const char *genre);

unsigned int cddb_disc_get_length(const cddb_disc_t *disc);

void cddb_disc_set_length(cddb_disc_t *disc, unsigned int l);

unsigned int cddb_disc_get_year(const cddb_disc_t *disc);

void cddb_disc_set_year(cddb_disc_t *disc, unsigned int y);

int cddb_disc_get_track_count(const cddb_disc_t *disc);

const char *cddb_disc_get_title(const cddb_disc_t *disc);

void cddb_disc_set_title(cddb_disc_t *disc, const char *title);

void cddb_disc_append_title(cddb_disc_t *disc, const char *title);

const char *cddb_disc_get_artist(const cddb_disc_t *disc);

void cddb_disc_set_artist(cddb_disc_t *disc, const char *artist);

void cddb_disc_append_artist(cddb_disc_t *disc, const char *artist);

const char *cddb_disc_get_ext_data(const cddb_disc_t *disc);

void cddb_disc_set_ext_data(cddb_disc_t *disc, const char *ext_data);

void cddb_disc_append_ext_data(cddb_disc_t *disc, const char *ext_data);


/* --- miscellaneous */


void cddb_disc_copy(cddb_disc_t *dst, cddb_disc_t *src);

int cddb_disc_calc_discid(cddb_disc_t *disc);

void cddb_disc_print(cddb_disc_t *disc);


#ifdef __cplusplus
    }
#endif

#endif /* CDDB_DISC_H */

---