FLUIDNINJA LIVE MANUAL  流体忍者实时手册

Contents 内容

1. Step-by-step Guides & Tutorial Videos
   分步指南和教程视频
2. Introduction 介绍

3. Location, Size, Versions 位置，大小，版本
4. Usage 使用方法
5. Core Functions 核心功能

7. Memory Demand, Performance
   内存需求，性能
8. Merging NinjaLive to your Project
   将 NinjaLive 合并到您的项目中
9. Settings 设置

14. Packaging, Compiling, Android
    包装，编译，安卓
15. Optimization 优化
16. Niagara 尼亚加拉
17. Sequencer & Movie Render Queue
    序列器与电影渲染队列
18. Volumetrics 体积测量法

25. Detail Maps 详细地图
26. Controlling Ninja in real time
    实时控制忍者
27. Mapping sim on 3D mesh surfaces
    在 3D 网格表面上进行映射模拟
28. Moving in WorldSpace 在世界空间中移动
29. Live v1.7 (DirectDrive, WorldSpace)
    Live v1.7（DirectDrive，WorldSpace）
30. Live v1.8 (Landscapes, Rivers)
    直播 v1.8（风景，河流）
31. Live v1.8.5.5 (FloorSnapper / floor-alignment)
    实时 v1.8.5.5（FloorSnapper / 楼层对齐）
32. Live v1.9.51 (Painter v2, Multilayer Materials, Tagging)
    实时 v1.9.51（画家 v2，多层材料，标记）
33. Live v1.9.53 (Heterogeneous Volumes, LWC)
    实时 v1.9.53（异构卷，LWC）
34. Live v1.9.54 (UE 5.4 specific fixes)
    实时 v1.9.54（UE 5.4 特定修复）

1. Step by Step guides in this Manual
   本手册中的逐步指南

Tutorials on YouTube YouTube 上的教程

2. Introduction 2. 引言

2.1 Inputs 2.1 输入

2.2 Level & game design
2.2 关卡与游戏设计

2.3 Rendering 2.3 渲染

2.4 NINJALIVE vs NINJATOOLS
2.4 NINJALIVE 与 NINJATOOLS

3. Location & Size 3. 位置与大小

4. Versions 4. 版本

5. Usage 5. 使用

Optionally you could utilize additional tools like Preset Manager with custom GUI,
可选地，您可以使用像带有自定义 GUI 的预设管理器等附加工具，

6. Core Functions 6. 核心功能

6.1 NinjaLiveComponent 6.1 忍者直播组件

6.2 NinjaLive 6.2 忍者直播

6.3 Actor Details VS ActorComponent Details
6.3 演员详情与演员组件详情

6.4 Preset Manager and Presets
6.4 预设管理器和预设

6.5 Simple Painter Mode 6.5 简单画家模式

7. Memory Demand 7. 内存需求

8. Performance (excerption)
8. 性能（摘录）

TYPICAL PERFORMANCE LIVE 1.2 vs 1.3
典型性能 直播 1.2 对比 1.3

GTX 1070 Ninja peak performance
GTX 1070 忍者峰值性能

9. Merging NinjaLive to your project
9. 将 NinjaLive 合并到您的项目中

STEP 1: add custom Trace Channe
步骤 1：添加自定义追踪通道

STEP 2: enable "UV from Hit" engine feature
步骤 2：启用“来自命中的 UV”引擎功能

• Copy this INI file to /YourProject/Config/... folder: LINK — or: - Set up Enhanced Input, as described in this guide: LINK
  将此 INI 文件复制到 /YourProject/Config/... 文件夹：链接 — 或：- 按照本指南中的说明设置增强输入：链接

10. Settings 10. 设置

10.1 Ninjalive Actor Parameters (briefly)
10.1 Ninjalive 演员参数（简要）

10.1.2 SCALING / SIZE 10.1.2 缩放 / 尺寸

10.1.3 NON-UNIFORM SCALING
10.1.3 非均匀缩放

10.1.5 LOCALISING INTERACTIONS: OVERLAP PROJECTION
10.1.5 本地化交互：重叠投影

10.1.6 FILTERING INTERACTIONS
10.1.6 过滤交互

10.1.7 WORLD SPACE VELOCITY
10.1.7 世界空间速度

10.2 Ninjalive Actor Component Parameters (briefly)
10.2 Ninjalive 演员组件参数（简要）

10.2.1 DISABLE/ENABLE 10.2.1 禁用/启用

10.2.2 PRESET USAGE 10.2.2 预设使用

10.2.3 OUTPUT MATERIAL USAGE
10.2.3 输出材料使用

10.2.4 RAYMARCHING 10.2.4 光线行进

• LiveRayMarching / Enable Raymarching switch
  LiveRayMarching / 启用光线行进开关

• LiveGeneric / OutputMaterialSelected: set the array index for the above materia
  设置上述材料的数组索引

10.2.6 USE CUSTOM LINE TRACE SOURCE (instead of camera)
10.2.6 使用自定义线条追踪源（而不是相机）

10.3 Adding NinjaLive Component To Your Own Actor Classes
10.3 将 NinjaLive 组件添加到您自己的演员类中

1. open owner (the planned sim component host blueprint)
   打开所有者（计划的模拟组件主机蓝图）
2. add component: NinjaLiveComponent
   添加组件：NinjaLiveComponent
3. add component: TraceMesh (StaticMeshComponent)
   添加组件：TraceMesh（静态网格组件）
4. set the value of "TraceMeshComponent" variable of NinjaLiveComponent (value = TraceMesh)
   设置 NinjaLiveComponent 的“TraceMeshComponent”变量的值（值 = TraceMesh）
5. set TraceMesh properties (note: scale is related to resolution!)
   设置 TraceMesh 属性（注意：缩放 与 分辨率相关！）
6. add NinjaLiveInterface to the owner blueprint (at Class Settings /Interface)
   将 NinjaLiveInterface 添加到所有者蓝图中（在类设置/接口处）
7. set NinjaLiveComponent default properties: while remaining in the blueprint editor select NinjaLiveComponent in the "Components" list of owner to access NinjaLiveComponent Details panel. Find "Live Interaction" parameter group
   设置 NinjaLiveComponent 默认属性：在蓝图编辑器中，选择所有者的“组件”列表中的 NinjaLiveComponent，以访问 NinjaLiveComponent 详细信息面板。找到“实时交互”参数组。
8. set the "Continuous Interaction with Owner Actor" switch to "ON"
   将“与所有者角色的持续互动”开关设置为“开启”
9. set continuous Interaction Inclusive Object Type / Bone names
   设置连续交互包容对象类型 / 骨骼名称
10. set the default value of all other params here (in the blueprint) - eg. default preset, material
    在这里（在蓝图中）设置所有其他参数的默认值 - 例如，默认预设、材料
11. enable TraceMesh CameraFacing (optional)
    启用 TraceMesh CameraFacing（可选）
12. save blueprint, and drag it on level from the Content Browse
    保存蓝图，并从内容浏览器中将其拖到关卡上

STEP 3, ADD TRACEMESH COMPONENT TO OWNE
步骤 3，将 Tracemesh 组件添加到 OWNE

• At the level placed instance - by selecting the component (this effects only that instance - In the owner blueprint, selecting TraceMesh and set default transform (effects all instances) - Via an exposed variable (NinjaLive Actor does it this way, so you could customize instances) Important: scale is related to simulation resolution - see: 10.1.3 NON-UNIFORM SCALING
  在放置实例的级别 - 通过选择组件（这只影响该实例） - 在所有者蓝图中，选择 TraceMesh 并设置默认变换（影响所有实例） - 通过一个暴露的变量（NinjaLive Actor 以这种方式实现，因此您可以自定义实例）重要：缩放与模拟 分辨率相关 - 见：10.1.3 非均匀缩放

STEP 6, ADD INTERFACE 步骤 6，添加接口

10.4 Other Ways To Include/embed/add Ninjalive To Actors
10.4 将 Ninjalive 包含/嵌入/添加到演员的其他方法

A. CHILD ACTOR COMPONEN A. 儿童演员组成

B. SPAWNING B. 产卵

10.5 Interaction: setting up Objects to trigger NinjaLive response
10.5 交互：设置对象以触发 NinjaLive 响应

B. SKELETAL MESHES B. 骨架网格

11. Utilities Pawn Possession, Quality, FPS, Viewport Widget
11. 公用事业典当占有、质量、FPS、视口小部件

1. LIGHT WIDGET 轻量小部件

2. EDITOR FPS 编辑器 FPS

3. POSSESSING PAWN 拥有典当

4. The util (once placed on level) influences other SYSTEMIC things, like DOF, motion blur, antialias, camera and mouse-cursor smoothing.
   该工具（放置在水平上）会影响其他系统性事物，如景深、运动模糊、抗锯齿、相机和鼠标光标平滑。
   NinjaLive_Utilities(self)
   忍者直播_工具(self)

14. Packaging, Compiling in general
14. 包装，编译一般情况

14.1 Remove Preset Manager From Levels Before Compile
14.1 在编译之前从级别中移除预设管理器

• METHOD1: define sim density and velocity input textures on a per container basis at NinjaLiveComponent /LiveCompatibility /Overwrite*Input (NOT a global setting)
  方法 1：在 NinjaLiveComponent / LiveCompatibility / Overwrite*Input 中按容器定义相似密度和速度输入纹理（不是全局设置）
• METHOD2: go to Project settings /Packaging /Additional Non-Asset Directories to Package and link the folder where the velocity and density maps are, this forces the system to package the maps. (GLOBAL setting)
  方法 2：前往项目设置 / 打包 / 额外非资产目录，打包并链接包含速度和密度图的文件夹，这会强制系统打包这些图。 （全局设置）

14.3 NinjaLive 1.1 - 1.2 blueprints are branched to APEX and non-APEX versions
14.3 NinjaLive 1.1 - 1.2 蓝图分支到 APEX 和非 APEX 版本

14.4 Mobile Rendering, Limitation
14.4 移动渲染，限制

15. Packaging to Android 15. 打包到安卓

15.1 Prerequisites 15.1 先决条件

15.2 setting up the Unreal Editor for Android packaging
15.2 为 Android 打包设置 Unreal 编辑器

15.3 setting up Ninja for Android packagins
15.3 为 Android 打包设置 Ninja

15.4 Packaging 15.4 包装

17. Optimization 17. 优化

17.1 Use Activation Volume
17.1 使用激活体积

17.2 Use LOD 17.2 使用 LOD

17.3 Use Memory Pool Manage
17.3 使用内存池管理

17.4 Reduce the number of Trace Targets
17.4 减少追踪目标的数量

17.5 Disable Dynamic Asset Lookup (DAL)
17.5 禁用动态资产查找 (DAL)

(A) OPTIMIZATION (A) 优化

(B) COMPATIBILITY (B) 兼容性

17.6 Carefully plan Rendertarget resolution
17.6 仔细规划渲染目标分辨率

17.6 Carefully choose the Pressure Solver (2 types) and solver settings
17.6 仔细选择压力求解器（2 种类型）和求解器设置

18. Changelog / Updates 18. 更新日志 / 更新

19. Known Issues & FAQ
19. 已知问题与常见问答

20. Niagara 20. 尼亚加拉

20.3 LINKING NIAGARA AND NINJA
20.3 连接尼亚加拉和忍者

1. Tag the actor that embeds the targeted Niagara Component
   标记嵌入目标尼亚加拉组件的演员

2. Provide Ninja with the tag, at:
   提供忍者标签，位于：

1. Create one or more RenderTargets in advance
   提前创建一个或多个渲染目标

2. Set ninja to write the RenderTarget(s)
   设置忍者以编写渲染目标

3. Once the RenderTargets are created and ninja is set up to write them: Tell Niagara to read the RTs
   一旦创建了渲染目标并设置忍者以写入它们：告诉尼亚加拉读取渲染目标

21. Complete List of NinjaLive UI parameters
21. NinjaLive UI 参数完整列表

22. Live fluidsim pipeline: technical description
22. 实时流体仿真管道：技术描述

23. Using Sequencer to control NinjaLive Actors
23. 使用序列器控制 NinjaLive 演员

23.1 Effectors 23.1 效应器

23.2 Parameters 23.2 参数

A step-by-step guide 逐步指南

1. Edit/Plugins/MovieRenderQueue: ENABLE PLUGIN
   编辑/插件/电影渲染队列：启用插件
2. Open the level that you would like to render ( NinjaLive_Level08_Demo_Roots is ideal for testing: single container, no proximity activation
   打开您想要渲染的关卡（NinjaLive_Level08_Demo_Roots 非常适合测试：单个容器，无接近激活）
3. Select "BP_NinjaLive_Utilities" on level and on the Details Panel: switch OFF the "Possess Nearest Pawn" flag
   在关卡中选择“BP_NinjaLive_Utilities”，在详细信息面板上：关闭“占有最近的棋子”标志
4. Content Browser: right click /CreateAdvancedAsset /Animation /LevelSequence
   内容浏览器：右键点击 / 创建高级资产 / 动画 / 关卡序列
5. Place Actor Panel: drag a camera on level ---> set the camera to the needed position
   放置演员面板：在关卡上拖动相机 ---> 将相机设置到所需位置
6. Content Browser: double-click on the level sequence
   内容浏览器：双击级别序列
7. In Sequencer: right click, "Actor to Sequencer" --> add the recently placed Camera from the Leve
   在 Sequencer 中：右键点击，“Actor 到 Sequencer” --> 添加最近放置的相机从关卡
8. Viewport, Top-Left corner UI /Perspective roll down menu: select Camera Actor
   视口，左上角 UI / 透视下拉菜单：选择相机演员
9. Window /Cinematics / MovieRenderQueue (MRQ)
   窗口 / 电影 / 电影渲染队列 (MRQ)
10. In MRQ, click on the green "Render" roll down menu add the previously created Level Sequence
    在 MRQ 中，点击绿色的“渲染”下拉菜单 ，添加之前创建的关卡序列
11. Adjust Output Folder and Config - if needed
    调整输出文件夹和配置 - 如有需要

12. Check 23.4: QUALITY NOTES
12. 检查 23.4：质量备注

13. Press green "Render (Local)" in the Bottom-Right corner
    在右下角按绿色的“渲染（本地）”按钮
14. After a few seconds of initialization, renders the image sequence to the provided folder
    经过几秒钟的初始化， 将图像序列渲染到提供的文件夹中

23.4 IMPORTANT NOTES ON QUALITY
23.4 关于质量的重要说明

Related chapter in the Manual
手册中的相关章节

Related tutorial videos: 相关教程视频：

24. Volumetrics  24. 体积测量

• wrapper materials for the new volume function
  新体积功能的包装材料
• minimal setups, showcasing volume function properties
  最小设置，展示音量功能属性

25. Detail Maps 25. 详细地图

26. Controlling Live in real time
26. 实时控制

Similar control could be achieved by Game Logic (Blueprints, Code) or Sequencer.
类似的控制可以通过游戏逻辑（蓝图、代码）或序列器实现。

• Practical example1: using NinjaLive Actor for an area FX. We would like to control the FX params using sequencer - to create a choreographed Cinematics Sequence See this video: LINK
  实际示例 1：使用 NinjaLive Actor 进行区域特效。我们希望通过序列器控制特效参数，以创建编排的电影序列。请查看此视频：链接
• Practical example2: character ability FX is delivered by an embedded NinjaLiveComponent - we switch the fluidsim preset and the output material as the character uses various ability-FX
  实际示例 2：角色能力 FX 由嵌入的 NinjaLiveComponent 提供 - 当角色使用各种能力 FX 时，我们切换流体模拟预设和输出材料

1. Could be modified instantly
   可以立即修改
2. Could be modified by re-initializing NinjaLiveComponent blueprint
   可以通过重新初始化 NinjaLiveComponent 蓝图进行修改
3. Simple Variables (eg. floats, integers) could be modified instantly by accessing NinjaLiveComponent. Variables have "telling names" - and you could read about them using the Tooltips and the Manual. Pls open up NinjaLiveComponent Blueprint: Preset Variables (for example) could be found under the "NONPUBLICLive Preset Variables" group. --- by code you can access them anytime. In the Blueprint that embeds NinjaLiveComponent (eg. a character) params could be directly accessed. For other (external) blueprints, the LIVE INTERFACE could be used. To modify a variable by Sequencer, you need to set "expose to cinematics" to TRUE. See Level 5, demonstrating how to use the Interface and Sequencer.
   简单变量（例如浮点数、整数）可以通过访问 NinjaLiveComponent 即时修改。变量具有“说明性名称”——您可以通过工具提示和手册了解它们。请打开 NinjaLiveComponent 蓝图：预设变量（例如）可以在“非公开实时预设变量”组下找到。——通过代码，您可以随时访问它们。在嵌入 NinjaLiveComponent 的蓝图中（例如，一个角色），参数可以直接访问。对于其他（外部）蓝图，可以使用实时接口。要通过 Sequencer 修改变量，您需要将“暴露给电影”设置为 TRUE。请参见第 5 级，演示如何使用接口和 Sequencer。
4. Asset-type-variables (like a DataTable with preset-values, or an OutputMaterial Instance) could be modified by re-initializing NinjaLive. (Trivial example: the Preset Manager re-initilizes ninja when changing materials or loading a new preset.)
   资产类型变量（如带有预设值的数据表或输出材料实例）可以通过重新初始化 NinjaLive 进行修改。（简单示例：当更改材料或加载新预设时，预设管理器会重新初始化 Ninja。）

27. Mapping sim on 3D Mesh surfaces
27. 在 3D 网格表面上映射模拟

1. raymarching based translucent volumetrics (entitled as "VolumeSmoke"
   基于光线行进的半透明体积渲染（标题为“体积烟雾”）
2. polygonal mesh based opaque 3D surfaces
   多边形网格基础的不透明 3D 表面

1. Select Container 选择容器
2. Select TraceMesh Actor Component
   选择 TraceMesh Actor 组件
3. Replace "NinjaLiveTraceMesh" (a single quad plane) with a tessellated plane (eg. SM_plane_300x300)
   将“NinjaLiveTraceMesh”（一个单一的四边形平面）替换为一个细分平面（例如：SM_plane_300x300）
4. Enable "Cast Shadow" at the mesh component Details Panel
   在网格组件详细面板中启用“投射阴影”
5. Select NinjaLiveComponent
   选择 NinjaLiveComponent
6. Go to LiveGeneric param group, Locate the currently used OutputMaterial in the array (checking the OutputMaterialSelected INDEX below the array helps)
   前往 LiveGeneric 参数组，定位数组中当前使用的 OutputMaterial（检查数组下方的 OutputMaterialSelected 索引有助于此）
7. Locate "Parallax" param group, disable ParallaxMapping (not needed when using a 3D sim mesh)
   找到“视差”参数组，禁用视差映射（在使用 3D 模拟网格时不需要）
8. Locate "MeshDistort" param group, enable MeshDistortion, tweak params (pay attention to CLAMP!)
   定位“MeshDistort”参数组，启用 MeshDistortion，调整参数（注意 CLAMP！）

28. Moving in WorldSpace 28. 在世界空间中移动

28.2 Additional settings to tweak:
28.2 额外的设置调整：

29. New features: Live 1.7
29. 新功能：实时 1.7

1. Direct drive 1. 直接驱动

2. Improved world-space motion
改进的世界空间运动

3. Covering large areas 覆盖大面积

A NEW, GENERIC WORLD-SPACE BASE-MATERIAL IS INTRODUCED
引入了一种新的通用世界空间基础材料

4. Driving multiple systems with a single fluidsim
4. 用单一流体仿真驱动多个系统

5. Improved Simple Painter Mode
5. 改进的简单画家模式

6. Modularity 6. 模块化

7. Niagara two-way data flow
7. 尼亚加拉双向数据流

8. Tag based actor and component tracking
8. 基于标签的演员和组件跟踪

30. New features: Live 1.8
30. 新功能：实时 1.8

1. SplineMesh based rivers
基于样条网格的河流

2. Landscape Components 2. 景观组成部分

Underwater & Caustics: see next page
水下与光晕：见下一页

3. Underwater & Caustics 水下与光晕

4. Caustics: Notes for UE5
4. 烧蚀：UE5 的笔记

- M_UnderWaterPostProcess_PreTonemap
(pre-tonemapper)
- M_UnderWaterPostProces
(post-tonemapper

• Post Process Materials 后处理材料
  จ Arrai
  2 Array elements  2 数组元素
  1.0
  1.0
  M_UnderWaterPostProcess_Caustics_LargeWater1_PreToneMap
  M_水下后处理_光晕_大水 1_预色调映射
  MI_UnderWaterPostProcess_Caustics_LargeWater2_PostToneMap
  MI_水下后处理_光晕_大水 2_后调色映射

The Pre-Tonemap Mat. contains the Caustics (here, the WorldPos node works as expected) The Post-Tonemap Mat. contains all other functionalities (gradients, coloring, distortion)

FIX is released as a new ninja subversion: Live v 1.8.5.1 (on 28 Oct. 2022)

UPDATE (27 November 2022)

New Nvidia drivers (v. 517 and above) seem to FIX the AbsoluteWorldPosition issue

\section*{31. New features: Live 1.8.5.5}

Tutorial video covering THIS chapter: LINK + Generic all-in-one Tutorial: LINK

New levels: /UseCases/Levels/Usecase_018A_Snow_LIVE18 /UseCases/Levels/Usecase_018B_Sand_LIVE18

/UseCases/Levels/Usecase_015C SimplePainterDemo LIVE18

/UseCases/Levels/Usecase_004A_DoubleSim_TilingWaves_LIVE18

/UseCases/Levels/Usecase_004B_DoubleSim_Vortex_LIVE18

Updated levels: Usecase 1, 2, 7, 10, 11, 12, 14-ABC, 17

New features:

(1) One-sim-driven environment

(2) Surface alignment

(3) Optimize for UE5 \& reworking obsolete content

\section*{1. One-sim-driven environment}

Ninja uses Output Materials to DIRECTLY drive other systems ( see 29.1 + LINK). Originally, ninja had TWO Output Material slots (primary, secondary) + an output for Niagara Systems. Since a landscape material setup consumes two slots (see: LINK), volumes were handled with the INDIRECT method (manual setup, writing an extra on-disk rendertarget with ninja, and reading that with the volume)

By adding a \(3^{\text {rd }}\) output material slot: we can direct-drive landscape, particles and volumes with a single simulation - driving complex environments (see LINK). See: sand \& snow demo levels (UC18-A,B)

\section*{2. Surface alignment}

The new FloorSnapper utility dynamically modifies the transform of user provided objects - aligning object rotation with floor normal direction and matching object position with the floor surface. A typical use case: aligning pawn-attached, moving volume containers with a non-flat / sloped landscape, while the player moves. See this video: LINK.

Older levels have been reworked (eg. UC 14-A,B,C) - to utilize FloorSnapper, instead of the monstrous spaghetty of nodes in the Level Blueprint:

UPDATE: CHECK CHAPTER 24 / LANDSCAPE ALIGNED VOLUMES

\section*{3. Optimize for UE5 \& reworking obsolete content}

Unreal 5 adjusts level main-light intensity and color according to sun position. All ninja materials have been equipped with AtmosphericLight type nodes, making them sensitive to the color/luma changes. In sync with the material update, all levels have been reworked in terms of lighting and atmosphere to meet the new UE standard. Niagara systems are also updated, eliminating deprecated modules.

Usecase 4 \& 6 levels (double-sim, vortex) have been resurrected. See video LINK. Originally, ninja contained multiple, experimental base materials to cover different scenarios. Through the dev process, these experimental materials became obsolete. By re-implementing functions in the SINGLE unified world space base material, we are (again) capable to merge multiple simulation outputs - like a local interaction handler and a vortex: video LINK.

\section*{32. New features:}

Live 1.9.51

Tutorial video covering THIS chapter: LINK + Generic all-in-one Tutorial: LINK

New levels: /Tutorial/Levels/NinjaLive_Level33_Tagging_LIVE19 /Tutorial/Levels/NinjaLive_Leve134A_Painter_v2_Primitives_LIVE19

/Tutorial/Levels/NinjaLive_Level34B_Painter_v2_Bones_LIVE19

Updated levels: Tutorial 2 A + UseCase 14, 16, 17

New features

1) Fast object tracking: Painter v2

2) Multilayer materials

(3) Tagging (to filter tracked objects)

\section*{1. Fast object tracking: Painter v2}

Ninja is registering tracked objects using a Collision Painter - drawing a dot (or line) for each object. In Live 1.9, the painter has been updated to a more performant "v2", capable of handling hundreds of primitives \& bones as simulation input, also compatible with Metahuman skeletons.

Painter v2 also replaces "SingleTargetMode": connecting the registered dots with lines for ALL tracked objects - creating smooth, continuous motion trajectories.

The features are located at NinjaLive Component Details Panel

\(\rightarrow \quad\) NinjaLive Component /LiveInteraction /UsePAINTER_V2_ToTrackObjects

/PV2_Connect_TrackpointsWithLines

\section*{2. Multilayer materials}

Ninja is using a main "base" Output Material (M_NinjaOutput_WorldSpaceGeneric) for all Materiallnstances \(\rightarrow\) when driving large world-space surfaces - like lakes, sand dunes and snowy landscapes.

In Live 1.9, the main Output Material is available as MaterialFunction, to build true multilayer materials for landscapes. We have also included an example-material that blends the function with another basic material.

The assets could be found using Content Browser:

\(\rightarrow\) /OutputMaterials/BaseMaterials/MF_NinjaOutput_WorldSpaceGeneric /OutputMaterials/BaseMaterials/M_NinjaOutput_WorldSpaceGeneric_Multilayer

3. Tagging (to filter tracked objects)

"Tagging" is a generic method to access objects in Unreal. We assign strings to Actors or Components using the "Tag" input field at the Details Panel. Blueprints could access these objects using the tags

Ninja uses tagging in these cases:
- Live Actor uses tags to FILTER TRACKED OBJECTS (see next page + LINK
- Live Component uses tags to ASSIGN MATERIALS to objects (DirectDrive) - LINK
- Landscape and FloorSnapper Utility Actors identify targets via tags - LINK1, LINK2

NinjaLive could use object and bone position as simulation input.

In this subchapter we are discussing (A) object type filters (class filters) and (B) tags as methods to define tracked objects (LINK)

(Note: Tagging has been added to Live 1.7 - and it has been improved since then)

NinjaLive COMPONENT - when added to NON-ninja actors (eg. a Pawn) - is LIMITED to track components of the OWNER. No tagging, only class filters ( \(\rightarrow\) see Chapter 6.1)

NinjaLive ACTOR could track arbitrary objects - using the InteractionVolume to detect objects in the simulation area. We could tell NinjaLive Actor what kind of objects to track - using TWO methods:

\section*{A. CLASS FILTERS / OBJECT TYPE FILTERS}

We are telling ninja to track certain Object Types: StaticMesh, PhysicsBody... etc

On the "ninja side" the object type filter could be adjusted under:

\(\rightarrow\) NinjaLive Actor Details /LiveInteraction /OverlapFilterInclusiveObjectType

On the "target side" (the objects to be tracked) this could be adjusted under:

\(\rightarrow\) /Component Details /Collision /CollisionPresets /ObjectType
B. TAGGING

We are telling ninja to track tagged Primitive or SkeletalMesh Components

On the "ninja side" the tag filters could be adjusted under:

\(\rightarrow\) NinjaLive Actor/LiveInteraction/TrackActorPrimitiveComponentsWithTag /TrackActorSkeletalMeshComponentsWithTag

On the "target side" (the objects to be tracked) tags could be added at:

\(\rightarrow\) Component Details Panel /"Tag" input field

\section*{IMPORTANT}

Class Filters and Tags are ADDITIVE. When used together, the results from BOTH filtering are added to the same list. For example: we are tracking ALL StaticMesh type objects using a class filter and ONE specific Pawn, via "SkeletalMesh" tagging.

\section*{33. New features:}

Live 1.9.53

(1) Volumetrics v2

(2) Floor alignment v2

(3) LWC support (Large World Coordinates)

\section*{1. Volumetrics v2 (see updated Chapter 24}

Unreal Engine 5.3 came with a new volume type: Heterogeneous Volume Accordingly, ninja has been updated with a new generic volume function, Handling ALL native UE volume types: fog, clouds - and heterogeneous volumes.

The update comes with...
- wrapper materials for the new volume function
- minimal setups, showcasing volume function properties
- fluidsim driven and passive setups (passive = non-interactive)

Setups are demonstrating usage in the 1 meter to 100 kilometers size range, combining various volume types and exploring multilayer volumes.

Complete Volumetrics V2 Documentation: LINK

New Content \& Levels:

Showreel Videos:
/Content/FluidNinjaLive/Volumetrics_v2 LINK1, LINK2

\section*{2. Surface alignment v2}

The update also employs a new technique to align volumes with surfaces.

We are sampling landscape height using RVT volumes and forwarding the height data to the volume material. The technique could potentially replace "floor snapper",

a previously introduced surface-aligning technique (See Chapter 31.2).

Related tutorial, Landscape aligned volumes: LINK

\section*{3. LWC support (1.9.53.3}

LWC (Large World Coordinates) is an Unreal Engine method that allows users to extend scenes beyond the original (UE4) 10 kilometers radius. Using LWC, ninja could drive surfaces, particle systems and volumes thousands of kilometers from the world origin

UE uses double precision (64 bit) data types (floats, vectors) in large worlds. Starting with version 1.9.53.3, ninja also supports LWC, by introducing the

"TraceMeshPosDouble" variable through all systems: blueprints, materials and niagara.

Updated systems are by default LWC compatible. The new feature could be turned off, see "LWC Support" param (TRUE/FALSE) in NinjaLiveComponent Blueprint and in al Output Material Instances.

33. Unreal 5.4 specific fixes: Live 1.9.54

Unreal Engine 5.4 came with breaking changes. In order to counter these, a new NinjaLive version is being released: 1.9.54.4 - dedicatedly for UE 5.4

Change log, text file: LINK