1 /* 2 * Copyright (c) 1999, 2014, 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.AudioFormat; 29 import javax.sound.sampled.AudioInputStream; 30 import javax.sound.sampled.AudioSystem; 31 32 /** 33 * Common conversions etc. 34 * 35 * @author Kara Kytle 36 * @author Florian Bomers 37 */ 38 public final class Toolkit { 39 40 /** 41 * Suppresses default constructor, ensuring non-instantiability. 42 */ 43 private Toolkit() { 44 } 45 46 /** 47 * Converts bytes from signed to unsigned. 48 */ 49 static void getUnsigned8(byte[] b, int off, int len) { 50 for (int i = off; i < (off+len); i++) { 51 b[i] += 128; 52 } 53 } 54 55 /** 56 * Swaps bytes. 57 * @throws ArrayOutOfBoundsException if len is not a multiple of 2. 58 */ 59 static void getByteSwapped(byte[] b, int off, int len) { 60 61 byte tempByte; 62 for (int i = off; i < (off+len); i+=2) { 63 64 tempByte = b[i]; 65 b[i] = b[i+1]; 66 b[i+1] = tempByte; 67 } 68 } 69 70 /** 71 * Linear to DB scale conversion. 72 */ 73 static float linearToDB(float linear) { 74 75 float dB = (float) (Math.log(((linear==0.0)?0.0001:linear))/Math.log(10.0) * 20.0); 76 return dB; 77 } 78 79 /** 80 * DB to linear scale conversion. 81 */ 82 static float dBToLinear(float dB) { 83 84 float linear = (float) Math.pow(10.0, dB/20.0); 85 return linear; 86 } 87 88 /* 89 * returns bytes aligned to a multiple of blocksize 90 * the return value will be in the range of (bytes-blocksize+1) ... bytes 91 */ 92 static long align(long bytes, int blockSize) { 93 // prevent null pointers 94 if (blockSize <= 1) { 95 return bytes; 96 } 97 return bytes - (bytes % blockSize); 98 } 99 100 static int align(int bytes, int blockSize) { 101 // prevent null pointers 102 if (blockSize <= 1) { 103 return bytes; 104 } 105 return bytes - (bytes % blockSize); 106 } 107 108 /* 109 * gets the number of bytes needed to play the specified number of milliseconds 110 */ 111 static long millis2bytes(AudioFormat format, long millis) { 112 long result = (long) (millis * format.getFrameRate() / 1000.0f * format.getFrameSize()); 113 return align(result, format.getFrameSize()); 114 } 115 116 /* 117 * gets the time in milliseconds for the given number of bytes 118 */ 119 static long bytes2millis(AudioFormat format, long bytes) { 120 return (long) (bytes / format.getFrameRate() * 1000.0f / format.getFrameSize()); 121 } 122 123 /* 124 * gets the number of bytes needed to play the specified number of microseconds 125 */ 126 static long micros2bytes(AudioFormat format, long micros) { 127 long result = (long) (micros * format.getFrameRate() / 1000000.0f * format.getFrameSize()); 128 return align(result, format.getFrameSize()); 129 } 130 131 /* 132 * gets the time in microseconds for the given number of bytes 133 */ 134 static long bytes2micros(AudioFormat format, long bytes) { 135 return (long) (bytes / format.getFrameRate() * 1000000.0f / format.getFrameSize()); 136 } 137 138 /* 139 * gets the number of frames needed to play the specified number of microseconds 140 */ 141 static long micros2frames(AudioFormat format, long micros) { 142 return (long) (micros * format.getFrameRate() / 1000000.0f); 143 } 144 145 /* 146 * gets the time in microseconds for the given number of frames 147 */ 148 static long frames2micros(AudioFormat format, long frames) { 149 return (long) (((double) frames) / format.getFrameRate() * 1000000.0d); 150 } 151 152 static void isFullySpecifiedAudioFormat(AudioFormat format) { 153 if (!format.getEncoding().equals(AudioFormat.Encoding.PCM_SIGNED) 154 && !format.getEncoding().equals(AudioFormat.Encoding.PCM_UNSIGNED) 155 && !format.getEncoding().equals(AudioFormat.Encoding.ULAW) 156 && !format.getEncoding().equals(AudioFormat.Encoding.ALAW)) { 157 // we don't know how to verify possibly non-linear encodings 158 return; 159 } 160 if (format.getFrameRate() <= 0) { 161 throw new IllegalArgumentException("invalid frame rate: " 162 +((format.getFrameRate()==-1)? 163 "NOT_SPECIFIED":String.valueOf(format.getFrameRate()))); 164 } 165 if (format.getSampleRate() <= 0) { 166 throw new IllegalArgumentException("invalid sample rate: " 167 +((format.getSampleRate()==-1)? 168 "NOT_SPECIFIED":String.valueOf(format.getSampleRate()))); 169 } 170 if (format.getSampleSizeInBits() <= 0) { 171 throw new IllegalArgumentException("invalid sample size in bits: " 172 +((format.getSampleSizeInBits()==-1)? 173 "NOT_SPECIFIED":String.valueOf(format.getSampleSizeInBits()))); 174 } 175 if (format.getFrameSize() <= 0) { 176 throw new IllegalArgumentException("invalid frame size: " 177 +((format.getFrameSize()==-1)? 178 "NOT_SPECIFIED":String.valueOf(format.getFrameSize()))); 179 } 180 if (format.getChannels() <= 0) { 181 throw new IllegalArgumentException("invalid number of channels: " 182 +((format.getChannels()==-1)? 183 "NOT_SPECIFIED":String.valueOf(format.getChannels()))); 184 } 185 } 186 187 static boolean isFullySpecifiedPCMFormat(AudioFormat format) { 188 if (!format.getEncoding().equals(AudioFormat.Encoding.PCM_SIGNED) 189 && !format.getEncoding().equals(AudioFormat.Encoding.PCM_UNSIGNED)) { 190 return false; 191 } 192 if ((format.getFrameRate() <= 0) 193 || (format.getSampleRate() <= 0) 194 || (format.getSampleSizeInBits() <= 0) 195 || (format.getFrameSize() <= 0) 196 || (format.getChannels() <= 0)) { 197 return false; 198 } 199 return true; 200 } 201 202 public static AudioInputStream getPCMConvertedAudioInputStream(AudioInputStream ais) { 203 // we can't open the device for non-PCM playback, so we have 204 // convert any other encodings to PCM here (at least we try!) 205 AudioFormat af = ais.getFormat(); 206 207 if( (!af.getEncoding().equals(AudioFormat.Encoding.PCM_SIGNED)) && 208 (!af.getEncoding().equals(AudioFormat.Encoding.PCM_UNSIGNED))) { 209 210 try { 211 AudioFormat newFormat = 212 new AudioFormat( AudioFormat.Encoding.PCM_SIGNED, 213 af.getSampleRate(), 214 16, 215 af.getChannels(), 216 af.getChannels() * 2, 217 af.getSampleRate(), 218 Platform.isBigEndian()); 219 ais = AudioSystem.getAudioInputStream(newFormat, ais); 220 } catch (Exception e) { 221 if (Printer.err) e.printStackTrace(); 222 ais = null; 223 } 224 } 225 226 return ais; 227 } 228 }