/* An actor that produces an event at the specified time.
Copyright (c) 1998-2005 The Regents of the University of California.
All rights reserved.
Permission is hereby granted, without written agreement and without
license or royalty fees, to use, copy, modify, and distribute this
software and its documentation for any purpose, provided that the above
copyright notice and the following two paragraphs appear in all copies
of this software.
IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF
THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE
PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF
CALIFORNIA HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
ENHANCEMENTS, OR MODIFICATIONS.
PT_COPYRIGHT_VERSION_2
COPYRIGHTENDKEY
*/
package ptolemy.domains.de.lib;
import ptolemy.actor.Director;
import ptolemy.actor.TypedAtomicActor;
import ptolemy.actor.TypedIOPort;
import ptolemy.actor.util.Time;
import ptolemy.data.BooleanToken;
import ptolemy.data.DoubleToken;
import ptolemy.data.expr.Parameter;
import ptolemy.data.type.BaseType;
import ptolemy.kernel.CompositeEntity;
import ptolemy.kernel.util.Attribute;
import ptolemy.kernel.util.IllegalActionException;
import ptolemy.kernel.util.NameDuplicationException;
import ptolemy.kernel.util.Workspace;
//////////////////////////////////////////////////////////////////////////
//// SingleEvent
/**
This actor produces an event with the specified value at the
specified time. In its initialize() method, it queues an event,
requesting that it be fired at the specified time. If the <i>time</i>
parameter changes before that time is reached, then the event is
effectively canceled. No event will be produced.
@author Edward A. Lee
@version $Id: SingleEvent.java,v 1.27 2005/07/08 19:58:16 cxh Exp $
@since Ptolemy II 1.0
@Pt.ProposedRating Yellow (eal)
@Pt.AcceptedRating Red (liuj)
*/
public class SingleEvent extends TypedAtomicActor {
/** Construct an actor with the specified container and name.
* @param container The container.
* @param name The name of this actor.
* @exception IllegalActionException If the entity cannot be contained
* by the proposed container.
* @exception NameDuplicationException If the container already has an
* actor with this name.
*/
public SingleEvent(CompositeEntity container, String name)
throws NameDuplicationException, IllegalActionException {
super(container, name);
output = new TypedIOPort(this, "output", false, true);
time = new Parameter(this, "time", new DoubleToken(0.0));
time.setTypeEquals(BaseType.DOUBLE);
value = new Parameter(this, "value", new BooleanToken(true));
output.setTypeSameAs(value);
}
///////////////////////////////////////////////////////////////////
//// ports and parameters ////
/** The output port. The type of this port is linked to the type
* of the <i>value</i> parameter.
*/
public TypedIOPort output = null;
/** The time at which to produce the output. This has type double,
* with default value 0.0.
* If the value is negative, then no output will be produced.
*/
public Parameter time;
/** The value produced at the output. This can have any type,
* and it defaults to a boolean token with value <i>true</i>.
*/
public Parameter value;
///////////////////////////////////////////////////////////////////
//// public methods ////
/** Allow type changes on the <i>value</i> parameter, and notify
* the director that resolved types are invalid.
* @param attribute The attribute whose type changed.
* @exception IllegalActionException If the parent class throws it.
*/
public void attributeTypeChanged(Attribute attribute)
throws IllegalActionException {
if (attribute == value) {
Director director = getDirector();
if (director != null) {
director.invalidateResolvedTypes();
}
} else {
super.attributeTypeChanged(attribute);
}
}
/** Clone the actor into the specified workspace. This calls the
* base class and then links the type of the <i>value</i> parameter
* to the output.
* @param workspace The workspace for the new object.
* @return A new actor.
* @exception CloneNotSupportedException If a derived class has
* has an attribute that cannot be cloned.
*/
public Object clone(Workspace workspace) throws CloneNotSupportedException {
SingleEvent newObject = (SingleEvent) super.clone(workspace);
newObject.output.setTypeSameAs(newObject.value);
return newObject;
}
/** If the current time matches the value of the <i>time</i> parameter,
* then produce an output token with value given by the <i>value</i>
* parameter.
*/
public void fire() throws IllegalActionException {
double eventTimeValue = ((DoubleToken) time.getToken()).doubleValue();
Time eventTime = new Time(getDirector(), eventTimeValue);
if (getDirector().getModelTime().equals(eventTime)) {
output.send(0, value.getToken());
}
super.fire();
}
/** Request firing at the time given by the <i>time</i> parameter.
* If the time is negative, then do nothing.
* @exception IllegalActionException If there is no director.
*/
public void initialize() throws IllegalActionException {
super.initialize();
double eventTime = ((DoubleToken) time.getToken()).doubleValue();
if (eventTime >= 0.0) {
Director director = getDirector();
if (director != null) {
director.fireAt(this, new Time(director, eventTime));
} else {
throw new IllegalActionException(this, "No director.");
}
}
}
}