GetCameraMatrix: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(New page: __NOTOC__ {{Server client function}} This function gets the position of the camera and the point it is facing. Note: The server-side version of this function returns the last camera matri...)
 
No edit summary
(19 intermediate revisions by 13 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
This function gets the position of the camera and the point it is facing.
This function gets the position of the camera and the position of the point it is facing.


Note: The server-side version of this function returns the last camera matrix that was set by the server, and thus does not necessarily indicate the current matrix of the camera (since it may have been changed client-side).
 
{{Important Note|Server-side this functions returns false or the latest value set via [[setCameraMatrix]] (called from server or client).}}


==Syntax==
==Syntax==
<section name="Server" class="server" show="true">
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool getCameraMatrix ( player thePlayer )
float float float float float float float float getCameraMatrix ( player thePlayer )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[player]]:getCameraMatrix|cameraMatrix|setCameraMatrix}}


===Required Arguments===  
===Required Arguments===
*'''thePlayer:''' The player whose camera matrix is to be returned.
*'''thePlayer:''' The player whose camera matrix is to be returned.
</section>
</section>
Line 17: Line 19:
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool getCameraMatrix ( )
float float float float float float float float getCameraMatrix ()
</syntaxhighlight>
</syntaxhighlight>
 
{{OOP||[[Camera]].getMatrix|matrix|setCameraMatrix}}
===Required Arguments===
''None.''
</section>
</section>


===Returns===
===Returns===
Returns ''true'' if the argument are valid, ''false'' otherwise.
This function returns 8 [[float|floats]] if the argument is valid (when applicable); the first three indicate the position of the camera, the next three indicate the position of the point it's facing, and the last two are the roll and field of view. Returns ''false'' if the argument is invalid.


==Example==
===Example===
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local x, y, z, lx, ly, lz = getCameraMatrix ()
x, lx = x + 1, lx + 1
 
setCameraMatrix (x, y, z, lx, ly, lz)
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Camera functions}}
{{Camera functions}}


[[Category:Incomplete]]
[[hu:getCameraMatrix]]

Revision as of 14:19, 16 February 2019

This function gets the position of the camera and the position of the point it is facing.


[[{{{image}}}|link=|]] Important Note: Server-side this functions returns false or the latest value set via setCameraMatrix (called from server or client).

Syntax

Click to collapse [-]
Server
float float float float float float float float getCameraMatrix ( player thePlayer )

OOP Syntax Help! I don't understand this!

Method: player:getCameraMatrix(...)
Variable: .cameraMatrix
Counterpart: setCameraMatrix


Required Arguments

  • thePlayer: The player whose camera matrix is to be returned.
Click to collapse [-]
Client
float float float float float float float float getCameraMatrix ()

OOP Syntax Help! I don't understand this!

Method: Camera.getMatrix(...)
Variable: .matrix
Counterpart: setCameraMatrix


Returns

This function returns 8 floats if the argument is valid (when applicable); the first three indicate the position of the camera, the next three indicate the position of the point it's facing, and the last two are the roll and field of view. Returns false if the argument is invalid.

Example

Click to collapse [-]
Client
local x, y, z, lx, ly, lz = getCameraMatrix ()
x, lx = x + 1, lx + 1

setCameraMatrix (x, y, z, lx, ly, lz)

See Also