itdb_device_new ()

Itdb_Device *
itdb_device_new (void);

Creates a new Itdb_Device structure

Since: 0.4.0

itdb_device_free ()

void
itdb_device_free (Itdb_Device *device);

Frees memory used by device

Since: 0.4.0

itdb_device_set_mountpoint ()

void
itdb_device_set_mountpoint (Itdb_Device *device,
                            const gchar *mp);

Sets the mountpoint of device to mp and update the cached device information (in particular, re-read the SysInfo file)

Since: 0.4.0

itdb_device_supports_artwork ()

gboolean
itdb_device_supports_artwork (const Itdb_Device *device);

Indicates whether device can display artwork or not. When dealing with a non-art capable iPod, no artwork data will be written to the iPod so you can spare calls to the artwork handling methods.

Since: 0.5.0

itdb_device_supports_chapter_image ()

gboolean
itdb_device_supports_chapter_image (const Itdb_Device *device);

Indicates whether device can display chapter images or not.

Since: 0.7.2

itdb_device_supports_photo ()

gboolean
itdb_device_supports_photo (const Itdb_Device *device);

Indicates whether device can display photos or not.

Since: 0.5.0

itdb_device_supports_podcast ()

gboolean
itdb_device_supports_podcast (const Itdb_Device *device);

Indicates whether device can play podcasts or not.

Since: 0.7.2

itdb_device_supports_video ()

gboolean
itdb_device_supports_video (const Itdb_Device *device);

Indicates whether device can play videos or not.

Since: 0.7.0

itdb_device_get_ipod_info ()

const Itdb_IpodInfo *
itdb_device_get_ipod_info (const Itdb_Device *device);

Retrieve the Itdb_IpodInfo entry for this iPod

Since: 0.4.0

itdb_info_get_ipod_info_table ()

const Itdb_IpodInfo *
itdb_info_get_ipod_info_table (void);

Return a pointer to the start of valid iPod model descriptions, which is an array of Itdb_IpodInfo entries. This can be useful if you want to build a list of all iPod models known to the current libgpod.

Since: 0.4.0

itdb_info_get_ipod_generation_string ()

const gchar *
itdb_info_get_ipod_generation_string (Itdb_IpodGeneration generation);

Return the iPod's generic generation name, like "First Generation", "Mobile Phone"...

Since: 0.4.0

itdb_info_get_ipod_model_name_string ()

const gchar *
itdb_info_get_ipod_model_name_string (Itdb_IpodModel model);

Return the iPod's generic model name, like "Color", "Nano"...

Since: 0.4.0

itdb_device_read_sysinfo ()

gboolean
itdb_device_read_sysinfo (Itdb_Device *device);

Reads the SysInfo file and stores information in device->sysinfo for later use.

Since: 0.4.0

itdb_device_get_sysinfo ()

gchar *
itdb_device_get_sysinfo (const Itdb_Device *device,
                         const gchar *field);

Retrieve specified field from the SysInfo file.

Since: 0.4.0

itdb_device_set_sysinfo ()

void
itdb_device_set_sysinfo (Itdb_Device *device,
                         const gchar *field,
                         const gchar *value);

Set specified field. It can later be written to the iPod using itdb_device_write_sysinfo()

Since: 0.4.0

itdb_device_write_sysinfo ()

gboolean
itdb_device_write_sysinfo (Itdb_Device *device,
                           GError **error);

Fills the SysInfo file with information in device->sysinfo. Note: no directories are created if not already existent.

Since: 0.4.0

Itdb_Device

typedef struct {
    gchar *mountpoint;
    gint   musicdirs;
    guint  byte_order;
    GHashTable *sysinfo;
    SysInfoIpodProperties *sysinfo_extended;
    gboolean sysinfo_changed;
    gint timezone_shift;
    void *iphone_sync_context;
    int iphone_sync_nest_level;
} Itdb_Device;

Structure representing an iPod device

Since: 0.4.0

struct Itdb_IpodInfo

struct Itdb_IpodInfo {
    const gchar *model_number;
    const double capacity;
    const Itdb_IpodModel ipod_model;
    const Itdb_IpodGeneration ipod_generation;
    const guint musicdirs;
    /* reserved for future use */
    const gint32 reserved_int1;
    const gint32 reserved_int2;
    gconstpointer reserved1;
    gconstpointer reserved2;
};

Structure representing information about an iPod

Since: 0.4.0

enum Itdb_IpodGeneration

iPod generation information

See http://support.apple.com/kb/HT1353 and http://en.wikipedia.org/wiki/IPod for more details.

Since: 0.4.0

enum Itdb_IpodModel

iPod model information

Since: 0.4.0

Itdb_ArtworkFormat

typedef struct {
        gint format_id;
        gint width;
        gint height;
        ItdbThumbFormat format;
        gint32 padding;
        gboolean crop;
        gint rotation;
        guchar back_color[4];

        gint display_width;
        gboolean interlaced;
        gint color_adjustment;
        gdouble gamma;
        gint associated_format;
        gint row_bytes_alignment;
} Itdb_ArtworkFormat;

Structure representing the characteristics of the thumbnails to write to a given .ithmb file. The format of the structure is based on the way artwork formats are written to SysInfoExtended.