Documentation Center

Viz Plug-ins User Guide

Version 5.1 | Published December 12, 2023 ©

Expert

images/download/attachments/140819238/ico_expert.png
The Expert plug-in sets some special properties and adds some advanced functions to a Container.

Note: This plug-in is located in: Plugins -> Container plug-ins -> Global

The plug-in shows different user interface based on the chosen Render Pipeline:

Viz Engine Renderer

images/download/thumbnails/140819238/image-2023-10-31_9-31-8.png

Draw Options

  • Draw Mode: Selects how the container is drawn.

    • Normal: Shows the rendered object with material and/or textures.

    • Wireframe: Shows the polygons that are drawn to create the object.

    • Outline: Shows the outline of the object (needs to be supported by Geometry plug-in).

  • Line Width: Sets the width of the wires if Wireframe or Outline draw mode is selected.

  • Disable Backface Culling: Renders the back face of a geometry. This can be useful when rendering transparent objects.

  • Two-sided Lighting: Enables two-sided lighting for a single container instead for a whole scene.

  • Multi-sampled Alpha Mask: Converts the Alpha Channel to a multi-sampled coverage mask.

Depth Options

  • Write to Depth: Enables writing into the depth buffer for this geometry.

  • Disable Depth Test:

Blending Options

  • Enable Render Mode: Automatically adds transparency to the object. To disable this transparency in the Viz Engine Render Pipeline, disable Enable Render Mode.

  • Render Modes

    • Add: Symbolically: C*A + FC. The source color gets added to the target color. The amount of color that is added depends, as we see from the formula, on the alpha value. However, it is always an addition, so the end result is always a lighter color than the initial frame content. If the frame color has high values on all three color channels (RGB), you might experience that the addition of the new color takes all channels to values above 255 (saturation). The values are clamped at 255, which is white.

    • Blend: Symbolically: C*A+(1-A)*FC. The new color value gets created as a weighted average of the source and the target. The weight factor is the alpha value of the rendered color. That means that if the incoming color has a very low alpha value, its influence on the new color is small, and conversely, if the new color has a high alpha value, its influence on the new color is larger.

    • Subtract: Symbolically: FC-C*A. The new color is the result of the incoming color being subtracted from the color in the frame buffer and the result is written back into the frame buffer. The alpha value of the incoming color decides how much who gets subtracted. If the incoming color has high values on all three color channels (RGB), you might experience that the subtraction of the new color takes all channel values to 0, and the result is a black color.

    • Rev-Subtract: Symbolically: C*A-FC. This is a reversed version of subtractive. The color in the frame buffer gets subtracted from the incoming color and the result is written back into the frame buffer.

    • Multiply: Symbolically: CA*FC. The new color and alpha get multiplied with the existing values in the frame buffer. The formula presupposes that the colors and alpha re described as values between 0 and 1. A color rendered with multiply always results in a darker color than both the color being rendered and the color in the frame buffer.

    • Rev-Multiply: This is a reversed version of multiply.

    • Max: Higher color values overwrite lower color values (for example, white draws over black - independently from the Z-Sort).

    • Blend (Premultiplied Alpha): Like Blend, but assuming the color already has the alpha multiplied.

    • All Render Modes having (Advanced) in their name are supported by Viz Engine Renderer and are mimicking the respective Photoshop blend modes.

Mirroring

Enables you to mirror the object over the X-, Y- and Z-axis.

Classic Renderer

  • Draw Mode: Selects how the container is drawn.

    • Normal: Shows the rendered object with material and/or textures.

    • Wireframe: Shows the polygons that are drawn to create the object.

    • Outline: Shows the outline of the object (needs to be supported by Geometry plug-in).

  • Line Width: Sets the width of the wires if Wireframe or Outline draw mode is selected.

  • Disable Backface Culling: Renders the back face of a geometry. This can be useful when rendering transparent objects.

  • Two-sided Lighting: Enables two-sided lighting for a single container instead for a whole scene.

  • Z-Buffer Draw: Defines if the depth buffer is used for rendering or not.

  • Z-Buffer Ignore: Ignores the OpenGL Z-buffer draw option when set to Off, and draws the object no matter if it is in the back or not.

  • Line Anti-aliasing: Renders an anti-aliased outline for 2D objects on machines that do not have anti-aliasing with multi-sampling. This extra outline can be removed by disabling this option.

  • Exact Picking: Exact Picking is usually a bit slower, as it uses pixel values instead of using the bounding box dimension.

  • Separate Specular: Enables specular highlights for textured geometry.

  • Render Mode:

    • Add: Symbolically: C*A + FC. The source color gets added to the target color. The amount of color that is added depends, as we see from the formula, on the alpha value. However, it is always an addition, so the end result is always a lighter color than the initial frame content. If the frame color has high values on all three color channels (RGB), you might experience that the addition of the new color takes all channels to values above 255 (saturation). The values are clamped at 255, which is white.

    • Blend: Symbolically: C*A+(1-A)*FC. The new color value gets created as a weighted average of the source and the target. The weight factor is the alpha value of the rendered color. That means that if the incoming color has a very low alpha value, its influence on the new color is small, and conversely, if the new color has a high alpha value, its influence on the new color is larger.

    • Subtract: Symbolically: FC-C*A. The new color is the result of the incoming color being subtracted from the color in the frame buffer and the result is written back into the frame buffer. The alpha value of the incoming color decides how much who gets subtracted. If the incoming color has high values on all three color channels (RGB), you might experience that the subtraction of the new color takes all channel values to 0, and the result is a black color.

    • Rev-Subtract: Symbolically: C*A-FC. This is a reversed version of subtractive. The color in the frame buffer gets subtracted from the incoming color and the result is written back into the frame buffer.

    • Multiply: Symbolically: CA*FC. The new color and alpha get multiplied with the existing values in the frame buffer. The formula presupposes that the colors and alpha re described as values between 0 and 1. A color rendered with multiply always results in a darker color than both the color being rendered and the color in the frame buffer.

    • Rev-Multiply: This is a reversed version of multiply.

    • Max: Higher color values overwrite lower color values (for example, white draws over black - independently from the Z-Sort).

  • Mirror: Enables you to mirror the object over the X-, Y- and Z-axis.

  • Shade Model

    • Flat: Shows the single polygons the object is made of. Lighting is only applied per face and not per vertex.

    • Smooth: Calculates a smooth surface.

  • Transparency Mode

    • Blend: Is the standard option.

    • Mask: Uses a raster.

    • Fastest: Uses the transparency mode which takes the least time to render.

    • High Quality: Uses the transparency mode which delivers the best looking result.

  • Draw Layer: Defines if the objects are drawn in all layers or only if it shows in a certain layer:

    • Any: The object is always drawn.

    • Main: The object is drawn only if it is in a scene, located in the Main Layer.

    • Back: The object is drawn only if it sits in the Back Layer.

    • Front: The object is drawn only if it is in the Front Layer.

      Note: The Draw Layer option can be used, for example, for a menu in a Scene which should be only visible if it is loaded in the front layer.