DxDrawRectangle3D - Revision history

IManGaaX at 05:17, 23 March 2025

2025-03-23T05:17:19Z

← Older revision		Revision as of 05:17, 23 March 2025
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
	__NOTOC__		__NOTOC__
	{{~~Note~~\|Useless function, use [[DxDrawLine3D]] or [[DxDrawMaterialLine3D]] instead.}}		{{Delete\|Useless function, use [[DxDrawLine3D]] or [[DxDrawMaterialLine3D]] instead.}}
	This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.		This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.

Myonlake at 22:02, 2 April 2023

2023-04-02T22:02:04Z

← Older revision		Revision as of 22:02, 2 April 2023
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
	__NOTOC__		__NOTOC__
	{{~~Delete~~\|Useless function, use [[DxDrawLine3D]] or [[DxDrawMaterialLine3D]] instead.}}		{{Note\|Useless function, use [[DxDrawLine3D]] or [[DxDrawMaterialLine3D]] instead.}}
	This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.		This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.

LordHenry at 16:59, 17 January 2023

2023-01-17T16:59:24Z

← Older revision		Revision as of 16:59, 17 January 2023
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
	__NOTOC__		__NOTOC__
			{{Delete\|Useless function, use [[DxDrawLine3D]] or [[DxDrawMaterialLine3D]] instead.}}
	This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.		This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.

Jusonex: Fixed syntax error (in the example script)

2012-08-28T10:53:24Z

Fixed syntax error (in the example script)

← Older revision		Revision as of 10:53, 28 August 2012
Line 44:		Line 44:
	dxDrawRectangle3D(0,0, 20, 20, 20, tocolor(255,255,255,255))		dxDrawRectangle3D(0,0, 20, 20, 20, tocolor(255,255,255,255))
	end		end
	~~end~~)		)
	</syntaxhighlight>		</syntaxhighlight>

Qaisjp: fixed example

2012-07-24T23:43:48Z

fixed example

← Older revision		Revision as of 23:43, 24 July 2012
Line 44:		Line 44:
	dxDrawRectangle3D(0,0, 20, 20, 20, tocolor(255,255,255,255))		dxDrawRectangle3D(0,0, 20, 20, 20, tocolor(255,255,255,255))
	end		end
	end		end)
	</syntaxhighlight>		</syntaxhighlight>

MrX at 01:02, 27 June 2012

2012-06-27T01:02:32Z

← Older revision		Revision as of 01:02, 27 June 2012
Line 31:		Line 31:
	local white = tocolor(255,255,255,255)		local white = tocolor(255,255,255,255)
	function dxDrawRectangle3D(x,y,z,w,h,c,r,...)		function dxDrawRectangle3D(x,y,z,w,h,c,r,...)
	~~r = r or 0~~		local lx, ly, lz = x+w, y+h, (z+tonumber(r or 0)) or z
	local lx, ly, lz = x+w, y+h, (z+tonumber(r)) or z
	return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, dot, h, c or white, ...)		return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, dot, h, c or white, ...)
	end		end

MrX: fixed rotation being an optional parameter

2012-06-27T01:02:01Z

fixed rotation being an optional parameter

← Older revision		Revision as of 01:02, 27 June 2012
Line 31:		Line 31:
	local white = tocolor(255,255,255,255)		local white = tocolor(255,255,255,255)
	function dxDrawRectangle3D(x,y,z,w,h,c,r,...)		function dxDrawRectangle3D(x,y,z,w,h,c,r,...)
			r = r or 0
	local lx, ly, lz = x+w, y+h, (z+tonumber(r)) or z		local lx, ly, lz = x+w, y+h, (z+tonumber(r)) or z
	return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, dot, h, c or white, ...)		return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, dot, h, c or white, ...)

Qaisjp at 12:53, 26 June 2012

2012-06-26T12:53:57Z

← Older revision		Revision as of 12:53, 26 June 2012
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}

	__NOTOC__		__NOTOC__
	This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.		This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.
Line 10:		Line 9:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool dxDrawRectangle3D ( float x, float y, float z, float width, float height, int color[, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>		<syntaxhighlight lang="lua">bool dxDrawRectangle3D ( float x, float y, float z, float width, float height[, int color, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>

			===Required Arguments===
			* '''X/Y/Z:''' The start position of the 3D rectangle, representing a coordinate in the GTA world.
			* '''width:''' The width of the rect in GTA world units. (This is 1/75th of the width used in dxDrawLine3D)
			* '''height:''' The height of the rect in GTA world units. (This is 1/75th of the width used in dxDrawLine3D)

			==Optional Arguments==
			{{OptionalArg}}
			* '''color:''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
			* '''rotation:''' Rotation (end point of the rect) offset
			* '''faceTowardX/Y/Z:''' The direction the front of the rect should face towards. If this is not set, the front of the rect always faces toward the camera.

	===~~Required Arguments~~===		===Returns===
	* none		Returns a ''true'' if the operation was successful, ''false'' otherwise.

	==Code==		==Code==

Qaisjp at 12:48, 26 June 2012

2012-06-26T12:48:13Z

← Older revision		Revision as of 12:48, 26 June 2012
Line 10:		Line 10:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool ~~dxDrawRectangle~~ ( float x, float y, float z, float width, float height, int color[, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>		<syntaxhighlight lang="lua">bool dxDrawRectangle3D ( float x, float y, float z, float width, float height, int color[, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>

	===Required Arguments===		===Required Arguments===

Qaisjp: Created page with "{{Useful Function}} NOTOC This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be us..."

2012-06-26T12:46:31Z

Created page with "{{Useful Function}} __NOTOC__ This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - rendered for one frame This should be us..."

New page

{{Useful Function}}

__NOTOC__
This function draws a textured 3D line between two points in the 3D world that appers to be a rectangle - 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, hence the possibility 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.<br>
* '''NOTE:''' This is made to be used clientside!.

==Syntax==
<syntaxhighlight lang="lua">bool dxDrawRectangle ( float x, float y, float z, float width, float height, int color[, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>

===Required Arguments===
* none

==Code==
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
local dot = dxCreateTexture(1,1)
local white = tocolor(255,255,255,255)
function dxDrawRectangle3D(x,y,z,w,h,c,r,...)
local lx, ly, lz = x+w, y+h, (z+tonumber(r)) or z
return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, dot, h, c or white, ...)
end
</syntaxhighlight>
</section>

==Example==
This draws a white rectangle in the middle of the GTA world for no reason
<syntaxhighlight lang="lua">
addEventHandler("onClientRender", root,
function()
dxDrawRectangle3D(0,0, 20, 20, 20, tocolor(255,255,255,255))
end
end
</syntaxhighlight>

Author: qaisjp

==See Also==
{{Useful_Functions}}