Matrix - Revision history

Tracer: Added examples for other methods

2022-02-16T17:09:06Z

Added examples for other methods

@@ Line 61: / Line 61: @@
 local rotation = matrix:getRotation()
 outputChatBox("rx: " .. rotation:getX() .. ", ry: " .. rotation:getY() .. ", rz:" .. rotation:getZ())
 </syntaxhighlight>
-===getForward===
 ===getRight===
 ===getUp===
 ==Using Matrices==

2018-02-16T18:47:45Z

Explained how to achieve the opposite directions.

← Older revision		Revision as of 18:47, 16 February 2018
Line 71:		Line 71:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	Object ( 1337, player.matrix.position + player.matrix.forward * 2 )		Object ( 1337, player.matrix.position + player.matrix.forward * 2 )
			</syntaxhighlight>

			If you wanted the opposite of matrix.forward you'll still use matrix.forward but you minus it instead of matrix.backward which doesn't exist. Same applies with matrix.right and matrix.up. To make the bin object appear behind a player:

			<syntaxhighlight lang="lua">
			Object ( 1337, player.matrix.position - player.matrix.forward * 2 )
	</syntaxhighlight>		</syntaxhighlight>

2017-07-12T02:15:23Z

@@ Line 50: / Line 50: @@
 ===getRotation===
 ===getForward===
 ===getRight===

2017-05-07T21:13:54Z

← Older revision		Revision as of 21:13, 7 May 2017
Line 1:		Line 1:
			{{Needs Example}}
	Matrices are one of the most powerful features of MTA [[OOP]]. We did have a presence of Matrices before with [[getElementMatrix]], but we were given an ugly disgusting table to play with. Now, with the new Matrix class, we can make and magically manipulate Matrices.		Matrices are one of the most powerful features of MTA [[OOP]]. We did have a presence of Matrices before with [[getElementMatrix]], but we were given an ugly disgusting table to play with. Now, with the new Matrix class, we can make and magically manipulate Matrices.
	__TOC__		__TOC__

2016-11-25T13:35:31Z

Example

← Older revision		Revision as of 13:35, 25 November 2016
Line 30:		Line 30:
	local desiredRelativePosition = Vector3(0, 5, 0) -- 5 meters front of player is a y = 5 vector		local desiredRelativePosition = Vector3(0, 5, 0) -- 5 meters front of player is a y = 5 vector
	local matrix = player.matrix		local matrix = player.matrix
	local newPosition = matrix.transformPosition(desiredRelativePosition)		local newPosition = matrix:transformPosition(desiredRelativePosition)
	player.position = newPosition		player.position = newPosition
	</syntaxhighlight>		</syntaxhighlight>

2016-08-07T17:43:19Z

add incomplete category

2015-11-30T20:21:16Z

fix some names in those links

← Older revision		Revision as of 20:21, 30 November 2015
Line 54:		Line 54:

	==Using Matrices==		==Using Matrices==
	Say you wanted to create a bin - object 1337 - two units in front of a player. You don't want to manually do trigonometry and you don't want to play with the complicated tables. You just want to get the position two units in front of the player whilst taking into account the rotation of the player. You only need to use '''[[Matrix#getForward]]'''. '''[[Matrix#getPosition]]''' and '''[[getElementMatrix]]'''. It's just:		Say you wanted to create a bin - object 1337 - two units in front of a player. You don't want to manually do trigonometry and you don't want to play with the complicated tables. You just want to get the position two units in front of the player whilst taking into account the rotation of the player. You only need to use '''[[Matrix#getForward\|Matrix.getForward]]''', '''[[Matrix#getPosition\|Matrix.getPosition]]''' and '''[[getElementMatrix]]'''. It's just:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	Object ( 1337, player.matrix.position + player.matrix.forward * 2 )		Object ( 1337, player.matrix.position + player.matrix.forward * 2 )

2015-11-30T20:19:59Z

possibly some links (can't test because links)

← Older revision		Revision as of 20:19, 30 November 2015
Line 54:		Line 54:

	==Using Matrices==		==Using Matrices==
	Say you wanted to create a bin - object 1337 - two units in front of a player. You don't want to manually do trigonometry and you don't want to play with the complicated tables. You just want to get the position two units in front of the player whilst taking into account the rotation of the player. You only need to use '''[[Matrix.getForward]]'''. '''[[Matrix.getPosition]]''' and '''[[getElementMatrix]]'''. It's just:		Say you wanted to create a bin - object 1337 - two units in front of a player. You don't want to manually do trigonometry and you don't want to play with the complicated tables. You just want to get the position two units in front of the player whilst taking into account the rotation of the player. You only need to use '''[[Matrix#getForward]]'''. '''[[Matrix#getPosition]]''' and '''[[getElementMatrix]]'''. It's just:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	Object ( 1337, player.matrix.position + player.matrix.forward * 2 )		Object ( 1337, player.matrix.position + player.matrix.forward * 2 )

2015-11-30T20:18:07Z

fix syntax

← Older revision		Revision as of 20:18, 30 November 2015
Line 3:		Line 3:
	==Methods==		==Methods==
	===create===		===create===
	This is default constructor for the Matrix class and returns a Matrix object.		This is default constructor for the Matrix class and returns a Matrix object. You can instantiate a Matrix object in several ways, as described below.

	~~====Syntax====~~		<syntaxhighlight lang="lua">matrix Matrix ( Vector3 position[, Vector3 rotation] )</syntaxhighlight>
	<syntaxhighlight lang="lua">matrix Matrix ( Vector3 position, Vector3 rotation )</syntaxhighlight>
	* '''position''': The position vector of the matrix		* '''position''': The position vector of the matrix
	* '''rotation''': The rotation vector of the matrix		* '''rotation''': The rotation vector of the matrix

2015-11-30T20:17:23Z

fix spacing issues

← Older revision		Revision as of 20:17, 30 November 2015
Line 9:		Line 9:
	* '''position''': The position vector of the matrix		* '''position''': The position vector of the matrix
	* '''rotation''': The rotation vector of the matrix		* '''rotation''': The rotation vector of the matrix


	<syntaxhighlight lang="lua">matrix Matrix ( Matrix matrixToClone )</syntaxhighlight>		<syntaxhighlight lang="lua">matrix Matrix ( Matrix matrixToClone )</syntaxhighlight>
	* '''matrixToClone''': A matrix you want to make a clone of		* '''matrixToClone''': A matrix you want to make a clone of


	<syntaxhighlight lang="lua">matrix Matrix()</syntaxhighlight>		<syntaxhighlight lang="lua">matrix Matrix()</syntaxhighlight>
	* You can call this method without parameters to initialize a zero matrix		* You can call this method without parameters to initialize a zero matrix


	===transformPosition===		===transformPosition===