Module ij
Package ij

Class Prefs


  • public class Prefs
    extends java.lang.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

      Fields 
      Modifier and Type Field Description
      static boolean alwaysOnTop
      "ImageJ" window is always on top.
      static boolean antialiasedText
      No longer used
      static boolean antialiasedTools
      Draw tool icons using antialiasing (always true).
      static boolean autoContrast
      Adjust contrast when scrolling stacks
      static boolean autoRunExamples
      Automatically run examples in Help/Examples menu.
      static boolean avoidResliceInterpolation
      Avoid interpolation when re-slicing
      static java.lang.String BCOLOR  
      static boolean blackBackground
      Backgound is black in binary images
      static boolean blackCanvas
      Use black image border.
      static boolean closingAll
      "Close All" command running
      static boolean convertToMicrons
      Convert tiff units to microns if pixel width is less than 0.0001 cm.
      static boolean copyColumnHeaders
      Include column headers when copying tables to clipboard.
      static boolean dialogCancelButtonOnRight
      Dialog "Cancel" button is on right on Linux
      static java.lang.String DIR_IMAGE  
      static boolean disableUndo
      Disable Edit/Undo command.
      static java.lang.String DIV_BY_ZERO_VALUE  
      static boolean doNotSaveWindowLocations
      Enable this option to workaround a bug with some Linux window managers that causes windows to wander down the screen.
      static boolean dontSaveHeaders
      Don't save Results table column headers
      static boolean dontSaveRowNumbers
      Don't save Results table row numbers
      static boolean doubleBuffer
      No longer used
      static boolean enhancedLineTool
      Allow lines to be created with one click at start and another at the end
      static java.lang.String FCOLOR  
      static boolean fixedDicomScaling
      Assume DICOM volumes use identical RescaleSlope and RescaleIntercept across all slices
      static boolean flipXZ
      Rotate XZ orthogonal views 180 degrees
      static java.lang.String FPS  
      static java.lang.String GUI_SCALE  
      static boolean ignoreRescaleSlope
      Ignore Rescale Slope when opening DICOMs
      static boolean intelByteOrder
      Export TIFF and Raw using little-endian byte order.
      static boolean interpolateScaledImages
      Display images scaled
      static boolean jFileChooserSettingChanged
      Use JFileChooser setting changed/
      static java.lang.String JPEG  
      static boolean keepArrowSelections
      Keep arrow selection after adding to overlay
      static boolean keepUndoBuffers
      Preserve undo (snapshot) buffers when switching images
      static java.lang.String KEY_PREFIX  
      static java.lang.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 java.lang.String NOISE_SD  
      static boolean nonBlockingFilterDialogs
      Use NonBlockingGenericDialogs in filters
      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 java.lang.String OPTIONS  
      static java.lang.String OPTIONS2  
      static boolean padEdges
      Extend the borders to foreground for binary erosions and closings.
      static boolean paintDoubleBuffered
      Aways paint images using double buffering
      static boolean pointAddToManager
      Add points to ROI Manager.
      static boolean pointAddToOverlay
      Add points to overlay.
      static boolean pointAutoMeasure
      Point tool auto-measure mode.
      static boolean pointAutoNextSlice
      Point tool auto-next slice mode (not saved in IJ_Prefs).
      static java.lang.String PREFS_NAME  
      static java.lang.String PROPS_NAME  
      static boolean reflexAngle
      Angle tool measures reflex angle
      static boolean requireControlKey
      Require control or command key for keybaord shortcuts.
      static boolean reverseNextPreviousOrder
      Reverse channel-slice-frame priority used by Next Slice and Previous Slice commands.
      static java.lang.String ROICOLOR  
      static boolean rotateYZ
      Rotate YZ orthogonal views 90 degrees
      static boolean runSocketListener
      Run the SocketListener.
      static java.lang.String separator
      file.separator system property
      static boolean setIJMenuBar
      Set MenuBar on Macs running Java 8.
      static java.lang.String SHOW_ALL_COLOR  
      static boolean showAllPoints
      Ignore stack positions when displaying points.
      static boolean showAllSliceOnly
      Only show ROIs associated with current slice in Roi Manager "Show All" mode.
      static boolean skipRawDialog
      Do not display dialog when opening .raw files
      static boolean smoothWand
      Wand tool "Smooth if thresholded" option
      static boolean splineFitLines
      Automatically spline fit line selections
      static boolean subPixelResolution
      Use sub-pixel resolution with line selections
      static boolean supportMacroUndo
      Support TRANSFORM Undo in macros
      static java.lang.String THREADS  
      static boolean useFileChooser
      Use the file chooser to import and export image sequences on Windows and Linux
      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 java.lang.String vistaHint  
      static boolean weightedColor
      Color to grayscale conversion is weighted (0.299, 0.587, 0.114) if the variable is true.
    • Constructor Summary

      Constructors 
      Constructor Description
      Prefs()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static boolean commandLineMacro()  
      static java.lang.String defaultResultsExtension()  
      static boolean get​(java.lang.String key, boolean defaultValue)
      Uses the keyword key to retrieve a boolean from the preferences file.
      static double get​(java.lang.String key, double defaultValue)
      Uses the keyword key to retrieve a number from the preferences file.
      static java.lang.String get​(java.lang.String key, java.lang.String defaultValue)
      Uses the keyword key to retrieve a string from the preferences file.
      static boolean getBoolean​(java.lang.String key, boolean defaultValue)
      Retrieves a boolean from IJ_Props or IJ_Prefs.txt.
      static java.awt.Color getColor​(java.lang.String key, java.awt.Color defaultColor)
      Finds a color in IJ_Props or IJ_Prefs.txt.
      static java.util.Properties getControlPanelProperties()  
      static java.lang.String getCustomPrefsPath()
      Returns the custom preferences (IJ_Prefs.txt) file path.
      static java.lang.String getCustomPropsPath()
      Returns the custom properties (IJ_Props.txt) file path.
      static java.lang.String getDefaultDirectory()
      Returns the default directory, if any, or null.
      static double getDouble​(java.lang.String key, double defaultValue)
      Retrieves a number from IJ_Props or IJ_Prefs.txt.
      static java.lang.String getFileSeparator()
      Returns the file.separator system property.
      static double getGuiScale()
      Returns the GenericDialog and Command Finder text scale.
      static java.lang.String getHomeDir()
      Obsolete, replaced by getImageJDir(), which, unlike this method, returns a path that ends with File.separator.
      static java.lang.String getImageJDir()
      Returns the path, ending in File.separator, to the ImageJ directory.
      static java.lang.String getImagesURL()
      Returns the URL of the directory that contains the ImageJ sample images.
      static int getInt​(java.lang.String key, int defaultValue)
      Retrieves a number from IJ_Props or IJ_Prefs.txt.
      static java.awt.Point getLocation​(java.lang.String key)
      Uses the keyword key to retrieve a location from the preferences file.
      static java.lang.String getPluginsDirProperty()  
      static java.lang.String getPrefsDir()
      Returns the path to the directory where the preferences file (IJPrefs.txt) is saved.
      static java.lang.String getString​(java.lang.String key)
      Retrieves a string from string in IJ_Props or IJ_Prefs.txt.
      static java.lang.String getString​(java.lang.String key, java.lang.String defaultString)
      Retrieves a string from IJ_Props or IJ_Prefs.txt.
      static int getThreads()
      Returns the number of threads used by PlugInFilters to process images and stacks.
      static int getTransparentIndex()
      Returns the transparent index (0-255), or -1 if transparency is disabled.
      static java.lang.String load​(java.lang.Object ij, java.applet.Applet applet)
      Finds and loads the configuration file ("IJ_Props.txt") and the preferences file ("IJ_Prefs.txt").
      static void resetPreferences()
      Delete the preferences file when ImageJ quits.
      static void saveLocation​(java.lang.String key, java.awt.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​(java.util.Properties prefs, java.lang.String path)  
      static void set​(java.lang.String key, boolean value)
      Saves the value of the boolean value in the preferences file using the keyword key.
      static void set​(java.lang.String key, double value)
      Saves the value of the double value in the preferences file using the keyword key.
      static void set​(java.lang.String key, int value)
      Saves the value of the integer value in the preferences file using the keyword key.
      static void set​(java.lang.String key, java.lang.String text)
      Saves the value of the string text in the preferences file using the keyword key.
      static void setGuiScale​(double scale)
      Sets the GenericDialog and Command Finder text scale (0.5 to 3.0).
      static void setImagesURL​(java.lang.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

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • DIV_BY_ZERO_VALUE

        public static final java.lang.String DIV_BY_ZERO_VALUE
        See Also:
        Constant Field Values
      • separator

        public static java.lang.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
        • 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 (always true).
        • intelByteOrder

          public static boolean intelByteOrder
          Export TIFF and Raw using little-endian byte order.
        • doubleBuffer

          public static boolean doubleBuffer
          No longer used
        • 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.
        • pointAddToOverlay

          public static boolean pointAddToOverlay
          Add points to overlay.
        • 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
        • ignoreRescaleSlope

          public static boolean ignoreRescaleSlope
          Ignore Rescale Slope when opening DICOMs
        • fixedDicomScaling

          public static boolean fixedDicomScaling
          Assume DICOM volumes use identical RescaleSlope and RescaleIntercept across all slices
        • 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
        • useFileChooser

          public static boolean useFileChooser
          Use the file chooser to import and export image sequences on Windows and Linux
        • subPixelResolution

          public static boolean subPixelResolution
          Use sub-pixel resolution with line selections
        • autoContrast

          public static boolean autoContrast
          Adjust contrast when scrolling stacks
        • enhancedLineTool

          public static boolean enhancedLineTool
          Allow lines to be created with one click at start and another at the end
        • keepArrowSelections

          public static boolean keepArrowSelections
          Keep arrow selection after adding to overlay
        • paintDoubleBuffered

          public static boolean paintDoubleBuffered
          Aways paint images using double buffering
        • skipRawDialog

          public static boolean skipRawDialog
          Do not display dialog when opening .raw files
        • reverseNextPreviousOrder

          public static boolean reverseNextPreviousOrder
          Reverse channel-slice-frame priority used by Next Slice and Previous Slice commands.
        • autoRunExamples

          public static boolean autoRunExamples
          Automatically run examples in Help/Examples menu.
        • showAllPoints

          public static boolean showAllPoints
          Ignore stack positions when displaying points.
        • setIJMenuBar

          public static boolean setIJMenuBar
          Set MenuBar on Macs running Java 8.
        • alwaysOnTop

          public static boolean alwaysOnTop
          "ImageJ" window is always on top.
        • splineFitLines

          public static boolean splineFitLines
          Automatically spline fit line selections
        • doNotSaveWindowLocations

          public static boolean doNotSaveWindowLocations
          Enable this option to workaround a bug with some Linux window managers that causes windows to wander down the screen.
        • jFileChooserSettingChanged

          public static boolean jFileChooserSettingChanged
          Use JFileChooser setting changed/
        • convertToMicrons

          public static boolean convertToMicrons
          Convert tiff units to microns if pixel width is less than 0.0001 cm.
        • smoothWand

          public static boolean smoothWand
          Wand tool "Smooth if thresholded" option
        • closingAll

          public static boolean closingAll
          "Close All" command running
        • dialogCancelButtonOnRight

          public static boolean dialogCancelButtonOnRight
          Dialog "Cancel" button is on right on Linux
        • supportMacroUndo

          public static boolean supportMacroUndo
          Support TRANSFORM Undo in macros
        • nonBlockingFilterDialogs

          public static boolean nonBlockingFilterDialogs
          Use NonBlockingGenericDialogs in filters
        • Constructor Detail

          • Prefs

            public Prefs()
        • Method Detail

          • set

            public static void set​(java.lang.String key,
                                   java.lang.String text)
            Saves the value of the string text in the preferences file using the keyword key. The string can be retrieved using the appropriate get() method.
            See Also:
            get(String,String)
          • set

            public static void set​(java.lang.String key,
                                   int value)
            Saves the value of the integer value in the preferences file using the keyword key. The value can be retrieved using the appropriate get() method.
            See Also:
            get(String,double)
          • set

            public static void set​(java.lang.String key,
                                   double value)
            Saves the value of the double value in the preferences file using the keyword key. The value can be retrieved using the appropriate get() method.
            See Also:
            get(String,double)
          • set

            public static void set​(java.lang.String key,
                                   boolean value)
            Saves the value of the boolean value in the preferences file using the keyword key. The value can be retrieved using the appropriate get() method.
            See Also:
            get(String,boolean)
          • get

            public static java.lang.String get​(java.lang.String key,
                                               java.lang.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​(java.lang.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​(java.lang.String key,
                                      boolean defaultValue)
            Uses the keyword key to retrieve a boolean from the preferences file. Returns defaultValue if the key is not found.
          • load

            public static java.lang.String load​(java.lang.Object ij,
                                                java.applet.Applet applet)
            Finds and loads the configuration file ("IJ_Props.txt") and the preferences file ("IJ_Prefs.txt").
            Returns:
            an error message if "IJ_Props.txt" not found.
          • getImagesURL

            public static java.lang.String getImagesURL()
            Returns the URL of the directory that contains the ImageJ sample images.
          • setImagesURL

            public static void setImagesURL​(java.lang.String url)
            Sets the URL of the directory that contains the ImageJ sample images.
          • getHomeDir

            public static java.lang.String getHomeDir()
            Obsolete, replaced by getImageJDir(), which, unlike this method, returns a path that ends with File.separator.
          • getImageJDir

            public static java.lang.String getImageJDir()
            Returns the path, ending in File.separator, to the ImageJ directory.
          • getPluginsDirProperty

            public static java.lang.String getPluginsDirProperty()
          • getPrefsDir

            public static java.lang.String getPrefsDir()
            Returns the path to the directory where the preferences file (IJPrefs.txt) is saved.
          • getDefaultDirectory

            public static java.lang.String getDefaultDirectory()
            Returns the default directory, if any, or null.
          • getFileSeparator

            public static java.lang.String getFileSeparator()
            Returns the file.separator system property.
          • savePreferences

            public static void savePreferences()
            Saves user preferences in the IJ_Prefs.txt properties file.
          • resetPreferences

            public static void resetPreferences()
            Delete the preferences file when ImageJ quits.
          • saveLocation

            public static void saveLocation​(java.lang.String key,
                                            java.awt.Point loc)
            Saves the Point loc in the preferences file as a string using the keyword key.
          • getLocation

            public static java.awt.Point getLocation​(java.lang.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​(java.util.Properties prefs,
                                         java.lang.String path)
                                  throws java.io.IOException
            Throws:
            java.io.IOException
          • getThreads

            public static int getThreads()
            Returns the number of threads used by PlugInFilters to process images and 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 java.util.Properties getControlPanelProperties()
          • defaultResultsExtension

            public static java.lang.String defaultResultsExtension()
          • setGuiScale

            public static void setGuiScale​(double scale)
            Sets the GenericDialog and Command Finder text scale (0.5 to 3.0).
          • getGuiScale

            public static double getGuiScale()
            Returns the GenericDialog and Command Finder text scale.
          • getCustomPropsPath

            public static java.lang.String getCustomPropsPath()
            Returns the custom properties (IJ_Props.txt) file path.
          • getCustomPrefsPath

            public static java.lang.String getCustomPrefsPath()
            Returns the custom preferences (IJ_Prefs.txt) file path.
          • getString

            public static java.lang.String getString​(java.lang.String key,
                                                     java.lang.String defaultString)
            Retrieves a string from IJ_Props or IJ_Prefs.txt. Does not retrieve strings set using Prefs.set().
          • getString

            public static java.lang.String getString​(java.lang.String key)
            Retrieves a string from string in IJ_Props or IJ_Prefs.txt.
          • getInt

            public static int getInt​(java.lang.String key,
                                     int defaultValue)
            Retrieves a number from IJ_Props or IJ_Prefs.txt. Does not retrieve numbers set using Prefs.set().
          • getDouble

            public static double getDouble​(java.lang.String key,
                                           double defaultValue)
            Retrieves a number from IJ_Props or IJ_Prefs.txt. Does not retrieve numbers set using Prefs.set().
          • getBoolean

            public static boolean getBoolean​(java.lang.String key,
                                             boolean defaultValue)
            Retrieves a boolean from IJ_Props or IJ_Prefs.txt. Does not retrieve boolean set using Prefs.set().
          • getColor

            public static java.awt.Color getColor​(java.lang.String key,
                                                  java.awt.Color defaultColor)
            Finds a color in IJ_Props or IJ_Prefs.txt.
          • commandLineMacro

            public static boolean commandLineMacro()