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