/*

 * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

package sun.audio;

import java.io.*;

import java.util.Arrays;

import javax.sound.sampled.*;

/**

 * A clip of audio data. This data can be used to construct an

 * AudioDataStream, which can be played. <p>

 *

 * @author  Arthur van Hoff

 * @author  Kara Kytle

 * @see     AudioDataStream

 * @see     AudioPlayer

 */

 /*

  * the idea here is that the AudioData object encapsulates the

  * data you need to play an audio clip based on a defined set

  * of data.  to do this, you require the audio data (a byte

  * array rather than an arbitrary input stream) and a format

  * object.

  */

public final class AudioData {

    private static final AudioFormat DEFAULT_FORMAT =

        new AudioFormat(AudioFormat.Encoding.ULAW,

                        8000,   // sample rate

                        8,      // sample size in bits

                        1,      // channels

                        1,      // frame size in bytes

                        8000,   // frame rate

                        true ); // bigendian (irrelevant for 8-bit data)

    AudioFormat format;   // carry forth the format array amusement

    byte buffer[];

    /**

     * Constructor

     */

    public AudioData(final byte[] buffer) {

        // if we cannot extract valid format information, we resort to assuming

        // the data will be 8k mono u-law in order to provide maximal backwards

        // compatibility....

        this(DEFAULT_FORMAT, buffer);

        // okay, we need to extract the format and the byte buffer of data

        try {

            AudioInputStream ais = AudioSystem.getAudioInputStream(new ByteArrayInputStream(buffer));

            this.format = ais.getFormat();

            ais.close();

            // $$fb 2002-10-27: buffer contains the file header now!

        } catch (IOException e) {

            // use default format

        } catch (UnsupportedAudioFileException e1 ) {

            // use default format

        }

    }

    /**

     * Non-public constructor; this is the one we use in ADS and CADS

     * constructors.

     */

    AudioData(final AudioFormat format, final byte[] buffer) {

        this.format = format;

        if (buffer != null) {

            this.buffer = Arrays.copyOf(buffer, buffer.length);

        }

    }

}