Navisworks: Markup¶

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

Nodes¶

Markup.AddCloud¶

EXPERIMENTAL: draws a revision-cloud redline through the given markup-space points (undocumented Navisworks API). Accepts [x,y] pairs or a flat x1,y1,x2,y2,… list. Wire a list of viewpoints and every one gets the cloud (the points input stays one outline).

Inputs

Input	Type	Default	What it does
`viewpoint` required	`any`	—	The saved viewpoint (or its name). Wire a list of viewpoints (or names) and the node runs once for each.
`points` required	`any[]`	—	Cloud outline: a list of [x, y] pairs, or a flat list x1, y1, x2, y2, … (3+ points).
`color`	`any`	`null`	Line colour: a Color, hex "#RRGGBB" or [r,g,b] (empty keeps the Navisworks default).
`thickness`	`integer`	`2`	Line thickness in pixels.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`viewpoint`	`SavedViewpoint`	The stored viewpoint (pass-through for chaining).

Tags: markup redline cloud revision revcloud viewpoint

Markup.AddNumberTag¶

EXPERIMENTAL: draws a circled number on a saved viewpoint and optionally attaches a comment — a tag substitute (real Find-Tags tags have no public API). Markup-space coordinates; calibrate with Markup.List. Wire a list of viewpoints and every one gets the tag.

Inputs

Input	Type	Default	What it does
`viewpoint` required	`any`	—	The saved viewpoint (or its name). Wire a list of viewpoints (or names) and the node runs once for each.
`number` required	`integer`	—	The tag number to draw.
`x` required	`number`	—	Markup-space X of the tag centre.
`y` required	`number`	—	Markup-space Y of the tag centre.
`radius`	`number`	`0.08`	Circle radius in markup-space units.
`comment`	`string`	`""`	Optional comment attached to the viewpoint (shows in the Comments panel).
`color`	`any`	`null`	Line colour: a Color, hex "#RRGGBB" or [r,g,b] (empty keeps the Navisworks default).
`thickness`	`integer`	`2`	Line thickness in pixels.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`viewpoint`	`SavedViewpoint`	The stored viewpoint (pass-through for chaining).

Tags: markup redline tag number bubble comment viewpoint

Markup.AddShape¶

EXPERIMENTAL: draws a line, arrow or ellipse redline on a saved viewpoint (undocumented Navisworks API). Markup-space coordinates; calibrate with Markup.List. Wire a list of viewpoints and every one gets the shape.

Inputs

Input	Type	Default	What it does
`viewpoint` required	`any`	—	The saved viewpoint (or its name). Wire a list of viewpoints (or names) and the node runs once for each.
`shape` required	`string`	—	line, arrow (points from start to end) or ellipse (fitted to the corner-to-corner box).
`x1` required	`number`	—	Markup-space X of the start point (tail, or first box corner).
`y1` required	`number`	—	Markup-space Y of the start point.
`x2` required	`number`	—	Markup-space X of the end point (head, or opposite box corner).
`y2` required	`number`	—	Markup-space Y of the end point.
`color`	`any`	`null`	Line colour: a Color, hex "#RRGGBB" or [r,g,b] (empty keeps the Navisworks default).
`thickness`	`integer`	`2`	Line thickness in pixels.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`viewpoint`	`SavedViewpoint`	The stored viewpoint (pass-through for chaining).

Tags: markup redline line arrow ellipse circle shape draw viewpoint

Markup.AddText¶

EXPERIMENTAL: draws a text redline on a saved viewpoint (undocumented Navisworks API). Coordinates are markup space — (0,0) is the view centre; calibrate with Markup.List. Wire a list of viewpoints and every one gets the text.

Inputs

Input	Type	Default	What it does
`viewpoint` required	`any`	—	The saved viewpoint (or its name). Wire a list of viewpoints (or names) and the node runs once for each.
`text` required	`string`	—	The text to draw.
`x` required	`number`	—	Markup-space X of the text anchor (0 = view centre).
`y` required	`number`	—	Markup-space Y of the text anchor (0 = view centre).
`color`	`any`	`null`	Line colour: a Color, hex "#RRGGBB" or [r,g,b] (empty keeps the Navisworks default).
`thickness`	`integer`	`2`	Line thickness in pixels.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`viewpoint`	`SavedViewpoint`	The stored viewpoint (pass-through for chaining).

Tags: markup redline text annotate label viewpoint tag

Markup.Clear¶

EXPERIMENTAL: removes every redline markup from a saved viewpoint (undocumented Navisworks API). Wire a list of viewpoints and every one is cleared.

Inputs

Input	Type	Default	What it does
`viewpoint` required	`any`	—	The saved viewpoint (or its name). Wire a list of viewpoints (or names) and the node runs once for each.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type	What it gives
`viewpoint`	`SavedViewpoint`	The stored viewpoint (pass-through for chaining).

Tags: markup redline clear delete remove viewpoint

Markup.List¶

EXPERIMENTAL: lists the redline markups on a saved viewpoint — types, texts and anchor positions. Draw one markup by hand and read it here to learn the coordinate scale for the Add nodes. Wire a list of viewpoints and you get one result per viewpoint.

Inputs

Input	Type	Default	What it does
`viewpoint` required	`any`	—	The saved viewpoint (or its name). Wire a list of viewpoints (or names) and the node runs once for each.
`document`	`Document`	`null`	The document (defaults to the active document).

Outputs

Output	Type
`count`	`integer`
`types`	`string[]`
`texts`	`string[]`
`positions`	`any`

Returns: Markup count, per-markup type names, texts (empty for shapes) and anchor positions as [x, y] — the calibration reference for the Add nodes.

Tags: markup redline list read count calibrate viewpoint