plan viewer

plan viewer

plan viewer is a viewer locked to a top-down plan view. Like viewer, it accepts renderable objects from all modules with red output ports, but the camera always looks straight down, so the view can be panned and zoomed but not rotated. The mouse wheel adjusts the Zoom. Because the view is always in plan, there is no Z Scale or perspective setting.

Rendering Mode

Rendering Mode lets plan viewer draw like a map or drawing package. In 3D mode, objects are drawn with standard depth-based rendering, so whatever is highest in elevation is on top. In Model Tree mode, objects are drawn in model tree order, with entries higher in the model tree covering the ones below them, regardless of elevation. This makes it easy to keep, for example, labels, site features, or a plume footprint on top of an aerial image.

Georeferenced Image Export

plan viewer replaces the export georeferenced image module. Its image export writes BMP, TIF, JPG, and PNG files. With Include Georeferencing on, it also writes a world file alongside the image (and embeds the geotransform in TIF files), so the image is placed correctly in GIS and other applications that support georeferencing.

Ports

DirectionNameTypeDescription
InputObjectsRenderableRenderable objects to visualize.
OutputViewViewThe view containing all associated renderable objects.

Properties

PropertyTypeDescription
ZoomDoubleControls the magnification of the plan view. The mouse wheel also adjusts this value.
BookmarksBookmarksBookmarked project states for reuse. Bookmarks may include view states, visibility states, sequence states, or any combination.
Zoom To FitButtonZooms to fit the entire model, and re-centers around the centroid of the scene.
Zoom To Fit ExactlyButtonZooms and re-centers so the model extents exactly fill the view, with no margin.
Show ContentsBooleanShows or hides the Viewer Contents.
Pin ContentsBooleanDetermines whether the contents panel is pinned or overlaid.

Rendering

PropertyTypeDescription
Rendering ModeChoice: 3D, Model TreeControls how overlapping objects are drawn. Model Tree draws the objects in model tree order, with entries higher in the model tree covering the ones below them. 3D uses standard depth-based rendering.
Anti AliasingBooleanSmooths jagged edges using FXAA, a fast post-process applied to the whole image. When linked, follows the application Anti Aliasing default in the user options.
Opacity ProcessingChoice: Fast, High QualityControls how overlapping transparent surfaces are composited. Fast blends them in draw order (cheapest, but transparency seen through multiple layers can look wrong). High Quality uses depth peeling to composite them in the correct order, at the cost of extra render passes. Not used in Model Tree mode, which always composites in draw order. When linked, follows the application Opacity Processing default in the user options.
Max Opacity PassesIntegerThe maximum number of depth-peeling passes used by High Quality opacity processing. Each pass resolves one more layer of overlapping transparency; higher values handle deeper transparent stacks but cost more. Used only with High Quality in 3D mode. When linked, follows the application default in the user options.

Camera Settings

PropertyTypeDescription
Auto Fit SceneChoice: Never, On Any Change, On Significant ChangeControls what kind of change causes the viewer to normalize (refit) the view.

Interaction

PropertyTypeDescription
Picked ObjectString (read-only)The object currently selected in the viewer. Updated by holding Ctrl and clicking on an object in the viewer.
Picked CoordinateCoordinate 3DThe coordinates of the current pick in the viewer (read-only). Updated by holding Ctrl and clicking on an object in the viewer.
Center On PickedButtonIf an object has been picked in the viewer, centers the view around the picked coordinate.
Clear ProbeButtonHides the probe marker at the picked location until the next pick.
Show Probe MarkerBooleanShows a marker at the most recently probed location. Probe using Ctrl+Left Click or double-click.
Show Viewer CenterBooleanShows an indicator of the current view center point.

Background

PropertyTypeDescription
StyleChoice: Solid Color, Two Color Gradient, VignetteControls how the background is colored.
Gradient AngleDoubleChanges the orientation of the gradient computed in the background. Used with the Two Color Gradient style.
Background ColorColorSets the background color. When linked, follows the Background Color in the application colors.
Gradient ColorColorSets the second color of the gradient. When linked, follows the Gradient Color in the application colors.

Window Size

PropertyTypeDescription
Activate WindowButtonBrings this viewer window to the foreground in the EVS user interface.
Window SizingChoice: Size Manually, Fit to WindowThe method for determining how to size the viewer contents.
Viewer WidthIntegerThe width of the rendered portion of the viewer, in pixels. Used with Size Manually.
Viewer HeightIntegerThe height of the rendered portion of the viewer, in pixels. Used with Size Manually.
Viewer Actual WidthIntegerThe actual width of the rendered portion of the viewer, in pixels (read-only).
Viewer Actual HeightIntegerThe actual height of the rendered portion of the viewer, in pixels (read-only).
Video Safe AreaChoice: None, HD/1080p/4K, Web and Phone Safe, NTSC, PAL, SECAMUsed when creating a video animation. Displays the areas that are usable for text and animation for several standard video formats, so the animation displays well on multiple televisions and devices.

Export Image

PropertyTypeDescription
Include GeoreferencingBooleanWrites a world file alongside the exported image (and embeds the geotransform for TIF), allowing the image to be placed correctly in applications that support georeferencing.
View ScaleDoubleThe scale to apply to both the viewer’s height and width when creating the image. Values are truncated to integers when setting the actual width and height.
Transparent BackgroundBooleanCreates an image with a transparent background. Only PNG and TIF images can store transparency; other formats fall back to the background color.
Image FilenameFileThe image file and format to use when creating the image.

Distance Tool

PropertyTypeDescription
Measure DistanceBooleanAllows the user to probe two locations in the viewer and returns detailed information about each point, as well as about the line connecting the two locations.
First Point LocationCoordinate 3DThe first point probed using Ctrl+Left Click. This value may be altered to change the line values, but doing so invalidates the probed data and object.
Second Point LocationCoordinate 3DThe second point probed using Ctrl+Left Click. This value may be altered to change the line values, but doing so invalidates the probed data and object.
Clear PointsButtonClears the probed points.
Distance Line ColorColorThe color of the line between the probed locations.
Point RadiusDoubleThe radius of the spheres displayed at the probe locations.
Line FilenameFileThe EVS Line File to write the distance line to.
File BehaviourChoice: Append To File, Overwrite FileWhen an EVS Line File has been selected, chooses whether to overwrite it with the stored points or append the points to the existing line file.