graphene/org.gtkkn.bindings.graphene/Matrix

Matrix

class Matrix(val grapheneMatrixPointer: <Error class: unknown class><<Error class: unknown class>>, cleaner: <Error class: unknown class>? = null)

A structure capable of holding a 4x4 matrix.

The contents of the #graphene_matrix_t structure are private and should never be accessed directly.

Skipped during bindings generation

  • parameter v: Array parameter of type gfloat is not supported

  • parameter xx: xx: Out parameter is not supported

  • parameter v: v: Out parameter is not supported

Constructors

Link copied to clipboard
constructor()

Allocate a new Matrix.

constructor(scope: <Error class: unknown class>)

Allocate a new Matrix using the provided AutofreeScope.

constructor(grapheneMatrixPointer: <Error class: unknown class><<Error class: unknown class>>, cleaner: <Error class: unknown class>? = null)

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard
val grapheneMatrixPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

Link copied to clipboard
fun decompose(translate: Vec3, scale: Vec3, rotate: Quaternion, shear: Vec3, perspective: Vec4): Boolean

Decomposes a transformation matrix into its component transformations.

Link copied to clipboard
fun determinant(): <Error class: unknown class>

Computes the determinant of the given matrix.

Link copied to clipboard
fun equal(b: Matrix): Boolean

Checks whether the two given #graphene_matrix_t matrices are equal.

Link copied to clipboard
fun equalFast(b: Matrix): Boolean

Checks whether the two given #graphene_matrix_t matrices are byte-by-byte equal.

Link copied to clipboard
fun free()

Frees the resources allocated by graphene_matrix_alloc().

Link copied to clipboard
fun getRow(index: <Error class: unknown class>, res: Vec4)

Retrieves the given row vector at @index_ inside a matrix.

Link copied to clipboard
fun getValue(row: <Error class: unknown class>, col: <Error class: unknown class>): <Error class: unknown class>

Retrieves the value at the given @row and @col index.

Link copied to clipboard
fun getXScale(): <Error class: unknown class>

Retrieves the scaling factor on the X axis in @m.

Link copied to clipboard
fun getXTranslation(): <Error class: unknown class>

Retrieves the translation component on the X axis from @m.

Link copied to clipboard
fun getYScale(): <Error class: unknown class>

Retrieves the scaling factor on the Y axis in @m.

Link copied to clipboard
fun getYTranslation(): <Error class: unknown class>

Retrieves the translation component on the Y axis from @m.

Link copied to clipboard
fun getZScale(): <Error class: unknown class>

Retrieves the scaling factor on the Z axis in @m.

Link copied to clipboard
fun getZTranslation(): <Error class: unknown class>

Retrieves the translation component on the Z axis from @m.

Link copied to clipboard
fun initFrom2d(xx: <Error class: unknown class>, yx: <Error class: unknown class>, xy: <Error class: unknown class>, yy: <Error class: unknown class>, x0: <Error class: unknown class>, y0: <Error class: unknown class>): Matrix

Initializes a #graphene_matrix_t from the values of an affine transformation matrix.

Link copied to clipboard
fun initFromMatrix(src: Matrix): Matrix

Initializes a #graphene_matrix_t using the values of the given matrix.

Link copied to clipboard
fun initFromVec4(v0: Vec4, v1: Vec4, v2: Vec4, v3: Vec4): Matrix

Initializes a #graphene_matrix_t with the given four row vectors.

Link copied to clipboard
fun initFrustum(left: <Error class: unknown class>, right: <Error class: unknown class>, bottom: <Error class: unknown class>, top: <Error class: unknown class>, zNear: <Error class: unknown class>, zFar: <Error class: unknown class>): Matrix

Initializes a #graphene_matrix_t compatible with #graphene_frustum_t.

Link copied to clipboard
fun initIdentity(): Matrix

Initializes a #graphene_matrix_t with the identity matrix.

Link copied to clipboard
fun initLookAt(eye: Vec3, center: Vec3, up: Vec3): Matrix

Initializes a #graphene_matrix_t so that it positions the "camera" at the given @eye coordinates towards an object at the @center coordinates. The top of the camera is aligned to the direction of the @up vector.

Link copied to clipboard
fun initOrtho(left: <Error class: unknown class>, right: <Error class: unknown class>, top: <Error class: unknown class>, bottom: <Error class: unknown class>, zNear: <Error class: unknown class>, zFar: <Error class: unknown class>): Matrix

Initializes a #graphene_matrix_t with an orthographic projection.

Link copied to clipboard
fun initPerspective(fovy: <Error class: unknown class>, aspect: <Error class: unknown class>, zNear: <Error class: unknown class>, zFar: <Error class: unknown class>): Matrix

Initializes a #graphene_matrix_t with a perspective projection.

Link copied to clipboard
fun initRotate(angle: <Error class: unknown class>, axis: Vec3): Matrix

Initializes @m to represent a rotation of @angle degrees on the axis represented by the @axis vector.

Link copied to clipboard
fun initScale(x: <Error class: unknown class>, y: <Error class: unknown class>, z: <Error class: unknown class>): Matrix

Initializes a #graphene_matrix_t with the given scaling factors.

Link copied to clipboard
fun initSkew(xSkew: <Error class: unknown class>, ySkew: <Error class: unknown class>): Matrix

Initializes a #graphene_matrix_t with a skew transformation with the given factors.

Link copied to clipboard
fun initTranslate(p: Point3d): Matrix

Initializes a #graphene_matrix_t with a translation to the given coordinates.

Link copied to clipboard
fun interpolate(b: Matrix, factor: <Error class: unknown class>, res: Matrix)

Linearly interpolates the two given #graphene_matrix_t by interpolating the decomposed transformations separately.

Link copied to clipboard
fun inverse(res: Matrix): Boolean

Inverts the given matrix.

Link copied to clipboard
fun is2d(): Boolean

Checks whether the given #graphene_matrix_t is compatible with an a 2D affine transformation matrix.

Link copied to clipboard
fun isBackfaceVisible(): Boolean

Checks whether a #graphene_matrix_t has a visible back face.

Link copied to clipboard
fun isIdentity(): Boolean

Checks whether the given #graphene_matrix_t is the identity matrix.

Link copied to clipboard
fun isSingular(): Boolean

Checks whether a matrix is singular.

Link copied to clipboard
fun multiply(b: Matrix, res: Matrix)

Multiplies two #graphene_matrix_t.

Link copied to clipboard
fun near(b: Matrix, epsilon: <Error class: unknown class>): Boolean

Compares the two given #graphene_matrix_t matrices and checks whether their values are within the given @epsilon of each other.

Link copied to clipboard
fun normalize(res: Matrix)

Normalizes the given #graphene_matrix_t.

Link copied to clipboard
fun perspective(depth: <Error class: unknown class>, res: Matrix)

Applies a perspective of @depth to the matrix.

Link copied to clipboard
fun print()

Prints the contents of a matrix to the standard error stream.

Link copied to clipboard
fun projectPoint(p: Point, res: Point)

Projects a #graphene_point_t using the matrix @m.

Link copied to clipboard
fun projectRect(r: Rect, res: Quad)

Projects all corners of a #graphene_rect_t using the given matrix.

Link copied to clipboard
fun projectRectBounds(r: Rect, res: Rect)

Projects a #graphene_rect_t using the given matrix.

Link copied to clipboard
fun rotate(angle: <Error class: unknown class>, axis: Vec3)

Adds a rotation transformation to @m, using the given @angle and @axis vector.

Link copied to clipboard
fun rotateEuler(e: Euler)

Adds a rotation transformation to @m, using the given #graphene_euler_t.

Link copied to clipboard
fun rotateQuaternion(q: Quaternion)

Adds a rotation transformation to @m, using the given #graphene_quaternion_t.

Link copied to clipboard
fun rotateX(angle: <Error class: unknown class>)

Adds a rotation transformation around the X axis to @m, using the given @angle.

Link copied to clipboard
fun rotateY(angle: <Error class: unknown class>)

Adds a rotation transformation around the Y axis to @m, using the given @angle.

Link copied to clipboard
fun rotateZ(angle: <Error class: unknown class>)

Adds a rotation transformation around the Z axis to @m, using the given @angle.

Link copied to clipboard
fun scale(factorX: <Error class: unknown class>, factorY: <Error class: unknown class>, factorZ: <Error class: unknown class>)

Adds a scaling transformation to @m, using the three given factors.

Link copied to clipboard
fun skewXy(factor: <Error class: unknown class>)

Adds a skew of @factor on the X and Y axis to the given matrix.

Link copied to clipboard
fun skewXz(factor: <Error class: unknown class>)

Adds a skew of @factor on the X and Z axis to the given matrix.

Link copied to clipboard
fun skewYz(factor: <Error class: unknown class>)

Adds a skew of @factor on the Y and Z axis to the given matrix.

Link copied to clipboard
fun transformBounds(r: Rect, res: Rect)

Transforms each corner of a #graphene_rect_t using the given matrix @m.

Link copied to clipboard
fun transformBox(b: Box, res: Box)

Transforms the vertices of a #graphene_box_t using the given matrix @m.

Link copied to clipboard
fun transformPoint(p: Point, res: Point)

Transforms the given #graphene_point_t using the matrix @m.

Link copied to clipboard
fun transformPoint3d(p: Point3d, res: Point3d)

Transforms the given #graphene_point3d_t using the matrix @m.

Link copied to clipboard
fun transformRay(r: Ray, res: Ray)

Transform a #graphene_ray_t using the given matrix @m.

Link copied to clipboard
fun transformRect(r: Rect, res: Quad)

Transforms each corner of a #graphene_rect_t using the given matrix @m.

Link copied to clipboard
fun transformSphere(s: Sphere, res: Sphere)

Transforms a #graphene_sphere_t using the given matrix @m. The result is the bounding sphere containing the transformed sphere.

Link copied to clipboard
fun transformVec3(v: Vec3, res: Vec3)

Transforms the given #graphene_vec3_t using the matrix @m.

Link copied to clipboard
fun transformVec4(v: Vec4, res: Vec4)

Transforms the given #graphene_vec4_t using the matrix @m.

Link copied to clipboard
fun translate(pos: Point3d)

Adds a translation transformation to @m using the coordinates of the given #graphene_point3d_t.

Link copied to clipboard
fun transpose(res: Matrix)

Transposes the given matrix.

Link copied to clipboard
fun unprojectPoint3d(modelview: Matrix, point: Point3d, res: Point3d)

Unprojects the given @point using the @projection matrix and a @modelview matrix.

Link copied to clipboard
fun untransformBounds(r: Rect, bounds: Rect, res: Rect)

Undoes the transformation on the corners of a #graphene_rect_t using the given matrix, within the given axis aligned rectangular @bounds.

Link copied to clipboard
fun untransformPoint(p: Point, bounds: Rect, res: Point): Boolean

Undoes the transformation of a #graphene_point_t using the given matrix, within the given axis aligned rectangular @bounds.