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 }