Utility blocks with mapping
for common WRM operations
Filename: J3duiBook/ lib/ j3dui/ utils/ blocks/ IntuitiveBlocks. java
...
/**
Creates an intuitive drag mapper and corresponding source
drag mapper, configures them for WRM translation, and
connects them to the target object.
@param target Target object.
@param wrmPlugin WRM plugin with pick engine and source
object list.
@param relative True if source drag actions are relative.
Typically, use false for real WRM and true otherwise. If
false should initialize target geometry using
updateActuation() instead of initActuation().
@param cumulative True if drag actions are cumulative.
Typically, use true if relative is true.
@return New building block. Should be connected to an
absolute input drag source.
*/
public static final InputDragTarget
buildWrmTranslationMapper(AffineGroup target,
WrmDragPlugin wrmPlugin, boolean relative,
boolean cumulative) {
// build source drag mapper
DirectSourceDragPlugin plugin =
new DirectSourceDragPlugin(target.getTail());
SourceDragMapper mapper = new SourceDragMapper(
target.getTranslation(), plugin);
mapper.setCumulative( cumulative);
// build relative source filter
SourceDragTarget filter;
if( relative) {
filter = new SourceDragFilter(
mapper, new RelativeSourceDragPlugin());
} else {
filter = mapper;
}
// build input drag mapper
return new IntuitiveDragMapper(filter, wrmPlugin);
}
/**
Creates an intuitive drag mapper and corresponding source
drag mapper, configures them for WRM spherical rotation, and
connects them to the target object.
@param target Target object.
@param wrmPlugin WRM plugin with pick engine and source
object list.
@param relative True if source drag actions are relative.
Typically, use false for real WRM and true otherwise. If
false should initialize target geometry using
updateActuation() instead of initActuation().
@param cumulative True if drag actions are cumulative.
Typically, use true for rotations in general.
@return New building block. Should be connected to an
absolute input drag source.
*/
public static final InputDragTarget
buildWrmSphereMapper(AxisAngleSphereGroup target,
WrmDragPlugin wrmPlugin, boolean relative,
boolean cumulative) {
AxisAngleSourceDragPlugin plugin;
SourceDragMapper mapper;
SourceDragSplitter splitter = new SourceDragSplitter();
// X axis
plugin = new AxisAngleSourceDragPlugin(target.getTail());
plugin.setTargetMap(Mapper.DIM_NONE, Mapper.DIM_W,
Mapper.DIM_NONE);
plugin.setAxis(new Vector3d(-1, 0, 0));
mapper = new SourceDragMapper(
target.getAxisAngleX(), plugin);
mapper.setCumulative(cumulative);
splitter.addEventTarget(mapper);
// Y axis
plugin = new AxisAngleSourceDragPlugin(target.getTail());
plugin.setTargetMap(Mapper.DIM_W, Mapper.DIM_NONE,
Mapper.DIM_NONE);
plugin.setAxis(new Vector3d( 0, 1, 0));
mapper = new SourceDragMapper(
target.getAxisAngleY(), plugin);
mapper.setCumulative(cumulative);
splitter.addEventTarget(mapper);
// build relative source filter
SourceDragTarget filter;
if( relative) {
filter = new SourceDragFilter(
splitter, new RelativeSourceDragPlugin());
} else {
filter = splitter;
}
// build input drag mapper
return new IntuitiveDragMapper(filter, wrmPlugin);
}
/**
Creates an intuitive drag mapper and corresponding source
drag mapper, configures them for sticky pseudo-WRM
translation with a target picker, and connects them to the
target object.
@param source Reference source object defining the picking
plane orientation.
@param target Target object.
@param root Scene graph pick root containing the target.
@param relative True if source drag actions are relative.
Typically, use false for real WRM and true otherwise. If
false should initialize target geometry using
updateActuation() instead of initActuation().
@param cumulative True if drag actions are cumulative.
Typically, use true if relative is true.
@return New building block. Should be connected to an
absolute input drag source.
*/
public static final InputDragTarget
buildStickyWrmTranslationMapper(Node source,
AffineGroup target, BranchGroup root, boolean relative,
boolean cumulative) {
// build target picker
ArrayList targetList = new ArrayList();
targetList.add(target);
PickEngine targetPicker = new PickEngine(
root, targetList);
// build mapper
InputDragTarget mapper = buildWrmTranslationMapper(
target, new PseudoWrmDragPlugin(source, targetPicker),
relative, cumulative);
return mapper;
}
...
19.5 SUMMARY
This chapter completes the presentation of the framework's implementation of 3D UI
control techniques. The workhorse of a 3D UI is object picking. For the purposes of
control, it forms the basis of intuitive control enabling, where user interaction is
directed only to the target object to which the mouse is pointing. Earlier chapters presented
an abbreviated form of the control chain that stretches from input device to tar-get
actuator. This chapter generalized that chain by introducing several additional
links, with the result being a more intuitive interactive experience for the user. Two
new spaces were introduced: the source drag space and the target drag space. In support
of these spaces, the framework provides several new building blocks, including an intuitive
drag mapper and a source drag mapper, and a new filter for operating in the 3D
source drag space. Examples demonstrated the control techniques of DRM and WRM
that were introduced in part 2 of the book. The examples also illustrated how these
techniques can be implemented using the framework core and utility building blocks.
New on the Java Boutique:
New Review:
Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling
API boasts simplicity, ease-of-integration, a well-rounded feature
set, and it's free!
New Applet:
Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA
sequences into three useful formats.
Elsewhere on internet.com:
WebDeveloper Java
Lots of Java information on webdeveloper.com
WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.
ScriptSearch Java
Hundreds of free Java code files to download.
jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.
