Skip to content

Latest commit

 

History

History
102 lines (80 loc) · 5.42 KB

INTERACTIONS.md

File metadata and controls

102 lines (80 loc) · 5.42 KB
Raw

Interactions

Mouse Interactions

Simple interaction with the displayed data is possible directly within the window. It is as follows:

  • Click and drag with the left mouse button to rotate around the focal point of the camera.
  • Hold Shift then Click and drag horizontally with the right mouse button to rotate the HDRI.
  • Click and drag vertically with the right mouse button to zoom in/out.
  • Move the mouse wheel to zoom in/out.
  • Hold Ctrl, then Click and drag vertically with the right mouse button to zoom in/out to mouse position.
  • Hold Ctrl, then Move the mouse wheel to zoom in/out to mouse position.
  • Click and drag with the middle mouse button to translate the camera.
  • Click with the middle mouse button to center the camera on the point under the cursor (hold Shift to allow forward or backward movement).
  • Drag and drop a file, directory or HDRI into the F3D window to load it. F3D relies on the extension (.hdr or .exr) to detect if the dropped file is an HDRI.

Note: When playing an animation with a scene camera, camera interactions are locked.

Hotkeys

The coloring can be controlled directly by pressing the following hotkeys:

  • C: cycle between coloring with array from point data and from cell data.
  • S: cycle the array to color with.
  • Y: cycle the component of the array to color with.

See the coloring cycle section for more info.

Other options can be toggled directly by pressing the following hotkeys:

  • W: cycle animations.
  • B: display of the scalar bar, only when coloring and not using direct scalars.
  • V: volume rendering, forces coloring.
  • I: opacity function inversion during volume rendering.
  • O: point sprites rendering.
  • P: translucency support.
  • Q: ambient occlusion.
  • A: anti-aliasing.
  • T: tone mapping.
  • E: the display of cell edges.
  • X: the trihedral axes display.
  • G: the horizontal grid display.
  • N: the display of the file name.
  • M: the display of the metadata if exists.
  • Z: the display of the FPS counter.
  • R: raytracing.
  • D: the denoiser when raytracing.
  • U: background blur, useful with an HDRI skybox.
  • K: trackball interaction mode.
  • F: HDRI ambient lighting.
  • J: the display of the HDRI skybox.
  • L: increase lights intensity.
  • Shift+L: decrease lights intensity.

Note that some hotkeys can be available or not depending on the file being loaded and the F3D configuration.

Camera Hotkeys:

  • 1: front view camera.
  • 3: right view camera.
  • 4: roll the camera left by 90 degrees.
  • 5: toggle orthographic projection.
  • 6: roll the camera right by 90 degrees.
  • 7: top view camera.
  • 9: isometric view camera.
  • Enter: reset the camera to its initial parameters.

Other hotkeys are available:

  • H: key to toggle the display of a cheat sheet showing all these hotkeys and their statuses.
  • ?: key to print scene description to the terminal.
  • Esc: close the window and quit F3D.
  • Space: play the animation if any.
  • ←: load the previous file if any and reset the camera.
  • →: load the next file if any and reset the camera.
  • ↑: reload the currently loaded files.
  • ↓: add all current files parent directories to the list of files, reload the currently loaded files and reset the camera.
  • F12: take a screenshot, ie. render the current view to an image file.
  • F11: take a "minimal" screenshot, ie. render the current view with no grid and no overlays to an image file with a transparent background.

When loading another file or reloading, options that have been changed interactively are kept as is.

Cycling Coloring

The following hotkeys let you cycle the coloring of the data:

  • C: cycle between point data and cell data - field data is not supported.
  • S: cycle the array available on the currently selected data in alphabetical order, skipping array not containing numeric data. It will loop back to not coloring unless using volume rendering.
  • Y: cycle the component available on the currently selected array, looping to -2 for direct scalars rendering.

When changing the array, the component in use will be kept if valid with the new array, if not it will be cycled until a valid component is found. When changing the type of data to color with, the index of the array within the data will be kept if valid with the new data. If not, it will cycle until a valid array is found. After that, the component will be checked as specified above.

Taking Screenshots

The destination filename used to save the screenshots (created by pressing F12 or F11) is configurable (using the screenshot-filename option) and can use template variables as described on the options page.

Unless the configured filename template is an absolute path, images will be saved into the user's home directory (using the following environment variables, if defined and pointing to an existing directory, in that order: XDG_PICTURES_DIR, HOME, or USERPROFILE).