erase-plane ("ern")

See this command in the command table.

To access this command:

  • Data ribbon > Objects > Unload > Delete Planes.

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

  • Use the quick key combination "ern".

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

Command Overview

Erase selected plane(s) from memory.

  • Only visible planes can be selected and erased. Hidden overlays and data that are filtered out at the time of selection, cannot be selected even if they fall within a selection box .

Command steps:

  1. Run the command.

  2. If not already selected, select the required planes (any method). See Selecting 3D Data Interactively.

  3. Click Yes.

  4. Click Cancel.

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