org.jmol.viewer
Class TransformManager11

java.lang.Object
  org.jmol.viewer.TransformManager
      org.jmol.viewer.TransformManager11

 class TransformManager11
extends TransformManager

Nested Class Summary

Nested classes/interfaces inherited from class org.jmol.viewer.TransformManager

TransformManager.MotionThread, TransformManager.VibrationThread

Field Summary

private int	multiplier
private static int	NAV_MODE_IGNORE
private static int	NAV_MODE_NEWXY
private static int	NAV_MODE_NEWXYZ
private static int	NAV_MODE_NEWZ
private static int	NAV_MODE_NONE
private static int	NAV_MODE_RESET
private static int	NAV_MODE_ZOOMED
(package private) float	navigationDepth
private float	navigationSlabOffset
private int	navMode
private int	nHits
protected Point3f	ptMoveToCenter
private float	zoomFactor

Fields inherited from class org.jmol.viewer.TransformManager

aaTest1, antialias, aperatureAngle, arcBall0, arcBall0Rotation, arcBall1, arcBallAxis, cameraDepth, cameraDepthSetting, cameraDistance, cameraDistanceFromCenter, cameraScaleFactor, DEFAULT_NAV_FPS, DEFAULT_PERSPECTIVE_MODEL, DEFAULT_SPIN_FPS, DEFAULT_SPIN_Y, defaultMode, degreesPerRadian, depthPercentSetting, depthPlane, depthValue, fixedRotationAxis, fixedRotationCenter, fixedRotationOffset, fixedTranslation, frameOffset, frameOffsets, haveNotifiedNaN, height, internalRotationAxis, internalSlab, internalTranslation, isSpinFixed, isSpinInternal, isSpinSelected, matrixRotate, matrixStereo, matrixTemp, matrixTest, matrixTransform, matrixTransformInv, MAXIMUM_ZOOM_PERCENTAGE, MAXIMUM_ZOOM_PERSPECTIVE_DEPTH, mode, MODE_NAVIGATION, MODE_PERSPECTIVE_CENTER, MODE_STANDARD, modelCenterOffset, modelRadius, modelRadiusPixels, motion, navFps, navigating, navigationCenter, navigationOffset, navigationShiftXY, navOn, navX, navY, navZ, perspectiveDepth, perspectiveModel, perspectiveOffset, perspectiveShiftXY, point3fScreenTemp, point3iScreenTemp, previousX, previousY, prevZoomSetting, ptTest1, ptTest2, ptTest3, referencePlaneOffset, rotationAxis, rotationRate, scale3D, scale3DAngstromsPerInch, scaleDefaultPixelsPerAngstrom, scalePixelsPerAngstrom, screenHeight, screenPixelCount, screenWidth, slabEnabled, slabPercentSetting, slabPlane, slabRange, slabValue, spinFps, spinOn, spinX, spinY, spinZ, stereoColors, stereoDegrees, stereoFrame, stereoMode, stereoRadians, twoPI, untransformedPoint, vectorTemp, vibrationOn, vibrationPeriodMs, viewer, visualRange, width, windowCentered, xTranslationFraction, yTranslationFraction, zDepthPercentSetting, zDepthValue, zoomEnabled, zoomPercent, zoomPercentSetting, zoomRatio, zShadeEnabled, zSlabPercentSetting, zSlabPoint, zSlabValue

Constructor Summary

TransformManager11()

TransformManager11(Viewer viewer)

TransformManager11(Viewer viewer, int width, int height)

Method Summary

protected void	adjustTemporaryScreenPoint() adjusts the temporary point for perspective and offsets
(package private) void	alignZX(Point3f pt0, Point3f pt1, Point3f ptVectorWing) brings pt0-pt1 vector to [0 0 -1], then rotates about [0 0 1] until ptVectorWing is in xz plane
protected void	calcCameraFactors() sets all camera and scale factors needed by the specific perspective model instantiated
private void	calcNavigationDepthPercent()
protected void	calcNavigationPoint() All the magic happens here.
protected void	calcNavSlabAndDepthValues()
(package private) boolean	canNavigate()
(package private) Point3f	getNavigationCenter()
(package private) float	getNavigationDepthPercent()
(package private) Point3f	getNavigationOffset()
(package private) float	getNavigationOffsetPercent(char XorY)
private float	getNavigationSlabOffsetPercent()
protected String	getNavigationState()
protected String	getNavigationText(boolean addComments)
private float	getNavPtHeight()
protected float	getPerspectiveFactor(float z) calculate the perspective factor based on z
(package private) void	navigate(float seconds, Point3f pt) scripted entry point for navigation
(package private) void	navigate(float seconds, Point3f[][] pathGuide) follows a path guided by orientation and offset vectors (as Point3fs)
private void	navigate(float seconds, Point3f[][] pathGuide, Point3f[] path, float[] theta, int indexStart, int indexEnd)
(package private) void	navigate(float seconds, Point3f[] path, float[] theta, int indexStart, int indexEnd) scripted navigation
(package private) void	navigate(float seconds, Vector3f rotAxis, float degrees) scripted entry point for navigation
(package private) void	navigate(int keyCode, int modifiers) entry point for keyboard-based navigation
(package private) void	navigateSurface(float timeSeconds, String name)
private void	navigateSurface(int dz)
private void	navigateTo(float floatSecondsTotal, Vector3f axis, float degrees, Point3f center, float depthPercent, float xTrans, float yTrans)
(package private) void	navTranslate(float seconds, Point3f pt) scripted entry point for navigation
(package private) void	navTranslatePercent(float seconds, float x, float y) scripted entry point for navigation
private void	newNavigationCenter() We do not want the fixed navigation offset to change, but we need a new model-based equivalent position.
protected void	resetNavigationPoint(boolean doResetSlab) something has arisen that requires resetting of the navigation point.
protected void	setNavFps(int navFps)
private void	setNavigationDepthPercent(float percent)
(package private) void	setNavigationDepthPercent(float timeSec, float percent) sets the position of the navigation offset relative to the model (50% center; 0% rear, 100% front; can be <0 or >100)
protected void	setNavigationOffsetRelative(boolean navigatingSurface)
(package private) void	setNavigationSlabOffsetPercent(float percent)
(package private) void	setScreenParameters(int screenWidth, int screenHeight, boolean useZoomLarge, boolean antialias, boolean resetSlab, boolean resetZoom)
(package private) void	zoomByFactor(float factor, int x, int y)

Methods inherited from class org.jmol.viewer.TransformManager

angstromsToPixels, calcSlabAndDepthValues, calcTransformMatrix, centerAt, checkInternalSlab, clear, defaultScaleToScreen, depthByPercentagePoints, depthToPercent, finalizeTransformParameters, getAxisAngle, getCameraFactors, getFrontPlane, getMatrixRotate, getMatrixtransform, getMoveToText, getNavigationManager, getNavOn, getNewFixedRotationCenter, getOrientationInfo, getOrientationText, getPerspectiveDepth, getRotation, getRotationCenter, getRotationQuaternion, getRotationRadius, getRotationText, getSlabDepthPlane, getSlabPercentSetting, getSpinOn, getSpinState, getState, getStereoRotationMatrix, getTransformText, getTranslationScript, getTranslationXPercent, getTranslationYPercent, getTranslationZPercent, getUnscaledTransformMatrix, getZoomPercentFloat, getZoomSetting, homePosition, isInPosition, isNavigating, isVibrationOn, isWindowCentered, move, moveRotationCenter, moveTo, percentToPixels, rotateAboutPointsInternal, rotateArcBall, rotateAxisAngle, rotateAxisAngle, rotateAxisAngleAtCenter, rotateAxisAngleRadiansFixed, rotateAxisAngleRadiansInternal, rotateFront, rotatePoint, rotateX, rotateXRadians, rotateXYBy, rotateY, rotateYRadians, rotateZ, rotateZBy, rotateZRadians, scaleFitToScreen, scaleFitToScreen, scaleToPerspective, scaleToScreen, setAntialias, setCameraDepthPercent, setCenter, setCenterAt, setFrameOffset, setFrameOffsets, setNavigationMode, setNavOn, setNavXYZ, setNewRotationCenter, setPerspectiveDepth, setRotation, setRotationPointXY, setRotationRadius, setScaleAngstromsPerInch, setSlabDepthInternal, setSlabEnabled, setSlabRange, setSpinFps, setSpinOn, setSpinXYZ, setStereoDegrees, setStereoMode, setStereoMode, setTranslationFractions, setVibrationPeriod, setVibrationScale, setVibrationT, setViewer, setVisualRange, setWindowCentered, setZoomEnabled, setZShadeEnabled, setZslabPoint, slabByPercentagePoints, slabDepthByPercentagePoints, slabInternal, slabReset, slabToPercent, spinXYBy, stopMotion, transformPoint, transformPoint, transformPoint, transformPoint, transformPointNoClip, transformPointNoClip, transformPoints, transformVector, translateToPercent, translateXYBy, translateZBy, unscaleToScreen, unTransformPoint, zDepthToPercent, zoomBy, zoomByPercent, zoomToPercent, zSlabToPercent, zValueFromPercent

Methods inherited from class java.lang.Object

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

Field Detail

navigationSlabOffset

private float navigationSlabOffset

zoomFactor

private float zoomFactor

NAV_MODE_IGNORE

private static final int NAV_MODE_IGNORE

See Also:

Constant Field Values

NAV_MODE_ZOOMED

private static final int NAV_MODE_ZOOMED

See Also:

Constant Field Values

NAV_MODE_NONE

private static final int NAV_MODE_NONE

See Also:

Constant Field Values

NAV_MODE_RESET

private static final int NAV_MODE_RESET

See Also:

Constant Field Values

NAV_MODE_NEWXY

private static final int NAV_MODE_NEWXY

See Also:

Constant Field Values

NAV_MODE_NEWXYZ

private static final int NAV_MODE_NEWXYZ

See Also:

Constant Field Values

NAV_MODE_NEWZ

private static final int NAV_MODE_NEWZ

See Also:

Constant Field Values

navMode

private int navMode

navigationDepth

float navigationDepth

nHits

private int nHits

multiplier

private int multiplier

ptMoveToCenter

protected Point3f ptMoveToCenter

Constructor Detail

TransformManager11

TransformManager11()

TransformManager11

TransformManager11(Viewer viewer)

TransformManager11

TransformManager11(Viewer viewer,
                   int width,
                   int height)

Method Detail

setNavFps

protected void setNavFps(int navFps)

Overrides:

setNavFps in class TransformManager

zoomByFactor

void zoomByFactor(float factor,
                  int x,
                  int y)

Overrides:

zoomByFactor in class TransformManager

calcCameraFactors

protected void calcCameraFactors()

Description copied from class: TransformManager

sets all camera and scale factors needed by the specific perspective model instantiated

Specified by:

calcCameraFactors in class TransformManager

getPerspectiveFactor

protected float getPerspectiveFactor(float z)

Description copied from class: TransformManager

calculate the perspective factor based on z

Specified by:

getPerspectiveFactor in class TransformManager

Returns:

perspectiveFactor

adjustTemporaryScreenPoint

protected void adjustTemporaryScreenPoint()

Description copied from class: TransformManager

adjusts the temporary point for perspective and offsets

Specified by:

adjustTemporaryScreenPoint in class TransformManager

setScreenParameters

void setScreenParameters(int screenWidth,
                         int screenHeight,
                         boolean useZoomLarge,
                         boolean antialias,
                         boolean resetSlab,
                         boolean resetZoom)

Overrides:

setScreenParameters in class TransformManager

calcNavigationPoint

protected void calcNavigationPoint()

All the magic happens here.

Overrides:

calcNavigationPoint in class TransformManager

getNavPtHeight

private float getNavPtHeight()

calcNavSlabAndDepthValues

protected void calcNavSlabAndDepthValues()

newNavigationCenter

private void newNavigationCenter()

We do not want the fixed navigation offset to change, but we need a new model-based equivalent position. The fixed rotation center is at a fixed offset as well. This means that the navigationCenter must be recalculated based on its former offset in the new context. We have two points, N(navigation) and R(rotation). We know where they ARE: fixedNavigationOffset and fixedRotationOffset. From these we must derive navigationCenter.

canNavigate

boolean canNavigate()

Overrides:

canNavigate in class TransformManager

resetNavigationPoint

protected void resetNavigationPoint(boolean doResetSlab)

Description copied from class: TransformManager

something has arisen that requires resetting of the navigation point.

Overrides:

resetNavigationPoint in class TransformManager

setNavigationOffsetRelative

protected void setNavigationOffsetRelative(boolean navigatingSurface)

Overrides:

setNavigationOffsetRelative in class TransformManager

navigate

void navigate(int keyCode,
              int modifiers)

Description copied from class: TransformManager

entry point for keyboard-based navigation

Overrides:

navigate in class TransformManager

Parameters:

keyCode - 0 indicates key released

modifiers - shift,alt,ctrl

navigateSurface

private void navigateSurface(int dz)

navigate

void navigate(float seconds,
              Point3f pt)

Description copied from class: TransformManager

scripted entry point for navigation

Overrides:

navigate in class TransformManager

navigate

void navigate(float seconds,
              Vector3f rotAxis,
              float degrees)

Description copied from class: TransformManager

scripted entry point for navigation

Overrides:

navigate in class TransformManager

setNavigationDepthPercent

void setNavigationDepthPercent(float timeSec,
                               float percent)

Description copied from class: TransformManager

sets the position of the navigation offset relative to the model (50% center; 0% rear, 100% front; can be <0 or >100)

Overrides:

setNavigationDepthPercent in class TransformManager

navTranslate

void navTranslate(float seconds,
                  Point3f pt)

Description copied from class: TransformManager

scripted entry point for navigation

Overrides:

navTranslate in class TransformManager

navTranslatePercent

void navTranslatePercent(float seconds,
                         float x,
                         float y)

Description copied from class: TransformManager

scripted entry point for navigation

Overrides:

navTranslatePercent in class TransformManager

navigateTo

private void navigateTo(float floatSecondsTotal,
                        Vector3f axis,
                        float degrees,
                        Point3f center,
                        float depthPercent,
                        float xTrans,
                        float yTrans)

navigate

void navigate(float seconds,
              Point3f[][] pathGuide)

Description copied from class: TransformManager

follows a path guided by orientation and offset vectors (as Point3fs)

Overrides:

navigate in class TransformManager

navigate

void navigate(float seconds,
              Point3f[] path,
              float[] theta,
              int indexStart,
              int indexEnd)

Description copied from class: TransformManager

scripted navigation

Overrides:

navigate in class TransformManager

Parameters:

seconds - number of seconds to allow for total movement, like moveTo

path - sequence of points to turn into a hermetian path

theta - orientation angle along path (0 aligns with window Y axis) [or Z axis if path is vertical]

indexStart - index of first "station"

indexEnd - index of last "station" not implemented yet

navigate

private void navigate(float seconds,
                      Point3f[][] pathGuide,
                      Point3f[] path,
                      float[] theta,
                      int indexStart,
                      int indexEnd)

Parameters:

seconds -

pathGuide -

path -

theta -

indexStart -

indexEnd -

navigateSurface

void navigateSurface(float timeSeconds,
                     String name)

Overrides:

navigateSurface in class TransformManager

alignZX

void alignZX(Point3f pt0,
             Point3f pt1,
             Point3f ptVectorWing)

brings pt0-pt1 vector to [0 0 -1], then rotates about [0 0 1] until ptVectorWing is in xz plane

Parameters:

pt0 -

pt1 -

ptVectorWing -

getNavigationCenter

Point3f getNavigationCenter()

Overrides:

getNavigationCenter in class TransformManager

getNavigationDepthPercent

float getNavigationDepthPercent()

Overrides:

getNavigationDepthPercent in class TransformManager

setNavigationSlabOffsetPercent

void setNavigationSlabOffsetPercent(float percent)

Overrides:

setNavigationSlabOffsetPercent in class TransformManager

getNavigationSlabOffsetPercent

private float getNavigationSlabOffsetPercent()

getNavigationOffset

Point3f getNavigationOffset()

Overrides:

getNavigationOffset in class TransformManager

setNavigationDepthPercent

private void setNavigationDepthPercent(float percent)

calcNavigationDepthPercent

private void calcNavigationDepthPercent()

getNavigationOffsetPercent

float getNavigationOffsetPercent(char XorY)

Overrides:

getNavigationOffsetPercent in class TransformManager

Returns:

percent

getNavigationText

protected String getNavigationText(boolean addComments)

Overrides:

getNavigationText in class TransformManager

Returns:

navigation text if in navigation mode

getNavigationState

protected String getNavigationState()

Overrides:

getNavigationState in class TransformManager

Returns:

the script that defines the current navigation state