~~NOTOC~~
====== setTexture ======
[[developer_center:developer_editor:script:ui_event|From Customui Class]]

<WRAP center box>
    Customui:setTexture(playerid, uiid, elementid, url)

**API Description**
The main function of this method: Set the texture of an image element in a custom UI.

^ Parameters  ^ Types   ^ Info                          ^
| playerid   | number  | Player ID                     |
| uiid       | string  | The ID of the custom UI        |
| elementid  | string  | The ID of the image element    |
| url        | string  | The texture ID to apply        |

^ Return Value      ^ Type   ^
| ErrorCode.OK (0) | number |
</WRAP>

==== Examples ====
<code lua setTexture_Example.lua>
-- This function executes when a player clicks a block
local function clickblock(event)
    local playerid = event.eventobjid  -- Player ID who clicked the block
    local uiid = "6986982063319417057"  -- Replace with your UI ID
    local elementid = "6986982063319417057_3"  -- Replace with your image element ID
    local url = "block_100"  -- Replace with your texture ID
    
    -- Set the texture for the player's UI image element
    Customui:setTexture(playerid, uiid, elementid, url)
end
-- Register event for Player.ClickBlock
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], clickblock)
</code>

==== Lua Code Explanation: Texture Setting ====

This Lua code demonstrates how to change an image element's texture when a player clicks a block.

=== Function Definition ===
<code lua>
local function clickblock(event)
</code>
* Declares the **clickblock** function for `Player.ClickBlock` events
* **event** parameter contains the interaction data

=== Parameter Extraction ===
<code lua>
local playerid = event.eventobjid
</code>
* Gets the **player ID** from the event object
* Identifies which player triggered the action

=== UI Configuration ===
<code lua>
local uiid = "6986982063319417057"
local elementid = "6986982063319417057_3"
local url = "10010"
</code>
* **uiid**: The custom UI's identifier
* **elementid**: Specific image component to modify
* **url**: Texture ID to apply
* **Note**: All are placeholders - replace with your actual IDs

=== Texture Setting ===
<code lua>
Customui:setTexture(playerid, uiid, elementid, url)
</code>
* Calls the Customui API to change the texture
* Parameters:
  * **playerid**: Target player
  * **uiid**: Parent UI container
  * **elementid**: Image element to modify
  * **url**: New texture ID

=== Event Registration ===
<code lua>
ScriptSupportEvent:registerEvent([=[Player.ClickBlock]=], clickblock)
</code>
* Links the function to block-click events
* Event type: `Player.ClickBlock` (triggered by any block interaction)

=== Educational Notes ===
Key concepts demonstrated:
  * **Dynamic UI Modification**: Changing elements at runtime
  * **Player Interaction**: Responding to block clicks
  * **Texture Management**: Applying different images to UI components
  * **Component Targeting**: Using element IDs for precise control

**Result**: Clicking any block changes the specified image's texture for the interacting player.

=== Important Notes ===
1. Replace all placeholder IDs with your actual values:
  * `uiid` (your custom UI's ID)
  * `elementid` (specific image element ID)
  * `url` (valid texture ID)
2. Ensure:
  *  The UI is already created/visible
  *  Texture IDs are preloaded
3. For multiple textures:
  * Store texture IDs in a table
  * Use logic to cycle through them

=== Troubleshooting ===
If the texture doesn't change:
1. Verify all IDs are correct
2. Check if the UI is visible
3. Confirm the texture ID exists
4. Ensure the event is properly registered