Rendering Order

    • The nodes under Canvas can be found in UI node ordering below.

    • The nodes that are not under Canvas, the user can choose to enable depth detection and occlusion display of 3D objects through , which will render the occlusion according to the Z-axis coordinates of the object when enabled (see example 2d-rendering-in-3d).

    UI nodes refer to the UI nodes under the Canvas node, the mixing of nodes is strictly sorted according to the node tree. The rendering order of the UI uses a Breadth-First Sorting scheme, and the node tree order is the final rendering data submission order. So the user can change the order of the nodes under their parents by setting the of the nodes and thus change the rendering order.

    Therefore, the overall rendering order in the figure above is A -> a1 -> a2 -> B -> b1 -> C, and the rendering state on the screen is C -> b1 -> B -> a2 -> a1 -> A. i.e. from top to bottom.

    setSiblingIndex is used to change the position of the current node in the children array of the parent node. If set at runtime by script, the changed node tree data will not be serialized. If the parameter passed in is larger than the length of the children array, it will be set to the end of the array, and if it is within the range, it will be inserted into the corresponding position. This operation is related to the state of the node tree in real time, and the user needs to know the current state of the node tree and perform the operation to get the expected result.

    To set the ClearFlag property, please refer to the following situations:

    • If the scene contains 2D background layer, 3D scene layer, 2D UI layer, then:

      • 2D background layer: ClearFlag property is set to Solid_Color.
      • 2D UI layer: If the model is included, the ClearFlag property is set to Depth_Only to avoid a model splash screen. If no model is present, the ClearFlag property can be set to /Depth_Only.

      sort