Fernando187: Remove obsolete Requirements section

2024-11-07T17:34:39Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:34, 7 November 2024
Line 55:		Line 55:
	addEventHandler("onClientRender", root, draw)		addEventHandler("onClientRender", root, draw)
	</syntaxhighlight>		</syntaxhighlight>

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.5.7-9.19626\|}}~~

	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

FileEX: Legacy version

2024-05-27T13:33:59Z

Legacy version

New page

__NOTOC__
{{Client function}}
This function draws a 3D primitive 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 [[dxDrawPrimitive3D]]}}
<br>

{{Deprecated items|3.0159|1.5.9|
==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawPrimitive3D ( string primitiveType, bool postGUI, table vertex1, table vertex2, table vertex3 [, table vertex4, ...] )
</syntaxhighlight>

[[File:Primitive.png|thumb|A four vertex primitive example using "trianglefan"]]

===Required Arguments===
* '''primitiveType:''' The type of primitive to be drawn. This could be:
"pointlist"
"linelist"
"linestrip"
"trianglefan"
"trianglelist"
"trianglestrip"
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).
* '''vertex1:''' A table with the coordinates of the vertex plus its color.
* '''vertex2:''' A table with the coordinates of the vertex plus its color.
* '''vertex3:''' A table with the coordinates of the vertex plus its color.

The vertex should be passed like this:
<syntaxhighlight lang="lua">
{x, y, z, color}
</syntaxhighlight>

==Optional Arguments==
{{OptionalArg}}
* '''vertexN:''' A table with the coordinates of the vertex plus its color. You can add as much as you want.

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

==Example==
This is a small example of creating 3D Primitive object with 4 vertex that will spawn on 'The Well Stacked Pizza Co.' in Idlewood.
<syntaxhighlight lang="lua">
local primitive = {
{2087.8, -1804.2, 13.5, tocolor(255, 0, 0)},
{2087.7, -1810.5, 13.5, tocolor(0, 255, 0)},
{2092.7, -1813.6, 17.7, tocolor(0, 0, 255)},
{2097.5, -1806.8, 16, tocolor(255, 255, 255)}
}

function draw()
dxDrawPrimitive3D("trianglefan", false, unpack(primitive))
end
addEventHandler("onClientRender", root, draw)
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.5.7-9.19626|}}

==See Also==
{{Drawing_functions}}

Legacy/dxDrawPrimitive3D - Revision history

Fernando187: Remove obsolete Requirements section

FileEX: Legacy version