SetElementAlpha: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(17 intermediate revisions by 16 users not shown)
Line 1: Line 1:
==Syntax==  
{{Server client function}}
__NOTOC__
[[file:SetElementAlpha.png|400px|thumb|right|Player ped alpha demonstration. Shown alpha levels are 255, 100 and 0 (left to right).]]
This function sets the alpha (transparency) value for the specified [[element]]. This can be a [[player]], [[ped]], [[object]], [[vehicle]] or [[Element/Weapon|weapon]].
 
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setElementAlpha ( element theElement, int alpha )
bool setElementAlpha ( element theElement, int alpha )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[element]]:setAlpha|alpha|getElementAlpha}}
===Required Arguments===
*'''theElement:''' The [[element]] whose alpha you want to set.
*'''alpha:'''  The alpha value to set. Values are 0-255, where 255 is fully opaque and 0 is fully transparent.
** '''Note:''' [[Object]]s are fully transparent at 140.
===Returns===
Returns ''true'' or ''false'' if invalid arguments were passed.
==Example==
<section name="Clientside example" class="client" show="true">
This example makes the player invisible.
<syntaxhighlight lang="lua">
function invisible()
        setElementAlpha(localPlayer, 0)
end
addCommandHandler ( "invisible", invisible )
</syntaxhighlight>
</section>
<section name="Serverside example" class="server" show="true">
This example lets you toggle invisibility when you write /invis.
<syntaxhighlight lang="lua">
function toggleInvis ( thePlayer )  -- thePlayer is whoever executed the command
  if getElementAlpha( thePlayer ) == 0 then -- if the player is invisible
      setElementAlpha ( thePlayer, 255 ) -- set the player alpha to 255.
  else -- else, if the player is visible
      setElementAlpha ( thePlayer, 0 ) -- set the players alpha to 0.
  end
end
addCommandHandler ( "invis", toggleInvis ) -- When /invis is typed, the function 'toggleInvis' will start.
</syntaxhighlight>
</section>


[[Category::Incomplete]]
==See Also==
{{Element functions}}

Latest revision as of 04:29, 11 August 2019

Player ped alpha demonstration. Shown alpha levels are 255, 100 and 0 (left to right).

This function sets the alpha (transparency) value for the specified element. This can be a player, ped, object, vehicle or weapon.

Syntax

bool setElementAlpha ( element theElement, int alpha )

OOP Syntax Help! I don't understand this!

Method: element:setAlpha(...)
Variable: .alpha
Counterpart: getElementAlpha


Required Arguments

  • theElement: The element whose alpha you want to set.
  • alpha: The alpha value to set. Values are 0-255, where 255 is fully opaque and 0 is fully transparent.
    • Note: Objects are fully transparent at 140.

Returns

Returns true or false if invalid arguments were passed.

Example

Click to collapse [-]
Clientside example

This example makes the player invisible.

function invisible()
        setElementAlpha(localPlayer, 0)
end
addCommandHandler ( "invisible", invisible )
Click to collapse [-]
Serverside example

This example lets you toggle invisibility when you write /invis.

function toggleInvis ( thePlayer )  -- thePlayer is whoever executed the command
   if getElementAlpha( thePlayer ) == 0 then -- if the player is invisible
       setElementAlpha ( thePlayer, 255 ) -- set the player alpha to 255.
   else	-- else, if the player is visible
       setElementAlpha ( thePlayer, 0 )	-- set the players alpha to 0.
   end
end
addCommandHandler ( "invis", toggleInvis ) -- When /invis is typed, the function 'toggleInvis' will start.

See Also