RMScene3D (ReportMill 13 API)

java.lang.Object
- com.reportmill.base.RMListenerList
- - com.reportmill.base.RMObject
  - - com.reportmill.shape.RMShape
    - - com.reportmill.shape.RMScene3D

All Implemented Interfaces:

DeepChangeListener, RMPropertyChanger, RMTypes, java.beans.PropertyChangeListener, java.lang.Cloneable, java.util.EventListener

Direct Known Subclasses:

RMGraphPart3D, RMGraphViewBar3D, RMGraphViewPie3D
```
public class RMScene3D
extends RMShape
```
This class manages a list of children and transforms them to 3D representations for display based on X and Y axis rotations. ReportMill 3D conventions: Coordinate system: Right handed (not left handed) Polygon front: Right hand rule (counter-clockwise defined polygons face forward) Transforms: Row major notation (as opposed to column major, points are assumed row vectors)

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class RMScene3D.RMShape3D
RMPolygon subclass that encapsulates a Path3D.
- Nested classes/interfaces inherited from interface com.reportmill.base.RMTypes
  RMTypes.AlignX, RMTypes.AlignY

Nested Classes
Modifier and Type	Class and Description
`static class`	`RMScene3D.RMShape3D` RMPolygon subclass that encapsulates a Path3D.

Field Summary

Fields
Modifier and Type Field and Description

int CONSTRAIN_NONE

int CONSTRAIN_PITCH

int CONSTRAIN_YAW
- Fields inherited from class com.reportmill.shape.RMShape
  WRAP_TYPE_BOTH, WRAP_TYPE_NONE

Fields
Modifier and Type	Field and Description
`int`	`CONSTRAIN_NONE`
`int`	`CONSTRAIN_PITCH`
`int`	`CONSTRAIN_YAW`

Constructor Summary

Constructors
Constructor and Description

RMScene3D()
Creates a new Scene3d.

Constructors
Constructor and Description
`RMScene3D()` Creates a new Scene3d.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`acceptsMouse()` Viewer method.
`void`	`addShape(RMShape aShape)` Adds a shape to the end of the shape list.
`void`	`addShape(RMShape aShape, int anIndex)` Adds a shape to the shape list at the given index.
`void`	`copy3D(RMScene3D aScene3D)` Copy 3D attributes only.
`RMShapeLayout`	`createLayout()` Create custom layout.
`boolean`	`equals(java.lang.Object anObj)` Standard equals implementation.
`boolean`	`equals3D(RMScene3D aScene3D)` Standard equals implementation.
`java.lang.Object`	`fromXMLShape(com.reportmill.archiver.RXArchiver anArchiver, com.reportmill.archiver.RXElement anElement, java.lang.Object anOwner)` XML unarchival.
`RMVector3D`	`getCamera()` Returns the camera as a vector.
`float`	`getDepth()` Returns the depth of the scene.
`float`	`getFieldOfView()` Returns the field of view of the camera (derived from focalLength).
`float`	`getFocalLength()` Returns the focal length of the camera (derived from the field of view and with view size).
`RMVector3D`	`getLight()` Returns the scene light as a vector.
`float`	`getOffsetZ()` Returns the Z offset of the scene (for zooming).
`RMPoint3D`	`getOrigin()` Returns the scene's origin.
`float`	`getPitch()` Returns the rotation about the X axis in degrees.
`float`	`getPseudoSkewX()` Returns the skew angle for X by Z.
`float`	`getPseudoSkewY()` Returns the skew angle for Y by Z.
`float`	`getRoll3D()` Returns the rotation about the Z axis in degrees.
`RMShape`	`getShape(int anIndex)` Returns the specific shape at the given index from the shape list.
`int`	`getShapeCount()` Returns the number of shapes in the shape list.
`RMTransform3D`	`getTransform3D()` Returns the transform 3d for the scene's camera.
`boolean`	`getValueIsAdjusting()` Returns whether scene3d is being re-oriented.
`float`	`getYaw()` Returns the rotation about the Y axis in degrees.
`boolean`	`isHittableChild(RMShape aChild)` Override to indicate that scene children are unhittable.
`boolean`	`isPseudo3D()` Returns whether scene is rendered in pseudo 3d.
`void`	`mouseDragged(RMShapeMouseEvent anEvent)` Viewer method.
`void`	`mousePressed(RMShapeMouseEvent anEvent)` Viewer method.
`void`	`mouseReleased(RMShapeMouseEvent anEvent)` Viewer method.
`void`	`removeShape(int anIndex)` Removes the shape at the given index from the shape list.
`void`	`resort()` Resorts child shapes from back to front.
`void`	`setColor(RMScene3D.RMShape3D aShape3D, RMColor aColor)` Sets the color for a 3d shape from a base color.
`void`	`setDefaultViewSettings()` Sets some reasonable default view settings.
`void`	`setDepth(float aValue)` Sets the depth of the scene.
`void`	`setFieldOfView(float aValue)` Sets the field of view of the camera.
`void`	`setFillAndStroke(RMScene3D.RMShape3D aShape3D, RMFill aFill, RMStroke aStroke, RMEffect anEffect)` Sets the fill and stroke of a 3D shape from a 2D shape.
`void`	`setFocalLength(float aValue)` Sets the focal length of the camera.
`void`	`setOffsetZ(float aValue)` Sets the Z offset of the scene (for zooming).
`void`	`setPitch(float aValue)` Sets the rotation about the X axis in degrees.
`void`	`setPseudo3D(boolean aFlag)` Sets whether scene is rendered in pseudo 3d.
`void`	`setPseudoSkewX(float anAngle)` Sets the skew angle for X by Z.
`void`	`setPseudoSkewY(float anAngle)` Sets the skew angle for Y by Z.
`void`	`setRoll3D(float aValue)` Sets the rotation about the Z axis in degrees.
`void`	`setYaw(float aValue)` Sets the rotation about the Y axis in degrees.
`com.reportmill.archiver.RXElement`	`toXMLShape(com.reportmill.archiver.RXArchiver anArchiver, java.lang.Object anOwner)` XML archival.
`void`	`toXMLShapeChildren(com.reportmill.archiver.RXArchiver anArchiver, com.reportmill.archiver.RXElement anElement, java.lang.Object anOwner)` XML archival of children - overrides shape implementation to suppress archival of generated 3D shapes.

Methods inherited from class com.reportmill.shape.RMShape
acceptsChildren, addAction, addActions, addBinding, addChild, addChild, addChild, addChild, addDeepChangeListener, addListener, addMouseListener, animUpdate, bounds, bringShapesToFront, childrenSuperSelectImmediately, clone, cloneDeep, contains, convertedPointFromShape, convertedPointToShape, convertedRectFromShape, convertedRectToShape, convertedSizeFromShape, convertedSizeToShape, convertedVectorFromShape, convertedVectorToShape, convertFromShape, convertPathFromShape, convertPathToShape, convertPointFromShape, convertPointToShape, convertRectFromShape, convertRectToShape, convertSizeFromShape, convertSizeToShape, convertToShape, convertVectorFromShape, convertVectorToShape, copyShape, createDivideShapeRemainder, createPartClone, deepChange, divideShapeFromEdge, divideShapeFromTop, doLayout, fromXML, fromXMLShapeChildren, fromXMLShapeLayout, get, get, getAction, getAlignmentX, getAlignmentY, getAncestor, getAncestorCount, getAncestorInCommon, getAnimator, getAnimator, getAutosizing, getAutosizingDefault, getBestHeight, getBestSize, getBestSize, getBestWidth, getBinding, getBinding, getBindingCount, getBounds, getBoundsInside, getBoundsMarked, getBoundsMarkedDeep, getBoundsOfChildren, getCausesWrap, getCausesWrapType, getChild, getChildAnimator, getChildAnimator, getChildArray, getChildClipShape, getChildContaining, getChildCount, getChildLast, getChildren, getChildrenIntersecting, getChildrenWhoCauseWrap, getChildrenWithClass, getChildrenWithClass, getChildWithClass, getChildWithName, getClipShape, getColor, getDatasetEntity, getDatasetKey, getDocument, getEffect, getEventAdapter, getFill, getFont, getFormat, getFrame, getFrame, getFrameMaxX, getFrameMaxY, getFrameX, getFrameXY, getFrameY, getHeight, getHover, getImageFill, getLayout, getLayout, getLayoutInfo, getLineWidth, getMaskPath, getMaximumSize, getMaximumSizeProperty, getMaxX, getMaxY, getMinimumSize, getMinimumSizeProperty, getName, getOpacity, getOpacityDeep, getOriginal, getOutline, getPageBreak, getPageBreakMax, getPageBreakPage, getPageBreakPageMax, getPageShape, getParent, getParentWithClass, getPart, getPartCount, getPartDeep, getPartDeepCount, getPath, getPathInBounds, getPreferredSize, getPreferredSize, getPreferredSizeProperty, getPropertyNameMapped, getPropertyNames, getReportMill, getRoll, getRootShape, getScaleX, getScaleY, getShapesToAncestor, getShapesToDescendant, getShapesToShape, getSize, getSizeP, getSkewX, getSkewY, getStroke, getStrokeColor, getStrokeWidth, getTextColor, getTimeline, getTimeline, getTransform, getTransformFromShape, getTransformInverse, getTransformToShape, getUndoer, getURL, getVisbileBounds, getVisibleBounds, getVisibleBounds, getVisibleBounds, getWidth, getX, getXY, getXYP, getY, height, indexOf, indexOfChild, intersects, isAncestor, isAnimProperty, isDescendant, isEditing, isEnabled, isHittable, isLocked, isMaximumSizeSet, isMinimumSizeSet, isRoot, isRSS, isShowing, isUnderlined, isViewing, isVisible, isVisibleChild, layoutReset, mouseClicked, mouseEntered, mouseExited, mouseMoved, notRSS, offsetChildrenXY, offsetXY, page, pageMax, paint, paintShape, paintShapeAll, paintShapeChildren, paintShapeOver, propertyChange, put, removeAction, removeBinding, removeBinding, removeChild, removeChild, removeChildren, removeDeepChangeListener, removeFromParent, removeMouseListener, repaint, repaint, resolvePageReferences, revalidate, sendShapesToBack, setAction, setAlignmentX, setAlignmentY, setAutosizing, setBestHeight, setBestSize, setBestSize, setBounds, setBounds, setCausesWrap, setCausesWrapType, setColor, setEffect, setEnabled, setFill, setFont, setFormat, setFrame, setFrame, setFrameSize, setFrameX, setFrameXY, setFrameXY, setFrameY, setHeight, setHover, setLayout, setLayoutInfo, setLineWidth, setLocked, setMaximumSize, setMinimumSize, setName, setOpacity, setOutline, setParent, setPreferredSize, setReportMill, setReportMillBindings, setReportMillDeep, setRoll, setScaleX, setScaleXY, setScaleY, setShowing, setSize, setSize, setSizeP, setSkewX, setSkewXY, setSkewY, setStroke, setStrokeColor, setStrokeWidth, setTextColor, setTime, setUnderlined, setURL, setVisible, setWidth, setX, setXY, setXY, setXYP, setY, superSelectable, toString, toXML, toXMLShapeLayout, undoerDisable, undoerEnable, undoerSetUndoTitle, validate, width, x, y

Methods inherited from class com.reportmill.base.RMObject
addPropertyChangeListener, removePropertyChangeListener

Methods inherited from class com.reportmill.base.RMListenerList
getListener, getListenerCount, getListenerCount, getListenerList, getListeners, hasListeners, removeListener

Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - CONSTRAIN_NONE
```
public final int CONSTRAIN_NONE
```
    See Also:
    Constant Field Values
  - CONSTRAIN_PITCH
```
public final int CONSTRAIN_PITCH
```
    See Also:
    Constant Field Values
  - CONSTRAIN_YAW
```
public final int CONSTRAIN_YAW
```
    See Also:
    Constant Field Values
- Constructor Detail
  - RMScene3D
```
public RMScene3D()
```
    Creates a new Scene3d.
- Method Detail
  - getDepth
```
public float getDepth()
```
    Returns the depth of the scene.
  - setDepth
```
public void setDepth(float aValue)
```
    Sets the depth of the scene.
  - getOrigin
```
public RMPoint3D getOrigin()
```
    Returns the scene's origin.
  - getYaw
```
public float getYaw()
```
    Returns the rotation about the Y axis in degrees.
  - setYaw
```
public void setYaw(float aValue)
```
    Sets the rotation about the Y axis in degrees.
  - getPitch
```
public float getPitch()
```
    Returns the rotation about the X axis in degrees.
  - setPitch
```
public void setPitch(float aValue)
```
    Sets the rotation about the X axis in degrees.
  - getRoll3D
```
public float getRoll3D()
```
    Returns the rotation about the Z axis in degrees.
  - setRoll3D
```
public void setRoll3D(float aValue)
```
    Sets the rotation about the Z axis in degrees.
  - getFocalLength
```
public float getFocalLength()
```
    Returns the focal length of the camera (derived from the field of view and with view size).
  - setFocalLength
```
public void setFocalLength(float aValue)
```
    Sets the focal length of the camera. Two feet is normal (1728 points).
  - getOffsetZ
```
public float getOffsetZ()
```
    Returns the Z offset of the scene (for zooming).
  - setOffsetZ
```
public void setOffsetZ(float aValue)
```
    Sets the Z offset of the scene (for zooming).
  - isPseudo3D
```
public boolean isPseudo3D()
```
    Returns whether scene is rendered in pseudo 3d.
  - setPseudo3D
```
public void setPseudo3D(boolean aFlag)
```
    Sets whether scene is rendered in pseudo 3d.
  - getPseudoSkewX
```
public float getPseudoSkewX()
```
    Returns the skew angle for X by Z.
  - setPseudoSkewX
```
public void setPseudoSkewX(float anAngle)
```
    Sets the skew angle for X by Z.
  - getPseudoSkewY
```
public float getPseudoSkewY()
```
    Returns the skew angle for Y by Z.
  - setPseudoSkewY
```
public void setPseudoSkewY(float anAngle)
```
    Sets the skew angle for Y by Z.
  - getFieldOfView
```
public float getFieldOfView()
```
    Returns the field of view of the camera (derived from focalLength).
  - setFieldOfView
```
public void setFieldOfView(float aValue)
```
    Sets the field of view of the camera.
  - setDefaultViewSettings
```
public void setDefaultViewSettings()
```
    Sets some reasonable default view settings.
  - getCamera
```
public RMVector3D getCamera()
```
    Returns the camera as a vector.
  - getLight
```
public RMVector3D getLight()
```
    Returns the scene light as a vector.
  - getShapeCount
```
public int getShapeCount()
```
    Returns the number of shapes in the shape list.
  - getShape
```
public RMShape getShape(int anIndex)
```
    Returns the specific shape at the given index from the shape list.
  - addShape
```
public void addShape(RMShape aShape)
```
    Adds a shape to the end of the shape list.
  - addShape
```
public void addShape(RMShape aShape,
            int anIndex)
```
    Adds a shape to the shape list at the given index.
  - removeShape
```
public void removeShape(int anIndex)
```
    Removes the shape at the given index from the shape list.
  - getTransform3D
```
public RMTransform3D getTransform3D()
```
    Returns the transform 3d for the scene's camera.
  - createLayout
```
public RMShapeLayout createLayout()
```
    Create custom layout.
  - setFillAndStroke
```
public void setFillAndStroke(RMScene3D.RMShape3D aShape3D,
                    RMFill aFill,
                    RMStroke aStroke,
                    RMEffect anEffect)
```
    Sets the fill and stroke of a 3D shape from a 2D shape.
  - setColor
```
public void setColor(RMScene3D.RMShape3D aShape3D,
            RMColor aColor)
```
    Sets the color for a 3d shape from a base color.
  - resort
```
public void resort()
```
    Resorts child shapes from back to front.
  - acceptsMouse
```
public boolean acceptsMouse()
```
    Viewer method.
    
    Overrides:
    
    acceptsMouse in class RMShape
  - mousePressed
```
public void mousePressed(RMShapeMouseEvent anEvent)
```
    Viewer method.
    
    Overrides:
    
    mousePressed in class RMShape
  - mouseDragged
```
public void mouseDragged(RMShapeMouseEvent anEvent)
```
    Viewer method.
    
    Overrides:
    
    mouseDragged in class RMShape
  - mouseReleased
```
public void mouseReleased(RMShapeMouseEvent anEvent)
```
    Viewer method.
    
    Overrides:
    
    mouseReleased in class RMShape
  - getValueIsAdjusting
```
public boolean getValueIsAdjusting()
```
    Returns whether scene3d is being re-oriented.
  - isHittableChild
```
public boolean isHittableChild(RMShape aChild)
```
    Override to indicate that scene children are unhittable.
    
    Overrides:
    
    isHittableChild in class RMShape
  - equals
```
public boolean equals(java.lang.Object anObj)
```
    Standard equals implementation.
    
    Overrides:
    
    equals in class RMShape
  - equals3D
```
public boolean equals3D(RMScene3D aScene3D)
```
    Standard equals implementation.
  - copy3D
```
public void copy3D(RMScene3D aScene3D)
```
    Copy 3D attributes only.
  - toXMLShape
```
public com.reportmill.archiver.RXElement toXMLShape(com.reportmill.archiver.RXArchiver anArchiver,
                                           java.lang.Object anOwner)
```
    XML archival.
    
    Overrides:
    
    toXMLShape in class RMShape
  - toXMLShapeChildren
```
public void toXMLShapeChildren(com.reportmill.archiver.RXArchiver anArchiver,
                      com.reportmill.archiver.RXElement anElement,
                      java.lang.Object anOwner)
```
    XML archival of children - overrides shape implementation to suppress archival of generated 3D shapes.
    
    Overrides:
    
    toXMLShapeChildren in class RMShape
  - fromXMLShape
```
public java.lang.Object fromXMLShape(com.reportmill.archiver.RXArchiver anArchiver,
                            com.reportmill.archiver.RXElement anElement,
                            java.lang.Object anOwner)
```
    XML unarchival.
    
    Overrides:
    
    fromXMLShape in class RMShape

Class RMScene3D

Nested Class Summary

Nested classes/interfaces inherited from interface com.reportmill.base.RMTypes

Field Summary

Fields inherited from class com.reportmill.shape.RMShape

Constructor Summary

Method Summary

Methods inherited from class com.reportmill.shape.RMShape

Methods inherited from class com.reportmill.base.RMObject

Methods inherited from class com.reportmill.base.RMListenerList

Methods inherited from class java.lang.Object

Field Detail

CONSTRAIN_NONE

CONSTRAIN_PITCH

CONSTRAIN_YAW

Constructor Detail

RMScene3D

Method Detail

getDepth

setDepth

getOrigin

getYaw

setYaw

getPitch

setPitch

getRoll3D

setRoll3D

getFocalLength

setFocalLength

getOffsetZ

setOffsetZ

isPseudo3D

setPseudo3D

getPseudoSkewX

setPseudoSkewX

getPseudoSkewY

setPseudoSkewY

getFieldOfView

setFieldOfView

setDefaultViewSettings

getCamera

getLight

getShapeCount

getShape

addShape

addShape

removeShape

getTransform3D

createLayout

setFillAndStroke

setColor

resort

acceptsMouse

mousePressed

mouseDragged

mouseReleased

getValueIsAdjusting

isHittableChild

equals

equals3D

copy3D

toXMLShape

toXMLShapeChildren

fromXMLShape