| Parameter |
Additional Parameters |
Description |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets the default image state (the image that the user sees before a piece of media is active) for the chosen face. The default image is specified by Second Life's server for that media type. **Note:** This flag is not currently implemented. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **control** \] |
Sets the style of controls. Can be either [PRIM_MEDIA_CONTROLS_STANDARD](/constants/PRIM_MEDIA_CONTROLS_STANDARD/) or [PRIM_MEDIA_CONTROLS_MINI](/constants/PRIM_MEDIA_CONTROLS_MINI/). |
| **controls** Flags |
Description |
| \[ [string](https://wiki.secondlife.com/wiki/string) **current_url** \] |
Sets the current url displayed on the chosen face. Changing this URL causes navigation. 1024 characters Max |
| \[ [string](https://wiki.secondlife.com/wiki/string) **home_url** \] |
Sets the home url for the chosen face. 1024 characters max |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets whether auto-looping is enabled. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets whether the media auto-plays when a Resident can view it. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets whether auto-scaling is enabled. Auto-scaling forces the media to the full size of the texture. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets whether clicking the media triggers auto-zoom and auto-focus on the media. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets what happens when someone click on a playing, but unfocused media face:
- [TRUE](/constants/TRUE/): Does the same thing a focused media face does, and forwards the click to the web browser.
- [FALSE](/constants/FALSE/): Focuses the media prim so that future clicks are forwarded to the web browser.
**Note:** Viewer settings affect this flag. It works by default on most prims.
|
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **width** \] |
Sets the width of the media in pixels. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **height** \] |
Sets the height of the media in pixels. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **boolean** \] |
Sets whether navigation is restricted to URLs in [PRIM_MEDIA_WHITELIST](/constants/PRIM_MEDIA_WHITELIST/). |
| \[ [string](https://wiki.secondlife.com/wiki/string) **CSV** \] |
Sets the whitelist as a string of [escaped](/functions/llEscapeURL/), comma-separated URLs. This string can hold up to 64 URLs or 1024 characters, whichever comes first. |
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **perms** \] |
Sets the permissions mask that control who can interact with the object:
- [PRIM_MEDIA_PERM_NONE](/constants/PRIM_MEDIA_PERM_NONE/)
- [PRIM_MEDIA_PERM_OWNER](/constants/PRIM_MEDIA_PERM_OWNER/)
- [PRIM_MEDIA_PERM_GROUP](/constants/PRIM_MEDIA_PERM_GROUP/)
- [PRIM_MEDIA_PERM_ANYONE](/constants/PRIM_MEDIA_PERM_ANYONE/)
|
| \[ [integer](https://wiki.secondlife.com/wiki/integer) **perms** \] |
Sets the permissions mask that control who can see the media control bar above the object:
- [PRIM_MEDIA_PERM_NONE](/constants/PRIM_MEDIA_PERM_NONE/)
- [PRIM_MEDIA_PERM_OWNER](/constants/PRIM_MEDIA_PERM_OWNER/)
- [PRIM_MEDIA_PERM_GROUP](/constants/PRIM_MEDIA_PERM_GROUP/)
- [PRIM_MEDIA_PERM_ANYONE](/constants/PRIM_MEDIA_PERM_ANYONE/)
|
## 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
- Face needs to be a single face. If you want the media on multiple faces (e. g. opposing sides of an object), you have to call the function multiple times with different face numbers. Bitwise AND for face numbers does not work.
- [PRIM_MEDIA_FIRST_CLICK_INTERACT](/constants/PRIM_MEDIA_FIRST_CLICK_INTERACT/) can be overridden by the viewer setting Me > Preferences > Sound & Media > Media first-interact. By default, it works on Worn HUDs, Owned Objects, Friend Objects, Group Objects, and Landowner Objects
## Helper functions
```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 (width/height are in pixels)
//-- 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);
llSetPrimitiveParams( [PRIM_TEXTURE, vIntFace] +
llListReplaceList( llGetPrimitiveParams( [PRIM_TEXTURE, vIntFace] ),
[vSizScale, ((vSizScale - <1.0, 1.0, 0.0>) / 2.0)],
1,
2 ) );
}
```
ref: [original source](https://wiki.secondlife.com/wiki/How_to_Align_a_Shared_Media_Texture_from_Linden_Script)
## History
- SVN:2816 r134947 Trunk
- [SVC-4939](https://jira.secondlife.com/browse/SVC-4939)
- Functionality available in Client 2.0
## Known issues
From the issue templates included by the wiki article:
- SVC-4939 (bug): \[http://svn.secondlife.com/trac/linden/changeset/2816 SVN Changeset 2816 in Trunk\] is immature
- VWR-17719 (bug): llSetPrimMediaParams PRIM_MEDIA_FIRST_CLICK_INTERACT doesn't work
## See also
### Functions
- [llSetLinkMedia](/functions/llSetLinkMedia/)
- [llGetPrimMediaParams](/functions/llGetPrimMediaParams/)
- [llClearPrimMedia](/functions/llClearPrimMedia/)
### Articles
- [/Tricks](https://wiki.secondlife.com/wiki//Tricks)
---
*Source: [LlSetPrimMediaParams](https://wiki.secondlife.com/wiki/LlSetPrimMediaParams) on the Second Life Wiki. Content from the Second Life Wiki articles LlSetPrimMediaParams (revision 1218887, 2026-06-05), Template:LSL Constants/PrimMedia/Controls (revision 1160766, 2012-01-08), Template:LSL Constants/PrimMedia (revision 1218888, 2026-06-05), Template:LSL Constants/ReturnStatus (revision 1185325, 2013-12-19), Template:Issues/SVC-4939 (revision 1162767, 2012-02-13), Template:Issues/VWR-17719 (revision 1163300, 2012-02-18) and Template:LSL Function/face (revision 1175878, 2013-01-06), CC BY-SA 3.0.*
---
From lsl.dev: https://lsl.dev/functions/llSetPrimMediaParams/