DxGetTextWidth: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (add "added in")
m (Undo revision 62332 by JeViCo (talk))
(5 intermediate revisions by 5 users not shown)
Line 2: Line 2:
{{Client function}}  
{{Client function}}  
This function retrieves the theoretical width of a certain piece of text, if it were to be drawn using [[dxDrawText]].
This function retrieves the theoretical width of a certain piece of text, if it were to be drawn using [[dxDrawText]].
'''NOTE:''' This function is relative to the client's screen resolution.


==Syntax==
==Syntax==
Line 15: Line 17:
* '''scale:''' The size of the text.
* '''scale:''' The size of the text.
* '''font:''' Either a custom [[DX font]] element or the name of a built-in dx font:
* '''font:''' Either a custom [[DX font]] element or the name of a built-in dx font:
{{DxFonts}}
* '''bColorCoded:''' Should we exclude color codes from the width? (false will include the hex in the length)
* '''bColorCoded:''' Should we exclude color codes from the width? (false will include the hex in the length)
{{DxFonts}}


===Returns===
===Returns===
Line 30: Line 32:
     outputChatBox(tostring(length))
     outputChatBox(tostring(length))
end
end
addEventHandler("onClientChatMessage",getRootElement(),dxwidth)
addEventHandler("onClientChatMessage",root,dxwidth)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
Line 36: Line 38:
==See Also==
==See Also==
{{Drawing_functions}}
{{Drawing_functions}}
[[hu:dxGetTextWidth]]

Revision as of 11:15, 7 March 2019

This function retrieves the theoretical width of a certain piece of text, if it were to be drawn using dxDrawText.

NOTE: This function is relative to the client's screen resolution.

Syntax

float dxGetTextWidth ( string text, [float scale=1, mixed font="default", bool bColorCoded=false] )

OOP Syntax Help! I don't understand this!

Note: This syntax requires you to ignore the font argument above
Method: font:getTextWidth(...)

Required Arguments

  • text: A string representing the text for which you wish to retrieve with width for.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • scale: The size of the text.
  • font: Either a custom DX font element or the name of a built-in dx font:
    • "default": Tahoma
    • "default-bold": Tahoma Bold
    • "clear": Verdana
    • "arial": Arial
    • "sans": Microsoft Sans Serif
    • "pricedown": Pricedown (GTA's theme text)
    • "bankgothic": Bank Gothic Medium
    • "diploma": Diploma Regular
    • "beckett": Beckett Regular
    • "unifont": Unifont
  • bColorCoded: Should we exclude color codes from the width? (false will include the hex in the length)

Returns

Returns the float of the width of the text.

Example

Click to collapse [-]
Example

This will show you the width of a message in a normal chatbox sent by a player

function dxwidth(msg)
    chatbox = getChatboxLayout()
    local length = dxGetTextWidth(msg,chatbox["chat_scale"][1])
    outputChatBox(tostring(length))
end
addEventHandler("onClientChatMessage",root,dxwidth)

See Also