translate-point ("tra")

translate-string ("tra")

translate-string-opt ("tra")

translate-wireframe ("trw")

See this command in the command table.

To access this command:

Wireframe Design ribbon > Edit > Translate.
Digitize ribbon > Transform > Translate.
Using the command line, enter "translate-string" and press ENTER.
Using the command line, enter "translate-string" and press ENTER.
Using the command line, enter "translate-string" and press ENTER.
Using the command line, enter "translate-string" and press ENTER.
Use the quick key combination "tra".
Use the quick key combination "trw".
Display the Find Command screen, locate translate-string and click Run.
Display the Find Command screen, locate translate-string and click Run.
Display the Find Command screen, locate translate-string and click Run.
Display the Find Command screen, locate translate-string and click Run.

Command Overview

Translate one or more selected data by a defined distance in each of the X, Y and Z directions, optionally repeating the translation a number of times. The screen displayed for this command is the same for target point, string and wireframe data.

Tip: preselecting data means you don't have to click on multiple items when running this command.

Command steps:

Optionally, preselect the data you wish to translate.
Run any of the translation commands.

Note: Any combination of data (string, point or wireframe) can be translated with each run of a command, and it doesn't matter which command was used to display the settings screen as this is identical regardless of how you display it.
If data wasn't previously selected, select the required data in any 3D window.
Using the Enter Translation Distance screen, choose how you wish to translate the selected data:
- Choose By XYZ Distance to enter a Translation Distance along each of the major axes.
- Choose By Slope Distance to enter the Azimuth, Gradient and Distance to translate data.
Choose if you wish to Repeat the translation a number of times (say, to produce bench crest strings at fixed intervals from the target string or strings).
If you wish to retain the original data and create a copy of it at the new location, check Keep Original Object. If unchecked, data is moved and the original data is not retained.
Click OK.

Data is either moved or copied to the translated position(s).

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("translate-string @point=100.0,200.0,0.0,1 '1.0' '2.0' '3.0' 'yes' '2'";

Where:

@point=100.0,200.0,0.0,1 is the ParsePointArguments: X,Y,Z,nButton.
'1.0' is the strX: a string value parsed as numeric offset X.
'2.0' is the strY: a string value parsed as numeric offset Y.
'3.0' is the strZ: a string value parsed as numeric offset Z.
'yes' is the strCopy: a string value interpreted as yes/no for copy mode (first letter y enables copy).
'2' is the strRepeat: a string value parsed as integer repeat count (optional).

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 parsed in @point input. (Parameter is not actually used so can be left as the example and ignored).	Y	`@point=100.0,200.0,0.0,1`
`strX`	A string value parsed as numeric offset X.	Y	`'1.0'`
`strY`	A string value parsed as numeric offset Y.	Y	`'2.0'`
`strZ`	A string value parsed as numeric offset Z.	Y	`'3.0'`
`strCopy`	A string value interpreted as yes/no for copy mode (first letter y enables copy).	Y	`'yes'`
`strRepeat`	A string value parsed as integer repeat count (optional).	N	`'2'`