动态显示屏

{
  "custom_trains": {
    "display_test": {
      "display_slots": "mtr:display_test/slots_small.json",
      "display_content": "mtr:display_test/sink_test.json",
      ...
    }
  }
}

对任意列车设定一个槽位文件 (display_slots) 和一个显示内容控制文件 (display_content) 即可为其增加动态显示屏。

NTE 通过在单独的文件中给出坐标的形式来指定动态显示屏的设置位置。这是为了使得设置更为灵活，以便便利地增加到已有模型的车辆上，同时这也和 RTM 的方向幕设定较为类似。

把它称为槽位。这是一个槽位文件内容的示例：

{
  "version": 1,
  "slots": [
    {
      "name": "led_side",
      "pos": [
         [[1.5, 2.6, -3.1], [1.5, 2.4, -3.1], [1.5, 2.4, -2.5], [1.5, 2.6, -2.5]],
         [[-1.5, 2.6, 3.1], [-1.5, 2.4, 3.1], [-1.5, 2.4, 2.5], [-1.5, 2.6, 2.5]]
       ],
       "offsets": [[0, 0, 0], [0, 0, 2]]
    },
    {
      "name": "led_head",
      "pos": [[[0.3, 2.6, 9.2], [0.3, 2.3, 9.2], [-0.3, 2.3, 9.2], [-0.3, 2.6, 9.2]]]
    }
  ]
}

这个文件里设定了两个槽位。每个槽位可以算作一种显示内容，可以在下面的 pos 中让它在多个屏幕上显示，但是这些屏幕都只能显示相同的内容。

• name 是这个槽位的名称，以稍后在显示内容控制文件中使用。
• pos 是一个三层的数组（注意看括号的数量和分布，避免写错），来写明各个屏幕的位置。每个屏幕只能是矩形，对于每个屏幕，分别按对于其正面来说的右上、右下、左下、左上的顺序给出四个 XYZ 坐标点。坐标原点是列车中心、地板高度，X 正方向向左、Y 正方向向上、Z 正方向向后。
• offsets 是一个两层的数组，用于把 pos 指定的显示屏复制多份，以在如门上方闪灯图的场景中省字。分别给出要复制出的每份的 XYZ 偏移量。如果没有写 offsets，就不会去复制。
  

  基本显示内容

  现实中动态显示屏的内容复杂多变，因此 NTE 提供了一个显示内容控制文件格式来让您详细地表示显示屏的显示逻辑。

{
  "version": 1,
  "texture": "display_test.png",
  "texture_size": [ 512, 512 ],
  "templates": {
    "line_map_sse": { "class": "include", "source": "line_map_sse.json" }
  },
  "logic": {
    "class": "draw",
    "slot": "led_side",
    "src_area": [ 0, 0, 100, 100 ],
    "dst_area": [ 0, 0, 1, 1 ]
  },
}

• texture 是显示屏内容所来自的贴图文件，只允许指定一个。在此处设置为它与显示内容控制文件的相对路径。
• texture_size 是这个贴图文件的尺寸。
• logic 描述屏幕上要显示什么样的内容，以下称为 “操作”。在这个例子里，它用图片中 (0,0) 到 (100,100) 的区域贴满屏幕。
• template 用来辅助说明一些复杂的绘图，以下称为 “模板”。

以下详细介绍操作和模板的使用。

{
  "class": "draw",
  "slot": "led_side",
  "src_area": [ 0, 0, 100, 100 ],
  "dst_area": [ 0, 0, 1, 1 ]
}

将原图中的一部分或全部贴到槽位的一部分或全部上。这里说贴到槽位上，就是指同样地贴到这个槽位里设置的所有显示屏上。

• class 是说明这是要进行哪一类操作，如 "draw" 就代表要进行这个贴图操作。以下不再赘述。
• slot 是要把图贴到哪个槽位上。
• src_area 是原图区域，依次指定左上角坐标、宽度和高度，单位是像素。
• dst_area 是目标区域，同样依次指定左上角坐标、宽度和高度。对于水平坐标，0 是最左侧，1 是最右侧；对于宽度，0 是没有，1 是显示屏宽度；垂直坐标正方向向下，以此类推。
  

  Sequence 操作

  <code json> { “class”: “sequence”, “nodes”: [ { “class”: “draw”, “slot”: “lcddoor”, “srcarea”: [ 0, 0, 100, 100 ], “dstarea”: [ 0, 0, 0.25, 1 ] }, { “class”: “draw”, “slot”: “lcddoor”, “srcarea”: [ 0, 200, 100, 100 ], “dstarea”: [ 0.5, 0, 0.5, 1 ] }, … ] } </code> 显然只能贴一张图是不太够用的。sequence 操作可以套住多个操作，让它们从上到下依次执行。用这个例子作为 "logic" 的话，就会分别贴两次了。在对同一槽位多次贴图时，后处理（写得靠下）的会盖在先处理的上面。

{
  "class": "include",
  "source": "hogehoge.json"
}

引入相对于当前文件目录的另一文件，以便将显示内容分入多个文件书写，条理更清晰。效果相当于以该文件内容整体替换掉这个块。在 logic 和 templates 里面都可以这样做。

{
  "class": "draw_line_map",
  "template": "line_map_sse",
  "slot": "lcd_door",
  "target": "Icon Pier",
  "direction": "left",
  "dst_area": [ 0.2, 0, 0.6, 1 ]
}

{
  "class": "line_map",
  "src_area": [0, 0, 1536, 308],
  "variants_y": {
    "highlight": 308,
    "passed": 616
  },
  "animations": {
    "highlight": { "duration_on": 0.5, "duration_off": 0.5 },
    "progress": { "type": "slide", "duration_on": 0.2, "duration_off": 1.2 }
  },
  "capsule_width": 14,
  "capsules_x": {
    "Al-Tighnari": 224,
    "Inage Kaigan": 339,
    "Layla": 454,
    ...
  }
}

与 MTR 原版的文字显示系统相比，NTE 允许您在显示文字时进行高级的排版，或动态地显示任意内容。

{
  "class": "draw_free_text",
  "slot": "lcd_door",
  "text": {
    "align_v_in": 1,
    "overflow_h": "fit",
    "parts": [
      { "text": "$sta[0].cjk", "size_v": 0.5, "margin": [ 0, 0.01 ] },
      { "text": "$sta[0].eng", "size_v": 0.2 }
    ]
  },
  "dst_area": [ 0.01, 0, 0.18, 1 ]
}

此操作可显示任意文本。不过，由于动态文本渲染的技术局限，此操作比起其他绘制操作性能更低，且只能绘制在最上层（其他 Draw 操作即使在其之后进行也不能叠加在它上方）。

以上示例会以大字显示下一站的中文名，在其右侧以小字紧接显示英文名，文字会在 dst_area 中居中对齐，且字体会在无法容纳时自动缩小。接下来的“排版”和“内容”部分解释 text 里面的格式，以及如 $sta[0].cjk 表示的含义。

{
    "align_h": 0,
    "align_v_out": 0,
    "align_v_in": 1,
    "overflow_h": "scroll",
    "scroll_speed": 0.1,
    "parts": [
        {
            "text": "你好世界",
            "size_v": 0.5,
            "margin": [ 0, 0.05 ]
        },
        {
            "text": "Hello World",
            "size_v": 0.2
        }
    ]
}

可设定多部份左右相接，每部分可分别设定字体大小和颜色等，最后一起参与居中或其他对齐处理。text 中可以使用任意固定文字，也可以使用下述的 “可变内容”。

</code> 一些液晶显示屏会循环切换多个画面。cycle 会将多个显示操作按照 duration 中设定的秒数依次轮换进行。在以上的例子中，会有 1 秒只显示第一个 draw 的内容，不显示第二个 draw 的内容；接下来会有 2 秒只显示第二个 draw 的内容，不显示第一个 draw 的内容。

then 中不仅可使用 draw，也可以使用如 sequence 等其他操作。您可以这样通过多层嵌套来实现更复杂的效果。

如果需要一段时间不进行显示操作，用 "then": null。

{
  "class": "switch",
  "target": "$route[0].eng",
  "nodes": [
    {
      "when": "Sightseeing Express Line",
      "then": { "class": "draw", ... }
    },
    ...
  ]
}

这一操作从多个操作中按照一个 “可变内容” 的内容选出一个来显示。

将 target 设为要判断的可变内容，然后会选出 when 和这一内容相同（区分大小写）的一项。如果都不同，就不显示。也可以用 "when": [ "1", "2" ] 来匹配多个内容。

可以用于给不同线路或走向设定不同内容，或在不同站显示开门方向等。

{
  "class": "if",
  "nodes": [
    { "when": "$dist[-1] < 200", "then": { 刚刚离站... } },
    { "when": "", "then": { 行车中... } },
    { "when": "$dist[0] < 200", "then": { 即将到站... } },
    { "when": "$door[0]", "then": { 到站开门... } },
    { "when": "$door_closing", "then": { 关门中... } }
  ]
}

这一操作从多个操作中按照一定条件选出一个来显示。

在 when 中设置条件。可使用以上介绍的 “可变内容” 写法。

• 当使用如 $sta[0].eng == Spawn 的写法时，将进行文字比较，这个条件将在下站英文名为 “Spawn” (区分大小写) 时成立。
• 当使用如 $dist[0] < 200 的写法时，将进行数值比较，这个条件将在到下一站的距离小于 200 米时成立（可使用 <、<=、>=、> 四种比较）。
• 当使用如 $sta[0] 的写法（不写任何运算）时，这个条件只要这个可变内容不是 “为空” 即成立。
• "when": "" 会被特殊处理。
  当多个 when 的条件成立时，将显示最下面的一个。这使得各个条件可以以一种类似时间顺序的方式来写，如到站开门时 $dist[0] < 200 也符合，但 $door[0] 写在下面更优先；不过，这本质上也只是一个下方优先，而不是真的时间顺序，所以还请综合考虑各个条件成立的情况。

如果没有（除了 "when": "" 之外的）条件成立，那么将显示 "when": "" 所匹配的操作，不论它排在第几个；如果没有一项 "when": "" ，那这时就不显示。

TODO