GetCameraViewMode: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(10 intermediate revisions by 9 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client function}}
{{Client function}}
This function allows you to get the camera's view mode. This indicates at what distance the camera will follow the player.
This function allows you to get the active camera view modes. This indicates at what distance the camera will follow the player or vehicle.
*'''Note:''' It currently only returns vehicle view modes


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
int getCameraViewMode ( )
int, int getCameraViewMode ( )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||Camera.getCameraViewMode|viewMode|setCameraViewMode}}


===Returns===
===Returns===
Returns an [[int]] indicating the current camera view mode. Their meanings can be seen below.
{{Deprecated items|3.0159|1.5.8|Returns an [[int]] indicating the current vehicle camera view mode. Their meanings can be seen below.|20851}}
 
{{Added feature/item|1.5.9|1.5.8|20851|Returns two [[int|ints]] indicating the current vehicle and ped camera view mode respectively. Their meanings can be seen below.}}


{{Camera view modes}}
{{Camera view modes}}


==Example==
==Example==
This example tells the player their current camera view when they change it
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- TODO
function onPlayerSpawn(theSpawnpoint)
    currentCam("fire") -- start a repeating check
end
addEventHandler("onClientPlayerSpawn", root, onPlayerSpawn)
 
function currentCam(key)
  if (getControlState(key)) then
      local vehicleMode, pedMode = getCameraViewMode()
      outputChatBox("Your current cam view is: " .. vehicleMode .. ".")
  end
end
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Client camera functions}}
{{Client camera functions}}
[[Category:Needs_Example]]
 
[[hu:getCameraViewMode]]
[[RO:getCameraViewMode]]

Latest revision as of 21:41, 23 September 2021

This function allows you to get the active camera view modes. This indicates at what distance the camera will follow the player or vehicle.

Syntax

int, int getCameraViewMode ( )

OOP Syntax Help! I don't understand this!

Method: Camera.getCameraViewMode(...)
Variable: .viewMode
Counterpart: setCameraViewMode


Returns

BEFORE VERSION 1.5.8 r20851:
Returns an int indicating the current vehicle camera view mode. Their meanings can be seen below.

Returns two ints indicating the current vehicle and ped camera view mode respectively. Their meanings can be seen below.

Vehicle Modes:

  • 0: Bumper
  • 1: Close external
  • 2: Middle external
  • 3: Far external
  • 4: Low external
  • 5: Cinematic

Ped Modes:

  • 1: Close
  • 2: Middle
  • 3: Far

Example

This example tells the player their current camera view when they change it

function onPlayerSpawn(theSpawnpoint)
    currentCam("fire") -- start a repeating check
end
addEventHandler("onClientPlayerSpawn", root, onPlayerSpawn)

function currentCam(key)
   if (getControlState(key)) then
      local vehicleMode, pedMode = getCameraViewMode()
      outputChatBox("Your current cam view is: " .. vehicleMode .. ".")
   end
end

See Also