new-string ("ns")

See this command in the command table.

To access this command:

Digitize ribbon > Create > String.
Using the command line, enter "new-string" and press ENTER.
Use the quick key combination "ns".
Display the Find Command screen, locate new-string and click Run.

Command Overview

Digitize new string data interactively (digitizes) in any 3D or Task data window. Digitizing can be completed across multiple windows, or even sections of the same split 3D window, which allows digitizing to be performed, potentially, in 3D by snapping.

Note: This command supports command line coordinates.

Typically, a left click or tap of the stylus adds a string point (although if Auto Node is enabled, points are added quickly to simulate sketching).

This command is supported by undo and redo. If undoing or redoing whilst the command is active (you'll see a Done button in the top left of the screen if so), you can undo or redo individual points. Once the command is completed, the entire string or strings are undone or redone as a single unit.

If no strings object exists in memory, a new object is created when this command is run. The object is called "New Strings" but this can be changed.

Digitizing mode continues until either another command is run, or Done is clicked, or you press ESC.

Tip: Whilst digitizing, you can complete the digitizing operation by double-clicking or double-tapping the final string vertex position. You can also complete the digitizing operation by closing the string.

Advanced Digitizing Controls

Enabled by default, this command is supported by advanced digitizing controls. To use standard digitising instead, display Project Settings > Points and Strings and clear Show advanced digitizing controls. When active, you can constrain your digitising behaviour to manage the length, gradient and azimuth of subsequent string segments.

See Advanced String Design.

Note: As a project setting, you must save your project to preserve this digitising mode between project sessions. The screen popup remembers its previous position.

Command Automation

You can automate by passing this command and parameters into oDmApp.ParseCommand(), using any COM-aware scripting language.

Note: For more information on scripting in Studio NPVS+, please refer to your Scripting Tutorial (Help > Scripting Tutorial).

Example Parameter String (JS):

oDmApp.ParseCommand("new-string @point=100.0,200.0,0.0,1 @attribute=GRADE,2.5";

Where:

@point=100.0,200.0,0.0,1 is the ParsePointArguments: An @point group of 4 comma-delimited values: X, Y, Z, and nButton. X, Y, and Z are numeric world coordinate values. nButton is an integer parsed as part of @point input; 1 is left mouse button behaviour, 2 is middle mouse button behaviour, and 4 is right mouse button behaviour.
@attribute=GRADE,2.5 is the ParseAttributeArguments: An attribute assignment token parsed into strColumnName and Datum.
GRADE is the strColumnName: String value naming the attribute column.
2.5 is the Datum: Typed attribute value parsed from the attribute token.

Parameters Table

Parameter	Description	Reqd?	Example Syntax
`ParsePointArguments`	An @point group of 4 comma-delimited values: X, Y, Z, and nButton. X, Y, and Z are numeric world coordinate values. nButton is an integer parsed as part of @point input; 1 is left mouse button behaviour, 2 is middle mouse button behaviour, and 4 is right mouse button behaviour.	Y	`@point=100.0,200.0,0.0,1`
`ParseAttributeArguments`	An attribute assignment token parsed into strColumnName and Datum.	Y	`@attribute=GRADE,2.5`
`strColumnName`	String value naming the attribute column.	Y	`GRADE`
`Datum`	Typed attribute value parsed from the attribute token.	Y	`2.5`