Fernando187: Remove obsolete Requirements section

2024-11-07T17:34:28Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:34, 7 November 2024
Line 49:		Line 49:
	end)		end)
	</syntaxhighlight>		</syntaxhighlight>

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.3.0-9.03931\|}}~~

	==Changelog==		==Changelog==

FileEX: Legacy version

2024-05-27T13:27:20Z

Legacy version

New page

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

The 3D line with a large width value effectively becomes a rectangle, so it it possible to construct basic shapes such as boxes with several large width lines and the appropriate values for 'faceToward'.

3D lines are drawn at a particular place in the [[Game_Processing_Order|game processing order]], so use [[onClientPreRender]] for drawing if you are attaching them to world elements.

{{Note|This page only contains legacy implementations. For current implementation check [[dxDrawMaterialLine3D]]}}
<br>

{{Deprecated items|3.0159|1.5.9|
==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawMaterialLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ, [ bool flipUV = false, ] element material, float width,
[ int color = white, [ bool postGUI = false, ] float faceTowardX, float faceTowardY, float faceTowardZ ] )
</syntaxhighlight>

===Required Arguments===
* '''startX/Y/Z:''' The start position of the 3D line, representing a coordinate in the GTA world.
* '''endX/Y/Z:''' The end position of the 3D line, representing a coordinate in the GTA world.
* '''material:''' A [[material]] to draw the line with.
* '''width:''' The width/thickness of the line in GTA world units. (This is 1/75th of the width used in dxDrawLine3D)

==Optional Arguments==
{{OptionalArg}}
{{Added feature/item|1.5.9|1.5.8|20862|
* '''flipUV''': A bool representing whether a UV orientation should be flipped.
}}
* '''color:''' An [[int|integer]] of the hex color, produced using [[tocolor]] or 0xAARRGGBB.
* '''postGUI''': A bool representing whether the line should be drawn on top of or behind any ingame GUI.
* '''faceTowardX/Y/Z:''' The position the front of the line should face towards. If this is not set, the camera position is used, so the front of the line faces toward the camera.

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

==Example==
Draws [[:File:DxDrawMaterialLine3D-example.png|an image]] in coordiantes -2422.68555, -608.78986, 132.56250:
<syntaxhighlight lang="lua">
local redcircle = dxCreateTexture("red.png")

x,y,z = -2422.68555, -608.78986, 132.56250

size = 1

addEventHandler("onClientRender", root, function()
dxDrawMaterialLine3D(x+size, y+size, z-0.95, x-size, y-size, z-0.95, redcircle, size*2,tocolor(255, 255, 255, 255), false, x, y, z)
end)
</syntaxhighlight>

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

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.5-9.11998|Added ''postGUI'' argument}}
{{ChangelogItem|1.5.8-9.20862|Added ''flipUV'' argument}}

==See Also==
{{Drawing_functions}}

Legacy/dxDrawMaterialLine3D - Revision history

Fernando187: Remove obsolete Requirements section

FileEX: Legacy version