Multi Theft Auto: Wiki - User contributions [en]

DxSetBlendMode

2022-09-30T22:19:12Z

Andres28: /* Example */

{{Client function}}
__NOTOC__
This function sets the current blend mode for the dxDraw functions. Changing the blend mode can increase the quality when drawing text or certain other images to a render target. As a general guide use '''modulate_add''' when drawing text to a render target, and '''add''' when drawing the render target to the screen. Don't forget to restore the default '''blend''' at the end - See the example below.

==Syntax==
<syntaxhighlight lang="lua">
bool dxSetBlendMode ( string blendMode )
</syntaxhighlight>

===Required Arguments===
*'''blendMode :''' The blend mode to use which can be one of:
**'''blend:''' The source textures are alpha blended to the screen/render target. This is the default mode for drawing and gives the results we all know and love.
**'''add:''' The source textures are added to the screen/render target.
**'''modulate_add:''' The source textures are multiplied by the alpha and then added to the screen/render target.
**'''overwrite :''' The source textures are overwritten. This can be useful for clearing render targets.

==Returns==
Returns true if successful, or ''false'' if invalid arguments were passed to the function.

==Example==
<section name="Client" class="client" show="true">
This example shows how to use '''modulate_add''' and '''add''' to avoid quality problems when using a render target:
<syntaxhighlight lang="lua">
local myRenderTarget = dxCreateRenderTarget(500, 500, true)

--
-- Function to draw text to our render target texture when the 'r' key is pressed
--
function updateRenderTarget()
dxSetRenderTarget(myRenderTarget, true)
dxSetBlendMode("modulate_add") -- Set 'modulate_add' when drawing stuff on the render target

dxDrawText("Testing "..getTickCount(), 0, 0, 0, 0, tocolor(255, 255, 255, 255), 2, "clear")

dxSetBlendMode("blend") -- Restore default blending
dxSetRenderTarget() -- Restore default render target
end
bindKey("r", "down", updateRenderTarget )

--
-- Display render target contents
--
addEventHandler("onClientRender", root,
function()
dxSetBlendMode("add") -- Set 'add' when drawing the render target on the screen
dxDrawImage(100, 200, 500, 500, myRenderTarget, -10)
dxSetBlendMode("blend") -- Restore default blending
end
)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.03782|}}

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04425|Added overwrite }}

==See Also==
{{Drawing_functions}}

[[hu:dxSetBlendMode]]

GetVehicleRespawnPosition

2022-09-29T01:21:24Z

Andres28: /* Example */

{{Server function}}
__NOTOC__
{{New feature/item|3.0156|1.5.5|14053|This function retrieves the respawn coordinates of a [[vehicle]].}}

==Syntax==
<syntaxhighlight lang="lua">
float float float getVehicleRespawnPosition ( element theVehicle )
</syntaxhighlight>
{{OOP||[[vehicle]]:getRespawnPosition|respawnPosition|setVehicleRespawnPosition}}

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] which you'd like to retrieve the respawn coordinates of.

===Returns===
Returns three [[float|floats]] indicating the respawn coordinates of the [[vehicle]], ''x'', ''y'' and ''z'' respectively.

==Example==
This example outputs the player's current vehicle respawn position.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getRespawnPosition(player)
local veh = getPedOccupiedVehicle(player)
if veh then
local x,y,z = getVehicleRespawnPosition(veh)
local rx,ry,rz = getVehicleRespawnRotation(veh)
outputChatBox("this car respawn in x = "..x.." y = "..y.." z = "..z.." rx = "..rx.." ry = "..rz,player,0,255,0)
else
outputChatBox("you are not in the car",player,255,0,0)
end
end
addCommandHandler("getRespawnPos",getRespawnPosition)
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}

GetVehicleRespawnRotation

2022-09-29T01:20:39Z

Andres28: /* Example */

{{Server function}}
__NOTOC__
{{New feature/item|3.0156|1.5.5|14053|This function retrieves the respawn rotation of a [[vehicle]].}}

==Syntax==
<syntaxhighlight lang="lua">
float float float getVehicleRespawnRotation ( element theVehicle )
</syntaxhighlight>
{{OOP||[[vehicle]]:getRespawnRotation|respawnRotation}}

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] which you'd like to retrieve the respawn rotation of.

===Returns===
Returns three [[float|floats]] indicating the respawn rotation of the [[vehicle]], ''x'', ''y'' and ''z'' respectively.

==Example==
This example outputs the player's current vehicle respawn position.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getRespawnPosition(player)
local veh = getPedOccupiedVehicle(player)
if veh then
local x,y,z = getVehicleRespawnPosition(veh)
local rx,ry,rz = getVehicleRespawnRotation(veh)
outputChatBox("this car respawn in x = "..x.." y = "..y.." z = "..z.." rx = "..rx.." ry = "..rz,player,0,255,0)
else
outputChatBox("you are not in the car",player,255,0,0)
end
end
addCommandHandler("getRespawnPos",getRespawnPosition)
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}

GetVehicleRespawnRotation

2022-09-29T01:19:48Z

Andres28: /* Example */

{{Server function}}
__NOTOC__
{{New feature/item|3.0156|1.5.5|14053|This function retrieves the respawn rotation of a [[vehicle]].}}

==Syntax==
<syntaxhighlight lang="lua">
float float float getVehicleRespawnRotation ( element theVehicle )
</syntaxhighlight>
{{OOP||[[vehicle]]:getRespawnRotation|respawnRotation}}

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] which you'd like to retrieve the respawn rotation of.

===Returns===
Returns three [[float|floats]] indicating the respawn rotation of the [[vehicle]], ''x'', ''y'' and ''z'' respectively.

==Example==
This example outputs the player's current vehicle respawn position.
<section name="Server" class="server" show="true">
<syntaxhighlight >
function getRespawnPosition(player)
local veh = getPedOccupiedVehicle(player)
if veh then
local x,y,z = getVehicleRespawnPosition(veh)
local rx,ry,rz = getVehicleRespawnRotation(veh)
outputChatBox("this car respawn in x = "..x.." y = "..y.." z = "..z.." rx = "..rx.." ry = "..rz,player,0,255,0)
else
outputChatBox("you are not in the car",player,255,0,0)
end
end
addCommandHandler("getRespawnPos",getRespawnPosition)
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}

GetVehicleRespawnPosition

2022-09-29T01:18:25Z

Andres28: /* Example */

{{Server function}}
__NOTOC__
{{New feature/item|3.0156|1.5.5|14053|This function retrieves the respawn coordinates of a [[vehicle]].}}

==Syntax==
<syntaxhighlight lang="lua">
float float float getVehicleRespawnPosition ( element theVehicle )
</syntaxhighlight>
{{OOP||[[vehicle]]:getRespawnPosition|respawnPosition|setVehicleRespawnPosition}}

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] which you'd like to retrieve the respawn coordinates of.

===Returns===
Returns three [[float|floats]] indicating the respawn coordinates of the [[vehicle]], ''x'', ''y'' and ''z'' respectively.

==Example==
This example outputs the player's current vehicle respawn position.
<section name="Server" class="server" show="true">
<syntaxhighlight >
function getRespawnPosition(player)
local veh = getPedOccupiedVehicle(player)
if veh then
local x,y,z = getVehicleRespawnPosition(veh)
local rx,ry,rz = getVehicleRespawnRotation(veh)
outputChatBox("this car respawn in x = "..x.." y = "..y.." z = "..z.." rx = "..rx.." ry = "..rz,player,0,255,0)
else
outputChatBox("you are not in the car",player,255,0,0)
end
end
addCommandHandler("getRespawnPos",getRespawnPosition)
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}

GetVehicleRespawnPosition

2022-09-29T01:16:26Z

Andres28: /* Example */

{{Server function}}
__NOTOC__
{{New feature/item|3.0156|1.5.5|14053|This function retrieves the respawn coordinates of a [[vehicle]].}}

==Syntax==
<syntaxhighlight lang="lua">
float float float getVehicleRespawnPosition ( element theVehicle )
</syntaxhighlight>
{{OOP||[[vehicle]]:getRespawnPosition|respawnPosition|setVehicleRespawnPosition}}

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] which you'd like to retrieve the respawn coordinates of.

===Returns===
Returns three [[float|floats]] indicating the respawn coordinates of the [[vehicle]], ''x'', ''y'' and ''z'' respectively.

==Example==
This example outputs the player's current vehicle respawn position.
<syntaxhighlight name="Server" class="server" show="true">
function getRespawnPosition(player)
local veh = getPedOccupiedVehicle(player)
if veh then
local x,y,z = getVehicleRespawnPosition(veh)
local rx,ry,rz = getVehicleRespawnRotation(veh)
outputChatBox("this car respawn in x = "..x.." y = "..y.." z = "..z.." rx = "..rx.." ry = "..rz,player,0,255,0)
else
outputChatBox("you are not in the car",player,255,0,0)
end
end
addCommandHandler("getRespawnPos",getRespawnPosition)
</syntaxhighlight>

==See Also==
{{Vehicle_functions}}