Difference between revisions of "Osiris/API/FadeToBlack"
From Divinity Engine Wiki
m (Deprecated) |
m |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
===== Full Definition(s) ===== | ===== Full Definition(s) ===== | ||
* call '''FadeToBlack'''(''(CHARACTERGUID)'''''_Character''', ''(REAL)'''''_Seconds''', ''(INTEGER)'''''_ToBlack''', ''(STRING)'''''_FadeID''') | * call '''FadeToBlack'''(''(CHARACTERGUID)'''''_Character''', ''(REAL)'''''_Seconds''', ''(INTEGER)'''''_ToBlack''', ''(STRING)'''''_FadeID''') | ||
| Line 6: | Line 4: | ||
Fades the screen either from or to black for the user that controls '''_Character'''. The fade will last for '''_Seconds''' seconds; the longer this time, the slower the fade operation. '''Important''': for backwards compatibility, the '''_ToBlack''' parameter behaves opposite of what you would expect. Passing '''0''' as this value will fade a regular game screen '''to''' black, while passing '''1''' will fade '''from''' a blacked-out screen back to normal. If you faded '''to''' black, once the fade operation has finished a [[Osiris/API/FadeDone|FadeDone]] event will be raised. If you faded '''from''' black, once the fade operation has finished a [[Osiris/API/ClearFadeDone|ClearFadeDone]] event will be raised | Fades the screen either from or to black for the user that controls '''_Character'''. The fade will last for '''_Seconds''' seconds; the longer this time, the slower the fade operation. '''Important''': for backwards compatibility, the '''_ToBlack''' parameter behaves opposite of what you would expect. Passing '''0''' as this value will fade a regular game screen '''to''' black, while passing '''1''' will fade '''from''' a blacked-out screen back to normal. If you faded '''to''' black, once the fade operation has finished a [[Osiris/API/FadeDone|FadeDone]] event will be raised. If you faded '''from''' black, once the fade operation has finished a [[Osiris/API/ClearFadeDone|ClearFadeDone]] event will be raised | ||
===== Notes ===== | ===== Notes ===== | ||
| − | |||
* Only call this routine for one character per user. | * Only call this routine for one character per user. | ||
| + | * Deprecated. Use the less confusing [[Osiris/API/FadeOutBlack|FadeOutBlack]] and [[Osiris/API/FadeOutWhite|FadeOutWhite]] calls instead. | ||
| + | |||
===== See Also ===== | ===== See Also ===== | ||
* [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]] | * [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]] | ||
* [[Osiris/API/ClearFadeDone|ClearFadeDone]] | * [[Osiris/API/ClearFadeDone|ClearFadeDone]] | ||
| + | * [[Osiris/API/FadeIn|FadeIn]] | ||
* [[Osiris/API/FadeDone|FadeDone]] | * [[Osiris/API/FadeDone|FadeDone]] | ||
| − | |||
* [[Osiris/API/FadeOutBlack|FadeOutBlack]] | * [[Osiris/API/FadeOutBlack|FadeOutBlack]] | ||
* [[Osiris/API/FadeOutWhite|FadeOutWhite]] | * [[Osiris/API/FadeOutWhite|FadeOutWhite]] | ||
| − | [[Category:Osiris Calls]] | + | [[Category:Osiris Calls|FadeToBlack]] |
Latest revision as of 15:11, 13 September 2018
Full Definition(s)
- call FadeToBlack((CHARACTERGUID)_Character, (REAL)_Seconds, (INTEGER)_ToBlack, (STRING)_FadeID)
Description
Fades the screen either from or to black for the user that controls _Character. The fade will last for _Seconds seconds; the longer this time, the slower the fade operation. Important: for backwards compatibility, the _ToBlack parameter behaves opposite of what you would expect. Passing 0 as this value will fade a regular game screen to black, while passing 1 will fade from a blacked-out screen back to normal. If you faded to black, once the fade operation has finished a FadeDone event will be raised. If you faded from black, once the fade operation has finished a ClearFadeDone event will be raised
Notes
- Only call this routine for one character per user.
- Deprecated. Use the less confusing FadeOutBlack and FadeOutWhite calls instead.
