ipod.h

Go to the documentation of this file.

/*
 * ipod.h
 *
 * Duane Maxwell
 * (c) 2005 by Linspire Inc
 *
 * 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 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
 * MERCHANTIBILITY 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 Lesser 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 __IPOD_H__
#define __IPOD_H__

#include <ipod/ipod_file_utils.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef void *ipod_t; 
typedef void *ipod_track_t; 
typedef void *ipod_playlist_t; 
typedef void *ipod_track_item_t; 
typedef void *ipod_eq_preset_t; 
extern int ipod_discover(char ***path_array);

extern ipod_t ipod_new(const char *path);

extern void ipod_flush(ipod_t ipod);

extern void ipod_free(ipod_t ipod);

extern uint32_t ipod_version(ipod_t ipod);

extern void ipod_disk_usage(ipod_t ipod, uint64_t *total, uint64_t *free);

//-----------------------------------------------------------------
//
// Tracks
//
//-----------------------------------------------------------------

extern unsigned int ipod_track_count(ipod_t ipod);

extern ipod_track_t ipod_track_get_by_index(ipod_t ipod, unsigned int index);

extern ipod_track_t ipod_track_get_by_track_id(ipod_t ipod, uint32_t track_id);

extern void ipod_track_free(ipod_track_t track);

extern ipod_track_t ipod_track_add(ipod_t ipod);

extern ipod_track_t ipod_track_add_from(ipod_t ipod, const char *filePath);

extern void ipod_track_remove(ipod_track_t track);

extern char *ipod_track_get_text(ipod_track_t track,int tag,char *s);

extern void ipod_track_set_text(ipod_track_t track,int tag, const char *s);

extern int ipod_track_has_text(ipod_track_t track, int tag);

extern uint32_t ipod_track_get_attribute(ipod_track_t track, int tag);

extern void ipod_track_set_attribute(ipod_track_t track, int tag, uint32_t value);

extern void ipod_track_upload(ipod_track_t track,const char *filePath,ipod_file_transfer_func callback,void *userData);

extern void ipod_track_download(ipod_track_t track,const char *filePath,ipod_file_transfer_func callback,void *userData);

//-----------------------------------------------------------------
//
// Playlists
//
//-----------------------------------------------------------------

extern unsigned int ipod_playlist_count(ipod_t ipod);

extern ipod_playlist_t ipod_playlist_get_by_index(ipod_t ipod, unsigned int index);

extern void ipod_playlist_free(ipod_playlist_t playlist);

extern ipod_playlist_t ipod_playlist_add(ipod_t ipod);

extern void ipod_playlist_remove(ipod_playlist_t playlist);

extern char *ipod_playlist_get_text(ipod_playlist_t playlist,int tag,char *s);

extern void ipod_playlist_set_text(ipod_playlist_t playlist,int tag,const char *s);

extern int ipod_playlist_has_text(ipod_playlist_t playlist, int tag);

extern uint32_t ipod_playlist_get_attribute(ipod_playlist_t playlist, int tag);

extern void ipod_playlist_set_attribute(ipod_playlist_t playlist, int tag, uint32_t value);

//-----------------------------------------------------------------
//
// Track Items (references to Tracks in Playlists)
//
//-----------------------------------------------------------------

extern unsigned int ipod_track_item_count(ipod_playlist_t playlist);

extern ipod_track_item_t ipod_track_item_get_by_index(ipod_playlist_t playlist, unsigned int index);

extern void ipod_track_item_free(ipod_track_item_t trackItem);

extern ipod_track_item_t ipod_track_item_add(ipod_playlist_t playlist);

extern void ipod_track_item_remove(ipod_track_item_t trackItem);

extern uint32_t ipod_track_item_get_attribute(ipod_track_item_t trackItem, int tag);

extern void ipod_track_item_set_attribute(ipod_track_item_t trackItem, int tag, uint32_t value);

//-----------------------------------------------------------------
//
// EQ Presets
//
//-----------------------------------------------------------------

extern unsigned int ipod_eq_preset_count(ipod_t ipod);

extern ipod_eq_preset_t ipod_eq_preset_get_by_index(ipod_t ipod, unsigned int index);

extern void ipod_eq_preset_free(ipod_eq_preset_t preset);

extern ipod_eq_preset_t ipod_eq_preset_add(ipod_t ipod);

extern void ipod_eq_preset_remove(ipod_eq_preset_t preset);

extern char *ipod_eq_preset_get_text(ipod_eq_preset_t preset,int tag,char *s);

extern void ipod_eq_preset_set_text(ipod_eq_preset_t preset,int tag,const char *s);

extern int ipod_eq_preset_has_text(ipod_eq_preset_t preset, int tag);

extern int32_t ipod_eq_preset_get_attribute(ipod_eq_preset_t preset, int tag);

extern void ipod_eq_preset_set_attribute(ipod_eq_preset_t preset, int tag, int32_t value);

//
//
//-----------------------------------------------------------------
//
// Miscellaneous
//
//-----------------------------------------------------------------

extern void ipod_report(void);

#ifdef __cplusplus
};
#endif

#endif

---