Difference between revisions of "LlForceMouselook"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Search JIRA for related Issues
m (Behaviour when used in a HUD) |
m |
||
| Line 5: | Line 5: | ||
|p1_name=mouselook | |p1_name=mouselook | ||
|p1_desc=boolean, If [[TRUE]] any avatar that sits on it is forced into [[mouselook]] mode. [[FALSE]] undoes this setting. | |p1_desc=boolean, If [[TRUE]] any avatar that sits on it is forced into [[mouselook]] mode. [[FALSE]] undoes this setting. | ||
|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_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. | ||
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 | ||
| Line 41: | Line 43: | ||
|cat4=Prim | |cat4=Prim | ||
|cat5=Mouselook | |cat5=Mouselook | ||
|cat6=Status | |||
|cat7 | |||
|cat8 | |||
}} | }} | ||
Revision as of 17:32, 12 June 2009
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llForceMouselook( integer mouselook );| 294 | Function ID |
| 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 any avatar that sits on it is forced into mouselook mode. FALSE undoes this setting. |
If mouselook is TRUE then when an avatar sits upon the prim, the avatar will be forced into mouselook mode.
FALSE is the default state and will not change the agents camera mode.
A 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.
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.
Examples
Force Mouselook on Sit <lsl>default {
state_entry()
{
llForceMouselook(TRUE);
}
}</lsl>
See Also
Functions
| • | llAvatarOnSitTarget | |||
| • | llGetAgentInfo | |||
| • | llSetCameraAtOffset | |||
| • | llSetCameraEyeOffset |
Deep Notes
Tests
| • | llForceMouseLook Test |
Signature |
|---|
function void llForceMouselook( integer mouselook ); |