rtmidi_c.h

Go to the documentation of this file.

/************************************************************************/
/************************************************************************/
 
#include <stdbool.h>
#include <stddef.h>
#ifndef RTMIDI_C_H
#define RTMIDI_C_H
 
#if defined(RTMIDI_EXPORT)
#if defined _WIN32 || defined __CYGWIN__
#define RTMIDIAPI __declspec(dllexport)
#else
#define RTMIDIAPI __attribute__((visibility("default")))
#endif
#else
#define RTMIDIAPI //__declspec(dllimport)
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct RtMidiWrapper {
    void* ptr;
    void* data;
 
    bool  ok;
 
    const char* msg;
};
 
typedef struct RtMidiWrapper* RtMidiPtr;
 
typedef struct RtMidiWrapper* RtMidiInPtr;
 
typedef struct RtMidiWrapper* RtMidiOutPtr;
 
enum RtMidiApi {
    RTMIDI_API_UNSPECIFIED,    
    RTMIDI_API_MACOSX_CORE,    
    RTMIDI_API_LINUX_ALSA,     
    RTMIDI_API_UNIX_JACK,      
    RTMIDI_API_WINDOWS_MM,     
    RTMIDI_API_RTMIDI_DUMMY,   
    RTMIDI_API_WEB_MIDI_API,   
    RTMIDI_API_WINDOWS_UWP,    
    RTMIDI_API_ANDROID,        
    RTMIDI_API_NUM             
};
 
enum RtMidiErrorType {
  RTMIDI_ERROR_WARNING,           
  RTMIDI_ERROR_DEBUG_WARNING,     
  RTMIDI_ERROR_UNSPECIFIED,       
  RTMIDI_ERROR_NO_DEVICES_FOUND,  
  RTMIDI_ERROR_INVALID_DEVICE,    
  RTMIDI_ERROR_MEMORY_ERROR,      
  RTMIDI_ERROR_INVALID_PARAMETER, 
  RTMIDI_ERROR_INVALID_USE,       
  RTMIDI_ERROR_DRIVER_ERROR,      
  RTMIDI_ERROR_SYSTEM_ERROR,      
  RTMIDI_ERROR_THREAD_ERROR       
};
 
typedef void(* RtMidiCCallback) (double timeStamp, const unsigned char* message,
                                 size_t messageSize, void *userData);
 
 
/* RtMidi API */
 
RTMIDIAPI const char* rtmidi_get_version();
 
RTMIDIAPI int rtmidi_get_compiled_api (enum RtMidiApi *apis, unsigned int apis_size);
 
RTMIDIAPI const char *rtmidi_api_name(enum RtMidiApi api);
 
RTMIDIAPI const char *rtmidi_api_display_name(enum RtMidiApi api);
 
RTMIDIAPI enum RtMidiApi rtmidi_compiled_api_by_name(const char *name);
 
RTMIDIAPI void rtmidi_error (enum RtMidiErrorType type, const char* errorString);
 
RTMIDIAPI void rtmidi_open_port (RtMidiPtr device, unsigned int portNumber, const char *portName);
 
RTMIDIAPI void rtmidi_open_virtual_port (RtMidiPtr device, const char *portName);
 
RTMIDIAPI void rtmidi_close_port (RtMidiPtr device);
 
RTMIDIAPI unsigned int rtmidi_get_port_count (RtMidiPtr device);
 
RTMIDIAPI int rtmidi_get_port_name (RtMidiPtr device, unsigned int portNumber, char * bufOut, int * bufLen);
 
/* RtMidiIn API */
 
RTMIDIAPI RtMidiInPtr rtmidi_in_create_default (void);
 
RTMIDIAPI RtMidiInPtr rtmidi_in_create (enum RtMidiApi api, const char *clientName, unsigned int queueSizeLimit);
 
RTMIDIAPI void rtmidi_in_free (RtMidiInPtr device);
 
RTMIDIAPI enum RtMidiApi rtmidi_in_get_current_api (RtMidiPtr device);
 
RTMIDIAPI void rtmidi_in_set_callback (RtMidiInPtr device, RtMidiCCallback callback, void *userData);
 
RTMIDIAPI void rtmidi_in_cancel_callback (RtMidiInPtr device);
 
RTMIDIAPI void rtmidi_in_ignore_types (RtMidiInPtr device, bool midiSysex, bool midiTime, bool midiSense);
 
RTMIDIAPI double rtmidi_in_get_message (RtMidiInPtr device, unsigned char *message, size_t *size);
 
/* RtMidiOut API */
 
RTMIDIAPI RtMidiOutPtr rtmidi_out_create_default (void);
 
RTMIDIAPI RtMidiOutPtr rtmidi_out_create (enum RtMidiApi api, const char *clientName);
 
RTMIDIAPI void rtmidi_out_free (RtMidiOutPtr device);
 
RTMIDIAPI enum RtMidiApi rtmidi_out_get_current_api (RtMidiPtr device);
 
RTMIDIAPI int rtmidi_out_send_message (RtMidiOutPtr device, const unsigned char *message, int length);
 
 
#ifdef __cplusplus
}
#endif
#endif