ij
Class Prefs

java.lang.Object
  ij.Prefs

public class Prefs
extends Object

This class contains the ImageJ preferences, which are loaded from the "IJ_Props.txt" and "IJ_Prefs.txt" files.

See Also:

ImageJ

Field Summary

static boolean	antialiasedText No longer used
static boolean	antialiasedTools Draw tool icons using antialiasing.
static boolean	avoidResliceInterpolation Avoid interpolation when re-slicing
static String	BCOLOR
static boolean	blackBackground Backgound is black in binary images
static boolean	blackCanvas Use black image border.
static boolean	copyColumnHeaders Include column headers when copying tables to clipboard.
static String	DIR_IMAGE
static boolean	disableUndo Disable Edit/Undo command.
static String	DIV_BY_ZERO_VALUE
static boolean	dontSaveHeaders Don't save Results table column headers
static boolean	dontSaveRowNumbers Don't save Results table row numbers
static boolean	doubleBuffer Double buffer display of selections and overlays.
static String	FCOLOR
static boolean	flipXZ Rotate XZ orthogonal views 180 degrees
static String	FPS
static boolean	intelByteOrder Export TIFF and Raw using little-endian byte order.
static boolean	interpolateScaledImages Display images scaled <100% using bilinear interpolation
static String	JPEG
static boolean	keepUndoBuffers Preserve undo (snapshot) buffers when switching images
static String	KEY_PREFIX
static String	MENU_SIZE
static boolean	moveToMisc Move isolated plugins to Miscellaneous submenu.
static boolean	multiPointMode Use MultiPoint tool.
static boolean	noBorder Do not draw black border around image.
static boolean	noClickToGC Don't run garbage collector when user clicks in status bar
static String	NOISE_SD
static boolean	noPointLabels Do not label multiple points created using point tool.
static boolean	noRowNumbers Do not include row numbers when copying tables to clipboard.
static boolean	open100Percent Open images at 100% magnification
static boolean	openDicomsAsFloat Open DICOMs as 32-bit float images
static String	OPTIONS
static String	OPTIONS2
static boolean	padEdges Extend the borders to foreground for binary erosions and closings.
static boolean	pointAddToManager Add points to ROI Manager.
static boolean	pointAutoMeasure Point tool auto-measure mode.
static boolean	pointAutoNextSlice Point tool auto-next slice mode (not saved in IJ_Prefs).
static String	PREFS_NAME
static String	PROPS_NAME
static boolean	reflexAngle Angle tool measures reflex angle
static boolean	requireControlKey Require control or command key for keybaord shortcuts.
static String	ROICOLOR
static boolean	rotateYZ Rotate YZ orthogonal views 90 degrees
static boolean	runSocketListener Run the SocketListener.
static String	separator file.separator system property
static String	SHOW_ALL_COLOR
static boolean	showAllSliceOnly Only show ROIs associated with current slice in Roi Manager "Show All" mode.
static String	THREADS
static boolean	useInvertingLut Open 8-bit images with inverting LUT so 0 is white and 255 is black.
static boolean	useJFileChooser Use JFileChooser instead of FileDialog to open and save files.
static boolean	useNamesAsLabels Use ROI names as "show all" labels in the ROI Manager
static boolean	usePointerCursor Use pointer cursor instead of cross
static boolean	useSystemProxies Set the "java.net.useSystemProxies" property
static boolean	verticalProfile Plot rectangular selectons vertically
static String	vistaHint
static boolean	weightedColor Color to grayscale conversion is weighted (0.299, 0.587, 0.114) if the variable is true.

Constructor Summary

Prefs()

Method Summary

static boolean	get(String key, boolean defaultValue) Uses the keyword key to retrieve a boolean from the preferences file.
static double	get(String key, double defaultValue) Uses the keyword key to retrieve a number from the preferences file.
static String	get(String key, String defaultValue) Uses the keyword key to retrieve a string from the preferences file.
static boolean	getBoolean(String key, boolean defaultValue) Finds a boolean in IJ_Props or IJ_Prefs.txt.
static Color	getColor(String key, Color defaultColor) Finds a color in IJ_Props or IJ_Prefs.txt.
static Properties	getControlPanelProperties()
static String	getDefaultDirectory() Returns the default directory, if any, or null.
static double	getDouble(String key, double defaultValue) Looks up a real number in IJ_Props or IJ_Prefs.txt.
static String	getFileSeparator() Returns the file.separator system property.
static String	getHomeDir() Returns the path to the ImageJ directory.
static String	getImagesURL() Returns the URL of the directory that contains the ImageJ sample images.
static int	getInt(String key, int defaultValue) Finds an int in IJ_Props or IJ_Prefs.txt.
static Point	getLocation(String key) Uses the keyword key to retrieve a location from the preferences file.
static String	getPrefsDir() Gets the path to the directory where the preferences file (IJPrefs.txt) is saved.
static String	getString(String key) Finds an string in IJ_Props or IJ_Prefs.txt.
static String	getString(String key, String defaultString) Finds an string in IJ_Props or IJ_Prefs.txt.
static int	getThreads() Returns the number of threads used by PlugInFilters to process stacks.
static int	getTransparentIndex() Returns the transparent index (0-255), or -1 if transparency is disabled.
static String	load(Object ij, Applet applet) Finds and loads the ImageJ configuration file, "IJ_Props.txt".
static void	saveLocation(String key, Point loc) Saves the Point loc in the preferences file as a string using the keyword key.
static void	savePreferences() Saves user preferences in the IJ_Prefs.txt properties file.
static void	savePrefs(Properties prefs, String path)
static void	set(String key, boolean value) Saves the boolean variable value in the preferences file using the keyword key.
static void	set(String key, double value) Saves value in the preferences file using the keyword key.
static void	set(String key, int value) Saves value in the preferences file using the keyword key.
static void	set(String key, String text) Saves the value of the string text in the preferences file using the keyword key.
static void	setImagesURL(String url) Sets the URL of the directory that contains the ImageJ sample images.
static void	setThreads(int n) Sets the number of threads (1-32) used by PlugInFilters to process stacks.
static void	setTransparentIndex(int index) Sets the transparent index (0-255), or set to -1 to disable transparency.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROPS_NAME

public static final String PROPS_NAME

See Also:

Constant Field Values

PREFS_NAME

public static final String PREFS_NAME

See Also:

Constant Field Values

DIR_IMAGE

public static final String DIR_IMAGE

See Also:

Constant Field Values

FCOLOR

public static final String FCOLOR

See Also:

Constant Field Values

BCOLOR

public static final String BCOLOR

See Also:

Constant Field Values

ROICOLOR

public static final String ROICOLOR

See Also:

Constant Field Values

SHOW_ALL_COLOR

public static final String SHOW_ALL_COLOR

See Also:

Constant Field Values

JPEG

public static final String JPEG

See Also:

Constant Field Values

FPS

public static final String FPS

See Also:

Constant Field Values

DIV_BY_ZERO_VALUE

public static final String DIV_BY_ZERO_VALUE

See Also:

Constant Field Values

NOISE_SD

public static final String NOISE_SD

See Also:

Constant Field Values

MENU_SIZE

public static final String MENU_SIZE

See Also:

Constant Field Values

THREADS

public static final String THREADS

See Also:

Constant Field Values

KEY_PREFIX

public static final String KEY_PREFIX

See Also:

Constant Field Values

OPTIONS

public static final String OPTIONS

See Also:

Constant Field Values

OPTIONS2

public static final String OPTIONS2

See Also:

Constant Field Values

vistaHint

public static final String vistaHint

See Also:

Constant Field Values

separator

public static String separator

file.separator system property

usePointerCursor

public static boolean usePointerCursor

Use pointer cursor instead of cross

antialiasedText

public static boolean antialiasedText

No longer used

interpolateScaledImages

public static boolean interpolateScaledImages

Display images scaled <100% using bilinear interpolation

open100Percent

public static boolean open100Percent

Open images at 100% magnification

blackBackground

public static boolean blackBackground

Backgound is black in binary images

useJFileChooser

public static boolean useJFileChooser

Use JFileChooser instead of FileDialog to open and save files.

weightedColor

public static boolean weightedColor

Color to grayscale conversion is weighted (0.299, 0.587, 0.114) if the variable is true.

blackCanvas

public static boolean blackCanvas

Use black image border.

pointAutoMeasure

public static boolean pointAutoMeasure

Point tool auto-measure mode.

pointAutoNextSlice

public static boolean pointAutoNextSlice

Point tool auto-next slice mode (not saved in IJ_Prefs).

requireControlKey

public static boolean requireControlKey

Require control or command key for keybaord shortcuts.

useInvertingLut

public static boolean useInvertingLut

Open 8-bit images with inverting LUT so 0 is white and 255 is black.

antialiasedTools

public static boolean antialiasedTools

Draw tool icons using antialiasing.

intelByteOrder

public static boolean intelByteOrder

Export TIFF and Raw using little-endian byte order.

doubleBuffer

public static boolean doubleBuffer

Double buffer display of selections and overlays.

noPointLabels

public static boolean noPointLabels

Do not label multiple points created using point tool.

disableUndo

public static boolean disableUndo

Disable Edit/Undo command.

noBorder

public static boolean noBorder

Do not draw black border around image.

showAllSliceOnly

public static boolean showAllSliceOnly

Only show ROIs associated with current slice in Roi Manager "Show All" mode.

copyColumnHeaders

public static boolean copyColumnHeaders

Include column headers when copying tables to clipboard.

noRowNumbers

public static boolean noRowNumbers

Do not include row numbers when copying tables to clipboard.

moveToMisc

public static boolean moveToMisc

Move isolated plugins to Miscellaneous submenu.

pointAddToManager

public static boolean pointAddToManager

Add points to ROI Manager.

padEdges

public static boolean padEdges

Extend the borders to foreground for binary erosions and closings.

runSocketListener

public static boolean runSocketListener

Run the SocketListener.

multiPointMode

public static boolean multiPointMode

Use MultiPoint tool.

openDicomsAsFloat

public static boolean openDicomsAsFloat

Open DICOMs as 32-bit float images

verticalProfile

public static boolean verticalProfile

Plot rectangular selectons vertically

rotateYZ

public static boolean rotateYZ

Rotate YZ orthogonal views 90 degrees

flipXZ

public static boolean flipXZ

Rotate XZ orthogonal views 180 degrees

dontSaveHeaders

public static boolean dontSaveHeaders

Don't save Results table column headers

dontSaveRowNumbers

public static boolean dontSaveRowNumbers

Don't save Results table row numbers

noClickToGC

public static boolean noClickToGC

Don't run garbage collector when user clicks in status bar

reflexAngle

public static boolean reflexAngle

Angle tool measures reflex angle

avoidResliceInterpolation

public static boolean avoidResliceInterpolation

Avoid interpolation when re-slicing

keepUndoBuffers

public static boolean keepUndoBuffers

Preserve undo (snapshot) buffers when switching images

useNamesAsLabels

public static boolean useNamesAsLabels

Use ROI names as "show all" labels in the ROI Manager

useSystemProxies

public static boolean useSystemProxies

Set the "java.net.useSystemProxies" property

Constructor Detail

Prefs

public Prefs()

Method Detail

load

public static String load(Object ij,
                          Applet applet)

Finds and loads the ImageJ configuration file, "IJ_Props.txt".

Returns:

an error message if "IJ_Props.txt" not found.

getImagesURL

public static String getImagesURL()

Returns the URL of the directory that contains the ImageJ sample images.

setImagesURL

public static void setImagesURL(String url)

Sets the URL of the directory that contains the ImageJ sample images.

getHomeDir

public static String getHomeDir()

Returns the path to the ImageJ directory.

getPrefsDir

public static String getPrefsDir()

Gets the path to the directory where the preferences file (IJPrefs.txt) is saved.

getDefaultDirectory

public static String getDefaultDirectory()

Returns the default directory, if any, or null.

getString

public static String getString(String key)

Finds an string in IJ_Props or IJ_Prefs.txt.

getString

public static String getString(String key,
                               String defaultString)

Finds an string in IJ_Props or IJ_Prefs.txt.

getBoolean

public static boolean getBoolean(String key,
                                 boolean defaultValue)

Finds a boolean in IJ_Props or IJ_Prefs.txt.

getInt

public static int getInt(String key,
                         int defaultValue)

Finds an int in IJ_Props or IJ_Prefs.txt.

getDouble

public static double getDouble(String key,
                               double defaultValue)

Looks up a real number in IJ_Props or IJ_Prefs.txt.

getColor

public static Color getColor(String key,
                             Color defaultColor)

Finds a color in IJ_Props or IJ_Prefs.txt.

getFileSeparator

public static String getFileSeparator()

Returns the file.separator system property.

savePreferences

public static void savePreferences()

Saves user preferences in the IJ_Prefs.txt properties file.

set

public static void set(String key,
                       String text)

Saves the value of the string text in the preferences file using the keyword key. This string can be retrieved using the appropriate get() method.

set

public static void set(String key,
                       int value)

Saves value in the preferences file using the keyword key. This value can be retrieved using the appropriate getPref() method.

set

public static void set(String key,
                       double value)

Saves value in the preferences file using the keyword key. This value can be retrieved using the appropriate getPref() method.

set

public static void set(String key,
                       boolean value)

Saves the boolean variable value in the preferences file using the keyword key. This value can be retrieved using the appropriate getPref() method.

get

public static String get(String key,
                         String defaultValue)

Uses the keyword key to retrieve a string from the preferences file. Returns defaultValue if the key is not found.

get

public static double get(String key,
                         double defaultValue)

Uses the keyword key to retrieve a number from the preferences file. Returns defaultValue if the key is not found.

get

public static boolean get(String key,
                          boolean defaultValue)

Uses the keyword key to retrieve a boolean from the preferences file. Returns defaultValue if the key is not found.

saveLocation

public static void saveLocation(String key,
                                Point loc)

Saves the Point loc in the preferences file as a string using the keyword key.

getLocation

public static Point getLocation(String key)

Uses the keyword key to retrieve a location from the preferences file. Returns null if the key is not found or the location is not valid (e.g., offscreen).

savePrefs

public static void savePrefs(Properties prefs,
                             String path)
                      throws IOException

Throws:

IOException

getThreads

public static int getThreads()

Returns the number of threads used by PlugInFilters to process stacks.

setThreads

public static void setThreads(int n)

Sets the number of threads (1-32) used by PlugInFilters to process stacks.

setTransparentIndex

public static void setTransparentIndex(int index)

Sets the transparent index (0-255), or set to -1 to disable transparency.

getTransparentIndex

public static int getTransparentIndex()

Returns the transparent index (0-255), or -1 if transparency is disabled.

getControlPanelProperties

public static Properties getControlPanelProperties()