jdk-sandbox: src/java.desktop/share/classes/com/sun/media/sound/Platform.java@148e29df1644 (annotated)

2 90ce3da70b43 Initial load duke parents: diff changeset	1	/*
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	2	* Copyright (c) 1999, 2018, Oracle and/or its affiliates. All rights reserved.
2 90ce3da70b43 Initial load duke parents: diff changeset	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90ce3da70b43 Initial load duke parents: diff changeset	4	*
90ce3da70b43 Initial load duke parents: diff changeset	5	* This code is free software; you can redistribute it and/or modify it
90ce3da70b43 Initial load duke parents: diff changeset	6	* under the terms of the GNU General Public License version 2 only, as
5506 202f599c92aa 6943119: Rebrand source copyright notices ohair parents: 1846 diff changeset	7	* published by the Free Software Foundation. Oracle designates this
2 90ce3da70b43 Initial load duke parents: diff changeset	8	* particular file as subject to the "Classpath" exception as provided
5506 202f599c92aa 6943119: Rebrand source copyright notices ohair parents: 1846 diff changeset	9	* by Oracle in the LICENSE file that accompanied this code.
2 90ce3da70b43 Initial load duke parents: diff changeset	10	*
90ce3da70b43 Initial load duke parents: diff changeset	11	* This code is distributed in the hope that it will be useful, but WITHOUT
90ce3da70b43 Initial load duke parents: diff changeset	12	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90ce3da70b43 Initial load duke parents: diff changeset	13	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
90ce3da70b43 Initial load duke parents: diff changeset	14	* version 2 for more details (a copy is included in the LICENSE file that
90ce3da70b43 Initial load duke parents: diff changeset	15	* accompanied this code).
90ce3da70b43 Initial load duke parents: diff changeset	16	*
90ce3da70b43 Initial load duke parents: diff changeset	17	* You should have received a copy of the GNU General Public License version
90ce3da70b43 Initial load duke parents: diff changeset	18	* 2 along with this work; if not, write to the Free Software Foundation,
90ce3da70b43 Initial load duke parents: diff changeset	19	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90ce3da70b43 Initial load duke parents: diff changeset	20	*
5506 202f599c92aa 6943119: Rebrand source copyright notices ohair parents: 1846 diff changeset	21	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices ohair parents: 1846 diff changeset	22	* or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices ohair parents: 1846 diff changeset	23	* questions.
2 90ce3da70b43 Initial load duke parents: diff changeset	24	*/
90ce3da70b43 Initial load duke parents: diff changeset	25
90ce3da70b43 Initial load duke parents: diff changeset	26	package com.sun.media.sound;
90ce3da70b43 Initial load duke parents: diff changeset	27
18215 b2afd66ce6db 8006328: Improve robustness of sound classes serb parents: 5506 diff changeset	28	import java.security.AccessController;
b2afd66ce6db 8006328: Improve robustness of sound classes serb parents: 5506 diff changeset	29	import java.security.PrivilegedAction;
2 90ce3da70b43 Initial load duke parents: diff changeset	30	import java.util.StringTokenizer;
90ce3da70b43 Initial load duke parents: diff changeset	31
90ce3da70b43 Initial load duke parents: diff changeset	32	/**
90ce3da70b43 Initial load duke parents: diff changeset	33	* Audio configuration class for exposing attributes specific to the platform or system.
90ce3da70b43 Initial load duke parents: diff changeset	34	*
90ce3da70b43 Initial load duke parents: diff changeset	35	* @author Kara Kytle
90ce3da70b43 Initial load duke parents: diff changeset	36	* @author Florian Bomers
90ce3da70b43 Initial load duke parents: diff changeset	37	*/
18215 b2afd66ce6db 8006328: Improve robustness of sound classes serb parents: 5506 diff changeset	38	final class Platform {
2 90ce3da70b43 Initial load duke parents: diff changeset	39
90ce3da70b43 Initial load duke parents: diff changeset	40	// native library we need to load
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	41	private static final String libName = "jsound";
2 90ce3da70b43 Initial load duke parents: diff changeset	42
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	43	private static boolean isNativeLibLoaded;
2 90ce3da70b43 Initial load duke parents: diff changeset	44
90ce3da70b43 Initial load duke parents: diff changeset	45	// SYSTEM CHARACTERISTICS
90ce3da70b43 Initial load duke parents: diff changeset	46	// vary according to hardware architecture
90ce3da70b43 Initial load duke parents: diff changeset	47
90ce3da70b43 Initial load duke parents: diff changeset	48	// intel is little-endian. sparc is big-endian.
90ce3da70b43 Initial load duke parents: diff changeset	49	private static boolean bigEndian;
90ce3da70b43 Initial load duke parents: diff changeset	50
90ce3da70b43 Initial load duke parents: diff changeset	51	static {
90ce3da70b43 Initial load duke parents: diff changeset	52	if(Printer.trace)Printer.trace(">> Platform.java: static");
90ce3da70b43 Initial load duke parents: diff changeset	53
90ce3da70b43 Initial load duke parents: diff changeset	54	loadLibraries();
90ce3da70b43 Initial load duke parents: diff changeset	55	}
90ce3da70b43 Initial load duke parents: diff changeset	56
90ce3da70b43 Initial load duke parents: diff changeset	57	/**
90ce3da70b43 Initial load duke parents: diff changeset	58	* Private constructor.
90ce3da70b43 Initial load duke parents: diff changeset	59	*/
90ce3da70b43 Initial load duke parents: diff changeset	60	private Platform() {
90ce3da70b43 Initial load duke parents: diff changeset	61	}
90ce3da70b43 Initial load duke parents: diff changeset	62
90ce3da70b43 Initial load duke parents: diff changeset	63	/**
90ce3da70b43 Initial load duke parents: diff changeset	64	* Dummy method for forcing initialization.
90ce3da70b43 Initial load duke parents: diff changeset	65	*/
90ce3da70b43 Initial load duke parents: diff changeset	66	static void initialize() {
90ce3da70b43 Initial load duke parents: diff changeset	67	if(Printer.trace)Printer.trace("Platform: initialize()");
90ce3da70b43 Initial load duke parents: diff changeset	68	}
90ce3da70b43 Initial load duke parents: diff changeset	69
90ce3da70b43 Initial load duke parents: diff changeset	70	/**
90ce3da70b43 Initial load duke parents: diff changeset	71	* Determine whether the system is big-endian.
90ce3da70b43 Initial load duke parents: diff changeset	72	*/
90ce3da70b43 Initial load duke parents: diff changeset	73	static boolean isBigEndian() {
90ce3da70b43 Initial load duke parents: diff changeset	74	return bigEndian;
90ce3da70b43 Initial load duke parents: diff changeset	75	}
90ce3da70b43 Initial load duke parents: diff changeset	76
90ce3da70b43 Initial load duke parents: diff changeset	77	/**
90ce3da70b43 Initial load duke parents: diff changeset	78	* Load the native library or libraries.
90ce3da70b43 Initial load duke parents: diff changeset	79	*/
90ce3da70b43 Initial load duke parents: diff changeset	80	private static void loadLibraries() {
90ce3da70b43 Initial load duke parents: diff changeset	81	if(Printer.trace)Printer.trace(">>Platform.loadLibraries");
90ce3da70b43 Initial load duke parents: diff changeset	82
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	83	// load the native library
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	84	isNativeLibLoaded = true;
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	85	try {
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	86	AccessController.doPrivileged((PrivilegedAction<Void>) () -> {
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	87	System.loadLibrary(libName);
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	88	return null;
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	89	});
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	90	} catch (Throwable t) {
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	91	if (Printer.err) Printer.err("Couldn't load library "+libName+": "+t.toString());
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	92	isNativeLibLoaded = false;
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	93	}
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	94	if (isNativeLibLoaded) {
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	95	bigEndian = nIsBigEndian();
2 90ce3da70b43 Initial load duke parents: diff changeset	96	}
90ce3da70b43 Initial load duke parents: diff changeset	97	}
90ce3da70b43 Initial load duke parents: diff changeset	98
90ce3da70b43 Initial load duke parents: diff changeset	99	static boolean isMidiIOEnabled() {
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	100	if (Printer.debug) Printer.debug("Platform: Checking for MidiIO; library is loaded=" + isNativeLibLoaded);
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	101	return isNativeLibLoaded;
2 90ce3da70b43 Initial load duke parents: diff changeset	102	}
90ce3da70b43 Initial load duke parents: diff changeset	103
90ce3da70b43 Initial load duke parents: diff changeset	104	static boolean isPortsEnabled() {
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	105	if (Printer.debug) Printer.debug("Platform: Checking for Ports; library is loaded=" + isNativeLibLoaded);
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	106	return isNativeLibLoaded;
2 90ce3da70b43 Initial load duke parents: diff changeset	107	}
90ce3da70b43 Initial load duke parents: diff changeset	108
90ce3da70b43 Initial load duke parents: diff changeset	109	static boolean isDirectAudioEnabled() {
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	110	if (Printer.debug) Printer.debug("Platform: Checking for DirectAudio; library is loaded=" + isNativeLibLoaded);
148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	111	return isNativeLibLoaded;
2 90ce3da70b43 Initial load duke parents: diff changeset	112	}
90ce3da70b43 Initial load duke parents: diff changeset	113
49289 148e29df1644 8071469: Cleanup include and exclude of sound native libraries ihse parents: 47216 diff changeset	114	// the following native method is implemented in Platform.c
32865 f9cb6e427f9e 8136783: Run blessed-modifier-order script on java.desktop prr parents: 29261 diff changeset	115	private static native boolean nIsBigEndian();
2 90ce3da70b43 Initial load duke parents: diff changeset	116	}

author	ihse
	Fri, 23 Mar 2018 09:51:02 +0100
changeset 49289	148e29df1644
parent 47216	71c04702a3d5
child 54860	1372fbbde8dd
permissions	-rw-r--r--