Bookmarks Panel¶
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¶
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¶
The
![[]>](../../_images/options_icon_gray2.png)
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.
