1 /*
   2  * Copyright (c) 2002, 2015, 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     public Mixer getMixer(Mixer.Info info) {
 105         synchronized (PortMixerProvider.class) {
 106             for (int i = 0; i < infos.length; i++) {
 107                 if (infos[i].equals(info)) {
 108                     return getDevice(infos[i]);
 109                 }
 110             }
 111         }
 112         throw new IllegalArgumentException(
 113                 String.format("Mixer %s not supported by this provider", info));
 114     }
 115 
 116 
 117     private static Mixer getDevice(PortMixerInfo info) {
 118         int index = info.getIndex();
 119         if (devices[index] == null) {
 120             devices[index] = new PortMixer(info);
 121         }
 122         return devices[index];
 123     }
 124 
 125     // INNER CLASSES
 126 
 127 
 128     /**
 129      * Info class for PortMixers.  Adds an index value for
 130      * making native references to a particular device.
 131      * This constructor is called from native.
 132      */
 133     static final class PortMixerInfo extends Mixer.Info {
 134         private final int index;
 135 
 136         private PortMixerInfo(int index, String name, String vendor, String description, String version) {
 137             super("Port " + name, vendor, description, version);
 138             this.index = index;
 139         }
 140 
 141         int getIndex() {
 142             return index;
 143         }
 144 
 145     } // class PortMixerInfo
 146 
 147     // NATIVE METHODS
 148     private static native int nGetNumDevices();
 149     private static native PortMixerInfo nNewPortMixerInfo(int mixerIndex);
 150 }