public static class ImageLoaderConfiguration.Builder
extends java.lang.Object
ImageLoaderConfiguration
Modifier and Type | Field and Description |
---|---|
static QueueProcessingType |
DEFAULT_TASK_PROCESSING_TYPE |
static int |
DEFAULT_THREAD_POOL_SIZE
3
|
static int |
DEFAULT_THREAD_PRIORITY
3
|
Constructor and Description |
---|
ImageLoaderConfiguration.Builder(android.content.Context context) |
Modifier and Type | Method and Description |
---|---|
ImageLoaderConfiguration |
build()
Builds configured
ImageLoaderConfiguration object |
ImageLoaderConfiguration.Builder |
defaultDisplayImageOptions(DisplayImageOptions defaultDisplayImageOptions)
Sets default display image options for image displaying.
|
ImageLoaderConfiguration.Builder |
denyCacheImageMultipleSizesInMemory()
When you display an image in a small
ImageView and later you try to display
this image (from identical URI) in a larger ImageView so decoded image of
bigger size will be cached in memory as a previous decoded image of smaller size.So the default behavior is to allow to cache multiple sizes of one image in memory. |
ImageLoaderConfiguration.Builder |
discCache(DiskCache diskCache)
|
ImageLoaderConfiguration.Builder |
discCacheExtraOptions(int maxImageWidthForDiskCache,
int maxImageHeightForDiskCache,
BitmapProcessor processorForDiskCache)
Deprecated.
|
ImageLoaderConfiguration.Builder |
discCacheFileCount(int maxFileCount)
Deprecated.
Use
diskCacheFileCount(int) instead |
ImageLoaderConfiguration.Builder |
discCacheFileNameGenerator(FileNameGenerator fileNameGenerator)
|
ImageLoaderConfiguration.Builder |
discCacheSize(int maxCacheSize)
Deprecated.
Use
diskCacheSize(int) instead |
ImageLoaderConfiguration.Builder |
diskCache(DiskCache diskCache)
Sets disk cache for images.
Default value - UnlimitedDiskCache . |
ImageLoaderConfiguration.Builder |
diskCacheExtraOptions(int maxImageWidthForDiskCache,
int maxImageHeightForDiskCache,
BitmapProcessor processorForDiskCache)
Sets options for resizing/compressing of downloaded images before saving to disk cache.
NOTE: Use this option only when you have appropriate needs. |
ImageLoaderConfiguration.Builder |
diskCacheFileCount(int maxFileCount)
Sets maximum file count in disk cache directory.
By default: disk cache is unlimited. NOTE: If you use this method then LruDiskCache
will be used as disk cache. |
ImageLoaderConfiguration.Builder |
diskCacheFileNameGenerator(FileNameGenerator fileNameGenerator)
Sets name generator for files cached in disk cache.
Default value - DefaultConfigurationFactory.createFileNameGenerator() |
ImageLoaderConfiguration.Builder |
diskCacheSize(int maxCacheSize)
Sets maximum disk cache size for images (in bytes).
By default: disk cache is unlimited. NOTE: If you use this method then LruDiskCache
will be used as disk cache. |
ImageLoaderConfiguration.Builder |
imageDecoder(ImageDecoder imageDecoder)
Sets utility which will be responsible for decoding of image stream.
Default value - DefaultConfigurationFactory.createImageDecoder() |
ImageLoaderConfiguration.Builder |
imageDownloader(ImageDownloader imageDownloader)
Sets utility which will be responsible for downloading of image.
Default value - DefaultConfigurationFactory.createImageDownloader() |
ImageLoaderConfiguration.Builder |
memoryCache(MemoryCache memoryCache)
Sets memory cache for
bitmaps .Default value - LruMemoryCache
with limited memory cache size (size = 1/8 of available app memory)NOTE: If you set custom memory cache then following configuration option will not be considered: memoryCacheSize(int)
|
ImageLoaderConfiguration.Builder |
memoryCacheExtraOptions(int maxImageWidthForMemoryCache,
int maxImageHeightForMemoryCache)
Sets options for memory cache
|
ImageLoaderConfiguration.Builder |
memoryCacheSize(int memoryCacheSize)
Sets maximum memory cache size for
bitmaps (in bytes).Default value - 1/8 of available app memory. NOTE: If you use this method then LruMemoryCache will be used as
memory cache. |
ImageLoaderConfiguration.Builder |
memoryCacheSizePercentage(int availableMemoryPercent)
Sets maximum memory cache size (in percent of available app memory) for
bitmaps .Default value - 1/8 of available app memory. NOTE: If you use this method then LruMemoryCache will be used as
memory cache. |
ImageLoaderConfiguration.Builder |
taskExecutor(java.util.concurrent.Executor executor)
Sets custom executor for tasks of loading and displaying images.
NOTE: If you set custom executor then following configuration options will not be considered for this executor: threadPoolSize(int)
threadPriority(int)
tasksProcessingOrder(QueueProcessingType)
|
ImageLoaderConfiguration.Builder |
taskExecutorForCachedImages(java.util.concurrent.Executor executorForCachedImages)
Sets custom executor for tasks of displaying cached on disk images (these tasks
are executed quickly so UIL prefer to use separate executor for them).
If you set the same executor for general tasks and tasks about cached images (this method) then these tasks will be in the same thread pool. |
ImageLoaderConfiguration.Builder |
tasksProcessingOrder(QueueProcessingType tasksProcessingType)
Sets type of queue processing for tasks for loading and displaying images.
Default value - QueueProcessingType.FIFO |
ImageLoaderConfiguration.Builder |
threadPoolSize(int threadPoolSize)
Sets thread pool size for image display tasks.
Default value - this |
ImageLoaderConfiguration.Builder |
threadPriority(int threadPriority)
Sets the priority for image loading threads.
|
ImageLoaderConfiguration.Builder |
writeDebugLogs()
Enables detail logging of
ImageLoader work. |
public static final int DEFAULT_THREAD_POOL_SIZE
public static final int DEFAULT_THREAD_PRIORITY
public static final QueueProcessingType DEFAULT_TASK_PROCESSING_TYPE
public ImageLoaderConfiguration.Builder(android.content.Context context)
public ImageLoaderConfiguration.Builder memoryCacheExtraOptions(int maxImageWidthForMemoryCache, int maxImageHeightForMemoryCache)
maxImageWidthForMemoryCache
- Maximum image width which will be used for memory saving during decoding
an image to Bitmap
. Default value - device's screen widthmaxImageHeightForMemoryCache
- Maximum image height which will be used for memory saving during decoding
an image to Bitmap
. Default value - device's screen height@Deprecated public ImageLoaderConfiguration.Builder discCacheExtraOptions(int maxImageWidthForDiskCache, int maxImageHeightForDiskCache, BitmapProcessor processorForDiskCache)
diskCacheExtraOptions(int, int, com.nostra13.universalimageloader.core.process.BitmapProcessor)
insteadpublic ImageLoaderConfiguration.Builder diskCacheExtraOptions(int maxImageWidthForDiskCache, int maxImageHeightForDiskCache, BitmapProcessor processorForDiskCache)
maxImageWidthForDiskCache
- Maximum width of downloaded images for saving at disk cachemaxImageHeightForDiskCache
- Maximum height of downloaded images for saving at disk cacheprocessorForDiskCache
- null-ok; Bitmap processor which process images before saving them in disc cachepublic ImageLoaderConfiguration.Builder taskExecutor(java.util.concurrent.Executor executor)
public ImageLoaderConfiguration.Builder taskExecutorForCachedImages(java.util.concurrent.Executor executorForCachedImages)
taskExecutor(Executor)
public ImageLoaderConfiguration.Builder threadPoolSize(int threadPoolSize)
this
public ImageLoaderConfiguration.Builder threadPriority(int threadPriority)
Thread.MAX_PRIORITY
or
less than Thread.MIN_PRIORITY
this
public ImageLoaderConfiguration.Builder denyCacheImageMultipleSizesInMemory()
ImageView
and later you try to display
this image (from identical URI) in a larger ImageView
so decoded image of
bigger size will be cached in memory as a previous decoded image of smaller size.public ImageLoaderConfiguration.Builder tasksProcessingOrder(QueueProcessingType tasksProcessingType)
QueueProcessingType.FIFO
public ImageLoaderConfiguration.Builder memoryCacheSize(int memoryCacheSize)
bitmaps
(in bytes).LruMemoryCache
will be used as
memory cache. You can use memoryCache(MemoryCache)
method to set your own implementation of
MemoryCache
.public ImageLoaderConfiguration.Builder memoryCacheSizePercentage(int availableMemoryPercent)
bitmaps
.LruMemoryCache
will be used as
memory cache. You can use memoryCache(MemoryCache)
method to set your own implementation of
MemoryCache
.public ImageLoaderConfiguration.Builder memoryCache(MemoryCache memoryCache)
bitmaps
.LruMemoryCache
with limited memory cache size (size = 1/8 of available app memory)@Deprecated public ImageLoaderConfiguration.Builder discCacheSize(int maxCacheSize)
diskCacheSize(int)
insteadpublic ImageLoaderConfiguration.Builder diskCacheSize(int maxCacheSize)
LruDiskCache
will be used as disk cache. You can use diskCache(DiskCache)
method for introduction your own
implementation of DiskCache
@Deprecated public ImageLoaderConfiguration.Builder discCacheFileCount(int maxFileCount)
diskCacheFileCount(int)
insteadpublic ImageLoaderConfiguration.Builder diskCacheFileCount(int maxFileCount)
LruDiskCache
will be used as disk cache. You can use diskCache(DiskCache)
method for introduction your own
implementation of DiskCache
@Deprecated public ImageLoaderConfiguration.Builder discCacheFileNameGenerator(FileNameGenerator fileNameGenerator)
public ImageLoaderConfiguration.Builder diskCacheFileNameGenerator(FileNameGenerator fileNameGenerator)
DefaultConfigurationFactory.createFileNameGenerator()
@Deprecated public ImageLoaderConfiguration.Builder discCache(DiskCache diskCache)
public ImageLoaderConfiguration.Builder diskCache(DiskCache diskCache)
UnlimitedDiskCache
. Cache directory is defined by
StorageUtils.getCacheDirectory(Context)
.public ImageLoaderConfiguration.Builder imageDownloader(ImageDownloader imageDownloader)
DefaultConfigurationFactory.createImageDownloader()
public ImageLoaderConfiguration.Builder imageDecoder(ImageDecoder imageDecoder)
DefaultConfigurationFactory.createImageDecoder()
public ImageLoaderConfiguration.Builder defaultDisplayImageOptions(DisplayImageOptions defaultDisplayImageOptions)
Simple options
public ImageLoaderConfiguration.Builder writeDebugLogs()
ImageLoader
work. To prevent detail logs don't call this method.
Consider L.disableLogging()
to disable
ImageLoader logging completely (even error logs)public ImageLoaderConfiguration build()
ImageLoaderConfiguration
object