Insert Text (InsTex)

Type: Interactive Application

Places text labels.

Detailed Description

Insert Text is designed to be run interactively and to be run from another Function Key. When used interactively, a rich set of options enable precise text placement in most situations. When run from another Function Key, options allow the application to be started and a text label to be placed without user intervention. Text labels may be typed in using a dialog box, keyed-in from the key-in area or from a text file.

Curved Text

It is possible to place text along an existing VrOne line (base line) as “curved text”. In this mode each text character will be placed as a single entity. The “Place Curved Text” mode is turned on the “Curved Text Search Distance” is set to enable this feature. The curved text direction and character rotations will be based on the direction of the base line. If the display North is up and a line is increasing from right to left then the text will show as “upside down” in reference to the viewer. Lines that are in layers that are turned off will not be considered when searching for lines to curve text along. A curved text offset can be specified which offsets text from the base line.

Local Commands

Parameters

NOTE: Each time Insert Symbol saves a symbol, it stores the location of the symbol as the saved coordinate. The saved coordinate may be used here as the last elevation for the Z Mode parameter or the last coordinate for the Digitize Last command.

Set Current Text Label (=)

Sets the current text label. This is a shortcut for the Txt= key-in. The two following key-ins have the same meaning:

=This is text

Txt=This is text

Size (Size=)

The size parameter sets both the text height and the text width to the size specified.

Offset X, Offset Y, Offset Z (OfsX=, OfsY= OfsZ=)

The coordinate of the text will be placed this distance from the point digitized. These parameters are often used when Insert Text is being used to place text next to another object such as a symbol.

Snap Mode (SnaMod=)

The snap mode defines what coordinate axis to get when snapping. If the Snap Mode were set to “Get elevation only” then it would be possible to snap to an existing symbol and retrieve it’s elevation only. This can be used to place the elevation of a spot elevation ‘X’.

Z Mode (ZMod=)

Defines the source of the elevation for the text label. This option can set the source to the current elevation, which is normally used when placing text. If the text to be placed is the elevation of the last symbol placed then a Z Mode of 1 should be set.

Copy Z (CopZ=)

If this parameter is set to 1 then the text entity’s elevation will be copied to the text label. This is necessary when labeling spot elevations.

Decimal Accuracy (DecAcc=)

If the Copy Z parameter is set to 1 then this parameter is used to define the number of places to the right of the decimal point that are labeled.

Prompt Mode (ProMod=)

If Prompt Mode is set to 1 then Insert Text will prompt for a text label when it is stored and after each new label is saved.

Increment Value (IncVal=)

If the current text label is a numeric value, the Increment Value will be added to it each time a text label is saved. This is useful when labeling items that are sequential numbers. Increment Value may be an integer or double precision number. A value of zero turns this feature off.

Place Curved Text (CurTex=)

Turns the curve text placement mode on or off. If this mode is on and the digitized text location is within the distance specified in the “Curved text search distance” (see below) of an existing line then the text will be placed along that line. Each text character will be placed as a single entity.

Curved Text Search Distance (CurDis=)

Specifies the line attach search distance to existing lines when placing curved text along an existing line. See “Place Curved Text” above. This parameter is entered in ground units.

Curved Text Offset Distance (CurOff=)

Specifies the distance to offset curved text from the base line. A negative number will offset the text to the left of the base line and a positive number will offset the text to the right. This parameter is entered in Prompting Units which is inches or millimeters (in|mm). (See Vr Mapping Definitions for more information about Prompting Units.)

Run Once (RunOnce=)

Insert Line will exit after a text label has been placed if this parameter is set to 1. Setting RUNONCE to 1 is the same as placing the Pop command as the On-end command in a function key that starts Insert Line. For consistency, the Pop command should be used instead of this parameter.

Digitize Last (DigLast)

This is not a parameter but a command. When received by this application, the current text label is placed at the saved coordinate position. This command is used when a symbol function key calls Insert Text and places a text label without any user intervention.

Text Rotations

Text rotations are defined in degrees, counterclockwise with zero being along the X-axis.

Text rotations

Text Justifications

VrOne supports ten text label justifications.

Ten supported Text Justifications

Button Assignments

Ins Text – Main

Ins Text – Rot

Ins Text – Expand

Ins Text – Just

Ins Text – File

It is possible to obtain text labels from a text file. This is useful when labeling items such as coordinate lists.