select-string-depth

See this command in the command table.

To access this command:

Using the command line, enter "select-string-depth" and press ENTER.
Display the Find Command screen, locate select-string-depth and click Run.

Command Overview

Select string data based on its depth 'into the screen'.

This command is particularly useful where there is an abundance of data on screen, say when scheduling block perimeters where wireframe solids are also displayed without any view clipping. In this situation, it is commonly the case that a wireframe surface which is 'closer' to the camera than a target perimeter may obscure the data you wish to select.

With this command, you can click multiple times to select string data that lies underneath the cursor, and where multiple targets are possible, successive clicks of the mouse will allow string data that is further away from the camera to be selected instead, cycling through all possible 'hits' and repeating the cycle as required.

Command steps:

Run the command.
Position the cursor over the data you wish to select.
Left-click.

Use multiple left-clicks to select string data that is beneath the currently selected data, or to return to selection of the topmost data.
Click Done to exit this selection mode and return to the default mode.

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("select-string-depth @point=100.0,200.0,0.0,1";

Where:

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

Parameters Table

Parameter Description Reqd? Example Syntax

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 from @point input. Value 12 enables control-held style selection behavior.	Y	`@point=100.0,200.0,0.0,1`

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 from @point input. Value 12 enables control-held style selection behavior.

@point=100.0,200.0,0.0,1