Difference between revisions of "LlForceMouselook"

From Second Life Wiki
Jump to navigation Jump to search
 
m
 
(32 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{LSLFunctionAll|func_id=294|func_sleep=0.0|func_energy=10.0|func=llForceMouselook|p1_type=integer|p1_name=mouselook|func_footnote=If mouselook is TRUE any avatar that sits on this object is forced into mouselook mode|return_text|spec|caveats|examples|helpers|related|also|notes}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
{{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=llForceMouselook
|p1_type=integer|p1_subtype=boolean|p1_name=mouselook
|p1_desc
|func_footnote=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.
|return_text
|spec
|caveats=
*This function has no effect on avatars already seated.
*The user may exit mouselook mode at any time.
**This can be detected by polling [[llGetAgentInfo]].
*There is nothing stopping someone from modifying or making a client that ignores this.
|constants
|examples=
'''Force Mouselook on Sit'''
<source lang="lsl2">default
{
    state_entry()
    {
        llForceMouselook(TRUE); // Forces sitting avatars into mouselook.
 
        llForceMouselook(FALSE); // Reverts the setting to the default...
                                // ...as with a newly created prim.
    }
}</source>
|helpers
|also_functions={{LSL DefineRow||[[llAvatarOnSitTarget]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llGetCameraRot]]|}}
{{LSL DefineRow||[[llSetCameraAtOffset]]|}}
{{LSL DefineRow||[[llSetCameraEyeOffset]]|}}
|also_events
|also_tests=
{{LSL DefineRow||[[llForceMouseLook Test]]|}}
|also_articles
|notes
|permission
|negative_index
|cat1=Sit
|cat2=Vehicle
|cat3=Camera
|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 );