Method Detail

• numIoThreads

  default T numIoThreads(int numIoThreads)

  The specified number of threads is started to handle asynchronous writing of values that are evicted from the memory cache.

  Parameters:

  numIoThreads - how many writer threads to start (default is 1).

• maxIoQueueSize

  default T maxIoQueueSize(int maxIoQueueSize)

  Set the maximum size of the disk write queue. When the queue is full, removing entries from the cache will block until earlier values have been written.

  Because processing of removed entries is done whenever the cache is accessed, this may also block accesses to the cache. (This is a good thing, because it avoids running out of memory because entries cannot be cleared fast enough...)

  Parameters:

  maxIoQueueSize - the maximum size of the write queue (default is 10).

• cacheDirectory

  default T cacheDirectory(Path dir)

  Set the path of the cell cache directory.

  This is null by default, which means that a temporary directory will be created.

  Do not use the same cell cache directory for two images at the same time. Set deleteCacheDirectoryOnExit(false) if you do not want the cell cache directory to be deleted when the virtual machine shuts down.

  Parameters:

  dir - the path to the cell cache directory.

• tempDirectory

  default T tempDirectory(Path dir)

  Set the path to the directory in which to create the temporary cell cache directory. This has no effect, if cacheDirectory(Path) is specified.

  This is null by default, which means that the default system temporary-file directory is used.

  Parameters:

  dir - the path to directory in which to create the temporary cell cache directory.

• tempDirectoryPrefix

  default T tempDirectoryPrefix(String prefix)

  Set the prefix string to be used in generating the name of the temporary cell cache directory. Note, that this is not the path in which the directory is created but a prefix to the name (e.g. "MyImg"). This has no effect, if cacheDirectory(Path) is specified.

  This is "imglib2" by default.

  Parameters:

  prefix - the prefix string to be used in generating the name of the temporary cell cache directory.

• deleteCacheDirectoryOnExit

  default T deleteCacheDirectoryOnExit(boolean deleteOnExit)

  Specify whether the cell cache directory should be automatically deleted when the virtual machine shuts down.

  This is true by default.

  For safety reasons, only cell cache directories that are created by the DiskCachedCellImgFactory are actually marked for deletion. This means that either no cacheDirectory(Path) is specified (a temporary directory is created), or the specified cacheDirectory(Path) does not exist yet.

  Parameters:

  deleteOnExit - whether the cell cache directory directory should be automatically deleted when the virtual machine shuts down.

• initializeCellsAsDirty

  default T initializeCellsAsDirty(boolean initializeAsDirty)

  Specify whether cells initialized by a CellLoader should be marked as dirty. It is useful to set this to true if initialization is a costly operation. By this, it is made sure that cells are initialized only once, and then written and retrieve from the disk cache when they are next required.

  This is false by default.

  This option only has an effect for DiskCachedCellImg that are created with a CellLoader (DiskCachedCellImgFactory.create(long[], CellLoader)).

  Parameters:

  initializeAsDirty - whether cells initialized by a CellLoader should be marked as dirty.