Viz Plug-ins User Guide

Version 5.0 | Published December 20, 2022 ©

Expert

images/download/attachments/85895623/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

Expert Properties

  • Draw Mode: Selects how to have the container drawn:

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

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

    • Outline (Classic Render Pipeline only): Shows the outline of the object.

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

  • Back Face: Renders the back face of a geometry. This can be useful when rendering transparent objects.

  • Two-sided Lighting (Classic Render Pipeline only): 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 (Classic Render Pipeline only): 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 (Classic Render Pipeline only): Exact Picking is usually a bit slower, as it uses pixel values instead of using the bounding box dimension.

  • Separate Specular (Classic Render Pipeline only): Enables specular highlights for textured geometry.

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

Enable Render Mode: This is for the Viz Engine Render Pipeline only. An export plug-in automatically adds transparency to the object. To disable this transparency in the Viz Engine Render Pipeline, disable Enable Render Mode.

  • 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).

  • Shade Model (Classic Render Pipeline only)

    • 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 (Classic Render Pipeline only)

    • 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 (Classic Render Pipeline only): 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.