clip-outside-perimeter ("cop")

See this command in the command table.

To access this command:

  • Digitize ribbon > Tools > Clip Strings > Clip Outside Perimeter.

  • Using the command line, enter "clip-outside-perimeter" and press ENTER.

  • Use the quick key combination "cop".

  • Display the Find Command screen, locate clip-outside-perimeter and click Run.

Command Overview

Delete point and string data lying inside a selected perimeter.

Note: If string or point data is loaded but not displayed, it is not affected by this command.

In the following example, the red perimeter (closed string) is used to clip the grey string data.

Before clipping:

After clipping:

Command steps:

  1. In a 3D window, display both the string data to be clipped, and the closed perimeter string that will clip that data.

  2. Run the command.

  3. Following the prompt in the Status Bar, select the clipping perimeter (the closed string).

    All string data insidethe perimeter is removed.

  4. Click Cancel to close 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("clip-outside-perimeter @point=-27.533174,10.168432,0.0,1";

Where:

  • @point=-27.533174,10.168432,0.0,1 is the @point=X,Y,Z,nButton: comma-delimited pick argument group.

Parameters Table

Parameter Description Reqd? Example Syntax
@point=X,Y,Z,nButton

Comma-delimited pick argument group.

  • X , Y , Z : numeric values (double).

  • nButton : integer parsed as part of the point argument. It is used when value 12 is provided (enables snapping); other values proceed with left-click handling.

 Y @point=-27.533174,10.168432,0.0,1

Related topics and activities