SimulatedHighDPIViewer

MacroModule

author	Felix Ritter
package	FMEwork/ReleaseMeVis
definition	SimulatedHighDPIViewer.def
see also	SoExaminerViewer
keywords	viewer, high-dpi, high-resolution

Purpose

The SimulatedHighDPIViewer helps in testing resolution-independent visualization modules. It renders a larger offscreen view into the viewer by displaying a shrunken image of the rendered scenegraph. The size of the image can be specified using the Pixel Scale multiplier field. For instance, a value of 2 will simulate the display of a Retina Display MacBook Pro on any regular display while a value of 1 will simulate a regular display on a Retina Display MacBook Pro.

Windows

Viewer

Settings

Input Fields

child

name: child, type: SoNode, deprecated name: inImage

Input of the child graph that should be viewed in high DPI.

Output Fields

self (hidden)

name: self, type: SoNode

(Hidden) output of the emulated high DPI rendering.

Parameter Fields

Field Index

Emulate Events: Bool

Internal Image Height: Integer

Internal Image Width: Integer

Mode: Enum

Pixel Scale: Integer

Visible Fields

Pixel Scale

name: pixelScale, type: Integer, default: 1, minimum: 1, maximum: 9

The value of this field is used as multiplier to the viewport size of the viewer.

Internal Image Width

name: imageWidthOut, type: Integer, persistent: no

Output of the internal high DPI resolution (width).

Internal Image Height

name: imageHeightOut, type: Integer, persistent: no

Output of the internal high DPI resolution (height).

Mode

name: mode, type: Enum, default: FramebufferSampler

Defines if and how the high resolution is simulated.

Values:

Title	Name	Description
​Framebuffer Sampler	​FramebufferSampler	​This uses the SoFramebufferSampler2D which allows for a real time rendering without any delay. It might not work on certain modules however (SoViewportRegion with delayed rendering, for example).
​Offscreen Renderer	​OffscreenRenderer	​This uses the OffscreenRenderer which allows to render most modules. However, interactions and resizing might be slightly delayed. Also, interaction does not work well if a SoViewportRegion with absolute pixel values is used in the scene graph. Should only be used if the content of the scene graph cannot be correctly displayed in FramebufferSampler mode!
​Bypass	​Bypass	​Renders the input directly without emulating high DPI.

Emulate Events

name: emulateEvents, type: Bool, default: TRUE

Enables emulation of events in high DPI resolution. If mode is set to Bypass, events are simply forwarded.