rotate-string ("rst")

See this command in the command table.

To access this command:

  • Digitize ribbon > Transform > Rotate.

  • Using the command line, enter "rotate-string" and press ENTER.

  • Use the quick key combination "rst".

  • Display the Find Command screen, locate rotate-string and click Run.

Command Overview

Rotate a string interactively about a fixed anchor point.

This command is affected by parameters that have been defined for your project. There are two possible ways that rotation can be performed:

  • Data can be rotated relative to the screen (that is, around a plane that is orthogonal to the current camera view), or;

  • Data can be rotated relative to the current data plane. This "3D" rotation allows the planar alignment of data to be maintained regardless of the position and direction of the camera.

See Project Settings: Points and Strings.

Command steps:

  1. Run the command.

    You are prompted to "Select anchor point on any string".

  2. Select the anchor point and the cursor changes to .

  3. Drag the anchor point and the selected string rotates about the defined anchor point. T

    Note: The angle of rotation and the azimuth in the view plane from the rotation point to the cursor location is reported in the message area of the status bar.

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("rotate-string @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
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 as part of @point input. Enumerated types are:

    • 1: Left mouse button behaviour

    • 2: Middle mouse button behaviour

    • 4: Right mouse button behaviour

 Y @point=100.0,200.0,0.0,1

Related topics and activities