Array Visualizer Configuration options
Each output type is individually configurable. Some configuration options are provided for all plot types at the upper left configuration area. While being available always, their settings are individually maintained and stored for each output type:
- 2D / 3D Display - toogles the interactive mode. 2D mode allows a selection rectangle to be drawn by the user and used for zoom-in operations. This works best for axis aligned line plots. In 3D mode the left mouse button is used to rotate the plot cube. Other mouse interactions are always available: panning by right mouse, zoom by mouse wheel and reset of the plot cube view by double clicking the scene.
- Auto Fit - if activated - causes a rescaling of the current limits of the plot cube when changes to the source data occur. This corresponds to the same action triggered by a double click on the plot which resets the scene view.
- The maximize button enlarges the Array Visualizer client area and optimizes space for small tool windows.
- Log [X|Y|Z] - logarithmic scales for the corresponding axis of the current plot.
In addition to that, each output type provides its individual set of configuration options: colormapping plots as surface and imagesc plots allow the definition of the colormap. Colorbar and legends can be activated or hidden, wireframe lines can be enabled or disabled. For line and scatter plots the line and point color is configurable as well as the size. Furthermore, line plots allow the selection of markers. Antialiasing is another available option for line plots.
The following options are accessed from the top menu of the Array Visualizer tool window.
The "Use Array Descriptors" menu is used to toogle the usage mode and enables / hides the array descriptor.
By default, in order to trigger the evaluation of an entered expression, one needs to hit the Enter key. When enabled, a new evaluation is triggered immediately whenever the expression is changed.
The Array Visualizer is configurable from the ILNumerics section of the Visual Studio Options dialog (Tools -> Options).
Configuration options include:
- Default Renderer - specify which rendering driver is used for plotting: OpenGL (default) is the recommended setting. OpenGL is available on modern machines and offers hardware accelerated rendering. Whenever you experience slow rendering during interaction on large data, make sure to use OpenGL rendering here. The ILNumerics internal software renderer is based on GDI and is provided as a fallback option. It potentially causes lower framerates.
- Max. Number of Lines - the maximum number of lines displayed for the Multiple Lines Plot output type. Default: 50
- Renderer Timeout - maximum time span a GDI driver is allowed to spend on rendering a single frame. After this time span is over, the rendering is cancelled and a label "Timeout" will indicate the partial result. This prevents the debug engine in Visual Studio from timing out and affects GDI renderers only. For OpenGL renderers this setting is ignored.
- Upper Limit of Data Dimensions - if the expression provided by the user leads to a data block too large for rendering the data dimensions are sampled down automatically. This setting specifies the maximum number of elements in each dimension up from which down-sampling kicks in.