musly.h

Go to the documentation of this file.

/* Copyright 2013-2014, Dominik Schnitzer <dominik@schnitzer.at>
 *
 * This file is part of Musly, a program for high performance music
 * similarity computation: http://www.musly.org/.
 *
 * This Source Code Form is subject to the terms of the Mozilla
 * Public License v. 2.0. If a copy of the MPL was not distributed
 * with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */

#ifndef MUSLY_H_
#define MUSLY_H_

#include <musly/musly_types.h>

#ifdef WIN32

  #define MUSLY_EXPORT __declspec(dllexport)
#else

  #define MUSLY_EXPORT __attribute__ ((visibility("default")))
#endif

#ifdef __cplusplus
extern "C"
{
#endif

MUSLY_EXPORT const char*
musly_version();


MUSLY_EXPORT void
musly_debug(
        int level);


MUSLY_EXPORT const char*
musly_jukebox_listmethods();


MUSLY_EXPORT const char*
musly_jukebox_listdecoders();


MUSLY_EXPORT const char*
musly_jukebox_aboutmethod(
        musly_jukebox* jukebox);


MUSLY_EXPORT musly_jukebox*
musly_jukebox_poweron(
        const char* method,
        const char* decoder);


MUSLY_EXPORT void
musly_jukebox_poweroff(
        musly_jukebox* jukebox);


MUSLY_EXPORT int
musly_jukebox_setmusicstyle(
        musly_jukebox* jukebox,
        musly_track** tracks,
        int num_tracks);


MUSLY_EXPORT int
musly_jukebox_addtracks(
        musly_jukebox* jukebox,
        musly_track** tracks,
        musly_trackid* trackids,
        int num_tracks);


MUSLY_EXPORT int
musly_jukebox_similarity(
        musly_jukebox* jukebox,
        musly_track* seed_track,
        musly_trackid seed_trackid,
        musly_track** tracks,
        musly_trackid* trackids,
        int num_tracks,
        float* similarities);


int
musly_jukebox_guessneighbors(
        musly_jukebox* jukebox,
        musly_trackid seed,
        musly_trackid* neighbors,
        int num_neighbors);


MUSLY_EXPORT musly_track*
musly_track_alloc(
        musly_jukebox* jukebox);


MUSLY_EXPORT void
musly_track_free(
        musly_track* track);


MUSLY_EXPORT int
musly_track_size(
        musly_jukebox* jukebox);


MUSLY_EXPORT int
musly_track_binsize(
        musly_jukebox* jukebox);


MUSLY_EXPORT int
musly_track_tobin(
        musly_jukebox* jukebox,
        musly_track* from_track,
        unsigned char* to_buffer);


MUSLY_EXPORT int
musly_track_frombin(
        musly_jukebox* jukebox,
        unsigned char* from_buffer,
        musly_track* to_track);


const char*
musly_track_tostr(
        musly_jukebox* jukebox,
        musly_track* from_track);


MUSLY_EXPORT int
musly_track_analyze_pcm(
        musly_jukebox* jukebox,
        float* mono_22khz_pcm,
        int length_pcm,
        musly_track* track);


MUSLY_EXPORT int
musly_track_analyze_audiofile(
        musly_jukebox* jukebox,
        const char* audiofile,
        int max_seconds,
        musly_track* track);

#ifdef __cplusplus
}
#endif

#endif // MUSLY_H_