IsCursorShowing: Difference between revisions
Jump to navigation
Jump to search
m (Added template, sections) |
No edit summary |
||
(7 intermediate revisions by 7 users not shown) | |||
Line 2: | Line 2: | ||
{{Server client function}} | {{Server client function}} | ||
This function is used to determine whether or not a player's cursor is showing. | This function is used to determine whether or not a player's cursor is showing. | ||
{{Note|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.}} | |||
Note | |||
==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 16: | ||
</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 24: | Line 22: | ||
===Returns=== | ===Returns=== | ||
Returns ''true'' if the player's cursor is showing, ''false'' if it isn't | Returns ''true'' if the player's cursor is showing, ''false'' if it isn't. | ||
</section> | </section> | ||
Line 32: | Line 30: | ||
<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> | |||
</section> | |||
<section name="Clientside Example" class="client" show="true"> | |||
With little of tweaking this can also be used clientside | |||
<syntaxhighlight lang="lua"> | |||
function toggleCursor () | |||
local currentState = isCursorShowing () -- get the current cursor state as a boolean | |||
local oppositeState = not currentState -- get the new state as its logical opposite | |||
showCursor ( oppositeState ) -- set it as the new cursor state | |||
end | |||
</syntaxhighlight> | |||
And a more compact version | |||
<syntaxhighlight lang="lua"> | |||
bindKey ("b", "down", -- binds B key to toggle cursor state | |||
function() | |||
showCursor( not isCursorShowing() ) | |||
end) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</section> | </section> | ||
Line 41: | Line 57: | ||
==See Also== | ==See Also== | ||
{{Cursor_functions}} | {{Cursor_functions}} | ||
[[hu:isCursorShowing]] |
Revision as of 15:38, 27 August 2020
This function is used to determine whether or not a player's cursor is showing.
Note: 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 [-]
Serverbool 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 [-]
Clientbool isCursorShowing ( )
Returns
Returns true if the player's cursor is showing, false if it isn't.
Example
Click to collapse [-]
ExampleThis 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
Click to collapse [-]
Clientside ExampleWith little of tweaking this can also be used clientside
function toggleCursor () local currentState = isCursorShowing () -- get the current cursor state as a boolean local oppositeState = not currentState -- get the new state as its logical opposite showCursor ( oppositeState ) -- set it as the new cursor state end
And a more compact version
bindKey ("b", "down", -- binds B key to toggle cursor state function() showCursor( not isCursorShowing() ) end)