/* * Copyright (c) 1999, 2007, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */package com.sun.media.sound;import java.util.StringTokenizer;/** * Audio configuration class for exposing attributes specific to the platform or system. * * @author Kara Kytle * @author Florian Bomers */class Platform { // STATIC FINAL CHARACTERISTICS // native library we need to load private static final String libNameMain = "jsound"; private static final String libNameALSA = "jsoundalsa"; private static final String libNameDSound = "jsoundds"; // extra libs handling: bit flags for each different library public static final int LIB_MAIN = 1; public static final int LIB_ALSA = 2; public static final int LIB_DSOUND = 4; // bit field of the constants above. Willbe set in loadLibraries private static int loadedLibs = 0; // features: the main native library jsound reports which feature is // contained in which lib public static final int FEATURE_MIDIIO = 1; public static final int FEATURE_PORTS = 2; public static final int FEATURE_DIRECT_AUDIO = 3; // SYSTEM CHARACTERISTICS // vary according to hardware architecture // signed8 (use signed 8-bit values) is true for everything we support except for // the solaris sbpro card. // we'll leave it here as a variable; in the future we may need this in java. // wait, is that true? i'm not sure. i think solaris takes unsigned data? // $$kk: 03.11.99: i think solaris takes unsigned 8-bit or signed 16-bit data.... private static boolean signed8; // intel is little-endian. sparc is big-endian. private static boolean bigEndian; // this is the value of the "java.home" system property. i am looking it up here // for use when trying to load the soundbank, just so // that all the privileged code is localized in this file.... private static String javahome; // this is the value of the "java.class.path" system property private static String classpath; static { if(Printer.trace)Printer.trace(">> Platform.java: static"); loadLibraries(); readProperties(); } /** * Private constructor. */ private Platform() { } // METHODS FOR INTERNAL IMPLEMENTATION USE /** * Dummy method for forcing initialization. */ static void initialize() { if(Printer.trace)Printer.trace("Platform: initialize()"); } /** * Determine whether the system is big-endian. */ static boolean isBigEndian() { return bigEndian; } /** * Determine whether the system takes signed 8-bit data. */ static boolean isSigned8() { return signed8; } /** * Obtain javahome. * $$kk: 04.16.99: this is *bad*!! */ static String getJavahome() { return javahome; } /** * Obtain classpath. * $$jb: 04.21.99: this is *bad* too!! */ static String getClasspath() { return classpath; } // PRIVATE METHODS /** * Load the native library or libraries. */ private static void loadLibraries() { if(Printer.trace)Printer.trace(">>Platform.loadLibraries"); try { // load the main library JSSecurityManager.loadLibrary(libNameMain); // just for the heck of it... loadedLibs |= LIB_MAIN; } catch (SecurityException e) { if(Printer.err)Printer.err("Security exception loading main native library. JavaSound requires access to these resources."); throw(e); } // now try to load extra libs. They are defined at compile time in the Makefile // with the define EXTRA_SOUND_JNI_LIBS String extraLibs = nGetExtraLibraries(); // the string is the libraries, separated by white space StringTokenizer st = new StringTokenizer(extraLibs); while (st.hasMoreTokens()) { String lib = st.nextToken(); try { JSSecurityManager.loadLibrary(lib); if (lib.equals(libNameALSA)) { loadedLibs |= LIB_ALSA; if (Printer.debug) Printer.debug("Loaded ALSA lib successfully."); } else if (lib.equals(libNameDSound)) { loadedLibs |= LIB_DSOUND; if (Printer.debug) Printer.debug("Loaded DirectSound lib successfully."); } else { if (Printer.err) Printer.err("Loaded unknown lib '"+lib+"' successfully."); } } catch (Throwable t) { if (Printer.err) Printer.err("Couldn't load library "+lib+": "+t.toString()); } } } static boolean isMidiIOEnabled() { return isFeatureLibLoaded(FEATURE_MIDIIO); } static boolean isPortsEnabled() { return isFeatureLibLoaded(FEATURE_PORTS); } static boolean isDirectAudioEnabled() { return isFeatureLibLoaded(FEATURE_DIRECT_AUDIO); } private static boolean isFeatureLibLoaded(int feature) { if (Printer.debug) Printer.debug("Platform: Checking for feature "+feature+"..."); int requiredLib = nGetLibraryForFeature(feature); boolean isLoaded = (requiredLib != 0) && ((loadedLibs & requiredLib) == requiredLib); if (Printer.debug) Printer.debug(" ...needs library "+requiredLib+". Result is loaded="+isLoaded); return isLoaded; } // the following native methods are implemented in Platform.c private native static boolean nIsBigEndian(); private native static boolean nIsSigned8(); private native static String nGetExtraLibraries(); private native static int nGetLibraryForFeature(int feature); /** * Read the required system properties. */ private static void readProperties() { // $$fb 2002-03-06: implement check for endianness in native. Facilitates porting ! bigEndian = nIsBigEndian(); signed8 = nIsSigned8(); // Solaris on Sparc: signed, all others unsigned javahome = JSSecurityManager.getProperty("java.home"); classpath = JSSecurityManager.getProperty("java.class.path"); }}
/*
* Copyright (c) 1999, 2007, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.sun.media.sound;
import java.util.StringTokenizer;
/**
* Audio configuration class for exposing attributes specific to the platform or system.
*
* @author Kara Kytle
* @author Florian Bomers
*/
class Platform {
// STATIC FINAL CHARACTERISTICS
// native library we need to load
private static final String libNameMain = "jsound";
private static final String libNameALSA = "jsoundalsa";
private static final String libNameDSound = "jsoundds";
// extra libs handling: bit flags for each different library
public static final int LIB_MAIN = 1;
public static final int LIB_ALSA = 2;
public static final int LIB_DSOUND = 4;
// bit field of the constants above. Willbe set in loadLibraries
private static int loadedLibs = 0;
// features: the main native library jsound reports which feature is
// contained in which lib
public static final int FEATURE_MIDIIO = 1;
public static final int FEATURE_PORTS = 2;
public static final int FEATURE_DIRECT_AUDIO = 3;
// SYSTEM CHARACTERISTICS
// vary according to hardware architecture
// signed8 (use signed 8-bit values) is true for everything we support except for
// the solaris sbpro card.
// we'll leave it here as a variable; in the future we may need this in java.
// wait, is that true? i'm not sure. i think solaris takes unsigned data?
// $$kk: 03.11.99: i think solaris takes unsigned 8-bit or signed 16-bit data....
private static boolean signed8;
// intel is little-endian. sparc is big-endian.
private static boolean bigEndian;
// this is the value of the "java.home" system property. i am looking it up here
// for use when trying to load the soundbank, just so
// that all the privileged code is localized in this file....
private static String javahome;
// this is the value of the "java.class.path" system property
private static String classpath;
static {
if(Printer.trace)Printer.trace(">> Platform.java: static");
loadLibraries();
readProperties();
}
/**
* Private constructor.
*/
private Platform() {
}
// METHODS FOR INTERNAL IMPLEMENTATION USE
/**
* Dummy method for forcing initialization.
*/
static void initialize() {
if(Printer.trace)Printer.trace("Platform: initialize()");
}
/**
* Determine whether the system is big-endian.
*/
static boolean isBigEndian() {
return bigEndian;
}
/**
* Determine whether the system takes signed 8-bit data.
*/
static boolean isSigned8() {
return signed8;
}
/**
* Obtain javahome.
* $$kk: 04.16.99: this is *bad*!!
*/
static String getJavahome() {
return javahome;
}
/**
* Obtain classpath.
* $$jb: 04.21.99: this is *bad* too!!
*/
static String getClasspath() {
return classpath;
}
// PRIVATE METHODS
/**
* Load the native library or libraries.
*/
private static void loadLibraries() {
if(Printer.trace)Printer.trace(">>Platform.loadLibraries");
try {
// load the main library
JSSecurityManager.loadLibrary(libNameMain);
// just for the heck of it...
loadedLibs |= LIB_MAIN;
} catch (SecurityException e) {
if(Printer.err)Printer.err("Security exception loading main native library. JavaSound requires access to these resources.");
throw(e);
}
// now try to load extra libs. They are defined at compile time in the Makefile
// with the define EXTRA_SOUND_JNI_LIBS
String extraLibs = nGetExtraLibraries();
// the string is the libraries, separated by white space
StringTokenizer st = new StringTokenizer(extraLibs);
while (st.hasMoreTokens()) {
String lib = st.nextToken();
try {
JSSecurityManager.loadLibrary(lib);
if (lib.equals(libNameALSA)) {
loadedLibs |= LIB_ALSA;
if (Printer.debug) Printer.debug("Loaded ALSA lib successfully.");
} else if (lib.equals(libNameDSound)) {
loadedLibs |= LIB_DSOUND;
if (Printer.debug) Printer.debug("Loaded DirectSound lib successfully.");
} else {
if (Printer.err) Printer.err("Loaded unknown lib '"+lib+"' successfully.");
}
} catch (Throwable t) {
if (Printer.err) Printer.err("Couldn't load library "+lib+": "+t.toString());
}
}
}
static boolean isMidiIOEnabled() {
return isFeatureLibLoaded(FEATURE_MIDIIO);
}
static boolean isPortsEnabled() {
return isFeatureLibLoaded(FEATURE_PORTS);
}
static boolean isDirectAudioEnabled() {
return isFeatureLibLoaded(FEATURE_DIRECT_AUDIO);
}
private static boolean isFeatureLibLoaded(int feature) {
if (Printer.debug) Printer.debug("Platform: Checking for feature "+feature+"...");
int requiredLib = nGetLibraryForFeature(feature);
boolean isLoaded = (requiredLib != 0) && ((loadedLibs & requiredLib) == requiredLib);
if (Printer.debug) Printer.debug(" ...needs library "+requiredLib+". Result is loaded="+isLoaded);
return isLoaded;
}
// the following native methods are implemented in Platform.c
private native static boolean nIsBigEndian();
private native static boolean nIsSigned8();
private native static String nGetExtraLibraries();
private native static int nGetLibraryForFeature(int feature);
/**
* Read the required system properties.
*/
private static void readProperties() {
// $$fb 2002-03-06: implement check for endianness in native. Facilitates porting !
bigEndian = nIsBigEndian();
signed8 = nIsSigned8(); // Solaris on Sparc: signed, all others unsigned
javahome = JSSecurityManager.getProperty("java.home");
classpath = JSSecurityManager.getProperty("java.class.path");
}
}