IsCursorShowing: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Added template, sections)
No edit summary
Line 6: Line 6:


==Syntax==  
==Syntax==  
<section name="Server" class="server">
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool isCursorShowing ( player thePlayer )
bool isCursorShowing ( player thePlayer )
Line 18: Line 18:
</section>
</section>


<section name="Client" class="client">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool isCursorShowing ( )
bool isCursorShowing ( )
Line 32: Line 32:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function toggleCursor ( thePlayer )
function toggleCursor ( thePlayer )
local currentState = isCursorShowing ( thePlayer ) -- get the current cursor state as a boolean
local currentState = isCursorShowing ( thePlayer ) -- get the current cursor state as a boolean
local oppositeState = not currentState -- get the new state as its logical opposite
local oppositeState = not currentState             -- get the new state as its logical opposite
showCursor ( thePlayer, oppositeState ) -- set it as the new cursor state
showCursor ( thePlayer, oppositeState )             -- set it as the new cursor state
end
end
</syntaxhighlight>
</syntaxhighlight>

Revision as of 20:26, 16 August 2007

This function is used to determine whether or not a player's cursor is showing.

Note that this retrieves the cursor state that has been set using showCursor, and thus doesn't take into account the cursor shown while the chatbox, menu or console are open. Also, keep in mind that while the client is aware of cursor states set from the server, the server doesn't know about cursor states set from the client.

Syntax

Click to collapse [-]
Server
bool isCursorShowing ( player thePlayer )

Required Arguments

  • thePlayer: The player you want to get cursor state of.

Returns

Returns true if the player's cursor is showing, false if it isn't or if invalid parameters were passed.

Click to collapse [-]
Client
bool isCursorShowing ( )

Returns

Returns true if the player's cursor is showing, false if it isn't or if invalid parameters were passed.

Example

Click to collapse [-]
Example

This serverside function toggles a player's cursor state.

function toggleCursor ( thePlayer )
	local currentState = isCursorShowing ( thePlayer )  -- get the current cursor state as a boolean
	local oppositeState = not currentState              -- get the new state as its logical opposite
	showCursor ( thePlayer, oppositeState )             -- set it as the new cursor state
end

See Also