查看“LlSetLinkMedia”的源代码

{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}}


{{函数详情
|函数名 = Function: integer llSetLinkMedia( integer link, integer face, list params );
|参数= 参数：
• integer 
link 
– 
Link number (0: unlinked, 1: root prim, >1: child prims) or a LINK_* flag 

• integer 
face 
– 
face number 

• list 
params 
– 
a set of name/value pairs (in no particular order) 
|返回值= 返回值：毫不延迟地为链接的prim(s)上的特定面孔设置媒体参数。

返回一个status(一个整数)，它是STATUS_*标志，详细说明操作的成功/失败。

|注意事项=
link需要是一个实际的链接号，或者是一个等同于单个prim的链接常量，比如LINK_ROOT和LINK_THIS。
  LINK_SET、LINK_ALL_CHILDREN和LINK_ALL_OTHERS将不能工作。
link不能是坐着的化身。

如果该函数的面值表示一个不存在的面值，则该函数将悄无声息地失败。

如果该对象上还没有prim media，则将添加它。

如果prim media是新添加到该对象的，未指定的参数将取其默认值。

如果prim媒体已经在该对象上，未指定的参数将不变。

关于PRIM_MEDIA_WIDTH_PIXELS (width)和PRIM_MEDIA_HEIGHT_PIXELS (height)…
  必须同时指定宽度和高度才能工作。它们缩小了纹理空间，而相反地扩大了光圈，即更小的值“放大”。
    如果没有指定宽度和高度，函数假设每个宽度和高度为1024。
  当PRIM_MEDIA_AUTO_SCALE为TRUE时，任何宽度和高度不精确为2n且0≤n < 12的值都将被“四舍五入”到下一个值，即将PRIM_MEDIA_WIDTH_PIXELS设为257与设为512效果相同。任何超出[0,2048]范围的值都将导致函数向DEBUG_CHANNEL发出消息并失败。使用0(0)会导致使用默认值1024。
  ''将宽度和高度作为“屏幕大小”的设置可能会有所帮助。如果媒体小于此“屏幕”，则媒体下方和/或右侧将有空白。如果媒体大于这个“屏幕”，滚动条就会显示出来。在不改变面的水平缩放、垂直缩放、水平偏移和垂直偏移的情况下重新缩放prim只会扭曲(拉伸/压缩)媒体。''等待审核。NM
  宽度和高度缩放超过1024像素将需要纹理背景调整大小以适应。(见有用片段)
    如果调整大小以适应，结果视图将切断边界外的滚动内容，使其不可能被查看。

|示例=
<pre>
</pre>

|相关函数=
[[llGetLinkNumber]] - 返回脚本所在的prim的链接号。

[[llSetPrimMediaParams]]

[[llGetLinkMedia]]

[[llClearLinkMedia]] 
|相关事件=
}}
附录：（表格）
{| class="wikitable" border="1"
|-
! colspan="2" | Flag
! Description
|-
| [[LINK_ROOT]] 
| 1
| 指多prim链接集合[1]中的根prim
|-
| [[LINK_THIS]] 
| -4
| refers to the prim the script is in 
|}

{| class="wikitable" border="1"
|-
! Success/Failure Flags
! 	
! Description
|-
| [[STATUS_BOUNDS_ERROR]] 
| 1002
| 传递给函数的参数有一个边界错误
|-
| [[STATUS_INTERNAL_ERROR]] 
| 1999
| 发生了内部错误
|-
| [[STATUS_MALFORMED_PARAMS]] 
| 1000
| 函数被调用时参数不正确
|-
| [[STATUS_NOT_FOUND]] 
| 1003
| 未找到对象或其他项目
|-
| [[STATUS_NOT_SUPPORTED]] 
| 1004
| 功能不支持
|-
| [[STATUS_OK]] 
| 0
| 函数调用成功
|-
| [[STATUS_TYPE_MISMATCH]] 
| 1001
| 传递给函数的参数类型不匹配
|-
| [[STATUS_WHITELIST_FAILED]] 
| 2001
| 白名单失败
|}
{| class="wikitable" border="1"
|-
! colspan="2" | Parameter
! Additional Parameters	
! Description 
|-
| [ [[PRIM_MEDIA_ALT_IMAGE_ENABLE]] ] 
| 0
| [ [[integer]] boolean ] 
| 设置所选面孔的默认图像状态(用户在媒体之前看到的图像是活动的)。默认映像是由Second Life的服务器为该媒体类型指定的。
注意:这个标志目前还没有实现。
|-
| rowspan="4" | [ [[PRIM_MEDIA_CONTROLS]] ] 
| rowspan="4" | 1
| [ [[integer]] control ] 
| 设置控件的样式。可以是[[PRIM_MEDIA_CONTROLS_STANDARD]]或[[PRIM_MEDIA_CONTROLS_MINI]]。
|-
| '''controls Flags''' 
| '''Description '''
|- 
| PRIM_MEDIA_CONTROLS_STANDARD  0
| 标准的web导航控件。
|-
| PRIM_MEDIA_CONTROLS_MINI      1
| 迷你网页导航控制;不包括地址栏。
|-
| [ [[PRIM_MEDIA_CURRENT_URL]] ] 
| 2
| [ [[string]] current_url ] 
| 设置所选面上显示的当前url。更改此URL将导致导航。1024个字符马克斯
|-
| [ [[PRIM_MEDIA_HOME_URL]] ] 
| 3
| [ [[string]] home_url ] 
| 设置所选面的主url。1024个字符最大
|-
| [ [[PRIM_MEDIA_AUTO_LOOP]] ] 
| 4
| [ [[integer]] boolean ] 
| 设置是否启用自动循环。
|-
| [ [[PRIM_MEDIA_AUTO_PLAY]] ] 
| 5
| [ [[integer]] boolean ] 
| 设置媒体是否自动播放时，居民可以查看它。
|-
| [ [[PRIM_MEDIA_AUTO_SCALE]] ] 
| 6
| [ [[integer]] boolean ] 
| 设置是否启用自动伸缩。自动缩放强制媒体到纹理的全尺寸。
|-
| [ [[PRIM_MEDIA_AUTO_ZOOM]] ] 
| 7
| [ [[integer]] boolean ] 
| 设置单击媒体是否会触发媒体上的自动缩放和自动对焦。
|-
| [ [[PRIM_MEDIA_FIRST_CLICK_INTERACT]] ] 
| 8
| [ [[integer]] boolean ] 
| 设置是否启用第一次单击交互。
注意:这个标志似乎不工作。
|-
| [ [[PRIM_MEDIA_WIDTH_PIXELS]] ] 
| 9
| [ [[integer]] width ] 
| 设置媒体的宽度，以像素为单位。
|-
| [ [[PRIM_MEDIA_HEIGHT_PIXELS]] ] 
| 10
| [ [[integer]] height ] 
| 以像素为单位设置媒体高度。
|-
| [ [[PRIM_MEDIA_WHITELIST_ENABLE]] ] 
| 11
| [ [[integer boolean]] ] 
| 设置导航是否限制为prim_media_白名单中的url。
|-
| [ [[PRIM_MEDIA_WHITELIST]] ] 
| 12
| [ [[string]] CSV ] 
| 将白名单设置为转义的、逗号分隔的url字符串。这个字符串最多可以容纳64个url或1024个字符，无论哪个在先。
|-
| [ [[PRIM_MEDIA_PERMS_INTERACT]] ] 
| 13
| [ [[integer]] perms ] 
| 设置权限掩码，控制谁可以与对象交互:

[[PRIM_MEDIA_PERM_NONE]] 

[[PRIM_MEDIA_PERM_OWNER]] 

[[PRIM_MEDIA_PERM_GROUP]] 

[[PRIM_MEDIA_PERM_ANYONE]]
|-
| [ [[PRIM_MEDIA_PERMS_CONTROL]] ] 
| 14
| [ [[integer]] perms ] 
| 设置权限掩码，用于控制谁可以看到对象上方的媒体控制栏:

[[PRIM_MEDIA_PERM_NONE]] 

[[PRIM_MEDIA_PERM_OWNER]] 

[[PRIM_MEDIA_PERM_GROUP]] 

[[PRIM_MEDIA_PERM_ANYONE]]
|}