manifold.base
Interface Manipulator

All Known Implementing Classes:
DeleteTool.DeleteManipulator, DragBoxTool.DragManipulator, DragLineTool.DragManipulator, ManipulatorAdaptor

public interface Manipulator

Encapsulates Tool’s manipulation behavior and is responsible for providing visual feedback during a manipulation sequence. Typical visual feedback is achieved by redrawing a rubberband using the XOR technique.

This is the Controller part of the Model-View-Controller design pattern in that it converts the user interaction into the commands for the model.

Copyright (c) 2000 Rutgers, The State University of New Jersey

Since:
manifold %Version%
Version:
%Version%, %Time%

Method Summary
 Command click(java.lang.Object event)
          Click event to the manipulator.
 Command effect(java.lang.Object event)
          Finalizes the manipulation.
 Command grasp(java.lang.Object event)
          Begins the manipulation by grasping the event's source uform.
 Command manipulate(java.lang.Object event)
          Manipulates the source uform.
 

Method Detail

grasp

public Command grasp(java.lang.Object event)
Begins the manipulation by grasping the event's source uform.

Parameters:
event - event object encapsulation the information received from the input device
Returns:
Command to be passed to the domain for execution. The command is exectuted on the uform

manipulate

public Command manipulate(java.lang.Object event)
Manipulates the source uform.

Parameters:
event - event object encapsulation the information received from the input device
Returns:
Command to be passed to the domain for execution. The command is exectuted on the uform

effect

public Command effect(java.lang.Object event)
Finalizes the manipulation.

Parameters:
event - event object encapsulation the information received from the input device
Returns:
Command to be passed to the domain for execution. The command is exectuted on the uform

click

public Command click(java.lang.Object event)
Click event to the manipulator. E.g. used by tools creating objects with a mouse click.

Parameters:
event - event object encapsulation the information received from the input device
Returns:
Command to be passed to the domain for execution. The command is exectuted on the uform


Copyright (c) 2003 Rutgers, The State University of New Jersey