FadeCamera

此函数将使玩家的相机在指定的时间段内淡入某一颜色或恢复正常。这也会影响播放器的音量（50%淡入=50%音量，完全淡入=无声音）。对于客户端脚本，您可以一行执行两个淡入淡出，但是对于服务器端脚本，您必须先使用一个，然后使用另一个.

[[{{{image}}}|link=|]]	Note: The speed of the effect depends directly on the current gamespeed.

Syntax

Click to collapse [-]

Server

bool fadeCamera ( player thePlayer, bool fadeIn, [ float timeToFade = 1.0, int red = 0, int green = 0, int blue = 0 ] )

OOP Syntax Help! I don't understand this!

Method: player:fadeCamera(...)

Required Arguments

• thePlayer: The player whose camera you wish to fade.
• fadeIn: Should the camera be faded in or out? Pass true to fade the camera in, false to fade it out to a color.

Optional Arguments

• timeToFade: The number of seconds it should take to fade.
• red: The amount of red in the color that the camera fades out to (0 - 255). Not required for fading in.
• green: The amount of green in the color that the camera fades out to (0 - 255). Not required for fading in.
• blue: The amount of blue in the color that the camera fades out to (0 - 255). Not required for fading in.

Click to collapse [-]

Client

bool fadeCamera ( bool fadeIn, [ float timeToFade = 1.0, int red = 0, int green = 0, int blue = 0 ] )

OOP Syntax Help! I don't understand this!

Method: Camera.fade(...)

Required Arguments

• fadeIn: Should the camera be faded in our out? Pass true to fade the camera in, false to fade it out to a color.

Optional Arguments

• timeToFade: The number of seconds it should take to fade.
• red: The amount of red in the color that the camera fades out to (0 - 255). Not required for fading in.
• green: The amount of green in the color that the camera fades out to (0 - 255). Not required for fading in.
• blue: The amount of blue in the color that the camera fades out to (0 - 255). Not required for fading in.

Returns

Returns true if the camera was faded successfully, false if invalid arguments were passed to the function.

Example

Click to collapse [-]

Server example

When a player gets damaged, place a quick fade-to-red effect on his screen.

function addRednessOnDamage ( )
      fadeCamera ( source, false, 1.0, 255, 0, 0 )         -- fade the player's camera to red over a period of 1 second
      setTimer ( fadeCameraDelayed, 500, 1, source )   -- don't let it go to opaque red, interrupt it after half a second and fade back to normal
end
addEventHandler ( "onPlayerDamage", root, addRednessOnDamage )

function fadeCameraDelayed(player) -- This function prevents debug warnings when the player disconnects while the timer is running.
      if (isElement(player)) then
            fadeCamera(player, true, 0.5)
      end
end

See Also

• fadeCamera
• getCameraInterior
• getCameraMatrix
• getCameraTarget
• setCameraInterior
• setCameraMatrix
• setCameraTarget