Difference between revisions of "LlForceMouselook"

From Second Life Wiki
Jump to navigation Jump to search
m
m
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|inject-2={{LSL Function/boolean|mouselook|bool=*|if=*|default=false|td=when an avatar sits on the prim, the avatar will be forced into [[mouselook]] mode||fd=the avatar will keep their current camera mode.|th=when an avatar sits on the prim, the avatar will be forced into mouselook mode}}
|func_id=294|func_sleep=0.0|func_energy=10.0
|func_id=294|func_sleep=0.0|func_energy=10.0
|func=llForceMouselook
|func=llForceMouselook
|p1_type=integer
|p1_type=integer|p1_subtype=boolean|p1_name=mouselook
|p1_name=mouselook
|p1_desc
|p1_desc=boolean, If [[TRUE]] any avatar that sits on it is forced into [[mouselook]] mode. [[FALSE]] undoes this setting.
|func_footnote=A [[llSitTarget|sit target]] is not necessary for this function to work.
|func_footnote=If '''mouselook''' is [[TRUE]] then when an avatar sits upon the prim, the avatar will be forced into [[mouselook]] mode.<br/>[[FALSE]] is the default state and will not change the agents camera mode.<br/>A [[llSitTarget|sit target]] is not necessary for this function to work.
|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
Line 17: Line 17:
|examples=
|examples=
'''Force Mouselook on Sit'''
'''Force Mouselook on Sit'''
<lsl>default
<source lang="lsl2">default
{
{
     state_entry()
     state_entry()
     {
     {
         llForceMouselook(TRUE);
         llForceMouselook(TRUE); // Forces sitting avatars into mouselook.
 
        llForceMouselook(FALSE); // Reverts the setting to the default...
                                // ...as with a newly created prim.
     }
     }
}</lsl>
}</source>
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llAvatarOnSitTarget]]|}}
|also_functions={{LSL DefineRow||[[llAvatarOnSitTarget]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llGetCameraRot]]|}}
{{LSL DefineRow||[[llSetCameraAtOffset]]|}}
{{LSL DefineRow||[[llSetCameraAtOffset]]|}}
{{LSL DefineRow||[[llSetCameraEyeOffset]]|}}
{{LSL DefineRow||[[llSetCameraEyeOffset]]|}}
Line 40: Line 44:
|cat3=Camera
|cat3=Camera
|cat4=Prim
|cat4=Prim
|cat5=Mouselook
|cat6=Status
|cat7
|cat8
}}
}}

Latest revision as of 01:25, 22 January 2015

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, if FALSE (default) the avatar will keep their current camera mode.

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

default
{
    state_entry()
    {
        llForceMouselook(TRUE); // Forces sitting avatars into mouselook.

        llForceMouselook(FALSE); // Reverts the setting to the default...
                                 // ...as with a newly created prim.
    }
}

Deep Notes

Search JIRA for related Issues

Tests

•  llForceMouseLook Test

Signature

function void llForceMouselook( integer mouselook );