Using 3D shape nodes

Use 3D shape nodes to draw vector shapes in 3D space.

These 3D shape nodes are available in Kanzi Shapes:

Filling a 3D shape node

Use a material to fill the shape in a 3D shape node.

To fill a 3D shape:

  1. In the Library > Materials and Textures, create the material that you want to use to fill a 3D shape node.

    For example, create a material that uses the VertexPhong material type.

    Tip

    If your project does not contain the VertexPhong material type, in the Library > Materials and Textures, press Alt and right-click Material Types and select VertexPhong.

    ../_images/fill-material.png
  2. Create or select a 3D shape node that you want to fill.

    For example, in the Node Tree, create a Path 3D node. In the Properties, set the Path Commands property to

    M (120, 20) L (62, 200) (216, 90) (24, 90) (178, 200) Z
    

    When you create a closed 3D shape, that shape by default has a black fill and no stroke.

    ../_images/path-3d-in-node-tree.png
  3. In the Properties, add the Fill Material property and set it to the material that you created.

    ../_images/path-3d-fill-material-set.png
  4. (Optional) To set the appearance of the outline of the 3D shape, add and set the Stroke Material and Stroke Thickness properties. See Using stroke.

    Kanzi renders the outline on top of the fill and blends the two materials.

    ../_images/stroke-material.png

Setting the stroke of a 3D shape

To set the style of the stroke of a 3D shape:

  1. In the Library > Materials and Textures, create the material that you want to use to define the appearance of a line or outline of a shape.

    For example, create a material that uses the VertexPhong material type.

    Tip

    If your project does not contain the VertexPhong material type, in the Library > Materials and Textures, press Alt and right-click Material Types, and select VertexPhong.

    ../_images/stroke-material1.png
  2. Create or select a 3D shape node whose stroke you want to set.

    For example, in the Node Tree, create an Ellipse 3D node.

    When you create a closed 3D shape, that shape by default has a black fill and no stroke.

    ../_images/ellipse-3d-in-node-tree.png ../_images/ellipse-3d-in-preview.png
  3. In the Properties, add and set:

    • Stroke Material to the material that you created

    • Stroke Thickness to the width that you want for the outline of the shape

    • (Optional) Fill Material to the material that you want to use to fill the shape

      To draw the shape using only the stroke and no fill, set Fill Material to < Unassigned >.

    ../_images/properties-ellipse-3d-with-stroke.png ../_images/preview-ellipse-3d-with-stroke.png

Rendering depth in 3D shape nodes

When you position two shapes so that they are coplanar and overlap, the depth buffer cannot figure out which shape is in front of the other shape. This phenomenon, called z-fighting, leads to a visual artifact where the shapes seem to be switching order, creating glitchy patterns.

To handle z-fighting, Kanzi Shapes by default renders 3D shape nodes in two passes:

  1. Renders the depth buffer without using depth offset.

  2. Renders the color buffer using the depth offset for testing.

For example, Kanzi Shapes renders the depth in these intersecting shapes correctly:

  • A Rectangle 3D node that has blue fill and contains an Ellipse 3D node that has yellow fill.

  • A Rectangle 3D node that has green fill, is rotated 90 degrees along the y axis, and contains an Ellipse 3D node that has red fill.

All four nodes have gray stroke.

../_images/rectangle-3ds-in-node-tree.png ../_images/depth-rendering-correct.png

Two-pass rendering means that Kanzi renders each shape twice, which causes performance overhead. When you do not need two-pass rendering, you can optimize performance by manually setting the depth rendering mode.

To set the depth rendering mode, select a 3D shape node and in the Properties, add and set the Shape 3D > Depth Rendering Mode property:

../_images/depth-rendering-depth-offset.png
  • Normal renders the shape without depth offset.

    When you use this mode, you must make sure that there is no z-fighting between the shapes and their fill and stroke, such as in this image.

    For example, use this mode to render a large number of shapes that use only one color or do not overlap.

../_images/depth-rendering-normal.png
  • Depth Write Disabled disables depth write.

    You can use this mode to render shapes that do not intersect other shapes. The shapes can intersect other Kanzi 3D content, but the shapes cannot occlude that content.

    For example, use this mode to render shapes that do not need to occlude anything, or when handling the occlusion does not need the depth buffer.

../_images/depth-rendering-depth-write-disabled.png
../_images/depth-rendering-mode-property.png

Setting the depth offset for the fill and stroke in 3D shape nodes

To improve rendering performance, instead of using the default two-pass rendering, you can manually set the depth offset for the fill and stroke of each 3D shape node.

This example shows how to set the depth offset in these intersecting Rectangle 3D nodes:

../_images/rectangle-3ds-in-node-tree.png ../_images/depth-rendering-correct.png

To set the depth offset for the fill and stroke in 3D shape nodes:

  1. In the Node Tree, select the two intersecting Rectangle 3D nodes. In the Properties, add and set these Shape 3D properties:

    • Depth Rendering Mode to Depth Offset

      With this mode, you set Kanzi Shapes to use the Fill Depth Offset and Stroke Depth Offset properties to apply a depth offset to the fill and stroke of a 3D shape node and its descendants.

    • Fill Depth Offset property Constant Multiplier property field to 0

      The Constant Multiplier sets a multiplier for the smallest measurable unit of depth, dependent on the target platform.

    • Stroke Depth Offset property Constant Multiplier property field to -3

      This way you set Kanzi Shapes to render in each rectangle the stroke over the fill.

      When you use the Kanzi default render passes to render you content, a negative offset corresponds to a depth value closer to the camera.

    ../_images/rectangle-3ds-selected.png ../_images/rectangle-3ds-depth-offset.png ../_images/ellipse-3ds-no-depth-offset.png
  2. In the Node Tree, select the Ellipse 3D nodes that are children of the Rectangle 3D nodes. In the Properties, add and set:

    • Fill Depth Offset property Constant Multiplier property field to -6

    • Stroke Depth Offset property Constant Multiplier property field to -9

    This way you set Kanzi Shapes to render the ellipses over the rectangles, and the stroke of the ellipses over the fill.

    ../_images/ellipse-3ds-selected.png ../_images/ellipse-3ds-depth-offset.png ../_images/depth-rendering-correct.png

See also

Using the Composite Shape nodes

Using the Ellipse nodes

Using the Line nodes

Using the Path nodes

Using the Rectangle nodes

Filling a shape

Using stroke

Gradients