“LlSetLinkMedia”的版本间的差异

来自人工智能助力教育知识百科
跳转至： 导航、 搜索
（创建页面，内容为“{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}} {{函数详情 |函数名 = Function: integer llSetLinkMedia( integer link, integer face, list p…”）
 
Mkx（讨论 | 贡献）
 
第61行： 第61行：
 
{| class="wikitable" border="1"
 
{| 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]]
 
|}
 
|}

2020年8月24日 (一) 03:13的最新版本

Template:Needs Translation/


函数名
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像素将需要纹理背景调整大小以适应。(见有用片段)
   如果调整大小以适应，结果视图将切断边界外的滚动内容，使其不可能被查看。
示例 







相关函数




llGetLinkNumber - 返回脚本所在的prim的链接号。

llSetPrimMediaParams

llGetLinkMedia

llClearLinkMedia








相关事件








附录：（表格）







Flag

Description




LINK_ROOT

1

指多prim链接集合[1]中的根prim




LINK_THIS

-4

refers to the prim the script is in







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

白名单失败







Parameter

Additional Parameters

Description




[ PRIM_MEDIA_ALT_IMAGE_ENABLE ]

0

[ integer boolean ]

设置所选面孔的默认图像状态(用户在媒体之前看到的图像是活动的)。默认映像是由Second Life的服务器为该媒体类型指定的。

注意:这个标志目前还没有实现。






[ PRIM_MEDIA_CONTROLS ]

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











					

						取自“https://i.bnu.edu.cn/wiki/index.php?title=LlSetLinkMedia&oldid=813”