clip-to-perimeter ("ctp")

See this command in the command table.

To access this command:

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

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

  • Use the quick key combination "ctp".

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

Command Overview

Deletes all string and point data from either inside or outside of a perimeter.

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

Command steps:

  1. Ensure data to be clipped, and the clipping perimeter, is visible in a 3D window.

  2. Run the command.

  3. Select the clipping perimeter.

  4. Select a point either inside or outside of the perimeter to choose which data is deleted.

    Strings and points are clipped to the edge of the perimeter.

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-to-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