Back to Seed Clases

Cogl

Classes

Interfaces

Structs

Unions

Enums

Struct Cogl.Matrix

Import line:	Cogl = imports.gi.Cogl;
GIR File:	Cogl-1.0.gir
C documentation:	CoglMatrix
Struct :	Matrix

A CoglMatrix holds a 4x4 transform matrix. This is a single precision,
column-major matrix which means it is compatible with what OpenGL expects.
A CoglMatrix can represent transforms such as, rotations, scaling,
translation, sheering, and linear projections. You can combine these
transforms by multiplying multiple matrices in the order you want them
applied.
The transformation of a vertex (x, y, z, w) by a CoglMatrix is given by:
|[
x_new = xx * x + xy * y + xz * z + xw * w
y_new = yx * x + yy * y + yz * z + yw * w
z_new = zx * x + zy * y + zz * z + zw * w
w_new = wx * x + wy * y + wz * z + ww * w
]|
Where w is normally 1
You must consider the members of the CoglMatrix structure read only,
and all matrix modifications must be done via the cogl_matrix API. This
allows Cogl to annotate the matrices internally. Violation of this will give
undefined results. If you need to initialize a matrix with a constant other
than the identity matrix you can use cogl_matrix_init_from_array().

Properties
Properties		Defined By
	_padding3 : guint32 read only	Cogl.Matrix
	flags : guint32 read only	Cogl.Matrix
	inv : Array read only	Cogl.Matrix
	type : guint32 read only	Cogl.Matrix
	ww : gfloat	Cogl.Matrix
	wx : gfloat	Cogl.Matrix
	wy : gfloat	Cogl.Matrix
	wz : gfloat	Cogl.Matrix
	xw : gfloat	Cogl.Matrix
	xx : gfloat	Cogl.Matrix
	xy : gfloat	Cogl.Matrix
	xz : gfloat	Cogl.Matrix
	yw : gfloat	Cogl.Matrix
	yx : gfloat	Cogl.Matrix
	yy : gfloat	Cogl.Matrix
	yz : gfloat	Cogl.Matrix
	zw : gfloat	Cogl.Matrix
	zx : gfloat	Cogl.Matrix
	zy : gfloat	Cogl.Matrix
	zz : gfloat	Cogl.Matrix

Methods / Constructors
Method / Constructor		Defined By
	new Cogl.Matrix () Create a new Cogl.Matrix Create a new Cogl.Matrix
	free () : none Returns: none	Cogl.Matrix
	frustum (gfloat *left, gfloat right, gfloat bottom, gfloat top, gfloat z_near, gfloat z_far) : none Multiplies matrix* by the given frustum perspective matrix. Multiplies matrix by the given frustum perspective matrix. Parameters: gfloat left Required (not null) coord of left vertical clipping plane gfloat right Required (not null) coord of right vertical clipping plane gfloat bottom Required (not null) coord of bottom horizontal clipping plane gfloat top Required (not null) coord of top horizontal clipping plane gfloat z_near Required (not null) positive distance to near depth clipping plane gfloat z_far Required (not null) positive distance to far depth clipping plane Returns: none	Cogl.Matrix
	get_array () : gfloat Casts matrix to a float array which can be directly passed to OpenGL. Casts matrix to a float array which can be directly passed to OpenGL. Returns: gfloat a pointer to the float array	Cogl.Matrix
	get_inverse (Object *out_values) : gboolean Gets the inverse transform of a given matrix and uses it to initialize a new CoglMatrix. Gets the inverse transform of a given matrix and uses it to initialize a new CoglMatrix. Although the first parameter is annotated as const to indicate that the transform it represents isn't modified this function may technically save a copy of the inverse transform within the given CoglMatrix* so that subsequent requests for the inverse transform may avoid costly inversion calculations. for degenerate transformations that can't be inverted (in this case the Parameters: Object out_values Cogl.Matrix inverse Returns: gboolean TRUE if the inverse was successfully calculated or FALSE	Cogl.Matrix
	init_from_array (gfloat *array) : none Initializes matrix* with the contents of array Initializes matrix with the contents of array Parameters: gfloat array Required (not null) A linear array of 16 floats (column-major order) Returns: none	Cogl.Matrix
	init_identity () : none Resets matrix to the identity matrix: \|[ .xx=1; .xy=0; .xz=0; .xw=0; .yx=0; .yy=1; .yz=0; .yw=0; .zx=0; .zy=0; .zz=1; .zw=0; .wx=0; .wy=0; .wz=0; .ww=1; ]\| Resets matrix to the identity matrix: \|[ .xx=1; .xy=0; .xz=0; .xw=0; .yx=0; .yy=1; .yz=0; .yw=0; .zx=0; .zy=0; .zz=1; .zw=0; .wx=0; .wy=0; .wz=0; .ww=1; ]\| Returns: none	Cogl.Matrix
	multiply (Matrix a, Matrix b) : none Multiplies the two supplied matrices together and stores the resulting matrix inside result Multiplies the two supplied matrices together and stores the resulting matrix inside result Parameters: Cogl.Matrix a Required (not null) A 4x4 transformation matrix Cogl.Matrix b Required (not null) A 4x4 transformation matrix Returns: none	Cogl.Matrix
	ortho (gfloat *left, gfloat right, gfloat bottom, gfloat top, gfloat z_near, gfloat z_far) : none Multiplies matrix* by a parallel projection matrix. Multiplies matrix by a parallel projection matrix. Parameters: gfloat left Required (not null) The coordinate for the left clipping plane gfloat right Required (not null) The coordinate for the right clipping plane gfloat bottom Required (not null) The coordinate for the bottom clipping plane gfloat top Required (not null) The coordinate for the top clipping plane gfloat z_near Required (not null) The coordinate for the near clipping plane (may be negative if the plane is behind the viewer) gfloat z_far Required (not null) The coordinate for the far clipping plane (may be negative if the plane is behind the viewer) Returns: none	Cogl.Matrix
	perspective (gfloat *fov_y, gfloat aspect, gfloat z_near, gfloat z_far) : none Multiplies matrix* by the described perspective matrix You should be careful not to have to great a z_far / z_near ratio since that will reduce the effectiveness of depth testing since there wont be enough precision to identify the depth of objects near to each other. Multiplies matrix by the described perspective matrix You should be careful not to have to great a z_far / z_near ratio since that will reduce the effectiveness of depth testing since there wont be enough precision to identify the depth of objects near to each other. Parameters: gfloat fov_y Required (not null) A field of view angle for the Y axis gfloat aspect Required (not null) The ratio of width to height determining the field of view angle for the x axis. gfloat z_near Required (not null) The distance to the near clip plane. Never pass 0 and always pass a positive number. gfloat z_far Required (not null) The distance to the far clip plane. (Should always be positive) Returns: none	Cogl.Matrix
	rotate (gfloat *angle, gfloat x, gfloat y, gfloat z) : none Multiplies matrix* with a rotation matrix that applies a rotation of angle degrees around the specified 3D vector. Multiplies matrix with a rotation matrix that applies a rotation of angle degrees around the specified 3D vector. Parameters: gfloat angle Required (not null) The angle you want to rotate in degrees gfloat x Required (not null) X component of your rotation vector gfloat y Required (not null) Y component of your rotation vector gfloat z Required (not null) Z component of your rotation vector Returns: none	Cogl.Matrix
	scale (gfloat sx, gfloat sy, gfloat sz) : none Multiplies matrix with a transform matrix that scales along the X, Y and Z axis. Multiplies matrix with a transform matrix that scales along the X, Y and Z axis. Parameters: gfloat sx Required (not null) The X scale factor gfloat sy Required (not null) The Y scale factor gfloat sz Required (not null) The Z scale factor Returns: none	Cogl.Matrix
	transform_point (gfloat x, gfloat y, gfloat z, gfloat w) : none Transforms a point whos position is given and returned as four float components. Transforms a point whos position is given and returned as four float components. Parameters: gfloat x Required (not null) The X component of your points position gfloat y Required (not null) The Y component of your points position gfloat z Required (not null) The Z component of your points position gfloat w Required (not null) The W component of your points position Returns: none	Cogl.Matrix
	translate (gfloat x, gfloat y, gfloat z) : none Multiplies matrix with a transform matrix that translates along the X, Y and Z axis. Multiplies matrix with a transform matrix that translates along the X, Y and Z axis. Parameters: gfloat x Required (not null) The X translation you want to apply gfloat y Required (not null) The Y translation you want to apply gfloat z Required (not null) The Z translation you want to apply Returns: none	Cogl.Matrix

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Clutter.Actor Method	get_transformation_matrix () : Cogl.Matrix Retrieves the transformations applied to self
Cogl Method	Cogl.get_modelview_matrix () : Cogl.Matrix Stores the current model-view matrix in matrix.
Cogl Method	Cogl.get_projection_matrix () : Cogl.Matrix Stores the current projection matrix in matrix.
Cogl Method	Cogl.set_modelview_matrix (Matrix *matrix) : none Loads matrix* as the new model-view matrix.
Cogl Method	Cogl.set_projection_matrix (Matrix *matrix*) : none Loads matrix as the new projection matrix.
Cogl Method	Cogl.transform (Matrix *matrix*) : none Multiplies the current model-view matrix by the given matrix.
Cogl.Material Method	set_layer_matrix (gint32 *layer_index, Matrix matrix*) : none This function lets you set a matrix that can be used to e.g.
Cogl.Pipeline Method	set_layer_matrix (gint32 *layer_index, Matrix matrix*) : none