Utils (Fiji Javadocs 0-SNAPSHOT API)

java.lang.Object
- ini.trakem2.utils.Utils

All Implemented Interfaces:

ij.plugin.PlugIn
```
public class Utils
extends Object
implements ij.plugin.PlugIn
```
Utils class: stores generic widely used methods. In particular, those for logging text messages (for debugging) and also some math and memory utilities.

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`debug`
`static boolean`	`debug_clip`
`static boolean`	`debug_event`
`static boolean`	`debug_mouse`
`static boolean`	`debug_sql`
`static boolean`	`debug_thing`
`static double`	`FL_ERROR` The error to use in floating-point or double floating point literal comparisons.
`static boolean`	`java3d`
`static String`	`last_dir` The path of the directory from which images have been recently loaded.
`static String`	`last_file` The path of the last opened file.
`static String`	`version`

Constructor Summary

Constructors
Constructor and Description

Utils()

Constructors
Constructor and Description
`Utils()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addEnablerListener(Checkbox master, Component[] enable, Component[] disable)` A helper for GenericDialog checkboxes to control other the enabled state of other GUI elements in the same dialog.
`static void`	`addLayerChoice(String label, Layer selected, GenericDialog gd)`
`static void`	`addLayerRangeChoices(Layer selected, GenericDialog gd)`
`static void`	`addLayerRangeChoices(Layer first, Layer last, GenericDialog gd)`
`static boolean`	`addPlugIns(JPopupMenu popup, String menu, Project project, Callable<Displayable> active)` Returns false if none to add.
`static JMenu`	`addPlugIns(String menu, Project project, Callable<Displayable> active)` Returns null if none to add.
`static void`	`addRGBColorSliders(GenericDialog gd, Color color)`
`static String`	`asHexRGBColor(Color color)`
`static void`	`asHexRGBColor(StringBuilder sb, Color color)`
`static List<Long>`	`asList(long[] ids)`
`static List<Long>`	`asList(long[] ids, int first, int length)`
`static String`	`caller(Object called)` Returns a String representation of the class of the object one step before in the stack trace.
`static <A,B> ArrayList<B>`	`castCollection(Collection<A> classAs, Class<B> type, boolean doThrow)`
`static boolean`	`check(String msg)`
`static boolean`	`checkYN(String msg)`
`static File`	`chooseFile(String name, String extension)`
`static File`	`chooseFile(String default_dir, String name, String extension)` Select a file from the file system, for saving purposes.
`static String`	`cleanString(String s)` Converts sequences of spaces into single space, and trims the ends.
`static ij.process.ImageProcessor`	`convertTo(ij.process.ImageProcessor ip, int type, boolean scaling)` Converts the ImageProcessor to an ImageProcessor of the given type, or the same if of equal type.
`static BufferedImage`	`convertToBufferedImage(ij.process.ByteProcessor bp)`
`static double[]`	`copy(double[] a, int new_length)` Will make a new double[] array, then fit in it as many points from the given array as possible according to the desired new length.
`static double[]`	`copy(double[] a, int first, int new_length)`
`static long[]`	`copy(long[] a, int new_length)`
`static long[]`	`copy(long[] a, int first, int new_length)`
`static ij.process.ImageProcessor`	`createProcessor(int type, int width, int height)`
`static ij.measure.ResultsTable`	`createResultsTable(String title, String[] columns)` Creates a new ResultsTable with the given window title and column titles, and 2 decimals of precision, or if one exists for the given window title, returns it.
`static InputStream`	`createStream(String path_or_url)`
`static String`	`cutNumber(double d, int n_decimals)`
`static String`	`cutNumber(double d, int n_decimals, boolean remove_trailing_zeros)` remove_trailing_zeros will leave at least one zero after the comma if appropriate.
`static String`	`d2s(double d, int n_decimals)`
`static void`	`debug(String msg)`
`static void`	`debugDialog()`
`static void`	`debugMouse(String msg)`
`static void`	`destroy(ControlWindow master)` Destroy house keeping threads.
`static void`	`drawPoint(Graphics g, int x, int y)`
`static boolean`	`ensure(File f)` Ensure the file can be written to.
`static boolean`	`ensure(String filepath)`
`static boolean`	`equalContent(Collection<?> a, Collection<?> b)` If both are null will throw an error.
`static boolean`	`equalContent(Map<?,?> a, Map<?,?> b)` If both are null will throw an error.
`static ij.process.FloatProcessor`	`fastConvertToFloat(ij.process.ByteProcessor ip)` A method that circumvents the findMinAndMax when creating a float processor from an existing processor.
`static ij.process.FloatProcessor`	`fastConvertToFloat(ij.process.ImageProcessor ip)`
`static ij.process.FloatProcessor`	`fastConvertToFloat(ij.process.ImageProcessor ip, int type)` A method that circumvents the findMinAndMax when creating a float processor from an existing processor.
`static ij.process.FloatProcessor`	`fastConvertToFloat(ij.process.ShortProcessor ip)` A method that circumvents the findMinAndMax when creating a float processor from an existing processor.
`static ij.ImagePlus[]`	`findAllOpenImages()` Scan the WindowManager for all open images, including stacks.
`static ij.ImagePlus[]`	`findOpenImages()` Scan the WindowManager for non-stack images
`static ij.ImagePlus[]`	`findOpenStacks()` Scan the WindowManager for open stacks.
`static IndexColorModel`	`fireLUT()` Returns a byte[3][256] containing the colors of the fire LUT.
`static String`	`fixDir(String path)` Convert a D:\\this\that\there to D://this/that/there/ Notice it adds an ending backslash.
`static int[]`	`get4Ints(int hex)`
`static String`	`getCharacter(int i)` 1 A, 2 B, 3 C --- 26 - z, 27 AA, 28 AB, 29 AC --- 26*27 AAA
`static int`	`getControlModifier()` The CTRL key functionality is passed over to the COMMAND key (aka META key) in a MacOSX.
`static double`	`getCos(double x1, double y1, double x2, double y2)` The cosinus between two vectors (in polar coordinates), by means of the dot product.
`static Dimension`	`getDimensions(String text, Font font)` Get the width and height of single-line text.
`static Object`	`getField(Object ob, Class<?> c, String field_name)` Get by reflection a private or protected field in the given object.
`static Object`	`getField(Object ob, String field_name)`
`static String[]`	`getHexRGBColor(Color color)`
`static PrintStream`	`getLogStream()`
`static Color`	`getRGBColorFromHex(String hex)`
`static int`	`indexOf(Object needle, Object[] haystack)`
`static void`	`invokeLater(Runnable r)` Invoke in the context of the event dispatch thread.
`static boolean`	`isControlDown(InputEvent e)` The CTRL key functionality is passed over to the COMMAND key (aka META key) in a MacOSX.
`static boolean`	`isPopupTrigger(MouseEvent me)` OS-agnostic diagnosis of whether the click was for the contextual popup menu.
`static boolean`	`isTrakEM2Subfile(File f)` Returns true if the file cannonical path contains "/trakem2." (adjusted for Windows as well).
`static boolean`	`isTrakEM2Subpath(String path)` Returns true if the path contains "/trakem2." (adjusted for Windows as well).
`static boolean`	`isValidIdentifier(String s)`
`static Bureaucrat`	`launchTPlugIn(KeyEvent ke, String menu, Project project, Displayable active)` Returns null if no plugin was launched.
`static void`	`log(Object ob)`
`static void`	`log(String msg)` Intended for the user to see.
`static void`	`log(String msg, Object ob)` Pretty-print the object, for example arrays as [0, 1, 2].
`static void`	`log2(Object... ob)`
`static void`	`log2(Object ob)` Pretty-print the object, for example arrays as [0, 1, 2].
`static void`	`log2(String msg)` Intended for developers: prints to terminal.
`static void`	`log2(String msg, Object ob)` Pretty-print the object, for example arrays as [0, 1, 2].
`static void`	`log2(String msg, Object ob1, Object... ob)`
`static void`	`logAll(String msg)` Print in all printable places: log window, System.out.println, and status bar.
`static void`	`logMany2(Object... ob)`
`static void`	`logStamped(String msg)` Intended for the user to see; time-stamps every logging line.
`static int`	`luminance(Color c)` 0.3 * R + 0.6 * G + 0.1 * B
`static String`	`makeValidIdentifier(String s)` user=> (def pat #"\b[a-zA-Z]+[\w]*\b") #'user/pat user=>(re-seq pat "abc def 1a334") ("abc" "def") user=> (re-seq pat "abc def a334") ("abc" "def" "a334")
`static boolean`	`matches(String pattern, String s)`
`static Color`	`mix(Color c1, Color c2)` Mix colors visually: red + green = yellow, etc.
`static ThreadPoolExecutor`	`newFixedThreadPool(int n_proc)` Creates a new fixed thread pool whose threads are in the same ThreadGroup as the Thread that calls this method.
`static ThreadPoolExecutor`	`newFixedThreadPool(int n_proc, String namePrefix)`
`static ThreadPoolExecutor`	`newFixedThreadPool(int n_proc, String namePrefix, boolean use_caching_thread)`
`static ThreadPoolExecutor`	`newFixedThreadPool(String namePrefix)` Creates a new fixed thread pool with as many threads as CPUs, and whose threads are in the same ThreadGroup as the Thread that calls this method.
`static String`	`now()` Returns the time as HH:MM:SS
`static String`	`openTextFile(String path)`
`static char[]`	`openTextFileChars(String path)`
`static String[]`	`openTextFileLines(String path)` Returns the file found at path as an array of lines, or null if not found.
`static void`	`paint(Pipe pipe, Map<Layer,ij.process.ImageProcessor> slices, int value, float scale)` Paints an approximation of the pipe into the set of slices.
`static void`	`printCaller(Object called_object)` Find out which method from which class called the method where the printCaller is used; for debugging purposes.
`static void`	`printCaller(Object called_object, int lines)`
`static String`	`removeExtension(String path)`
`static boolean`	`removeFile(File f)` Remove the file, or if it's a directory, recursively go down subdirs and remove all contents, but will stop on encountering a non-hidden file that is not an empty dir.
`static boolean`	`removePrefixedFiles(File parent, String prefix, ArrayList<String> removed_paths)` Returns true if all files and their subdirectories, recursively, under parent folder have been removed.
`static void`	`restoreMenuBar()` Restore ImageJ's MenuBar
`static void`	`revalidateComponent(Component c)` Like calling pack() on a Frame but on a Component.
`static void`	`reverse(double[] a)` Reverse in place an array of doubles.
`static void`	`reverse(long[] a)` Reverse in place an array of longs.
`void`	`run(String arg)`
`static boolean`	`safeCopy(String source, String target)`
`static boolean`	`saveToFile(File f, String contents)`
`static boolean`	`saveToFile(String name, String extension, String contents)`
`static String[]`	`selectFile(String title_msg)` Returns null or the selected directory and file.
`static void`	`setDebug(boolean debug)`
`static void`	`setDebugMouse(boolean debug_mouse)`
`static void`	`setDebugSQL(boolean debug_sql)`
`static void`	`setEnabled(Container root, boolean b)` Recursively enable/disable all components of the @param root Container.
`static void`	`setField(Object ob, Class<?> c, String field_name, Object value)`
`static void`	`setLogStream(PrintStream ps)`
`static void`	`setup(ControlWindow master)` Initialize house keeping threads.
`static void`	`showAllTables(HashMap<Class<?>,ij.measure.ResultsTable> ht)`
`static void`	`showMessage(String msg)`
`static void`	`showMessage(String title, String msg)`
`static void`	`showMessageT(String msg)` Runs the showMessage in a separate Thread.
`static void`	`showProgress(double p)`
`static void`	`showStatus(String msg)`
`static void`	`showStatus(String msg, boolean focus)`
`static void`	`sleep(long miliseconds)`
`static double[]`	`toDouble(int[] a, int len)`
`static int[]`	`toInt(double[] a, int len)`
`static String`	`toString(Object ob)` Print an object; if it's an array, print each element, recursively, as [0, 1, 2] or [[0, 1, 2], [3, 4, 5]], etc, same for Iterable and Map objects.
`static String`	`trim(CharSequence sb)`
`static void`	`updateComponent(Component c)` Repaint the given Component on the swing repaint thread (aka "SwingUtilities.invokeLater").
`static void`	`wait(Collection<Future<?>> fus)`
`static void`	`waitIfAlive(Collection<Future<?>> fus, boolean throwException)`
`static boolean`	`wrongImageJVersion()`
`static String`	`zeroPad(int i, int n_digits)` Zero-pad a number, so that '1' becomes '001' if n_digits is 3.

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

Field Detail

version
```
public static String version
```

debug
```
public static boolean debug
```

debug_mouse
```
public static boolean debug_mouse
```

debug_sql
```
public static boolean debug_sql
```

debug_event
```
public static boolean debug_event
```

debug_clip
```
public static boolean debug_clip
```

debug_thing
```
public static boolean debug_thing
```

FL_ERROR
```
public static final double FL_ERROR
```
The error to use in floating-point or double floating point literal comparisons.

See Also:

Constant Field Values

last_dir
```
public static String last_dir
```
The path of the directory from which images have been recently loaded.

last_file
```
public static String last_file
```
The path of the last opened file.

java3d
```
public static final boolean java3d
```

Constructor Detail
- Utils
```
public Utils()
```

Method Detail

debug
```
public static void debug(String msg)
```

debugMouse

public static void debugMouse(String msg)

setup

public static final void setup(ControlWindow master)

Initialize house keeping threads.

destroy

public static final void destroy(ControlWindow master)

Destroy house keeping threads.

setLogStream

public static void setLogStream(PrintStream ps)

getLogStream

public static PrintStream getLogStream()

log

public static final void log(String msg)

Intended for the user to see.

logStamped
```
public static final void logStamped(String msg)
```
Intended for the user to see; time-stamps every logging line.

logAll
```
public static final void logAll(String msg)
```
Print in all printable places: log window, System.out.println, and status bar.

log2
```
public static final void log2(String msg)
```
Intended for developers: prints to terminal.

log2
```
public static final void log2(Object ob)
```
Pretty-print the object, for example arrays as [0, 1, 2].

log2

public static final void log2(String msg,
                              Object ob)

Pretty-print the object, for example arrays as [0, 1, 2].

log2

public static final void log2(String msg,
                              Object ob1,
                              Object... ob)

log

public static final void log(Object ob)

log

public static final void log(String msg,
                             Object ob)

Pretty-print the object, for example arrays as [0, 1, 2].

log2

public static final void log2(Object... ob)

logMany2

public static final void logMany2(Object... ob)

toString
```
public static final String toString(Object ob)
```
Print an object; if it's an array, print each element, recursively, as [0, 1, 2] or [[0, 1, 2], [3, 4, 5]], etc, same for Iterable and Map objects.

setDebug

public static void setDebug(boolean debug)

setDebugMouse

public static void setDebugMouse(boolean debug_mouse)

setDebugSQL

public static void setDebugSQL(boolean debug_sql)

printCaller
```
public static final void printCaller(Object called_object)
```
Find out which method from which class called the method where the printCaller is used; for debugging purposes.

printCaller

public static final void printCaller(Object called_object,
                                     int lines)

caller
```
public static final String caller(Object called)
```
Returns a String representation of the class of the object one step before in the stack trace.

restoreMenuBar

public static final void restoreMenuBar()

Restore ImageJ's MenuBar

showMessage

public static final void showMessage(String msg)

showMessage

public static final void showMessage(String title,
                                     String msg)

showMessageT

public static final void showMessageT(String msg)

Runs the showMessage in a separate Thread.

showStatus

public static final void showStatus(String msg,
                                    boolean focus)

showStatus

public static final void showStatus(String msg)

showProgress

public static final void showProgress(double p)

debugDialog
```
public static void debugDialog()
```

findOpenStacks
```
public static ij.ImagePlus[] findOpenStacks()
```
Scan the WindowManager for open stacks.

findOpenImages
```
public static ij.ImagePlus[] findOpenImages()
```
Scan the WindowManager for non-stack images

findAllOpenImages
```
public static ij.ImagePlus[] findAllOpenImages()
```
Scan the WindowManager for all open images, including stacks.

cutNumber

public static String cutNumber(double d,
                               int n_decimals)

cutNumber

public static final String cutNumber(double d,
                                     int n_decimals,
                                     boolean remove_trailing_zeros)

remove_trailing_zeros will leave at least one zero after the comma if appropriate.

zeroPad

public static final String zeroPad(int i,
                                   int n_digits)

Zero-pad a number, so that '1' becomes '001' if n_digits is 3.

check

public static final boolean check(String msg)

checkYN

public static final boolean checkYN(String msg)

d2s

public static final String d2s(double d,
                               int n_decimals)

getHexRGBColor

public static final String[] getHexRGBColor(Color color)

asHexRGBColor

public static final String asHexRGBColor(Color color)

asHexRGBColor

public static final void asHexRGBColor(StringBuilder sb,
                                       Color color)

getRGBColorFromHex

public static final Color getRGBColorFromHex(String hex)

get4Ints

public static final int[] get4Ints(int hex)

run
```
public void run(String arg)
```
Specified by:

run in interface ij.plugin.PlugIn

chooseFile

public static final File chooseFile(String name,
                                    String extension)

chooseFile

public static final File chooseFile(String default_dir,
                                    String name,
                                    String extension)

Select a file from the file system, for saving purposes. Prompts for overwritting if the file exists, unless the ControlWindow.isGUIEnabled() returns false (i.e. there is no GUI).

selectFile

public static final String[] selectFile(String title_msg)

Returns null or the selected directory and file.

saveToFile

public static final boolean saveToFile(File f,
                                       String contents)

saveToFile

public static final boolean saveToFile(String name,
                                       String extension,
                                       String contents)

cleanString
```
public static final String cleanString(String s)
```
Converts sequences of spaces into single space, and trims the ends.

openTextFile

public static final String openTextFile(String path)

openTextFileLines
```
public static final String[] openTextFileLines(String path)
```
Returns the file found at path as an array of lines, or null if not found.

openTextFileChars

public static final char[] openTextFileChars(String path)

getCos

public static final double getCos(double x1,
                                  double y1,
                                  double x2,
                                  double y2)

The cosinus between two vectors (in polar coordinates), by means of the dot product.

removeExtension

public static final String removeExtension(String path)

addEnablerListener

public static final void addEnablerListener(Checkbox master,
                                            Component[] enable,
                                            Component[] disable)

A helper for GenericDialog checkboxes to control other the enabled state of other GUI elements in the same dialog.

wrongImageJVersion

public static final boolean wrongImageJVersion()

addLayerRangeChoices

public static final void addLayerRangeChoices(Layer selected,
                                              GenericDialog gd)

addLayerRangeChoices

public static final void addLayerRangeChoices(Layer first,
                                              Layer last,
                                              GenericDialog gd)

addLayerChoice

public static final void addLayerChoice(String label,
                                        Layer selected,
                                        GenericDialog gd)

addRGBColorSliders

public static final void addRGBColorSliders(GenericDialog gd,
                                            Color color)

convertTo

public static final ij.process.ImageProcessor convertTo(ij.process.ImageProcessor ip,
                                                        int type,
                                                        boolean scaling)

Converts the ImageProcessor to an ImageProcessor of the given type, or the same if of equal type.

copy
```
public static final double[] copy(double[] a,
                                  int new_length)
```
Will make a new double[] array, then fit in it as many points from the given array as possible according to the desired new length. If the new length is shorter that a.length, it will shrink and crop from the end; if larger, the extra spaces will be set with zeros.

copy

public static final long[] copy(long[] a,
                                int new_length)

copy

public static final double[] copy(double[] a,
                                  int first,
                                  int new_length)

copy

public static final long[] copy(long[] a,
                                int first,
                                int new_length)

reverse

public static final void reverse(double[] a)

Reverse in place an array of doubles.

reverse

public static final void reverse(long[] a)

Reverse in place an array of longs.

toDouble

public static final double[] toDouble(int[] a,
                                      int len)

toInt

public static final int[] toInt(double[] a,
                                int len)

isPopupTrigger
```
public static final boolean isPopupTrigger(MouseEvent me)
```
OS-agnostic diagnosis of whether the click was for the contextual popup menu.

updateComponent
```
public static final void updateComponent(Component c)
```
Repaint the given Component on the swing repaint thread (aka "SwingUtilities.invokeLater").

revalidateComponent
```
public static final void revalidateComponent(Component c)
```
Like calling pack() on a Frame but on a Component.

now
```
public static final String now()
```
Returns the time as HH:MM:SS

sleep

public static final void sleep(long miliseconds)

mix

public static final Color mix(Color c1,
                              Color c2)

Mix colors visually: red + green = yellow, etc.

getCharacter
```
public static final String getCharacter(int i)
```
1 A, 2 B, 3 C --- 26 - z, 27 AA, 28 AB, 29 AC --- 26*27 AAA

getField

public static final Object getField(Object ob,
                                    String field_name)

getField

public static final Object getField(Object ob,
                                    Class<?> c,
                                    String field_name)

Get by reflection a private or protected field in the given object.

setField

public static final void setField(Object ob,
                                  Class<?> c,
                                  String field_name,
                                  Object value)

fastConvertToFloat
```
public static final ij.process.FloatProcessor fastConvertToFloat(ij.process.ByteProcessor ip)
```
A method that circumvents the findMinAndMax when creating a float processor from an existing processor. Ignores color calibrations and does no scaling at all.

fastConvertToFloat
```
public static final ij.process.FloatProcessor fastConvertToFloat(ij.process.ShortProcessor ip)
```
A method that circumvents the findMinAndMax when creating a float processor from an existing processor. Ignores color calibrations and does no scaling at all.

fastConvertToFloat
```
public static final ij.process.FloatProcessor fastConvertToFloat(ij.process.ImageProcessor ip,
                                                                 int type)
```
A method that circumvents the findMinAndMax when creating a float processor from an existing processor. Ignores color calibrations and does no scaling at all.

fastConvertToFloat

public static final ij.process.FloatProcessor fastConvertToFloat(ij.process.ImageProcessor ip)

createResultsTable

public static final ij.measure.ResultsTable createResultsTable(String title,
                                                               String[] columns)

Creates a new ResultsTable with the given window title and column titles, and 2 decimals of precision, or if one exists for the given window title, returns it.

createProcessor

public static final ij.process.ImageProcessor createProcessor(int type,
                                                              int width,
                                                              int height)

paint

public static void paint(Pipe pipe,
                         Map<Layer,ij.process.ImageProcessor> slices,
                         int value,
                         float scale)

Paints an approximation of the pipe into the set of slices.

matches

public static final boolean matches(String pattern,
                                    String s)

isValidIdentifier

public static final boolean isValidIdentifier(String s)

makeValidIdentifier

public static final String makeValidIdentifier(String s)

 user=> (def pat #"\b[a-zA-Z]+[\w]*\b")
 #'user/pat
 user=>(re-seq pat "abc def 1a334")
 ("abc" "def")
 user=> (re-seq pat "abc def a334")
 ("abc" "def" "a334")

Then concatenate all good words with underscores.

Returns:: null when nothing valid is found in 's'.

indexOf

public static final int indexOf(Object needle,
                                Object[] haystack)

removeFile
```
public static final boolean removeFile(File f)
```
Remove the file, or if it's a directory, recursively go down subdirs and remove all contents, but will stop on encountering a non-hidden file that is not an empty dir.

isTrakEM2Subfile
```
public static boolean isTrakEM2Subfile(File f)
                                throws Exception
```
Returns true if the file cannonical path contains "/trakem2." (adjusted for Windows as well).

Throws:

Exception

isTrakEM2Subpath
```
public static boolean isTrakEM2Subpath(String path)
```
Returns true if the path contains "/trakem2." (adjusted for Windows as well).

removePrefixedFiles
```
public static final boolean removePrefixedFiles(File parent,
                                                String prefix,
                                                ArrayList<String> removed_paths)
```
Returns true if all files and their subdirectories, recursively, under parent folder have been removed. For safety reasons, this function will return false immediately if the parent file path does not include a lowercase "trakem2." in it. If removed_paths is not null, all removed full paths are added to it. Returns false if some files could not be removed.

getControlModifier
```
public static final int getControlModifier()
```
The CTRL key functionality is passed over to the COMMAND key (aka META key) in a MacOSX.

isControlDown
```
public static final boolean isControlDown(InputEvent e)
```
The CTRL key functionality is passed over to the COMMAND key (aka META key) in a MacOSX.

drawPoint

public static final void drawPoint(Graphics g,
                                   int x,
                                   int y)

trim

public static final String trim(CharSequence sb)

wait

public static final void wait(Collection<Future<?>> fus)

waitIfAlive

public static final void waitIfAlive(Collection<Future<?>> fus,
                                     boolean throwException)

fixDir
```
public static final String fixDir(String path)
```
Convert a D:\\this\that\there to D://this/that/there/ Notice it adds an ending backslash.

newFixedThreadPool
```
public static final ThreadPoolExecutor newFixedThreadPool(int n_proc)
```
Creates a new fixed thread pool whose threads are in the same ThreadGroup as the Thread that calls this method. This allows for the threads to be interrupted when the caller thread's group is interrupted.

newFixedThreadPool
```
public static final ThreadPoolExecutor newFixedThreadPool(String namePrefix)
```
Creates a new fixed thread pool with as many threads as CPUs, and whose threads are in the same ThreadGroup as the Thread that calls this method.

newFixedThreadPool

public static final ThreadPoolExecutor newFixedThreadPool(int n_proc,
                                                          String namePrefix)

newFixedThreadPool

public static final ThreadPoolExecutor newFixedThreadPool(int n_proc,
                                                          String namePrefix,
                                                          boolean use_caching_thread)

equalContent

public static final boolean equalContent(Collection<?> a,
                                         Collection<?> b)

If both are null will throw an error.

equalContent

public static final boolean equalContent(Map<?,?> a,
                                         Map<?,?> b)

If both are null will throw an error.

addPlugIns

public static final boolean addPlugIns(JPopupMenu popup,
                                       String menu,
                                       Project project,
                                       Callable<Displayable> active)

Returns false if none to add.

addPlugIns

public static final JMenu addPlugIns(String menu,
                                     Project project,
                                     Callable<Displayable> active)

Returns null if none to add.

launchTPlugIn

public static final Bureaucrat launchTPlugIn(KeyEvent ke,
                                             String menu,
                                             Project project,
                                             Displayable active)

Returns null if no plugin was launched. To launch a plugin, it needs a Utils.getControlModifier + 1,2,3,4... up to 9.

Parameters:: active - may be null.

getDimensions

public static final Dimension getDimensions(String text,
                                            Font font)

Get the width and height of single-line text.

createStream

public static final InputStream createStream(String path_or_url)
                                      throws Exception

Throws:: Exception

asList

public static final List<Long> asList(long[] ids)

asList

public static final List<Long> asList(long[] ids,
                                      int first,
                                      int length)

setEnabled

public static void setEnabled(Container root,
                              boolean b)

Recursively enable/disable all components of the @param root Container.

ensure

public static final boolean ensure(String filepath)

ensure
```
public static final boolean ensure(File f)
```
Ensure the file can be written to. Will create parent directories if necessary.

luminance

public static final int luminance(Color c)

0.3 * R + 0.6 * G + 0.1 * B

invokeLater
```
public static final void invokeLater(Runnable r)
```
Invoke in the context of the event dispatch thread.

showAllTables

public static final void showAllTables(HashMap<Class<?>,ij.measure.ResultsTable> ht)

fireLUT
```
public static final IndexColorModel fireLUT()
```
Returns a byte[3][256] containing the colors of the fire LUT.

convertToBufferedImage

public static final BufferedImage convertToBufferedImage(ij.process.ByteProcessor bp)

safeCopy

public static final boolean safeCopy(String source,
                                     String target)
                              throws IOException

Parameters:: source - The file to copy.; target - The new file to create.
Returns:: Whether the file could be copied; also returns false if the target file exists.
Throws:: IOException

castCollection

public static final <A,B> ArrayList<B> castCollection(Collection<A> classAs,
                                                      Class<B> type,
                                                      boolean doThrow)

Class Utils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

version

debug

debug_mouse

debug_sql

debug_event

debug_clip

debug_thing

FL_ERROR

last_dir

last_file

java3d

Constructor Detail

Utils

Method Detail

debug

debugMouse

setup

destroy

setLogStream

getLogStream

log

logStamped

logAll

log2

log2

log2

log2

log

log

log2

logMany2

toString

setDebug

setDebugMouse

setDebugSQL

printCaller

printCaller

caller

restoreMenuBar

showMessage

showMessage

showMessageT

showStatus

showStatus

showProgress

debugDialog

findOpenStacks

findOpenImages

findAllOpenImages

cutNumber

cutNumber

zeroPad

check

checkYN

d2s

getHexRGBColor

asHexRGBColor

asHexRGBColor

getRGBColorFromHex

get4Ints

run

chooseFile

chooseFile

selectFile

saveToFile

saveToFile

cleanString

openTextFile

openTextFileLines

openTextFileChars

getCos

removeExtension

addEnablerListener

wrongImageJVersion