Vr Mapping |
ON-LINE REFERENCE DOCUMENTATION CARDINAL SYSTEMS, LLC |
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
Also supported is hydro-enforcement during the collection of line points which forces lines to flow upstream or downstream.
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. 3=Create circle from the 3 points. |
ATTZRU= |
Attaches Z Rule |
0 = Original 1 = Mean 2 = Line 1 (Same as original) 3 = Line 2 (Line attached to) |
ATTNOD= |
Nodes when attaching |
0 = No 1 = Yes |
DRIBAC= |
Drives 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= |
Turns splicing on/off |
0 = Off 1 = On |
SPLSEA= |
Sets splicing search distance |
Splicing search distance in ground units |
SPLZ= |
Splices Z mode |
0 = Blend elevations from splice line into base line(s) 1 = Inherit the first elevation of the base line for all points on the line after splice 2 = Slope the elevations on the splice line from blend points into the base line(s) |
LAKLIN= |
Makes a Lake Line in which the elevations of the line are set to the first point |
0 = Off 1 = On |
EXPSPL= |
Explodes splined lines. If line mode is splined will place extra points on the line to approximate the spline curve. |
0 = Off 1 = On |
EXPFON= |
Explodes 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. |
CLOTWO= |
Allows lines to be closed with only two existing points |
0=No. Line must have three or more points before it can be closed. 1=Yes. Line can be closed when it has two or more points. |
HYDENF= |
Turns on/off the hydro-enforcement of lines during collection. |
0=Off 1=On |
HYDDIR= |
Defines the flow direction of lines during collection if hydro-enforcement is active. |
0=Downstream 1=Upstream |
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. See Z Rules when using Attach and Run for more information. |
* 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 |
|
# |
|
Z Rules when using Attach and Run
The following information describes how the Z is handled when using Attach and Run.
If noding is on, then the two node points added to the original line (the one being attached to) are always interpolated from the surrounding original line points.
The Z rule applies to the points added to the new line depending on the current Z rule settings as follows:
| • | Original: The beginning and ending attachment points on the new line are set to whatever the Z value was when digitizing the attachment points. The points added that run along the original line are set to same Z as the original line points. |
| • | Mean: The beginning and ending attachment points on the new line are set to the mean of the active Z and the interpolated Z from the surrounding original line points. The points added that run along the original line are set to same Z as the original line points. |
| • | Line 1: Behaves the same as Original. |
| • | Line 2: The beginning and ending attachment points on the new line are set to the interpolated Z from the surrounding original line points. The points added that run along the original line are set to same Z as the original line points. |
It is 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.
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.
One of three splicing elevation modes may be selected when splicing. The splicing Z mode may be set in Parameters (button 7, button 7) in “Splice elevation mode” or may be set with the SplZ= key-in.
| • | Blend (SplZ=0) – The elevations of the end point(s) on the splice line will be blended into the existing line(s). The elevation(s) of the existing line will be used and the elevation(s) of the end points on the splice line will be modified to match. |
| • | Inherit (SplZ=1) – The elevation of the fist point on the existing line will be inherited by all points on the resulting line. After splicing the elevations of all the points on the line will be the same. This is a useful setting when splicing contour lines and should only be used when splicing features such as contours where a constant line elevation is assumed. |
| • | Slope (SplZ=2) – The splice line elevations will be sloped based on the first and last point elevations of the splice line. The first and last points on the splice line will first be blended into the existing line(s) as described in Blend above then the remainder of the points on the splice line will be interpolated based on these two elevations. NOTE: Both splice line end points must be blended into an existing line or lines for this option to take effect. If only one end of the splice line is blended then the Blend option will be used for the elevation of that line. |
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.
When hydro enforcement is active each new point digitized must conform to the specified elevation flow of the line. If the new point would cause the line to flow in the wrong direction the alert beep is sounded and the point is ignored. The alert beep sound may be set in Edit Beep (EdiBee). Hydro enforcement and the flow direction is set in Enter (Button 7) -> Params (Button 7) dialog or may be set using the HydEnf= and HydDir= key-ins.