erase-point ("dpo")

See this command in the command table.

To access this command:

  • Data ribbon > Objects > Unload > Points.

  • Using the command line, enter "erase-point" and press ENTER.

  • Use the quick key combination "dpo".

  • Display the Find Command screen, locate erase-point and click Run.

Command Overview

Delete vertices (points) in any selected or non-selected string(s) or point(s) nearest to the cursor.  

This command is supported by undo and redo operations.

To delete points on selected string or point data:

  1. Select string(s) or point(s). See Selecting 3D Data Interactively.

  2. Run the command.

  3. If a string(s) has been selected, individually select (left-click or right-click) the required string point(s).

    Note: When selecting the string points for deletion, only one point can be selected at a time. Clicking anywhere within a 3D window will delete the point, on the selected string(s), which is nearest to the cursor. The user does not need to click adjacent to each point, but just closer to the required point than any other point on the selected string.

  4. Press ESC or click Done to complete the command.

To delete points on unselected string or point data:

  1. Run the command.

  2. Individually select (left-click or right-click) the required point(s).

  3. Press ESC or click Done to complete the command.

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("erase-point @point=100.0,200.0,0.0,1 'yes'";

Where:

  • @point=100.0,200.0,0.0,1 is the ParsePointArguments: X,Y,Z,nButton.

  • 'yes' is the confirmToken: a string value and expects yes or no (quoted and unquoted variants are accepted in different delete paths).

Parameters Table

Parameter Description Reqd? Example Syntax
ParsePointArguments

X,Y,Z,nButton.

  • X is a numeric (double) world coordinate value.

  • Y is a numeric (double) world coordinate value.

  • Z is a numeric (double) world coordinate value.

  • nButton is an integer value parsed as part of @point input. Enumerated types are:

    • 1: Left mouse button behaviour

    • 2: Middle mouse button behaviour

    • 4: Right mouse button behaviour

 Y @point=100.0,200.0,0.0,1
confirmToken

A string value and expects yes or no (quoted and unquoted variants are accepted in different delete paths).

 Y 'yes'

Related topics and activities