OsGetLinkPrimitiveParams

Revision as of 01:15, 4 June 2011

 

Home

 

Download

 

News

 

Support

 

Admin

 

Dev

 

Screen Shots

 

Grid List

 

Bugs

Languages:

English

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 );
    }
}