LlSetLinkMedia

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