View source for LlSetLinkMedia

{{LSL_Function
|inject-2={{LSL_Function/face|face|notall=*}}{{LSL_Function/link|link|nogroup=*}}{{Issues/SVC-7422}}
|func_id=?|func_sleep=0.0|func_energy=0.0|mode
|func=llSetLinkMedia|return_type=integer|return_subtype=status
|p1_type=integer|p1_subtype=link|p1_name=link|p1_desc
|p2_type=integer|p2_name=face|p2_desc
|p3_type=list|p3_subtype=instructions|p3_name=params|p3_desc=a set of name/value pairs (in no particular order)
|func_footnote=
|func_desc=Set the media {{LSLP|params}} for a particular {{LSLP|face}} on the {{LSLP|link}}ed prim(s) without a delay.
|return_text=that is a STATUS_* flag which details the success/failure of the operation(s).
|spec=
|caveats=*If prim-media is not already on this object, add it.
*Params not specified are unchanged, or if new media is added set to the default specified.
* Both width and height must be specified together to work, and they narrow the texture space while inversely widening the aperture.
** width and height scaled larger than 1024pixels will require the texture backdrop to be resized to fit(see [[#Useful_Snippets|Useful Snippets]])
*** if resized to fit, the resulting view will cut off scrolled content outside the bounds making it impossible to be viewed
|constants={{LSL Constants/ReturnStatus|table=*|sortable=*}}{{LSL Constants/PrimMedia|set}}
|examples
|helpers=<lsl>//-- expand media textures greater than 1024 pixel in a direction to fit the media face
//-- does exactly what the "align" button does in the edit window
//-- original by Edelman Linden (or Kate Linden), tweaked by Void Singer
uExpandMediaTexture( integer vIntWidth, integer vIntHeight, integer vIntFace ){
    integer vIntTemp;
    vector  vSizScale;

    while (vIntWidth >> ++vIntTemp);
    vSizScale.x = vIntWidth / (float)(1 << vIntTemp);
    vIntTemp = 0;
    while (vIntHeight >> ++vIntTemp);
    vSizScale.y = vIntHeight / (float)(1 << vIntTemp);
    llSetLinkPrimitiveParamsFast( LINK_THIS,
                                  [PRIM_TEXTURE, vIntFace] +
                                  llListReplaceList( llGetLinkPrimitiveParams(LINK_THIS, [PRIM_TEXTURE, vIntFace] ),
                                                    [vSizScale, ((vSizScale - <1.0, 1.0, 0.0>) / 2.0)],
                                                    1,
                                                    2 ) );
}</lsl>
|also_functions=
{{LSL DefineRow||[[llSetPrimMediaParams]]}}
{{LSL DefineRow||[[llGetLinkMedia]]}}
{{LSL DefineRow||[[llClearLinkMedia]]}}
|also_tests
|also_events=
|also_articles=*[[User:Kelly Linden/lsl hacks]]
|notes
|deepnotes
|history = Date of Release  [[ Release_Notes/Second_Life_Server/11#11.08.10.238207 | 10/08/2011 ]]
|cat1=Prim Media
|cat2=Media
|cat3=Link/Set
|cat4
}}
[[Category:Shared Media]]