com.bumptech.glide.load

Class MultiTransformation<T>

java.lang.Object

com.bumptech.glide.load.MultiTransformation<T>

Type Parameters:

T - The type of Resource that will be transformed.

All Implemented Interfaces:

Key, Transformation<T>

public class MultiTransformation<T>
extends Object
implements Transformation<T>

A transformation that applies one or more transformations in iteration order to a resource.

Field Summary

Fields inherited from interface com.bumptech.glide.load.Key

CHARSET, STRING_CHARSET_NAME

Constructor Summary

Constructors

Constructor and Description
MultiTransformation(Collection<? extends Transformation<T>> transformationList)
MultiTransformation(Transformation<T>... transformations)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o) For caching to work correctly, implementations must implement this method and Key.hashCode().
int	hashCode() For caching to work correctly, implementations must implement this method and Key.equals(Object).
Resource<T>	transform(Context context, Resource<T> resource, int outWidth, int outHeight) Transforms the given resource and returns the transformed resource.
void	updateDiskCacheKey(MessageDigest messageDigest) Adds all uniquely identifying information to the given digest.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultiTransformation

@SafeVarargs
public MultiTransformation(@NonNull
                                        Transformation<T>... transformations)

MultiTransformation

public MultiTransformation(@NonNull
                           Collection<? extends Transformation<T>> transformationList)

Method Detail

transform

@NonNull
public Resource<T> transform(@NonNull
                                      Context context,
                                      @NonNull
                                      Resource<T> resource,
                                      int outWidth,
                                      int outHeight)

Description copied from interface: Transformation

Transforms the given resource and returns the transformed resource.

If the original resource object is not returned, the original resource will be recycled and it's internal resources may be reused. This means it is not safe to rely on the original resource or any internal state of the original resource in any new resource that is created. Usually this shouldn't occur, but if absolutely necessary either the original resource object can be returned with modified internal state, or the data in the original resource can be copied into the transformed resource.

If a Transformation is updated, Key.equals(Object), Key.hashCode(), and Key.updateDiskCacheKey(java.security.MessageDigest) should all change. If you're using a simple String key an easy way to do this is to append a version number to your key. Failing to do so will mean users may see images loaded from cache that had the old version of the Transformation applied. Changing the return values of those methods will ensure that the cache key has changed and therefore that any cached resources will be re-generated using the updated Transformation.

During development you may need to either using DiskCacheStrategy.NONE or make sure Key.updateDiskCacheKey(java.security.MessageDigest) changes each time you make a change to the Transformation. Otherwise the resource you request may be loaded from disk cache and your Transformation may not be called.

Specified by:

transform in interface Transformation<T>

Parameters:

context - The Application context

resource - The resource to transform.

outWidth - The width of the view or target the resource will be displayed in, or Target.SIZE_ORIGINAL to indicate the original resource width.

outHeight - The height of the view or target the resource will be displayed in, or Target.SIZE_ORIGINAL to indicate the original resource height.

Returns:

The transformed resource.

equals

public boolean equals(Object o)

Description copied from interface: Key

For caching to work correctly, implementations must implement this method and Key.hashCode().

Specified by:

equals in interface Key

Overrides:

equals in class Object

hashCode

public int hashCode()

Description copied from interface: Key

For caching to work correctly, implementations must implement this method and Key.equals(Object).

Specified by:

hashCode in interface Key

Overrides:

hashCode in class Object

updateDiskCacheKey

public void updateDiskCacheKey(@NonNull
                               MessageDigest messageDigest)

Description copied from interface: Key

Adds all uniquely identifying information to the given digest.

Note - Using MessageDigest.reset() inside of this method will result in undefined behavior.

Specified by:

updateDiskCacheKey in interface Key