如何使用绘制中断功能

最終更新： 2026年1月8日

在这里我们将解说如何通过检查器操作和设置绘制中断功能。
有关绘制中断功能的详细信息，请确认手册“绘制中断功能”。

CubismRenderingInterceptController组件

这是用于使用绘制中断功能的组件。
将其附加到您要在Cubism模型绘制之间进行绘制处理的物体上。
该组件置入Assets/Live2D/Cubism/Rendering/URP/RenderingInterceptor中。

可以附加组件的物体

可以附加组件的物体如下所示：

Cubism模型
包含任意Renderer组件的物体
- 例如：Sprite Renderer、Mesh Renderer

TIPS

对于包含任意Renderer组件的物体，这些Renderer将在运行时Disable，以避免在Unity的渲染通道中发生绘制处理。在运行时启用Renderer组件可能会导致意外绘制结果。

检查器

当您使用Add Component等进行附加时，将显示以下检查器。

各项目说明如下：

Invoke Timing Setting
设置在绘制过程之前还是之后进行处理。

Pre Rendering
绘制处理之前

Post Rendering
绘制处理之后

Mode
设置绘制顺序的方式。

Sorting Order
这是使用下面描述的SortingOrder值来控制绘制顺序的方法。如果使用与下面描述的Group Sorting Order相同值的Grouped Sorting Index所绘制的Cubism模型的Sorting Mode均为BackToFrontZ或FrontToBackZ（按与相机的距离进行比较），则中断可能无法正常执行。
Grouped Sorting Index和Sorting Mode通过CubismRenderController设置。

Z Depth
该方法利用与相机的距离来控制绘制顺序。如果使用与下面描述的Group Sorting Order 相同值的Grouped Sorting Index所绘制的Cubsim模型的Sorting Mode均为BackToFrontOrder或FrontToBackOrder（按绘制顺序进行比较），则中断可能无法正常执行。
Grouped Sorting Index和Sorting Mode通过CubismRenderController设置。

Drawable
该方法指定一个特定的Drawable，并在对指定的Drawable进行绘制处理之前和之后执行绘制处理，而不管SortingOrder值或与相机的距离如何。

Group Sorting Order
决定要在哪个Grouped Sorting Index时进行绘制的值。
如果没有通过指定的Grouped Sorting Index绘制的模型，则除非设置了 InterceptingMode.Drawable，否则将跳过该处理。

Sorting Order
设置绘制顺序的值。
除了InterceptingMode.SortingOrder之外，其他均被忽略。

Target Art Mesh
InterceptingMode.Drawable时参考的Drawable。
指定要执行绘制处理的位置的Drawable。