DxDrawImageOnElement - Revision history

Tracer: Changed return type

2023-07-21T16:18:18Z

Changed return type

← Older revision		Revision as of 16:18, 21 July 2023
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">~~boolean~~ dxDrawImageOnElement(element TheElement, element Image [, int distance = 20, int height = 1, int width = 1, int R = 255, int G = 255, int B = 255, int alpha = 255, bool checkBuildings = true, bool checkVehicles = false, bool checkPeds = false, bool checkDummies = true, bool seeThroughStuff = true, bool ignoreSomeObjectsForCamera = false, element ignoredElement = nil ] ) </syntaxhighlight>		<syntaxhighlight lang="lua">
			none dxDrawImageOnElement(element TheElement, element Image [, int distance = 20, int height = 1, int width = 1, int R = 255, int G = 255, int B = 255, int alpha = 255, bool checkBuildings = true, bool checkVehicles = false, bool checkPeds = false, bool checkDummies = true, bool seeThroughStuff = true, bool ignoreSomeObjectsForCamera = false, element ignoredElement = nil ] )
			</syntaxhighlight>

	[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]		[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]
Line 33:		Line 35:

	==Returns==		==Returns==
	Returns ~~''true'' if successful, ''false'' otherwise.~~		Returns none

	==Function source==		==Function source==

Arran Fortuna: At least indent properly.

2019-09-20T16:54:17Z

At least indent properly.

Hassan saad: /* Function source */

2018-01-14T20:42:27Z

Function source

← Older revision		Revision as of 20:42, 14 January 2018
Line 64:		Line 64:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
	*Original author: ''~~Has[S]oN~~''.		*Original author: ''Al Obaidi Hassan''.
	*Skype: ''hassan.saad2000''		*Skype: ''hassan.saad2000''

Hassan saad at 14:01, 13 March 2016

2016-03-13T14:01:43Z

← Older revision		Revision as of 14:01, 13 March 2016
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, element Image [, int distance, int height, int width, int R, int G, int B, int alpha, bool checkBuildings, bool checkVehicles, bool checkPeds, bool checkDummies, bool seeThroughStuff, bool ignoreSomeObjectsForCamera, element ignoredElement ] ) </syntaxhighlight>		<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, element Image [, int distance = 20, int height = 1, int width = 1, int R = 255, int G = 255, int B = 255, int alpha = 255, bool checkBuildings = true, bool checkVehicles = false, bool checkPeds = false, bool checkDummies = true, bool seeThroughStuff = true, bool ignoreSomeObjectsForCamera = false, element ignoredElement = nil ] ) </syntaxhighlight>

	[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]		[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]

Hassan saad at 01:50, 12 March 2016

2016-03-12T01:50:57Z

← Older revision		Revision as of 01:50, 12 March 2016
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, element Image [, int distance, int height, int width, int R, int G, int B, int alpha ] ) </syntaxhighlight>		<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, element Image [, int distance, int height, int width, int R, int G, int B, int alpha, bool checkBuildings, bool checkVehicles, bool checkPeds, bool checkDummies, bool seeThroughStuff, bool ignoreSomeObjectsForCamera, element ignoredElement ] ) </syntaxhighlight>

	[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]		[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]
Line 22:		Line 22:
	* ''B'': The Blue color code (0-255), it's 255 by default.		* ''B'': The Blue color code (0-255), it's 255 by default.
	* ''alpha'': The alpha of the image, it's 255 by default.		* ''alpha'': The alpha of the image, it's 255 by default.

			*'''checkBuildings:''' Allow the line of sight to be blocked by GTA's internally placed buildings, i.e. the world map.
			*'''checkVehicles:''' Allow the line of sight to be blocked by [[Vehicle\|vehicles]].
			*'''checkPeds:''' Allow the line of sight to be blocked by peds, i.e. [[Player\|players]].
			*'''checkObjects:''' Allow the line of sight to be blocked by [[Object\|objects]].
			*'''checkDummies:''' Allow the line of sight to be blocked by GTA's internal dummies. These are not used in the current MTA version so this argument can be set to ''false''.
			*'''seeThroughStuff:''' Allow the line of sight to be blocked by translucent game objects, e.g. glass.
			*'''ignoreSomeObjectsForCamera:''' Allow the line of sight to be blocked by certain objects.
			*'''ignoredElement:''' Allow the line of sight to pass through a certain specified element.

	==Returns==		==Returns==
Line 35:		Line 44:
	local height = height or 1		local height = height or 1
	local width = width or 1		local width = width or 1
	if (isLineOfSightClear(x, y, z, x2, y2, z2, ~~true~~, ~~false~~, ~~false~~, ~~false~~)) then		local checkBuildings = checkBuildings or true
			local checkVehicles = checkVehicles or false
			local checkPeds = checkPeds or false
			local checkObjects = checkObjects or true
			local checkDummies = checkDummies or true
			local seeThroughStuff = seeThroughStuff or false
			local ignoreSomeObjectsForCamera = ignoreSomeObjectsForCamera or false
			local ignoredElement = ignoredElement or nil
			if (isLineOfSightClear(x, y, z, x2, y2, z2, checkBuildings, checkVehicles, checkPeds , checkObjects,checkDummies,seeThroughStuff,ignoreSomeObjectsForCamera,ignoredElement)) then
	local sx, sy = getScreenFromWorldPosition(x, y, z+height)		local sx, sy = getScreenFromWorldPosition(x, y, z+height)
	if(sx) and (sy) then		if(sx) and (sy) then

Hassan saad: /* Optional arguments */

2016-02-02T10:11:30Z

Optional arguments

← Older revision		Revision as of 10:11, 2 February 2016
Line 21:		Line 21:
	* ''G'': The Green color code (0-255), it's 255 by default.		* ''G'': The Green color code (0-255), it's 255 by default.
	* ''B'': The Blue color code (0-255), it's 255 by default.		* ''B'': The Blue color code (0-255), it's 255 by default.
	* ''alpha'': The alpha of the ~~text~~, it's 255 by default.		* ''alpha'': The alpha of the image, it's 255 by default.

	==Returns==		==Returns==

Hassan saad: /* Syntax */

2016-02-01T22:52:34Z

Syntax

← Older revision		Revision as of 22:52, 1 February 2016
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, ~~string~~ Image [, int distance, int height, int width, int R, int G, int B, int alpha ] ) </syntaxhighlight>		<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, element Image [, int distance, int height, int width, int R, int G, int B, int alpha ] ) </syntaxhighlight>

	[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]		[[File:DxDrawImageOnElement.png\|thumb\|Example of how it should looks like.\|284x230px]]

Hassan saad at 18:38, 1 February 2016

2016-02-01T18:38:29Z

← Older revision		Revision as of 18:38, 1 February 2016
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This useful client function draws an image on any element you choose.		This useful client function draws an image on any element you choose.
			{{Note\|You have to use [[onClientRender]] or [[onClientPreRender]] events with this function.}}

	==Syntax==		==Syntax==

Hassan saad: Created page with "{{Useful Function}} NOTOC This useful client function draws an image on any element you choose. ==Syntax== boolean dxDrawImageOnElement(elem..."

2016-02-01T15:07:56Z

Created page with "{{Useful Function}}<lowercasetitle/> __NOTOC__ This useful client function draws an image on any element you choose. ==Syntax== <syntaxhighlight lang="lua">boolean dxDrawImageOnElement(elem..."

New page

{{Useful Function}}<lowercasetitle/>
__NOTOC__
This useful client function draws an image on any element you choose.

==Syntax==
<syntaxhighlight lang="lua">boolean dxDrawImageOnElement(element TheElement, string Image [, int distance, int height, int width, int R, int G, int B, int alpha ] ) </syntaxhighlight>

[[File:DxDrawImageOnElement.png|thumb|Example of how it should looks like.|284x230px]]

==Required arguments==
* ''TheElement'': The element you want to draw the image on it.
* ''Image'': The image you want. Use [[dxCreateTexture]] to create it.

==Optional arguments==
* ''height'': The height of the text, it's 1 by default.
* ''distance'': The distance you will be able to view the image from, it's 20 by default.
* ''height'': The height of the image, it's 1 by default.
* ''width'': The width of the image, it's 1 by default.
* ''R'': The Red color code (0-255), it's 255 by default.
* ''G'': The Green color code (0-255), it's 255 by default.
* ''B'': The Blue color code (0-255), it's 255 by default.
* ''alpha'': The alpha of the text, it's 255 by default.

==Returns==
Returns ''true'' if successful, ''false'' otherwise.

==Function source==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function dxDrawImageOnElement(TheElement,Image,distance,height,width,R,G,B,alpha)
local x, y, z = getElementPosition(TheElement)
local x2, y2, z2 = getElementPosition(localPlayer)
local distance = distance or 20
local height = height or 1
local width = width or 1
if (isLineOfSightClear(x, y, z, x2, y2, z2, true, false, false, false)) then
local sx, sy = getScreenFromWorldPosition(x, y, z+height)
if(sx) and (sy) then
local distanceBetweenPoints = getDistanceBetweenPoints3D(x, y, z, x2, y2, z2)
if(distanceBetweenPoints < distance) then
dxDrawMaterialLine3D(x, y, z+1+height-(distanceBetweenPoints/distance), x, y, z+height, Image, width-(distanceBetweenPoints/distance), tocolor(R or 255, G or 255, B or 255, alpha or 255))
end
end
end
end
</syntaxhighlight>
</section>
*Original author: ''Has[S]oN''.
*Skype: ''hassan.saad2000''

==Example #1==
This example creates an image on a random ped in the Grove street.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
randomPed = createPed(285,2506.83423,-1684.89941,13.55648)
tag = dxCreateTexture("crown.png")

addEventHandler("onClientPreRender", root,
function()
dxDrawImageOnElement(randomPed,tag)
end)
</syntaxhighlight>
</section>

==Example #2==
This example creates an image on all the vehicles in the game.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local tag = dxCreateTexture("bike.png")

addEventHandler("onClientPreRender", root,
function()
for k,v in ipairs(getElementsByType("vehicle")) do
dxDrawImageOnElement(v,tag)
end
end)
</syntaxhighlight>
</section>

==See also==
{{Useful Functions}}

← Older revision		Revision as of 16:54, 20 September 2019
Line 39:		Line 39:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function dxDrawImageOnElement(TheElement,Image,distance,height,width,R,G,B,alpha)		function dxDrawImageOnElement(TheElement,Image,distance,height,width,R,G,B,alpha)
	local x, y, z = getElementPosition(TheElement)		local x, y, z = getElementPosition(TheElement)
	local x2, y2, z2 = getElementPosition(localPlayer)		local x2, y2, z2 = getElementPosition(localPlayer)
	local distance = distance or 20		local distance = distance or 20
	local height = height or 1		local height = height or 1
	local width = width or 1		local width = width or 1
	local checkBuildings = checkBuildings or true		local checkBuildings = checkBuildings or true
	local checkVehicles = checkVehicles or false		local checkVehicles = checkVehicles or false
	local checkPeds = checkPeds or false		local checkPeds = checkPeds or false
	local checkObjects = checkObjects or true		local checkObjects = checkObjects or true
	local checkDummies = checkDummies or true		local checkDummies = checkDummies or true
	local seeThroughStuff = seeThroughStuff or false		local seeThroughStuff = seeThroughStuff or false
	local ignoreSomeObjectsForCamera = ignoreSomeObjectsForCamera or false		local ignoreSomeObjectsForCamera = ignoreSomeObjectsForCamera or false
	local ignoredElement = ignoredElement or nil		local ignoredElement = ignoredElement or nil
	if (isLineOfSightClear(x, y, z, x2, y2, z2, checkBuildings, checkVehicles, checkPeds , checkObjects,checkDummies,seeThroughStuff,ignoreSomeObjectsForCamera,ignoredElement)) then		if (isLineOfSightClear(x, y, z, x2, y2, z2, checkBuildings, checkVehicles, checkPeds , checkObjects,checkDummies,seeThroughStuff,ignoreSomeObjectsForCamera,ignoredElement)) then
	local sx, sy = getScreenFromWorldPosition(x, y, z+height)		local sx, sy = getScreenFromWorldPosition(x, y, z+height)
	if(sx) and (sy) then		if(sx) and (sy) then
	local distanceBetweenPoints = getDistanceBetweenPoints3D(x, y, z, x2, y2, z2)		local distanceBetweenPoints = getDistanceBetweenPoints3D(x, y, z, x2, y2, z2)
	if(distanceBetweenPoints < distance) then		if(distanceBetweenPoints < distance) then
	dxDrawMaterialLine3D(x, y, z+1+height-(distanceBetweenPoints/distance), x, y, z+height, Image, width-(distanceBetweenPoints/distance), tocolor(R or 255, G or 255, B or 255, alpha or 255))		dxDrawMaterialLine3D(x, y, z+1+height-(distanceBetweenPoints/distance), x, y, z+height, Image, width-(distanceBetweenPoints/distance), tocolor(R or 255, G or 255, B or 255, alpha or 255))
	~~end~~
	~~end~~
	end		end
			end
	end		end
			end
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>