Resource:DxDraw3DText

2013-07-22T14:05:34Z

OpenIDUser52: Created page with "{{Resource page}} This resource allowe you to draw 3D-DX texts any where in the game . ==How it works== You only need to use the exported function from the resource '''dxDraw3..."

{{Resource page}}

This resource allowe you to draw 3D-DX texts any where in the game .

==How it works==
You only need to use the exported function from the resource '''dxDraw3DText''' and draw the text . ( To use the exported function use [[call]] function ) .

==The dxDraw3DText function==

===Syntax===
<syntaxhighlight lang="lua">element dxDraw3DText( string text, int x, int y, int z [, int scale = 2, string font = "default", int r = 255, int g = 255, int b = 255, int maxDistance = 12 ] )</syntaxhighlight>

===Required Arguments===
*'''text :''' A [[string]] representing the text you wish to draw .
*'''x, y, z :''' Three integers representing the world coordinates of where you want the text to be .

===Optional Arguments===
*'''scale :''' An [[int]] representing the size of the font .
*'''font :''' A [[string]] representing the font type, This CAN'T be a [[DX font]] element, It can ONLY be :
{{DxFonts}}
*'''r, g, b :''' Three integers representing the RGB Color codes for the text .
*''' maxDistance :''' An [[int]] representing the max distance the text will show in .

===Returns===

The function returns a ''text element'' if successfule, ''false'' otherwise .

===Example===

This example will draw a 3D text neer a player when the resource starts, And destroys it after 5 secinds .

<syntaxhighlight lang="lua">local dxDraw3DText = exports.3D_DX_Texts:dxDraw3DText -- define the function

addEventHandler( "onClientResourceStart", getResourceRootElement( getThisResource( ) ),
function( )
local x, y, z = getElementPosition( getLocalPlayer( ) ) -- getting the player coordinates
local playerName = getPlayerName( getLocalPlayer( ) ) -- getting the player name
local theText = dxDraw3DText( "Welcome " .. playerName, x, y, z ) -- dtawing the text
if theText then -- if it was drawn
setTimer( destroyElement, 5000, 1, theText ) -- set a time to destroy it after 5 seconds
end
end
)</syntaxhighlight>

==Notes==
* The ''dxDraw3DText'' function is client side only .
* The ''dxDraw3DText'' function doesn't need the [[onClientRender]] event to work .
* The ''dxDraw3DText'' function only creates a ''text element'', The drawing and stuff is done in the resource, So it MUST be running so the texts show .

==Download==
You can download the resource, comment about it, rate it and report any bugs at the community page : [https://community.multitheftauto.com/index.php?p=resources&s=details&id=7613]

GuiGridListGetSelectedItemText

2013-03-18T13:48:25Z

OpenIDUser52: Created page with "__NOTOC__ {{Useful Function}} This function gets the item text of the selected item in a grid list . ==Syntax== <syntaxhighlight lang="lua"> string guiGridListGetSelectedItemText ( element gr..."

__NOTOC__
{{Useful Function}}
This function gets the item text of the selected item in a grid list .

==Syntax==
<syntaxhighlight lang="lua">
string guiGridListGetSelectedItemText ( element gridList [, int column] )
</syntaxhighlight>

==Required Arguments==
* '''gridList :''' The gridLsit to get the selected item text from .

==Optional Arguments==
* '''column :''' The column to get the selected item text from .

==Code==
<section name='Client' class='client' show='true'>
<syntaxhighlight lang="lua">
function guiGridListGetSelectedItemText ( gridList, column )
local falseText = ''
local item = guiGridListGetSelectedItem ( gridList )
local text = guiGridListGetItemText ( gridList, item, column or 1 )
if ( text ~= '' ) then
return text
else
return false
end
end
</syntaxhighlight>
</section>

==Returns==

* A ''String'' containing the selected item text, ''false'' otherwise .

==Example==
* This example gets a player name from the grid list, and out puts it in the chat .
<syntaxhighlight lang="lua">
local window = guiCreateWindow ( 350, 100, 200, 250, "The Players", false )
--- Create a window !
local gridList = guiCreateGridList ( 0.8, 0.1, 0.15, 0.6, true, window )
--- Create a grid list in the window !
local players = getElementsByType( 'player' )
--- Create a table containing all the players !

for i,player in ipairs ( players ) do
--- Loop the table !
local row = guiGridListAddRow ( gridList )
--- Add a row to the grid list !
guiGridListSetItemText ( gridLsit, row, 1, getPlayerName ( player ), false, false )
--- Set the row's text to the players names !

function selectAPlayer ( )
--- Start a function !
if ( guiGridListGetSelectedItem ( gridList ) ) then
--- If there was a selected item in the grid list !
local thePlayerName = guiGridListGetSelectedItemText ( gridList )
--- Get the selected item text !
outputChatBox ( thePlayerName..' is a player in the server!' )
--- Out put his name in the chat !
end
--- Close the ' if ' !
end
--- Close the ' function ' !
addEventHandler ( 'onClientDoubleGUIClick', root, selectAPlayer )
--- Add the event handler of the function !
</syntaxhighlight>

* '''Author : ''' #Pai_[N]

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki - User contributions [en]

Resource:DxDraw3DText

GuiGridListGetSelectedItemText