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

相关事件

附录：（表格）