Graphics3D

java.lang.Object
- org.jmol.util.GData
- - org.jmol.g3d.Graphics3D

All Implemented Interfaces:

JmolGraphicsInterface, JmolRendererInterface
```
public final class Graphics3D
extends GData
implements JmolRendererInterface
```
Provides high-level graphics primitives for 3D visualization for the software renderers. These methods should not have to be used with WebGL or OpenGL or other hardware accelerators. This module is linked to via reflection from org.jmol.viewer.Viewer Bob Hanson 9/2/2012
A pure software implementation of a 3D graphics engine. No hardware required. Depending upon what you are rendering ... some people say it is pretty fast.

Author:

Miguel, miguel@jmol.org with additions by Bob Hanson hansonr@stolaf.edu The above is an understatement to say the least. This is a two-pass rendering system. In the first pass, all opaque objects are rendered. In the second pass, all translucent objects are rendered. If there are no translucent objects, then that is found in the first pass as follows: The renderers first try to set the color index of the object to be rendered using setColix(short colix), and that method returns false if we are in the wrong pass for that type of object. In addition, setColix records in the boolean haveTranslucentObjects whether a translucent object was seen in the first pass. The second pass is skipped if this flag is not set. This saves immensely on rendering time when there are no translucent objects. THUS, IT IS CRITICAL THAT ALL RENDERING OPTIONS CHECK THE COLIX USING g3d.setColix(short colix) PRIOR TO RENDERING. Translucency is rendered only approximately. We can't maintain a full buffer of all translucent objects. Instead, we "cheat" by maintaining one translucent z buffer. When a translucent pixel is to be written, its z position is checked and... ...if it is behind or at the z position of any pixel, it is ignored ...if it is in front of a translucent pixel, it is added to the translucent buffer ...if it is between an opaque and translucent pixel, the translucent pixel is turned opaque, and the new pixel is added to the translucent buffer This guarantees accurate translucency when there are no more than two translucent pixels between the user and an opaque pixel. It's a fudge, for sure. But it is pretty good, and certainly fine for "draft" work. Users needing more accurate translucencty are encouraged to use the POV-Ray export facility for production-level work. Antialiasing is accomplished as full scene antialiasing. This means that the width and height are doubled (both here and in TransformManager), the scene is rendered, and then each set of four pixels is averaged (roughly) as the final pixel in the width*height buffer. Antialiasing options allow for antialiasing of all objects: antialiasDisplay = true antialiasTranslucent = true or just the opaque ones: antialiasDisplay = true antialiasTranslucent = false or not at all: antialiasDisplay = false The difference will be speed and memory. Adding translucent objects doubles the buffer requirement, and adding antialiasing quadruples the buffer requirement. So we have: Memory requirements are significant, in multiples of (width) * (height) 32-bit integers: antialias OFF ON/opaque only ON/all objects no translucent 1p + 1z = 2 4p + 4z = 8 4p + 4z = 8 objects with translucent 2p + 2z = 4 5p + 5z = 10 8p + 8z = 16 objects Note that no antialising at all is required for POV-Ray output. POV-Ray will do antialiasing on its own. In principle we could save a bit in the case of antialiasing of just opaque objects and reuse the p and z buffers for the translucent buffer, but this hasn't been implemented because the savings isn't that great, and if you are going to the trouble of having antialiasing, you probably what it all.

Field Summary

Fields
Modifier and Type	Field and Description
`private boolean`	`addAllPixels`
`private byte[]`	`anaglyphChannelBytes`
`private int`	`anaglyphLength`
`private boolean`	`antialias2`
`private int`	`argbNoisyDn`
`private int`	`argbNoisyUp`
`private CircleRenderer`	`circle3d`
`private JmolFont`	`currentFont`
`private boolean`	`currentlyRendering`
`private int`	`currentShadeIndex`
`private CylinderRenderer`	`cylinder3d`
`private boolean`	`haveTranslucentObjects`
`private HermiteRenderer`	`hermite3d`
`private boolean`	`isFullSceneAntialiasingEnabled`
`private boolean`	`isScreened`
`private int`	`lastRawColor`
`(package private) LineRenderer`	`line3d`
`private static short`	`normixCount`
`private static byte`	`nullShadeIndex`
`protected int[]`	`pbuf`
`protected int[]`	`pbufT`
`private Pixelator`	`pixel`
`(package private) Platform3D`	`platform`
`private int`	`saveAmbient`
`private int`	`saveDiffuse`
`private byte[]`	`shadeIndexes`
`private byte[]`	`shadeIndexes2Sided`
`private int[]`	`shadesCurrent`
`static java.util.Comparator<TextString>`	`sort`
`private SphereRenderer`	`sphere3d`
`private int`	`stringCount`
`private TextString[]`	`strings`
`private V3[]`	`transformedVectors`
`private int`	`translucencyLog`
`protected int`	`translucencyMask`
`private TriangleRenderer`	`triangle3d`
`private boolean`	`twoPass`
`private V3`	`vectorAB`
`private V3`	`vectorAC`
`private V3`	`vectorNormal`
`protected int[]`	`zbuf`
`protected int[]`	`zbufT`
`protected int`	`zMargin`

Fields inherited from class org.jmol.util.GData
antialiasEnabled, antialiasThisFrame, apiPlatform, argbCurrent, backgroundImage, bgcolor, bufferSize, changeableColixMap, colixCurrent, depth, displayMaxX, displayMaxY, displayMinX, displayMinY, ENDCAPS_FLAT, ENDCAPS_NONE, ENDCAPS_OPEN, ENDCAPS_OPENEND, ENDCAPS_SPHERICAL, EXPORT_CARTESIAN, EXPORT_NOT, EXPORT_RAYTRACER, graphicsForMetrics, height, inGreyscaleMode, isPass2, newAntialiasing, newWindowHeight, newWindowWidth, shader, slab, translucentCoverOnly, width, windowHeight, windowWidth, xGT, xLast, xLT, yGT, yLast, yLT, zDepth, zGT, zLT, zShadeB, zShadeG, zShadePower, zShadeR, zSlab

Constructor Summary

Constructors
Constructor and Description

Graphics3D()

Constructors
Constructor and Description
`Graphics3D()`

Method Summary

Methods
Modifier and Type	Method and Description
`(package private) void`	`addPixel(int offset, int z, int p)`
`void`	`applyAnaglygh(EnumStereoMode stereoMode, int[] stereoColors)`
`void`	`applyBlueAnaglyph()`
`void`	`applyCustomAnaglyph(int[] stereoColors)`
`void`	`applyCyanAnaglyph()`
`void`	`applyGreenAnaglyph()`
`void`	`beginRendering(Matrix3f rotationMatrix, boolean translucentMode, boolean isImageWrite)`
`boolean`	`canDoTriangles()`
`boolean`	`checkTranslucent(boolean isAlphaTranslucent)`
`void`	`clear()`
`void`	`clearFontCache()`
`(package private) void`	`clearPixel(int offset, int z)`
`boolean`	`currentlyRendering()`
`void`	`destroy()`
`private void`	`downsampleFullSceneAntialiasing(boolean downsampleZBuffer)`
`void`	`drawAtom(Atom atom)`
`void`	`drawBond(P3 atomA, P3 atomB, short colixA, short colixB, byte endcaps, short mad, int bondOrder)`
`void`	`drawDashedLine(int run, int rise, P3i pointA, P3i pointB)`
`void`	`drawDottedLine(P3i pointA, P3i pointB)`
`boolean`	`drawEllipse(P3 ptAtom, P3 ptX, P3 ptY, boolean fillArc, boolean wireframeOnly)`
`void`	`drawFilledCircle(short colixRing, short colixFill, int diameter, int x, int y, int z)` draws a ring and filled circle (halos, draw CIRCLE, draw handles)
`void`	`drawHermite4(int tension, P3i s0, P3i s1, P3i s2, P3i s3)`
`void`	`drawHermite7(boolean fill, boolean border, int tension, P3i s0, P3i s1, P3i s2, P3i s3, P3i s4, P3i s5, P3i s6, P3i s7, int aspectRatio, short colixBack)`
`private void`	`drawHLine(int x, int y, int z, int w)`
`void`	`drawImage(java.lang.Object objImage, int x, int y, int z, int zSlab, short bgcolix, int width, int height)`
`void`	`drawLine(short colixA, short colixB, int x1, int y1, int z1, int x2, int y2, int z2)`
`void`	`drawLineAB(P3i pointA, P3i pointB)`
`void`	`drawLineXYZ(int x1, int y1, int z1, int x2, int y2, int z2)`
`void`	`drawPixel(int x, int y, int z)`
`void`	`drawPoints(int count, int[] coordinates, int scale)`
`void`	`drawQuadrilateral(short colix, P3i screenA, P3i screenB, P3i screenC, P3i screenD)`
`void`	`drawRect(int x, int y, int z, int zSlab, int rWidth, int rHeight)` draws a rectangle
`void`	`drawString(java.lang.String str, JmolFont font3d, int xBaseline, int yBaseline, int z, int zSlab, short bgColix)` draws the specified string in the current font.
`void`	`drawStringNoSlab(java.lang.String str, JmolFont font3d, int xBaseline, int yBaseline, int z, short bgColix)` draws the specified string in the current font.
`void`	`drawSurface(MeshSurface meshSurface, short colix)`
`void`	`drawTriangle3C(P3i screenA, short colixA, P3i screenB, short colixB, P3i screenC, short colixC, int check)`
`void`	`drawTriangle3I(P3i screenA, P3i screenB, P3i screenC, int check)`
`private void`	`drawVLine(int x, int y, int z, int h)`
`void`	`endRendering()`
`void`	`fillConeSceen3f(byte endcap, int screenDiameter, P3 screenBase, P3 screenTip)`
`void`	`fillConeScreen(byte endcap, int screenDiameter, P3i screenBase, P3i screenTip, boolean isBarb)`
`void`	`fillCylinder(byte endcaps, int diameter, P3i screenA, P3i screenB)`
`void`	`fillCylinderBits(byte endcaps, int diameter, P3 screenA, P3 screenB)`
`void`	`fillCylinderScreen(byte endcaps, int diameter, int xA, int yA, int zA, int xB, int yB, int zB)`
`void`	`fillCylinderScreen3I(byte endcaps, int diameter, P3i screenA, P3i screenB, P3 pt0f, P3 pt1f, float radius)`
`void`	`fillCylinderXYZ(short colixA, short colixB, byte endcaps, int diameter, int xA, int yA, int zA, int xB, int yB, int zB)`
`void`	`fillEllipsoid(P3 center, P3[] points, int x, int y, int z, int diameter, Matrix3f mToEllipsoidal, double[] coef, Matrix4f mDeriv, int selectedOctant, P3i[] octantPoints)`
`void`	`fillHermite(int tension, int diameterBeg, int diameterMid, int diameterEnd, P3i s0, P3i s1, P3i s2, P3i s3)`
`void`	`fillQuadrilateral(P3 screenA, P3 screenB, P3 screenC, P3 screenD)`
`void`	`fillQuadrilateral3i(P3i screenA, short colixA, short normixA, P3i screenB, short colixB, short normixB, P3i screenC, short colixC, short normixC, P3i screenD, short colixD, short normixD)`
`void`	`fillRect(int x, int y, int z, int zSlab, int widthFill, int heightFill)` fills background rectangle for label
`void`	`fillSphere(int diameter, P3 center)` fills a solid sphere
`void`	`fillSphereI(int diameter, P3i center)` fills a solid sphere
`void`	`fillSphereXYZ(int diameter, int x, int y, int z)` fills a solid sphere
`void`	`fillTriangle(P3i screenA, short colixA, short normixA, P3i screenB, short colixB, short normixB, P3i screenC, short colixC, short normixC, float factor)`
`void`	`fillTriangle3CN(P3i screenA, short colixA, short normixA, P3i screenB, short colixB, short normixB, P3i screenC, short colixC, short normixC)`
`void`	`fillTriangle3f(P3 screenA, P3 screenB, P3 screenC, boolean setNoisy)`
`void`	`fillTriangle3i(P3i screenA, P3i screenB, P3i screenC, P3 ptA, P3 ptB, P3 ptC)`
`void`	`fillTriangleTwoSided(short normix, int xScreenA, int yScreenA, int zScreenA, int xScreenB, int yScreenB, int zScreenB, int xScreenC, int yScreenC, int zScreenC)`
`java.lang.String`	`finalizeOutput()`
`java.lang.String`	`getExportName()`
`int`	`getExportType()`
`JmolFont`	`getFont3DCurrent()`
`GData`	`getGData()` underlying GData object handles all general graphics setup.
`double`	`getPrivateKey()`
`java.lang.Object`	`getScreenImage(boolean isImageWrite)`
`int`	`getShadeIndex(short normix)`
`private int`	`getShadeIndexP3(P3 screenA, P3 screenB, P3 screenC)`
`V3[]`	`getTransformedVertexVectors()`
`boolean`	`hasContent()`
`boolean`	`haveTranslucentObjects()`
`void`	`initialize(ApiPlatform apiPlatform)`
`JmolRendererInterface`	`initializeExporter(java.lang.String type, Viewer viewer, double privateKey, GData g3d, java.lang.Object output)`
`boolean`	`initializeOutput(java.lang.String type, Viewer viewer, double privateKey, GData gdata, java.lang.Object object)`
`boolean`	`isCartesianExport()`
`boolean`	`isDirectedTowardsCamera(short normix)`
`(package private) static void`	`mergeBufferPixel(int[] pbuf, int offset, int argbB, int bgcolor)`
`(package private) void`	`mergeOpaqueAndTranslucentBuffers()`
`void`	`plotImage(int x, int y, int z, java.lang.Object image, JmolRendererInterface jmolRenderer, short bgcolix, int width, int height)`
`void`	`plotImagePixel(int argb, int x, int y, int z, int shade, int bgargb)`
`(package private) void`	`plotPixelClippedArgb(int argb, int x, int y, int z)`
`void`	`plotPixelClippedP3i(P3i screen)`
`(package private) void`	`plotPixelClippedScreened(int argb, boolean isScreened, int x, int y, int z)`
`(package private) void`	`plotPixelClippedXYZ(int x, int y, int z)`
`(package private) void`	`plotPixelsClipped(int count, int x, int y, int z)`
`(package private) void`	`plotPixelsClippedRaster(int count, int x, int y, int zAtLeft, int zPastRight, Rgb16 rgb16Left, Rgb16 rgb16Right)`
`(package private) void`	`plotPixelsUnclippedCount(int count, int x, int y, int z)`
`(package private) void`	`plotPixelsUnclippedRaster(int count, int x, int y, int zAtLeft, int zPastRight, Rgb16 rgb16Left, Rgb16 rgb16Right)`
`(package private) void`	`plotPixelUnclipped(int x, int y, int z)`
`(package private) void`	`plotPixelUnclippedArgb(int argb, int x, int y, int z)`
`private void`	`plotPoints(int count, int[] coordinates, int xOffset, int yOffset)`
`void`	`plotText(int x, int y, int z, int argb, int bgargb, java.lang.String text, JmolFont font3d, JmolRendererInterface jmolRenderer)`
`private void`	`releaseBuffers()`
`void`	`releaseScreenImage()`
`void`	`renderAllStrings(java.lang.Object jmolRenderer)`
`void`	`renderBackground(JmolRendererInterface jmolRenderer)`
`void`	`renderCrossHairs(int[] minMax, int screenWidth, int screenHeight, P3 navOffset, float navDepth)`
`void`	`setBackgroundTransparent(boolean TF)`
`boolean`	`setColix(short colix)` sets current color from colix color index
`void`	`setColor(int argb)`
`(package private) void`	`setColorNoisy(int shadeIndex)`
`void`	`setFont(JmolFont font3d)`
`void`	`setFontFid(byte fid)`
`void`	`setNoisySurfaceShade(P3i screenA, P3i screenB, P3i screenC)` used by CartoonRenderer (DNA surface) and GeoSurfaceRenderer (face) to assign a noisy shade to the surface it will render
`boolean`	`setPass2(boolean antialiasTranslucent)`
`void`	`setRotationMatrix(Matrix3f rotationMatrix)`
`void`	`setTempZSlab(int zSlab)`
`private void`	`setTriangleColixAndShadeIndex(short colix, int shadeIndex)`
`private boolean`	`setTriangleTranslucency(short colixA, short colixB, short colixC)`
`void`	`setWindowParameters(int width, int height, boolean antialias)`
`(package private) void`	`setZMargin(int dz)`
`void`	`setZShade(boolean zShade, int zSlab, int zDepth, int zShadePower)`
`(package private) void`	`shadeTextPixel(int offset, int z, int argb, int bgargb, int shade)`
`void`	`snapshotAnaglyphChannelBytes()`
`void`	`volumeRender(boolean TF)`
`void`	`volumeRender4(int diameter, int x, int y, int z)`

Methods inherited from class org.jmol.util.GData
changeColixArgb, clipCode, clipCode3, getAmbientPercent, getBgColixes, getCel, getChangeableColix, getColorArgbOrGray, getDepth, getDiffusePercent, getFont3D, getFont3DFS, getFont3DFSS, getFont3DScaled, getFontFid, getFontFidFS, getFontStyleID, getLightSource, getPhongExponent, getRenderHeight, getRenderWidth, getScreenOctant, getShades, getSlab, getSpecular, getSpecularExponent, getSpecularPercent, getSpecularPower, getTranslucentCoverOnly, isAntialiased, isClipped, isClipped3, isClippedXY, isClippedZ, isDisplayAntialiased, isInDisplayRange, isPass2, plotImage, roundInt, setAmbientPercent, setBackgroundArgb, setBackgroundImage, setCel, setDepth, setDiffusePercent, setGreyscaleMode, setNewWindowParametersForExport, setPhongExponent, setSlab, setSpecular, setSpecularExponent, setSpecularPercent, setSpecularPower, setTranslucentCoverOnly, setWidthHeight, setWinParams, setZShade2

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jmol.api.JmolRendererInterface
getBgColixes, getFontFidFS, getTranslucentCoverOnly, isPass2, setTranslucentCoverOnly

Methods inherited from interface org.jmol.api.JmolGraphicsInterface
getColorArgbOrGray, getDepth, getFont3DScaled, getFontFid, getRenderHeight, getRenderWidth, getSlab, isAntialiased, isClippedXY, isClippedZ, isInDisplayRange, setDepth, setSlab

Field Detail

platform
```
Platform3D platform
```

line3d
```
LineRenderer line3d
```

circle3d
```
private CircleRenderer circle3d
```

sphere3d
```
private SphereRenderer sphere3d
```

triangle3d
```
private TriangleRenderer triangle3d
```

cylinder3d
```
private CylinderRenderer cylinder3d
```

hermite3d
```
private HermiteRenderer hermite3d
```

isFullSceneAntialiasingEnabled

private boolean isFullSceneAntialiasingEnabled

antialias2
```
private boolean antialias2
```

strings
```
private TextString[] strings
```

stringCount
```
private int stringCount
```

anaglyphChannelBytes
```
private byte[] anaglyphChannelBytes
```

twoPass
```
private boolean twoPass
```

addAllPixels
```
private boolean addAllPixels
```

haveTranslucentObjects
```
private boolean haveTranslucentObjects
```

pbuf
```
protected int[] pbuf
```

pbufT
```
protected int[] pbufT
```

zbuf
```
protected int[] zbuf
```

zbufT
```
protected int[] zbufT
```

translucencyMask
```
protected int translucencyMask
```

shadesCurrent
```
private int[] shadesCurrent
```

anaglyphLength
```
private int anaglyphLength
```

isScreened
```
private boolean isScreened
```

argbNoisyUp
```
private int argbNoisyUp
```

argbNoisyDn
```
private int argbNoisyDn
```

currentFont
```
private JmolFont currentFont
```

pixel
```
private Pixelator pixel
```

zMargin
```
protected int zMargin
```

currentShadeIndex
```
private int currentShadeIndex
```

lastRawColor
```
private int lastRawColor
```

translucencyLog
```
private int translucencyLog
```

saveAmbient
```
private int saveAmbient
```

saveDiffuse
```
private int saveDiffuse
```

sort

public static java.util.Comparator<TextString> sort

currentlyRendering
```
private boolean currentlyRendering
```

vectorAB
```
private final V3 vectorAB
```

vectorAC
```
private final V3 vectorAC
```

vectorNormal
```
private final V3 vectorNormal
```

normixCount
```
private static final short normixCount
```

transformedVectors
```
private final V3[] transformedVectors
```

shadeIndexes
```
private final byte[] shadeIndexes
```

shadeIndexes2Sided

private final byte[] shadeIndexes2Sided

nullShadeIndex
```
private static byte nullShadeIndex
```

Constructor Detail
- Graphics3D
```
public Graphics3D()
```

Method Detail

clear
```
public void clear()
```
Overrides:

clear in class GData

destroy
```
public void destroy()
```
Overrides:

destroy in class GData

getGData
```
public GData getGData()
```
underlying GData object handles all general graphics setup.

Specified by:

getGData in interface JmolRendererInterface

Returns:
"this" in the case of Graphics3D and this.g3d in the case of Export3D

setZMargin
```
void setZMargin(int dz)
```

initialize

public void initialize(ApiPlatform apiPlatform)

Overrides:: initialize in class GData

currentlyRendering
```
public boolean currentlyRendering()
```
Specified by:

currentlyRendering in interface JmolRendererInterface

setWindowParameters

public void setWindowParameters(int width,
                       int height,
                       boolean antialias)

Overrides:: setWindowParameters in class GData

checkTranslucent
```
public boolean checkTranslucent(boolean isAlphaTranslucent)
```
Specified by:

checkTranslucent in interface JmolRendererInterface

beginRendering

public void beginRendering(Matrix3f rotationMatrix,
                  boolean translucentMode,
                  boolean isImageWrite)

Overrides:: beginRendering in class GData

setBackgroundTransparent
```
public void setBackgroundTransparent(boolean TF)
```
Overrides:

setBackgroundTransparent in class GData

releaseBuffers
```
private void releaseBuffers()
```

setPass2
```
public boolean setPass2(boolean antialiasTranslucent)
```
Overrides:

setPass2 in class GData

Returns:
true if need a second (translucent) pass

endRendering
```
public void endRendering()
```
Overrides:

endRendering in class GData

getScreenImage
```
public java.lang.Object getScreenImage(boolean isImageWrite)
```
Overrides:

getScreenImage in class GData

Returns:
image object

applyAnaglygh

public void applyAnaglygh(EnumStereoMode stereoMode,
                 int[] stereoColors)

Overrides:: applyAnaglygh in class GData

snapshotAnaglyphChannelBytes
```
public void snapshotAnaglyphChannelBytes()
```
Overrides:

snapshotAnaglyphChannelBytes in class GData

applyCustomAnaglyph

public void applyCustomAnaglyph(int[] stereoColors)

applyGreenAnaglyph
```
public void applyGreenAnaglyph()
```

applyBlueAnaglyph
```
public void applyBlueAnaglyph()
```

applyCyanAnaglyph
```
public void applyCyanAnaglyph()
```

releaseScreenImage
```
public void releaseScreenImage()
```
Overrides:

releaseScreenImage in class GData

haveTranslucentObjects
```
public boolean haveTranslucentObjects()
```
Specified by:

haveTranslucentObjects in interface JmolRendererInterface

setTempZSlab
```
public void setTempZSlab(int zSlab)
```

setZShade
```
public void setZShade(boolean zShade,
             int zSlab,
             int zDepth,
             int zShadePower)
```
Overrides:

setZShade in class GData

Parameters:
zShade - whether to shade along z front to back
zSlab - for zShade
zDepth - for zShade

downsampleFullSceneAntialiasing

private void downsampleFullSceneAntialiasing(boolean downsampleZBuffer)

mergeOpaqueAndTranslucentBuffers

void mergeOpaqueAndTranslucentBuffers()

mergeBufferPixel

static void mergeBufferPixel(int[] pbuf,
                    int offset,
                    int argbB,
                    int bgcolor)

hasContent
```
public boolean hasContent()
```

setColor
```
public void setColor(int argb)
```
Specified by:

setColor in interface JmolRendererInterface

Overrides:

setColor in class GData

setColix
```
public boolean setColix(short colix)
```
sets current color from colix color index

Specified by:

setColix in interface JmolRendererInterface

Overrides:

setColix in class GData

Parameters:
colix - the color index

Returns:
true or false if this is the right pass

addPixel

void addPixel(int offset,
            int z,
            int p)

clearPixel

void clearPixel(int offset,
              int z)

drawFilledCircle
```
public void drawFilledCircle(short colixRing,
                    short colixFill,
                    int diameter,
                    int x,
                    int y,
                    int z)
```
Description copied from interface: JmolRendererInterface

draws a ring and filled circle (halos, draw CIRCLE, draw handles)

Specified by:

drawFilledCircle in interface JmolRendererInterface

x - center x
y - center y
z - center z

volumeRender4

public void volumeRender4(int diameter,
                 int x,
                 int y,
                 int z)

Specified by:: volumeRender4 in interface JmolRendererInterface

fillSphereXYZ
```
public void fillSphereXYZ(int diameter,
                 int x,
                 int y,
                 int z)
```
fills a solid sphere

Specified by:

fillSphereXYZ in interface JmolRendererInterface

Parameters:
diameter - pixel count
x - center x
y - center y
z - center z

volumeRender
```
public void volumeRender(boolean TF)
```
Specified by:

volumeRender in interface JmolRendererInterface

fillSphereI
```
public void fillSphereI(int diameter,
               P3i center)
```
fills a solid sphere

Specified by:

fillSphereI in interface JmolRendererInterface

Parameters:
diameter - pixel count
center - javax.vecmath.Point3i defining the center

fillSphere
```
public void fillSphere(int diameter,
              P3 center)
```
fills a solid sphere

Specified by:

fillSphere in interface JmolRendererInterface

Parameters:
diameter - pixel count
center - a javax.vecmath.Point3f ... floats are casted to ints

fillEllipsoid

public void fillEllipsoid(P3 center,
                 P3[] points,
                 int x,
                 int y,
                 int z,
                 int diameter,
                 Matrix3f mToEllipsoidal,
                 double[] coef,
                 Matrix4f mDeriv,
                 int selectedOctant,
                 P3i[] octantPoints)

Specified by:: fillEllipsoid in interface JmolRendererInterface

drawRect
```
public void drawRect(int x,
            int y,
            int z,
            int zSlab,
            int rWidth,
            int rHeight)
```
draws a rectangle

Specified by:

drawRect in interface JmolRendererInterface

Parameters:
x - upper left x
y - upper left y
z - upper left z
zSlab - z for slab check (for set labelsFront)
rWidth - pixel count
rHeight - pixel count

drawHLine

private void drawHLine(int x,
             int y,
             int z,
             int w)

drawVLine

private void drawVLine(int x,
             int y,
             int z,
             int h)

fillRect
```
public void fillRect(int x,
            int y,
            int z,
            int zSlab,
            int widthFill,
            int heightFill)
```
fills background rectangle for label

Specified by:

fillRect in interface JmolRendererInterface

Parameters:
x - upper left x
y - upper left y
z - upper left z
zSlab - z value for slabbing
widthFill - pixel count
heightFill - pixel count

drawString
```
public void drawString(java.lang.String str,
              JmolFont font3d,
              int xBaseline,
              int yBaseline,
              int z,
              int zSlab,
              short bgColix)
```
draws the specified string in the current font. no line wrapping -- axis, labels, measures

Specified by:

drawString in interface JmolRendererInterface

Parameters:
str - the String
font3d - the Font3D
xBaseline - baseline x
yBaseline - baseline y
z - baseline z
zSlab - z for slab calculation
bgColix -

drawStringNoSlab
```
public void drawStringNoSlab(java.lang.String str,
                    JmolFont font3d,
                    int xBaseline,
                    int yBaseline,
                    int z,
                    short bgColix)
```
draws the specified string in the current font. no line wrapping -- echo, frank, hover, molecularOrbital, uccage

Specified by:

drawStringNoSlab in interface JmolRendererInterface

Parameters:
str - the String
font3d - the Font3D
xBaseline - baseline x
yBaseline - baseline y
z - baseline z
bgColix -

renderAllStrings
```
public void renderAllStrings(java.lang.Object jmolRenderer)
```
Specified by:

renderAllStrings in interface JmolGraphicsInterface

Overrides:

renderAllStrings in class GData

plotText

public void plotText(int x,
            int y,
            int z,
            int argb,
            int bgargb,
            java.lang.String text,
            JmolFont font3d,
            JmolRendererInterface jmolRenderer)

Overrides:: plotText in class GData; bgargb - TODO

drawImage

public void drawImage(java.lang.Object objImage,
             int x,
             int y,
             int z,
             int zSlab,
             short bgcolix,
             int width,
             int height)

Specified by:: drawImage in interface JmolRendererInterface

plotImage

public void plotImage(int x,
             int y,
             int z,
             java.lang.Object image,
             JmolRendererInterface jmolRenderer,
             short bgcolix,
             int width,
             int height)

setFontFid
```
public void setFontFid(byte fid)
```
Specified by:

setFontFid in interface JmolRendererInterface

Overrides:

setFontFid in class GData

setFont
```
public void setFont(JmolFont font3d)
```
Overrides:

setFont in class GData

getFont3DCurrent
```
public JmolFont getFont3DCurrent()
```
Specified by:

getFont3DCurrent in interface JmolRendererInterface

Overrides:

getFont3DCurrent in class GData

drawPixel

public void drawPixel(int x,
             int y,
             int z)

Specified by:: drawPixel in interface JmolRendererInterface

drawPoints

public void drawPoints(int count,
              int[] coordinates,
              int scale)

Specified by:: drawPoints in interface JmolRendererInterface

drawDashedLine

public void drawDashedLine(int run,
                  int rise,
                  P3i pointA,
                  P3i pointB)

Specified by:: drawDashedLine in interface JmolRendererInterface

drawDottedLine

public void drawDottedLine(P3i pointA,
                  P3i pointB)

Specified by:: drawDottedLine in interface JmolRendererInterface

drawLineXYZ

public void drawLineXYZ(int x1,
               int y1,
               int z1,
               int x2,
               int y2,
               int z2)

Specified by:: drawLineXYZ in interface JmolRendererInterface

drawLine

public void drawLine(short colixA,
            short colixB,
            int x1,
            int y1,
            int z1,
            int x2,
            int y2,
            int z2)

Specified by:: drawLine in interface JmolRendererInterface

drawLineAB

public void drawLineAB(P3i pointA,
              P3i pointB)

Specified by:: drawLineAB in interface JmolRendererInterface

fillCylinderXYZ

public void fillCylinderXYZ(short colixA,
                   short colixB,
                   byte endcaps,
                   int diameter,
                   int xA,
                   int yA,
                   int zA,
                   int xB,
                   int yB,
                   int zB)

Specified by:: fillCylinderXYZ in interface JmolRendererInterface

fillCylinderScreen

public void fillCylinderScreen(byte endcaps,
                      int diameter,
                      int xA,
                      int yA,
                      int zA,
                      int xB,
                      int yB,
                      int zB)

Specified by:: fillCylinderScreen in interface JmolRendererInterface

fillCylinderScreen3I

public void fillCylinderScreen3I(byte endcaps,
                        int diameter,
                        P3i screenA,
                        P3i screenB,
                        P3 pt0f,
                        P3 pt1f,
                        float radius)

Specified by:: fillCylinderScreen3I in interface JmolRendererInterface

fillCylinder

public void fillCylinder(byte endcaps,
                int diameter,
                P3i screenA,
                P3i screenB)

Specified by:: fillCylinder in interface JmolRendererInterface

fillCylinderBits

public void fillCylinderBits(byte endcaps,
                    int diameter,
                    P3 screenA,
                    P3 screenB)

Specified by:: fillCylinderBits in interface JmolRendererInterface

fillConeScreen

public void fillConeScreen(byte endcap,
                  int screenDiameter,
                  P3i screenBase,
                  P3i screenTip,
                  boolean isBarb)

Specified by:: fillConeScreen in interface JmolRendererInterface

fillConeSceen3f

public void fillConeSceen3f(byte endcap,
                   int screenDiameter,
                   P3 screenBase,
                   P3 screenTip)

Specified by:: fillConeSceen3f in interface JmolRendererInterface

drawHermite4

public void drawHermite4(int tension,
                P3i s0,
                P3i s1,
                P3i s2,
                P3i s3)

Specified by:: drawHermite4 in interface JmolRendererInterface

drawHermite7

public void drawHermite7(boolean fill,
                boolean border,
                int tension,
                P3i s0,
                P3i s1,
                P3i s2,
                P3i s3,
                P3i s4,
                P3i s5,
                P3i s6,
                P3i s7,
                int aspectRatio,
                short colixBack)

Specified by:: drawHermite7 in interface JmolRendererInterface

fillHermite

public void fillHermite(int tension,
               int diameterBeg,
               int diameterMid,
               int diameterEnd,
               P3i s0,
               P3i s1,
               P3i s2,
               P3i s3)

Specified by:: fillHermite in interface JmolRendererInterface

drawTriangle3C

public void drawTriangle3C(P3i screenA,
                  short colixA,
                  P3i screenB,
                  short colixB,
                  P3i screenC,
                  short colixC,
                  int check)

Specified by:: drawTriangle3C in interface JmolRendererInterface

drawTriangle3I

public void drawTriangle3I(P3i screenA,
                  P3i screenB,
                  P3i screenC,
                  int check)

Specified by:: drawTriangle3I in interface JmolRendererInterface

fillTriangleTwoSided

public void fillTriangleTwoSided(short normix,
                        int xScreenA,
                        int yScreenA,
                        int zScreenA,
                        int xScreenB,
                        int yScreenB,
                        int zScreenB,
                        int xScreenC,
                        int yScreenC,
                        int zScreenC)

Specified by:: fillTriangleTwoSided in interface JmolRendererInterface

fillTriangle3f

public void fillTriangle3f(P3 screenA,
                  P3 screenB,
                  P3 screenC,
                  boolean setNoisy)

Specified by:: fillTriangle3f in interface JmolRendererInterface

fillTriangle3i

public void fillTriangle3i(P3i screenA,
                  P3i screenB,
                  P3i screenC,
                  P3 ptA,
                  P3 ptB,
                  P3 ptC)

Specified by:: fillTriangle3i in interface JmolRendererInterface

fillTriangle

public void fillTriangle(P3i screenA,
                short colixA,
                short normixA,
                P3i screenB,
                short colixB,
                short normixB,
                P3i screenC,
                short colixC,
                short normixC,
                float factor)

Specified by:: fillTriangle in interface JmolRendererInterface

fillTriangle3CN

public void fillTriangle3CN(P3i screenA,
                   short colixA,
                   short normixA,
                   P3i screenB,
                   short colixB,
                   short normixB,
                   P3i screenC,
                   short colixC,
                   short normixC)

Specified by:: fillTriangle3CN in interface JmolRendererInterface

setTriangleColixAndShadeIndex

private void setTriangleColixAndShadeIndex(short colix,
                                 int shadeIndex)

setTriangleTranslucency

private boolean setTriangleTranslucency(short colixA,
                              short colixB,
                              short colixC)

drawQuadrilateral

public void drawQuadrilateral(short colix,
                     P3i screenA,
                     P3i screenB,
                     P3i screenC,
                     P3i screenD)

Specified by:: drawQuadrilateral in interface JmolRendererInterface

fillQuadrilateral

public void fillQuadrilateral(P3 screenA,
                     P3 screenB,
                     P3 screenC,
                     P3 screenD)

Specified by:: fillQuadrilateral in interface JmolRendererInterface

fillQuadrilateral3i

public void fillQuadrilateral3i(P3i screenA,
                       short colixA,
                       short normixA,
                       P3i screenB,
                       short colixB,
                       short normixB,
                       P3i screenC,
                       short colixC,
                       short normixC,
                       P3i screenD,
                       short colixD,
                       short normixD)

Specified by:: fillQuadrilateral3i in interface JmolRendererInterface

drawSurface

public void drawSurface(MeshSurface meshSurface,
               short colix)

Specified by:: drawSurface in interface JmolRendererInterface

plotPixelClippedXYZ

void plotPixelClippedXYZ(int x,
                       int y,
                       int z)

plotPixelClippedP3i
```
public void plotPixelClippedP3i(P3i screen)
```
Specified by:

plotPixelClippedP3i in interface JmolRendererInterface

plotPixelClippedArgb

void plotPixelClippedArgb(int argb,
                        int x,
                        int y,
                        int z)

plotImagePixel

public void plotImagePixel(int argb,
                  int x,
                  int y,
                  int z,
                  int shade,
                  int bgargb)

Specified by:: plotImagePixel in interface JmolRendererInterface

plotPixelClippedScreened

void plotPixelClippedScreened(int argb,
                            boolean isScreened,
                            int x,
                            int y,
                            int z)

plotPixelUnclipped

void plotPixelUnclipped(int x,
                      int y,
                      int z)

plotPixelUnclippedArgb

void plotPixelUnclippedArgb(int argb,
                          int x,
                          int y,
                          int z)

plotPixelsClipped

void plotPixelsClipped(int count,
                     int x,
                     int y,
                     int z)

plotPixelsClippedRaster

void plotPixelsClippedRaster(int count,
                           int x,
                           int y,
                           int zAtLeft,
                           int zPastRight,
                           Rgb16 rgb16Left,
                           Rgb16 rgb16Right)

plotPixelsUnclippedRaster

void plotPixelsUnclippedRaster(int count,
                             int x,
                             int y,
                             int zAtLeft,
                             int zPastRight,
                             Rgb16 rgb16Left,
                             Rgb16 rgb16Right)

plotPixelsUnclippedCount

void plotPixelsUnclippedCount(int count,
                            int x,
                            int y,
                            int z)

plotPoints

private void plotPoints(int count,
              int[] coordinates,
              int xOffset,
              int yOffset)

setColorNoisy
```
void setColorNoisy(int shadeIndex)
```

setNoisySurfaceShade
```
public void setNoisySurfaceShade(P3i screenA,
                        P3i screenB,
                        P3i screenC)
```
used by CartoonRenderer (DNA surface) and GeoSurfaceRenderer (face) to assign a noisy shade to the surface it will render

Specified by:

setNoisySurfaceShade in interface JmolRendererInterface

Overrides:

setNoisySurfaceShade in class GData

Parameters:
screenA -
screenB -
screenC -

getShadeIndexP3

private int getShadeIndexP3(P3 screenA,
                  P3 screenB,
                  P3 screenC)

renderBackground
```
public void renderBackground(JmolRendererInterface jmolRenderer)
```
Specified by:

renderBackground in interface JmolRendererInterface

Overrides:

renderBackground in class GData

drawAtom
```
public void drawAtom(Atom atom)
```
Specified by:

drawAtom in interface JmolRendererInterface

getExportType
```
public int getExportType()
```
Specified by:

getExportType in interface JmolRendererInterface

getExportName
```
public java.lang.String getExportName()
```
Specified by:

getExportName in interface JmolRendererInterface

canDoTriangles
```
public boolean canDoTriangles()
```

isCartesianExport
```
public boolean isCartesianExport()
```

initializeExporter

public JmolRendererInterface initializeExporter(java.lang.String type,
                                       Viewer viewer,
                                       double privateKey,
                                       GData g3d,
                                       java.lang.Object output)

Specified by:: initializeExporter in interface JmolRendererInterface

finalizeOutput
```
public java.lang.String finalizeOutput()
```
Specified by:

finalizeOutput in interface JmolRendererInterface

drawBond

public void drawBond(P3 atomA,
            P3 atomB,
            short colixA,
            short colixB,
            byte endcaps,
            short mad,
            int bondOrder)

Specified by:: drawBond in interface JmolRendererInterface

drawEllipse

public boolean drawEllipse(P3 ptAtom,
                  P3 ptX,
                  P3 ptY,
                  boolean fillArc,
                  boolean wireframeOnly)

Specified by:: drawEllipse in interface JmolRendererInterface

getPrivateKey
```
public double getPrivateKey()
```

clearFontCache
```
public void clearFontCache()
```
Overrides:

clearFontCache in class GData

getTransformedVertexVectors
```
public V3[] getTransformedVertexVectors()
```
Specified by:

getTransformedVertexVectors in interface JmolRendererInterface

Overrides:

getTransformedVertexVectors in class GData

isDirectedTowardsCamera
```
public boolean isDirectedTowardsCamera(short normix)
```
Specified by:

isDirectedTowardsCamera in interface JmolRendererInterface

Overrides:

isDirectedTowardsCamera in class GData

Returns:
true if front

setRotationMatrix

public void setRotationMatrix(Matrix3f rotationMatrix)

getShadeIndex

public int getShadeIndex(short normix)

renderCrossHairs

public void renderCrossHairs(int[] minMax,
                    int screenWidth,
                    int screenHeight,
                    P3 navOffset,
                    float navDepth)

Specified by:: renderCrossHairs in interface JmolRendererInterface
Parameters:: minMax -; screenWidth -; screenHeight -; navOffset -; navDepth -

initializeOutput

public boolean initializeOutput(java.lang.String type,
                       Viewer viewer,
                       double privateKey,
                       GData gdata,
                       java.lang.Object object)

Specified by:: initializeOutput in interface JmolRendererInterface

shadeTextPixel

void shadeTextPixel(int offset,
                  int z,
                  int argb,
                  int bgargb,
                  int shade)

Class Graphics3D

Field Summary

Fields inherited from class org.jmol.util.GData

Constructor Summary

Method Summary

Methods inherited from class org.jmol.util.GData

Methods inherited from class java.lang.Object

Methods inherited from interface org.jmol.api.JmolRendererInterface

Methods inherited from interface org.jmol.api.JmolGraphicsInterface

Field Detail

platform

line3d

circle3d

sphere3d

triangle3d

cylinder3d

hermite3d

isFullSceneAntialiasingEnabled

antialias2

strings

stringCount

anaglyphChannelBytes

twoPass

addAllPixels

haveTranslucentObjects

pbuf

pbufT

zbuf

zbufT

translucencyMask

shadesCurrent

anaglyphLength

isScreened

argbNoisyUp

argbNoisyDn

currentFont

pixel

zMargin

currentShadeIndex

lastRawColor

translucencyLog

saveAmbient

saveDiffuse

sort

currentlyRendering

vectorAB

vectorAC

vectorNormal

normixCount

transformedVectors

shadeIndexes

shadeIndexes2Sided

nullShadeIndex

Constructor Detail

Graphics3D

Method Detail

clear

destroy

getGData

setZMargin

initialize

currentlyRendering

setWindowParameters

checkTranslucent

beginRendering

setBackgroundTransparent

releaseBuffers

setPass2

endRendering

getScreenImage

applyAnaglygh

snapshotAnaglyphChannelBytes

applyCustomAnaglyph

applyGreenAnaglyph

applyBlueAnaglyph

applyCyanAnaglyph

releaseScreenImage

haveTranslucentObjects

setTempZSlab

setZShade