Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:41:18Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=CircleImage}}
Sets the texture a CircleImage shows and which point of it is at the circle's centre.

<pre>
CircleImageSetTexture(imageName, textureName, x, y)
</pre>

== Arguments ==
;imageName : <code>string</code> – Name of a CircleImage window.
;textureName : <code>string</code> – Name of the texture.
;x, y : <code>number</code> – Pixel position in the texture that is drawn at the centre of the circle. Fractions are dropped.

== Returns ==
Nothing.

== Details ==
* The texture is loaded by name and the circle is rebuilt with it.
* How much of the texture around that point is visible depends on the window's size and the texture scale (see [[API:CircleImageSetTextureScale|CircleImageSetTextureScale]]).
* To show an icon from an icon texture, the stock UI adds half the window size to the icon's top-left corner (see the example).

== Errors ==
* <code>Error in function call 'CircleImageSetTexture': Window %s does not exist</code>
* <code>Error in function call 'CircleImageSetTexture': Window %s is not a CircleImage</code>

== Example ==
A round morale-ability icon, from <code>ea_abilitieswindow/source/abilitieswindow.lua</code>:
<pre>
local texture, x, y = GetIconData( ability.iconNum )
...
local winX, winY = WindowGetDimensions( window.."CircleIcon" )
CircleImageSetTexture (window.."CircleIcon", texture, x + winX/2, y + winY/2)
</pre>

A group member's portrait, from <code>eatemplate_unitframes/source/groupmemberunitframe.lua</code>:
<pre>
CircleImageSetTexture( newUnitFrame:GetName().."Portrait", "render_scene_group_portrait"..UnitIdToGroupMemberMapping[unitId].groupMemberIndex, 40, 54 )
</pre>

== See also ==
* [[API:CircleImageSetTextureScale|CircleImageSetTextureScale]]
* [[API:CircleImageSetTextureSlice|CircleImageSetTextureSlice]]
* [[API:DynamicImageSetTexture|DynamicImageSetTexture]]

API:CircleImageSetTexture - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)