Util (VisAD 2.0 API)

java.lang.Object
- visad.util.Util

```
public class Util
extends Object
```
A hodge-podge of general utility methods.

Constructor Summary

Constructors
Constructor and Description

Util()

Constructors
Constructor and Description
`Util()`

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`adjustComboBox(JComboBox combo)` Limit the given combo box to one line in height.
`static void`	`adjustTextField(JTextField field)` Limit the given text field to one line in height.
`static boolean`	`arraysEqual(Object[] o1, Object[] o2)` Tests whether two arrays are component-wise equal.
`static boolean`	`canDoHDF5()` Test whether HDF-5 native code is present in this JVM.
`static boolean`	`canDoImageJ()` Test whether ImageJ is present in this JVM.
`static boolean`	`canDoJAI()` Test whether Java Advanced Imaging is present in this JVM.
`static boolean`	`canDoJava3D()` Test whether Java3D is present in this JVM.
`static boolean`	`canDoJava3D(String version)` Check to see if the version of Java3D being used is compatible with the desired specification version.
`static boolean`	`canDoJPEG()` Test whether `javax.imageio` can write JPEGs.
`static boolean`	`canDoPython()` Test whether Jython is present in this JVM.
`static boolean`	`canDoQuickTime()` Test whether QuickTime for Java is present in this JVM.
`static void`	`captureDisplay(DisplayImpl display, String filename)` Capture a DisplayImpl into a JPEG file
`static void`	`captureDisplay(DisplayImpl display, String filename, boolean sync)` Capture a DisplayImpl into a JPEG file
`static void`	`centerWindow(Window window)` Center the given window on the screen.
`static void`	`centerWindow(Window parent, Window window)` Center the given window within the specified parent window.
`static double[][]`	`clone(double[][] input)` do a deep clone
`static float[][]`	`clone(float[][] input)` do a deep clone
`static Level`	`configureLogging(int verbosity)`
`static Level`	`configureLogging(int verbosity, String pkg)` Configure basic logging for the visad package.
`static ConstantMap[]`	`getColorMaps(Color color)` Create a ConstantMap array of colors for use with
`static String`	`getName(SceneGraphObject obj)` Gets the name of the given `SceneGraphObject`.
`static String`	`getStackTrace()` Utility method to return the stack trace
`static String`	`getTimestamp()` Return a string representation of the current date and time.
`static String`	`getVersionDate()` Return a string representation of VisAD's build date and time.
`static JFileChooser`	`getVisADFileChooser()` Return a JFileChooser that recognizes supported VisAD file types.
`static void`	`invoke(boolean wait, boolean printStackTraces, Runnable r)` Executes the given Runnable object with the Swing event handling thread.
`static void`	`invoke(boolean wait, Runnable r)` Executes the given Runnable object with the Swing event handling thread.
`static boolean`	`isApproximatelyEqual(double a, double b)` Determine whether two numbers are roughly the same.
`static boolean`	`isApproximatelyEqual(double a, double b, double epsilon)` Determine whether two numbers are roughly the same.
`static boolean`	`isApproximatelyEqual(float a, float b)` Determine whether two numbers are roughly the same.
`static boolean`	`isApproximatelyEqual(float a, float b, float epsilon)` Determine whether two numbers are roughly the same.
`static void`	`printArray(String prefix, double[] array)` Print out the values in a double array.
`static void`	`printArray(String prefix, Object[] array)` Create a string representation of the given array
`static void`	`printJ3DProperties(Canvas3D canvas)` Print Java3D global and Canvas3D properties to `System.err`.
`static void`	`printJ3DProperties(PrintStream str, Canvas3D canvas)` Print Java3D properties.
`static void`	`printSceneGraph(Node node)`
`static void`	`setName(SceneGraphObject obj, String name)` Sets the name of the given `SceneGraphObject`.
`static int`	`unsignedByteToInt(byte b)` Converts an (unsigned) byte to an unsigned int.
`static long`	`unsignedByteToLong(byte b)` Converts an (unsigned) byte to an unsigned long.
`static int`	`unsignedShortToInt(short s)` Converts an (unsigned) byte to an unsigned int.

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

- Constructor Detail
  - Util
```
public Util()
```
- Method Detail
  - isApproximatelyEqual
```
public static boolean isApproximatelyEqual(float a,
                           float b,
                           float epsilon)
```
    Determine whether two numbers are roughly the same.
    
    Parameters:
    a - First number
    b - Second number
    epsilon - Absolute amount by which they can differ.
    
    Returns:
    true if they're approximately equal.
  - isApproximatelyEqual
```
public static boolean isApproximatelyEqual(float a,
                           float b)
```
    Determine whether two numbers are roughly the same.
    
    Parameters:
    a - First number
    b - Second number
    
    Returns:
    true if they're approximately equal.
  - isApproximatelyEqual
```
public static boolean isApproximatelyEqual(double a,
                           double b,
                           double epsilon)
```
    Determine whether two numbers are roughly the same.
    
    Parameters:
    a - First number
    b - Second number
    epsilon - Absolute amount by which they can differ.
    
    Returns:
    true if they're approximately equal.
  - isApproximatelyEqual
```
public static boolean isApproximatelyEqual(double a,
                           double b)
```
    Determine whether two numbers are roughly the same.
    
    Parameters:
    a - First number
    b - Second number
    
    Returns:
    true if they're approximately equal.
  - getVersionDate
```
public static String getVersionDate()
```
    Return a string representation of VisAD's build date and time.
    
    Returns:
  - printJ3DProperties
```
public static void printJ3DProperties(PrintStream str,
                      Canvas3D canvas)
```
    Print Java3D properties.
    
    Parameters:
    str - Where to print properties.
    canvas - The Canvas3D to get properties from. If null Canvas3D properties are skipped.
    See Also:
    #printJ3DProperties(Canvas3D)}
  - printJ3DProperties
```
public static void printJ3DProperties(Canvas3D canvas)
```
    Print Java3D global and Canvas3D properties to System.err.
    
    Parameters:
    canvas - The Canvas3D to get properties from. If null Canvas3D properties are skipped.
    See Also:
    javax.media.j3d.VirtualUniverse#getProperties()}, javax.media.j3d.Canvas3D#queryProperties()}
  - printSceneGraph
```
public static void printSceneGraph(Node node)
```
    Parameters:
    node -
  - getName
```
public static String getName(SceneGraphObject obj)
```
    Gets the name of the given SceneGraphObject. This method exists to avoid a compile-time dependency on Java3D 1.4+.
  - setName
```
public static void setName(SceneGraphObject obj,
           String name)
```
    Sets the name of the given SceneGraphObject. This method exists to avoid a compile-time dependency on Java3D 1.4+.
  - getTimestamp
```
public static String getTimestamp()
```
    Return a string representation of the current date and time.
    
    Returns:
  - getVisADFileChooser
```
public static JFileChooser getVisADFileChooser()
```
    Return a JFileChooser that recognizes supported VisAD file types.
    
    Returns:
  - adjustTextField
```
public static void adjustTextField(JTextField field)
```
    Limit the given text field to one line in height.
    
    Parameters:
    field -
  - adjustComboBox
```
public static void adjustComboBox(JComboBox combo)
```
    Limit the given combo box to one line in height.
    
    Parameters:
    combo -
  - centerWindow
```
public static void centerWindow(Window window)
```
    Center the given window on the screen.
    
    Parameters:
    window -
  - centerWindow
```
public static void centerWindow(Window parent,
                Window window)
```
    Center the given window within the specified parent window.
    
    Parameters:
    parent -
    window -
  - canDoHDF5
```
public static boolean canDoHDF5()
```
    Test whether HDF-5 native code is present in this JVM.
    
    Returns:
    true if found, otherwise false
  - canDoImageJ
```
public static boolean canDoImageJ()
```
    Test whether ImageJ is present in this JVM.
    
    Returns:
    true if found, otherwise false
  - canDoJPEG
```
public static boolean canDoJPEG()
```
    Test whether javax.imageio can write JPEGs.
    
    Returns:
    true if found, otherwise false
  - canDoJAI
```
public static boolean canDoJAI()
```
    Test whether Java Advanced Imaging is present in this JVM.
    
    Returns:
    true if found, otherwise false
  - canDoPython
```
public static boolean canDoPython()
```
    Test whether Jython is present in this JVM.
    
    Returns:
    true if found, otherwise false
  - canDoQuickTime
```
public static boolean canDoQuickTime()
```
    Test whether QuickTime for Java is present in this JVM.
    
    Returns:
    true if found, otherwise false
  - canDoJava3D
```
public static boolean canDoJava3D()
```
    Test whether Java3D is present in this JVM.
    
    Returns:
    true if found, otherwise false
  - canDoJava3D
```
public static boolean canDoJava3D(String version)
```
    Check to see if the version of Java3D being used is compatible with the desired specification version.
    
    Parameters:
    version - version to check. Needs to conform to the dotted format of specification version numbers (e.g., 1.2)
    
    Returns:
    true if the Java3D version being used is greater than or equal to the desired version number
  - captureDisplay
```
public static void captureDisplay(DisplayImpl display,
                  String filename)
```
    Capture a DisplayImpl into a JPEG file
    
    Parameters:
    display - the DisplayImpl to capture
    filename - the name of the file to write into
  - captureDisplay
```
public static void captureDisplay(DisplayImpl display,
                  String filename,
                  boolean sync)
```
    Capture a DisplayImpl into a JPEG file
    
    Parameters:
    display - the DisplayImpl to capture
    filename - the name of the file to write into
    sync - ensure the display is "done" if true
  - arraysEqual
```
public static boolean arraysEqual(Object[] o1,
                  Object[] o2)
```
    Tests whether two arrays are component-wise equal.
    
    Parameters:
    o1 -
    o2 -
    
    Returns:
  - printArray
```
public static void printArray(String prefix,
              Object[] array)
```
    Create a string representation of the given array
    
    Parameters:
    prefix -
    array - array to print
  - printArray
```
public static void printArray(String prefix,
              double[] array)
```
    Print out the values in a double array.
    
    Parameters:
    prefix - prefix string
    array - array to print
  - invoke
```
public static void invoke(boolean wait,
          Runnable r)
```
    Executes the given Runnable object with the Swing event handling thread.
    
    Parameters:
    wait - true if method should block until Runnable code finishes execution.
    r - Runnable object to execute using the event handling thread.
  - invoke
```
public static void invoke(boolean wait,
          boolean printStackTraces,
          Runnable r)
```
    Executes the given Runnable object with the Swing event handling thread.
    
    Parameters:
    wait - true if method should block until Runnable code finishes execution.
    printStackTraces - true if the stack trace for any exception should be printed.
    r - Runnable object to execute using the event handling thread.
  - getColorMaps
```
public static ConstantMap[] getColorMaps(Color color)
                                  throws VisADException
```
    Create a ConstantMap array of colors for use with
    
    Parameters:
    color - color to encode
    
    Returns:
    an array containing either 3 colors or, if the color parameter included an alpha component, a 4 element array with 3 colors and an @{link Display.Alpha alpha} component.
    
    Throws:
    
    VisADException
  - configureLogging
```
public static Level configureLogging(int verbosity,
                     String pkg)
```
    Configure basic logging for the visad package. In a production envirionment the prefered way to configure logging is using the logging.properties file. This is intended only as a convienience method for configuring console logging for the purposes of testing.
    
    Parameters:
    verbosity - 0 is Level.WARNING and progresses to a maximum of Level.ALL.
    pkg - Name of the java package to configure logging for.
    
    Returns:
    The Level logging was set to.
  - configureLogging
```
public static Level configureLogging(int verbosity)
```
    Parameters:
    verbosity -
    
    Returns:
    See Also:
    #configureLogging(int, java.lang.String)}
  - getStackTrace
```
public static String getStackTrace()
```
    Utility method to return the stack trace
    
    Returns:
    The stack trace
  - clone
```
public static float[][] clone(float[][] input)
```
    do a deep clone
    
    Parameters:
    input - the array
    
    Returns:
    cloned array
  - clone
```
public static double[][] clone(double[][] input)
```
    do a deep clone
    
    Parameters:
    input - the array
    
    Returns:
    cloned array
  - unsignedShortToInt
```
public static int unsignedShortToInt(short s)
```
    Converts an (unsigned) byte to an unsigned int. Since Java doesn't have an unsigned byte type, this requires some foolery. This solution based on information and code from http://www.rgagnon.com/javadetails/java-0026.html
    
    Parameters:
    s - The unsigned short to convert
    
    Returns:
    the unsigned int equivalent
  - unsignedByteToInt
```
public static int unsignedByteToInt(byte b)
```
    Converts an (unsigned) byte to an unsigned int. Since Java doesn't have an unsigned byte type, this requires some foolery. This solution based on information and code from http://www.rgagnon.com/javadetails/java-0026.html
    
    Parameters:
    b - The unsigned byte to convert
    
    Returns:
    the unsigned int equivalent
  - unsignedByteToLong
```
public static long unsignedByteToLong(byte b)
```
    Converts an (unsigned) byte to an unsigned long. Since Java doesn't have an unsigned byte type, this requires some foolery. This solution based on information and code from http://www.rgagnon.com/javadetails/java-0026.html
    
    Parameters:
    b - The unsigned byte to convert
    
    Returns:
    the unsigned long equivalent

Class Util

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Util

Method Detail

isApproximatelyEqual

isApproximatelyEqual

isApproximatelyEqual

isApproximatelyEqual

getVersionDate

printJ3DProperties

printJ3DProperties

printSceneGraph

getName

setName

getTimestamp

getVisADFileChooser

adjustTextField

adjustComboBox

centerWindow

centerWindow

canDoHDF5

canDoImageJ

canDoJPEG

canDoJAI

canDoPython

canDoQuickTime

canDoJava3D

canDoJava3D

captureDisplay

captureDisplay

arraysEqual

printArray

printArray

invoke

invoke

getColorMaps

configureLogging

configureLogging

getStackTrace

clone

clone

unsignedShortToInt

unsignedByteToInt

unsignedByteToLong