Difference between revisions of "LlForceMouselook"

From Second Life Wiki
Jump to navigation Jump to search
m (multi lang)
m
 
(16 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Multi-lang}}{{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 13: Line 13:
*The user may exit mouselook mode at any time.
*The user may exit mouselook mode at any time.
**This can be detected by polling [[llGetAgentInfo]].
**This can be detected by polling [[llGetAgentInfo]].
*There is nothing stopping someone from modifying or making a client that ignores this.
|constants
|constants
|examples=
|examples=
'''Force Mouselook on Sit'''
'''Force Mouselook on Sit'''
<pre>
<source lang="lsl2">default
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.
     }
     }
}
}</source>
</pre>
|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]]|}}
|also_events
|also_events
|also_tests
|also_tests=
{{LSL DefineRow||[[llForceMouseLook Test]]|}}
|also_articles
|also_articles
|notes
|notes
Line 40: Line 44:
|cat3=Camera
|cat3=Camera
|cat4=Prim
|cat4=Prim
|cat5=Mouselook
|cat6=Status
|cat7
|cat8
}}
}}

Latest revision as of 00:25, 22 January 2015

Summary

Function: llForceMouselook( integer mouselook );
0.0 Forced Delay
10.0 Energy

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.

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

Tests

•  llForceMouseLook Test

Signature

function void llForceMouselook( integer mouselook );