Navisworks: Selection¶

9 nodes. Types ending in [] are lists. An input with a default is optional.

Nodes¶

Captured Selection¶

Snapshots the current Navisworks selection and keeps it, so the graph runs on that fixed set even after you select something else (Selection.Current, in contrast, reads the live selection again on every run). Press Capture to (re)store the live selection, Clear to forget it. Each element is stored with its GUID and checked when the graph runs: if the model changed or is another project, the elements are looked up by GUID and any that cannot be found are reported on the node and left out. The capture belongs to the graph file, so use the node outside node groups (every instance of a group would share one set) and capture again for each project.

Interactive node: it has its own controls on the canvas.

No inputs.

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	The captured model items.

Tags: snapshot freeze fixed pin keep capture remember

Selection.AddToCurrent¶

Adds items to the existing Navisworks selection (union) and returns the result.

Inputs

Input	Type	Default	What it does
`items` any number of wires required	`ModelItem[]`	—	The model items to add.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	A snapshot of the resulting (unioned) selection.

Tags: selection add union append extend

Selection.Clear¶

Clears the interactive Navisworks selection.

Inputs

Input	Type	Default	What it does
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`cleared`	`boolean`	True when the selection was cleared.

Tags: selection clear deselect none

Selection.Current¶

The model items currently selected in Navisworks, read again on every run (press Run after selecting something else and the new selection comes through). The nodes after it run again only when the selection is different from the previous run.

Inputs

Input	Type	Default	What it does
`resolveTo`	`string`	`"Self"`	Optional selection resolution applied to the picked items, like Options > Interface > Selection > Resolution in Navisworks: Self (default, keep items as picked), File, Layer, FirstObject, LastObject, LastUnique or Geometry.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	A snapshot of the currently selected items.

Tags: selection selected current picked resolution

Selection.Invert¶

The items that are NOT in the current selection (Navisworks' own invert, so whole untouched branches come back as one item each); it does not change the selection — wire it into Selection.SetCurrent to select them. Read again on every run, so it follows the selection as it is now.

Inputs

Input	Type	Default	What it does
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	Everything except the current selection, as branch-level items (like Navisworks' own Invert Selection).

Tags: selection invert inverse opposite except everything else not selected complement

Selection.Remove¶

Takes the given items out of the current Navisworks selection and returns what is still selected; items that are not selected themselves (for example children of a selected parent) are ignored.

Inputs

Input	Type	Default	What it does
`items` any number of wires required	`ModelItem[]`	—	The model items to deselect.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	A snapshot of the selection that remains.

Tags: selection remove deselect subtract exclude minus unselect

Selection.Resolve¶

Re-selects items at another selection-tree level — File, Layer, FirstObject, LastObject, LastUnique, Geometry — like Navisworks' selection resolution option (Options > Interface > Selection). Level Geometry flattens items to their unique geometry-bearing descendants (the items QTO, colouring and clash selections want; it was ModelItem.GeometryLeaves). Level LastObject walks up from a geometry leaf to the whole object it belongs to, the item you usually want to name, colour or tag (it was ModelItem.ObjectAncestor). The result has no duplicates and keeps the input order; wire a list of groups and lacing gives one resolved list per group.

Inputs

Input	Type	Default	What it does
`items` any number of wires required	`ModelItem[]`	—	The model items to resolve.
`level`	`string`	`"LastObject"`	The resolution level: File, Layer, FirstObject, LastObject, LastUnique, Geometry or Self (case insensitive; spaces allowed, e.g. "Last Object").

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	The resolved items (duplicates removed, input order preserved).

Tags: selection resolve resolution level file layer first object last object last unique geometry parent ancestor leaves flatten descendants object ancestor element composite whole object geometry leaves

Selection.SelectAll¶

Selects everything in the Navisworks UI and returns the selected items.

Inputs

Input	Type	Default	What it does
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	A snapshot of the resulting selection.

Tags: selection select all everything

Selection.SetCurrent¶

Replaces the interactive Navisworks selection with the given items.

Inputs

Input	Type	Default	What it does
`items` any number of wires required	`ModelItem[]`	—	The model items to select.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`items`	`ModelItem[]`	The items that were selected (pass-through).

Tags: selection select set highlight