# Shader
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Ctors](https://developer.android.com/reference/android/graphics/Shader#pubctors)\|[Methods](https://developer.android.com/reference/android/graphics/Shader#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/graphics/Shader#inhmethods)
# Shader
*** ** * ** ***
[Kotlin](https://developer.android.com/reference/kotlin/android/graphics/Shader "View this page in Kotlin")\|Java
`
public
class
Shader
`
`
extends `[Object](https://developer.android.com/reference/java/lang/Object)`
``
`
|---|-------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.graphics.Shader |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known direct subclasses [BitmapShader](https://developer.android.com/reference/android/graphics/BitmapShader),[ComposeShader](https://developer.android.com/reference/android/graphics/ComposeShader),[LinearGradient](https://developer.android.com/reference/android/graphics/LinearGradient),[RadialGradient](https://developer.android.com/reference/android/graphics/RadialGradient),[RuntimeShader](https://developer.android.com/reference/android/graphics/RuntimeShader),[SweepGradient](https://developer.android.com/reference/android/graphics/SweepGradient) |-------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [BitmapShader](https://developer.android.com/reference/android/graphics/BitmapShader) | Shader used to draw a bitmap as a texture. | | [ComposeShader](https://developer.android.com/reference/android/graphics/ComposeShader) | A subclass of shader that returns the composition of two other shaders, combined by an[Xfermode](https://developer.android.com/reference/android/graphics/Xfermode)subclass. | | [LinearGradient](https://developer.android.com/reference/android/graphics/LinearGradient) | | | [RadialGradient](https://developer.android.com/reference/android/graphics/RadialGradient) | | | [RuntimeShader](https://developer.android.com/reference/android/graphics/RuntimeShader) | A[RuntimeShader](https://developer.android.com/reference/android/graphics/RuntimeShader)calculates a per-pixel color based on the output of a user defined Android Graphics Shading Language (AGSL) function. | | [SweepGradient](https://developer.android.com/reference/android/graphics/SweepGradient) | | |
*** ** * ** ***
Shader is the base class for objects that return horizontal spans of colors during drawing. A subclass of Shader is installed in a Paint calling paint.setShader(shader). After that any object (other than a bitmap) that is drawn with that paint will get its color(s) from the shader.
## Summary
| ### Public constructors ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[Shader](https://developer.android.com/reference/android/graphics/Shader#Shader())`() ` *This constructor is deprecated. Use subclass constructors directly instead.* |
| ### Public methods ||
|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` boolean` | ` `[getLocalMatrix](https://developer.android.com/reference/android/graphics/Shader#getLocalMatrix(android.graphics.Matrix))`(`[Matrix](https://developer.android.com/reference/android/graphics/Matrix)` localM) ` Return true if the shader has a non-identity local matrix. |
| ` void` | ` `[setLocalMatrix](https://developer.android.com/reference/android/graphics/Shader#setLocalMatrix(android.graphics.Matrix))`(`[Matrix](https://developer.android.com/reference/android/graphics/Matrix)` localM) ` Set the shader's local matrix. |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
## Public constructors
### Shader
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Shader ()
```
**This constructor is deprecated.**
Use subclass constructors directly instead.
## Public methods
### getLocalMatrix
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean getLocalMatrix (Matrix localM)
```
Return true if the shader has a non-identity local matrix.
| Parameters ||
|----------|---------------------------------------------------------------------------------------------|
| `localM` | `Matrix`: Set to the local matrix of the shader, if the shader's matrix is non-null.
|
| Returns ||
|-----------|-----------------------------------------------------------|
| `boolean` | true if the shader has a non-identity local matrix
|
### setLocalMatrix
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setLocalMatrix (Matrix localM)
```
Set the shader's local matrix. Passing null will reset the shader's matrix to identity. If the matrix has scale value as 0, the drawing result is undefined.
| Parameters ||
|----------|-----------------------------------------------------------------------------|
| `localM` | `Matrix`: The shader's new local matrix, or null to specify identity
|