CoreMidi4J: CoreMidiDeviceProvider.cpp Source File

00001 
00017 #include "CoreMidiDeviceProvider.h"
00018 
00020 // Native functions for CoreMidiDeviceProvider
00022 
00023 /*
00024  * Gets the number of MIDI sources provided by the Core MIDI system
00025  *
00026  * Class:     com_coremidi4j_CoreMidiDeviceProvider
00027  * Method:    getNumberOfSources
00028  * Signature: ()I
00029  *
00030  * @param env           The JNI environment
00031  * @param obj   The reference to the java object instance that called this native method
00032  *
00033  * @return      The number of MIDI sources provided by the Core MIDI system
00034  *
00035  */
00036 
00037 JNIEXPORT jint JNICALL Java_uk_co_xfactorylibrarians_coremidi4j_CoreMidiDeviceProvider_getNumberOfSources(JNIEnv *env, jobject obj) {
00038 
00039   return (jint) MIDIGetNumberOfSources();
00040 
00041 }
00042 
00043 /*
00044  * Gets the number of MIDI destinations provided by the Core MIDI system
00045  *
00046  * Class:     com_coremidi4j_CoreMidiDeviceProvider
00047  * Method:    getNumberOfDestinations
00048  * Signature: ()I
00049  *
00050  * @param env    The JNI environment
00051  * @param obj    The reference to the java object instance that called this native method
00052  *
00053  * @return       The number of MIDI destinations provided by the Core MIDI system
00054  *
00055  */
00056 
00057 JNIEXPORT jint JNICALL Java_uk_co_xfactorylibrarians_coremidi4j_CoreMidiDeviceProvider_getNumberOfDestinations(JNIEnv *env, jobject obj) {
00058 
00059   return (jint) MIDIGetNumberOfDestinations();
00060 
00061 }
00062 
00063 /*
00064  * Gets the specified Core MIDI Source
00065  *
00066  * Class:     com_coremidi4j_CoreMidiDeviceProvider
00067  * Method:    getSource
00068  * Signature: (I)I
00069  *
00070  * @param env            The JNI environment
00071  * @param obj            The reference to the java object instance that called this native method
00072  * @param sourceIndex    The index of the MIDI source to get
00073  *
00074  * @return               The specified Core MIDI Source
00075  *
00076  * @throws               CoreMidiEXception if the source index is not valid
00077  *
00078  */
00079 
00080 JNIEXPORT jint JNICALL Java_uk_co_xfactorylibrarians_coremidi4j_CoreMidiDeviceProvider_getSource(JNIEnv *env, jobject obj, jint sourceIndex) {
00081 
00082   if ( sourceIndex >= MIDIGetNumberOfSources() ) {
00083 
00084     ThrowException(env,CFSTR("MIDIGetSource"),sourceIndex);
00085 
00086   }
00087 
00088   return MIDIGetSource(sourceIndex);
00089 
00090 }
00091 
00092 /*
00093  * Gets the specified Core MIDI Destination
00094  *
00095  * Class:     com_coremidi4j_CoreMidiDeviceProvider
00096  * Method:    getDestination
00097  * Signature: (I)I
00098  *
00099  * @param env                   The JNI environment
00100  * @param obj                   The reference to the java object instance that called this native method
00101  * @param destinationIndex      The index of the MIDI destination to get
00102  *
00103  * @return                      The specified Core MIDI Destination
00104  *
00105  * @throws                      CoreMidiEXception if the destination index is not valid
00106  *
00107  */
00108 
00109 JNIEXPORT jint JNICALL Java_uk_co_xfactorylibrarians_coremidi4j_CoreMidiDeviceProvider_getDestination(JNIEnv *env, jobject obj, jint destinationIndex) {
00110 
00111   if ( destinationIndex >= MIDIGetNumberOfDestinations() ) {
00112 
00113     ThrowException(env,CFSTR("MIDIGetDestination"), destinationIndex);
00114 
00115   }
00116 
00117   return MIDIGetDestination(destinationIndex);
00118 
00119 }
00120 
00121 /*
00122  * Gets the unique ID (UID) of the specified end point
00123  *
00124  * Class:     com_coremidi4j_CoreMidiDeviceProvider
00125  * Method:    getUniqueID
00126  * Signature: (I)I
00127  *
00128  * @param env                   The JNI environment
00129  * @param obj                   The reference to the java object instance that called this native method
00130  * @param endPointReference     The end point reference
00131  *
00132  * @return                      The unique ID (UID) of the specified end point
00133  *
00134  */
00135 
00136 JNIEXPORT jint JNICALL Java_uk_co_xfactorylibrarians_coremidi4j_CoreMidiDeviceProvider_getUniqueID(JNIEnv *env, jobject obj, jint endPointReference) {
00137 
00138   SInt32 uid = 0;
00139 
00140   MIDIObjectGetIntegerProperty(endPointReference, kMIDIPropertyUniqueID, &uid);
00141 
00142   return uid;
00143 
00144 }
00145 
00146 /*
00147  * Creates and gets a MidiDevice.Info object for the specified end point reference
00148  *
00149  * Class:     com_coremidi4j_CoreMidiDeviceProvider
00150  * Method:    getMidiDeviceInfo
00151  * Signature: (I)Ljavax/sound/midi/MidiDevice/Info;
00152  *
00153  * @param env                   The JNI environment
00154  * @param obj                   The reference to the java object instance that called this native method
00155  * @param endPointReference     The end point reference
00156  *
00157  * @return                      A MidiDevice.Info object for the specified end point reference
00158  *
00159  */
00160 
00161 JNIEXPORT jobject JNICALL Java_uk_co_xfactorylibrarians_coremidi4j_CoreMidiDeviceProvider_getMidiDeviceInfo(JNIEnv *env, jobject obj, jint endPointReference) {
00162 
00163   MIDIDeviceRef deviceReference       = NULL;
00164   CFStringRef   deviceName            = NULL;
00165   CFStringRef   deviceManufacturer    = NULL;
00166   CFStringRef   deviceModel           = NULL;
00167   CFStringRef   deviceOffline         = NULL;
00168   SInt32        deviceUniqueID        = 0;
00169   SInt32        deviceDriverVersion   = 0;
00170 
00171   MIDIEntityRef entityReference       = NULL;
00172   CFStringRef   entityName            = NULL;
00173   CFStringRef   entityManufacturer    = NULL;
00174   CFStringRef   entityModel           = NULL;
00175   CFStringRef   entityOffline         = NULL;
00176   SInt32        entityUniqueID        = 0;
00177   SInt32        entityDriverVersion   = 0;
00178 
00179   // End point reference is in method parameters
00180   CFStringRef   endpointName          = NULL;
00181   CFStringRef   endpointManufacturer  = NULL;
00182   CFStringRef   endpointModel         = NULL;
00183   CFStringRef   endpointOffline       = NULL;
00184   SInt32        endpointUniqueID      = 0;
00185   SInt32        endpointDriverVersion = 0;
00186   
00187   // Find the Java CoreMIDIDeviceInfo class and its constructor
00188   jclass javaClass = env->FindClass("uk/co/xfactorylibrarians/coremidi4j/CoreMidiDeviceInfo");
00189   jmethodID constructor = env->GetMethodID(javaClass, "<init>", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;IILjava/lang/String;IILjava/lang/String;II)V");
00190 
00191   // Get the endpoint properties
00192   MIDIObjectGetStringProperty (endPointReference, kMIDIPropertyName,          &endpointName);
00193   MIDIObjectGetStringProperty (endPointReference, kMIDIPropertyModel,         &endpointModel);
00194   MIDIObjectGetStringProperty (endPointReference, kMIDIPropertyManufacturer,  &endpointManufacturer);
00195   MIDIObjectGetStringProperty (endPointReference, kMIDIPropertyOffline,       &endpointOffline);
00196   MIDIObjectGetIntegerProperty(endPointReference, kMIDIPropertyUniqueID,      &endpointUniqueID);
00197   MIDIObjectGetIntegerProperty(endPointReference, kMIDIPropertyDriverVersion, &endpointDriverVersion);
00198 
00199   // Get the entity properties
00200   MIDIEndpointGetEntity(endPointReference, &entityReference);
00201 
00202   MIDIObjectGetStringProperty (entityReference, kMIDIPropertyName,          &entityName);
00203   MIDIObjectGetStringProperty (entityReference, kMIDIPropertyModel,         &entityModel);
00204   MIDIObjectGetStringProperty (entityReference, kMIDIPropertyManufacturer,  &entityManufacturer);
00205   MIDIObjectGetStringProperty (entityReference, kMIDIPropertyOffline,       &entityOffline);
00206   MIDIObjectGetIntegerProperty(entityReference, kMIDIPropertyUniqueID,      &entityUniqueID);
00207   MIDIObjectGetIntegerProperty(entityReference, kMIDIPropertyDriverVersion, &entityDriverVersion);
00208 
00209   // Get the device properties
00210   MIDIEntityGetDevice(entityReference, &deviceReference);
00211 
00212   MIDIObjectGetStringProperty (deviceReference, kMIDIPropertyName,          &deviceName); // Get this again in case our string build fails
00213   MIDIObjectGetStringProperty (deviceReference, kMIDIPropertyModel,         &deviceModel);
00214   MIDIObjectGetStringProperty (deviceReference, kMIDIPropertyManufacturer,  &deviceManufacturer);
00215   MIDIObjectGetStringProperty (deviceReference, kMIDIPropertyOffline,       &deviceOffline);
00216   MIDIObjectGetIntegerProperty(deviceReference, kMIDIPropertyUniqueID,      &deviceUniqueID);
00217   MIDIObjectGetIntegerProperty(deviceReference, kMIDIPropertyDriverVersion, &deviceDriverVersion);
00218   
00219   long numberOfEntities = MIDIDeviceGetNumberOfEntities(deviceReference);
00220   
00221   // Uncomment these lines if you wish to view information as received on the native side during debugging.
00222   //std::cout << "End Point " << std::endl;
00223   //std::cout << "  End Point Reference                  " << endPointReference << std::endl;
00224   //std::cout << "  End Point kMIDIPropertyName          " << CFStringGetCStringPtr (endpointName, CFStringGetSystemEncoding() ) << std::endl;
00225   //std::cout << "  End Point kMIDIPropertyModel         " << CFStringGetCStringPtr (endpointModel, CFStringGetSystemEncoding() ) << std::endl;
00226   //std::cout << "  End Point kMIDIPropertyManufacturer  " << CFStringGetCStringPtr (endpointManufacturer, CFStringGetSystemEncoding() ) << std::endl;
00227   //std::cout << "  End Point kMIDIPropertyOffline       " << endpointOffline << std::endl;
00228   //std::cout << "  End Point kMIDIPropertyUniqueID      " << endpointUniqueID << std::endl;
00229   //std::cout << "  End Point kMIDIPropertyDriverVersion " << endpointDriverVersion << std::endl;
00230   //std::cout << std::endl;
00231   //std::cout << "  Entity    Reference                  " << entityReference << std::endl;
00232   //std::cout << "  Entity    kMIDIPropertyName          " << CFStringGetCStringPtr (entityName, CFStringGetSystemEncoding() ) << std::endl;
00233   //std::cout << "  Entity    kMIDIPropertyModel         " << CFStringGetCStringPtr (entityModel, CFStringGetSystemEncoding() ) << std::endl;
00234   //std::cout << "  Entity    kMIDIPropertyManufacturer  " << CFStringGetCStringPtr (entityManufacturer, CFStringGetSystemEncoding() ) << std::endl;
00235   //std::cout << "  Entity    kMIDIPropertyOffline       " << entityOffline << std::endl;
00236   //std::cout << "  Entity    kMIDIPropertyUniqueID      " << entityUniqueID << std::endl;
00237   //std::cout << "  Entity    kMIDIPropertyDriverVersion " << entityDriverVersion << std::endl;
00238   //std::cout << std::endl;
00239   //std::cout << "  Device    Reference                  " << deviceReference << std::endl;
00240   //std::cout << "  Device    kMIDIPropertyName          " << CFStringGetCStringPtr (deviceName, CFStringGetSystemEncoding() ) << std::endl;
00241   //std::cout << "  Device    kMIDIPropertyModel         " << CFStringGetCStringPtr (deviceModel, CFStringGetSystemEncoding() ) << std::endl;
00242   //std::cout << "  Device    kMIDIPropertyManufacturer  " << CFStringGetCStringPtr (deviceManufacturer, CFStringGetSystemEncoding() ) << std::endl;
00243   //std::cout << "  Device    kMIDIPropertyOffline       " << deviceOffline << std::endl;
00244   //std::cout << "  Device    kMIDIPropertyUniqueID      " << deviceUniqueID << std::endl;
00245   //std::cout << "  Device    kMIDIPropertyDriverVersion " << deviceDriverVersion << std::endl;
00246   //std::cout << std::endl;
00247   //std::cout << "  Number of entities                   " << numberOfEntities << std::endl;
00248   //std::cout << std::endl;
00249 
00250   // Build the Device Info name. Add "CoreMIDI4J - " to the start of our device name if we can
00251   // And if the device has more than one entity then add the entity name
00252   CFMutableStringRef buildName = CFStringCreateMutable(NULL, 0);
00253   CFStringRef deviceInfoName;
00254   
00255   if ( buildName != NULL ) {
00256 
00257     CFStringAppend(buildName, deviceName);
00258     
00259     if ( numberOfEntities > 1 ) {
00260       
00261       CFStringAppend(buildName, CFSTR(" "));
00262       CFStringAppend(buildName, entityName);
00263       
00264     }
00265     
00266     // Overwrite the deviceName with our updated one
00267     deviceInfoName = CFStringCreateCopy(NULL, buildName);
00268 
00269     // And release the temporary string
00270     CFRelease(buildName);
00271 
00272   }
00273 
00274   const char *deviceInfoNamePtr         = CFStringGetCStringPtr ( deviceInfoName,     CFStringGetSystemEncoding() );
00275   const char *deviceInfoManufacturerPtr = CFStringGetCStringPtr ( deviceManufacturer, CFStringGetSystemEncoding() );
00276   const char *deviceInfoDescriptionPtr  = CFStringGetCStringPtr ( deviceModel,        CFStringGetSystemEncoding() );
00277   
00278   const char *deviceNamePtr             = CFStringGetCStringPtr ( deviceName,         CFStringGetSystemEncoding() );
00279   const char *entityNamePtr             = CFStringGetCStringPtr ( entityName,         CFStringGetSystemEncoding() );
00280   const char *endPointNamePtr           = CFStringGetCStringPtr ( endpointName,       CFStringGetSystemEncoding() );
00281   
00282   // TODO - Have seen reference that the device neds to be initialised to get the version. As we are still getting zero, force the string for now
00283   const char *deviceInfoVersion         = "Unknown Version";
00284   
00285   // Create the Java Object
00286   jobject info = env->NewObject(javaClass,
00287                                 constructor,
00288                                 env->NewStringUTF(( deviceInfoNamePtr         != NULL ) ? deviceInfoNamePtr         : "** Internal Error getting Device Name!"),
00289                                 env->NewStringUTF(( deviceInfoManufacturerPtr != NULL ) ? deviceInfoManufacturerPtr : "Unknown Manufacturer"),
00290                                 env->NewStringUTF(( deviceInfoDescriptionPtr  != NULL ) ? deviceInfoDescriptionPtr  : "Unknown Description"),
00291                                 env->NewStringUTF(deviceInfoVersion),
00292                                 env->NewStringUTF(deviceNamePtr),
00293                                 deviceReference,
00294                                 deviceUniqueID,
00295                                 env->NewStringUTF(entityNamePtr),
00296                                 entityReference,
00297                                 entityUniqueID,
00298                                 env->NewStringUTF(endPointNamePtr),
00299                                 endPointReference,
00300                                 endpointUniqueID);
00301 
00302   return info;
00303 
00304 }
00305