mirrors/weston
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
80f9163ad6
weston/shared/matrix.h

83 lines
2.5 KiB
C
Raw Normal View History

compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
/*
* Copyright © 2008-2011 Kristian Høgsberg
compositor: implement inverse matrix transformation Implement 4x4 matrix inversion based on LU-decomposition with partial pivoting. Instead of simply computing the inverse matrix explicitly, introduce the type struct weston_inverse_matrix for storing the LU-decomposition and the permutation from pivoting. Using doubles, this struct has greater precision than struct weston_matrix. If you need only few (less than 5, presumably) multiplications with the inverse matrix, is it cheaper to use weston_inverse_matrix, and not compute the inverse matrix explicitly into a weston_matrix. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-16 16:27:00 +04:00
* Copyright © 2012 Collabora, Ltd.
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
*
* Permission to use, copy, modify, distribute, and sell this software and
* its documentation for any purpose is hereby granted without fee, provided
* that the above copyright notice appear in all copies and that both that
* copyright notice and this permission notice appear in supporting
* documentation, and that the name of the copyright holders not be used in
* advertising or publicity pertaining to distribution of the software
* without specific, written prior permission. The copyright holders make
* no representations about the suitability of this software for any
* purpose. It is provided "as is" without express or implied warranty.
*
* THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
* SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
* FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
* SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
* RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
* CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef WESTON_MATRIX_H
#define WESTON_MATRIX_H
sdk: be C++ friendly This renames the weston_surface's private member to configure_private and externs "C" the headers of the SDK.
2013-03-28 21:02:42 +04:00
#ifdef __cplusplus
extern "C" {
#endif
matrix: track transform type Introduce several matrix transform types and track type for matrix. Could be usefull for activating some fastpath that depends on some transform type. Signed-off-by: Vasily Khoruzhick <anarsoul@gmail.com>
2013-01-28 23:40:28 +04:00
enum weston_matrix_transform_type {
WESTON_MATRIX_TRANSFORM_TRANSLATE = (1 << 0),
WESTON_MATRIX_TRANSFORM_SCALE = (1 << 1),
WESTON_MATRIX_TRANSFORM_ROTATE = (1 << 2),
WESTON_MATRIX_TRANSFORM_OTHER = (1 << 3),
};
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
struct weston_matrix {
weston: Use float instead of GLfloat.
2012-09-30 04:57:21 +04:00
float d[16];
matrix: track transform type Introduce several matrix transform types and track type for matrix. Could be usefull for activating some fastpath that depends on some transform type. Signed-off-by: Vasily Khoruzhick <anarsoul@gmail.com>
2013-01-28 23:40:28 +04:00
unsigned int type;
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
};
struct weston_vector {
weston: Use float instead of GLfloat.
2012-09-30 04:57:21 +04:00
float f[4];
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
};
void
weston_matrix_init(struct weston_matrix *matrix);
void
weston_matrix_multiply(struct weston_matrix *m, const struct weston_matrix *n);
void
weston: Use float instead of GLfloat.
2012-09-30 04:57:21 +04:00
weston_matrix_scale(struct weston_matrix *matrix, float x, float y, float z);
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
void
weston_matrix_translate(struct weston_matrix *matrix,
weston: Use float instead of GLfloat.
2012-09-30 04:57:21 +04:00
float x, float y, float z);
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
void
matrix: track transform type Introduce several matrix transform types and track type for matrix. Could be usefull for activating some fastpath that depends on some transform type. Signed-off-by: Vasily Khoruzhick <anarsoul@gmail.com>
2013-01-28 23:40:28 +04:00
weston_matrix_rotate_xy(struct weston_matrix *matrix, float cos, float sin);
void
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
weston_matrix_transform(struct weston_matrix *matrix, struct weston_vector *v);
compositor: drop inverse matrix from weston_transform Remove the inverse matrix member from struct weston_transform. It is easier (and probably faster, too) to create and store only forward transformation matrices in a list, multiply them once, and then invert the final matrix, rather than creating both forward and inverse matrices, and multiplying both. Add a stub for the 4x4 matrix inversion function. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 17:00:57 +04:00
int
compositor: simplify the matrix inversion API The compositor will likely do an order of magnitude less matrix inversions than point transformations with an inverse, hence we do not really need the optimised path for single-shot invert-and-transform. Expose only the computing of the explicit inverse matrix in the API. However, the matrix inversion tests need access to the internal functions. Designate a unit test build by #defining UNIT_TEST, and export the internal functions in that case. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-20 12:47:57 +04:00
weston_matrix_invert(struct weston_matrix *inverse,
compositor: drop inverse matrix from weston_transform Remove the inverse matrix member from struct weston_transform. It is easier (and probably faster, too) to create and store only forward transformation matrices in a list, multiply them once, and then invert the final matrix, rather than creating both forward and inverse matrices, and multiplying both. Add a stub for the 4x4 matrix inversion function. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 17:00:57 +04:00
const struct weston_matrix *matrix);
compositor: simplify the matrix inversion API The compositor will likely do an order of magnitude less matrix inversions than point transformations with an inverse, hence we do not really need the optimised path for single-shot invert-and-transform. Expose only the computing of the explicit inverse matrix in the API. However, the matrix inversion tests need access to the internal functions. Designate a unit test build by #defining UNIT_TEST, and export the internal functions in that case. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-20 12:47:57 +04:00
#ifdef UNIT_TEST
# define MATRIX_TEST_EXPORT WL_EXPORT
int
matrix_invert(double *A, unsigned *p, const struct weston_matrix *matrix);
compositor: implement inverse matrix transformation Implement 4x4 matrix inversion based on LU-decomposition with partial pivoting. Instead of simply computing the inverse matrix explicitly, introduce the type struct weston_inverse_matrix for storing the LU-decomposition and the permutation from pivoting. Using doubles, this struct has greater precision than struct weston_matrix. If you need only few (less than 5, presumably) multiplications with the inverse matrix, is it cheaper to use weston_inverse_matrix, and not compute the inverse matrix explicitly into a weston_matrix. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-16 16:27:00 +04:00
void
weston: Use float instead of GLfloat.
2012-09-30 04:57:21 +04:00
inverse_transform(const double *LU, const unsigned *p, float *v);
compositor: simplify the matrix inversion API The compositor will likely do an order of magnitude less matrix inversions than point transformations with an inverse, hence we do not really need the optimised path for single-shot invert-and-transform. Expose only the computing of the explicit inverse matrix in the API. However, the matrix inversion tests need access to the internal functions. Designate a unit test build by #defining UNIT_TEST, and export the internal functions in that case. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-20 12:47:57 +04:00
#else
# define MATRIX_TEST_EXPORT static
#endif
compositor: drop inverse matrix from weston_transform Remove the inverse matrix member from struct weston_transform. It is easier (and probably faster, too) to create and store only forward transformation matrices in a list, multiply them once, and then invert the final matrix, rather than creating both forward and inverse matrices, and multiplying both. Add a stub for the 4x4 matrix inversion function. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 17:00:57 +04:00
sdk: be C++ friendly This renames the weston_surface's private member to configure_private and externs "C" the headers of the SDK.
2013-03-28 21:02:42 +04:00
#ifdef __cplusplus
}
#endif
compositor: move matrix code to separate files Move matrix code to separate files to allow writing unit tests for it. Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
2012-01-12 16:30:47 +04:00
#endif /* WESTON_MATRIX_H */
Reference in New Issue Copy Permalink