modedb: fix vrefresh for ilace
[android/external-libkmsxx.git] / kmscube / esTransform.h
1 //
2 // Book:      OpenGL(R) ES 2.0 Programming Guide
3 // Authors:   Aaftab Munshi, Dan Ginsburg, Dave Shreiner
4 // ISBN-10:   0321502795
5 // ISBN-13:   9780321502797
6 // Publisher: Addison-Wesley Professional
7 // URLs:      http://safari.informit.com/9780321563835
8 //            http://www.opengles-book.com
9 //
11 /*
12  * (c) 2009 Aaftab Munshi, Dan Ginsburg, Dave Shreiner
13  *
14  * Permission is hereby granted, free of charge, to any person obtaining a
15  * copy of this software and associated documentation files (the "Software"),
16  * to deal in the Software without restriction, including without limitation
17  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
18  * and/or sell copies of the Software, and to permit persons to whom the
19  * Software is furnished to do so, subject to the following conditions:
20  *
21  * The above copyright notice and this permission notice shall be included
22  * in all copies or substantial portions of the Software.
23  *
24  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
25  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
27  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
28  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
29  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
30  * DEALINGS IN THE SOFTWARE.
31  */
33 //
34 /// \file ESUtil.h
35 /// \brief A utility library for OpenGL ES.  This library provides a
36 ///        basic common framework for the example applications in the
37 ///        OpenGL ES 2.0 Programming Guide.
38 //
39 #ifndef ESUTIL_H
40 #define ESUTIL_H
42 ///
43 //  Includes
44 //
45 #include <GLES2/gl2.h>
46 #include <EGL/egl.h>
48 #ifdef __cplusplus
50 extern "C" {
51 #endif
53 typedef struct
54 {
55         GLfloat   m[4][4];
56 } ESMatrix;
58 //
59 /// \brief multiply matrix specified by result with a scaling matrix and return new matrix in result
60 /// \param result Specifies the input matrix.  Scaled matrix is returned in result.
61 /// \param sx, sy, sz Scale factors along the x, y and z axes respectively
62 //
63 void esScale(ESMatrix *result, GLfloat sx, GLfloat sy, GLfloat sz);
65 //
66 /// \brief multiply matrix specified by result with a translation matrix and return new matrix in result
67 /// \param result Specifies the input matrix.  Translated matrix is returned in result.
68 /// \param tx, ty, tz Scale factors along the x, y and z axes respectively
69 //
70 void esTranslate(ESMatrix *result, GLfloat tx, GLfloat ty, GLfloat tz);
72 //
73 /// \brief multiply matrix specified by result with a rotation matrix and return new matrix in result
74 /// \param result Specifies the input matrix.  Rotated matrix is returned in result.
75 /// \param angle Specifies the angle of rotation, in degrees.
76 /// \param x, y, z Specify the x, y and z coordinates of a vector, respectively
77 //
78 void esRotate(ESMatrix *result, GLfloat angle, GLfloat x, GLfloat y, GLfloat z);
80 //
81 // \brief multiply matrix specified by result with a perspective matrix and return new matrix in result
82 /// \param result Specifies the input matrix.  new matrix is returned in result.
83 /// \param left, right Coordinates for the left and right vertical clipping planes
84 /// \param bottom, top Coordinates for the bottom and top horizontal clipping planes
85 /// \param nearZ, farZ Distances to the near and far depth clipping planes.  Both distances must be positive.
86 //
87 void esFrustum(ESMatrix *result, float left, float right, float bottom, float top, float nearZ, float farZ);
89 //
90 /// \brief multiply matrix specified by result with a perspective matrix and return new matrix in result
91 /// \param result Specifies the input matrix.  new matrix is returned in result.
92 /// \param fovy Field of view y angle in degrees
93 /// \param aspect Aspect ratio of screen
94 /// \param nearZ Near plane distance
95 /// \param farZ Far plane distance
96 //
97 void esPerspective(ESMatrix *result, float fovy, float aspect, float nearZ, float farZ);
99 //
100 /// \brief multiply matrix specified by result with a perspective matrix and return new matrix in result
101 /// \param result Specifies the input matrix.  new matrix is returned in result.
102 /// \param left, right Coordinates for the left and right vertical clipping planes
103 /// \param bottom, top Coordinates for the bottom and top horizontal clipping planes
104 /// \param nearZ, farZ Distances to the near and far depth clipping planes.  These values are negative if plane is behind the viewer
105 //
106 void esOrtho(ESMatrix *result, float left, float right, float bottom, float top, float nearZ, float farZ);
108 //
109 /// \brief perform the following operation - result matrix = srcA matrix * srcB matrix
110 /// \param result Returns multiplied matrix
111 /// \param srcA, srcB Input matrices to be multiplied
112 //
113 void esMatrixMultiply(ESMatrix *result, ESMatrix *srcA, ESMatrix *srcB);
115 //
116 //// \brief return an indentity matrix
117 //// \param result returns identity matrix
118 //
119 void esMatrixLoadIdentity(ESMatrix *result);
121 #ifdef __cplusplus
123 #endif
125 #endif // ESUTIL_H