Package com.j3d.engine.interact.cmd.commands.transform

Class RotateSelection

java.lang.Object

com.j3d.engine.interact.cmd.base.Command

com.j3d.engine.interact.cmd.args.Subcommand

com.j3d.engine.interact.cmd.commands.transform.AbstractTransform

com.j3d.engine.interact.cmd.commands.transform.RotateSelection

All Implemented Interfaces:

Argument, KeyedStatefulCommand, SemiStatefulCommand, StatefulCommand<Void>, EventListener

public class RotateSelection
extends AbstractTransform

A sub-command of TransformCmd who uses the handles made by AbstractTransform and the key-setters provided by AbstractTransform from KeyedStatefulCommand to rotate a selection of points or triangles around a given axis.

As like any other implementor of AbstractTransform, rotate provides the following functions based on the given input:

• (No Handle Selected) + UP/DOWN KEY : +/-(Z Axis)
• (No Handle Selected) + UP/DOWN KEY (Arbitrary Axis) : +/-(Y Axis)
• X Handle + UP/DOWN KEY : +/-(X Axis)
• Y Handle + UP/DOWN KEY : +/-(Y Axis)
• Z Handle + UP/DOWN KEY : +/-(Z Axis)

Aliases: rot, r

Unlike other AbstractTransform implementors, rotate provides a second (third when used) optional TypedArg which expects a Vector3 for an arbitrary axis to rotate around.

The mouse owner for rotate (RotateMouseOwner) actually provides a line indicating the actual axis you're about to rotate around (Only when a handle is selected. not including an arbitrary axis)

Typical Usage:

     transform rotate             - Rotate Faces
     trans rot p                  - Rotate Points
     trans rot f (0, 0.2, 1.42)   - Rotate Faces around the Vector3 axis (0, 0.2, 1.42)
     selection r v (1, 0.3, 0.5)  - Rotate Points around the Vector3 axis (1, 0.3, 0.5)
     

See AbstractTransform for more information onthe distinction between point mode and face mode.

Author:

Lehlogonolo Poole

See Also:

• TransformCmd
• AbstractTransform
• KeyedStatefulCommand
• StatefulCommand
• RotateMouseOwner
• ArgSet
• HandleType

Field Summary

Fields

Modifier and Type	Field	Description
private Vector3	axis
static RotateMouseOwner	rotateMouseOwner

Fields inherited from class com.j3d.engine.interact.cmd.commands.transform.AbstractTransform

argSet, center, currentIndex, eventName, faceMode, gear, gearTrain, keys, label, originalPointPos, overlapId, references

Fields inherited from class com.j3d.engine.interact.cmd.base.Command

aliases, args, description, usages

Constructor Summary

Constructors

Constructor	Description
RotateSelection()

Method Summary

Modifier and Type	Method	Description
void	rotateDownKey(Vector3 a, GPoint gPoint)
void	rotateUpKey(Vector3 a, GPoint gPoint)
void	run(Invoker invoker, SafeJLabel logLabel, String aliasUsed, Object[] args, ArrayList<TaggedArgValue<?>> taggedArgs)	The main entry point for the command.

Methods inherited from class com.j3d.engine.interact.cmd.commands.transform.AbstractTransform

finished, getCurrentStepSize, getGearIndex, getGearTrain, getKeys, getOriginalPointPositions, getReferences, onEnter, onEsc, onEvent, onStart, selfName, setGearIndex

Methods inherited from class com.j3d.engine.interact.cmd.args.Subcommand

getDescription, getName, isOptional

Methods inherited from class com.j3d.engine.interact.cmd.base.Command

addNoArgUsage, aliases, aliasStream, args, dispatchToSubcommands, getUsages, hasNoArgs, parseUsages, usages, varTaggedArgs

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.j3d.engine.interact.cmd.base.KeyedStatefulCommand

newGearKey, setDownKey, setKey, setKeyAsSideEffects, setLeftKey, setRightKey, setUpKey

Methods inherited from interface com.j3d.engine.interact.cmd.base.SemiStatefulCommand

fire

Methods inherited from interface com.j3d.engine.interact.cmd.base.StatefulCommand

run, run

Field Details

rotateMouseOwner

public static RotateMouseOwner rotateMouseOwner

axis

private Vector3 axis

Constructor Details

RotateSelection

RotateSelection()

Method Details

run

public void run(Invoker invoker,
 SafeJLabel logLabel,
 String aliasUsed,
 Object[] args,
 ArrayList<TaggedArgValue<?>> taggedArgs)

Description copied from class: AbstractTransform

The main entry point for the command. It gathers the selected objects and initiates the stateful transformation mode.

Overrides:

run in class AbstractTransform

Parameters:

invoker - The invoker of this command

logLabel - The JLabel to display log messages.

aliasUsed - The alias of the command that was used to invoke it.

args - The arguments passed to the command.

taggedArgs - Tagged arguments passed to the command.

rotateUpKey

public void rotateUpKey(Vector3 a,
 GPoint gPoint)

rotateDownKey

public void rotateDownKey(Vector3 a,
 GPoint gPoint)