processing4/core/src/processing/core/PMatrix.java at main · processing/processing4 · GitHub

History

212 lines (160 loc) · 5.95 KB

Raw

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

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */

Part of the Processing project - http://processing.org

This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General

Public License along with this library; if not, write to the

Free Software Foundation, Inc., 59 Temple Place, Suite 330,

Boston, MA 02111-1307 USA

package processing.core;

/**

* A matrix is used to define graphical transformations. PMatrix is the common

* interface for both the 2D and 3D matrix classes in Processing. A matrix is a

* grid of numbers, which can be multiplied by a vector to give another vector.

* Multiplying a point by a particular matrix might translate it, rotate it,

* or carry out a combination of transformations.

* Multiplying matrices by each other combines their effects; use the

* {@code apply} and {@code preApply} methods for this.

public interface PMatrix {

/**

* Make this an identity matrix. Multiplying by it will have no effect.

public void reset();

/**

* Returns a copy of this PMatrix.

public PMatrix get();

/**

* Copies the matrix contents into a float array.

* If target is null (or not the correct size), a new array will be created.

public float[] get(float[] target);

/**

* Make this matrix become a copy of src.

public void set(PMatrix src);

/**

* Set the contents of this matrix to the contents of source. Fills the

* matrix left-to-right, starting in the top row.

public void set(float[] source);

/**

* Set the matrix content to this 2D matrix or its 3D equivalent.

public void set(float m00, float m01, float m02,

float m10, float m11, float m12);

/**

* Set the matrix content to the 3D matrix supplied, if this matrix is 3D.

public void set(float m00, float m01, float m02, float m03,

float m10, float m11, float m12, float m13,

float m20, float m21, float m22, float m23,

float m30, float m31, float m32, float m33);

public void translate(float tx, float ty);

public void translate(float tx, float ty, float tz);

public void rotate(float angle);

public void rotateX(float angle);

public void rotateY(float angle);

public void rotateZ(float angle);

public void rotate(float angle, float v0, float v1, float v2);

public void scale(float s);

public void scale(float sx, float sy);

public void scale(float x, float y, float z);

public void shearX(float angle);

public void shearY(float angle);

/**