SetCameraMatrix: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
This function sets the camera's position and direction. The first three arguments are the point at which the camera lies, the last three are the point the camera faces (or the point it "looks at").
هذه الوظيفة تغير مكان الكاميرا. اول ثلاثة ارقمنات يعبرون عن احداثيات مكان الكاميرا, اخر ثلاثة ارقمنات يعبرون عن مكان اتجاه الكاميرا اي يعني ماتنظر اليه الكاميرا.


'''Note:''' Calling this function takes the camera's focus away from the player and sets the camera in a fixed position and rotation. The camera's focus can be brought back to the player using the [[setCameraTarget]] function.
'''ملحوظة:''' استدعاء هذه الوظيفة سيحرك كاميرا الاعب الي موضع واتجاه مختلف لاعاده الكاميرا الي الاعب يمكنك استخدام وظيفة [[setCameraTarget]]
==Syntax==
==الصيغة==
<section name="Server" class="server" show="true">
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 10: Line 10:
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[player]]:setCameraMatrix|cameraMatrix|getCameraMatrix}}
{{OOP||[[player]]:setCameraMatrix|cameraMatrix|getCameraMatrix}}
===Required Arguments===  
===الارقمنات المطلوبة===  
*'''thePlayer:''' The player whose camera is to be changed.
*'''thePlayer:''' الاعب الذي ستتغير مكان او اتجاه الكاميرا لديه.
*'''positionX:''' The x coordinate of the camera's position.
*'''positionX:''' احداثي اكس لمكان الكاميرا.
*'''positionY:''' The y coordinate of the camera's position.
*'''positionY:''' احداثي واي لمكان الكاميرا.
*'''positionZ:''' The z coordinate of the camera's position.
*'''positionZ:''' احداثي زد لمكان الكاميرا.
*'''{{New feature/item|3.0141|1.4.1|7005|Instead of six coordinates, or two vectors, a Matrix can be supplied.}}'''
*'''{{New feature/item|3.0141|1.4.1|7005|Instead of six coordinates, or two vectors, a Matrix can be supplied.}}'''


===Optional Arguments===  
===الارقمنات الاختيارية===  
*'''lookAtX:''' The x coordinate of the point the camera faces.
*'''lookAtX:''' احداثي اكس لاتجاه الكاميرا.
*'''lookAtY:''' The y coordinate of the point the camera faces.
*'''lookAtY:''' احداثي واي لاتجاه الكاميرا.
*'''lookAtZ:''' The z coordinate of the point the camera faces.
*'''lookAtZ:''' احداثي زد لاتجاه الكاميرا.
*'''roll:''' The camera roll angle, -180 to 180. A value of 0 means the camera sits straight, positive values will turn it counter-clockwise and negative values will turn it clockwise. -180 or 180 means the camera is upside down.
*'''roll:''' زاوية تمايل الكاميرا, من -180 ال 180. اذا كانت القيمة ب 0 ستكون الكاميرا مستقيمة, القيم الإيجابية سوف تتحول عكس اتجاه عقارب الساعة والقيم السلبية سوف تتحول في اتجاه عقارب الساعة. -180 او 180 تعني ان الكاميرا ستكون راس علي عقب.
*'''fov:''' the field of view angle, 0 to 180. The higher this value is, the more you will be able to see what is to your sides.
*'''fov:''' مجال زاوية الرؤية, 0 الي 180 . كلما ارتفعت هذه القيمة , كلما استطعت رؤية مجال اكبر
</section>
</section>


Line 31: Line 31:
{{OOP|This is under the static class '''Camera'''|Camera.setMatrix|matrix|getCameraMatrix}}
{{OOP|This is under the static class '''Camera'''|Camera.setMatrix|matrix|getCameraMatrix}}


===Required Arguments===  
===الارقمنات المطلوبة===  
*'''positionX:''' The x coordinate of the camera's position.
*'''positionX:''' احداثي اكس لمكان الكاميرا.
*'''positionY:''' The y coordinate of the camera's position.
*'''positionY:''' احداثي واي لمكان الكاميرا.
*'''positionZ:''' The z coordinate of the camera's position.
*'''positionZ:''' احداثي زد لمكان الكاميرا.
*'''{{New feature/item|3.0141|1.4.1|7005|Instead of six coordinates, or two vectors, a Matrix can be supplied.}}'''
*'''{{New feature/item|3.0141|1.4.1|7005|Instead of six coordinates, or two vectors, a Matrix can be supplied.}}'''


===Optional Arguments===  
===الارقمنات الاختيارية===  
*'''lookAtX:''' The x coordinate of the point the camera faces.
*'''lookAtX:''' احداثي اكس لاتجاه الكاميرا.
*'''lookAtY:''' The y coordinate of the point the camera faces.
*'''lookAtY:''' احداثي واي لاتجاه الكاميرا.
*'''lookAtZ:''' The z coordinate of the point the camera faces.
*'''lookAtZ:''' احداثي زد لاتجاه الكاميرا.
*'''roll:''' The camera roll angle, -180 to 180. A value of 0 means the camera sits straight, positive values will turn it counter-clockwise and negative values will turn it clockwise. -180 or 180 means the camera is upside down.
*'''roll:''' زاوية تمايل الكاميرا, من -180 ال 180. اذا كانت القيمة ب 0 ستكون الكاميرا مستقيمة, القيم الإيجابية سوف تتحول عكس اتجاه عقارب الساعة والقيم السلبية سوف تتحول في اتجاه عقارب الساعة. -180 او 180 تعني ان الكاميرا ستكون راس علي عقب.
*'''fov:''' the field of view angle, 0 to 180. The higher this value is, the more you will be able to see what is to your sides.
*'''fov:''' مجال زاوية الرؤية, 0 الي 180 . كلما ارتفعت هذه القيمة , كلما استطعت رؤية مجال اكبر
</section>
</section>


Line 48: Line 48:
Returns ''true'' if the arguments are valid, ''false'' otherwise.
Returns ''true'' if the arguments are valid, ''false'' otherwise.


==Example==
==مثال==
This code fixates the camera onto the Vinewood sign in Los Santos for any player that joins the server:
هذا الكود يضع اتجاه ومكان الكاميرا علي علامة "فاين وود" في مدينة لوس سانتوس لاي لاعب يدخل الي السيرفر :
<section class="server" name="Server script" show="true">
<section class="server" name="Server script" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function setCameraOnPlayerJoin()
function setCameraOnPlayerJoin()
     -- slowly fade the camera in to make the screen visible
     -- تتلاشي الكاميرا ببطئ لتجعل الشاشة مرئية
     fadeCamera(source, true, 5)
     fadeCamera(source, true, 5)
     -- set the player's camera to a fixed position, looking at a fixed point
     -- تضع كاميرا الخاصة بلاعب ف مكان معين, وتنظر الي اتجاه معين
     setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)
     setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)
end
end
Line 61: Line 61:
</section>
</section>


==See Also==
==انظر ايضا==
{{Camera functions}}
{{Camera functions}}

Revision as of 01:11, 9 April 2017

هذه الوظيفة تغير مكان الكاميرا. اول ثلاثة ارقمنات يعبرون عن احداثيات مكان الكاميرا, اخر ثلاثة ارقمنات يعبرون عن مكان اتجاه الكاميرا اي يعني ماتنظر اليه الكاميرا.

ملحوظة: استدعاء هذه الوظيفة سيحرك كاميرا الاعب الي موضع واتجاه مختلف لاعاده الكاميرا الي الاعب يمكنك استخدام وظيفة setCameraTarget

الصيغة

Click to collapse [-]
Server
bool setCameraMatrix ( player thePlayer, float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll = 0, float fov = 70 ] )

OOP Syntax Help! I don't understand this!

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


الارقمنات المطلوبة

  • thePlayer: الاعب الذي ستتغير مكان او اتجاه الكاميرا لديه.
  • positionX: احداثي اكس لمكان الكاميرا.
  • positionY: احداثي واي لمكان الكاميرا.
  • positionZ: احداثي زد لمكان الكاميرا.
  • Instead of six coordinates, or two vectors, a Matrix can be supplied.

الارقمنات الاختيارية

  • lookAtX: احداثي اكس لاتجاه الكاميرا.
  • lookAtY: احداثي واي لاتجاه الكاميرا.
  • lookAtZ: احداثي زد لاتجاه الكاميرا.
  • roll: زاوية تمايل الكاميرا, من -180 ال 180. اذا كانت القيمة ب 0 ستكون الكاميرا مستقيمة, القيم الإيجابية سوف تتحول عكس اتجاه عقارب الساعة والقيم السلبية سوف تتحول في اتجاه عقارب الساعة. -180 او 180 تعني ان الكاميرا ستكون راس علي عقب.
  • fov: مجال زاوية الرؤية, 0 الي 180 . كلما ارتفعت هذه القيمة , كلما استطعت رؤية مجال اكبر
Click to collapse [-]
Client
bool setCameraMatrix ( float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll = 0, float fov = 70 ] )

OOP Syntax Help! I don't understand this!

Note: This is under the static class Camera
Method: Camera.setMatrix(...)
Variable: .matrix
Counterpart: getCameraMatrix


الارقمنات المطلوبة

  • positionX: احداثي اكس لمكان الكاميرا.
  • positionY: احداثي واي لمكان الكاميرا.
  • positionZ: احداثي زد لمكان الكاميرا.
  • Instead of six coordinates, or two vectors, a Matrix can be supplied.

الارقمنات الاختيارية

  • lookAtX: احداثي اكس لاتجاه الكاميرا.
  • lookAtY: احداثي واي لاتجاه الكاميرا.
  • lookAtZ: احداثي زد لاتجاه الكاميرا.
  • roll: زاوية تمايل الكاميرا, من -180 ال 180. اذا كانت القيمة ب 0 ستكون الكاميرا مستقيمة, القيم الإيجابية سوف تتحول عكس اتجاه عقارب الساعة والقيم السلبية سوف تتحول في اتجاه عقارب الساعة. -180 او 180 تعني ان الكاميرا ستكون راس علي عقب.
  • fov: مجال زاوية الرؤية, 0 الي 180 . كلما ارتفعت هذه القيمة , كلما استطعت رؤية مجال اكبر

Returns

Returns true if the arguments are valid, false otherwise.

مثال

هذا الكود يضع اتجاه ومكان الكاميرا علي علامة "فاين وود" في مدينة لوس سانتوس لاي لاعب يدخل الي السيرفر :

Click to collapse [-]
Server script
function setCameraOnPlayerJoin()
     -- تتلاشي الكاميرا ببطئ لتجعل الشاشة مرئية
     fadeCamera(source, true, 5)
     -- تضع كاميرا الخاصة بلاعب ف مكان معين, وتنظر الي اتجاه معين
     setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)
end
addEventHandler("onPlayerJoin", root, setCameraOnPlayerJoin)

انظر ايضا


Retrieved from "https://wiki.multitheftauto.com/wiki/SetCameraMatrix?oldid=50595"