Difference between revisions of "LlPushObject"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m (rotation on agents) |
m (<lsl> tag to <source>) |
||
| (9 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL_Function/uuid|target|sim=*|object=*}} | |||
|func_id=165|func_sleep=0.0|func_energy=10.0 | |func_id=165|func_sleep=0.0|func_energy=10.0 | ||
|func=llPushObject | |func=llPushObject | ||
|p1_type=key|p1_name=target|p1_desc | |p1_type=key|p1_name=target|p1_desc | ||
|p2_type=vector|p2_name=impulse | |p2_type=vector|p2_name=impulse|p2_desc=Direction and force of push. Direction is affected by {{LSLP|local}}.|p2_hover=Direction and force of push. Direction is affected by 'local'. | ||
|p3_type=vector|p3_name=ang_impulse|p3_desc= | |p3_type=vector|p3_name=ang_impulse|p3_desc=Rotational force. | ||
|p4_type=integer|p4_name=local|p4_desc=boolean, if {{LSL Const|TRUE|integer|1}} uses the [[Viewer coordinate frames#Local|local]] axis of | |p4_type=integer|p4_name=local|p4_desc=boolean, if {{LSL Const|TRUE|integer|1}} uses the [[Viewer coordinate frames#Local|local]] axis of {{LSLP|target}}, if {{LSL Const|FALSE|integer|0}} uses the [[Viewer coordinate frames#Region|region]] axis.|p4_hover=boolean, if TRUE uses the local axis of 'target', if FALSE uses the region axis. | ||
|func_footnote | |func_footnote | ||
|func_desc=Applies | |func_desc=Applies {{LSLP|impulse}} and {{LSLP|ang_impulse}} to object {{LSLP|target}} | ||
|return_text | |return_text | ||
|spec | |spec | ||
| Line 14: | Line 15: | ||
*The effectiveness of Push is modulated by the amount of [[Energy|script energy]] available. | *The effectiveness of Push is modulated by the amount of [[Energy|script energy]] available. | ||
**There is a [[LlPushObject/Havok4Implementation|simplified code snippet]] describing how Push is implemented in the Havok4 project and reveals some of the details of how the energy budget affects the final Push magnitude. | **There is a [[LlPushObject/Havok4Implementation|simplified code snippet]] describing how Push is implemented in the Havok4 project and reveals some of the details of how the energy budget affects the final Push magnitude. | ||
* | *In no-push areas an object can only push its owner. | ||
* | *{{LSLP|ang_impulse}} is ignored when applying to agents or their attachments. | ||
*[[Energy]] use is calculated as magnitude of {{LSLP|impulse}} divided by 20,000. | |||
*The push impact is diminished with distance by a factor of distance cubed. | |||
|constants | |constants | ||
|examples= | |examples= | ||
< | <source lang="lsl2">// Pushes the collided object or avatar. | ||
default | default | ||
{ | { | ||
| Line 25: | Line 28: | ||
llPushObject(llDetectedKey(0),<0,0,100>, <0,0,100>, TRUE); | llPushObject(llDetectedKey(0),<0,0,100>, <0,0,100>, TRUE); | ||
} | } | ||
}</ | }</source> | ||
|helpers | |helpers | ||
|also_functions | |also_functions | ||
| Line 35: | Line 38: | ||
|negative_index | |negative_index | ||
|cat1=Physics | |cat1=Physics | ||
|cat2 | |cat2=Movement | ||
|cat3 | |cat3 | ||
|cat4 | |cat4 | ||
}} | }} | ||
Revision as of 14:15, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llPushObject( key target, vector impulse, vector ang_impulse, integer local );| 165 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Applies impulse and ang_impulse to object target
| • key | target | – | group, avatar or object UUID that is in the same region | |
| • vector | impulse | – | Direction and force of push. Direction is affected by local. | |
| • vector | ang_impulse | – | Rotational force. | |
| • integer | local | – | boolean, if TRUE uses the local axis of target, if FALSE uses the region axis. |
Caveats
- Only works on land where Push is not restricted or where the script is owned by the land owner.
- If the land is owned by a group, the scripted object must be deeded to the same group.
- The effectiveness of Push is modulated by the amount of script energy available.
- There is a simplified code snippet describing how Push is implemented in the Havok4 project and reveals some of the details of how the energy budget affects the final Push magnitude.
- In no-push areas an object can only push its owner.
- ang_impulse is ignored when applying to agents or their attachments.
- Energy use is calculated as magnitude of impulse divided by 20,000.
- The push impact is diminished with distance by a factor of distance cubed.
Examples
// Pushes the collided object or avatar.
default
{
collision_start(integer num_detected)
{
llPushObject(llDetectedKey(0),<0,0,100>, <0,0,100>, TRUE);
}
}
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function void llPushObject( key target, vector impulse, vector ang_impulse, integer local ); |