1 /* 2 * Copyright (c) 2002, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package com.sun.media.sound; 27 28 import javax.sound.sampled.Mixer; 29 import javax.sound.sampled.spi.MixerProvider; 30 31 32 /** 33 * Port provider. 34 * 35 * @author Florian Bomers 36 */ 37 public final class PortMixerProvider extends MixerProvider { 38 39 // STATIC VARIABLES 40 41 /** 42 * Set of info objects for all port input devices on the system. 43 */ 44 private static PortMixerInfo[] infos; 45 46 /** 47 * Set of all port input devices on the system. 48 */ 49 private static PortMixer[] devices; 50 51 52 // STATIC 53 54 static { 55 // initialize 56 Platform.initialize(); 57 } 58 59 60 // CONSTRUCTOR 61 62 63 /** 64 * Required public no-arg constructor. 65 */ 66 public PortMixerProvider() { 67 synchronized (PortMixerProvider.class) { 68 if (Platform.isPortsEnabled()) { 69 init(); 70 } else { 71 infos = new PortMixerInfo[0]; 72 devices = new PortMixer[0]; 73 } 74 } 75 } 76 77 private static void init() { 78 // get the number of input devices 79 int numDevices = nGetNumDevices(); 80 81 if (infos == null || infos.length != numDevices) { 82 if (Printer.trace) Printer.trace("PortMixerProvider: init()"); 83 // initialize the arrays 84 infos = new PortMixerInfo[numDevices]; 85 devices = new PortMixer[numDevices]; 86 87 // fill in the info objects now. 88 // we'll fill in the device objects as they're requested. 89 for (int i = 0; i < infos.length; i++) { 90 infos[i] = nNewPortMixerInfo(i); 91 } 92 if (Printer.trace) Printer.trace("PortMixerProvider: init(): found numDevices: " + numDevices); 93 } 94 } 95 96 public Mixer.Info[] getMixerInfo() { 97 synchronized (PortMixerProvider.class) { 98 Mixer.Info[] localArray = new Mixer.Info[infos.length]; 99 System.arraycopy(infos, 0, localArray, 0, infos.length); 100 return localArray; 101 } 102 } 103 104 105 public Mixer getMixer(Mixer.Info info) { 106 synchronized (PortMixerProvider.class) { 107 for (int i = 0; i < infos.length; i++) { 108 if (infos[i].equals(info)) { 109 return getDevice(infos[i]); 110 } 111 } 112 } 113 throw new IllegalArgumentException("Mixer " + info.toString() 114 + " not supported by this provider."); 115 } 116 117 118 private static Mixer getDevice(PortMixerInfo info) { 119 int index = info.getIndex(); 120 if (devices[index] == null) { 121 devices[index] = new PortMixer(info); 122 } 123 return devices[index]; 124 } 125 126 // INNER CLASSES 127 128 129 /** 130 * Info class for PortMixers. Adds an index value for 131 * making native references to a particular device. 132 * This constructor is called from native. 133 */ 134 static final class PortMixerInfo extends Mixer.Info { 135 private final int index; 136 137 private PortMixerInfo(int index, String name, String vendor, String description, String version) { 138 super("Port " + name, vendor, description, version); 139 this.index = index; 140 } 141 142 int getIndex() { 143 return index; 144 } 145 146 } // class PortMixerInfo 147 148 // NATIVE METHODS 149 private static native int nGetNumDevices(); 150 private static native PortMixerInfo nNewPortMixerInfo(int mixerIndex); 151 }