OsGetLinkPrimitiveParams

From OpenSimulator

Revision as of 02:15, 4 June 2011 by Makopoppo (Talk | contribs)

Jump to: navigation, search

LSL: list osGetLinkPrimitiveParams( integer linknumber, list params )
C#: LSL_List osGetRegionStats( int linknumber, LSL_List params )

Returns the primitive parameters for the linkset prim or prims specified by linknumber. It is possible to use the linkset constants (e.g. LINK_SET, LINK_ALL_CHILDREN) in place of a specific link number, in which case the requested parameters of each relevant prim are concatenated to the end of the list. Otherwise, the usage is identical to llGetPrimitiveParams().

This function has a threat level of High, to prevent unscrupulous users from easily retrieving the construction details of an entire linkset. Please see the threat level page for information on how to enable the use of this function securely.

Example script:

// llGetLinkPrimitiveParams() example script
//
// Trivial example which averages the sizes of all the prims in the linkset and returns the resuilt.
//
default
{
    state_entry()
    {
        vector average = ZERO_VECTOR;
        list params = osGetLinkPrimitiveParams( LINK_SET, [ PRIM_SIZE ] );
        integer len = llGetListLength( params );
        integer i;
 
        for (i = 0; i < len; i++)
            average += llList2Vector( params, i );
 
        average /= (float) len;
        llOwnerSay( "The average size of the prims in this linkset is " + (string) average );
    }
}
Personal tools
General
About This Wiki