new-points ("npo")

See this command in the command table.

To access this command:

  • Digitize ribbon > Create > Point.

  • Using the command line, enter "new-points" and press ENTER.

  • Use the quick key combination "npo".

  • Display the Find Command screen, locate new-points and click Run.

Command Overview

Digitize new point 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.

Typically, a left click or tap of the stylus adds a point.

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, all points digitized in the command session are undone or redone as a single unit.

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

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

Note: This command supports command line coordinates.

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-points @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

Related topics and activities