FileEX: FileEX moved page DxDrawLine3D legacy to Legacy/DxDrawLine3D

2024-05-27T12:49:23Z

FileEX moved page DxDrawLine3D legacy to Legacy/DxDrawLine3D

← Older revision	Revision as of 12:49, 27 May 2024
(No difference)

FileEX: Legacy versions

2024-05-27T12:48:10Z

Legacy versions

New page

__NOTOC__
{{Client function}}
This function draws a 3D line between two points in the 3D world - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.

{{Note|This page only contains legacy implementations. For current implementation check [[dxDrawLine3D]]}}
<br>
{{Deprecated items|3.0159|1.5.9|
==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ [, int color = 0xFFFFFFFF, float width = 1.0, bool postGUI = false ] )
</syntaxhighlight>

===Required Arguments===
* '''startX:''' The start X position of the 3D line, representing a coordinate in the GTA world.
* '''startY:''' The start Y position of the 3D line, representing a coordinate in the GTA world.
* '''startZ:''' The start Z position of the 3D line, representing a coordinate in the GTA world.
* '''endX:''' The end X position of the 3D line, representing a coordinate in the GTA world.
* '''endY:''' The end Y position of the 3D line, representing a coordinate in the GTA world.
* '''endZ:''' The end Z position of the 3D line, representing a coordinate in the GTA world.

==Optional Arguments==
{{OptionalArg}}
* '''color:''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB.
* '''width:''' The width/thickness of the line
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.
|22465}}

==Example==
This is a small example of creating 3D Line / "Rope" between vehicle and player.
<syntaxhighlight lang="lua">
function makeLineAppear()
testVehicle = createVehicle ( 411, 0, 0, 5 ) -- Create our test vehicle.
addEventHandler("onClientRender", root, createLine) -- onClientRender keeps the 3D Line visible.
end
function createLine ( )
x1, y1, z1 = getElementPosition ( testVehicle ) -- Get test vehicles position.
x2, y2, z2 = getElementPosition ( localPlayer ) -- Get local players position.
dxDrawLine3D ( x1, y1, z1, x2, y2, z2, tocolor ( 0, 255, 0, 230 ), 2) -- Create 3D Line between test vehicle and local player.
end
addCommandHandler("line", makeLineAppear)
</syntaxhighlight>

==See Also==
{{Drawing_functions}}

Legacy/DxDrawLine3D - Revision history

FileEX: FileEX moved page DxDrawLine3D legacy to Legacy/DxDrawLine3D

FileEX: Legacy versions