/*
* @(#)DelayedSoundArea.java 1.15 04/07/26
*
* Copyright (c) 2004 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* -Redistribution of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* -Redistribution in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
* ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
* OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN")
* AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
* AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
* DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
* REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
* INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
* OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
* EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or intended
* for use in the design, construction, operation or maintenance of any
* nuclear facility.
*/
/*
* @(#)DelayedSoundArea.java 1.15 04/07/26
*/
import java.awt.Graphics;
import java.applet.AudioClip;
import java.net.URL;
import java.net.MalformedURLException;
import java.util.StringTokenizer;
/**
* This ImageArea Class will play a sound each time the user enters the
* area. It is different from SoundArea in that it accepts a delay (in
* tenths of a second) before it plays the sound. If the mouse leaves
* the area before the time delay, the sound is not played.
*
* This allows you to have one piece of audio when the button is "hit"
* via SoundArea and another if the user stays on the button.
*
* @author Chuck McManis
* @version 1.15, 07/26/04
*/
class DelayedSoundArea extends ImageMapArea {
/** The URL of the sound to be played. */
URL sound;
AudioClip soundData;
boolean hasPlayed;
int delay;
int countDown;
/**
* The argument is the URL of the sound to be played.
* This method also sets this type of area to be non-terminal.
*/
public void handleArg(String arg) {
Thread soundLoader;
StringTokenizer st = new StringTokenizer(arg, ", ");
delay = Integer.parseInt(st.nextToken());
try {
sound = new URL(parent.getDocumentBase(), st.nextToken());
} catch (MalformedURLException e) {
sound = null;
}
}
public void getMedia() {
if (sound != null) {
soundData = parent.getAudioClip(sound);
}
if (soundData == null) {
System.out.println("DelayedSoundArea: Unable to load data "+sound);
}
}
/**
* The highlight method plays the sound in addition to the usual
* graphical highlight feedback.
*/
public void enter() {
hasPlayed = false;
countDown = delay;
parent.startAnimation();
}
/**
* This method is called every animation cycle if there are any
* active animating areas.
* @return true if this area requires further animation notifications
*/
public boolean animate() {
if (entered && ! hasPlayed) {
if (countDown > 0) {
countDown--;
return true;
}
hasPlayed = true;
if (soundData != null) {
soundData.play();
}
}
return false;
}
}
|