Vr Mapping

ON-LINE REFERENCE DOCUMENTATION

CARDINAL SYSTEMS, LLC

www.cardinalsystems.net

Insert Multiply Parallel Lines  (InsMul)

Type: Interactive/Batch Application

 

Inserts up to 10 parallel lines from an existing base line.

Detailed Description

Inserts up to ten parallel lines with known XYZ offsets from an existing base line. The lines to be paralleled are defined and saved in a Parallel parameter file. Insert Multiple Parallel Lines offers the following modes:

Interactive – The base line is identified by the user and parallel lines are placed based on the current Parallel parameter file.
Batch – Lines within layer(s) are used as base lines. These layers may be in the current workspace or all open workspaces. This application may be run in batch mode from a macro.
From OnEnd Command – The last line saved is used as the base line. This is useful to place parallel lines each time a base line is saved. The OnEnd command is defined from a VrOne Function Key.

When running in batch mode, layers that are turned off will not be used even if they have been specified. Insert Multiple Parallel lines is undoable.

 

InsMParLine_image002

 

The original line to be paralleled is called the base line. The new parallel lines are placed as passes from the parallel parameter file.

Local Commands

Key-in

Description

Range

WS=, WSTC=

Workspaces to consider when running in batch

0-1

LAY=

Layers containing lines to parallel when running in batch.

1-10,001 (Number line)

PARFIL=

Loads a previously defined parallel parameter file.

File name with path. Example:

C:\jobs\param\CurbGutter.mpp

RUN

Runs Insert Multiple Parallel in batch mode with current parallel parameters.

 

DIGLAST

Inserts parallel lines using the last saved line as the baseline.

 

Workspaces to consider (WS= or WSTC=)

Defines the workspaces to consider when running in batch mode.

Layers containing base lines (Lay=)

Defines the layer(s) to search for existing base lines when running in batch mode.

Parallel parameter file (ParFil=)

Loads a previously defined parallel parameter file.

Run (Run)

Runs application in batch mode using the current Workspace to consider, Layers to consider, and Parallel parameter file. This application will end after placing the parallel lines when using the Run command.

Use last saved line (DigLast)

Inserts parallel lines using the last save lines as the base line. This is useful when running Insert Parallel Lines from a Function Key’s OnEnd command. This application will end after placing the parallel lines when using the DIGLAST command.

Parallel Parameters

InsMParLine_image004

Pass

Allows entry/edit of up to 10 parallel passes.

Pass name

Specifies the name of each parallel pass (informational purposes only; does not modify image).

Pass

Turns individual passes on or off.

Layer for parallel line

Specifies the layer into which to place the line created by the current pass. An argument of -1 specifies that the new line should be placed in the same layer as the base line.

Graphic pointer of parallel line

Specifies the graphic pointer for the line placed by the current pass. An argument of -1 specifies that the new line should use the same graphic pointer as the base line.

Line offset distance Xy

Defines the distance in ground units from the base line to place the new parallel line. Positive numbers place the line to the right of the base line; negative numbers to the left.

Line offset delta Z

Defines in ground units the delta elevation to apply to each point on the parallel line.

Button Assignments

Rev Line – Lock on

 

Button

Description

1

Id line

Identifies base line from which to create parallel lines.

2

Parallel layer

Runs in batch mode.

3

Load params

Loads parallel parameter file.

4

Save params

Saves current parameters as parallel parameter file.

5

 

 

6

 

 

7

Enter params

Enter/edit parallel parameters.

8

Init params

Initializes parallel parameters.

9

 

 

*

 

 

0

 

 

#

End

Ends application.

 

MODES

Interactive Mode

Allows a base line to be identified. After the base line identified is confirmed, the parallel lines are placed based on the current parameters. Insert Multiple Parallel Lines starts in Interactive Mode.

Batch Mode

Reads baselines from user-defined layers. Workspaces to consider include the current workspace or all open workspaces.

 

InsMParLine_image006

From OnEnd Command

Insert Multiple Parallel lines may be run unattended from a VrOne Function Key OnEnd command. Using this mode allows parallel lines to be placed after a line is saved. Following is and example of using an OnEnd command.

 

InsMul,ParFil=c:\jobs\01-345\CurbGutter.mpp,DigLast

 

InsMul – Starts application

ParFil=c:\jobs\01-345\CurbGutter.mpp – Loads a previously defined parallel parameter file. The file postfix for a parallel parameter file is .mpp.

DigLast – Uses the last saved line as the base line. The application exits after the new parallel line(s) are placed.

Running from a macro

Insert Multiple Parallel Lines can be run in batch mode from a macro.  The following is an example of a macro that runs the application in batch mode:

InsMul

ParFil=c:\jobs\01-345\CurbGutter.mpp

Ws=0

Lay=1-19 23 25

Run

After the new parallel lines are placed, Insert Multiple Parallel Lines ends.