view-by-two-points ("v2")

See this command in the command table.

To access this command:

Using the command line, enter "view-by-two-points" and press ENTER.
Use the quick key combination "v2"
Display the Find Command screen, locate view-by-two-points and click Run.

Command Overview

Set the active 3D window view position and orientation based on two selected points (to define a central axis) and an orientation around that axis.

Note: This command shouldn't be confused with the plane-by-two-points ("2") command which sets the orientation of the current 3D window section plane (although the view can be automatically oriented to this section afterwards, optionally).

Command steps:

Display any 3D window.

Note: This command is also supported in external 3D windows.
Run the command.
Left or right (snap) click two separate points in the 3D window. This becomes the axis around which the camera is oriented.

Tip: You can click points in separate 3D windows. This can be useful to precisely align the view with landmark data points.

The Orientation screen displays.
Select a view Orientation option:
- Horizontal
- Vertical
- Perpendicular
Click OK.

The view orients to point at the focal point, along the selected axis.

Note: Ignore the Align view to section option. The Orientation screen is also used by the section modification commands (plane-by-two-points ("2"), for example), where this option is relevant.

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("view-by-two-points @point=100.0,200.0,0.0,1 @point=120.0,220.0,0.0,1 'v'";

Where:

@point=100.0,200.0,0.0,1 is the first ParsePointArguments: an @point group for first reference point.
@point=120.0,220.0,0.0,1 is the second ParsePointArguments: an @point group for second reference point.
'v' is the orientationArg: a string value. Enumerated types are:

Parameters Table

Parameter	Description	Reqd?	Example Syntax
`first ParsePointArguments`	An @point group for first reference point.	Y	`@point=100.0,200.0,0.0,1`
`second ParsePointArguments`	An @point group for second reference point.	Y	`@point=120.0,220.0,0.0,1`
`orientationArg`	A string value. Enumerated types are:	Y	`'v'`