Summary: Nested Classes | Constants | Ctors | Methods | Protected Methods | Inherited Methods

MaterialShapeDrawable

public class MaterialShapeDrawable
extends Drawable implements TintAwareDrawable, Shapeable

java.lang.Object
↳	android.graphics.drawable.Drawable
	↳	com.google.android.material.shape.MaterialShapeDrawable

Known direct subclasses ChipDrawable ChipDrawable ChipDrawable contains all the layout and draw logic for Chip.

---

Base drawable class for Material Shapes that handles shadows, elevation, scale and color for a generated path.

Summary

Nested classes
@interface	MaterialShapeDrawable.CompatibilityShadowMode Determines when compatibility shadow is drawn vs.

Constants
int	SHADOW_COMPAT_MODE_ALWAYS Always draw fake shadows, never draw native elevation shadows.
int	SHADOW_COMPAT_MODE_DEFAULT Try to draw native elevation shadows if possible, otherwise use fake shadows.
int	SHADOW_COMPAT_MODE_NEVER Never draw fake shadows.

Public constructors
MaterialShapeDrawable()
MaterialShapeDrawable(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)
MaterialShapeDrawable(ShapePathModel shapePathModel)
MaterialShapeDrawable(ShapeAppearanceModel shapeAppearanceModel)

Public methods
static 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.
static MaterialShapeDrawable	createWithElevationOverlay(Context context) Returns a MaterialShapeDrawable with the elevation overlay functionality initialized, a fill color of colorSurface, and an elevation of 0.
static MaterialShapeDrawable	createWithElevationOverlay(Context context, float elevation, ColorStateList backgroundTint) Returns a MaterialShapeDrawable with the elevation overlay functionality initialized, a fill color of backgroundTint, and an elevation of elevation.
void	draw(Canvas canvas)
int	getAlpha()
float	getBottomLeftCornerResolvedSize() Returns the actual size of the bottom left corner for the current bounds.
float	getBottomRightCornerResolvedSize() Returns the actual size of the bottom right corner for the current bounds.
Drawable.ConstantState	getConstantState()
float	getElevation() Returns the elevation used to render both fake shadows when requiresCompatShadow() is true and elevation overlays.
ColorStateList	getFillColor() Get the color used for the fill.
float	getInterpolation() Get the interpolation of the path, between 0 and 1.
int	getOpacity()
void	getOutline(Outline outline)
boolean	getPadding(Rect padding)
Paint.Style	getPaintStyle() Get the current style used by the shape's paint.
float	getParentAbsoluteElevation() Returns the parent absolute elevation.
void	getPathForSize(int width, int height, Path path) This method is deprecated. see ShapeAppearancePathProvider
int	getResolvedTintColor() Get the tint color factoring in any other runtime modifications such as elevation overlays.
float	getScale() Get the scale of the rendered path.
int	getShadowCompatRotation() Returns the rotation offset applied to the fake shadow which is drawn when requiresCompatShadow() is true.
int	getShadowCompatibilityMode()
int	getShadowElevation() This method is deprecated. use getElevation() instead.
int	getShadowOffsetX() Returns the X offset of the shadow from the bounds of the shape.
int	getShadowOffsetY() Returns the Y offset of the shadow from the bounds of the shape.
int	getShadowRadius() Get the shadow radius rendered by the path in pixels.
ShapeAppearanceModel	getShapeAppearanceModel() Get the ShapeAppearanceModel containing the path that will be rendered in this drawable.
ShapePathModel	getShapedViewModel() This method is deprecated. Use getShapeAppearanceModel() instead.
ColorStateList	getStrokeColor() Get the color used for the stroke.
ColorStateList	getStrokeTintList() Get the stroke's current ColorStateList.
float	getStrokeWidth() Get the stroke width used by the shape's paint.
ColorStateList	getTintList() Get the tint list used by the shape's paint.
float	getTopLeftCornerResolvedSize() Returns the actual size of the top left corner for the current bounds.
float	getTopRightCornerResolvedSize() Returns the actual size of the top right corner for the current bounds.
float	getTranslationZ() Returns the translationZ used to render both fake shadows when requiresCompatShadow() is true and elevation overlays.
Region	getTransparentRegion()
float	getZ() Returns the visual z position of this drawable, in pixels.
void	initializeElevationOverlay(Context context) Initializes the elevation overlay functionality for this drawable.
void	invalidateSelf()
boolean	isElevationOverlayEnabled() Returns whether the elevation overlay functionality is initialized and enabled in this drawable's theme context.
boolean	isElevationOverlayInitialized() Returns whether the elevation overlay functionality has been initialized for this drawable.
boolean	isPointInTransparentRegion(int x, int y) Determines whether a point is contained within the transparent region of the Drawable.
boolean	isShadowEnabled() This method is deprecated. use getShadowCompatibilityMode() instead
boolean	isStateful()
Drawable	mutate()
boolean	requiresCompatShadow() Returns true if fake shadows should be drawn.
void	setAlpha(int alpha)
void	setColorFilter(ColorFilter colorFilter)
void	setCornerSize(float cornerSize) Updates the corners for the given CornerSize.
void	setCornerSize(CornerSize cornerSize) Updates the corners for the given CornerSize.
void	setEdgeIntersectionCheckEnable(boolean enable)
void	setElevation(float elevation) Sets the elevation used to render both fake shadows when requiresCompatShadow() is true and elevation overlays.
void	setFillColor(ColorStateList fillColor) Set the color used for the fill.
void	setInterpolation(float interpolation) Set the interpolation of the path, between 0 and 1.
void	setPadding(int left, int top, int right, int bottom) Configure the padding of the shape
void	setPaintStyle(Paint.Style paintStyle) Set the style used by the shape's paint.
void	setParentAbsoluteElevation(float parentAbsoluteElevation) Sets the parent absolute elevation, which is used to render elevation overlays.
void	setScale(float scale) Set the scale of the rendered path.
void	setShadowBitmapDrawingEnable(boolean enable)
void	setShadowColor(int shadowColor) Set the color of fake shadow rendered behind the shape.
void	setShadowCompatRotation(int shadowRotation) Set the rotation offset applied to the fake shadow which is drawn when requiresCompatShadow() is true.
void	setShadowCompatibilityMode(int mode) Set the shadow compatibility mode.
void	setShadowElevation(int shadowElevation) This method is deprecated. use setElevation(float) instead.
void	setShadowEnabled(boolean shadowEnabled) This method is deprecated. use setShadowCompatibilityMode(int) instead.
void	setShadowRadius(int shadowRadius) This method is deprecated. use setElevation(float) instead.
void	setShapeAppearanceModel(ShapeAppearanceModel shapeAppearanceModel) Set the ShapeAppearanceModel containing the path that will be rendered in this drawable.
void	setShapedViewModel(ShapePathModel shapedViewModel) This method is deprecated. Use setShapeAppearanceModel(ShapeAppearanceModel) instead.
void	setStroke(float strokeWidth, ColorStateList strokeColor) Set the shape's stroke width and stroke color using a ColorStateList.
void	setStroke(float strokeWidth, int strokeColor) Set the shape's stroke width and stroke color.
void	setStrokeColor(ColorStateList strokeColor) Set the color used for the stroke.
void	setStrokeTint(ColorStateList tintList) Set the shape's stroke ColorStateList
void	setStrokeTint(int tintColor) Set the shape's stroke color.
void	setStrokeWidth(float strokeWidth) Set the stroke width used by the shape's paint.
void	setTint(int tintColor)
void	setTintList(ColorStateList tintList)
void	setTintMode(PorterDuff.Mode tintMode)
void	setTranslationZ(float translationZ) Sets the translationZ used to render both fake shadows when requiresCompatShadow() is true and elevation overlays.
void	setUseTintColorForShadow(boolean useTintColorForShadow) Set whether fake shadow color should match next set tint color.
void	setZ(float z) Sets the visual z position of this view, in pixels.

Protected methods
int	compositeElevationOverlayIfNeeded(int backgroundColor)
RectF	getBoundsAsRectF()
void	onBoundsChange(Rect bounds)
boolean	onStateChange(int[] state)

Inherited methods
From class android.graphics.drawable.Drawable void applyTheme(Resources.Theme arg0) boolean canApplyTheme() void clearColorFilter() final Rect copyBounds() final void copyBounds(Rect arg0) static Drawable createFromPath(String arg0) static Drawable createFromResourceStream(Resources arg0, TypedValue arg1, InputStream arg2, String arg3, BitmapFactory.Options arg4) static Drawable createFromResourceStream(Resources arg0, TypedValue arg1, InputStream arg2, String arg3) static Drawable createFromStream(InputStream arg0, String arg1) static Drawable createFromXml(Resources arg0, XmlPullParser arg1) static Drawable createFromXml(Resources arg0, XmlPullParser arg1, Resources.Theme arg2) static Drawable createFromXmlInner(Resources arg0, XmlPullParser arg1, AttributeSet arg2, Resources.Theme arg3) static Drawable createFromXmlInner(Resources arg0, XmlPullParser arg1, AttributeSet arg2) abstract void draw(Canvas arg0) int getAlpha() final Rect getBounds() Drawable.Callback getCallback() int getChangingConfigurations() ColorFilter getColorFilter() Drawable.ConstantState getConstantState() Drawable getCurrent() Rect getDirtyBounds() void getHotspotBounds(Rect arg0) int getIntrinsicHeight() int getIntrinsicWidth() int getLayoutDirection() final int getLevel() int getMinimumHeight() int getMinimumWidth() abstract int getOpacity() Insets getOpticalInsets() void getOutline(Outline arg0) boolean getPadding(Rect arg0) int[] getState() Region getTransparentRegion() boolean hasFocusStateSpecified() void inflate(Resources arg0, XmlPullParser arg1, AttributeSet arg2, Resources.Theme arg3) void inflate(Resources arg0, XmlPullParser arg1, AttributeSet arg2) void invalidateSelf() boolean isAutoMirrored() boolean isFilterBitmap() boolean isProjected() boolean isStateful() final boolean isVisible() void jumpToCurrentState() Drawable mutate() void onBoundsChange(Rect arg0) boolean onLayoutDirectionChanged(int arg0) boolean onLevelChange(int arg0) boolean onStateChange(int[] arg0) static int resolveOpacity(int arg0, int arg1) void scheduleSelf(Runnable arg0, long arg1) abstract void setAlpha(int arg0) void setAutoMirrored(boolean arg0) void setBounds(int arg0, int arg1, int arg2, int arg3) void setBounds(Rect arg0) final void setCallback(Drawable.Callback arg0) void setChangingConfigurations(int arg0) void setColorFilter(int arg0, PorterDuff.Mode arg1) abstract void setColorFilter(ColorFilter arg0) void setDither(boolean arg0) void setFilterBitmap(boolean arg0) void setHotspot(float arg0, float arg1) void setHotspotBounds(int arg0, int arg1, int arg2, int arg3) final boolean setLayoutDirection(int arg0) final boolean setLevel(int arg0) boolean setState(int[] arg0) void setTint(int arg0) void setTintBlendMode(BlendMode arg0) void setTintList(ColorStateList arg0) void setTintMode(PorterDuff.Mode arg0) boolean setVisible(boolean arg0, boolean arg1) void unscheduleSelf(Runnable arg0)
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait(long arg0, int arg1) final void wait(long arg0) final void wait()
From interface androidx.core.graphics.drawable.TintAwareDrawable abstract void setTint(int arg0) abstract void setTintList(ColorStateList arg0) abstract void setTintMode(PorterDuff.Mode arg0)
From interface com.google.android.material.shape.Shapeable abstract ShapeAppearanceModel getShapeAppearanceModel() Returns the ShapeAppearanceModel used for the shape definition. abstract void setShapeAppearanceModel(ShapeAppearanceModel shapeAppearanceModel) Sets the ShapeAppearanceModel that defines the shape.

Constants

SHADOW_COMPAT_MODE_ALWAYS

public static final 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

public static final 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

public static final 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)

Public constructors

MaterialShapeDrawable

public MaterialShapeDrawable ()

MaterialShapeDrawable

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

Parameters
context	Context
attrs	AttributeSet
defStyleAttr	int
defStyleRes	int

MaterialShapeDrawable

public MaterialShapeDrawable (ShapePathModel shapePathModel)

Parameters
shapePathModel	ShapePathModel

MaterialShapeDrawable

public MaterialShapeDrawable (ShapeAppearanceModel shapeAppearanceModel)

Parameters
shapeAppearanceModel	ShapeAppearanceModel

Public methods

createWithElevationOverlay

public static 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 ElevationOverlayProvider.compositeOverlayIfNeeded(int, float) for information on when the overlay will be active.

Parameters
context	Context
elevation	float

Returns
MaterialShapeDrawable

createWithElevationOverlay

public static MaterialShapeDrawable createWithElevationOverlay (Context context)

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

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

Parameters
context	Context

Returns
MaterialShapeDrawable

createWithElevationOverlay

public static MaterialShapeDrawable createWithElevationOverlay (Context context, 
                float elevation, 
                ColorStateList backgroundTint)

Returns a MaterialShapeDrawable with the elevation overlay functionality initialized, a fill color of backgroundTint, and an elevation of elevation. When backgroundTint is null, colorSurface will be used as default.

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

Parameters
context	Context
elevation	float
backgroundTint	ColorStateList

Returns
MaterialShapeDrawable

draw

public void draw (Canvas canvas)

Parameters
canvas	Canvas

getAlpha

public int getAlpha ()

Returns
int

getBottomLeftCornerResolvedSize

public float getBottomLeftCornerResolvedSize ()

Returns the actual size of the bottom left corner for the current bounds.

Returns
float

getBottomRightCornerResolvedSize

public float getBottomRightCornerResolvedSize ()

Returns the actual size of the bottom right corner for the current bounds.

Returns
float

getConstantState

public Drawable.ConstantState getConstantState ()

Returns
Drawable.ConstantState

getElevation

public float getElevation ()

Returns the elevation used to render both fake shadows when 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.

Returns
float

getFillColor

public ColorStateList getFillColor ()

Get the color used for the fill.

Returns
ColorStateList	the color set on the Paint object responsible for the fill.

getInterpolation

public float getInterpolation ()

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

Returns
float	the interpolation of the path.

getOpacity

public int getOpacity ()

Returns
int

getOutline

public void getOutline (Outline outline)

Parameters
outline	Outline

getPadding

public boolean getPadding (Rect padding)

Parameters
padding	Rect

Returns
boolean

getPaintStyle

public Paint.Style getPaintStyle ()

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

Returns
Paint.Style	current used paint style.

getParentAbsoluteElevation

public float getParentAbsoluteElevation ()

Returns the parent absolute elevation.

Returns
float

getPathForSize

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

This method is deprecated.
see ShapeAppearancePathProvider

Parameters
width	int
height	int
path	Path

getResolvedTintColor

public int getResolvedTintColor ()

Get the tint color factoring in any other runtime modifications such as elevation overlays.

Returns
int

getScale

public float getScale ()

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

Returns
float	the scale of the path.

getShadowCompatRotation

public int getShadowCompatRotation ()

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

Returns
int

getShadowCompatibilityMode

public int getShadowCompatibilityMode ()

Returns
int

getShadowElevation

public int getShadowElevation ()

This method is deprecated.
use getElevation() instead.

Get the shadow elevation rendered by the path.

Returns
int

getShadowOffsetX

public int getShadowOffsetX ()

Returns the X offset of the shadow from the bounds of the shape.

Returns
int

getShadowOffsetY

public int getShadowOffsetY ()

Returns the Y offset of the shadow from the bounds of the shape.

Returns
int

getShadowRadius

public int getShadowRadius ()

Get the shadow radius rendered by the path in pixels. This method should be used only when the actual size of the shadow is required. Usually getElevation() should be used instead to get the actual elevation of this view as it might be different.

Returns
int

getShapeAppearanceModel

public ShapeAppearanceModel getShapeAppearanceModel ()

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

Returns
ShapeAppearanceModel	the current model.

getShapedViewModel

public ShapePathModel getShapedViewModel ()

This method is deprecated.
Use getShapeAppearanceModel() instead.

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

Returns
ShapePathModel	the current model.

getStrokeColor

public ColorStateList getStrokeColor ()

Get the color used for the stroke.

Returns
ColorStateList	the color set on the Paint object responsible for the stroke.

getStrokeTintList

public ColorStateList getStrokeTintList ()

Get the stroke's current ColorStateList.

Returns
ColorStateList	the stroke's current ColorStateList.

getStrokeWidth

public float getStrokeWidth ()

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

Returns
float	the stroke's current width.

getTintList

public ColorStateList getTintList ()

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

Returns
ColorStateList

getTopLeftCornerResolvedSize

public float getTopLeftCornerResolvedSize ()

Returns the actual size of the top left corner for the current bounds.

Returns
float

getTopRightCornerResolvedSize

public float getTopRightCornerResolvedSize ()

Returns the actual size of the top right corner for the current bounds.

Returns
float

getTranslationZ

public float getTranslationZ ()

Returns the translationZ used to render both fake shadows when 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.

Returns
float

getTransparentRegion

public Region getTransparentRegion ()

Returns
Region

getZ

public float getZ ()

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

Returns
float

initializeElevationOverlay

public void initializeElevationOverlay (Context context)

Initializes the elevation overlay functionality for this drawable.

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

Parameters
context	Context

invalidateSelf

public void invalidateSelf ()

isElevationOverlayEnabled

public boolean isElevationOverlayEnabled ()

Returns whether the elevation overlay functionality is initialized and enabled in this drawable's theme context.

Returns
boolean

isElevationOverlayInitialized

public boolean isElevationOverlayInitialized ()

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

Returns
boolean

isPointInTransparentRegion

public 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.

Parameters
x	int: The X coordinate of the point.
y	int: The Y coordinate of the point.

Returns
boolean	true iff the point is contained in the transparent region of the Drawable.

isShadowEnabled

public boolean isShadowEnabled ()

This method is deprecated.
use getShadowCompatibilityMode() instead

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

Returns
boolean	true if fake shadows should be drawn, false otherwise.

isStateful

public boolean isStateful ()

Returns
boolean

mutate

public Drawable mutate ()

Returns
Drawable

requiresCompatShadow

public boolean requiresCompatShadow ()

Returns true if fake shadows should be drawn. Native elevation shadows can't be drawn on API < 21 or when the shape is concave.

Returns
boolean

setAlpha

public void setAlpha (int alpha)

Parameters
alpha	int

setColorFilter

public void setColorFilter (ColorFilter colorFilter)

Parameters
colorFilter	ColorFilter

setCornerSize

public void setCornerSize (float cornerSize)

Updates the corners for the given CornerSize.

Parameters
cornerSize	float

setCornerSize

public void setCornerSize (CornerSize cornerSize)

Updates the corners for the given CornerSize.

Parameters
cornerSize	CornerSize

setEdgeIntersectionCheckEnable

public void setEdgeIntersectionCheckEnable (boolean enable)

Parameters
enable	boolean

setElevation

public void setElevation (float elevation)

Sets the elevation used to render both fake shadows when 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.

Parameters
elevation	float

setFillColor

public void setFillColor (ColorStateList fillColor)

Set the color used for the fill.

Parameters
fillColor	ColorStateList: the color set on the Paint object responsible for the fill.

setInterpolation

public 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.

Parameters
interpolation	float: the desired interpolation.

setPadding

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

Configure the padding of the shape

Parameters
left	int: Left padding of the shape
top	int: Top padding of the shape
right	int: Right padding of the shape
bottom	int: Bottom padding of the shape

setPaintStyle

public void setPaintStyle (Paint.Style paintStyle)

Set the style used by the shape's paint.

Parameters
paintStyle	Paint.Style: the desired style.

setParentAbsoluteElevation

public void setParentAbsoluteElevation (float parentAbsoluteElevation)

Sets the parent absolute elevation, which is used to render elevation overlays.

Parameters
parentAbsoluteElevation	float

setScale

public void setScale (float scale)

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

Parameters
scale	float: the desired scale.

setShadowBitmapDrawingEnable

public void setShadowBitmapDrawingEnable (boolean enable)

Parameters
enable	boolean

setShadowColor

public void setShadowColor (int shadowColor)

Set the color of fake shadow rendered behind the shape. This will only be drawn when 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.

Parameters
shadowColor	int: desired color.

setShadowCompatRotation

public void setShadowCompatRotation (int shadowRotation)

Set the rotation offset applied to the fake shadow which is drawn when 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.

Parameters
shadowRotation	int

setShadowCompatibilityMode

public 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 ViewGroup.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.

Parameters
mode	int

setShadowElevation

public void setShadowElevation (int shadowElevation)

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

Set the shadow elevation rendered by the path.

Parameters
shadowElevation	int: the desired elevation.

setShadowEnabled

public void setShadowEnabled (boolean shadowEnabled)

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

Set shadow rendering to be enabled or disabled when 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.

Parameters
shadowEnabled	boolean: true if fake shadows should be drawn; false if not.

setShadowRadius

public void setShadowRadius (int shadowRadius)

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

Set the shadow radius rendered by the path.

Parameters
shadowRadius	int: the desired shadow radius.

setShapeAppearanceModel

public void setShapeAppearanceModel (ShapeAppearanceModel shapeAppearanceModel)

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

Parameters
shapeAppearanceModel	ShapeAppearanceModel: the desired model.

setShapedViewModel

public 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.

Parameters
shapedViewModel	ShapePathModel: the desired model.

setStroke

public void setStroke (float strokeWidth, 
                ColorStateList strokeColor)

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

Parameters
strokeWidth	float: a float for the width of the stroke.
strokeColor	ColorStateList: the ColorStateList for the shape's stroke.

setStroke

public void setStroke (float strokeWidth, 
                int strokeColor)

Set the shape's stroke width and stroke color.

Parameters
strokeWidth	float: a float for the width of the stroke.
strokeColor	int: an int representing the Color to use for the shape's stroke.

setStrokeColor

public void setStrokeColor (ColorStateList strokeColor)

Set the color used for the stroke.

Parameters
strokeColor	ColorStateList: the color set on the Paint object responsible for the stroke.

setStrokeTint

public void setStrokeTint (ColorStateList tintList)

Set the shape's stroke ColorStateList

Parameters
tintList	ColorStateList: the ColorStateList for the shape's stroke.

setStrokeTint

public void setStrokeTint (int tintColor)

Set the shape's stroke color.

Parameters
tintColor	int: an int representing the Color to use for the shape's stroke.

setStrokeWidth

public void setStrokeWidth (float strokeWidth)

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

Parameters
strokeWidth	float: desired stroke width.

setTint

public void setTint (int tintColor)

Parameters
tintColor	int

setTintList

public void setTintList (ColorStateList tintList)

Parameters
tintList	ColorStateList

setTintMode

public void setTintMode (PorterDuff.Mode tintMode)

Parameters
tintMode	PorterDuff.Mode

setTranslationZ

public void setTranslationZ (float translationZ)

Sets the translationZ used to render both fake shadows when 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.

Parameters
translationZ	float

setUseTintColorForShadow

public void setUseTintColorForShadow (boolean useTintColorForShadow)

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

Parameters
useTintColorForShadow	boolean: true if color should match; false otherwise.

setZ

public 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.

Parameters
z	float

Protected methods

compositeElevationOverlayIfNeeded

protected int compositeElevationOverlayIfNeeded (int backgroundColor)

Parameters
backgroundColor	int

Returns
int

getBoundsAsRectF

protected RectF getBoundsAsRectF ()

Returns
RectF

onBoundsChange

protected void onBoundsChange (Rect bounds)

Parameters
bounds	Rect

onStateChange

protected boolean onStateChange (int[] state)

Parameters
state	int

Returns
boolean