DxDrawPrimitive - Revision history

Dmi7ry at 06:32, 17 June 2023

2023-06-17T06:32:46Z

← Older revision		Revision as of 06:32, 17 June 2023
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawPrimitive ( string pType, bool postGUI, table ~~vertice1~~ [, table ~~vertice2~~, ...] )		bool dxDrawPrimitive ( string pType, bool postGUI, table vertex1 [, table vertex2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Line 11:		Line 11:
	* '''pType:''' Type of primitive to be drawn.		* '''pType:''' Type of primitive to be drawn.
	* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).		* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).
	* '''vertices:''' Tables representing each primitive ~~vertice~~, required amount of them is determined by primitive type.		* '''vertices:''' Tables representing each primitive vertex, required amount of them is determined by primitive type.

	==Allowed types==		==Allowed types==
Line 24:		Line 24:

	==Vertices format==		==Vertices format==
	* '''posX:''' An float representing the absolute X position of the ~~vertice~~, represented by pixels on the screen.		* '''posX:''' An float representing the absolute X position of the vertex, represented by pixels on the screen.
	* '''posY:''' An float representing the absolute Y position of the ~~vertice~~, represented by pixels on the screen.		* '''posY:''' An float representing the absolute Y position of the vertex, represented by pixels on the screen.
	* '''color (optional):''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue). If it's not specified, white color is used.		* '''color (optional):''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue). If it's not specified, white color is used.

Line 33:		Line 33:
	==Example==		==Example==
	<section name="Example 1" class="client" show="true">		<section name="Example 1" class="client" show="true">
	This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every ~~vertice~~ random color.		This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every vertex random color.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local vertices = {}		local vertices = {}
Line 39:		Line 39:
	if btn ~= "left" then return end		if btn ~= "left" then return end
	if state ~= "up" then return end		if state ~= "up" then return end
	local ~~vertice~~ = {x, y, tocolor(math.random(255), math.random(255), math.random(255))}		local vertex = {x, y, tocolor(math.random(255), math.random(255), math.random(255))}
	table.insert(vertices, ~~vertice~~)		table.insert(vertices, vertex)
	end		end
	addEventHandler("onClientClick", root, onClick)		addEventHandler("onClientClick", root, onClick)

Dragon: /* Example */ added yet another example, hidden by default because it just expands on the previous one and is probably more suited towards advanced users. also fixed a comment in the previous example to be fully accurate

2023-01-28T20:28:26Z

Example: added yet another example, hidden by default because it just expands on the previous one and is probably more suited towards advanced users. also fixed a comment in the previous example to be fully accurate

@@ Line 58: / Line 58: @@
 function resStart() -- do all this once during "onClientResourceStart", rather than every frame
 	local range = math.pi * 2 -- to get 1 complete oscillation of the sine wave we need the range from 0 to 2pi
-	local resolution = 100 -- resolution in this example means in how many steps we draw the linestrip, higher resolution means smoother curve at the expense of longer computation time
+	local resolution = 100 -- resolution in this example means in how many steps we draw the linestrip, higher resolution means smoother curve at the expense of longer computation time and higher memory usage
 	local scale = 50
 	for i=0,range,range/resolution do -- "loop through this [resolution] times, starting at 0 and ending at [range]"
@@ Line 70: / Line 70: @@
 function exampleRender()
 	dxDrawPrimitive("linestrip",true,unpack(sinCoords)) -- render a linestrip type primitive with the coordinates we calculated earlier to draw our sine wave
 end
 addEventHandler("onClientRender",getRootElement(),exampleRender)

Dragon: added another example using the linestrip type primitive

2023-01-23T17:15:34Z

added another example using the linestrip type primitive

@@ Line 32: / Line 32: @@
 ==Example==
 This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every vertice random color.
 <syntaxhighlight lang="lua">
@@ Line 48: / Line 49: @@
 addEventHandler("onClientPreRender", root, draw)
 </syntaxhighlight>
 ==See Also==

Motar2k: /* Example */

2020-04-05T21:02:47Z

Example

← Older revision		Revision as of 21:02, 5 April 2020
Line 32:		Line 32:

	==Example==		==Example==
	~~<section name="Client" class="client" show="true">~~
	This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every vertice random color.		This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every vertice random color.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 49:		Line 48:
	addEventHandler("onClientPreRender", root, draw)		addEventHandler("onClientPreRender", root, draw)
	</syntaxhighlight>		</syntaxhighlight>
	~~</section>~~

	==See Also==		==See Also==

Motar2k: /* Example */

2020-04-05T20:45:15Z

Example

← Older revision		Revision as of 20:45, 5 April 2020
Line 49:		Line 49:
	addEventHandler("onClientPreRender", root, draw)		addEventHandler("onClientPreRender", root, draw)
	</syntaxhighlight>		</syntaxhighlight>

	</section>		</section>

Motar2k: /* Example */

2020-04-05T20:44:49Z

Example

← Older revision		Revision as of 20:44, 5 April 2020
Line 31:		Line 31:
	Returns a ''true'' if the operation was successful, ''false'' otherwise.		Returns a ''true'' if the operation was successful, ''false'' otherwise.

	==Example==		==Example==
			<section name="Client" class="client" show="true">
	This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every vertice random color.		This is a small example that creates trianglefan primitive with vertices in places that user clicks. It assigns every vertice random color.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 48:		Line 49:
	addEventHandler("onClientPreRender", root, draw)		addEventHandler("onClientPreRender", root, draw)
	</syntaxhighlight>		</syntaxhighlight>

			</section>

	==See Also==		==See Also==

Qaisjp: fix version

2019-06-27T15:37:44Z

fix version

← Older revision		Revision as of 15:37, 27 June 2019
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Client function}}		{{Client function}}
	{{New feature/item\|3.0157\|1.5.6\|~~14203~~\|This function draws a 2D primitive shape across the screen - rendered for one frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.}}		{{New feature/item\|3.0157\|1.5.6\|14370\|This function draws a 2D primitive shape across the screen - rendered for one frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.}}

	==Syntax==		==Syntax==

Surge at 17:11, 26 October 2018

2018-10-26T17:11:35Z

← Older revision		Revision as of 17:11, 26 October 2018
Line 51:		Line 51:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

			[[hu:dxDrawPrimitive]]

Emiliano Castro at 15:15, 7 October 2018

2018-10-07T15:15:46Z

← Older revision		Revision as of 15:15, 7 October 2018
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawPrimitive ( ~~primitiveType~~ pType, bool postGUI, table vertice1 [, table vertice2, ...] )		bool dxDrawPrimitive ( string pType, bool postGUI, table vertice1 [, table vertice2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Myonlake at 16:58, 6 September 2018

2018-09-06T16:58:58Z

← Older revision		Revision as of 16:58, 6 September 2018
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Client function}}		{{Client function}}
	{{New feature/item\|3.~~0156~~\|1.5.5\|14203\|This function draws a 2D primitive shape across the screen - rendered for one frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.}}		{{New feature/item\|3.0157\|1.5.6\|14203\|This function draws a 2D primitive shape across the screen - rendered for one frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.}}

	==Syntax==		==Syntax==