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
	Show / Hide Inherited methods, properties and signals

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 : Number	Cogl.Matrix
	flags : Number	Cogl.Matrix
	inv : Array	Cogl.Matrix
	type : Number	Cogl.Matrix
	ww : Number	Cogl.Matrix
	wx : Number	Cogl.Matrix
	wy : Number	Cogl.Matrix
	wz : Number	Cogl.Matrix
	xw : Number	Cogl.Matrix
	xx : Number	Cogl.Matrix
	xy : Number	Cogl.Matrix
	xz : Number	Cogl.Matrix
	yw : Number	Cogl.Matrix
	yx : Number	Cogl.Matrix
	yy : Number	Cogl.Matrix
	yz : Number	Cogl.Matrix
	zw : Number	Cogl.Matrix
	zx : Number	Cogl.Matrix
	zy : Number	Cogl.Matrix
	zz : Number	Cogl.Matrix

Methods / Constructors
Method / Constructor		Defined By
	new Cogl.Matrix () Create a new Cogl.Matrix Create a new Cogl.Matrix
	frustum (Number *left, Number right, Number bottom, Number top, Number z_near, Number z_far) : none Multiplies matrix* by the given frustum perspective matrix. Multiplies matrix by the given frustum perspective matrix. Parameters: Number left Required (not null) Number right Required (not null) Number bottom Required (not null) Number top Required (not null) Number z_near Required (not null) Number z_far Required (not null) Returns: none	Cogl.Matrix
	get_array () : Number 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: Number	Cogl.Matrix
	get_inverse (Object *out_values) : Boolean 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. Parameters: Object out_values Cogl.Matrix inverse Returns: Boolean for degenerate transformations that can't be inverted (in this case the	Cogl.Matrix
	init_from_array () : Number Initializes matrix with the contents of array Initializes matrix with the contents of array Returns: Number	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) Cogl.Matrix b Required (not null) Returns: none	Cogl.Matrix
	ortho (Number *left, Number right, Number bottom, Number top, Number z_near, Number z_far) : none Multiplies matrix* by a parallel projection matrix. Multiplies matrix by a parallel projection matrix. Parameters: Number left Required (not null) Number right Required (not null) Number bottom Required (not null) Number top Required (not null) Number z_near Required (not null) the plane is behind the viewer) Number z_far Required (not null) the plane is behind the viewer) Returns: none	Cogl.Matrix
	perspective (Number *fov_y, Number aspect, Number z_near, Number 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: Number fov_y Required (not null) Number aspect Required (not null) for the x axis. Number z_near Required (not null) a positive number. Number z_far Required (not null) Returns: none	Cogl.Matrix
	rotate (Number *angle, Number x, Number y, Number 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: Number angle Required (not null) Number x Required (not null) Number y Required (not null) Number z Required (not null) Returns: none	Cogl.Matrix
	scale (Number sx, Number sy, Number 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: Number sx Required (not null) Number sy Required (not null) Number sz Required (not null) Returns: none	Cogl.Matrix
	transform_point (Number x, Number y, Number z, Number 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: Number x Required (not null) The X component of your points position Number y Required (not null) The Y component of your points position Number z Required (not null) The Z component of your points position Number w Required (not null) The W component of your points position Returns: none	Cogl.Matrix
	translate (Number x, Number y, Number 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: Number x Required (not null) Number y Required (not null) Number z Required (not null) 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.material_set_layer_matrix (void* *material, Number layer_index, Matrix matrix*) : none This function lets you set a matrix that can be used to e.g.
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.