Bookmarks Panel

../../_images/bookmarks_panel.png

Overview

  • The Bookmarks Panel is used to create and manage Viewport Bookmarks for quick navigation to preset View locations.
  • The Bookmarks Panel is open and docked by default on the left side of the default startup layout of SEQUOIA.
  • A Bookmark captures the transformation (position and orientation) of the Viewport Camera, as well as some other Camera-related properties.
  • Clicking a Bookmark will set the current Viewport’s Camera to the same position and orientation.
  • SEQUOIA manages the Bookmarks as part of the Document, and will save and load the Bookmarks when the Document is saved and loaded.
  • See Using Bookmark for workflow-centric details.

User Interface

Bookmark Thumbnails

  • The Bookmark Thumbnails represent a miniature version of the view at the time the Bookmark was created, or last updated.
  • Bookmark Thumbnails are not stored with the Document, but are regenerated on Document loading, when the [Refresh] button is pressed, or when the Bookmark is updated to a new view using the SET command.
  • Clicking the Thumbnail when Edit Mode is off, or Double-Clicking when Edit Mode is on will set the Active Viewport to the Bookmark.

New Bookmark Icon

  • Pressing the New Bookmark button with the Camera icon will create a new Bookmark using the Active Viewport.

Edit Mode Checkbox

  • When unchecked (default), a single Left-Click with the mouse will both select the Bookmark Thumbnail and set the Active Viewport to the Bookmarked view.
  • When checked, a single Left-Click will only select the Bookmark Thumbnail, but will not set the Active Viewport - a Double-Click will be required.
  • When Edit Mode is on, it is easy to select one or more Bookmarks to Set, Delete, Copy&Paste, Save Selected etc. without affecting the Active Viewport in the process.
  • When Edit Mode is off, you can still perform these operations, but each click on a Bookmark Thumbnail will affect the Active Viewport.

Refresh Button

  • This button is always active.
  • Pressing this button will update the Thumbnail images of all Bookmarks based on the current Viewport settings.

Rename... Button

  • This button is only active when a single Bookmark Thumbnail is selected.

Remove Button

  • This button is only active when one or more Bookmark Thumbnails are selected.
  • Pressing this button will delete the Bookmarks.
  • Alternatively, you can press the DELETE key on the keyboard.
  • Note that this operation cannot be undone!

Bookmarks Right-Click Context Menu

../../_images/bookmarks_context_menu.png
  • The Right-Click Context Menu of the Panel (both over existing Bookmarks and empty Backgroun) provides the following features:
  • GO To Bookmark
    • Sets the Active Viewport to the Bookmark under the mouse.
    • This option will be grayed out if no Bookmark is found under the mouse.
  • SET Bookmark To Current View
    • Sets the Bookmark under the mouse to the Active Viewport’s Camera information.
    • The Bookmark’s previous Camera information will be lost, its data and its thumbnail will be updated.
    • This option will be grayed out if no Bookmark is found under the mouse.

  • ADD New Bookmark
    • Creates a new Bookmark from the Active Viewport.
  • REMOVE Bookmark
    • Removes the selected Bookmarks.
    • This option will be grayed out if no Bookmarks are selected.

  • EDIT Mode Toggle
    • Toggles the Edito Mode on and off.
    • When in Edit mode, single click only selects the Bookmark’s thumbnail but does not set the Viewport unless you doble-click.

  • LOAD Bookmarks File...
    • Opens a file dialog to load thumbnails from a file.
    • Supported formats include previously saved .SQBM preset file, .SQ Documents, or a binary Point Data file containing valid Scanner metadata.
  • SAVE Bookmarks...
    • Opens a file saving dialog to output all Bookmarks to an .SQBM preset file.
  • SAVE Selected Bookmarks...
    • Opens a file save dialog to output only the selected Bookmarks to an SQBM preset file.

Bookmarks Presets Menu

../../_images/bookmarks_options_menu.png
  • The []> Options Menu of the Bookmarks Panel offers the following Actions and Viewport Presets:
  • Active Document
    • When checked, the Bookmarks Panel will display the Bookmarks of the Active Document selected by the Active Viewport.
    • It will become unchecked when one of the Documents below it is checked instead.

  • <DocumentName>...
    • Locks the Bookmarks Panel to the specific Document to display its Bookmarks even if the Active Document is different.

  • LOAD Bookmark File...

    • Opens a file dialog to load thumbnails from a file.
    • Supported formats include previously saved .SQBM preset file, .SQ Documents, or a binary Point Data file containing valid Scanner metadata.
  • SAVE Bookmarks...

    • Opens a file saving dialog to output all Bookmarks to an .SQBM preset file.
  • SAVE Selected Bookmarks...

    • Opens a file save dialog to output only the selected Bookmarks to an .SQBM preset file.

  • Go To HOME View
    • Sets the Active Viewport to the default startup view.
    • This also moves the Camera Point Of Interest to the center of the Home Grid.
    • The Camera Position will depend on the size of the Home Grid, so changing the Home Grid Spacing And/Or Segments will have an effect on the Home view.
    • Alternatively, press the H key.
  • Go To TOP View
    • Sets the Active Viewport to the Top Orthographic view.
    • Alternatively, press the T key.
  • Go To BOTTOM View
    • Sets the Active Viewport to the Bottom Orthographic view.
    • Alternatively, press the B key.
  • Go To LEFT View
    • Sets the Active Viewport to the Left Orthographic view.
    • Alternatively, press the L key.
  • Go To RIGHT View
    • Sets the Active Viewport to the Right Orthographic view.
    • Alternatively, press the R key.
  • Go To FRONT View
    • Sets the Active Viewport to the Front Orthographic view.
    • Alternatively, press the F key.
  • Go To BACK View
    • Sets the Active Viewport to the Back Orthographic view.
    • Alternatively, press the K key.

Bookmark Gizmos In The Viewport

  • While the Bookmarks are not Document objects like Point Loader, Mesher, or Camera, their position and orientation can be represented in a similar way in the Viewport.
  • By default, the Display Bookmarks option is unchecked in the Object Display toolbar and Display menu.
  • When checked, the Bookmarks will be drawn in the Viewport and will represent the view’s frustum (cone) and the X and Y axes as red and green dashes on the sides.
  • The Bookmark gizmos can be selected, moved, rotated, and deleted.
  • No scaling is allowed, and renaming is only supported via the right-click menu in the Bookmarks panel, as there are no Object Properties associated with the gizmos.