DxDrawImage3D - Revision history

Kirukiru: Typo? (another float width arg after element material

2019-12-19T13:48:43Z

Typo? (another float width arg after element material

← Older revision		Revision as of 13:48, 19 December 2019
Line 8:		Line 8:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool dxDrawImage3D ( float x, float y, float z, float width, float height, element material~~, float width~~,		<syntaxhighlight lang="lua">bool dxDrawImage3D ( float x, float y, float z, float width, float height, element material,
	[ int color = white, float rotation = 0, [ bool postGUI = false, ] float faceTowardX, float faceTowardY, float faceTowardZ ] )</syntaxhighlight>		[ int color = white, float rotation = 0, [ bool postGUI = false, ] float faceTowardX, float faceTowardY, float faceTowardZ ] )</syntaxhighlight>

Myonlake: /* Code */

2018-07-08T15:42:05Z

Code

← Older revision		Revision as of 15:42, 8 July 2018
Line 33:		Line 33:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function dxDrawImage3D( x, y, z, width, height, material, color, rotation, ... )		function dxDrawImage3D( x, y, z, width, height, material, color, rotation, ... )
	return dxDrawMaterialLine3D( x, y, z, x + width, y + height, ( z + tonumber( rotation or 0 ) ~~) or z~~, material, height, color or 0xFFFFFFFF, ... )		return dxDrawMaterialLine3D( x, y, z, x + width, y + height, z + tonumber( rotation or 0 ), material, height, color or 0xFFFFFFFF, ... )
	end		end
	</syntaxhighlight>		</syntaxhighlight>

Myonlake at 15:39, 8 July 2018

2018-07-08T15:39:33Z

← Older revision		Revision as of 15:39, 8 July 2018
Line 1:		Line 1:
			__NOTOC__
	{{Useful Function}}		{{Useful Function}}
	~~__NOTOC__~~
	This function draws a textured 3D line between two points in the 3D world that appers to be a 3D image - 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 3D image - 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 and a texture effectively becomes a 3D image, hence the possibility to construct basic shapes such as boxes with several large width lines and the appropriate values for 'faceToward'.		The 3D line with a large width value and a texture effectively becomes a 3D image, 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>~~		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 is made to be used clientside!.

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">~~boolean dxDraw3DImage~~ ( float x, float y, float z, float width, float height, element material[, int color, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>		<syntaxhighlight lang="lua">bool dxDrawImage3D ( float x, float y, float z, float width, float height, element material, float width,
			[ int color = white, float rotation = 0, [ bool postGUI = false, ] float faceTowardX, float faceTowardY, float faceTowardZ ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
Line 16:		Line 16:
	* '''height:''' The height of the image in GTA world units. (This is 1/75th of the width used in dxDrawLine3D)		* '''height:''' The height of the image in GTA world units. (This is 1/75th of the width used in dxDrawLine3D)
	* '''material:''' A material to draw the image with.		* '''material:''' A material to draw the image with.


	==Optional Arguments==		==Optional Arguments==
Line 22:		Line 21:
	* '''color:''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).		* '''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 image) offset		* '''rotation:''' Rotation (end point of the image) offset
			{{New items\|3.0156\|1.5.5\|
			* '''postGUI''': A bool representing whether the image should be drawn on top of or behind any ingame GUI.
			\|11998}}
	* '''faceTowardX/Y/Z:''' The direction the front of the image should face towards. If this is not set, the front of the image always faces toward the camera.		* '''faceTowardX/Y/Z:''' The direction the front of the image should face towards. If this is not set, the front of the image always faces toward the camera.

Line 28:		Line 30:

	==Code==		==Code==
	<section name="~~Clientside script~~" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~local white = tocolor(255,255,255,255)~~		function dxDrawImage3D( x, y, z, width, height, material, color, rotation, ... )
	function dxDrawImage3D(x,y,z,w,h,m,c,r,...)		return dxDrawMaterialLine3D( x, y, z, x + width, y + height, ( z + tonumber( rotation or 0 ) ) or z, material, height, color or 0xFFFFFFFF, ... )
	~~local lx~~, ly, ~~lz =~~ x+w, y+h, (z+tonumber(r or 0)) or z
	~~return dxDrawMaterialLine3D(x,y,z, lx, ly, lz~~, m, h, c or ~~white~~, ...)
	end		end
	</syntaxhighlight>		</syntaxhighlight>
Line 41:		Line 41:
	This draws a trollface in the middle of the GTA world for no reason		This draws a trollface in the middle of the GTA world for no reason
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local face = dxCreateTexture("trollface.png")		local face = dxCreateTexture( "trollface.png" )
	addEventHandler("onClientRender", root,
	function()		addEventHandler( "onClientRender", root,
	dxDrawImage3D(0,0, 20, 20, 20, face, tocolor(255,255,255,255))		function( )
			dxDrawImage3D( 0,0, 20, 20, 20, face, tocolor( 255, 255, 255, 255 ) )
	end		end
	)		)
	</syntaxhighlight>		</syntaxhighlight>

			'''Author:''' qaisjp
	Author: qaisjp

	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}

GabWas at 21:06, 15 July 2016

2016-07-15T21:06:02Z

← Older revision		Revision as of 21:06, 15 July 2016
Line 9:		Line 9:

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

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

Castillo at 04:33, 10 February 2013

2013-02-10T04:33:52Z

← Older revision		Revision as of 04:33, 10 February 2013
Line 46:		Line 46:
	dxDrawImage3D(0,0, 20, 20, 20, face, tocolor(255,255,255,255))		dxDrawImage3D(0,0, 20, 20, 20, face, tocolor(255,255,255,255))
	end		end
	~~end~~
	)		)
	</syntaxhighlight>		</syntaxhighlight>

Castillo at 03:33, 10 February 2013

2013-02-10T03:33:50Z

← Older revision		Revision as of 03:33, 10 February 2013
Line 47:		Line 47:
	end		end
	end		end
			)
	</syntaxhighlight>		</syntaxhighlight>

MrX: fixed rotation being an optional parameter, fixed example

2012-06-27T01:03:32Z

fixed rotation being an optional parameter, fixed example

← Older revision		Revision as of 01:03, 27 June 2012
Line 32:		Line 32:
	local white = tocolor(255,255,255,255)		local white = tocolor(255,255,255,255)
	function dxDrawImage3D(x,y,z,w,h,m,c,r,...)		function dxDrawImage3D(x,y,z,w,h,m,c,r,...)
	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 0)) or z
	return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, m, h, c or white, ...)		return dxDrawMaterialLine3D(x,y,z, lx, ly, lz, m, h, c or white, ...)
	end		end
Line 44:		Line 44:
	addEventHandler("onClientRender", root,		addEventHandler("onClientRender", root,
	function()		function()
	~~dxDrawRectangle3D~~(0,0, 20, 20, 20, face, tocolor(255,255,255,255))		dxDrawImage3D(0,0, 20, 20, 20, face, tocolor(255,255,255,255))
	end		end
	end		end

Qaisjp at 12:54, 26 June 2012

2012-06-26T12:54:19Z

← Older revision		Revision as of 12:54, 26 June 2012
Line 39:		Line 39:

	==Example==		==Example==
	This draws a ~~trolface~~ in the middle of the GTA world for no reason		This draws a trollface in the middle of the GTA world for no reason
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local face = dxCreateTexture("trollface.png")		local face = dxCreateTexture("trollface.png")

Qaisjp at 12:54, 26 June 2012

2012-06-26T12:54:14Z

← Older revision		Revision as of 12:54, 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 3D image - 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 3D image - rendered for one frame This should be used in conjunction with [[onClientPreRender]] in order to display continuously.

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 3D image - rendered for one frame This should be use..."

2012-06-26T12:52: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 3D image - rendered for one frame This should be use..."

New page

{{Useful Function}}

__NOTOC__
This function draws a textured 3D line between two points in the 3D world that appers to be a 3D image - 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 and a texture effectively becomes a 3D image, 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 dxDraw3DImage ( float x, float y, float z, float width, float height, element material[, int color, float rotation, float faceTowardX, float faceTowardY, float faceTowardZ]</syntaxhighlight>

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

==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 image) offset
* '''faceTowardX/Y/Z:''' The direction the front of the image should face towards. If this is not set, the front of the image always faces toward the camera.

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

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

==Example==
This draws a trolface in the middle of the GTA world for no reason
<syntaxhighlight lang="lua">
local face = dxCreateTexture("trollface.png")
addEventHandler("onClientRender", root,
function()
dxDrawRectangle3D(0,0, 20, 20, 20, face, tocolor(255,255,255,255))
end
end
</syntaxhighlight>

Author: qaisjp

==See Also==
{{Useful_Functions}}

DxDrawImage3D - Revision history

Kirukiru: Typo? (another float width arg after element material

Myonlake: /* Code */

Myonlake at 15:39, 8 July 2018

GabWas at 21:06, 15 July 2016

Castillo at 04:33, 10 February 2013

Castillo at 03:33, 10 February 2013

MrX: fixed rotation being an optional parameter, fixed example

Qaisjp at 12:54, 26 June 2012

Qaisjp at 12:54, 26 June 2012

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 3D image - rendered for one frame This should be use..."

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 3D image - rendered for one frame This should be use..."