DxDrawText - Revision history

IManGaaX at 12:29, 23 June 2025

2025-06-23T12:29:44Z

← Older revision		Revision as of 12:29, 23 June 2025
Line 20:		Line 20:
	*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.		*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
	*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).		*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
	*'''textSize:''' the size of the text scale.}		*'''textSize:''' the size of the text scale.
	*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''		*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''
	{{DxFonts}}		{{DxFonts}}

IManGaaX at 12:29, 23 June 2025

2025-06-23T12:29:36Z

← Older revision		Revision as of 12:29, 23 June 2025
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, float ~~fontScale~~,		bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, float textSize,
	mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,		mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
	bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,		bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,
Line 20:		Line 20:
	*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.		*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
	*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).		*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
	*'''~~fontScale~~:''' the size of the text scale.}}		*'''textSize:''' the size of the text scale.}
	*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''		*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''
	{{DxFonts}}		{{DxFonts}}

IManGaaX at 12:29, 23 June 2025

2025-06-23T12:29:08Z

← Older revision		Revision as of 12:29, 23 June 2025
Line 20:		Line 20:
	*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.		*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
	*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).		*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
	*'''fontScale:''' the size of the text~~.{{New feature\|3.0110\|1.1\|'''~~scale~~:'''~~.}}		*'''fontScale:''' the size of the text scale.}}
	*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''		*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''
	{{DxFonts}}		{{DxFonts}}

IManGaaX at 12:28, 23 June 2025

2025-06-23T12:28:44Z

← Older revision		Revision as of 12:28, 23 June 2025
Line 20:		Line 20:
	*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.		*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
	*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).		*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
	*'''fontScale:''' the size of the text.{{New feature\|3.0110\|1.1\|'''scale:''' ~~can (optionally) be specified as two floats~~. ~~i.e. '''scaleX, scaleY'''~~}}		*'''fontScale:''' the size of the text.{{New feature\|3.0110\|1.1\|'''scale:'''.}}
	*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''		*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''
	{{DxFonts}}		{{DxFonts}}

IManGaaX at 12:27, 23 June 2025

2025-06-23T12:27:51Z

← Older revision		Revision as of 12:27, 23 June 2025
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, ~~int~~ fontScale,		bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, float fontScale,
	mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,		mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
	bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,		bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,

IManGaaX at 12:26, 23 June 2025

2025-06-23T12:26:45Z

← Older revision		Revision as of 12:26, 23 June 2025
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, ~~float~~ fontScale,		bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, int fontScale,
	mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,		mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
	bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,		bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,

IManGaaX: correct problems

2025-06-23T12:26:30Z

correct problems

← Older revision		Revision as of 12:26, 23 June 2025
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, float ~~scaleXY = 1.0, float scaleY = 1.0~~,		bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, float fontScale,
	mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,		mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
	bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,		bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,
Line 20:		Line 20:
	*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.		*'''bottomY:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
	*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).		*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
	*'''~~scale~~:''' the size of the text.{{New feature\|3.0110\|1.1\|'''scale:''' can (optionally) be specified as two floats. i.e. '''scaleX, scaleY'''}}		*'''fontScale:''' the size of the text.{{New feature\|3.0110\|1.1\|'''scale:''' can (optionally) be specified as two floats. i.e. '''scaleX, scaleY'''}}
	*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''		*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''
	{{DxFonts}}		{{DxFonts}}

Srslyyyy: /* Example */

2024-12-03T06:23:20Z

Example

← Older revision		Revision as of 06:23, 3 December 2024
Line 50:		Line 50:
	This example code will add the current zone name in the lower left corner of the players' screens.		This example code will add the current zone name in the lower left corner of the players' screens.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local ~~screenWidth~~, ~~screenHeight~~ = guiGetScreenSize ( ) -- ~~Get~~ the screen resolution (width and height)		local screenX, screenY = guiGetScreenSize() -- get the screen resolution (width and height)
			local shadowColor = tocolor(0, 0, 0, 255) -- define shadow color outside render scope and use it afterwards (for performance reasons)
			local textColor = tocolor(255, 255, 255, 255) -- define color outside render scope and use it afterwards (for performance reasons)

	function ~~createText~~ ( )		function renderPlayerZone()
	local playerX, playerY, playerZ = getElementPosition ( localPlayer ) -- ~~Get~~ our player's coordinates.		local playerX, playerY, playerZ = getElementPosition(localPlayer) -- get our player's coordinates
	local playerZoneName = getZoneName ( playerX, playerY, playerZ ) -- ~~Get~~ name of the zone the player is in.		local playerZoneName = getZoneName(playerX, playerY, playerZ) -- get name of the zone the player is in

	-- ~~Draw~~ zone name text's shadow.		-- draw zone name text's shadow
	dxDrawText ( playerZoneName, 44, ~~screenHeight~~ - 41, ~~screenWidth, screenHeight, tocolor ( 0, 0~~, 0, ~~255 )~~, 1.02, "pricedown" )		dxDrawText(playerZoneName, 44, screenY - 41, screenX, screenY, shadowColor, 1.02, "pricedown")
	-- ~~Draw~~ zone name text.		-- draw zone name text
	dxDrawText ( playerZoneName, 44, ~~screenHeight~~ - 43, ~~screenWidth, screenHeight, tocolor ( 255, 255~~, ~~255~~, ~~255 )~~, 1, "pricedown" )		dxDrawText(playerZoneName, 44, screenY - 43, screenX, screenY, textColor, 1, "pricedown")
	end		end
			addEventHandler("onClientRender", root, renderPlayerZone)
	~~function HandleTheRendering ( )~~
	addEventHandler ( "onClientRender", root, ~~createText ) -- keep the text visible with onClientRender.~~
	~~end~~

	~~addEventHandler ( "onClientResourceStart", resourceRoot, HandleTheRendering~~ )
	</syntaxhighlight>		</syntaxhighlight>

	This example shows how to set both horizontal and vertical text size.		This example shows how to set both horizontal and vertical text size.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local ~~screenWidth~~, ~~screenHeight~~ = guiGetScreenSize ( ) -- ~~Get~~ the screen resolution (width and height)		local screenX, screenY = guiGetScreenSize() -- get the screen resolution (width and height)
			local textColor = tocolor(255, 255, 255, 255) -- define color outside render scope and use it afterwards (for performance reasons)

			function renderGameTick()
			local tickNow = getTickCount()

	~~function createText ( )~~		dxDrawText(tickNow, 44, screenY - 43, screenX, screenY, textColor, 1, 2, "pricedown")
	dxDrawText ( ~~getTickCount()~~, 44, ~~screenHeight~~ - 43, ~~screenWidth, screenHeight, tocolor ( 255, 255~~, ~~255~~, ~~255 )~~, 1, 2, "pricedown" )
	end		end
	addEventHandler ( "onClientRender", root, ~~createText~~ )		addEventHandler("onClientRender", root, renderGameTick)
	</syntaxhighlight>		</syntaxhighlight>

IManGaaX at 08:15, 5 November 2023

2023-11-05T08:15:27Z

← Older revision		Revision as of 08:15, 5 November 2023
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = ~~tocolor(255,255,255,255)~~, float scaleXY = 1.0, float scaleY = 1.0,		bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = white, float scaleXY = 1.0, float scaleY = 1.0,
	mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,		mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
	bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,		bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,

IManGaaX at 08:14, 5 November 2023

2023-11-05T08:14:58Z

← Older revision		Revision as of 08:14, 5 November 2023
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawText ( string text, float leftX, float topY [, float rightX = leftX, float bottomY = topY, int color = ~~white~~, float scaleXY = 1.0 [, float scaleY = 1.0 ],		bool dxDrawText ( string text, float leftX, float topY, [ float rightX = leftX, float bottomY = topY, int color = tocolor(255,255,255,255), float scaleXY = 1.0, float scaleY = 1.0,
	mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,		mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
	bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,		bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,
	float fRotation = 0.0, float fRotationCenterX = 0.0, float fRotationCenterY = 0.0, float fLineSpacing = 0.0] )		float fRotation = 0.0, float fRotationCenterX = 0.0, float fRotationCenterY = 0.0, float fLineSpacing = 0.0 ] )
	</syntaxhighlight>		</syntaxhighlight>