ShakeCamera: Difference between revisions
Jump to navigation
Jump to search
(Add shakeCamera by Tracer (https://github.com/multitheftauto/mtasa-blue/pull/3585)) |
mNo edit summary |
||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{Client function}} | {{Client function}} | ||
__NOTOC__ | __NOTOC__ | ||
This function allows you to | {{Added feature/item|1.6.1|1.6.0|22631| | ||
This function allows you to trigger camera shake effect (just like explosion does). | |||
}} | |||
{{Note|The camera shaking duration depends on the force. High values can result in very long durations}} | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool shakeCamera( float | bool shakeCamera ( float force, [ float x, float y, float z ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required arguments=== | ===Required arguments=== | ||
*''' | *'''force''': Intensity and time of the shake. The higher the value, the longer the camera shakes | ||
===Optional Arguments=== | ===Optional Arguments=== | ||
| Line 21: | Line 25: | ||
==Example== | ==Example== | ||
This example allows you to constantly trigger camera shake effect in center of the map, the closer you are to center the stronger effect will be. | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | local shakeStrength = 1.4 -- define strength of the camera shake | ||
local shakePosX, shakePosY, shakePosZ = 0, 0, 3 -- define position where camera shake would happen | |||
function triggerCameraShake() | |||
shakeCamera(shakeStrength, shakePosX, shakePosY, shakePosZ) -- trigger camera shake | |||
end | |||
setTimer(triggerCameraShake, 100, 0) -- call this function indefinitely, every 100 ms | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{Client camera functions}} | {{Client camera functions}} | ||
Latest revision as of 08:55, 31 July 2024
Syntax
bool shakeCamera ( float force, [ float x, float y, float z ] )
Required arguments
- force: Intensity and time of the shake. The higher the value, the longer the camera shakes
Optional Arguments
- x: Center X coordinate of the shake.
- y: Center Y coordinate of the shake.
- z: Center Z coordinate of the shake.
If not given, it will defaults to local player position.
Returns
Always returns true.
Example
This example allows you to constantly trigger camera shake effect in center of the map, the closer you are to center the stronger effect will be.
local shakeStrength = 1.4 -- define strength of the camera shake local shakePosX, shakePosY, shakePosZ = 0, 0, 3 -- define position where camera shake would happen function triggerCameraShake() shakeCamera(shakeStrength, shakePosX, shakePosY, shakePosZ) -- trigger camera shake end setTimer(triggerCameraShake, 100, 0) -- call this function indefinitely, every 100 ms
See Also
- getCamera
- getCameraClip
- getCameraFieldOfView
- getCameraGoggleEffect
- getCameraViewMode
- setCameraClip
- setCameraFieldOfView
- setCameraGoggleEffect
- setCameraViewMode
- Shared
- fadeCamera
- getCameraInterior
- getCameraMatrix
- getCameraTarget
- setCameraInterior
- setCameraMatrix
- setCameraTarget