Draw Modes

Overview

The HOOPS Web Viewer component supports several different ways to draw the scene called “Draw Modes”. Only one of them can be active at a given time. To activate a specific draw mode call the setDrawMode() function on the view object:

    hwv.view.setDrawMode(Communicator.DrawMode.Shaded);

The following draw modes are currently supported:

  • Gooch

  • HiddenLine

  • Shaded

  • Toon

  • Wireframe

  • WireframeOnShaded

  • XRay

Visit the DrawMode entry in our API Reference Manual for more details.

Selecting one of those draw modes renders the scene with either faces and lines turned on, faces only or lines only. It is an easy way to turn off visibility of faces and lines for the whole model. Alternatively you can also use the functions view.setLineVisibility() and view.setFaceVisibility() to control this behavior. The code below turns on Wireframe mode meaning that only the lines in the model are displayed:

    hwv.view.setDrawMode(Communicator.DrawMode.Wireframe);
../../../_images/draw_modes_wireframe_on_shaded.png

Wireframe draw mode on

Hidden line

Hidden line removal (HLR) involves displaying only visible, unobscured lines. Faces of visible geometry will be used to obscure lines the lines in the model or draw them in a dimmed style but the faces themselves will not be drawn. Typically, HLR is used to provide a result suitable for hardcopy or screenshots since having shaded facets can clutter the scene. However, sometimes end-users are also interested in seeing a model rendered with hidden line mode on the screen.

    hwv.view.setDrawMode(Communicator.DrawMode.HiddenLine);
../../../_images/draw_modes_hidden_line.png

Hidden line mode on

There are various settings for hidden line mode that you can specify by retrieving and modifying the HiddenLineSettings object. For example, in order to make the obscured lines in the hidden line render invisible you would write the following code:

    var hiddenLineSettings = hwv.view.getHiddenLineSettings();
    hiddenLineSettings.setObscuredLineOpacity(0);
    hwv.view.setDrawMode(Communicator.DrawMode.HiddenLine);
../../../_images/draw_modes_hidden_line_obscured_invisible.png

Hidden line mode on w/ obscured lines

Hard edge detection

A hard edge detection algorithm is enabled by default. This new algorithm will cause hidden line mode to look different than previous versions. A new set of functions have been added to the View class to control this new behavior.

  • setHardEdgesEnabled(), getHardEdgesEnabled()

  • setHardEdgeColor(), getHardEdgeColor()

  • setHardEdgeOpacity(), getHardEdgeOpacity()

  • setHardEdgeThreshold(), getHardEdgeThreshold()

  • setHardEdgeThresholdRampWidth(), getHardEdgeThresholdRampWidth()

../../../_images/prototype-hard-edges-on.png

Default - hard edges on:

../../../_images/prototype-hard-edges-off.png

Hard edges off

X-ray

The purpose of X-ray mode is to make it easy to identify selected elements in a complex scene by turning the whole model except for the selected elements transparent. In the below example the selected part is inside the model and would normally just be displayed as an outline. With X-ray mode however the selected part is fully displayed without completely hiding the rest of the model.

../../../_images/draw_modes_x_ray.png

X-ray mode on

Below are the API functions to control various aspects of X-ray mode:

  • view.setXRayColor()

  • view.setXRayOpacity()

  • view.setXRayTransparencyMode()

As an example, let’s change the opacity of the unselected lines to fully opaque:

    hwv.view.setXRayOpacity(1, Communicator.ElementType.Lines);
../../../_images/draw_modes_x_ray_opacity.png

X-ray mode on with opaque unselected lines