GraphUtil

java.lang.Object
- org.das2.graph.GraphUtil

```
public class GraphUtil
extends java.lang.Object
```
Utilities for drawing graphics and establishing standard behavior. This provides functions to get a 16x16 icon for a color, getting a Path from a series of data points, and a "visualize" method for simply looking at some data.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`GraphUtil.Copyable<T>` Classes that implement this interface provide their instances with the ability to copy themselves in a manner similar to Cloneable objects, but without the drawbacks of Cloneable.
`static class`	`GraphUtil.DebuggingGeneralPath` DebuggingGeneralPath can be used for debugging.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`CONNECT_MODE_HISTOGRAM` draw the lines in histogram mode, horizontal to the half-way point, then vertical, then horizontal the rest of the way.
`static java.lang.String`	`CONNECT_MODE_SCATTER` don't draw connecting lines.
`static java.lang.String`	`CONNECT_MODE_SERIES` the normal connecting mode from point-to-point in a series.
`static java.lang.String`	`FILL_TEXTURE_BACKHASH`
`static java.lang.String`	`FILL_TEXTURE_CROSSHASH`
`static java.lang.String`	`FILL_TEXTURE_HASH`
`static java.lang.String`	`FILL_TEXTURE_NONE`
`static java.lang.String`	`FILL_TEXTURE_SOLID`
`static int`	`MAX_TICKS` limit the number of ticks which are computed

Constructor Summary

Constructors
Constructor and Description

GraphUtil()

Constructors
Constructor and Description
`GraphUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static java.awt.image.BufferedImage`	`blurImage(java.awt.image.BufferedImage im, int size)` blur the image with a Guassian blur.
`static java.awt.geom.AffineTransform`	`calculateAT(DasAxis xaxis0, DasAxis yaxis0, DasAxis xaxis1, DasAxis yaxis1)` calculates the AffineTransform between two sets of x and y axes, if possible.
`static java.awt.geom.AffineTransform`	`calculateAT(DatumRange xaxis0, DatumRange yaxis0, DasAxis xaxis1, DasAxis yaxis1)`
`static TickVDescriptor`	`calculateManualTicks(java.lang.String lticks, DatumRange dr, boolean log)` calculate a TickVDescriptor for the ticks.
`static int`	`clipPath(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result, java.awt.Rectangle clip)` clip the path to within the clip rectangle.
`static javax.swing.Icon`	`colorIcon(java.awt.Color iconColor, int w, int h)` return an icon block with the color and size.
`static javax.swing.ImageIcon`	`colorImageIcon(java.awt.Color iconColor, int w, int h)` return an ImageIcon with the color and size.
`static DasAxis`	`copyAxis(DasAxis a)` return a copy of the plot.
`static DasColorBar`	`copyColorBar(DasColorBar a)` return a copy of the plot.
`static DasPlot`	`copyPlot(DasPlot p)` return a copy of the plot.
`static java.lang.String`	`describe(java.awt.geom.GeneralPath path, boolean enumeratePoints)` describe the path for debugging.
`static void`	`fillWithTexture(java.awt.Graphics2D g, java.awt.geom.GeneralPath pbox, java.awt.Color fillColor, java.lang.String fillTexture)` fill the region using the specified fillTexture.
`static java.lang.String`	`getATScaleTranslateString(java.awt.geom.AffineTransform at)` return a string representation of the affine transforms used in DasPlot for debugging.
`static Converter`	`getFontConverter(DasCanvasComponent dcc, java.lang.String fallbackFont)` converts forward from relative font spec to point size, used by the annotation and axis nodes.
`static java.awt.image.ConvolveOp`	`getGaussianBlurFilter(int radius, boolean horizontal)` return a Gaussian filter for blurring images.
`static java.awt.geom.GeneralPath`	`getPath(DasAxis xAxis, DasAxis yAxis, QDataSet ds, boolean histogram, boolean clip)` get the path for the points, checking for breaks in the data from fill values.
`static java.awt.geom.GeneralPath`	`getPath(DasAxis xAxis, DasAxis yAxis, QDataSet xds, QDataSet yds, boolean histogram, boolean clip)` get the path for the points, checking for breaks in the data from fill values.
`static java.awt.geom.GeneralPath`	`getPath(DasAxis xAxis, DasAxis yAxis, QDataSet xds, QDataSet yds, java.lang.String mode, boolean clip)` get the path for the points, checking for breaks in the data from fill values or breaks suggested by linear cadence in the DEPEND_0 of yds.
`static java.awt.Color`	`getRicePaperColor()` return translucent white color for indicating the application is busy.
`static java.lang.String`	`getSegNameFor(int type)` print the name for the segment type
`static double[]`	`getSlopeIntercept(double x0, double y0, double x1, double y1)` calculates the slope and intercept of a line going through two points.
`static DasPlot`	`guessPlot(QDataSet ds)` get a plot and renderer for the dataset.
`static Renderer`	`guessRenderer(QDataSet ds)` legacy guess that is used who-knows-where.
`static DasAxis`	`guessXAxis(QDataSet ds)`
`static DasAxis`	`guessYAxis(QDataSet dsz)`
`static DasAxis`	`guessZAxis(QDataSet dsz)`
`static DatumRange`	`invTransformRange(DasAxis axis, double x1, double x2)`
`static java.awt.geom.Point2D`	`lineIntersection(java.awt.geom.Line2D line1, java.awt.geom.Line2D line2, boolean noBoundsCheck)` returns the point where the two line segments intersect, or null.
`static java.awt.geom.Point2D`	`lineRectangleIntersection(java.awt.geom.Point2D p0, java.awt.geom.Point2D p1, java.awt.geom.Rectangle2D r0)` return the intersection of a line segment and the edge of a rectangle, where one point is outside of the rectangle and one is inside.
`static java.awt.geom.Line2D`	`lineRectangleMask(java.awt.geom.Point2D p0, java.awt.geom.Point2D p1, java.awt.geom.Rectangle2D r)` return the line segment which is within the rectangle mask.
`static DasPlot`	`newDasPlot(DasCanvas canvas, DatumRange x, DatumRange y)` create a plot for the canvas, along with the row and column for layout.
`static GrannyTextEditor`	`newGrannyTextEditor()` return a GrannyTextEditor with the Das2Core extras added.
`static GrannyTextRenderer`	`newGrannyTextRenderer()` return a GrannyTextEditor with the Das2Core extras added.
`static double`	`parseLayoutLength(java.lang.String s, double totalWidth, double em)` parse strings like "14em+2pt" into a length in pixels.
`static java.awt.geom.Line2D`	`perpendicularLine(java.awt.geom.Line2D line, java.awt.Point p, double len)` create a line perpendicular to the line segment `line`, which would go through `p`, and have length `abs(len)`.
`static double`	`pointsAlongCurve(java.awt.geom.PathIterator it, double[] pathlen, java.awt.geom.Point2D.Double[] result, double[] orientation, boolean stopAtMoveTo)` return the points along a curve.
`static double`	`pointsAlongCurve(java.awt.geom.PathIterator it, double[] pathlen, java.awt.geom.Point2D.Double[] result, double[] orientation, boolean stopAtMoveTo, java.util.Map<java.lang.String,java.lang.Object> props)` return the points along a curve.
`static int`	`reducePath(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result)` Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points.
`static int`	`reducePath(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result, int res)` Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points.
`static int`	`reducePath20140622(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result, int resn, int resd)` New ReducePath reduces a path by keeping track of vertically collinear points, and reducing them to an entry point, an exit point, min and max.
`static java.awt.geom.Line2D`	`shortenLine(java.awt.geom.Line2D line, double l1, double l2)` return line shorted by so many pixels at each end.
`static java.awt.Rectangle`	`shrinkRectangle(java.awt.Rectangle bounds, int percent)` return rectangle with same center that is percent/100 of the original width and height.
`static double[]`	`transformRange(DasAxis axis, DatumRange range)` returns pixel range of the datum range, guarenteeing that the first element will be less than or equal to the second.
`static DasPlot`	`visualize(QDataSet ds)` get a plot and add it to a JFrame.

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

- Field Detail
  - FILL_TEXTURE_CROSSHASH
```
public static java.lang.String FILL_TEXTURE_CROSSHASH
```
  - FILL_TEXTURE_HASH
```
public static java.lang.String FILL_TEXTURE_HASH
```
  - FILL_TEXTURE_BACKHASH
```
public static java.lang.String FILL_TEXTURE_BACKHASH
```
  - FILL_TEXTURE_SOLID
```
public static java.lang.String FILL_TEXTURE_SOLID
```
  - FILL_TEXTURE_NONE
```
public static java.lang.String FILL_TEXTURE_NONE
```
  - CONNECT_MODE_HISTOGRAM
```
public static final java.lang.String CONNECT_MODE_HISTOGRAM
```
    draw the lines in histogram mode, horizontal to the half-way point, then vertical, then horizontal the rest of the way.
    
    See Also:
    
    Constant Field Values
  - CONNECT_MODE_SCATTER
```
public static final java.lang.String CONNECT_MODE_SCATTER
```
    don't draw connecting lines.
    
    See Also:
    
    Constant Field Values
  - CONNECT_MODE_SERIES
```
public static final java.lang.String CONNECT_MODE_SERIES
```
    the normal connecting mode from point-to-point in a series.
    
    See Also:
    
    Constant Field Values
  - MAX_TICKS
```
public static final int MAX_TICKS
```
    limit the number of ticks which are computed
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - GraphUtil
```
public GraphUtil()
```
- Method Detail
  - fillWithTexture
```
public static void fillWithTexture(java.awt.Graphics2D g,
                                   java.awt.geom.GeneralPath pbox,
                                   java.awt.Color fillColor,
                                   java.lang.String fillTexture)
```
    fill the region using the specified fillTexture.
    
    Parameters:
    
    g - the graphics context
    
    pbox - a general path
    
    fillColor - if non-null, set this color to fill and return to the original color
    
    fillTexture - one of the enumerations: none, hash, crosshash, backhash, and solid (and "" is an alias for solid)
    
    See Also:
    
    Renderer.CONTROL_KEY_FILL_TEXTURE
  - newGrannyTextRenderer
```
public static GrannyTextRenderer newGrannyTextRenderer()
```
    return a GrannyTextEditor with the Das2Core extras added. Examples include:
    - block
    - img;https://autoplot.org/Logo96.png;50%
    Returns:
  - newGrannyTextEditor
```
public static GrannyTextEditor newGrannyTextEditor()
```
    return a GrannyTextEditor with the Das2Core extras added.
    
    Returns:
  - newDasPlot
```
public static DasPlot newDasPlot(DasCanvas canvas,
                                 DatumRange x,
                                 DatumRange y)
```
    create a plot for the canvas, along with the row and column for layout.
    
    Parameters:
    
    canvas - the canvas parent for the plot.
    
    x - the x range
    
    y - the y range
    
    Returns:
    
    the plot.
  - getPath
```
public static java.awt.geom.GeneralPath getPath(DasAxis xAxis,
                                                DasAxis yAxis,
                                                QDataSet ds,
                                                boolean histogram,
                                                boolean clip)
```
    get the path for the points, checking for breaks in the data from fill values.
    
    Parameters:
    
    xAxis - the x axis.
    
    yAxis - the y axis.
    
    ds - the y values. SemanticOps.xtagsDataSet is used to extract the x values.
    
    histogram - if true, use histogram (stair-step) mode
    
    clip - limit path to what's visible for each axis.
    
    Returns:
    
    the GeneralPath.
  - getPath
```
public static java.awt.geom.GeneralPath getPath(DasAxis xAxis,
                                                DasAxis yAxis,
                                                QDataSet xds,
                                                QDataSet yds,
                                                boolean histogram,
                                                boolean clip)
```
    get the path for the points, checking for breaks in the data from fill values.
    
    Parameters:
    
    xAxis - the x axis.
    
    yAxis - the y axis.
    
    xds - the x values.
    
    yds - the y values.
    
    histogram - if true, use histogram (stair-step) mode
    
    clip - limit path to what's visible for each axis.
    
    Returns:
    
    the GeneralPath.
  - getSegNameFor
```
public static final java.lang.String getSegNameFor(int type)
```
    print the name for the segment type
    
    Parameters:
    
    type -
    
    Returns:
    
    "SEG_MOVETO", etc or "SEG_???"
  - getPath
```
public static java.awt.geom.GeneralPath getPath(DasAxis xAxis,
                                                DasAxis yAxis,
                                                QDataSet xds,
                                                QDataSet yds,
                                                java.lang.String mode,
                                                boolean clip)
```
    get the path for the points, checking for breaks in the data from fill values or breaks suggested by linear cadence in the DEPEND_0 of yds.
    
    Parameters:
    
    xAxis - the x axis.
    
    yAxis - the y axis.
    
    xds - the x values.
    
    yds - the y values, possibly containing a DEPEND_0.
    
    mode - one of CONNECT_MODE_SERIES, CONNECT_MODE_SCATTER, or CONNECT_MODE_HISTOGRAM
    
    clip - limit path to what's visible for each axis.
    
    Returns:
    
    the GeneralPath.
    
    See Also:
    
    CONNECT_MODE_SERIES, CONNECT_MODE_SCATTER, CONNECT_MODE_HISTOGRAM
  - calculateAT
```
public static java.awt.geom.AffineTransform calculateAT(DasAxis xaxis0,
                                                        DasAxis yaxis0,
                                                        DasAxis xaxis1,
                                                        DasAxis yaxis1)
```
    calculates the AffineTransform between two sets of x and y axes, if possible.
    
    Parameters:
    
    xaxis0 - the original reference frame x axis
    
    yaxis0 - the original reference frame y axis
    
    xaxis1 - the new reference frame x axis
    
    yaxis1 - the new reference frame y axis
    
    Returns:
    
    an AffineTransform that transforms data positioned with xaxis0 and yaxis0 on xaxis1 and yaxis1, or null if no such transform exists.
  - calculateAT
```
public static java.awt.geom.AffineTransform calculateAT(DatumRange xaxis0,
                                                        DatumRange yaxis0,
                                                        DasAxis xaxis1,
                                                        DasAxis yaxis1)
```
  - guessYAxis
```
public static DasAxis guessYAxis(QDataSet dsz)
```
  - guessXAxis
```
public static DasAxis guessXAxis(QDataSet ds)
```
  - guessZAxis
```
public static DasAxis guessZAxis(QDataSet dsz)
```
  - guessRenderer
```
public static Renderer guessRenderer(QDataSet ds)
```
    legacy guess that is used who-knows-where. Autoplot has much better code for guessing, refer to it.
    
    Parameters:
    
    ds -
    
    Returns:
  - guessPlot
```
public static DasPlot guessPlot(QDataSet ds)
```
    get a plot and renderer for the dataset.
    
    Parameters:
    
    ds - the dataset
    
    Returns:
    
    a plot with a renderer for the dataset.
  - copyAxis
```
public static DasAxis copyAxis(DasAxis a)
```
    return a copy of the plot. It does not have the row and column set to its own row and column.
    
    Parameters:
    
    a -
    
    Returns:
  - copyColorBar
```
public static DasColorBar copyColorBar(DasColorBar a)
```
    return a copy of the plot. It does not have the row and column set to its own row and column.
    
    Parameters:
    
    a -
    
    Returns:
  - copyPlot
```
public static DasPlot copyPlot(DasPlot p)
```
    return a copy of the plot. This will include the Renderers and the data they contain. The plot is not attached to a canvas or row and column.
```
 
   cnvsNew= new DasCanvas(500,500);
   row= new DasRow(cnvsNew,0.2,0.8);
   column= new DasColumn(cnvsNew,0.2,0.8);
   p= GraphUtil.copyPlot(dp); 
   cnvsNew.add(p,row,column); 
 
 
```
    Parameters:
    
    p -
    
    Returns:
  - visualize
```
public static DasPlot visualize(QDataSet ds)
```
    get a plot and add it to a JFrame.
    
    Parameters:
    
    ds -
    
    Returns:
  - clipPath
```
public static int clipPath(java.awt.geom.PathIterator it,
                           java.awt.geom.GeneralPath result,
                           java.awt.Rectangle clip)
```
    clip the path to within the clip rectangle. Note this may introduce breaks where the path was continuous before. Note this does not work with quadTo etc. This was motivated by an old version of Adobe Illustrator which didn't respect the clip set in the PDF, and with the journal Nature, which apparently uses an old version of Illustrator.
    
    Parameters:
    
    it -
    
    result -
    
    clip -
    
    Returns:
  - reducePath20140622
```
public static int reducePath20140622(java.awt.geom.PathIterator it,
                                     java.awt.geom.GeneralPath result,
                                     int resn,
                                     int resd)
```
    New ReducePath reduces a path by keeping track of vertically collinear points, and reducing them to an entry point, an exit point, min and max. This can be all four in one point. We also limit the resolution and combine points that are basically the same value, using resn and resd (numerator and denominator). For example (1/5) would mean that points within x of 1/5 of one another are considered vertically collinear.
    
    Parameters:
    
    it - input path.
    
    result - output path.
    
    resn - the resolution numerator (e.g. 1)
    
    resd - the resolution denominator (e.g. 5)
    
    Returns:
    
    the number of points.
  - reducePath
```
public static int reducePath(java.awt.geom.PathIterator it,
                             java.awt.geom.GeneralPath result)
```
    Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points. We bin average the points within a cell, because discretization would mess up the label orientation in contour plotting. a new GeneralPath which will be rendered identically to the input path, but contains a minimal number of points.
    
    Parameters:
    
    it - A path iterator with minute details that will be lost when rendering.
    
    result - A GeneralPath to put the result into.
    
    Returns:
    
    the number of "points" (LINE_TOs) in the result.
  - reducePath
```
public static int reducePath(java.awt.geom.PathIterator it,
                             java.awt.geom.GeneralPath result,
                             int res)
```
    Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points. We bin average the points within a cell, because discretization would mess up the label orientation in contour plotting. a new GeneralPath which will be rendered identically to the input path, but contains a minimal number of points.
    
    Parameters:
    
    it - A path iterator with minute details that will be lost when rendering.
    
    result - A GeneralPath to put the result into.
    
    res - limit the resolution in pixels
    
    Returns:
    
    the number of "points" (LINE_TOs) in the result.
  - pointsAlongCurve
```
public static double pointsAlongCurve(java.awt.geom.PathIterator it,
                                      double[] pathlen,
                                      java.awt.geom.Point2D.Double[] result,
                                      double[] orientation,
                                      boolean stopAtMoveTo)
```
    return the points along a curve. Used by ContourRenderer. The returned result is the remaining path length. Elements of pathlen that are beyond the total path length are not computed, and the result points will be null. Note that CUBICTO and QUADTO are not supported.
    
    Parameters:
    
    pathlen - monotonically increasing path lengths at which the position is to be located. May be null if only the total path length is desired.
    
    result - the resultant points will be put into this array. This array should have the same number of elements as pathlen
    
    orientation - the local orientation, in radians, of the point at will be put into this array. This array should have the same number of elements as pathlen
    
    it - PathIterator first point is used to start the length.
    
    stopAtMoveTo - treat SEG_MOVETO as the end of the path. The pathIterator will be left at this point.
    
    Returns:
    
    the remaining length. Note null may be used for pathlen, result, and orientation and this will simply return the total path length.
  - pointsAlongCurve
```
public static double pointsAlongCurve(java.awt.geom.PathIterator it,
                                      double[] pathlen,
                                      java.awt.geom.Point2D.Double[] result,
                                      double[] orientation,
                                      boolean stopAtMoveTo,
                                      java.util.Map<java.lang.String,java.lang.Object> props)
```
    return the points along a curve. Used by ContourRenderer. The returned result is the remaining path length. Elements of pathlen that are beyond the total path length are not computed, and the result points will be null. Note that CUBICTO and QUADTO are not supported.
    
    Parameters:
    
    pathlen - monotonically increasing path lengths at which the position is to be located. May be null if only the total path length is desired.
    
    result - the resultant points will be put into this array. This array should have the same number of elements as pathlen
    
    orientation - the local orientation, in radians, of the point at will be put into this array. This array should have the same number of elements as pathlen
    
    it - PathIterator first point is used to start the length.
    
    stopAtMoveTo - treat SEG_MOVETO as the end of the path. The pathIterator will be left at this point.
    
    props - empty map where properties are added.
    
    Returns:
    
    the remaining length. Note null may be used for pathlen, result, and orientation and this will simply return the total path length.
  - parseLayoutLength
```
public static double parseLayoutLength(java.lang.String s,
                                       double totalWidth,
                                       double em)
```
    parse strings like "14em+2pt" into a length in pixels.
    - "1em",0,8 -> 8
    - "50%",240,0 -> 120
    - "4pt",240,8 -> 4
    - "4px",240,8 -> 4
    - "1em+4pt",240,8 -> 12
    Parameters:
    
    s - the string specifying ems and pxs
    
    totalWidth - the total with for the normalized length.
    
    em - the size of an em in pixels.
    
    Returns:
    
    the length in pixels
    
    See Also:
    
    DasDevicePosition.parseLayoutStr(java.lang.String)
  - getATScaleTranslateString
```
public static java.lang.String getATScaleTranslateString(java.awt.geom.AffineTransform at)
```
    return a string representation of the affine transforms used in DasPlot for debugging.
    
    Parameters:
    
    at - the affine transform
    
    Returns:
    
    a string representation of the affine transforms used in DasPlot for debugging.
  - getSlopeIntercept
```
public static double[] getSlopeIntercept(double x0,
                                         double y0,
                                         double x1,
                                         double y1)
```
    calculates the slope and intercept of a line going through two points.
    
    Parameters:
    
    x0 - the first point x
    
    y0 - the first point y
    
    x1 - the second point x
    
    y1 - the second point y
    
    Returns:
    
    a double array with two elements [ slope, intercept ].
  - getRicePaperColor
```
public static java.awt.Color getRicePaperColor()
```
    return translucent white color for indicating the application is busy.
    
    Returns:
    
    translucent white color
  - getGaussianBlurFilter
```
public static java.awt.image.ConvolveOp getGaussianBlurFilter(int radius,
                                                              boolean horizontal)
```
    return a Gaussian filter for blurring images.
    
    Parameters:
    
    radius - the radius filter in pixels.
    
    horizontal - true if horizontal blur.
    
    Returns:
    
    the ConvolveOp
  - blurImage
```
public static java.awt.image.BufferedImage blurImage(java.awt.image.BufferedImage im,
                                                     int size)
```
    blur the image with a Guassian blur.
    
    Parameters:
    
    im -
    
    size - the size of the blur, roughly in pixels.
    
    Returns:
    
    image
  - describe
```
public static java.lang.String describe(java.awt.geom.GeneralPath path,
                                        boolean enumeratePoints)
```
    describe the path for debugging.
    
    Parameters:
    
    path - the Path to describe
    
    enumeratePoints - if true, print all the points as well.
    
    Returns:
    
    String description.
  - lineIntersection
```
public static java.awt.geom.Point2D lineIntersection(java.awt.geom.Line2D line1,
                                                     java.awt.geom.Line2D line2,
                                                     boolean noBoundsCheck)
```
    returns the point where the two line segments intersect, or null.
    
    Parameters:
    
    line1 -
    
    line2 -
    
    noBoundsCheck - if true, then do not check the segment bounds.
    
    Returns:
  - lineRectangleMask
```
public static java.awt.geom.Line2D lineRectangleMask(java.awt.geom.Point2D p0,
                                                     java.awt.geom.Point2D p1,
                                                     java.awt.geom.Rectangle2D r)
```
    return the line segment which is within the rectangle mask.
    
    Parameters:
    
    p0 - the first point
    
    p1 - the second point
    
    r - the rectangle
    
    Returns:
    
    null when they do not intersect, or the segment
  - lineRectangleIntersection
```
public static java.awt.geom.Point2D lineRectangleIntersection(java.awt.geom.Point2D p0,
                                                              java.awt.geom.Point2D p1,
                                                              java.awt.geom.Rectangle2D r0)
```
    return the intersection of a line segment and the edge of a rectangle, where one point is outside of the rectangle and one is inside.
    
    Parameters:
    
    p0 -
    
    p1 -
    
    r0 -
    
    Returns:
    
    null or the point along the rectangle
  - transformRange
```
public static double[] transformRange(DasAxis axis,
                                      DatumRange range)
```
    returns pixel range of the datum range, guarenteeing that the first element will be less than or equal to the second.
    
    Parameters:
    
    axis -
    
    range -
    
    Returns:
  - invTransformRange
```
public static DatumRange invTransformRange(DasAxis axis,
                                           double x1,
                                           double x2)
```
  - colorIcon
```
public static javax.swing.Icon colorIcon(java.awt.Color iconColor,
                                         int w,
                                         int h)
```
    return an icon block with the color and size.
    
    Parameters:
    
    iconColor - the color
    
    w - the width in pixels
    
    h - the height in pixels
    
    Returns:
    
    an icon.
  - colorImageIcon
```
public static javax.swing.ImageIcon colorImageIcon(java.awt.Color iconColor,
                                                   int w,
                                                   int h)
```
    return an ImageIcon with the color and size.
    
    Parameters:
    
    iconColor -
    
    w -
    
    h -
    
    Returns:
  - shrinkRectangle
```
public static java.awt.Rectangle shrinkRectangle(java.awt.Rectangle bounds,
                                                 int percent)
```
    return rectangle with same center that is percent/100 of the original width and height.
    
    Parameters:
    
    bounds - the original rectangle.
    
    percent - the percent to increase (110% is 10% bigger)
    
    Returns:
    
    a rectangle with same center that is percent/100. of the original width and height.
  - shortenLine
```
public static java.awt.geom.Line2D shortenLine(java.awt.geom.Line2D line,
                                               double l1,
                                               double l2)
```
    return line shorted by so many pixels at each end.
    
    Parameters:
    
    line - the line
    
    l1 - number of units to adjust the first point, towards the center
    
    l2 - number of units to adjust the second point, towards the center
    
    Returns:
    
    the new line
  - perpendicularLine
```
public static java.awt.geom.Line2D perpendicularLine(java.awt.geom.Line2D line,
                                                     java.awt.Point p,
                                                     double len)
```
    create a line perpendicular to the line segment line, which would go through p, and have length abs(len). If len is negative, then line.p1,line.p2,p is counter-clockwise. This is left unimplemented as it's a nice student project.
    
    Parameters:
    
    line - a line segment.
    
    p - a point, whose projection is necessarily within the line segment.
    
    len - the length of the resulting line, or
    
    Returns:
    
    line colinear with p and having length abs(len).
  - getFontConverter
```
public static Converter getFontConverter(DasCanvasComponent dcc,
                                         java.lang.String fallbackFont)
```
    converts forward from relative font spec to point size, used by the annotation and axis nodes.
    
    Parameters:
    
    dcc - the canvas component.
    
    fallbackFont - the font to use when a font is not available, like "sans-8"
    
    Returns:
    
    the converter that converts between strings like "1em" and the font.
  - calculateManualTicks
```
public static TickVDescriptor calculateManualTicks(java.lang.String lticks,
                                                   DatumRange dr,
                                                   boolean log)
```
    calculate a TickVDescriptor for the ticks. Example specifications:
    - +20 - every 20 units, whatever the data units are.
    - +20s - every 20 seconds
    - 0,20,40,60,100 - explicit locations.
    - +20s/4 - every 20 seconds, with four minor divisions.
    - +20s/5,10,15 - minor ticks repeat each 20s.
    - 100,200,300/50,150,250,350 - explicit list of major and minor ticks.
    - *10/+1 - log ticks with linear minor ticks.
    - none - no ticks
    Parameters:
    
    lticks - the specification
    
    dr - the range to cover
    
    log -
    
    Returns:
    
    null if the string can't be parsed, or the TickVDescriptor
    
    See Also:
    
    https://github.com/autoplot/dev/blob/master/demos/2021/20211130/demoCalculateManualTicks.jy, the maximum number of minor or major ticks calculated

Class GraphUtil

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FILL_TEXTURE_CROSSHASH

FILL_TEXTURE_HASH

FILL_TEXTURE_BACKHASH

FILL_TEXTURE_SOLID

FILL_TEXTURE_NONE

CONNECT_MODE_HISTOGRAM

CONNECT_MODE_SCATTER

CONNECT_MODE_SERIES

MAX_TICKS

Constructor Detail

GraphUtil

Method Detail

fillWithTexture

newGrannyTextRenderer

newGrannyTextEditor

newDasPlot

getPath

getPath

getSegNameFor

getPath

calculateAT

calculateAT

guessYAxis

guessXAxis

guessZAxis

guessRenderer

guessPlot

copyAxis

copyColorBar

copyPlot

visualize

clipPath

reducePath20140622

reducePath

reducePath

pointsAlongCurve

pointsAlongCurve

parseLayoutLength

getATScaleTranslateString

getSlopeIntercept

getRicePaperColor

getGaussianBlurFilter

blurImage

describe

lineIntersection

lineRectangleMask

lineRectangleIntersection

transformRange

invTransformRange

colorIcon

colorImageIcon

shrinkRectangle

shortenLine

perpendicularLine

getFontConverter

calculateManualTicks