desmoj.extensions.space3D

Class MovableSpatialSimProcess

java.lang.Object

desmoj.core.simulator.NamedObject

desmoj.core.simulator.ModelComponent

desmoj.core.simulator.Schedulable

desmoj.core.simulator.Entity

desmoj.core.simulator.SimProcess

desmoj.extensions.space3D.SpatialSimProcess

desmoj.extensions.space3D.MovableSpatialSimProcess

All Implemented Interfaces:

MovableSpatialObject, SpatialObject, VisibleObject

public abstract class MovableSpatialSimProcess
extends SpatialSimProcess
implements MovableSpatialObject

The class represents the movable DESMO-J SimProcess which should be visualized. Therefore it implements the MovableSpatialObject interface for the handling with the 3D spatial data, the spatial movements and the parent-child-MSO concept.

Author:

Fred Sun

Constructor Summary

Constructors

Constructor and Description
MovableSpatialSimProcess(Model owner, java.lang.String name, java.lang.String type, boolean showInTrace) Constructs a MovableSpatialSimProcess without specify the spatial data.
MovableSpatialSimProcess(Model owner, java.lang.String name, java.lang.String type, boolean showInTrace, double acc, double dec, double mSpeed) Constructs a MovableSpatialSimProcess with specific acceleration and negative acceleration, maximum speed and position data.
MovableSpatialSimProcess(Model owner, java.lang.String name, java.lang.String type, boolean showInTrace, double acc, double dec, double mSpeed, Length startPositionX, Length startPositionY, Length startPositionZ, SpatialMovementManager manager) Constructs a MovableSpatialSimProcess with specific acceleration and negative acceleration, maximum speed, position data and SpatialMovementManager for movement customizing.

Method Summary

Modifier and Type	Method and Description
void	attach(MovableSpatialObject host) Snaps to another MovableSpatialObject.
void	cancelMovement() Cancel the movement if there is a movement performing.
void	cancelRotation() Cancel the rotation if there is a rotation performing.
void	detach() Releases from the host object if this object is attached to it.
double	getAcc() Gets the acceleration of the object.
SpatialObject	getCurrentLocation() Returns the SpatialObject where this MovableSpatialObject is currently located.
Movement	getCurrentMovement() Gets the current Movement object.
Rotation	getCurrentRotation() Gets the current Rotation object.
double	getCurrentSpeed() Gets the current moving speed of the object.
double	getDec() Gets the negative acceleration of the object.
Matrix4d	getMatrix() Gets a 4x4 double matrix object which contains the spatial data of the SpatialObejct.
double	getMaxSpeed() Gets the maximum speed of the object.
Length	getPosX()
Length	getPosY()
Length	getPosZ()
boolean	isAttached() IShows whether the MovableSpatialObject is attached.
boolean	isFocusedOnTrack() Returns whether the FocusOnTrack function is on.
boolean	isMoving() Shows whether the MovableSpatialObject is moving.
boolean	isMovingConcurrent() Shows whether this object is moving concurrentlly.
boolean	isRotating() Shows whether the MovableSpatialObject is rotating.
void	move(Movement movement, boolean focusOnTrack) Move the object to the destination according to the given movement object.
void	move(SpatialObject destination, java.lang.String entryPointName, boolean focusOnTrack) Move the object to the position of another SpatialObject without a specified duration.
void	move(SpatialObject destination, java.lang.String entryPointName, TimeSpan duration, boolean focusOnTrack) Move the object to the position of another SpatialObject with a specified duration.
void	move(SpatialObject destination, java.lang.String entryPointName, TimeSpan duration, double maxSpeed, double acc, double dec, boolean focusOnTrack) Move the object to the position of another SpatialObject with specific attributes.
void	moveConcurrent(Movement movement, boolean focusOnTrack) Move the object to the destination according to the given movement object.
void	moveConcurrent(SpatialObject destination, java.lang.String entryPointName, boolean focusOnTrack) Move the object to the position of another SpatialObject without a specified duration.
void	moveConcurrent(SpatialObject destination, java.lang.String entryPointName, TimeSpan duration, boolean focusOnTrack) Move the object to the position of another SpatialObject with a specified duration.
void	moveConcurrent(SpatialObject destination, java.lang.String entryPointName, TimeSpan duration, double maxSpeed, double acc, double dec, boolean focusOnTrack) Move the object to the position of another SpatialObject with specific attributes.
void	notifyMovingDone() Notifies the MovableSpatialObject that the moving is finished and updates the new coordinates.
void	notifyRotatingDone() Notifies the MovableSpatialObject that the rotating is finished and updates the new coordinates.
void	resetRotation() Resets the rotation of the object.
void	rotX(double angle) Adds a rotation about the x-axis to the current orientation.
void	rotX(double angle, TimeSpan duration) Rotates the object about the x-axis using an animation.
void	rotXConcurrent(double angle, TimeSpan duration) Rotates the object about the x-axis using an animation.
void	rotY(double angle) Adds a rotation about the y-axis to the current orientation.
void	rotY(double angle, TimeSpan duration) Rotates the object about the y-axis using an animation.
void	rotYConcurrent(double angle, TimeSpan duration) Rotates the object about the y-axis using an animation.
void	rotZ(double angle) Adds a rotation about the z-axis to the current orientation.
void	rotZ(double angle, TimeSpan duration) Rotates the object about the z-axis using an animation.
void	rotZConcurrent(double angle, TimeSpan duration) Rotates the object about the z-axis using an animation.
void	sendToLocation(SpatialObject destination) Set this object to the position of the destination object and change the currentLocation to the destination object.
void	sendToLocationEntryPoint(SpatialObject destination, java.lang.String entryPoint) Set this object to the position of the given entry point of the destination object.
void	sendToLocationExitPoint(SpatialObject destination, java.lang.String exitPoint) Set this object to the position of the given exit point of the destination object.
void	setAcc(double acc) Sets the acceleration of the object.
void	setDec(double dec) Sets the negative acceleration of the object.
void	setMaxSpeed(double mSpeed) Sets the maximum speed of this object
void	setPosition(Length x, Length y, Length z) It sets the new position for the object

Methods inherited from class desmoj.extensions.space3D.SpatialSimProcess

addEntryPoint, addExitPoint, getEntryPoint, getEntryPointGlobal, getEntryPointNames, getExitPoint, getExitPointGlobal, getExitPointNames, getVisualModel, isMovable, isVisible, removeVisible, setVisible

Methods inherited from class desmoj.core.simulator.SimProcess

activate, activate, activate, activateAfter, activateBefore, activatePreempt, cancelInterruptDelayed, canCooperate, clearInterruptCode, cooperate, getActivatedBy, getInterruptCode, getInterruptException, getMaster, getRealTimeConstraint, getSchedulingPriority, getSlaveWaitQueue, getSupervisor, hold, hold, hold, interrupt, interrupt, interruptDelayed, interruptDelayed, isBlocked, isComponent, isDelayedInterruptScheduled, isInterrupted, isRepeating, isTerminated, lifeCycle, obtainResources, passivate, prepareTransport, reActivate, reActivate, resetMaster, returnAllResources, returnResources, setBlocked, setRealTimeConstraint, setRepeating, setSchedulingPriority, setSlaveWaitQueue

Methods inherited from class desmoj.core.simulator.Entity

getIdentNumber, getQueueingPriority, getQueues, getScheduledEvents, isEqual, isLarger, isLargerOrEqual, isNotEqual, isQueued, isSimProcess, isSmaller, isSmallerOrEqual, schedule, schedule, schedule, schedule, schedule, schedule, schedule, schedule, schedule, scheduleAfter, scheduleAfter, scheduleAfter, scheduleBefore, scheduleBefore, scheduleBefore, schedulePreempt, schedulePreempt, schedulePreempt, setQueueingPriority

Methods inherited from class desmoj.core.simulator.Schedulable

assignReporter, cancel, getCorrespondingReportable, isCurrent, isScheduled, rename, reSchedule, reSchedule, reSchedulePreempt, scheduledNext, setCorrespondingReportable

Methods inherited from class desmoj.core.simulator.ModelComponent

current, currentEntity, currentEntityAll, currentEvent, currentModel, currentSimProcess, debugIsOn, debugOff, debugOn, getModel, isExperimentCompatible, isModelCompatible, presentTime, sendDebugNote, sendMessage, sendTraceNote, sendWarning, skipTraceNote, skipTraceNote, traceIsOn, traceOff, traceOn

Methods inherited from class desmoj.core.simulator.NamedObject

getName, getQuotedName, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface desmoj.extensions.space3D.SpatialObject

addEntryPoint, addExitPoint, getEntryPoint, getEntryPointGlobal, getEntryPointNames, getExitPoint, getExitPointGlobal, getExitPointNames, getName, isMovable

Constructor Detail

MovableSpatialSimProcess

public MovableSpatialSimProcess(Model owner,
                                java.lang.String name,
                                java.lang.String type,
                                boolean showInTrace)

Constructs a MovableSpatialSimProcess without specify the spatial data.

Parameters:

owner - The model this process is associated to.

name - The name of the process.

type - The type attribute belongs to the SpatialObject interface.

showInTrace - Flag for showing entity in trace-files. Set it to true if entity should show up in trace. Set to false in entity should not be shown in trace.

MovableSpatialSimProcess

public MovableSpatialSimProcess(Model owner,
                                java.lang.String name,
                                java.lang.String type,
                                boolean showInTrace,
                                double acc,
                                double dec,
                                double mSpeed)

Constructs a MovableSpatialSimProcess with specific acceleration and negative acceleration, maximum speed and position data.

Parameters:

owner - The model this entity is associated to.

name - The name of the entity.

type - The type attribute belongs to the SpatialObject interface.

showInTrace - showInTrace Flag for showing entity in trace-files. Set it to true if entity should show up in trace. Set to false in entity should not be shown in trace..

acc - The acceleration of this MovableSpatialObject.

dec - The breaking acceleration of this MovableSpatialObject (normally a negative value).

mSpeed - The maximum speed of this MobavleSpatialObject.

MovableSpatialSimProcess

public MovableSpatialSimProcess(Model owner,
                                java.lang.String name,
                                java.lang.String type,
                                boolean showInTrace,
                                double acc,
                                double dec,
                                double mSpeed,
                                Length startPositionX,
                                Length startPositionY,
                                Length startPositionZ,
                                SpatialMovementManager manager)

Constructs a MovableSpatialSimProcess with specific acceleration and negative acceleration, maximum speed, position data and SpatialMovementManager for movement customizing.

Parameters:

owner - The model this entity is associated to.

name - The name of the entity.

type - The type attribute belongs to the SpatialObject interface.

showInTrace - showInTrace Flag for showing entity in trace-files. Set it to true if entity should show up in trace. Set to false in entity should not be shown in trace.

acc - The acceleration of this MovableSpatialObject.

dec - The breaking acceleration of this MovableSpatialObject (normally a negative value)

mSpeed - The maximum speed of this MovableSpatialObject.

startPositionX - The x start position in ExtendedLength.

startPositionY - The y start position in ExtendedLength.

startPositionZ - The z start position in ExtendedLength.

manager - a specific SpatialMovementManager which the user could have customized.

Method Detail

attach

public void attach(MovableSpatialObject host)

Description copied from interface: MovableSpatialObject

Snaps to another MovableSpatialObject. If the host moves, this object will be moved, too. The relative position to the host object will be kept. If attached, this object shouldn't be able to change its position and orientation itself anymore.

Specified by:

attach in interface MovableSpatialObject

Parameters:

host - The MovableSpatialObject who to attach to.

cancelMovement

public void cancelMovement()

Description copied from interface: MovableSpatialObject

Cancel the movement if there is a movement performing.

Specified by:

cancelMovement in interface MovableSpatialObject

cancelRotation

public void cancelRotation()

Description copied from interface: MovableSpatialObject

Cancel the rotation if there is a rotation performing.

Specified by:

cancelRotation in interface MovableSpatialObject

detach

public void detach()

Description copied from interface: MovableSpatialObject

Releases from the host object if this object is attached to it.

Specified by:

detach in interface MovableSpatialObject

getAcc

public double getAcc()

Description copied from interface: MovableSpatialObject

Gets the acceleration of the object. The default value is 0.

Specified by:

getAcc in interface MovableSpatialObject

Returns:

The acceleration

getCurrentLocation

public SpatialObject getCurrentLocation()

Description copied from interface: MovableSpatialObject

Returns the SpatialObject where this MovableSpatialObject is currently located.

Specified by:

getCurrentLocation in interface MovableSpatialObject

Returns:

The SpatialObject where this MovableSpatialObject is located. Null, if it isn't located at any SpatialObject.

getCurrentMovement

public Movement getCurrentMovement()

Description copied from interface: MovableSpatialObject

Gets the current Movement object.

Specified by:

getCurrentMovement in interface MovableSpatialObject

Returns:

The current Movement object. Null, if this MovableSpatialObject isn't moving.

getCurrentRotation

public Rotation getCurrentRotation()

Description copied from interface: MovableSpatialObject

Gets the current Rotation object.

Specified by:

getCurrentRotation in interface MovableSpatialObject

Returns:

The current Rotation object. Null, if this MovableSpatialObject isn't rotating.

getCurrentSpeed

public double getCurrentSpeed()

Description copied from interface: MovableSpatialObject

Gets the current moving speed of the object.

Specified by:

getCurrentSpeed in interface MovableSpatialObject

Returns:

The current moving speed.

getDec

public double getDec()

Description copied from interface: MovableSpatialObject

Gets the negative acceleration of the object. The default value is 0.

Specified by:

getDec in interface MovableSpatialObject

Returns:

The negative acceleration

getMatrix

public Matrix4d getMatrix()

Description copied from interface: SpatialObject

Gets a 4x4 double matrix object which contains the spatial data of the SpatialObejct.

Specified by:

getMatrix in interface SpatialObject

Overrides:

getMatrix in class SpatialSimProcess

Returns:

The Matrix4d object.

getMaxSpeed

public double getMaxSpeed()

Description copied from interface: MovableSpatialObject

Gets the maximum speed of the object. If it's 0, the MovableSpatialObject won't have speed limitation. The default value is 0.

Specified by:

getMaxSpeed in interface MovableSpatialObject

Returns:

The maximum speed of the object

getPosX

public Length getPosX()

Specified by:

getPosX in interface SpatialObject

Overrides:

getPosX in class SpatialSimProcess

Returns:

It returns the x-position of the object.

getPosY

public Length getPosY()

Specified by:

getPosY in interface SpatialObject

Overrides:

getPosY in class SpatialSimProcess

Returns:

It returns the y-position of the object.

getPosZ

public Length getPosZ()

Specified by:

getPosZ in interface SpatialObject

Overrides:

getPosZ in class SpatialSimProcess

Returns:

It returns the z-position of the object.

isAttached

public boolean isAttached()

Description copied from interface: MovableSpatialObject

IShows whether the MovableSpatialObject is attached.

Specified by:

isAttached in interface MovableSpatialObject

Returns:

Whether the MovableSpatialObejct is attached.

isFocusedOnTrack

public boolean isFocusedOnTrack()

Description copied from interface: MovableSpatialObject

Returns whether the FocusOnTrack function is on.

Specified by:

isFocusedOnTrack in interface MovableSpatialObject

Returns:

True if it's set. False if it's not set.

isMoving

public boolean isMoving()

Description copied from interface: MovableSpatialObject

Shows whether the MovableSpatialObject is moving.

Specified by:

isMoving in interface MovableSpatialObject

Returns:

whether the MovableSpatialObject is moving.

isMovingConcurrent

public boolean isMovingConcurrent()

Shows whether this object is moving concurrentlly.

Returns:

True, if it's moving concurrentlly. Else, false.

isRotating

public boolean isRotating()

Description copied from interface: MovableSpatialObject

Shows whether the MovableSpatialObject is rotating.

Specified by:

isRotating in interface MovableSpatialObject

Returns:

whether the MovableSpatialObject is rotating.

move

public void move(SpatialObject destination,
                 java.lang.String entryPointName,
                 boolean focusOnTrack)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Move the object to the position of another SpatialObject without a specified duration. It use the acceleration, deceleration and the maximum speed of the MovableSpatialObject. For this method the maximum speed of the object must be given or an IllegalMoveException will be thrown. If the acceleration is <= 0 OR deceleration of the object is >= 0, then the kinematical attributes won't be calculated and the movement will start with the maximum speed and break to zero immediately at the destination. If the object is already moving it will move to the new destination. (not for MovableSpatialSimProcess)

Specified by:

move in interface MovableSpatialObject

Parameters:

destination - The destination object we want to move to.

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

Throws:

SuspendExecution

move

public void move(SpatialObject destination,
                 java.lang.String entryPointName,
                 TimeSpan duration,
                 boolean focusOnTrack)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Move the object to the position of another SpatialObject with a specified duration. It use the acceleration, deceleration and the maximum speed of the MovableSpatialObject. If the acceleration is <= 0 OR deceleration of the object is >= 0, then the kinematical attributes won't be calculated and the movement will start with the speed needed to arrive the destination in time. If the maximum speed of the object is initialized (>0), then an IllegalMoveException will be thrown if it is not possible to make to the destination in time. If the object is already moving it will move to the new destination. (not for MovableSpatialSimProcess)

Specified by:

move in interface MovableSpatialObject

Parameters:

destination - The destination object we want to move to.

duration - The duration of the movement in TimeSpan.

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

Throws:

SuspendExecution

move

public void move(SpatialObject destination,
                 java.lang.String entryPointName,
                 TimeSpan duration,
                 double maxSpeed,
                 double acc,
                 double dec,
                 boolean focusOnTrack)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Move the object to the position of another SpatialObject with specific attributes. There are different varieties of movement modes depends on the initialized parameters (O = initialized, X = not initialized(means invalid or null)): case 1: duration O, maxSpeed O, acc & dec O: The movement will be performed according to the parameters. If the given parameters can't be satisfied, an IllegalMoveException will be thrown. case 2: duration X, maxSpeed O, acc & dec O: The object will be moved to the destination with the fastest speed possible. case 3: duration O, maxSpeed X, acc & dec O: The object will move to the destination with the given acceleration and deceleration and try to reach the destination in time. If the given parameters can't be satisfied, an IllegalMoveException will be thrown. case 4: duration X, maxSpeed X, acc & dec O: The object will be accelerated and followed by a deceleration. There's no constant phase in the movement. case 5: duration O, maxSpeed O, acc or dec X: The object will start with the speed needed to arrive the destination in the given time and break suddenly to zero at the end of the movement. The maxSpeed gives the speed limit of the movement. If the given parameters can't be satisfied, an IllegalMoveException will be thrown. case 6: duration X, maxSpeed O, acc or dec X: The movement will start with the maxSpeed and stops the destination. case 7: duration O, maxSpeed X, acc or dec X: The movement will start with the speed needed to arrive the destination with the duration given. All other combinations of these parameters will cause an IllegalMoveException. If the object is already moving it will move to the new destination. (not for MovableSpatialSimProcess)

Specified by:

move in interface MovableSpatialObject

Parameters:

destination - The destination object we want to move to.

duration - The duration of the movement in TimeSpan(optional).

maxSpeed - The maximum speed of the movement(optional).

acc - The acceleration of the movement(optional).

dec - The deceleration of the movement(optional).

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

Throws:

SuspendExecution

move

public void move(Movement movement,
                 boolean focusOnTrack)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Move the object to the destination according to the given movement object. If the object is already moving it will move to the new destination. (not for MovableSpatialSimProcess) If this MovableSpatialObject is a child-MSO, the Track which is contained in the Movement parameter should be in the local coordinates of this object.

Specified by:

move in interface MovableSpatialObject

Parameters:

movement - The movement which should be performed.

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

Throws:

SuspendExecution

moveConcurrent

public void moveConcurrent(SpatialObject destination,
                           java.lang.String entryPointName,
                           boolean focusOnTrack)

Move the object to the position of another SpatialObject without a specified duration. The difference to the move methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a rotation can be performed while the object is moving. If the object is already moving it will move to the new destination. It use the acceleration, deceleration and the maximum speed of the MovableSpatialObject. For this method the maximum speed of the object must be given or an IllegalMoveException will be thrown. If the acceleration OR deceleration of the object is <= 0, then the kinematical attributes won't be calculated and the movement will start with the maximum speed and break to zero immediately at the destination.

Parameters:

destination - The destination object we want to move to.

enttryPointName - The name of the specific entry point at the destination object, which should be steered to.

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

moveConcurrent

public void moveConcurrent(SpatialObject destination,
                           java.lang.String entryPointName,
                           TimeSpan duration,
                           boolean focusOnTrack)

Move the object to the position of another SpatialObject with a specified duration. The difference to the move methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a rotation can be performed while the object is moving. If the object is already moving it will move to the new destination. It use the acceleration, deceleration and the maximum speed of the MovableSpatialObject. If the acceleration OR deceleration of the object is <= 0, then the kinematical attributes won't be calculated and the movement will start with the speed needed to arrive the destination in time. If the maximum speed of the object is initialized (>0), then an IllegalMoveException will be thrown if it is not possible to make to the destination in time.

Parameters:

destination - The destination object we want to move to.

enttryPointName - The name of the specific entry point at the destination object, which should be steered to.

duration - The duration of the movement in TimeSpan.

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

moveConcurrent

public void moveConcurrent(SpatialObject destination,
                           java.lang.String entryPointName,
                           TimeSpan duration,
                           double maxSpeed,
                           double acc,
                           double dec,
                           boolean focusOnTrack)

Move the object to the position of another SpatialObject with specific attributes. The difference to the move methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a rotation can be performed while the object is moving. If the object is already moving it will move to the new destination. There are different varieties of movement modes depends on the initialized parameters (O = initialized, X = not initialized(means <=0 or null)): case 1: duration O, maxSpeed O, acc & dec O: The movement will be performed according to the parameters. If the given parameters can't be satisfied, an IllegalMoveException will be thrown. case 2: duration X, maxSpeed O, acc & dec O: The object will be moved to the destination with the fastest speed possible. case 3: duration O, maxSpeed X, acc & dec O: The object will move to the destination with the given acceleration and deceleration and try to reach the destination in time. If the given parameters can't be satisfied, an IllegalMoveException will be thrown. case 4: duration X, maxSpeed X, acc & dec O: The object will be accelerated and followed by a deceleration. There's no constant phase in the movement. case 5: duration O, maxSpeed O, acc or dec X: The object will start with the speed needed to arrive the destination in the given time and break suddenly to zero at the end of the movement. The maxSpeed gives the speed limit of the movement. If the given parameters can't be satisfied, an IllegalMoveException will be thrown. case 6: duration X, maxSpeed O, acc or dec X: The movement will start with the maxSpeed and stops the destination. case 7: duration O, maxSpeed X, acc or dec X: The movement will start with the speed needed to arrive the destination with the duration given. All other combinations of these parameters will cause an IllegalMoveException.

Parameters:

destination - The destination object we want to move to.

enttryPointName - The name of the specific entry point at the destination object, which should be steered to(optional).

duration - The duration of the movement in TimeSpan(optional).

maxSpeed - The maximum speed of the movement(optional).

acc - The acceleration of the movement(optional).

dec - The deceleration of the movement(optional).

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

moveConcurrent

public void moveConcurrent(Movement movement,
                           boolean focusOnTrack)

Move the object to the destination according to the given movement object. The difference to the move methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a rotation can be performed while the object is moving. If the object is already moving it will move to the new destination.

Parameters:

movement - The movement which should be performed.

focusOnTrack - Whether the orientation of the moving object should focus to the moving direction.

notifyMovingDone

public void notifyMovingDone()
                      throws SuspendExecution

Description copied from interface: MovableSpatialObject

Notifies the MovableSpatialObject that the moving is finished and updates the new coordinates. This method shouldn't be called by user!

Specified by:

notifyMovingDone in interface MovableSpatialObject

Throws:

SuspendExecution

notifyRotatingDone

public void notifyRotatingDone()
                        throws SuspendExecution

Description copied from interface: MovableSpatialObject

Notifies the MovableSpatialObject that the rotating is finished and updates the new coordinates. This method shouldn't be called by user!

Specified by:

notifyRotatingDone in interface MovableSpatialObject

Throws:

SuspendExecution

resetRotation

public void resetRotation()

Description copied from interface: SpatialObject

Resets the rotation of the object.

Specified by:

resetRotation in interface SpatialObject

Overrides:

resetRotation in class SpatialSimProcess

rotX

public void rotX(double angle,
                 TimeSpan duration)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Rotates the object about the x-axis using an animation.

Specified by:

rotX in interface MovableSpatialObject

Parameters:

angle - The start angle

duration - The duration of the animation

Throws:

SuspendExecution

rotY

public void rotY(double angle,
                 TimeSpan duration)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Rotates the object about the y-axis using an animation.

Specified by:

rotY in interface MovableSpatialObject

Parameters:

angle - The start angle

duration - The duration of the animation

Throws:

SuspendExecution

rotZ

public void rotZ(double angle,
                 TimeSpan duration)
          throws SuspendExecution

Description copied from interface: MovableSpatialObject

Rotates the object about the z-axis using an animation.

Specified by:

rotZ in interface MovableSpatialObject

Parameters:

angle - The start angle

duration - The duration of the animation

Throws:

SuspendExecution

rotX

public void rotX(double angle)

Description copied from interface: SpatialObject

Adds a rotation about the x-axis to the current orientation.

Specified by:

rotX in interface SpatialObject

Overrides:

rotX in class SpatialSimProcess

Parameters:

angle - The rotation angle in radians

rotY

public void rotY(double angle)

Description copied from interface: SpatialObject

Adds a rotation about the y-axis to the current orientation.

Specified by:

rotY in interface SpatialObject

Overrides:

rotY in class SpatialSimProcess

Parameters:

angle - The rotation angle in radians

rotZ

public void rotZ(double angle)

Description copied from interface: SpatialObject

Adds a rotation about the z-axis to the current orientation.

Specified by:

rotZ in interface SpatialObject

Overrides:

rotZ in class SpatialSimProcess

Parameters:

angle - The rotation angle in radians

rotXConcurrent

public void rotXConcurrent(double angle,
                           TimeSpan duration)

Rotates the object about the x-axis using an animation. The difference to the rotX methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a movement can be performed while the object is rotating.

Parameters:

angle - The start angle

duration - The duration of the animation

rotYConcurrent

public void rotYConcurrent(double angle,
                           TimeSpan duration)

Rotates the object about the y-axis using an animation. The difference to the rotY methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a movement can be performed while the object is rotating.

Parameters:

angle - The start angle

duration - The duration of the animation

rotZConcurrent

public void rotZConcurrent(double angle,
                           TimeSpan duration)

Rotates the object about the z-axis using an animation. The difference to the rotZ methods is that this method won't passivate the MovableSpatialSimProcess after the execution so other actions like a movement can be performed while the object is rotating.

Parameters:

angle - The start angle

duration - The duration of the animation

sendToLocation

public void sendToLocation(SpatialObject destination)

Description copied from interface: MovableSpatialObject

Set this object to the position of the destination object and change the currentLocation to the destination object.

Specified by:

sendToLocation in interface MovableSpatialObject

Parameters:

destination - The destination this object will be send to.

sendToLocationEntryPoint

public void sendToLocationEntryPoint(SpatialObject destination,
                                     java.lang.String entryPoint)

Description copied from interface: MovableSpatialObject

Set this object to the position of the given entry point of the destination object. The currentLocation will also be changed to the destination object.

Specified by:

sendToLocationEntryPoint in interface MovableSpatialObject

Parameters:

destination - The destination object the currentLocation should be set to.

entryPoint - The specific entry point of the destination object.

sendToLocationExitPoint

public void sendToLocationExitPoint(SpatialObject destination,
                                    java.lang.String exitPoint)

Description copied from interface: MovableSpatialObject

Set this object to the position of the given exit point of the destination object. The currentLocation will also be changed to the destination object.

Specified by:

sendToLocationExitPoint in interface MovableSpatialObject

Parameters:

destination - The destination object the currentLocation should be set to.

exitPoint - The specific exit point of the destination object this object will be send to.

setAcc

public void setAcc(double acc)

Description copied from interface: MovableSpatialObject

Sets the acceleration of the object.

Specified by:

setAcc in interface MovableSpatialObject

Parameters:

acc - The acceleration

setDec

public void setDec(double dec)

Description copied from interface: MovableSpatialObject

Sets the negative acceleration of the object.

Specified by:

setDec in interface MovableSpatialObject

Parameters:

dec - The negative acceleration

setPosition

public void setPosition(Length x,
                        Length y,
                        Length z)

Description copied from interface: SpatialObject

It sets the new position for the object. *

Specified by:

setPosition in interface SpatialObject

Overrides:

setPosition in class SpatialSimProcess

Parameters:

x - The ExtendedLength which contains the new x-position.

y - The ExtendedLength which contains the new y-position.

z - The ExtendedLength which contains the new z-position.

setMaxSpeed

public void setMaxSpeed(double mSpeed)

Description copied from interface: MovableSpatialObject

Sets the maximum speed of this object

Specified by:

setMaxSpeed in interface MovableSpatialObject

Parameters:

mSpeed - The maximum speed of the object