InterpolatingGridBase (Artisynth API documentation)

java.lang.Object
- maspack.geometry.InterpolatingGridBase

All Implemented Interfaces:

HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

Direct Known Subclasses:

ScalarGridBase, VectorGrid
```
public abstract class InterpolatingGridBase
extends java.lang.Object
implements Renderable, Scannable
```
Base class for regular 3D grids that interpolate values using trilinear interpolation.
The grid is implemented as a regular 3D grid composed of nx X ny X nz vertices along the x, y and z directions, giving it a resolution of rx, ry, rz, cells along each of these directions, where rx = nx-1, ry = ny-1, and rz = nz-1. The grid has widths w = (wx, wy, wz) along each of these directions, and cell widths given by wx/rx, wy/ry, and wz/rz.
Several coordinate frames are associated with the grid:
- The local frame L in which local value queries are made. By default, the grid is centered on, and axis aligned with, the local frame. However, it is also possible to reposition the grid so that it has a center and an orientation defined with respect to L.
- The local frame L can itself by described with respect to a world frame W, using a rigid transform TLW that maps from local to world coordinates. Values queries can also be made with respect to world coordinates.
- The grid frame G is defined with respect to the grid itself, aligned with its orientation, and translated and scaled so that the coordinates of each vertex corresponds to (i, j, k), where i, j, and k are the vertex indices. The origin (0, 0, 0) hence corresponds to the minimum grid vertex. Conversion from grid to local coordinates is done using a combined scaling/rigid transform TGL.

Field Summary
- Fields inherited from interface maspack.render.IsRenderable
  TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors
Constructor and Description

InterpolatingGridBase(InterpolatingGridBase grid)
Creates a new grid base that is a copy of an existing one.

Constructors
Constructor and Description
`InterpolatingGridBase(InterpolatingGridBase grid)` Creates a new grid base that is a copy of an existing one.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clearColors()` Clears the color map used to specify vertex colors.
`RenderProps`	`createRenderProps()` Factory method to create render properties appropriate to this object.
`boolean`	`epsilonEquals(InterpolatingGridBase grid, double tol)` Returns `true` if this grid base equals another within a prescribed tolerance.
`Vector3i`	`getCellVertex(Vector3i xyzi, Point3d point)` Returns the x, y, z indices of the minimum vertex of the cell containing a given point in local coordinates.
`Vector3d`	`getCellWidths()` Returns the grid cell widths along each axis.
`void`	`getCenter(Vector3d center)` Returns the center of this grid with respect to its local coordinates.
`RigidTransform3d`	`getCenterAndOrientation()` Returns the transform TCL that describes the center and orientation of this grid with respect to local coordinates.
`int`	`getClosestVertex(Point3d point)` Returns the vertex index of the nearest vertex to a point in local coordinates.
`int`	`getDebug()`
`java.awt.Color`	`getDefaultVertexColor()` Returns the default color used for rendering vertices when a color map is specified.
`VectorTransformer3d`	`getGridToLocalTransformer()` Returns the transformer that maps from grid to local coordinates.
`RigidTransform3d`	`getLocalToWorld()` Returns the transform that maps from local to world coordinates.
`VectorTransformer3d`	`getLocalToWorldTransformer()` Returns the transformer that maps from local to world coordinates.
`Vector3d`	`getLocalVertexCoords(Vector3d coords, int vi)` Find the local coordinates of a vertex, as specified by its vertex index.
`Vector3d`	`getLocalVertexCoords(Vector3d coords, Vector3i vxyz)` Find the local coordinates of a vertex, as specified by its x, y, z indices.
`void`	`getOrientation(RotationMatrix3d R)` Returns the orientation of this grid with respect to its local coordinates.
`abstract java.lang.Class<?>`	`getParameterType()` For subclasses with parameterized typing, returns the type parameter.
`double`	`getRadius()` Returns the radius of this grid, defined as half the distance across its maximal diagonal.
`int`	`getRenderHints()` Returns a bit code giving rendering hints about this renderable.
`RenderProps`	`getRenderProps()` Returns the render properities for this object.
`java.lang.String`	`getRenderRanges()` Returns a string describing the render ranges for this grid, as described for `setRenderRanges(java.lang.String)`.
`boolean`	`getRenderVector(Vector3d vec3, int xi, int yj, int zk)` For grid subclasses wishing to render 3D vector information, this method should be overridden to optionally returns a vector quantity associated with the vertex at indices `xi`, `yj`, and `zk`.
`double`	`getRenderVectorScale()` For grid subclasses wishing to render 3D vector information, this method should be overridden to return a scaling factor to be applied to vectors returned by `getRenderVector(maspack.matrix.Vector3d, int, int, int)` to determine the length of the actual rendered vector.
`Vector3i`	`getResolution()` Returns the resolution of this grid along each axis.
`void`	`getSelection(java.util.LinkedList<java.lang.Object> list, int qid)` Append to `list` the component (or components) associated with the `qid`-th selection query issued by this component's render method.
`java.awt.Color`	`getVertexColor(int idx)` Returns the color used for rendering a specific vertex when using a color map.
`Vector3d`	`getWidths()` Returns the widths of this grid along the x, y, and z axes.
`void`	`getWidths(Vector3d widths)` Returns the widths of this grid along the x, y, and z axes.
`void`	`getWorldCenter(Point3d center)` Returns the center of this grid with respect to world coordinates.
`void`	`getWorldOrientation(RotationMatrix3d R)` Returns the orientation of this grid with respect to world coordinates.
`Vector3d`	`getWorldVertexCoords(Vector3d coords, int vi)` Find the world coordinates of a vertex, as specified by its vertex index.
`Vector3d`	`getWorldVertexCoords(Vector3d coords, Vector3i vxyz)` Find the world coordinates of a vertex, as specified by its x, y, z indices.
`boolean`	`hasLocalToWorld()` Queries whether this grid has a local-to-world transform that is not the identity.
`boolean`	`isSelectable()` Returns true if this object is in fact selectable.
`boolean`	`isVertexRenderingEnabled()` Queries whether rendering of vertices is enabled.
`boolean`	`isWritable()` Returns `true` if this component should in fact be written to secondary storage.
`int`	`numSelectionQueriesNeeded()` If this selectable manages its own selection (by issuing selection queries within its `render` method), then this method should return the maximum number of selection queries that will be required.
`int`	`numVertices()` Returns the total number of vertices in this grid.
`static int[]`	`parseRenderRanges(java.lang.String str, StringHolder errorMsg)` Parses a render range specification for this grid.
`void`	`prerender(RenderList list)` Called prior to rendering to allow this object to update the internal state required for rendering (such as by caching rendering coordinates).
`void`	`prerender(RenderProps props)`
`void`	`render(Renderer renderer, int flags)` Render this object using the functionality of the supplied `Renderer`.
`void`	`render(Renderer renderer, RenderProps props, int flags)`
`void`	`scaleDistance(double s)` Scales the distance units of the grid, which entails scaling the widths and coordinate transform information.
`void`	`scan(ReaderTokenizer rtok, java.lang.Object ref)` Scans this element from a ReaderTokenizer.
`void`	`set(InterpolatingGridBase grid)` Sets this grid base to be a copy of an existing one.
`void`	`setCenter(Vector3d center)` Sets the center of this grid with respect to its local coordinates.
`void`	`setCenterAndOrientation(RigidTransform3d TCL)` Sets the center and orientation of this grid with respect to local coordinates, by means of the transform `TCL` whose rotation matrix `R` gives the orientation and offset vector `p` gives the center.
`void`	`setDebug(int level)`
`void`	`setDefaultVertexColor(java.awt.Color color)` Sets the default color used for rendering vertices.
`void`	`setLocalToWorld(RigidTransform3d TLW)` Sets a transform that maps from local to world coordinates.
`void`	`setOrientation(RotationMatrix3d R)` Sets the orientation of this grid with respect to its local coordinates.
`void`	`setRenderProps(RenderProps props)` Assigns a new set of render properties to this object.
`void`	`setRenderRanges(java.lang.String str)` Sets the render ranges for this grid.
`void`	`setResolution(Vector3i resolution)` Sets the resolution for this grid along the x, y, and z axes.
`void`	`setVertexColor(int idx, java.awt.Color color)` Sets the color used to render a specific vertex.
`void`	`setVertexRenderingEnabled(boolean enable)` Enable or disable rendering of vertices.
`void`	`updateBounds(Vector3d pmin, Vector3d pmax)` Update the minimum and maximum points for this object.
`Vector3i`	`vertexToXyzIndices(Vector3i vxyz, int vi)` Given a vertex index `vi`, compute the corresponding x, y, z indices.
`void`	`write(java.io.PrintWriter pw, NumberFormat fmt, java.lang.Object ref)` Writes a text description of this element to a PrintWriter.
`int`	`xyzIndicesToVertex(Vector3i vxyz)` Given the x, y, z indices for a vertex, compute the corresponding vertex index.

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

- Constructor Detail
  - InterpolatingGridBase
```
public InterpolatingGridBase(InterpolatingGridBase grid)
```
    Creates a new grid base that is a copy of an existing one.
    
    Parameters:
    
    grid - grid base to copy
- Method Detail
  - getParameterType
```
public abstract java.lang.Class<?> getParameterType()
```
    For subclasses with parameterized typing, returns the type parameter. Othewise, returns null.
    
    Returns:
    
    type parameter, or null
  - setLocalToWorld
```
public void setLocalToWorld(RigidTransform3d TLW)
```
    Sets a transform that maps from local to world coordinates. If the specified transform is the identity, then hasLocalToWorld will subsequently return false.
    
    Parameters:
    
    TLW - transform from local to world coordinates
  - getLocalToWorld
```
public RigidTransform3d getLocalToWorld()
```
    Returns the transform that maps from local to world coordinates. If hasLocalToWorld returns false, this will be the identity.
    
    Returns:
    
    transform from local to world coordinates. Should not be modified.
  - hasLocalToWorld
```
public boolean hasLocalToWorld()
```
    Queries whether this grid has a local-to-world transform that is not the identity.
    
    Returns:
    
    true if the local-to-world transform is not the identity.
  - getLocalToWorldTransformer
```
public VectorTransformer3d getLocalToWorldTransformer()
```
    Returns the transformer that maps from local to world coordinates. If the local-to-world transform is the identity, then this will be an identity transformer.
    
    Returns:
    
    transformer that maps from local to world coordinates
  - getGridToLocalTransformer
```
public VectorTransformer3d getGridToLocalTransformer()
```
    Returns the transformer that maps from grid to local coordinates.
    
    Returns:
    
    transformer from grid to local coordinates
  - setResolution
```
public void setResolution(Vector3i resolution)
```
    Sets the resolution for this grid along the x, y, and z axes.
    
    Parameters:
    
    resolution - cell resolution along the x, y and z axes. Must be at least 1 along each axis.
  - set
```
public void set(InterpolatingGridBase grid)
```
    Sets this grid base to be a copy of an existing one.
    
    Parameters:
    
    grid - grid base to copy
  - clearColors
```
public void clearColors()
```
    Clears the color map used to specify vertex colors. When no color map is present, vertices are rendered using the point color of the render properties passed to the render method.
  - setVertexColor
```
public void setVertexColor(int idx,
                           java.awt.Color color)
```
    Sets the color used to render a specific vertex. If no color map is currently present, one is created.
    
    Parameters:
    
    idx - vertex index
    
    color - rendering color for the vertex
  - getVertexColor
```
public java.awt.Color getVertexColor(int idx)
```
    Returns the color used for rendering a specific vertex when using a color map. If no color map is currently present, null is returned.
    
    Parameters:
    
    idx - vertex index
    
    Returns:
    
    rendering color for the vertex
  - setDefaultVertexColor
```
public void setDefaultVertexColor(java.awt.Color color)
```
    Sets the default color used for rendering vertices. If no color map is currently present, one is initialized.
    
    Parameters:
    
    color - default vertex color when using a color map.
  - getDefaultVertexColor
```
public java.awt.Color getDefaultVertexColor()
```
    Returns the default color used for rendering vertices when a color map is specified. If no color map is currently present, then null is returned.
    
    Returns:
    
    default vertex color when using a color map.
  - setCenterAndOrientation
```
public void setCenterAndOrientation(RigidTransform3d TCL)
```
    Sets the center and orientation of this grid with respect to local coordinates, by means of the transform TCL whose rotation matrix R gives the orientation and offset vector p gives the center. All other aspects of the grid remain unchanged.
    
    Parameters:
    
    TCL - transform giving the center and orientation of the grid with respect to local coordinates.
  - getCenterAndOrientation
```
public RigidTransform3d getCenterAndOrientation()
```
    Returns the transform TCL that describes the center and orientation of this grid with respect to local coordinates.
    
    Returns:
    
    transform giving the center and orientation with respect to local coordinates. Should not be modified.
  - getCenter
```
public void getCenter(Vector3d center)
```
    Returns the center of this grid with respect to its local coordinates.
    
    Parameters:
    
    center - returns the grid center
  - setCenter
```
public void setCenter(Vector3d center)
```
    Sets the center of this grid with respect to its local coordinates.
    
    Parameters:
    
    center - new grid center
  - getOrientation
```
public void getOrientation(RotationMatrix3d R)
```
    Returns the orientation of this grid with respect to its local coordinates.
    
    Parameters:
    
    R - grid orientation in local coordinates
  - setOrientation
```
public void setOrientation(RotationMatrix3d R)
```
    Sets the orientation of this grid with respect to its local coordinates.
    
    Parameters:
    
    R - new grid orientation in local coordinates
  - getWorldOrientation
```
public void getWorldOrientation(RotationMatrix3d R)
```
    Returns the orientation of this grid with respect to world coordinates.
    
    Parameters:
    
    R - grid orientation in world coordinates
  - getWorldCenter
```
public void getWorldCenter(Point3d center)
```
    Returns the center of this grid with respect to world coordinates.
    
    Parameters:
    
    center - returns the grid center
  - getCellVertex
```
public Vector3i getCellVertex(Vector3i xyzi,
                              Point3d point)
```
    Returns the x, y, z indices of the minimum vertex of the cell containing a given point in local coordinates. If point is outside the grid, null is returned.
    
    Parameters:
    
    xyzi - returns the x, y, z indices. If specified as null, then the containing vector is allocated internally.
    
    point - point for which the cell vertex is desired (local coordinates)
    
    Returns:
    
    vector containing the cell vertex indices, or null if point is outside the grid.
  - vertexToXyzIndices
```
public Vector3i vertexToXyzIndices(Vector3i vxyz,
                                   int vi)
```
    Given a vertex index vi, compute the corresponding x, y, z indices.
    
    Parameters:
    
    vxyz - returns the x, y, z indices.
    
    vi - vertex index
    
    Returns:
    
    reference to vxyz
  - xyzIndicesToVertex
```
public int xyzIndicesToVertex(Vector3i vxyz)
```
    Given the x, y, z indices for a vertex, compute the corresponding vertex index.
    
    Parameters:
    
    vxyz - x, y, z indices
    
    Returns:
    
    vertex index
  - getResolution
```
public Vector3i getResolution()
```
    Returns the resolution of this grid along each axis. This equals the number of cells along each axis.
    
    Returns:
    
    number of cells along each axis
  - getCellWidths
```
public Vector3d getCellWidths()
```
    Returns the grid cell widths along each axis. For each axis i, this equals w_i/res_i, where w_i and res_i are the overall width and resolution associated with that axis.
    
    Returns:
    
    grid cell widths in each direction
  - getWidths
```
public Vector3d getWidths()
```
    Returns the widths of this grid along the x, y, and z axes.
    
    Returns:
    
    grid widths (passed by value, can be modified)
  - getWidths
```
public void getWidths(Vector3d widths)
```
    Returns the widths of this grid along the x, y, and z axes.
    
    Parameters:
    
    widths - returns the grid widths
  - numVertices
```
public int numVertices()
```
    Returns the total number of vertices in this grid.
    
    Returns:
    
    number of grid vertices
  - getRenderVector
```
public boolean getRenderVector(Vector3d vec3,
                               int xi,
                               int yj,
                               int zk)
```
    For grid subclasses wishing to render 3D vector information, this method should be overridden to optionally returns a vector quantity associated with the vertex at indices xi, yj, and zk. Should returns null if no vector information should be rendered at that vertex.
    
    Parameters:
    
    vec3 - three vector value
    
    xi - x vertex index
    
    yj - y vertex index
    
    zk - z vertex index
    
    Returns:
    
    true if the vector quantity maps to a 3-vector value
  - getRenderVectorScale
```
public double getRenderVectorScale()
```
    For grid subclasses wishing to render 3D vector information, this method should be overridden to return a scaling factor to be applied to vectors returned by getRenderVector(maspack.matrix.Vector3d, int, int, int) to determine the length of the actual rendered vector. Returning 0 disables vector rendering.
    
    Returns:
    
    scaling factor for rendered vectors
  - getRenderProps
```
public RenderProps getRenderProps()
```
    Returns the render properities for this object. If no render properties are assigned, this routines returns null.
    
    Specified by:
    
    getRenderProps in interface HasRenderProps
    
    Returns:
    
    current render properties for this object
  - createRenderProps
```
public RenderProps createRenderProps()
```
    Factory method to create render properties appropriate to this object.
    
    Specified by:
    
    createRenderProps in interface HasRenderProps
    
    Returns:
    
    new render properties for this object
  - setRenderProps
```
public void setRenderProps(RenderProps props)
```
    Assigns a new set of render properties to this object. An argument of null will remove render properties from this object.
    
    Specified by:
    
    setRenderProps in interface HasRenderProps
    
    Parameters:
    
    props - new render properties for this object
  - setVertexRenderingEnabled
```
public void setVertexRenderingEnabled(boolean enable)
```
    Enable or disable rendering of vertices. Default is true.
    
    Parameters:
    
    enable - if true, enables vertex rendering
  - isVertexRenderingEnabled
```
public boolean isVertexRenderingEnabled()
```
    Queries whether rendering of vertices is enabled.
    
    Returns:
    
    true if vertex rendering is enabled
  - getSelection
```
public void getSelection(java.util.LinkedList<java.lang.Object> list,
                         int qid)
```
    Append to list the component (or components) associated with the qid-th selection query issued by this component's render method. This will only be called if this component manages its own selection (i.e., the number nums returned by IsSelectable.numSelectionQueriesNeeded() is positive), and qid will in turn be a number between 0 and nums-1.
    
    Specified by:
    
    getSelection in interface IsSelectable
    
    Parameters:
    
    list - selected objects are appended to the end of this list
    
    qid - index of the selection query
  - isSelectable
```
public boolean isSelectable()
```
    Returns true if this object is in fact selectable.
    
    Specified by:
    
    isSelectable in interface IsSelectable
    
    Returns:
    
    true if this object is selectable
  - numSelectionQueriesNeeded
```
public int numSelectionQueriesNeeded()
```
    If this selectable manages its own selection (by issuing selection queries within its render method), then this method should return the maximum number of selection queries that will be required. Otherwise, this method should return -1.
    
    Specified by:
    
    numSelectionQueriesNeeded in interface IsSelectable
    
    Returns:
    
    maximum number of selection queries needed by this component, or -1 if this component does not manage its own selection.
  - prerender
```
public void prerender(RenderList list)
```
    Called prior to rendering to allow this object to update the internal state required for rendering (such as by caching rendering coordinates). The object may add internal objects to the list of objects being rendered, by calling
    list.addIfVisible (obj);
    for each of the objects in question.
    
    Specified by:
    
    prerender in interface IsRenderable
    
    Parameters:
    
    list - list of objects to be rendered
  - prerender
```
public void prerender(RenderProps props)
```
  - render
```
public void render(Renderer renderer,
                   int flags)
```
    Render this object using the functionality of the supplied Renderer.
    
    Specified by:
    
    render in interface IsRenderable
    
    Parameters:
    
    renderer - provides the functionality used to perform the rendering.
    
    flags - flags that may be used to control different aspects of the rendering. Flags are defined in Renderer and currently include Renderer.HIGHLIGHT and Renderer.SORT_FACES.
  - render
```
public void render(Renderer renderer,
                   RenderProps props,
                   int flags)
```
  - updateBounds
```
public void updateBounds(Vector3d pmin,
                         Vector3d pmax)
```
    Update the minimum and maximum points for this object. In an x-y-z coordinate system with x directed to the right and y directed upwards, the minimum and maximum points can be thought of as defining the left-lower-far and right-upper-near corners of a bounding cube. This method should only reduce the elements of the minimum point and increase the elements of the maximum point, since it may be used as part of an iteration to determine the bounding cube for several different objects.
    
    Specified by:
    
    updateBounds in interface IsRenderable
    
    Parameters:
    
    pmin - minimum point
    
    pmax - maximum point
  - getRenderHints
```
public int getRenderHints()
```
    Returns a bit code giving rendering hints about this renderable. Current bit codes include TRANSPARENT and TWO_DIMENSIONAL.
    
    Specified by:
    
    getRenderHints in interface IsRenderable
    
    Returns:
    
    bit code of rendering hints.
  - getClosestVertex
```
public int getClosestVertex(Point3d point)
```
    Returns the vertex index of the nearest vertex to a point in local coordinates.
    
    Parameters:
    
    point - point for which to calculate nearest vertex (local coordinates)
    
    Returns:
    
    index of nearest vertex to point
  - getLocalVertexCoords
```
public Vector3d getLocalVertexCoords(Vector3d coords,
                                     int vi)
```
    Find the local coordinates of a vertex, as specified by its vertex index.
    
    Parameters:
    
    coords - if not null, supplies a vector for returning the coordinates
    
    vi - vertex index
    
    Returns:
    
    vertex coordinates
  - getLocalVertexCoords
```
public Vector3d getLocalVertexCoords(Vector3d coords,
                                     Vector3i vxyz)
```
    Find the local coordinates of a vertex, as specified by its x, y, z indices.
    
    Parameters:
    
    coords - if not null, supplies a vector for returning the coordinates
    
    vxyz - x, y, z vertex indices
    
    Returns:
    
    vertex coordinates
  - getWorldVertexCoords
```
public Vector3d getWorldVertexCoords(Vector3d coords,
                                     int vi)
```
    Find the world coordinates of a vertex, as specified by its vertex index.
    
    Parameters:
    
    coords - if not null, supplies a vector for returning the coordinates
    
    vi - vertex index
    
    Returns:
    
    vertex coordinates
  - getWorldVertexCoords
```
public Vector3d getWorldVertexCoords(Vector3d coords,
                                     Vector3i vxyz)
```
    Find the world coordinates of a vertex, as specified by its x, y, z indices.
    
    Parameters:
    
    coords - if not null, supplies a vector for returning the coordinates
    
    vxyz - x, y, z vertex indices
    
    Returns:
    
    vertex coordinates
  - getRenderRanges
```
public java.lang.String getRenderRanges()
```
    Returns a string describing the render ranges for this grid, as described for setRenderRanges(java.lang.String).
    
    Returns:
    
    render range string
  - setRenderRanges
```
public void setRenderRanges(java.lang.String str)
```
    Sets the render ranges for this grid. The render ranges control the range of vertices that are rendering along each axis when the grid is being rendered.
    The format consists of three separate range descriptors, one for each axis. A range descriptor may be '*' (all vertices), 'n:m' (vertices in the index range n to m, inclusive), or 'n' (vertices only at index n). For example:
```
   "* * *"     - all vertices      
   "* 7 *"     - all vertices along x and z, and those at index 7 along y
   "0 2 3"     - a single vertex at indices (0, 2, 3)
   "0:3 4:5 *" - all vertices between indices 0-3 along x, and 4-5 along y
 
```
    In addition, the single charater "*" also indicates all vertices.
    Parameters:
    
    str - render range specification
    
    Throws:
    
    java.lang.IllegalArgumentException - if the range specification is not valid.
  - parseRenderRanges
```
public static int[] parseRenderRanges(java.lang.String str,
                                      StringHolder errorMsg)
```
    Parses a render range specification for this grid. The specification must have the format described for setRenderRanges(java.lang.String). This method does not set anything; it simply parses the ranges and converts then into an integer array of length 6, giving the upper and lower bounds along each of the x, y, and z axes. For the ``all'' specifier ('*'), the values 0 and Integer.MAX_VALUE are used. Applications can use this method to test if a range specification is valid prior to calling setRenderRanges(java.lang.String). If the specification is invalid, then an error message is placed in errorMsg and the method returns null.
    
    Parameters:
    
    str - range specification
    
    errorMsg - returns an error message in case of an error
    
    Returns:
    
    array giving the ranges, or null if there is an error
  - getRadius
```
public double getRadius()
```
    Returns the radius of this grid, defined as half the distance across its maximal diagonal.
    
    Returns:
    
    radius of this grid
  - scan
```
public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException
```
    Scans this element from a ReaderTokenizer. The expected text format is assumed to be compatible with that produced by write.
    
    Specified by:
    
    scan in interface Scannable
    
    Parameters:
    
    rtok - Tokenizer from which to scan the element
    
    ref - optional reference object which can be used for resolving references to other objects
    
    Throws:
    
    java.io.IOException - if an I/O or formatting error occured
  - write
```
public void write(java.io.PrintWriter pw,
                  NumberFormat fmt,
                  java.lang.Object ref)
           throws java.io.IOException
```
    Writes a text description of this element to a PrintWriter. The text description should be compatable with scan and complete enough to allow full reconstruction of the element.
    
    Specified by:
    
    write in interface Scannable
    
    Parameters:
    
    pw - stream for writing the element
    
    fmt - numeric formating information
    
    ref - optional reference object which can be used for producing references to other objects
    
    Throws:
    
    java.io.IOException - if an I/O error occured
  - isWritable
```
public boolean isWritable()
```
    Description copied from interface: Scannable
    
    Returns true if this component should in fact be written to secondary storage. This gives subclasses control over whether or not they are actually written out.
    
    Specified by:
    
    isWritable in interface Scannable
    
    Returns:
    
    true if this component should be written to secondary storage.
  - epsilonEquals
```
public boolean epsilonEquals(InterpolatingGridBase grid,
                             double tol)
```
    Returns true if this grid base equals another within a prescribed tolerance. The grid bases are equal if the resolution, widths, center, and orientation are equal. Specifying tol = 0 requires exact equality.
    
    Parameters:
    
    grid - grid base to compare against
    
    tol - floating point tolerance (absolute)
  - getDebug
```
public int getDebug()
```
  - setDebug
```
public void setDebug(int level)
```
  - scaleDistance
```
public void scaleDistance(double s)
```
    Scales the distance units of the grid, which entails scaling the widths and coordinate transform information.
    
    Parameters:
    
    s - scaling factor

Class InterpolatingGridBase

Field Summary

Fields inherited from interface maspack.render.IsRenderable

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

InterpolatingGridBase

Method Detail

getParameterType

setLocalToWorld

getLocalToWorld

hasLocalToWorld

getLocalToWorldTransformer

getGridToLocalTransformer

setResolution

set

clearColors

setVertexColor

getVertexColor

setDefaultVertexColor

getDefaultVertexColor

setCenterAndOrientation

getCenterAndOrientation

getCenter

setCenter

getOrientation

setOrientation

getWorldOrientation

getWorldCenter

getCellVertex

vertexToXyzIndices

xyzIndicesToVertex

getResolution

getCellWidths

getWidths

getWidths

numVertices

getRenderVector

getRenderVectorScale

getRenderProps

createRenderProps

setRenderProps

setVertexRenderingEnabled

isVertexRenderingEnabled

getSelection

isSelectable

numSelectionQueriesNeeded

prerender

prerender

render

render

updateBounds

getRenderHints

getClosestVertex

getLocalVertexCoords

getLocalVertexCoords

getWorldVertexCoords

getWorldVertexCoords

getRenderRanges

setRenderRanges

parseRenderRanges

getRadius

scan

write

isWritable

epsilonEquals

getDebug

setDebug

scaleDistance