Difference between revisions of "Osiris/API/CameraActivate"

From Divinity Engine Wiki
Jump to: navigation, search
(Document CameraActivate)
 
m
 
(One intermediate revision by the same user not shown)
Line 3: Line 3:
 
* call '''CameraActivate'''(''(CHARACTERGUID)'''''_Character''', ''(STRING)'''''_Camera''', ''(REAL)'''''_Time''', ''(INTEGER)'''''_HideUI''', ''(INTEGER)'''''_Smooth''', ''(INTEGER)'''''_HideShroud''')
 
* call '''CameraActivate'''(''(CHARACTERGUID)'''''_Character''', ''(STRING)'''''_Camera''', ''(REAL)'''''_Time''', ''(INTEGER)'''''_HideUI''', ''(INTEGER)'''''_Smooth''', ''(INTEGER)'''''_HideShroud''')
 
===== Description =====
 
===== Description =====
Activates a camera (the SpectatorCameraTrigger with name '''_Camera''') for '''Character'''. The game will use this camera for '''_Time''' seconds. If '''_HideUI''' is '''1''', the hot bar and other UI elements will be hidden. If '''_Smooth''' is '''1''', the transition between the current camera view and the new one will be smoothed out. If '''_HideShroud''' is '''1''', all shroud will be cleared while this camera is active.
+
Activates a camera (the SpectatorCameraTrigger with name '''_Camera''') for '''Character'''. The game will use this camera for '''_Time''' seconds. If '''_HideUI''' is '''1''', the hotbar and other UI elements will be hidden while the camera is active. If '''_Smooth''' is '''1''', the transition between the current camera view and the new one will be smoothed out. If '''_HideShroud''' is '''1''', all shroud will be cleared while this camera is active.
 
===== Notes =====
 
===== Notes =====
 
* Only call this routine for one character per [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]].
 
* Only call this routine for one character per [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]].
Line 10: Line 10:
 
* [[Osiris/API/StartCameraSpline|StartCameraSpline]]
 
* [[Osiris/API/StartCameraSpline|StartCameraSpline]]
  
[[Category:Osiris Calls]]
+
[[Category:Osiris Calls|CameraActivate]]

Latest revision as of 16:04, 19 December 2017

Warningred.png
Deprecated. Use StartCameraSpline instead.
Full Definition(s)
  • call CameraActivate((CHARACTERGUID)_Character, (STRING)_Camera, (REAL)_Time, (INTEGER)_HideUI, (INTEGER)_Smooth, (INTEGER)_HideShroud)
Description

Activates a camera (the SpectatorCameraTrigger with name _Camera) for Character. The game will use this camera for _Time seconds. If _HideUI is 1, the hotbar and other UI elements will be hidden while the camera is active. If _Smooth is 1, the transition between the current camera view and the new one will be smoothed out. If _HideShroud is 1, all shroud will be cleared while this camera is active.

Notes
  • Only call this routine for one character per CharacterGetReservedUserID.
  • This routine has been deprecated because it does not work if a game is saved/loaded while a camera is active, and the camera focus can be easily cleared through external actions (e.g. joining combat).
See Also