new-triangle ("ntr")

See this command in the command table.

To access this command:

  • Wireframe Design ribbon > New Triangle.

  • Using the command line, enter "new-triangle" and press ENTER.

  • Use the quick key combination "ntr".

  • Display the Find Command screen, locate new-triangle and click Run.

Command Overview

Defines new wireframe triangles interactively in the 3D window, either appending them to an existing or new wireframe object.

By default, the new triangles are added to the current wireframe object. If no wireframe object exists, a new object is created, displaying details of the new object immediately in the Current Object Toolbar.

The new wireframe object takes it's attributes from those of the column defaultsin the Current Object toolbar,. The wireframe triangles will not take attributes from loaded strings, nor will attributes be transferred when snapping to string points.

The initial triangle is formed using 3 points. Subsequent triangles are defined like this:

  • If a subsequent triangle is connected to the original by only one point, snap to the shared point and define another two points elsewhere. For example, in the image below, point (4) is snapped to the position of point (3):

  • To add a triangle that shares the edge formed by the previously-digitized two points (on the preceding triangle, just created), define a single point elsewhere. For example, in the image below, 4 points are used to create 2 triangles with a shared edge:

    Tip: this method lets you quickly build up a set of interconnected triangles, without having to define the 3 vertices of each triangle individually.

Command steps:

  1. Run the command.

  2. In the Snapping toolbar, select the required snap mode and data selection settings.

  3. In the Current Objects toolbar, select the current object or create a new one. See how to set the current object.

  4. In the Current Objects toolbar, select the required Attribute Field and associated Attribute Value parameters. See how to set attributes.

  5. Digitize new triangle vertex positions. See the examples above for advice one whether to use 3 points or 1 point to create new data.

  6. When all triangles are created, click Done to end 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("new-triangle @point=100.0,200.0,0.0,1 @attribute=ZONE,'A'";

Where:

  • @point=100.0,200.0,0.0,1 is the ParsePointArguments: An @point group of 4 comma-delimited values: X, Y, Z, and nButton. X, Y, and Z are numeric world coordinate values. nButton is an integer parsed as part of @point input; 1 is left mouse button behaviour, 2 is middle mouse button behaviour, and 4 is right mouse button behaviour.

  • @attribute=ZONE,'A' is the ParseAttributeArguments: An attribute assignment token parsed into strColumnName and Datum.

  • ZONE is the strColumnName: String value naming the attribute column.

  • 'A' is the Datum: Typed attribute value parsed from the attribute token.

Parameters Table

Parameter Description Reqd? Example Syntax
ParsePointArguments An @point group of 4 comma-delimited values: X, Y, Z, and nButton. X, Y, and Z are numeric world coordinate values. nButton is an integer parsed as part of @point input; 1 is left mouse button behaviour, 2 is middle mouse button behaviour, and 4 is right mouse button behaviour. Y @point=100.0,200.0,0.0,1
ParseAttributeArguments An attribute assignment token parsed into strColumnName and Datum. Y @attribute=ZONE,'A'
strColumnName String value naming the attribute column. Y ZONE
Datum Typed attribute value parsed from the attribute token. Y 'A'

Related topics and activities