DxDrawMaterialPrimitive - Revision history

FIY9AL: /* Example */

2024-08-29T13:55:10Z

Example

← Older revision		Revision as of 13:55, 29 August 2024
Line 36:		Line 36:
	Returns a ''true'' if the operation was successful, ''false'' otherwise.		Returns a ''true'' if the operation was successful, ''false'' otherwise.

	==Example==		==Example==
			<syntaxhighlight lang="lua">
	-- Load the texture		-- Load the texture
	local texture = dxCreateTexture("myTexture.png")		local texture = dxCreateTexture("myTexture.png")
Line 51:		Line 52:
	-- Add an event handler to render the primitive every frame		-- Add an event handler to render the primitive every frame
	addEventHandler("onClientRender", root, renderPrimitive)		addEventHandler("onClientRender", root, renderPrimitive)
	~~{{Example}}~~		</syntaxhighlight>

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

FIY9AL: /* Example */

2024-08-29T13:54:06Z

Example

← Older revision		Revision as of 13:54, 29 August 2024
Line 37:		Line 37:

	==Example==		==Example==
			-- Load the texture
			local texture = dxCreateTexture("myTexture.png")

			-- Function to render a textured triangle
			function renderPrimitive()
			if texture then
			-- Draw the primitive using the "trianglelist" type
			-- 3 vertices, each with 4 numbers: {x, y, u, v}
			dxDrawMaterialPrimitive("trianglelist", texture, false, {100, 100, 0, 0}, {300, 100, 1, 0}, {200, 300, 0.5, 1})
			end
			end

			-- Add an event handler to render the primitive every frame
			addEventHandler("onClientRender", root, renderPrimitive)
	{{Example}}		{{Example}}

FIY9AL at 13:53, 29 August 2024

2024-08-29T13:53:31Z

← Older revision		Revision as of 13:53, 29 August 2024
Line 7:		Line 7:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table ~~vertice1~~ [, table ~~vertice2~~, ...] )		bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table vertex1 [, table vertex2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Line 14:		Line 14:
	* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.		* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.
	* '''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 27:		Line 27:

	==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.
	* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image		* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image
Line 36:		Line 36:
	Returns a ''true'' if the operation was successful, ''false'' otherwise.		Returns a ''true'' if the operation was successful, ''false'' otherwise.

	~~-- Load the texture~~		==Example==
	~~local texture~~ = ~~dxCreateTexture("myTexture.png")~~		{{Example}}

	~~-- Function to render a textured triangle~~
	~~function renderPrimitive()~~
	~~if texture then~~
	~~-- Draw the primitive using the "trianglelist" type~~
	~~-- 3 vertices, each with 4 numbers:~~ {~~x, y, u, v}~~
	~~dxDrawMaterialPrimitive("trianglelist", texture, false,~~ {~~100, 100, 0, 0~~}~~, {300, 100, 1, 0~~}~~, {200, 300, 0.5, 1})~~
	~~end~~
	~~end~~

	~~-- Add an event handler to render the primitive every frame~~
	~~addEventHandler("onClientRender", root, renderPrimitive)~~

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

FIY9AL: Undo revision 77048 by Dmi7ry (talk)

2024-08-29T13:52:45Z

Undo revision 77048 by Dmi7ry (talk)

← Older revision		Revision as of 13:52, 29 August 2024
Line 7:		Line 7:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table ~~vertex1~~ [, table ~~vertex2~~, ...] )		bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table vertice1 [, table vertice2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Line 14:		Line 14:
	* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.		* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.
	* '''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 ~~vertex~~, required amount of them is determined by primitive type.		* '''vertices:''' Tables representing each primitive vertice, required amount of them is determined by primitive type.

	==Allowed types==		==Allowed types==
Line 27:		Line 27:

	==Vertices format==		==Vertices format==
	* '''posX:''' An float representing the absolute X position of the ~~vertex~~, represented by pixels on the screen.		* '''posX:''' An float representing the absolute X 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.		* '''posY:''' An float representing the absolute Y position of the vertice, 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.
	* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image		* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image

FIY9AL: The dxDrawMaterialPrimitive function in MTA allows you to draw 2D or 3D textured primitives by passing the vertex data directly as individual arguments.

2024-08-29T13:51:51Z

The dxDrawMaterialPrimitive function in MTA allows you to draw 2D or 3D textured primitives by passing the vertex data directly as individual arguments.

← Older revision		Revision as of 13:51, 29 August 2024
Line 36:		Line 36:
	Returns a ''true'' if the operation was successful, ''false'' otherwise.		Returns a ''true'' if the operation was successful, ''false'' otherwise.

	=~~=Example==~~		-- Load the texture
	{{~~Example~~}}		local texture = dxCreateTexture("myTexture.png")

			-- Function to render a textured triangle
			function renderPrimitive()
			if texture then
			-- Draw the primitive using the "trianglelist" type
			-- 3 vertices, each with 4 numbers: {x, y, u, v}
			dxDrawMaterialPrimitive("trianglelist", texture, false, {100, 100, 0, 0}, {300, 100, 1, 0}, {200, 300, 0.5, 1})
			end
			end

			-- Add an event handler to render the primitive every frame
			addEventHandler("onClientRender", root, renderPrimitive)

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

Dmi7ry at 06:29, 17 June 2023

2023-06-17T06:29:47Z

← Older revision		Revision as of 06:29, 17 June 2023
Line 7:		Line 7:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table ~~vertice1~~ [, table ~~vertice2~~, ...] )		bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table vertex1 [, table vertex2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Line 14:		Line 14:
	* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.		* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.
	* '''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 27:		Line 27:

	==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.
	* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image		* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image

Qaisjp: fix ver

2019-06-27T15:37:51Z

fix ver

← 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 with material applied to it 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 with material applied to it across the screen - rendered for one frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.
	If image file is used, it should ideally have dimensions that are a power of two, to prevent possible blurring.		If image file is used, it should ideally have dimensions that are a power of two, to prevent possible blurring.
	Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...}}		Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...}}

StrixG at 20:01, 4 January 2019

2019-01-04T20:01:13Z

← Older revision		Revision as of 20:01, 4 January 2019
Line 7:		Line 7:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool ~~dxDrawPrimitive~~ ( primitiveType pType, mixed material, bool postGUI, table vertice1 [, table vertice2, ...] )		bool dxDrawMaterialPrimitive ( primitiveType pType, mixed material, bool postGUI, table vertice1 [, table vertice2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Surge at 19:41, 25 October 2018

2018-10-25T19:41:33Z

← Older revision		Revision as of 19:41, 25 October 2018
Line 41:		Line 41:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

			[[hu:dxDrawMaterialPrimitive]]

Myonlake at 16:58, 6 September 2018

2018-09-06T16:58:50Z

← 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 with material applied to it 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 with material applied to it across the screen - rendered for one frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.
	If image file is used, it should ideally have dimensions that are a power of two, to prevent possible blurring.		If image file is used, it should ideally have dimensions that are a power of two, to prevent possible blurring.
	Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...}}		Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...}}