Difference between revisions of "LlTargetRemove"

From Second Life Wiki
Jump to navigation Jump to search
m (lsl code tagging)
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|inject-2={{LSL Function/handle|handle|at_target|not_at_target}}
|func_id=67|func_sleep=0.0|func_energy=10.0
|func_id=67|func_sleep=0.0|func_energy=10.0
|func=llTargetRemove
|func=llTargetRemove
|p1_type=integer|p1_name=number
|p1_type=integer|p1_subtype=handle|p1_name=handle
|func_footnote
|func_footnote
|func_desc=Removes positional target '''number''' registered with {{LSLG|llTarget}}
|func_desc=Removes positional target {{LSLP|handle}} registered with [[llTarget]]
|return_text
|return_text
|spec
|spec
Line 10: Line 11:
|constants
|constants
|examples=
|examples=
<lsl>
<source lang="lsl2">
integer target_id;
integer target_id;
vector target_pos;
vector target_pos;
Line 40: Line 41:
     }
     }
}
}
</lsl>
</source>
|helpers
|helpers
|also_functions=*{{LSLG|llTarget}}
|also_functions={{LSL DefineRow||[[llTarget]]}}
*{{LSLG|llRotTarget}}
{{LSL DefineRow||[[llRotTarget]]}}
*{{LSLG|llRotTargetRemove}}
{{LSL DefineRow||[[llRotTargetRemove]]}}
|also_tests
|also_tests
|also_events=*{{LSLG|at_target}}
|also_events={{LSL DefineRow||[[at_target]]}}
*{{LSLG|not_at_target}}
{{LSL DefineRow||[[not_at_target]]}}
|also_articles
|also_articles
|notes
|notes
|cat1=Target
|cat1=Target
|cat2=Physics
|cat2=Physics
|cat3
|cat3=Stop
|cat4
|cat4=At Target
}}
}}

Latest revision as of 12:28, 22 January 2015

Summary

Function: llTargetRemove( integer handle );

Removes positional target handle registered with llTarget

• integer handle handle to control at_target and not_at_target events

Examples

integer target_id;
vector target_pos;

default
{
    state_entry()
    {
        target_pos = llGetPos() + <1.0, 0.0, 0.0>;
        target_id = llTarget(target_pos, 0.5);
    }
    at_target(integer tnum, vector targetpos, vector ourpos)
    {
        if (tnum == target_id)
        {
            llOwnerSay("object is within range of target");
            llOwnerSay("target position: " + (string)targetpos + ", object is now at: " + (string)ourpos);
            llOwnerSay("this is " + (string)llVecDist(targetpos, ourpos) + " meters from the target");
            llTargetRemove(target_id);
        }
    }
    not_at_target()
    {
        llOwnerSay(
            "not there yet - object is at " + (string)llGetPos() + 
            ", which is " + (string)llVecDist(target_pos, llGetPos()) + 
            " meters from the target (" + (string)target_pos + ")"
        );
    }
}

See Also

Events

•  at_target
•  not_at_target

Functions

•  llTarget
•  llRotTarget
•  llRotTargetRemove

Deep Notes

Search JIRA for related Issues

Signature

function void llTargetRemove( integer handle );