ParaView/Users Guide/Settings: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
Line 52: Line 52:
<center>'''Figure 5. General Render View Preferences'''</center>
<center>'''Figure 5. General Render View Preferences'''</center>


* '''Use Immediate Mode Rendering''' : Controls whether OpenGL display lists are used or not.  
* '''Use Immediate Mode Rendering''' : Controls whether OpenGL display lists are used or not which are generally faster only when rendering relatively small amounts of geometry.


The '''LOD Parameters''' settings control if, when and to what extent ParaView will down sample the data it draws while you move the mouse so as to maintain interactivity. The algorithm by which ParaView down samples the data is known as quadric clustering.
The '''LOD Parameters''' settings control if, when and to what extent ParaView will down sample the data it draws while you move the mouse so as to maintain interactivity. The algorithm by which ParaView down samples the data is known as quadric clustering.
Line 66: Line 66:
* '''Enable Depth Peeling''' : Controls whether ParaView will try to use the (potentially slow) depth peeling algorithm at all.
* '''Enable Depth Peeling''' : Controls whether ParaView will try to use the (potentially slow) depth peeling algorithm at all.
* '''Number of Peels''' : Controls the number of passes in the rendering algorithm. Higher produces quality images but increases rendering time.
* '''Number of Peels''' : Controls the number of passes in the rendering algorithm. Higher produces quality images but increases rendering time.
The '''Coincident Topology Resolution''' settings control the method that ParaView uses to draw co-planar polygons in a non conflicting way (to avoid z-tearing in graphics terminology). Changes to these parameters do not take effect until ParaView is restarted.
The pull down menu allows you to choose between various algorithms that deal with z-tearing.
** '''Do Nothing''' : does not attempt to resolve overlapping geometry
** '''Use Z-Buffer Shift''' : adjusts OpenGL's Z direction scaling to draw one object slightly in front of the other. The '''Z Shift''' property controls the amount of offset.
** '''Use Polygon Offset''' : adjusts polygon locations (by calling glPolygonOffset()) for the same purpose. For a discussion of the '''Factor''', '''Units''' and '''Offset Faces''' parameters, see http://www.opengl.org/resources/faq/technical/polygonoffset.htm.
* '''Use Offscreen Rendering for Screenshots''' : This checkbox is enabled only when offscreen rendering is available. It tells ParaView to generate images that are being captured as screenshots in offscreen contexts. On some platforms this is necessary to avoid accidentally capturing overlapping pixels (such as a mouse pointer) from the operating system.


== Render View Camera ==
== Render View Camera ==

Revision as of 17:28, 3 February 2011

Application Settings

Application wide settings are saved in between sessions so that every time you start ParaView on the same machine you get the same behaviors. The settings are stored in an XML file that resides at %APPDATA%\ParaView\ParaViewVERSION.ini on Windows and ~/.config/ParaView/ParaViewVERSION.ini on all other platforms. If you need to restore ParaView's default settings you can either move this file or run with the --disable-registry argument.

These settings are managed via the settings dialog. On Macintosh this is reached from the Preferences entry in the ParaView menu. On Unix, Linux and Windows systems it is reached from the Settings entry on the Edit menu. These settings are program wide and are not to be confused with the View settings found under the Edit menu. Those settings are specific to each View window and are discussed in the Displaying Data chapter.

The following figures show the various pages within the settings dialog. Choose from among them by clicking on the page list toward the left. Click on the arrow to expose the three sub pages in the Render View settings category. Some plugins add their own pages to the dialog but we do not discuss them here and instead refer you to any documentation that comes along with the plugin. Do note though that most settings are documented within the application via tooltips.

General

ParaView UsersGuide settings general.png
Figure 1. General Preferences
  • Default View : choose the View window type that ParaView initially shows when it starts up and connects to any server.
  • On File Open : Control the timestep shown by default when ParaView opens a file with multiple time steps.
  • Rescale Data Range Mode : Controls how color lookup tables are adjusted when data ranges change
  • Heart-Beat Interval : Sets the length of time between keepalive messages that the client sends to the remote server which prevents the TCP connection between the two machines from shutting down.
  • Auto Accept : Makes every change take effect immediately rather than requiring you to click the Apply button.
  • Auto Convert Properties : Tells ParaView to do some data conversions automatically so that more filters are immediately applicable to the data you have at hand.
  • Crash Recovery : Tells ParaView to save a record of each action you take so that you can easily recover your work if ParaView crashes mid-session.
  • Use Multi-Core : Tells ParaView to spawn an MPI parallel server on the same machine that is running the GUI so as to better take advantage of multi-core machines on processing bound problems.

Colors

ParaView UsersGuide settings colors.png
Figure 2. Color Preferences

Animation

ParaView UsersGuide settings animation.png
Figure 3. Animation Preferences
  • Cache Geometry : When checked this allows ParaView to save and later reuse rather than regenerate visible geometry during animation play back to speed up replay.
  • Cache Limit : This is the maximum size of the animation playback geometry cache (on each node when in parallel).

Charts

ParaView UsersGuide settings charts.png
Figure 4. Chart Preferences
  • Hidden Series : Allows you to specify a set of regular expressions that are compared against array names so that various bookkeeping arrays are not drawn in 2D charts and thus distract from the meaningful ones.

Render View General

ParaView UsersGuide settings renderview general.png
Figure 5. General Render View Preferences
  • Use Immediate Mode Rendering : Controls whether OpenGL display lists are used or not which are generally faster only when rendering relatively small amounts of geometry.

The LOD Parameters settings control if, when and to what extent ParaView will down sample the data it draws while you move the mouse so as to maintain interactivity. The algorithm by which ParaView down samples the data is known as quadric clustering.

  • LOD Threshold : Rendered data that is smaller than the specified size is not down sampled.
  • LOD Resolution : When data is downsampled, this controls how coarsely.
  • Outline threshold : Data that is larger than this threshold is drawn only as a bounding box while you move the camera.
  • Lock Interactive Render : Controls how long ParaView waits after you have released the mouse and finished moving the camera before it returns to a full resolution render.
  • Allow Rendering Interrupts : makes the drawing process interuptable so that you can move the camera immediately, without having to wait for a potentially slow full resolution render to complete.

The Depth Peeling settings control the algorithm that ParaView uses (given a sufficiently capable GPU) to draw translucent geometry correctly.

  • Enable Depth Peeling : Controls whether ParaView will try to use the (potentially slow) depth peeling algorithm at all.
  • Number of Peels : Controls the number of passes in the rendering algorithm. Higher produces quality images but increases rendering time.

The Coincident Topology Resolution settings control the method that ParaView uses to draw co-planar polygons in a non conflicting way (to avoid z-tearing in graphics terminology). Changes to these parameters do not take effect until ParaView is restarted.

The pull down menu allows you to choose between various algorithms that deal with z-tearing.

    • Do Nothing : does not attempt to resolve overlapping geometry
    • Use Z-Buffer Shift : adjusts OpenGL's Z direction scaling to draw one object slightly in front of the other. The Z Shift property controls the amount of offset.
    • Use Polygon Offset : adjusts polygon locations (by calling glPolygonOffset()) for the same purpose. For a discussion of the Factor, Units and Offset Faces parameters, see http://www.opengl.org/resources/faq/technical/polygonoffset.htm.
  • Use Offscreen Rendering for Screenshots : This checkbox is enabled only when offscreen rendering is available. It tells ParaView to generate images that are being captured as screenshots in offscreen contexts. On some platforms this is necessary to avoid accidentally capturing overlapping pixels (such as a mouse pointer) from the operating system.

Render View Camera

ParaView UsersGuide settings camera.png
Figure 6. Camera Preferences

Render View Server

ParaView UsersGuide settings server.png
Figure 7. Server Preferences