Markup

The Markup Extension provides the ability to annotate a 3D scene with a 2D whiteboard overlay from any location in a USD Stage.

Note

Users can view Markups together or create Markups within the same Live Session. However only 1 user can edit a specific Markup at a given time.

Using Markup

To access the Markup tool, click the Markup button in one of the access points, depending on which application is being used.

  1. The Markup Filmstrip can be toggled on and off from the Viewport controls at the top of the screen.

  2. The Markup Filmstrip can also be toggled on and off from the navigation bar in Viewport experiences such as Review mode in USD Explorer.

_images/ext_markup_navbar.png

Markup Filmstrip

Markup Manager window

Menu Item

Description

Add Markup button

Adds a new Markup at the current location and view

Export Markup

Opens Export Dialog for Exporting Markup to an external file

Markup playlist controls

Play through Markups at 5 second intervals or advance between Markups

Markup

View and Edit saved Markups

Markup name

Right click to Rename Markup

Notes

Enter notes for selected Markup

Create Markup

  1. Position and orient your stage view to the desired shot.

  2. Left-click either Markup Button to open the Markup Filmstrip.

  3. Left-click the Add Markup Button at the top of the panel.

Note

When a Markup is being edited, the screen is locked and the view cannot be moved. The Markup must be applied or canceled to return to moving in 3d space.

Edit and Delete Markup

When viewing Markups, the Markup sub-tools will be disabled. To edit the Markup, click on the unlock icon either on the Markup tool bar or from the Markup hover state on the Markup Filmstrip.

_images/ext_markup_view_edit_locked.png
  • To edit a Markup, hover over it and press the unlock icon. This allows you to reposition your view and then recapture the Markup. When A Markup is being edited, there will be a yellow outline around the Markup in the Markup Filmstrip.

_images/ext_markup-edit.jpg

Markup Playlist Controls

  1. Use Previous and next arrows to advance between Markups.

  2. Use the play button to flip through your Markups like a slideshow at 5 second intervals.

Markup Name

  • Right click to Rename Markup.

Markup Notes

  • To add a note to a Markup, press the drop-down arrow below it to reveal a text field.

_images/ext_markup-note.jpg

Markup Sub-tools

Ref #

Option

Usage

3

Comment

Place a text box annotation on the stage

4

Draw

Draw lines or squiggles

5

Arrow

Draw single or double-sided arrows

6

Shapes

Draw circles or squares

7

Exit

Exit markup editor NOTE: Click Apply to save your work

Markups can have multiple elements drawn from all listed sub-tools combined. Common commands for Markup sub-tools include the following.

  • Selection - To select a Markup Element, simply hover over a part of it and click. A transform box will appear of that element. Only one element can be selected at a time.

  • Transform - A selected Markup Element can be transformed by grabbing the handle at the top of the bounding box or by grabbing and moving any transform anchor point.

  • Edit - When a MarkUp element is selected, it has a property strip attached to it. These allow the current element to be edited or deleted.

  • Apply / Cancel - All Markups must be applied or canceled to exit Markup edit context.

Comment

The Comment sub-tool provides a basic text annotation and editing sub-tool and provides four text font sizes, and a color picker. Click “Apply” to save.

Markup comment

Draw

The Draw sub-tool allows freehand lines to be drawn on the stage and provides four line thicknesses. When drawing, a box will expand around the drawing across the screen showing the total area of the drawing as it is painted. Click “Apply” to save.

Markup draw

Arrow

The Arrow sub-tool allows single or double ended arrows to be drawn. The left-most arrow will draw the arrow from tip to tail (based on start/end point); the middle arrow selection will draw from tail to tip, and the double arrow may be started at either origin or endpoint. Click “Apply” to save.

Markup arrow

Shapes

The Shapes sub-tool allows you to draw a square or circle of any size, and provides four line sizes. Click “Apply” to save.

Markup shapes

Apply/Cancel

When a given Markup is finished editing, click “Apply” to save to the Markup Manager window, or “Cancel” to abandon the operation without saving.

Markup apply and cancel

Export Markup

Markup can be exported to a variety of common formats so that annotations can be shared externally from Omniverse.

_images/ext_markup_fimstrip_export.png

To Export Markup:

  1. Open the Markup Filmstrip

  2. On the top right, press the Export Markup button

  3. Set output options

  4. Press Export

_images/ext_markup_export.png

To view exported Markups, press View Exported Markups on the Markup Export Dialog. This will open the folder where this file was exported on your PC.

Export Options

Markups can be exported in the following formats

  • PDF - The PDF option has more options for size (Letter or A4) and orientation (Portrait or Landscape).

  • CSV

  • XLSX

Markup Preferences

Markup Viewport control can be repositioned in the Application Preferences, Viewport section.

_images/preferences_viewport.png