1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
/*
* Copyright (C) 2006 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.graphics;
/**
* Shader is the based 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.
*/
public class Shader {
/**
* This is set by subclasses, but don't make it public.
*/
private long native_instance;
private long native_with_local_matrix;
/**
* Initialization step that should be called by subclasses in their
* constructors. Calling again may result in memory leaks.
* @hide
*/
protected void init(long ni) {
native_instance = ni;
}
private Matrix mLocalMatrix;
public enum TileMode {
/**
* replicate the edge color if the shader draws outside of its
* original bounds
*/
CLAMP (0),
/**
* repeat the shader's image horizontally and vertically
*/
REPEAT (1),
/**
* repeat the shader's image horizontally and vertically, alternating
* mirror images so that adjacent images always seam
*/
MIRROR (2);
TileMode(int nativeInt) {
this.nativeInt = nativeInt;
}
final int nativeInt;
}
/**
* Return true if the shader has a non-identity local matrix.
* @param localM If not null, it is set to the shader's local matrix.
* @return true if the shader has a non-identity local matrix
*/
public boolean getLocalMatrix(Matrix localM) {
if (mLocalMatrix != null) {
localM.set(mLocalMatrix);
return !mLocalMatrix.isIdentity();
}
return false;
}
/**
* Set the shader's local matrix. Passing null will reset the shader's
* matrix to identity.
*
* Starting with {@link android.os.Build.VERSION_CODES#L}, this does not
* modify any Paints which use this Shader. In order to modify the Paint,
* you need to call {@link Paint#setShader} again. Further, any {@link ComposeShader}s
* created with this Shader will be unaffected.
*
* @param localM The shader's new local matrix, or null to specify identity
*/
public void setLocalMatrix(Matrix localM) {
mLocalMatrix = localM;
native_with_local_matrix = nativeSetLocalMatrix(native_instance,
native_with_local_matrix, localM == null ? 0 : localM.native_instance);
}
protected void finalize() throws Throwable {
try {
super.finalize();
} finally {
nativeDestructor(native_instance, native_with_local_matrix);
}
}
/**
* @hide
*/
protected Shader copy() {
final Shader copy = new Shader();
copyLocalMatrix(copy);
return copy;
}
/**
* @hide
*/
protected void copyLocalMatrix(Shader dest) {
if (mLocalMatrix != null) {
final Matrix lm = new Matrix();
getLocalMatrix(lm);
dest.setLocalMatrix(lm);
} else {
dest.setLocalMatrix(null);
}
}
/* package */ long getNativeInstance() {
if (native_with_local_matrix != 0) {
return native_with_local_matrix;
}
return native_instance;
}
private static native void nativeDestructor(long native_shader, long native_with_local_matrix);
private static native long nativeSetLocalMatrix(long native_shader,
long native_with_local_matrix, long matrix_instance);
}
|
