|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectsim.portrayal3d.SimplePortrayal3D
sim.portrayal3d.simple.PrimitivePortrayal3D
public abstract class PrimitivePortrayal3D
An abstract superclass for portrayals involving Shape3D or various Primitive (sphere, cone, etc.) objects. The default size for these objects is to have an approximately 1.0f diameter.
The objects are pickable by default, though you can change this by calling setPickable(). This must be called prior to the first call to getModel(...) (or if you override getModel(...), prior to your calling of super.getModel(...)).
The objects are can also have an optional internal Transform3D through which they may be rotated or scaled etc. Note that adding this Transform3D also adds additonal overhead, slowing down the model by perhaps 25%. To add this Transform3D, call setTransform() or setScale() at prior to the first call to getModel(...) (or if you override getModel(...), prior to your calling of super.getModel(...)). Once you have done this, you may change the scaling or transform again with these methods at any time, preferably during getModel(...).
The objects also have an appearance. To set the appearance, call setAppearance().
Field Summary |
---|
Fields inherited from class sim.portrayal3d.SimplePortrayal3D |
---|
DEFAULT_APPEARANCE, parentPortrayal |
Constructor Summary | |
---|---|
PrimitivePortrayal3D()
|
Method Summary | |
---|---|
protected javax.media.j3d.Appearance |
getAppearance(javax.media.j3d.TransformGroup j3dModel)
Returns an appearance object suitable to set in setAppearance(...). |
javax.media.j3d.TransformGroup |
getModel(java.lang.Object obj,
javax.media.j3d.TransformGroup j3dModel)
We suggest that if you wish to override this to change the appearance or scale or transform of the underlying model, do the changes first and THEN call super.getModel(obj, j3dModel). |
protected javax.media.j3d.Shape3D |
getShape(javax.media.j3d.TransformGroup j3dModel,
int shapeIndex)
Returns the shape by the given index. |
protected abstract int |
numShapes()
Returns the number of shapes handled by this primitive or Shape3D. |
protected void |
setAppearance(javax.media.j3d.TransformGroup j3dModel,
javax.media.j3d.Appearance app)
Sets the Appearance of the portrayal. |
void |
setPickable(boolean val)
|
protected boolean |
setScale(javax.media.j3d.TransformGroup j3dModel,
float val)
Sets the Transform3D of the portrayal to a given scaling value, if there *is* a transform (in some cases, such as ValuePortrayal3D, there won't be any). |
static void |
setShape3DFlags(javax.media.j3d.Shape3D shape)
Sets common Shape3D flags to make its appearance and geometry easy to modify. |
protected boolean |
setTransform(javax.media.j3d.TransformGroup j3dModel,
javax.media.j3d.Transform3D transform)
Sets the Transform3D of the portrayal, if there is one (in some cases, such as ValuePortrayal3D, there won't be any). |
Methods inherited from class sim.portrayal3d.SimplePortrayal3D |
---|
appearanceForColor, appearanceForColors, appearanceForImage, clearPickableFlags, getInspector, getName, getStatus, isSelected, polygonAttributes, setAppearanceFlags, setParentPortrayal, setPickableFlags, setPickableFlags, setSelected |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PrimitivePortrayal3D()
Method Detail |
---|
public static void setShape3DFlags(javax.media.j3d.Shape3D shape)
protected javax.media.j3d.Shape3D getShape(javax.media.j3d.TransformGroup j3dModel, int shapeIndex)
protected javax.media.j3d.Appearance getAppearance(javax.media.j3d.TransformGroup j3dModel)
protected boolean setTransform(javax.media.j3d.TransformGroup j3dModel, javax.media.j3d.Transform3D transform)
protected boolean setScale(javax.media.j3d.TransformGroup j3dModel, float val)
protected void setAppearance(javax.media.j3d.TransformGroup j3dModel, javax.media.j3d.Appearance app)
protected abstract int numShapes()
public void setPickable(boolean val)
public javax.media.j3d.TransformGroup getModel(java.lang.Object obj, javax.media.j3d.TransformGroup j3dModel)
getModel
in interface Portrayal3D
getModel
in class SimplePortrayal3D
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |