View source for DrawIconByName

<onlyinclude>
Draws an icon added by [[AddIconToken]] using its token name.
</onlyinclude>

As this is GUI-related it is client only - it should be wrapped in "if ( getNet().isClient() )" or be in a client-only script.

This method is part of the GUI namespace so you need to prefix calls to it with 'GUI::'.

This method has two variants. They both specify the token name as a string and the position to draw the icon at with a [[position2d]]i but one also specifies a scale factor for the icon as a float.
<syntaxhighlight lang="cpp">
void GUI::DrawIconByName( const string &iconName, position2di pos )
void GUI::DrawIconByName( const string &iconName, position2di pos, f32 scale )
</syntaxhighlight>

[[Category:Scripting]]
[[Category:Global Functions]]

'''Example'''

<syntaxhighlight lang="cpp">
void onRender(CRules@ this)
{	
	AddIconToken("$corpse$", "GUI/BodyIcon.png", dimension2di(32, 32), 0, SColor(255, 125, 25, 5));
	GUI::DrawIconByName("$corpse$", position2di(getScreenWidth()/2 - 50, getScreenHeight()/2 - 50), 2);

}
</syntaxhighlight>

[[File:GUIIcon.png]]