GL3Viewer (Artisynth API documentation)

java.lang.Object
- maspack.render.GL.GLViewer
- - maspack.render.GL.GL3.GL3Viewer

All Implemented Interfaces:

com.jogamp.opengl.GLEventListener, java.util.EventListener, HasProperties, GLRenderer, Renderer, Viewer
```
public class GL3Viewer
extends GLViewer
```

Nested Class Summary
- Nested classes/interfaces inherited from class maspack.render.GL.GLViewer
  GLViewer.BlendFactor, GLViewer.GLVersion
- Nested classes/interfaces inherited from interface maspack.render.Viewer
  Viewer.RotationMode, Viewer.ViewControlMask
- Nested classes/interfaces inherited from interface maspack.render.Renderer
  Renderer.AxisDrawStyle, Renderer.ColorInterpolation, Renderer.ColorMixing, Renderer.DrawMode, Renderer.FaceStyle, Renderer.HighlightStyle, Renderer.LineStyle, Renderer.PointStyle, Renderer.Shading

Field Summary
- Fields inherited from class maspack.render.GL.GLViewer
  AUTO_FIT, DEFAULT_AXIS_RADIUS_RATIO, DEFAULT_DST_BLENDING, DEFAULT_ELLIPTIC_CURSOR_ACTIVE, DEFAULT_ELLIPTIC_CURSOR_SIZE, DEFAULT_ROTATION_MODE, DEFAULT_SRC_BLENDING, DEFAULT_VIEW_CONTROL_MASK, myProps, useGLJPanel
- Fields inherited from interface maspack.render.Renderer
  HIGHLIGHT, SORT_FACES

Constructor Summary

Constructors
Constructor and Description
`GL3Viewer(GL3Viewer shareWith, int width, int height)` Creates a new GLViewer with default capabilities that shares resources (e.g., diplay lists and textures) with an existing GLViewer.
`GL3Viewer(com.jogamp.opengl.GLCapabilities cap, GL3SharedResources resources, int width, int height)` Creates a new GLViewer with specified capabilities and size.
`GL3Viewer(int width, int height)` Creates a new GLViewer with default capabilities.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`awaitScreenShotCompletion()`
`void`	`cleanupScreenShots()`
`void`	`display(com.jogamp.opengl.GLAutoDrawable drawable, int flags)`
`void`	`dispose()` MUST BE CALLED by whatever frame when it is going down, will notify any shared resources that they can be cleared.
`void`	`dispose(com.jogamp.opengl.GLAutoDrawable drawable)` Called any time GL context is switched! e.g.
`void`	`drawArrow(float[] pnt0, float[] pnt1, double rad, boolean capped)` Draws a solid arrow between two points in model coordinates, using the current shading and material.
`void`	`drawArrow(RenderProps props, float[] pnt0, float[] pnt1, boolean capped, boolean highlight)` Draws an arrow between two points in model coordinates, using the radius, line color, and shading specified by the render properties argument `props`.
`void`	`drawAxes(com.jogamp.opengl.GL3 gl, double len)`
`void`	`drawAxes(RigidTransform3d X, double[] lens, int width, boolean highlight)` Draws a set of coordinate axes representing a rigid coordinate frame `X`.
`void`	`drawBox(float[] pnt, double wx, double wy, double wz)` Draws an axis-aligned box in model coordinates, using the current shading and material.
`void`	`drawBox(RigidTransform3d TBM, Vector3d widths)` Draws a box centered on the specified transform in model coordinates, using the current shading and material.
`void`	`drawCone(float[] pnt0, float[] pnt1, double r0, double r1, boolean capped)` Draws a cone between two points in model coordinates, using the current shading and material.
`void`	`drawCube(float[] pnt, double w)` Draws an axis-aligned cube with a specified width centered at a point in model coordinates, using the current shading and material.
`void`	`drawCylinder(float[] coords0, float[] coords1, double r, boolean capped)` Draws a cylinder between two points in model coordinates, using the current shading and material.
`void`	`drawInstances(RenderObject robj, RenderInstances rinst)` Draw an object multiple times with differing per-instance information
`void`	`drawLine(float[] pnt0, float[] pnt1)` Draws a single line between two points in model coordinates, using the current line width, material, and shading.
`void`	`drawLine(RenderProps props, float[] pnt0, float[] pnt1, float[] color, boolean capped, boolean highlight)` Draws a single line between two points in model coordinates, using the line style, radius, line color, and shading specified by the render properties argument `props`.
`void`	`drawLines(RenderObject robj, int gidx)` Draws all the lines in the specified line group of the render object, using the current material and shading.
`void`	`drawLines(RenderObject robj, int gidx, int offset, int count, Renderer.LineStyle style, double rad)` Draws a selection of lines in the specified line group of the supplied render object, using the current material and shading.
`void`	`drawLines(RenderObject robj, int gidx, RenderInstances rinst)` Draw an object multiple times with differing per-instance information
`void`	`drawLineStrip(RenderProps props, java.lang.Iterable<float[]> pnts, Renderer.LineStyle style, boolean highlight)` Draws a line strip between a series of points in model coordinates, using the radius, line color, and shading specified by the render properties argument `props`, and the line style specified by `style`.
`void`	`drawPoint(float[] pnt)` Draws a single point located at `pnt` in model coordinates, using the current point size, material, and shading.
`void`	`drawPoint(RenderProps props, float[] pnt, boolean highlight)` Draws a single point located at `pnt` in model coordinates, using the point style, size, point color, and shading specified by the render properties argument `props`.
`void`	`drawPoints(RenderObject robj, int gidx)` Draws all the points in the specified point group of the supplied render object, using the current material and shading.
`void`	`drawPoints(RenderObject robj, int gidx, int offset, int count, Renderer.PointStyle style, double rad)` Draws a selection of points in the specified point group of the supplied render object, using the current material and shading.
`void`	`drawPoints(RenderObject robj, int gidx, RenderInstances rinst)` Draw an object multiple times with differing per-instance information
`void`	`drawSphere(float[] pnt, double rad)` Draws a sphere with a specified radius centered at a point in model coordinates, using the current shading and material.
`void`	`drawSpindle(float[] pnt0, float[] pnt1, double rad)` Draws a spindle between two points in model coordinates, using the current shading and material.
`double`	`drawText(java.awt.Font font, java.lang.String str, float[] pos, double emSize)` Draws text in the x-y plane in model coordinates.
`void`	`drawTriangle(float[] pnt0, float[] pnt1, float[] pnt2)` Draw triangular faces, using the current Shading, lighting and material, and computing a single "face" normal from the coordinates (so the current "shading" really matters only if it is Shading.NONE).
`void`	`drawTriangles(java.lang.Iterable<float[]> points)`
`void`	`drawTriangles(RenderObject robj, int gidx, int offset, int count)` Draws a selection of triangles in the specified triangle group of the render object, using the current material and shading.
`void`	`drawTriangles(RenderObject robj, int gidx, RenderInstances rinst)` Draw an object multiple times with differing per-instance information
`void`	`drawVertices(RenderObject robj, int[] idxs, Renderer.DrawMode mode)`
`void`	`drawVertices(RenderObject robj, Renderer.DrawMode mode)` Draws all the vertices associated with the specified RenderObject, using a specified drawing mode and the current material and shading.
`void`	`drawVertices(RenderObject robj, VertexIndexArray idxs, int offset, int count, Renderer.DrawMode mode)` Draws a selection of vertices associated with the specified RenderObject, using a specified drawing mode and the current material and shading.
`GLTextRenderer`	`getTextRenderer()`
`boolean`	`grabPending()`
`boolean`	`hasBumpMapping()` Queries whether or not this renderer supports bump mapping.
`boolean`	`hasColorMapMixing(Renderer.ColorMixing cmix)` Queries whether or not a specified method for combining color map and material coloring is supported by this Renderer.
`boolean`	`hasColorMapping()` Queries whether or not this renderer supports color mapping.
`boolean`	`hasNormalMapping()` Queries whether or not this renderer supports normal mapping.
`boolean`	`hasVertexColorMixing(Renderer.ColorMixing cmix)` Queries whether or not a specified method for combining vertex coloring and material coloring is supported by this Renderer.
`void`	`init(com.jogamp.opengl.GLAutoDrawable drawable)` Called any time GL context is switched! e.g.
`void`	`maybeUpdateMaterials()`
`void`	`setShaderOverride(java.lang.Object shaderKey, java.io.File[] vf)`
`int`	`setSurfaceResolution(int nres)` Sets the resolution used for creating mesh representations of curved solids.
`void`	`setupScreenShot(int w, int h, java.io.File file, java.lang.String format)`
`void`	`setupScreenShot(int w, int h, int samples, java.io.File file, java.lang.String format)` Setup for a screenshot during the next render cycle
`void`	`useProgram(com.jogamp.opengl.GL3 gl, java.lang.Object key)`

Methods inherited from class maspack.render.GL.GLViewer
addClipPlane, addClipPlane, addClipPlane, addDragger, addKeyListener, addLight, addLight, addMouseInputListener, addMouseWheelListener, addRenderable, addRenderListener, addSelectionListener, addVertex, addVertex, addVertex, addVertex, autoFit, autoFitOrtho, autoFitPerspective, begin2DRendering, begin2DRendering, begin2DRendering, beginDraw, beginGL, beginSelectionQuery, beginSubSelection, centerDistancePerPixel, clearClipPlanes, clearDraggers, clearPickMatrix, clearRenderables, display, distancePerPixel, draw, drawArrow, drawArrow, drawAxes, drawAxes, drawAxes, drawBox, drawCone, drawCube, drawCylinder, drawLine, drawLine, drawLine, drawLine, drawLine, drawLines, drawLines, drawLines, drawPoint, drawPoint, drawPoint, drawPoints, drawPoints, drawPoints, drawRay, drawSolidAxes, drawSolidAxes, drawSphere, drawSpindle, drawText, drawText, drawText, drawTriangle, drawTriangles, drawTriangles, drawVertices, end2DRendering, endDraw, endGL, endSelectionQuery, endSubSelection, estimateRadiusAndCenter, finish2DRendering, getAllDraggers, getAllPropertyInfo, getAutoSwapBufferMode, getAxialView, getAxisDrawStyle, getAxisLength, getAxisRadiusRatio, getBackColor, getBackgroundColor, getBackgroundColor, getBlendDestFactor, getBlendSourceFactor, getBounds, getBumpMap, getCanvas, getCellDivisions, getCellSize, getCenter, getCenterToWorld, getCenterToWorld, getClipPlane, getClipPlanes, getColor, getColorInterpolation, getColorMap, getComponent, getContext, getDefaultFont, getDepthOffset, getDragBox, getDraggers, getDrawTool, getEllipticCursorActive, getEllipticCursorSize, getEllipticSelection, getEmission, getExternalRenderList, getEye, getEyeToWorld, getEyeZDirection, getFaceStyle, getFarPlaneDistance, getFrontColor, getFrustum, getGL, getGrid, getGridVisible, getHighlightColor, getHighlightColor, getHighlighting, getHighlightStyle, getIndexOfLight, getKeyListeners, getLight, getLineWidth, getModelMatrix, getModelMatrix, getModelMatrix, getMouseHandler, getMouseInputListeners, getMouseWheelListeners, getNormalMap, getNumClipPlanes, getPointSize, getProfiling, getProjectionMatrix, getProjectionMatrix, getProperty, getRenderFlags, getRenderListeners, getRotationMode, getRoundedPoints, getScreenCursor, getScreenHeight, getScreenWidth, getScreenX, getScreenY, getSelectingColor, getSelectionEvent, getSelectionFilter, getSelectionListeners, getSelectOnPress, getShading, getShininess, getSpecular, getSurfaceResolution, getTextBounds, getTextureMatrix, getTextureMatrix, getTransparencyBlending, getTransparencyFaceCulling, getUpVector, getVertexColorMixing, getVerticalFieldOfView, getViewControlMask, getViewMatrix, getViewMatrix, getViewMatrix, getViewPlaneDistance, getViewPlaneHeight, getViewPlaneWidth, has2DRendering, hasHighlightStyle, hasSelection, hasTextRendering, hasVertexColoring, is2DRendering, isAutoResizeEnabled, isAutoViewportEnabled, isDepthEnabled, isDepthWriteEnabled, isLightingEnabled, isMultiSampleEnabled, isOrthogonal, isSelectable, isSelecting, isSelectionEnabled, isSpecialRenderFlagsSet, isTextureMappingEnabled, isTransparencyEnabled, isVertexColoringEnabled, maxClipSurfaces, mulModelMatrix, numFreeClipSurfaces, numLights, numMultiSamples, numSelectionQueriesNeeded, paint, popModelMatrix, popProjectionMatrix, popTextureMatrix, popViewMatrix, pushModelMatrix, pushProjectionMatrix, pushTextureMatrix, pushViewMatrix, removeClipPlane, removeDragger, removeKeyListener, removeLight, removeLight, removeMouseInputListener, removeMouseWheelListener, removeRenderable, removeRenderListener, removeSelectionListener, repaint, rerender, rerender, resetEllipticCursorSize, reshape, restoreDefaultState, rotate, rotateModelMatrix, scaleModelMatrix, scaleModelMatrix, setAutoResizeEnabled, setAutoSwapBufferMode, setAutoViewportEnabled, setAxialView, setAxisDrawStyle, setAxisLength, setAxisRadiusRatio, setBackColor, setBackgroundColor, setBackgroundColor, setBackgroundColor, setBlendDestFactor, setBlendSourceFactor, setBumpMap, setCenter, setColor, setColor, setColor, setColor, setColor, setColorInterpolation, setColorMap, setDefaultFont, setDefaultLights, setDepthEnabled, setDepthOffset, setDepthWriteEnabled, setDragBox, setDrawTool, setEdgeColoring, setEllipticCursorActive, setEllipticCursorSize, setEllipticSelection, setEmission, setExternalRenderList, setEye, setEyeToWorld, setEyeToWorld, setFaceColoring, setFaceColoring, setFaceStyle, setFrontAlpha, setFrontColor, setGlobalRenderFlags, setGridSizeAndPosition, setGridVisible, setHighlightColor, setHighlighting, setHighlightStyle, setLightingEnabled, setLineColoring, setLineShading, setLineWidth, setMaterial, setModelMatrix, setModelMatrix2d, setMouseHandler, setMultiSampleEnabled, setNormal, setNormal, setNormal, setNormalMap, setOrthogonal, setOrthogonal, setOrthographicView, setPerspective, setPerspective, setPerspective, setPointColoring, setPointShading, setPointSize, setProfiling, setPropsColoring, setPropsShading, setRotationMode, setRoundedPoints, setScreenCursor, setSelectingColor, setSelectingColor, setSelectionEnabled, setSelectionFilter, setSelectOnPress, setShading, setShininess, setSpecular, setTextureCoord, setTextureCoord, setTextureCoord, setTextureMappingEnabled, setTextureMatrix, setTransparencyBlending, setTransparencyEnabled, setTransparencyFaceCulling, setUpVector, setVertexColoringEnabled, setVertexColorMixing, setVerticalFieldOfView, setViewControlMask, setViewMatrix, setViewport, setViewVolume, translate, translateModelMatrix, translateModelMatrix, zoom

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

- Constructor Detail
  - GL3Viewer
```
public GL3Viewer(int width,
                 int height)
```
    Creates a new GLViewer with default capabilities.
    
    Parameters:
    
    width - initial width of the viewer
    
    height - initial height of the viewer
  - GL3Viewer
```
public GL3Viewer(GL3Viewer shareWith,
                 int width,
                 int height)
```
    Creates a new GLViewer with default capabilities that shares resources (e.g., diplay lists and textures) with an existing GLViewer.
    
    Parameters:
    
    shareWith - GLViewer with which resources are to be shared
    
    width - initial width of the viewer
    
    height - initial height of the viewer
  - GL3Viewer
```
public GL3Viewer(com.jogamp.opengl.GLCapabilities cap,
                 GL3SharedResources resources,
                 int width,
                 int height)
```
    Creates a new GLViewer with specified capabilities and size.
    
    Parameters:
    
    cap - Desired GL capabilities. Can be specified as null, which will create default capabilities.
    
    resources - Resources to be used by the viewer. Can be specified as null, which will create default resources.
    
    width - initial width of the viewer
    
    height - initial height of the viewer
- Method Detail
  - init
```
public void init(com.jogamp.opengl.GLAutoDrawable drawable)
```
    Description copied from class: GLViewer
    
    Called any time GL context is switched! e.g. moving window to new display
    
    Specified by:
    
    init in interface com.jogamp.opengl.GLEventListener
    
    Overrides:
    
    init in class GLViewer
  - dispose
```
public void dispose(com.jogamp.opengl.GLAutoDrawable drawable)
```
    Description copied from class: GLViewer
    
    Called any time GL context is switched! e.g. moving window to new display
    
    Specified by:
    
    dispose in interface com.jogamp.opengl.GLEventListener
    
    Overrides:
    
    dispose in class GLViewer
  - dispose
```
public void dispose()
```
    Description copied from class: GLViewer
    
    MUST BE CALLED by whatever frame when it is going down, will notify any shared resources that they can be cleared. It is best to add it as a WindowListener
    
    Specified by:
    
    dispose in interface Viewer
    
    Overrides:
    
    dispose in class GLViewer
  - display
```
public void display(com.jogamp.opengl.GLAutoDrawable drawable,
                    int flags)
```
    Specified by:
    
    display in class GLViewer
  - getTextRenderer
```
public GLTextRenderer getTextRenderer()
```
    Specified by:
    
    getTextRenderer in class GLViewer
  - drawText
```
public double drawText(java.awt.Font font,
                       java.lang.String str,
                       float[] pos,
                       double emSize)
```
    Description copied from interface: Renderer
    
    Draws text in the x-y plane in model coordinates.
    
    Parameters:
    
    font - the font to use. The font size largely impacts the resolution of the renderer characters. A value of at least 32pt is recommended.
    
    str - string to render
    
    pos - position of the lower left of the text box (model coordinates)
    
    emSize - size of an `em' unit in model coordinates
    
    Returns:
    
    the advance distance in the x-direction (width of text)
  - setupScreenShot
```
public void setupScreenShot(int w,
                            int h,
                            int samples,
                            java.io.File file,
                            java.lang.String format)
```
    Description copied from class: GLViewer
    
    Setup for a screenshot during the next render cycle
    
    Specified by:
    
    setupScreenShot in class GLViewer
    
    Parameters:
    
    w - width of shot
    
    h - height of shot
    
    samples - number of samples to use for the multisample FBO (does antialiasing)
    
    file - file to which the screen shot should be written
    
    format - format string
  - setupScreenShot
```
public void setupScreenShot(int w,
                            int h,
                            java.io.File file,
                            java.lang.String format)
```
    Specified by:
    
    setupScreenShot in class GLViewer
  - awaitScreenShotCompletion
```
public void awaitScreenShotCompletion()
```
    Specified by:
    
    awaitScreenShotCompletion in class GLViewer
  - grabPending
```
public boolean grabPending()
```
    Specified by:
    
    grabPending in class GLViewer
  - cleanupScreenShots
```
public void cleanupScreenShots()
```
    Specified by:
    
    cleanupScreenShots in class GLViewer
  - maybeUpdateMaterials
```
public void maybeUpdateMaterials()
```
    Specified by:
    
    maybeUpdateMaterials in class GLViewer
  - drawSphere
```
public void drawSphere(float[] pnt,
                       double rad)
```
    Description copied from interface: Renderer
    
    Draws a sphere with a specified radius centered at a point in model coordinates, using the current shading and material. This method is functionally equivalent to Renderer.drawSphere(Vector3d,double).
    
    Parameters:
    
    pnt - center of the sphere
    
    rad - radius of the sphere
  - drawCube
```
public void drawCube(float[] pnt,
                     double w)
```
    Description copied from interface: Renderer
    
    Draws an axis-aligned cube with a specified width centered at a point in model coordinates, using the current shading and material.
    
    Parameters:
    
    pnt - center of the cube
    
    w - width of the cube
  - drawBox
```
public void drawBox(float[] pnt,
                    double wx,
                    double wy,
                    double wz)
```
    Description copied from interface: Renderer
    
    Draws an axis-aligned box in model coordinates, using the current shading and material.
    
    Parameters:
    
    pnt - center of the box
    
    wx - width in x
    
    wy - width in y
    
    wz - width in z
  - drawBox
```
public void drawBox(RigidTransform3d TBM,
                    Vector3d widths)
```
    Description copied from interface: Renderer
    
    Draws a box centered on the specified transform in model coordinates, using the current shading and material.
    
    Parameters:
    
    TBM - transform from box to model coordinates on which the box is centered
    
    widths - x,y,z widths of the box
  - drawSpindle
```
public void drawSpindle(float[] pnt0,
                        float[] pnt1,
                        double rad)
```
    Description copied from interface: Renderer
    
    Draws a spindle between two points in model coordinates, using the current shading and material. The resolution is specified by Renderer.getSurfaceResolution().
    
    Parameters:
    
    pnt0 - first end point
    
    pnt1 - second end point
    
    rad - radius of the spindle
  - drawCylinder
```
public void drawCylinder(float[] coords0,
                         float[] coords1,
                         double r,
                         boolean capped)
```
    Description copied from interface: Renderer
    
    Draws a cylinder between two points in model coordinates, using the current shading and material. The resolution is specified by Renderer.getSurfaceResolution().
    
    Parameters:
    
    coords0 - first end point
    
    coords1 - second end point
    
    r - radius of the cylinder
    
    capped - if true, indicates that the cylinder should have a solid cap on each end
  - drawCone
```
public void drawCone(float[] pnt0,
                     float[] pnt1,
                     double r0,
                     double r1,
                     boolean capped)
```
    Description copied from interface: Renderer
    
    Draws a cone between two points in model coordinates, using the current shading and material. A cone is like a cylinder, except that it can have different radii at the end points. The resolution is specified by Renderer.getSurfaceResolution().
    
    Parameters:
    
    pnt0 - first end point
    
    pnt1 - second end point
    
    r0 - radius at first end point
    
    r1 - radius at second end point
    
    capped - if true, indicates that the cone should have a solid cap on each end
  - setShaderOverride
```
public void setShaderOverride(java.lang.Object shaderKey,
                              java.io.File[] vf)
```
  - useProgram
```
public void useProgram(com.jogamp.opengl.GL3 gl,
                       java.lang.Object key)
```
  - drawLine
```
public void drawLine(RenderProps props,
                     float[] pnt0,
                     float[] pnt1,
                     float[] color,
                     boolean capped,
                     boolean highlight)
```
    Description copied from interface: Renderer
    
    Draws a single line between two points in model coordinates, using the line style, radius, line color, and shading specified by the render properties argument props. This method is functionally equivalent to Renderer.drawLine(RenderProps,float[],float[],boolean), except for the additional control provided by the arguments color and capped.
    
    Parameters:
    
    props - render properties used for drawing the line
    
    pnt0 - first point
    
    pnt1 - second point
    
    color - if not null, specifies an alternate color that should be used in place of the line color specified in props
    
    capped - if true, specifies that the line should have a solid cap on its ends for styles such as Renderer.LineStyle.CYLINDER and @link LineStyle#ARROW}
    
    highlight - if true, indicates that highlighting, if enabled, should be applied to the line
  - drawArrow
```
public void drawArrow(float[] pnt0,
                      float[] pnt1,
                      double rad,
                      boolean capped)
```
    Description copied from interface: Renderer
    
    Draws a solid arrow between two points in model coordinates, using the current shading and material. This method is functionally equivalent to Renderer.drawArrow(Vector3d,Vector3d,double,boolean) except that the points are specified using float[].
    
    Parameters:
    
    pnt0 - first end point
    
    pnt1 - second end point
    
    rad - radius of the cylinder
    
    capped - if true, indicates that the arrow should have a solid cap on the bottom
  - drawArrow
```
public void drawArrow(RenderProps props,
                      float[] pnt0,
                      float[] pnt1,
                      boolean capped,
                      boolean highlight)
```
    Description copied from interface: Renderer
    
    Draws an arrow between two points in model coordinates, using the radius, line color, and shading specified by the render properties argument props. The method behaves similarly to Renderer.drawArrow(float[],float[],double,boolean), with the cylinder radius determine instead by props.getLineRadius().
    
    Parameters:
    
    props - render properties used for drawing the arrow
    
    pnt0 - first point
    
    pnt1 - second point
    
    capped - if true, specifies that the arrow should have a solid cap on the bottom
    
    highlight - if true, indicates that highlighting, if enabled, should be applied to the arrow
  - drawPoint
```
public void drawPoint(RenderProps props,
                      float[] pnt,
                      boolean highlight)
```
    Description copied from interface: Renderer
    
    Draws a single point located at pnt in model coordinates, using the point style, size, point color, and shading specified by the render properties argument props. This method is functionally equivalent to Renderer.drawPoint(RenderProps,Vector3d,boolean) except that the point is specified using float[].
    
    Parameters:
    
    props - render properties used for drawing the point
    
    pnt - location of the point
    
    highlight - if true, indicates that highlighting, if enabled, should be applied to the point
  - drawAxes
```
public void drawAxes(com.jogamp.opengl.GL3 gl,
                     double len)
```
  - drawAxes
```
public void drawAxes(RigidTransform3d X,
                     double[] lens,
                     int width,
                     boolean highlight)
```
    Description copied from interface: Renderer
    
    Draws a set of coordinate axes representing a rigid coordinate frame X. This method is functionally equivalent to Renderer.drawAxes(RigidTransform3d,double,int,boolean), except that the lengths for each axis are individually specified. Axes with a a specified length of 0 will not be drawn.
    
    Parameters:
    
    X - coordinate frame defining the axes
    
    lens - lengths for each axis
    
    width - width of each axis (in pixels)
    
    highlight - if true, indicates that the axes should be highlighted.
  - drawLineStrip
```
public void drawLineStrip(RenderProps props,
                          java.lang.Iterable<float[]> pnts,
                          Renderer.LineStyle style,
                          boolean highlight)
```
    Description copied from interface: Renderer
    
    Draws a line strip between a series of points in model coordinates, using the radius, line color, and shading specified by the render properties argument props, and the line style specified by style.
    If the line style is Renderer.LineStyle.LINE, then the strip is drawn using pixel-based lines with a width given by props.getLineWidth(). For other line styles, the strip is drawn as solids with a nominal radius given by props.getLineRadius(). If highlight is true and the highlight style is Renderer.HighlightStyle.COLOR, then the strip will be drawn using the highlight color rather than the line color specified in props.
    
    Parameters:
    
    props - render properties used for drawing the strip
    
    pnts - list of points used for drawing the strip
    
    style - line style to be used for the strip
    
    highlight - if true, indicates that highlighting, if enabled, should be applied to the strip
  - setSurfaceResolution
```
public int setSurfaceResolution(int nres)
```
    Description copied from interface: Renderer
    
    Sets the resolution used for creating mesh representations of curved solids. The number represents the number of line segments that would be used to approximate a circle. This level of resolution is then employed to create the mesh.
    
    Specified by:
    
    setSurfaceResolution in interface Renderer
    
    Overrides:
    
    setSurfaceResolution in class GLViewer
    
    Parameters:
    
    nres - resolution for curved surfaces
    
    Returns:
    
    previous resolution
  - drawPoint
```
public void drawPoint(float[] pnt)
```
    Description copied from interface: Renderer
    
    Draws a single point located at pnt in model coordinates, using the current point size, material, and shading. This method is functionally equivalent to Renderer.drawPoint(Vector3d).
    
    Parameters:
    
    pnt - array (of length 3) giving the point to draw
  - drawLine
```
public void drawLine(float[] pnt0,
                     float[] pnt1)
```
    Description copied from interface: Renderer
    
    Draws a single line between two points in model coordinates, using the current line width, material, and shading. This method is functionally equivalent to Renderer.drawLine(Vector3d,Vector3d).
    
    Parameters:
    
    pnt0 - array (of length 3) giving the first point
    
    pnt1 - array (of length 3) giving the second point
  - drawTriangle
```
public void drawTriangle(float[] pnt0,
                         float[] pnt1,
                         float[] pnt2)
```
    Draw triangular faces, using the current Shading, lighting and material, and computing a single "face" normal from the coordinates (so the current "shading" really matters only if it is Shading.NONE).
    
    Parameters:
    
    pnt0 - first point
    
    pnt1 - second point
    
    pnt2 - third point
  - drawTriangles
```
public void drawTriangles(java.lang.Iterable<float[]> points)
```
  - drawTriangles
```
public void drawTriangles(RenderObject robj,
                          int gidx,
                          int offset,
                          int count)
```
    Description copied from interface: Renderer
    
    Draws a selection of triangles in the specified triangle group of the render object, using the current material and shading.
    
    Parameters:
    
    robj - render object
    
    gidx - triangle group index
    
    offset - triangle offset at which to start rendering
    
    count - number of triangles to draw
  - drawLines
```
public void drawLines(RenderObject robj,
                      int gidx)
```
    Description copied from interface: Renderer
    
    Draws all the lines in the specified line group of the render object, using the current material and shading.
    
    Parameters:
    
    robj - render object
    
    gidx - line group index
  - drawPoints
```
public void drawPoints(RenderObject robj,
                       int gidx)
```
    Description copied from interface: Renderer
    
    Draws all the points in the specified point group of the supplied render object, using the current material and shading.
    
    Parameters:
    
    robj - render object
    
    gidx - point group index
  - drawVertices
```
public void drawVertices(RenderObject robj,
                         Renderer.DrawMode mode)
```
    Description copied from interface: Renderer
    
    Draws all the vertices associated with the specified RenderObject, using a specified drawing mode and the current material and shading.
    
    Parameters:
    
    robj - render object
    
    mode - drawing mode to be used for drawing the vertices
  - drawVertices
```
public void drawVertices(RenderObject robj,
                         VertexIndexArray idxs,
                         int offset,
                         int count,
                         Renderer.DrawMode mode)
```
    Description copied from interface: Renderer
    
    Draws a selection of vertices associated with the specified RenderObject, using a specified drawing mode and the current material and shading. This version of the method should be favoured for persistent index lists, since the VertexIndexArray can detect whether or not it has been modified, which allows for caching. Additionally, this method allows specification of an offset and vertex count.
    
    Parameters:
    
    robj - render object
    
    idxs - vertex indices
    
    offset - index offset
    
    count - index count
    
    mode - drawing mode to be used for drawing the vertices
  - drawVertices
```
public void drawVertices(RenderObject robj,
                         int[] idxs,
                         Renderer.DrawMode mode)
```
  - drawLines
```
public void drawLines(RenderObject robj,
                      int gidx,
                      int offset,
                      int count,
                      Renderer.LineStyle style,
                      double rad)
```
    Description copied from interface: Renderer
    
    Draws a selection of lines in the specified line group of the supplied render object, using the current material and shading. The lines are drawn either as pixel-based lines or as solid primitives, according to the specified line style. For lines drawn using the style Renderer.LineStyle.LINE, the argument rad gives the line width, whereas for solid primitives (Renderer.LineStyle.CYLINDER, Renderer.LineStyle.SOLID_ARROW, Renderer.LineStyle.SPINDLE), it gives the nominal radius.
    
    Parameters:
    
    robj - render object
    
    gidx - line group index
    
    offset - line offset at which to begin drawing
    
    count - number of lines to draw
    
    style - line style to use for drawing
    
    rad - radius for solid lines or width for pixel-based lines
  - drawPoints
```
public void drawPoints(RenderObject robj,
                       int gidx,
                       int offset,
                       int count,
                       Renderer.PointStyle style,
                       double rad)
```
    Description copied from interface: Renderer
    
    Draws a selection of points in the specified point group of the supplied render object, using the current material and shading. The points are drawn either as pixel-based points or as solids, according to the specified points style. For points drawn using the style Renderer.PointStyle.POINT, the argument rad gives the point size, whereas for Renderer.PointStyle.CUBE it gives the cube half-width, and for Renderer.PointStyle.SPHERE it gives the sphere radius.
    
    Parameters:
    
    robj - render object
    
    gidx - point group index
    
    offset - point offset at which to begin within the point group
    
    count - number of points to draw
    
    style - point style to use for drawing
    
    rad - radius for spheres or width for pixel-based points
  - drawInstances
```
public void drawInstances(RenderObject robj,
                          RenderInstances rinst)
```
    Draw an object multiple times with differing per-instance information
    
    Parameters:
    
    robj - render object
    
    rinst - render instance info
  - drawPoints
```
public void drawPoints(RenderObject robj,
                       int gidx,
                       RenderInstances rinst)
```
    Draw an object multiple times with differing per-instance information
    
    Parameters:
    
    robj - render object
    
    gidx - point group index
    
    rinst - render instance info
  - drawLines
```
public void drawLines(RenderObject robj,
                      int gidx,
                      RenderInstances rinst)
```
    Draw an object multiple times with differing per-instance information
    
    Parameters:
    
    robj - render object
    
    gidx - line group index
    
    rinst - render instance info
  - drawTriangles
```
public void drawTriangles(RenderObject robj,
                          int gidx,
                          RenderInstances rinst)
```
    Draw an object multiple times with differing per-instance information
    
    Parameters:
    
    robj - render object
    
    gidx - triangle group index
    
    rinst - render instances
  - hasVertexColorMixing
```
public boolean hasVertexColorMixing(Renderer.ColorMixing cmix)
```
    Description copied from interface: Renderer
    
    Queries whether or not a specified method for combining vertex coloring and material coloring is supported by this Renderer.
    
    Specified by:
    
    hasVertexColorMixing in interface Renderer
    
    Specified by:
    
    hasVertexColorMixing in class GLViewer
    
    Returns:
    
    true if the color mixing method is supported
  - hasColorMapMixing
```
public boolean hasColorMapMixing(Renderer.ColorMixing cmix)
```
    Description copied from interface: Renderer
    
    Queries whether or not a specified method for combining color map and material coloring is supported by this Renderer.
    
    Specified by:
    
    hasColorMapMixing in interface Renderer
    
    Specified by:
    
    hasColorMapMixing in class GLViewer
    
    Returns:
    
    true if the color mixing method is supported
  - hasColorMapping
```
public boolean hasColorMapping()
```
    Description copied from interface: Renderer
    
    Queries whether or not this renderer supports color mapping.
    
    Returns:
    
    true if color mapping is supported.
  - hasNormalMapping
```
public boolean hasNormalMapping()
```
    Description copied from interface: Renderer
    
    Queries whether or not this renderer supports normal mapping.
    
    Returns:
    
    true if normal mapping is supported.
  - hasBumpMapping
```
public boolean hasBumpMapping()
```
    Description copied from interface: Renderer
    
    Queries whether or not this renderer supports bump mapping.
    
    Returns:
    
    true if bump mapping is supported.

Class GL3Viewer

Nested Class Summary

Nested classes/interfaces inherited from class maspack.render.GL.GLViewer

Nested classes/interfaces inherited from interface maspack.render.Viewer

Nested classes/interfaces inherited from interface maspack.render.Renderer

Field Summary

Fields inherited from class maspack.render.GL.GLViewer

Fields inherited from interface maspack.render.Renderer

Constructor Summary

Method Summary

Methods inherited from class maspack.render.GL.GLViewer

Methods inherited from class java.lang.Object

Constructor Detail

GL3Viewer

GL3Viewer

GL3Viewer

Method Detail

init

dispose

dispose

display

getTextRenderer

drawText

setupScreenShot

setupScreenShot

awaitScreenShotCompletion

grabPending

cleanupScreenShots

maybeUpdateMaterials

drawSphere

drawCube

drawBox

drawBox

drawSpindle

drawCylinder

drawCone

setShaderOverride

useProgram

drawLine

drawArrow

drawArrow

drawPoint

drawAxes

drawAxes

drawLineStrip

setSurfaceResolution

drawPoint

drawLine

drawTriangle

drawTriangles

drawTriangles

drawLines

drawPoints

drawVertices

drawVertices

drawVertices

drawLines

drawPoints

drawInstances

drawPoints

drawLines

drawTriangles

hasVertexColorMixing

hasColorMapMixing

hasColorMapping

hasNormalMapping

hasBumpMapping