VrOne

ON-LINE REFERENCE DOCUMENTATION

CARDINAL SYSTEMS, LLC

386-439-2525   

www.cardinalsystems.net   
 

INSERT LINE (InsLin)

 

Type: Interactive Application

 

Places multiple point lines where the operator determines the location of the points.  Insert Line supports the Splicing of the digitized line into an existing line or lines.  Click here for more on Splicing

Local Commands

Key-in

Description

Range

LAY=

Layer number

1-10001

MOD=

Mode

1=Line 2=Spline

GRP=

Graphic pointer

1-60

WID=

Line width

0-255

PEN=

Pen number

1-256

CON=

Construction flag

0-1

NGR=

Non graphic pointer

32 bit

LNK=

Link number

32 bit

FC=

Feature code

15 char

DIG=x y z

Digitizes point

X Y Z

FKEY=name

Changes to function key parameters

Function key name

ARCMOD=

Arc flag mode

0 = Don’t place arc flags

1 = Place arc flags

ENDMOD=

Sets the behavior of the end button.

0=End

1=Digitize point at current location then end line.

2=Save line after collecting 2 points.

ATTZRU=

Attach Z Rule

0 = Original

1 = Mean

2 = Line 1 (Same as original)

3 = Line 2 (Line attached to)

ATTNOD=

Node when attaching

0 = No

1 = Yes

DRIBAC=

Drive input device to the previous line point when Backup is pressed

0 = No

1 = Yes

RUNONCE=

If 1 then Insert Line will exit after the next line is saved.

0 = No

1 = Yes

SPL=

Turn splicing on/off

0 = Off

1 = On

SPLSEA=

Set splicing search distance

Splicing search distance in ground units.

SPLINH=

Inherit elevations from base line when splicing

0 =  No

1 = Yes

LAKLIN=

Makes a Lake Line in which the elevations of the line are set to the first point.

0 = Off

1 = On

EXPSPL=

Explode splined lines. If line mode is splined will place extra points on the line to approximate the spline curve.

0 = Off

1 = On

EXPFON=

Explode fonted lines. If the line used a non solid line font, multiple lines will be placed to generate the line font graphics.

0 = Off

1 = On

EXPSF=

Explode line scale factor

If the explode spline option is on, this controls how many points are placed on the line. 1.0 = use normal Spline chord distance. Large numbers add more points, smaller numbers add fewer points.

Button Assignments

Ins Line - Main

Button

Description

1 Digitize pt

Digitizes a single Xyz location

2 Close

Closes the current line but does not save the line

3 Backup

Deletes the last point on the current line

4 End

Ends and saves the current line

5 Attach

Attaches to an existing line

6 Arc

Fits an arc thru the last three line points

7 Enter

Allows entry of line properties or parameters.  Also allows the placement of a point by coordinate, azimuth/distance or bearing/distance.

8 Enter Z

Allows entry of an elevation

9 Attach & run

Attaches and runs along an existing line copying common points

* Menu board

Makes selection from Menu Board

0 Toggle snap

Toggles snapping on / off

# End

Ends Insert Line

 

 Ins Line – Enter

Button

Description

1 Properties

Allows entry of line properties such a layer, mode and graphic pointer

2 Coordinate

Allows the placement of a point by entering a coordinate position

3 Azimuth

Allows the placement of a point by azimuth and distance

4 Bearing

Allows the placement of a point by bearing and distance

5

 

6

 

7 Params

Allows the setting of parameters

8

 

9

 

*

 

0

 

#

 

Splicing

It’s possible to splice the current line into another existing line.  It is also possible to splice the current line into two existing lines.  Parameters may be set to splice automatically based on the position of the end points of the current line.  When using Insert Line for splicing, it is not necessary to set any of the line properties such as Layer and Graphic Pointer.  The resulting spliced will have the properties from the existing line.  If a splice is made between two existing lines, the properties for the new line will be inherited from the first existing line which is the line closest to the start point on the new line.

 

It is possible to inherit the elevation of the existing line when splicing by setting the Splice Inherit Z (SplInh) parameter.  When this parameter is set to Yes then the elevation of the spliced line will inherit the elevation of the base line.  In the case where three lines are spliced the elevation of the first line will be used.  This parameter should only be used when splicing features such as contours where a constant line elevation is assumed.

 

Splicing is set up by turning on the splicing mode.  This can be done from the Enter button (Button 7) then the Params button (Button 7).  The splice search distance may be set here also.  The splice flag and search distance may also be set from the Spl= and SplSea= key-ins.  For example; a key-in of Spl=1 SplSea=20 would turn splicing on and set the search distance to 20 ground units.  These key-ins may be placed on a Function Key so Insert Line may be started with splicing set.

 

The results of splicing may be undone using the Undo command.

 

Following are several examples of splicing:

 

Example 1 – Undershoot Splice

The red line is the existing line and the grey line is the new line.  The end point on the new line is within the Splice Search Distance (SplSea=) of the existing line.  The first point on the new line is not within the range of an existing line so this end of the line will not be spliced.  This condition is considered an undershoot splice.

 

When the new line is ended it is spliced into the existing line.  The new line inherits the properties of the existing line.

 

Example 2 – Overshoot Splice

The red line is the existing line and the grey line is the new line.  The first point on the new line is within the Splice Search Distance (SplSea=) of the existing line.  The last point on the new line is not within the range of an existing line so this end of the line will not be spliced.  This condition is considered an overshoot splice.

 

When the new line is ended it is spliced into the existing line.  The new line inherits the properties of the existing line.

 

Example 3 – Two Point Splice

The red line is the existing line and the grey line is the new line.  Both the first point and end points on the new line are within the Splice Search Distance (SplSea=) of the existing line.  This condition is considered a Two Point Splice.

When the new line is ended it is spliced into the existing line.

 

Example 4 – Two Line Splice

The red and green lines are existing lines and the grey line is the new lines.  The first point is within the Splice Search Distance (SplSea=) of the red line and the end point is within the range of the green line.  This condition is considered a Two Line Splice.

 

When the new line is ended it is spliced into the existing lines.  Notice the spliced line assumes the line properties of the first existing line.