/*

 * 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");

    }

}