Template:IsCursorOnElemen: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added isCursorOnElement function with example usage for interactive GUI/DX buttons, including hover and SelectBut highlighting, with explanation and screenshot)
 
Tag: Blanking
 
Line 1: Line 1:
== Client-Side Function: isCursorOnElement ==


[[File:MTANeonX.png|thumb]]
'''Description:'''
This function is used in GUI / DX to create interactive buttons or effects in a professional way.
It allows you to make elements like buttons, rectangles, or any selectable area responsive to the player's cursor.
You can also add many enhancements to make the appearance of the button or element look visually appealing and professional.
---
=== Function ===
<syntaxhighlight lang="lua">
function isCursorOnElement( posX, posY, width, height )
if isCursorShowing( ) then
local mouseX, mouseY = getCursorPosition( )
local clientW, clientH = guiGetScreenSize( )
local mouseX, mouseY = mouseX * clientW, mouseY * clientH
if ( mouseX > posX and mouseX < ( posX + width ) and mouseY > posY and mouseY < ( posY + height ) ) then
return true
end
end
return false
end
</syntaxhighlight>
---
=== Example Usage ===
<syntaxhighlight lang="lua">
-- Example: Interactive button on screen
local SelectBut = 1 -- Stores the button selected by player
local x, y, w, h = 100, 100, 150, 50 -- Element position and size
if isCursorOnElement(x, y, w, h) then
    -- Cursor is on the element → full alpha
    dxDrawImage(x, y, w, h, "img.png", 0, 0, 0, tocolor(255, 254, 254, 255), false)
else
    if SelectBut == 1 then
        -- Cursor is not on the element but already selected → full alpha
        dxDrawImage(x, y, w, h, "img.png", 0, 0, 0, tocolor(255, 254, 254, 255), false)
    else
        -- Cursor is not on the element and not selected → reduce alpha
        dxDrawImage(x, y, w, h, "img.png", 0, 0, 0, tocolor(255, 254, 254, 50), false)
    end
end
</syntaxhighlight>
---
===Explanation ===
* '''isCursorOnElement(posX, posY, width, height)''' Function to check cursor position relative to an element 
---
=== Notes===
* This function is safe for Client-Side only and will not affect other players.
* GUI/DX Example can be adapted for multiple buttons or GUI elements easily.

Latest revision as of 14:51, 5 April 2026

Retrieved from "https://wiki.multitheftauto.com/wiki/Template:IsCursorOnElemen?oldid=82794"