Difference between revisions of "LlForceMouselook"

From Second Life Wiki
Jump to navigation Jump to search
m
m (There was no truth to the statement about a worn object with this property creating an on-screen button. Removed it.)
Line 6: Line 6:
|p1_desc=boolean, if [[TRUE]] when an avatar sits on the prim, the avatar will be forced into [[mouselook]] mode. [[FALSE]] is the default setting and will undo a previously set [[TRUE]] or do nothing.
|p1_desc=boolean, if [[TRUE]] when an avatar sits on the prim, the avatar will be forced into [[mouselook]] mode. [[FALSE]] is the default setting and will undo a previously set [[TRUE]] or do nothing.
|func_footnote=A [[llSitTarget|sit target]] is not necessary for this function to work.
|func_footnote=A [[llSitTarget|sit target]] is not necessary for this function to work.
If the function is used in an attachment (like a HUD), then the wearer is not forced into Mouselook mode. Rather, a button appears at the bottom of the screen, and the wearer must click it to enter Mouselook. This is similar to what happens when [[CONTROL_ML_LBUTTON]] is captured with [[llTakeControls]].
|func_desc=Sets if a sitting avatar should be forced into [[mouselook]] when they sit on this prim.
|func_desc=Sets if a sitting avatar should be forced into [[mouselook]] when they sit on this prim.
|return_text
|return_text

Revision as of 02:46, 13 May 2010

Summary

Function: llForceMouselook( integer mouselook );

Sets if a sitting avatar should be forced into mouselook when they sit on this prim.

• integer mouselook boolean, if TRUE when an avatar sits on the prim, the avatar will be forced into mouselook mode. FALSE is the default setting and will undo a previously set TRUE or do nothing.

A sit target is not necessary for this function to work.

Caveats

  • This function has no effect on avatars already seated.
  • The user may exit mouselook mode at any time.
  • There is nothing stopping someone from modifying or making a client that ignores this.
All Issues ~ Search JIRA for related Bugs

Examples

Force Mouselook on Sit <lsl>default {

   state_entry()
   {
       llForceMouselook(TRUE); // Forces sitting avatars into mouselook.
       llForceMouselook(FALSE); // Reverts the setting to the default...
                                // ...as with a newly created prim.
   }
}</lsl>

See Also

Deep Notes

Search JIRA for related Issues

Tests

•  llForceMouseLook Test

Signature

function void llForceMouselook( integer mouselook );