MaterialShapeDrawable

SHADOW_COMPAT_MODE_ALWAYS

int SHADOW_COMPAT_MODE_ALWAYS

Always draw fake shadows, never draw native elevation shadows. If a path could be concave, this will prevent the shadow from suddenly being rendered natively.

Constant Value: 2 (0x00000002)

SHADOW_COMPAT_MODE_DEFAULT

int SHADOW_COMPAT_MODE_DEFAULT

Try to draw native elevation shadows if possible, otherwise use fake shadows. This is best for paths which will always be convex. If the path might change to be concave, you should consider using SHADOW_COMPAT_MODE_ALWAYS otherwise the shadows could suddenly switch from native to fake in the middle of an animation.

Constant Value: 0 (0x00000000)

SHADOW_COMPAT_MODE_NEVER

int SHADOW_COMPAT_MODE_NEVER

Never draw fake shadows. You may want to enable this if backwards compatibility for shadows isn't as important as performance. Native shadow elevation shadows will still be drawn if possible.

Constant Value: 1 (0x00000001)

MaterialShapeDrawable

MaterialShapeDrawable ()

MaterialShapeDrawable

MaterialShapeDrawable (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

MaterialShapeDrawable

MaterialShapeDrawable (ShapeAppearanceModel shapeAppearanceModel)

createWithElevationOverlay

MaterialShapeDrawable createWithElevationOverlay (Context context, 
                float elevation)

Returns a MaterialShapeDrawable with the elevation overlay functionality initialized, a fill color of colorSurface, and an elevation of elevation.

See layerOverlayIfNeeded(int, float) for information on when the overlay will be active.

createWithElevationOverlay

MaterialShapeDrawable createWithElevationOverlay (Context context)

Returns a MaterialShapeDrawable with the elevation overlay functionality initialized, a fill color of colorSurface, and an elevation of 0.

See layerOverlayIfNeeded(int, float) for information on when the overlay will be active.

draw

void draw (Canvas canvas)

getConstantState

Drawable.ConstantState getConstantState ()

getElevation

float getElevation ()

Returns the elevation used to render both fake shadows when ERROR(/#requiresCompatShadow()) is true and elevation overlays. This value is the same as the native elevation that would be used to render shadows on API 21 and up.

getFillColor

ColorStateList getFillColor ()

Get the color used for the fill.

getInterpolation

float getInterpolation ()

Get the interpolation of the path, between 0 and 1. Ranges between 0 (none) and 1 (fully) interpolated.

getOpacity

int getOpacity ()

getOutline

void getOutline (Outline outline)

getPadding

boolean getPadding (Rect padding)

getPaintStyle

Paint.Style getPaintStyle ()

Get the current style used by the shape's paint.

getPathForSize

void getPathForSize (Rect bounds, 
                Path path)

This method is deprecated.
see ShapeAppearancePathProvider

getPathForSize

void getPathForSize (int width, 
                int height, 
                Path path)

This method is deprecated.
see ShapeAppearancePathProvider

getScale

float getScale ()

Get the scale of the rendered path. A value of 1 renders it at 100% size.

getShadowCompatRotation

int getShadowCompatRotation ()

Returns the rotation offset applied to the fake shadow which is drawn when ERROR(/#requiresCompatShadow()) is true.

getShadowCompatibilityMode

int getShadowCompatibilityMode ()

getShadowElevation

int getShadowElevation ()

This method is deprecated.
use getElevation() instead.

Get the shadow elevation rendered by the path.

getShadowRadius

int getShadowRadius ()

This method is deprecated.
use getElevation() instead.

Get the shadow radius rendered by the path.

getShapeAppearanceModel

ShapeAppearanceModel getShapeAppearanceModel ()

Get the ShapeAppearanceModel containing the path that will be rendered in this drawable.

getShapedViewModel

ShapeAppearanceModel getShapedViewModel ()

This method is deprecated.
Use getShapeAppearanceModel() instead.

Get the ShapePathModel containing the path that will be rendered in this drawable.

getStrokeColor

ColorStateList getStrokeColor ()

Get the color used for the stroke.

getStrokeTint

int getStrokeTint ()

This method is deprecated.
Use getStrokeTintList() instead.

Get the int representing the Color of the shape's stroke in the current state.

getStrokeTintList

ColorStateList getStrokeTintList ()

Get the stroke's current ColorStateList.

getStrokeWidth

float getStrokeWidth ()

Get the stroke width used by the shape's paint.

getTintList

ColorStateList getTintList ()

Get the tint list used by the shape's paint.

getTranslationZ

float getTranslationZ ()

Returns the translationZ used to render both fake shadows when ERROR(/#requiresCompatShadow()) is true and elevation overlays. This value is the same as the native translationZ that would be used to render shadows on API 21 and up.

getTransparentRegion

Region getTransparentRegion ()

getZ

float getZ ()

Returns the visual z position of this drawable, in pixels. This is equivalent to the translationZ property plus the current elevation property.

initializeElevationOverlay

void initializeElevationOverlay (Context context)

Initializes the elevation overlay functionality for this drawable.

See layerOverlayIfNeeded(int, float) for information on when the overlay will be active.

invalidateSelf

void invalidateSelf ()

isElevationOverlayInitialized

boolean isElevationOverlayInitialized ()

Returns whether the elevation overlay functionality has been initialized for this drawable.

isPointInTransparentRegion

boolean isPointInTransparentRegion (int x, 
                int y)

Determines whether a point is contained within the transparent region of the Drawable. A return value of true generally suggests that the touched view should not process a touch event at that point.

isShadowEnabled

boolean isShadowEnabled ()

This method is deprecated.
use getShadowCompatibilityMode() instead

Get shadow rendering status for shadows when ERROR(/#requiresCompatShadow()) is true.

isStateful

boolean isStateful ()

mutate

Drawable mutate ()

onShapeAppearanceModelChanged

void onShapeAppearanceModelChanged ()

Callback invoked when a corner or edge of the ShapeAppearanceModel changes.

setAlpha

void setAlpha (int alpha)

setColorFilter

void setColorFilter (ColorFilter colorFilter)

setCornerRadius

void setCornerRadius (float cornerRadius)

setElevation

void setElevation (float elevation)

Sets the elevation used to render both fake shadows when ERROR(/#requiresCompatShadow()) is true and elevation overlays. This value is the same as the native elevation that would be used to render shadows on API 21 and up.

setFillColor

void setFillColor (ColorStateList fillColor)

Set the color used for the fill.

setInterpolation

void setInterpolation (float interpolation)

Set the interpolation of the path, between 0 and 1. Ranges between 0 (none) and 1 (fully) interpolated. An interpolation of 1 generally indicates a fully rendered path, while an interpolation of 0 generally indicates a fully healed path, which is usually a rectangle.

setPadding

void setPadding (int left, 
                int top, 
                int right, 
                int bottom)

Configure the padding of the shape

setPaintStyle

void setPaintStyle (Paint.Style paintStyle)

Set the style used by the shape's paint.

setScale

void setScale (float scale)

Set the scale of the rendered path. A value of 1 renders it at 100% size.

setShadowColor

void setShadowColor (int shadowColor)

Set the color of fake shadow rendered behind the shape. This will only be drawn when ERROR(/#requiresCompatShadow()) is true, otherwise native elevation shadows will be drawn which don't support colored shadows.

Setting a shadow color will prevent the tint color from being used.

setShadowCompatRotation

void setShadowCompatRotation (int shadowRotation)

Set the rotation offset applied to the fake shadow which is drawn when ERROR(/#requiresCompatShadow()) is true. 0 degrees will draw the shadow below the shape.

This allows for the Drawable to be wrapped in a RotateDrawable, or rotated in a view while still having the fake shadow to appear to be drawn from the bottom.

setShadowCompatibilityMode

void setShadowCompatibilityMode (int mode)

Set the shadow compatibility mode. This allows control over when fake shadows should drawn instead of native elevation shadows.

Note: To prevent clipping of fake shadow for views on API levels above lollipop, the parent view must disable clipping of children by calling setClipChildren(boolean), or by setting `android:clipChildren="false"` in xml. `clipToPadding` may also need to be false if there is any padding on the parent that could intersect the shadow.

setShadowElevation

void setShadowElevation (int shadowElevation)

This method is deprecated.
use setElevation(float) instead.

Set the shadow elevation rendered by the path.

setShadowEnabled

void setShadowEnabled (boolean shadowEnabled)

This method is deprecated.
use setShadowCompatibilityMode(int) instead.

Set shadow rendering to be enabled or disabled when ERROR(/#requiresCompatShadow()) is true. Setting this to false could provide some performance benefits on older devices if you don't mind no shadows being drawn.

Note: native elevation shadows will still be drawn on API 21 and up if the shape is convex and the view with this background has elevation.

setShadowRadius

void setShadowRadius (int shadowRadius)

This method is deprecated.
use setElevation(float) instead.

Set the shadow radius rendered by the path.

setShapeAppearanceModel

void setShapeAppearanceModel (ShapeAppearanceModel shapeAppearanceModel)

Set the ShapeAppearanceModel containing the path that will be rendered in this drawable.

setShapedViewModel

void setShapedViewModel (ShapePathModel shapedViewModel)

This method is deprecated.
Use setShapeAppearanceModel(ShapeAppearanceModel) instead.

Set the ShapePathModel containing the path that will be rendered in this drawable.

setStroke

void setStroke (float strokeWidth, 
                ColorStateList strokeColor)

Set the shape's stroke width and stroke color using a ColorStateList.

setStroke

void setStroke (float strokeWidth, 
                int strokeColor)

Set the shape's stroke width and stroke color.

setStrokeColor

void setStrokeColor (ColorStateList strokeColor)

Set the color used for the stroke.

setStrokeTint

void setStrokeTint (ColorStateList tintList)

Set the shape's stroke ColorStateList

setStrokeTint

void setStrokeTint (int tintColor)

Set the shape's stroke color.

setStrokeWidth

void setStrokeWidth (float strokeWidth)

Set the stroke width used by the shape's paint.

setTint

void setTint (int tintColor)

setTintList

void setTintList (ColorStateList tintList)

setTintMode

void setTintMode (PorterDuff.Mode tintMode)

setTranslationZ

void setTranslationZ (float translationZ)

Sets the translationZ used to render both fake shadows when ERROR(/#requiresCompatShadow()) is true and elevation overlays. This value is the same as the native translationZ that would be used to render shadows on API 21 and up.

setUseTintColorForShadow

void setUseTintColorForShadow (boolean useTintColorForShadow)

Set whether fake shadow color should match next set tint color. This will only be drawn when ERROR(/#requiresCompatShadow()) is true, otherwise native elevation shadows will be drawn which don't support colored shadows.

setZ

void setZ (float z)

Sets the visual z position of this view, in pixels. This is equivalent to setting the translationZ property to be the difference between the z value passed in and the current elevation property.

getBoundsAsRectF

RectF getBoundsAsRectF ()

onBoundsChange

void onBoundsChange (Rect bounds)

onStateChange

boolean onStateChange (int[] state)