com.hannesdorfmann.httpkit.image

Class FadeableHttpImageView

java.lang.Object

android.view.View

android.widget.ImageView

com.hannesdorfmann.httpkit.image.FadeableHttpImageView

All Implemented Interfaces:

android.graphics.drawable.Drawable.Callback, android.view.accessibility.AccessibilityEventSource, android.view.KeyEvent.Callback, HttpImageView

public class FadeableHttpImageView
extends android.widget.ImageView
implements HttpImageView

This image view can change his drawable by crossfading. This requires that a placeholder is set! Otherwise crossfading could not be executed. Moreover you must ensure, that the the placeholder and the loaded bitmap have the same width and height, therefore the name FadeableHttpImageView

Author:

Hannes Dorfmann

Nested Class Summary

Nested classes/interfaces inherited from class android.widget.ImageView

android.widget.ImageView.ScaleType

Nested classes/interfaces inherited from class android.view.View

android.view.View.AccessibilityDelegate, android.view.View.BaseSavedState, android.view.View.DragShadowBuilder, android.view.View.MeasureSpec, android.view.View.OnAttachStateChangeListener, android.view.View.OnClickListener, android.view.View.OnCreateContextMenuListener, android.view.View.OnDragListener, android.view.View.OnFocusChangeListener, android.view.View.OnGenericMotionListener, android.view.View.OnHoverListener, android.view.View.OnKeyListener, android.view.View.OnLayoutChangeListener, android.view.View.OnLongClickListener, android.view.View.OnSystemUiVisibilityChangeListener, android.view.View.OnTouchListener

Field Summary

Fields inherited from class android.view.View

ALPHA, DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, EMPTY_STATE_SET, ENABLED_FOCUSED_SELECTED_STATE_SET, ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_FOCUSED_STATE_SET, ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, ENABLED_SELECTED_STATE_SET, ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_STATE_SET, ENABLED_WINDOW_FOCUSED_STATE_SET, FIND_VIEWS_WITH_CONTENT_DESCRIPTION, FIND_VIEWS_WITH_TEXT, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, FOCUSED_SELECTED_STATE_SET, FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, FOCUSED_STATE_SET, FOCUSED_WINDOW_FOCUSED_STATE_SET, GONE, HAPTIC_FEEDBACK_ENABLED, IMPORTANT_FOR_ACCESSIBILITY_AUTO, IMPORTANT_FOR_ACCESSIBILITY_NO, IMPORTANT_FOR_ACCESSIBILITY_YES, INVISIBLE, KEEP_SCREEN_ON, LAYER_TYPE_HARDWARE, LAYER_TYPE_NONE, LAYER_TYPE_SOFTWARE, MEASURED_HEIGHT_STATE_SHIFT, MEASURED_SIZE_MASK, MEASURED_STATE_MASK, MEASURED_STATE_TOO_SMALL, NO_ID, OVER_SCROLL_ALWAYS, OVER_SCROLL_IF_CONTENT_SCROLLS, OVER_SCROLL_NEVER, PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET, PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_SELECTED_STATE_SET, PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_STATE_SET, PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_SELECTED_STATE_SET, PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_STATE_SET, PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_SELECTED_STATE_SET, PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_WINDOW_FOCUSED_STATE_SET, ROTATION, ROTATION_X, ROTATION_Y, SCALE_X, SCALE_Y, SCREEN_STATE_OFF, SCREEN_STATE_ON, SCROLLBAR_POSITION_DEFAULT, SCROLLBAR_POSITION_LEFT, SCROLLBAR_POSITION_RIGHT, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SELECTED_STATE_SET, SELECTED_WINDOW_FOCUSED_STATE_SET, SOUND_EFFECTS_ENABLED, STATUS_BAR_HIDDEN, STATUS_BAR_VISIBLE, SYSTEM_UI_FLAG_FULLSCREEN, SYSTEM_UI_FLAG_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_STABLE, SYSTEM_UI_FLAG_LOW_PROFILE, SYSTEM_UI_FLAG_VISIBLE, SYSTEM_UI_LAYOUT_FLAGS, TEXT_ALIGNMENT_INHERIT, TEXT_ALIGNMENT_RESOLVED_DEFAULT, TRANSLATION_X, TRANSLATION_Y, VIEW_LOG_TAG, VISIBLE, WINDOW_FOCUSED_STATE_SET, X, Y

Constructor Summary

Constructors

Constructor and Description
FadeableHttpImageView(android.content.Context context)
FadeableHttpImageView(android.content.Context context, android.util.AttributeSet attrs)
FadeableHttpImageView(android.content.Context context, android.util.AttributeSet attrs, int defStyle)

Method Summary

Methods

Modifier and Type	Method and Description
void	clearClickColorFiltered() Clears the color filter to show the normal image
android.graphics.Bitmap	getPlaceholderBitmap() Get the Bitmap that is shown when showPlaceholderImageImmediatly() gets called
String	getUrl() Get the url that is currently loading
boolean	hasLastRequestError() Return true, if the last http
boolean	isCorssFadeEnabled() Is cross fading enabled
boolean	isFadingEnabled()
void	onError(String url, Exception e)
void	setClickColorMatrix(float[] colorFilterMatrix) Set the matrix for the ColorMatrixColorFilter which is enabled if the user clicks on this view.
void	setCrossFadeEnabled(boolean enabled) Set crossfading between the placeholder to the loaded bitmap
void	setErrorDrawable(android.graphics.drawable.Drawable d) Set the error Drawable, that will be displayed when an error has occurred while loading
void	setErrorResource(int errorResource) Sets the error Resource that should be displayed, when an error has occurred while loading the real image resource
void	setFadingDuration(int duration) Set how long the switching drawable animation takes
void	setFadingEnabled(boolean enabled)
void	setLoadedBitmap(android.graphics.Bitmap loadedBitmap) Sets the loaded Image Bitmap
void	setPlaceholderBitmap(android.graphics.Bitmap b) Sets the start bitmap.
void	setPlaceholderResource(int placeholderResource) Set the placeholder resource.
void	setScaleType(android.widget.ImageView.ScaleType t)
void	setUrl(String url) Set the url that should be loaded
void	showClickColorFiltered() Show the color filter to highlight a click event
void	showErrorDrawable() Displays the error drawable
void	showErrorImage() Show the error image.
void	showLoadedBitmap(android.graphics.Bitmap bitmap, boolean loadedImmediatly) Sets and shows the loaded Image
void	showPlaceholder() Shows a place holder image while loading the real image resource
void	showPlaceholderImageImmediatly() Show the start Bitmap that has been set as placeholder.
void	simulateClickColorFilter() Simulates the color filter with the default delay
void	simulateClickColorFilter(long delay) Simulate the color filter that will be enabled and disabled, like on a real click event
void	startImageSwitching() Replace the start Image with the already loaded ( setLoadedBitmap(Bitmap)) drawable.
void	startImageSwitching(int animationDurationMillis) This is the same as startImageSwitching(), but here you can specify the animation duration as parameter.

Methods inherited from class android.widget.ImageView

clearColorFilter, drawableStateChanged, getAdjustViewBounds, getBaseline, getBaselineAlignBottom, getColorFilter, getCropToPadding, getDrawable, getImageAlpha, getImageMatrix, getMaxHeight, getMaxWidth, getScaleType, hasOverlappingRendering, invalidateDrawable, jumpDrawablesToCurrentState, onAttachedToWindow, onCreateDrawableState, onDetachedFromWindow, onDraw, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onMeasure, onPopulateAccessibilityEvent, setAdjustViewBounds, setAlpha, setBaseline, setBaselineAlignBottom, setColorFilter, setColorFilter, setColorFilter, setCropToPadding, setFrame, setImageAlpha, setImageBitmap, setImageDrawable, setImageLevel, setImageMatrix, setImageResource, setImageState, setImageURI, setMaxHeight, setMaxWidth, setSelected, setVisibility, verifyDrawable

Methods inherited from class android.view.View

addChildrenForAccessibility, addFocusables, addFocusables, addOnAttachStateChangeListener, addOnLayoutChangeListener, addTouchables, animate, announceForAccessibility, awakenScrollBars, awakenScrollBars, awakenScrollBars, bringToFront, buildDrawingCache, buildDrawingCache, buildLayer, callOnClick, cancelLongPress, canScrollHorizontally, canScrollVertically, checkInputConnectionProxy, clearAnimation, clearFocus, combineMeasuredStates, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchConfigurationChanged, dispatchDisplayHint, dispatchDragEvent, dispatchDraw, dispatchGenericFocusedEvent, dispatchGenericMotionEvent, dispatchGenericPointerEvent, dispatchHoverEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchRestoreInstanceState, dispatchSaveInstanceState, dispatchSetActivated, dispatchSetPressed, dispatchSetSelected, dispatchSystemUiVisibilityChanged, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchVisibilityChanged, dispatchWindowFocusChanged, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, draw, findFocus, findViewById, findViewsWithText, findViewWithTag, fitSystemWindows, focusSearch, forceLayout, getAccessibilityNodeProvider, getAlpha, getAnimation, getApplicationWindowToken, getBackground, getBottom, getBottomFadingEdgeStrength, getBottomPaddingOffset, getCameraDistance, getContentDescription, getContext, getContextMenuInfo, getDefaultSize, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusables, getFocusedRect, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getId, getImportantForAccessibility, getKeepScreenOn, getKeyDispatcherState, getLayerType, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLeftPaddingOffset, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMatrix, getMeasuredHeight, getMeasuredHeightAndState, getMeasuredState, getMeasuredWidth, getMeasuredWidthAndState, getMinimumHeight, getMinimumWidth, getNextFocusDownId, getNextFocusForwardId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getOverScrollMode, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, getParent, getParentForAccessibility, getPivotX, getPivotY, getResources, getRight, getRightFadingEdgeStrength, getRightPaddingOffset, getRootView, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollX, getScrollY, getSolidColor, getSuggestedMinimumHeight, getSuggestedMinimumWidth, getSystemUiVisibility, getTag, getTag, getTop, getTopFadingEdgeStrength, getTopPaddingOffset, getTouchables, getTouchDelegate, getTranslationX, getTranslationY, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowAttachCount, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, hasFocus, hasFocusable, hasOnClickListeners, hasTransientState, hasWindowFocus, inflate, initializeFadingEdge, initializeScrollbars, invalidate, invalidate, invalidate, isActivated, isClickable, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isInEditMode, isInTouchMode, isLayoutRequested, isLongClickable, isOpaque, isPaddingOffsetRequired, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShown, isSoundEffectsEnabled, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, layout, measure, mergeDrawableStates, offsetLeftAndRight, offsetTopAndBottom, onAnimationEnd, onAnimationStart, onCheckIsTextEditor, onConfigurationChanged, onCreateContextMenu, onCreateInputConnection, onDisplayHint, onDragEvent, onDrawScrollBars, onFilterTouchEventForSecurity, onFinishInflate, onFinishTemporaryDetach, onFocusChanged, onGenericMotionEvent, onHoverChanged, onHoverEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onLayout, onOverScrolled, onRestoreInstanceState, onSaveInstanceState, onScreenStateChanged, onScrollChanged, onSetAlpha, onSizeChanged, onStartTemporaryDetach, onTouchEvent, onTrackballEvent, onVisibilityChanged, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, onWindowVisibilityChanged, overScrollBy, performAccessibilityAction, performClick, performHapticFeedback, performHapticFeedback, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, requestFitSystemWindows, requestFocus, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, resolveSize, resolveSizeAndState, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDelegate, setActivated, setAlpha, setAnimation, setBackground, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBottom, setCameraDistance, setClickable, setContentDescription, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusableInTouchMode, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHovered, setId, setImportantForAccessibility, setKeepScreenOn, setLayerType, setLayoutParams, setLeft, setLongClickable, setMeasuredDimension, setMinimumHeight, setMinimumWidth, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOverScrollMode, setPadding, setPivotX, setPivotY, setPressed, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollContainer, setScrollX, setScrollY, setSoundEffectsEnabled, setSystemUiVisibility, setTag, setTag, setTop, setTouchDelegate, setTranslationX, setTranslationY, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setWillNotCacheDrawing, setWillNotDraw, setX, setY, showContextMenu, startActionMode, startAnimation, startDrag, unscheduleDrawable, unscheduleDrawable, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.hannesdorfmann.httpkit.image.HttpImageView

getHeight, getWidth

Constructor Detail

FadeableHttpImageView

public FadeableHttpImageView(android.content.Context context)

FadeableHttpImageView

public FadeableHttpImageView(android.content.Context context,
                     android.util.AttributeSet attrs)

FadeableHttpImageView

public FadeableHttpImageView(android.content.Context context,
                     android.util.AttributeSet attrs,
                     int defStyle)

Method Detail

setCrossFadeEnabled

public void setCrossFadeEnabled(boolean enabled)

Set crossfading between the placeholder to the loaded bitmap

Parameters:

enabled -

isCorssFadeEnabled

public boolean isCorssFadeEnabled()

Is cross fading enabled

Returns:

See Also:

setCrossFadeEnabled(boolean)

setUrl

public void setUrl(String url)

Set the url that should be loaded

Specified by:

setUrl in interface HttpImageView

Parameters:

url -

hasLastRequestError

public boolean hasLastRequestError()

Description copied from interface: HttpImageView

Return true, if the last http

Specified by:

hasLastRequestError in interface HttpImageView

Returns:

getUrl

public String getUrl()

Get the url that is currently loading

Specified by:

getUrl in interface HttpImageView

Returns:

setFadingDuration

public void setFadingDuration(int duration)

Set how long the switching drawable animation takes

Parameters:

duration -

See Also:

startImageSwitching()

setErrorDrawable

public void setErrorDrawable(android.graphics.drawable.Drawable d)

Set the error Drawable, that will be displayed when an error has occurred while loading

Specified by:

setErrorDrawable in interface HttpImageView

Parameters:

d -

setErrorResource

public void setErrorResource(int errorResource)

Sets the error Resource that should be displayed, when an error has occurred while loading the real image resource

Specified by:

setErrorResource in interface HttpImageView

Parameters:

errorResource -

showErrorDrawable

public void showErrorDrawable()

Displays the error drawable

setLoadedBitmap

public void setLoadedBitmap(android.graphics.Bitmap loadedBitmap)

Sets the loaded Image Bitmap

Parameters:

loadedBitmap -

setScaleType

public void setScaleType(android.widget.ImageView.ScaleType t)

Overrides:

setScaleType in class android.widget.ImageView

startImageSwitching

public void startImageSwitching()

Replace the start Image with the already loaded ( setLoadedBitmap(Bitmap)) drawable. This will be done with a little animation. The duration of the animation is the default, that has been specified in the xml (otherwise a default value will be used).

This method can only be called, if setLoadedBitmap(Bitmap) has been set before.

setPlaceholderBitmap

public void setPlaceholderBitmap(android.graphics.Bitmap b)

Sets the start bitmap. This is the bitmap that will be displayed (when no error has occurred and the other bitmap is already loading)

Specified by:

setPlaceholderBitmap in interface HttpImageView

Parameters:

b -

setPlaceholderResource

public void setPlaceholderResource(int placeholderResource)

Set the placeholder resource. This resource will be displayed while loading the real image (bitmap) resource in background

Specified by:

setPlaceholderResource in interface HttpImageView

Parameters:

placeholderResource -

getPlaceholderBitmap

public android.graphics.Bitmap getPlaceholderBitmap()

Get the Bitmap that is shown when showPlaceholderImageImmediatly() gets called

Returns:

The start Bitmap

showPlaceholderImageImmediatly

public void showPlaceholderImageImmediatly()

Show the start Bitmap that has been set as placeholder. If no placeholder has been set yet, than a no drawable (null-drawable) will be shown instead, which will lead to a transparent image view.

startImageSwitching

public void startImageSwitching(int animationDurationMillis)

This is the same as startImageSwitching(), but here you can specify the animation duration as parameter. So this passed duration value will be uses, instead of the default animation duration.

Parameters:

animationDurationMillis -

onError

public void onError(String url,
           Exception e)

showErrorImage

public void showErrorImage()

Description copied from interface: HttpImageView

Show the error image. This method gets called, when an error while loading has occurred

Specified by:

showErrorImage in interface HttpImageView

showPlaceholder

public void showPlaceholder()

Description copied from interface: HttpImageView

Shows a place holder image while loading the real image resource

Specified by:

showPlaceholder in interface HttpImageView

showLoadedBitmap

public void showLoadedBitmap(android.graphics.Bitmap bitmap,
                    boolean loadedImmediatly)

Description copied from interface: HttpImageView

Sets and shows the loaded Image

Specified by:

showLoadedBitmap in interface HttpImageView

Parameters:

bitmap - The Bitmap that has been loaded

loadedImmediatly - true, if the Bitmap has been loaded immediatly (from cache)

setFadingEnabled

public void setFadingEnabled(boolean enabled)

isFadingEnabled

public boolean isFadingEnabled()

showClickColorFiltered

public void showClickColorFiltered()

Show the color filter to highlight a click event

clearClickColorFiltered

public void clearClickColorFiltered()

Clears the color filter to show the normal image

setClickColorMatrix

public void setClickColorMatrix(float[] colorFilterMatrix)

Set the matrix for the ColorMatrixColorFilter which is enabled if the user clicks on this view.
Example for a black-white grayscale filter:

float brightness = 0.33f;
float[] colorMatrix = { 0.33f, 0.33f, 0.33f, 0, brightness, // red
0.33f, 0.33f, 0.33f, 0, brightness, // green
0.33f, 0.33f, 0.33f, 0, brightness, // blue
0, 0, 0, 1, 0 // alpha
};

Parameters:

colorFilterMatrix -

simulateClickColorFilter

public void simulateClickColorFilter(long delay)

Simulate the color filter that will be enabled and disabled, like on a real click event

simulateClickColorFilter

public void simulateClickColorFilter()

Simulates the color filter with the default delay