[MV/MZ]ULDS无限图层插件使用详解 (2023-08-04更新+范例v3)
taroxd大佬的ULDS无限图层插件具有非常强大的图层功能，允许开发者在地图上叠加无限的视差图层。但相信不少人在研究插件的时候都曾为插件帮助中不甚详尽的说明绞尽脑汁……现在论坛上似乎还没有系统的ULDS教程，为了能让更多的新人小白感受到这个插件的魅力，我以我对ULDS浅薄的认识写了这样一篇教程。
与此同时，诚邀各路大神一起解决该教程中的问题，弥补该教程中的缺憾。
2023-08-04 ULDS简易范例更新至v3.00（蓝奏云）：
https://wwll.lanzout.com/iRUuY14d2yte
新增自由淡入淡出和遮罩房间范例，修复了Bug并进一步完善了内容，将无限图层插件帮助文档内容与本帖同步
旧版本范例
该教程将依次讲述以下5个模块，后续也许还会更新：
1. 地图注释（基础）
2. 地图注释（高级）
3. 地图注释例子
4. 设置碰撞体积
5. 技巧
•关于相对地图远景
•关于动态帧图层
•关于简易光源 (2022-12-09更新)
├ 简易圆形光源
└ 简易手电筒
•关于淡入淡出 (2023-07-27更新)
├ 立即淡入淡出
├ 与开关相联的淡入/淡出(仅能同时实现一种)
└ 与开关相联的自由淡入淡出(两种皆可实现)
•关于遮罩房间 (2023-08-04更新)
•（或许以后还会更新...）
* ---------------------------------------------------------------------
*=== ULDS插件使用说明 ===
*
* ULDS插件通过配置地图注释来实现图层功能。
*
*== 1. 地图注释（基础） ==
*
* 在地图注释中按以下格式书写：
*
{
参数1: 值1,
参数2: 值2,
......
参数n: 值n
}
*
* 和之间要以 JSON 格式书写。请自行学习JSON格式如何书写。
*
* 其中，必须有的参数是：
*
* "name": 图片名称。
*
* "x": 图片的x坐标。x坐标越大，图片越靠右。
* 若为 纯数字 ，则表示以 屏幕左上角 为原点的图片x坐标。图片横向位置始终与屏幕保持一致。
* 若为 this.rx(n) ，则表示以 地图左上角 为原点的图片x坐标。
* n 可以是以下2种情况：
* - 若n为 数字，则表示以 地图左上角 为原点的图片x坐标，且x坐标为 n 。
* 例如 this.rx(48) 指的是图片会贴在地图x坐标为 48 像素的位置。
* - 若n为 t ，则图片将会被从左向右滚动播放。
* 如果是 -t ，则图片会被从右向左滚动播放。
*
* "y": 图片的y坐标。y坐标越大，图片越靠下。
* 若为 纯数字 ，则表示以 屏幕左上角 为原点的图片y坐标。图片纵向位置始终与屏幕保持一致。
* 若为 this.ry(n) ，则表示以 地图左上角 为原点的图片y坐标。
* n 可以是以下2种情况：
* - 若n为 数字，则表示以 地图左上角 为原点的图片y坐标，且y坐标为 n 。
* 例如 this.ry(48) 指的是图片会贴在地图y坐标为 48 像素的位置。
* - 若n为 t ，则图片将会被从上到下滚动播放。
* 如果是 -t ，则图片会被从下向上滚动播放。
*
* 其他可供选择的基础参数有：
*
* "z": 图片的z层级。默认是0.5（可在插件参数中设置）。小数点可精确至后两位。建议大于1，且为浮点数，这样设置可以最大程度地兼容其他涉及图层的插件（如灯光插件等）。
* 指定图片可以覆盖在z层级小于该图片z层级的所有图片之上。
* 例如，若指定A图片z层级为6，B图片z层级为10，则A图片会覆盖所有z层级低于6的贴图，但会被B图片覆盖。
* RMMV中各贴图的原生层级：0 -> 远景/A区地面图块，3 -> 玩家/事件，4 -> 星标图块。
*
* "path": 自定义图片所在的文件夹。文件夹必须在img文件夹里。默认是parallaxes（插件参数中可配置）
*
* "loop": true/false
* 是否循环播放图片。
*
* 还有一些参数，需要开发人员对Sprite类, Bitmap类属性具有初步的认识：
* （不过本人已将常用参数全部列在下方了，即便不懂脚本的小伙伴们应该也可以看懂）
*
* "smooth": true/false
* 是否应用平滑缩放。
*
* "blendMode": 图片的混合模式。默认是0（正常）。
* RMMV原生混合模式：0 -> 正常，1 -> 叠加，2 -> 正片叠底，3 -> 滤色
*
* "opacity": 图片的不透明度。0-255间的一个数字。默认是255（完全不透明）。
*
* "rotation": 图片的旋转角度（弧度）。数字 兀 在JS中是 Math.PI 。
*
* "scale.x": 图片被横向缩放的倍数。默认是1（不放大）。可以是小数。
* 如果是负数，图片就会被左右镜像翻转。
*
* "scale.y": 图片被纵向缩放的倍数。默认是1（不放大）。可以是小数。
* 如果是负数，图片就会被上下镜像翻转。
*
* "visible": true/false
* 图片是否可见。
*
*
*
*== 2. 地图注释（高级） ==
*
* 上面模块讲的是地图注释的基本格式。这一模块将会讲到该插件的一些高级用法和提供的一些引用。
*
*
* 无限图层的设置在游玩时是即时动态更新的。
* 所以在地图注释中，可以调用$gameSwitches和$gameVariables等脚本的值来实时控制图片的状态。
*
* 例如：
*
* · 参数"visible"可以这样写：
* "visible": "$gameSwitches.value(2)"
* - 这表示由开关#2来实时控制图片的显示与隐藏。
*
* · 参数"rotation"可以这样写：
* "rotation": "$gameVariables.value(1)*Math.PI"
* - 这表示由变量#1来控制图片的旋转角度。变量#1最好是介于0到2的数字。
*
* 当然，以此类推，其他插件提供的脚本变量/开关也可以使用。
*
*
* 也许各位会觉得每次写$gameVariables, $gameSwitches什么的太麻烦了，还容易写错，
* 那么可以考虑使用插件作者提供的引用：s 和 v 来代替开关和变量。
*
* 仍以上面举过的两个例子为例：
*
* · 参数"visible"可以这样写：
* "visible": "s.value(2)"
* - 这表示由开关#2来实时控制图片的显示与隐藏。
*
* · 参数"rotation"可以这样写：
* "rotation": "v.value(1)*Math.PI"
* - 这表示由变量#1来控制图片的旋转角度。变量#1最好是介于0到2的数字。
*
* 除了 s, v 这两个引用之外，插件作者还提供了一个引用。
* 还记得前面提到的 this.rx(t) 吗？
* 其中的 t 也是一个引用。t 代表每帧都会自增（自己+1）的一个数字。初始值是0。
*
* 一个地图中可以添加多个注释。利用z层级来控制各图层的叠加情况，就可以非常灵活地制作视差地图了！
*
*
*
* == 3. 例子 ==
*
{
"name": "BlueSky",
"x": "this.rx(t)",
"y": 50,
"z": 10.5,
"loop": true,
"scale.x": -1,
"visible": "s.value(3)"
}
* - 在地图中使用位于img/parallaxes/中的BlueSky.png图片。
* 该图片Z层级是10.5，在横向位置上以正常速度(1帧1像素)从左向右循环自滚动，在纵向位置上相对于屏幕的y坐标为50，图片被左右镜像反转，由开关#3控制显示和隐藏。
*
{
"name": "Night",
"path": "pictures",
"x": "this.rx(48)",
"y": "this.ry(48)",
"z": 20,
"visible": "s.value(5)",
"scale.x": "v.value(2)",
"scale.y": "v.value(2)",
"blendMode": 2,
"rotation": "Math.PI"
}
* - 在地图中使用位于img/pictures/中的Night.png图片。
* 该图片Z层级是20，相对于地图的坐标为(48, 48)，由开关#5控制显示和隐藏，
* 横纵向缩放的倍数是变量#2的值，混合模式是正片叠底，以图片左上角为锚点，旋转180°。
*
*
*
*== 4. 设置碰撞体积 ==
*
* ULDS插件本身不提供碰撞体积功能。
*
* 默认情况下，在地图的图块组 A组 中随意寻找 可通行图块 和 不可通行图块 各一种，
* 然后根据所使用的图层直接在RMMV地图编辑器中绘制相应可通行/不可通行区域即可。
*
* 似乎也可以使用与该插件同作者的RegionPassage.js，用区域来设置相应可通行/不可通行区域。
*
* 如果有更为细微的需求（例如半格或不规则碰撞体积），也可以找找别的插件。
* 例如QM+CollisionMap.js及其前置插件QMovement.js，允许你进行像素级移动，
* 并通过检查一张图片的颜色来设定通行设置。
* 图片白色和透明部分是可通行的地方，其他颜色不可通行。
*
*
*
*== 5. 技巧 ==
*
* 可以先稍微熟悉一下以上四个模块的内容，再来看这一模块。
*
*
*= 关于相对地图远景 =
*
* 设想情景：玩家正行走在一处山峰中。山峰会随着玩家的走动而移动。
* 表现形式：距离镜头近的山峰移动速度快。距离镜头远的山峰(背景)移动速度慢。
* 核心问题：解决不同山峰贴图的不同移动速度问题。
* 解决方法：在原来注释的基础上，只给各个贴图相应的注释参数"x"和"y"值乘一个PARAM即可：
* (比如如果贴图原先位于相对于地图的(0, 0)处，就做出如下改动：)
* "x": "this.rx(0)*PARAM",
* "y": "this.ry(0)*PARAM",
* 其中，PARAM 是一个数字。
* - 对于 距离镜头近 的贴图：PARAM 最好是一个1以上的数字。
* 数字越大，贴图随玩家移动的速度越快，所演绎的贴图与镜头的距离就越近。
* 记得将z层级设为4以上。
* - 对于 距离镜头远 的贴图：PARAM 最好是一个0到1之间的小数。
* 小数越小，贴图随玩家移动的速度越慢，所演绎的贴图与镜头的距离就越远。
* 记得将z层级设为3以下。
*
*
*= 关于动态帧图层 =
*
* 设想情景：玩家走到一处风景宜人的桃源乡暂且歇脚。湖泊中流水潺潺，好一幅生机勃勃之景。
* 表现形式：用多帧图层来表现动态的湖水。
* 核心问题：如何按照指定帧数依次显示湖水的各个图层。
* 解决方法：假设图层相对于地图位于(144, 144)，共有3帧(湖泊_1, 湖泊_2, 湖泊_3)，
* 则创建以以下格式书写的地图注释：
{
"name": "湖泊_1",
"x": "this.rx(144)",
"y": "this.ry(144)",
"z": 1.5,
"visible": "v.value(10) === 0"
}
{
"name": "湖泊_2",
"x": "this.rx(144)",
"y": "this.ry(144)",
"z": 1.5,
"visible": "v.value(10) === 1"
}
{
"name": "湖泊_3",
"x": "this.rx(144)",
"y": "this.ry(144)",
"z": 1.5,
"visible": "v.value(10) === 2"
}
* 在这个例子中，属性"visible"中的条件占用了变量#10。
* 如果想替换为别的变量，直接将所有出现的"10"替换为所使用的变量ID即可。
* 随后，在地图上创建一个并行处理的事件，内容如下：
* ◆等待：n 帧
* ◆变量操作：#0010 = 1
* ◆等待：n 帧
* ◆变量操作：#0010 = 2
* ◆等待：n 帧
* ◆变量操作：#0010 = 0
* n 是图层的帧间隔。
* 这样应该就没什么问题了。
*
*
*= 关于简易光源 =2022-12-09更新
*
* 设想情景：玩家/跟随者/事件在黑暗中行走，只有柔和的光源相伴左右，营造出一种静谧的氛围。
*
* 注意，这一例子主要是讲解将图片绑定在玩家/跟随者/事件上的方法和介绍图片锚点属性。
* 这一部分所制作的光源一个地图只能使用一张，局限性非常大，如果有需求的话还是要使用插件。
* 不过通过将图片绑定在玩家/跟随者/事件上与动态帧图层方法结合起来，可以制作类似角色行走图特效等的效果。
*
* 0.光源图片的配置
*
* 这一部分所要用到的光源图片并非一张简单的有色光源图片，而是背景为纯黑色，只有中心部分镂空作为光源的一张图片。
* 图片的尺寸下限以游戏分辨率为准。一格默认为48像素x48像素，如果分辨率为17格x13格（816像素x624像素），那么图片的大小至少应当是(17x2-1)格x(13x2-1)格，即1584像素x1200像素。
* 在这一情况下，考虑到图片文件的大小，可以适当缩小图片，使用时设置"scale.x"和"scale.y"属性调整缩放值即可。
*
* 在此提供两张用于816x624分辨率下游戏的光源图片。使用时需要将"scale.x"和"scale.y"属性均设为2。建议将"opacity"设为225。
0
*
* 1.简易圆形光源 (烛光)
*
* 表现形式：以玩家/跟随者/事件为中心，周身环绕着圆形的光源。
* 核心问题：如何将圆形光源图片绑定在玩家/跟随者/事件身上。
* 解决方法：假设圆形光源图片名为 light.png ，为了将图片绑定到*玩家*身上，
* 则创建以以下格式书写的地图注释：
{
"name": "light",
"x": "this.rx(($gamePlayer._realX+1/2)*$gameMap.tileWidth())",
"y": "this.ry(($gamePlayer._realY+1/2)*$gameMap.tileHeight())",
"z": 5,
"anchor.x": 0.5,
"anchor.y": 0.5,
"visible": "v.value(11) == 1"
}
* 将变量#11的值设为1时图片就会显现出来。
*
* 其中，"anchor.x"和"anchor.y"属性是指图片的锚点。锚点的位置将会影响图片的旋转和缩放效果。
* 锚点在左上角时"anchor.x"和"anchor.y"分别为0, 0，在中央时分别为0.5, 0.5，在右下角时分别为1, 1，以此类推。
*
* ※如果想将光源图片绑定到*跟随者*上的话，就将"x""y"属性中的$gamePlayer替换成$gamePlayer.followers().visibleFollowers()。INDEX从零开始计数，第一个跟随者（地图上玩家身后的角色）索引是0。
* ※如果想将光源图片绑定到*事件*上的话，就将"x""y"属性中的$gamePlayer替换成$gameMap.event(EVENT_ID)。EVENT_ID是事件ID。
*
* 2.简易手电筒
*
* 表现形式：手电筒的光源将会永远朝向玩家/跟随者/事件的正前方。
* 核心问题：如何让手电筒光源图片的旋转角度与玩家的朝向相关联。
* 解决方法：假设手电筒光源图片名为flashlight.png，图片中手电筒光源朝下，为了将图片绑定到*玩家*身上，
* 则创建以以下格式书写的地图注释：
{
"name": "flashlight",
"x": "this.rx(($gamePlayer._realX+1/2)*$gameMap.tileWidth())",
"y": "this.ry(($gamePlayer._realY+1/2)*$gameMap.tileHeight())",
"z": 5,
"anchor.x": 0.5,
"anchor.y": 0.5,
"visible": "v.value(11) == 2",
"rotation": "(function(){var obj = $gamePlayer;if(obj.direction()==2) return 0;if(obj.direction()==4) return 1/2*Math.PI;if(obj.direction()==8) return Math.PI;if(obj.direction()==6) return -1/2*Math.PI;})()"
}
* 将变量#11的值设为2时图片就会显现出来。
*
* 对于将手电筒光源图片绑定到跟随者/事件上的方法，参见 1.简易圆形光源 (烛光) 部分。记得将"rotation"属性值中的$gamePlayer也替换掉。
*
*
* = 关于淡入淡出 =2023-07-27更新
*
* 1. 立即淡入淡出
*
* 设想情景：玩家甫一进入洋馆客房，房间墙壁和地毯上竟慢慢浮现出大块大块狰狞的暗褐色污渍。
* 表现形式：玩家进入地图时，血迹贴图渐渐由透明变为不透明（淡入）。
* 核心问题：如何使血迹贴图的不透明度随时间推移而增大。
* 解决方法：假设血液贴图的名称为 blood.png ，以图片左上角为锚点，贴图位于 (123, 456)，需要在 1.5s 内显现，
* 则创建以以下格式书写的地图注释：
{
"name": "blood",
"x": "this.rx(123)",
"y": "this.ry(456)",
"z": 3.5,
"opacity": "(function(){var duration=1.5;var f=duration*60;var val=255/f;if(t
页:
[1]