Vr Mapping |
ON-LINE REFERENCE DOCUMENTATION CARDINAL SYSTEMS, LLC |
Insert Multiply Parallel Lines (InsMul)
Type: Interactive/Batch Application
Up to 10 parallel lines may be inserted from an existing base line.
Detailed Description
Inserts up to ten parallel lines with known Xy and Z 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.
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.
Pass
Allows entry/edit of a parallel pass. There can be up to ten passes.
Pass name
Each pass may be name and is for information purposes only.
Pass
Individual passes may be turned on or off.
Layer for parallel line
Defines the layer for the parallel line placed 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
Defines the graphic pointer for the parallel 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 to place the new parallel line from the base line. This parameter is entered in ground units. A positive number will place the parallel line to the right of the base line and a negative number will place the parallel line to the left of the base line.
Line offset delta Z
Defines the delta elevation to apply to each point on the parallel line. This parameter is entered in ground units.
Button Assignments
Rev Line – Lock on
|
Button |
Description |
1 |
Id line |
Identifies base line to place new parallel line(s) from |
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
When Insert Multiple Parallel Lines starts it is in interactive mode and a base line may be identified. After the base line identified is confirmed the parallel lines are placed based on the current parameters.
Insert Multiple Parallel Line may be run in batch mode in which base lines are read from user-defined layers. Workspaces to consider include the current workspace or all open workspaces.
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.
Insert Multiple Parallel Lines can be run in batch mode from a macro. 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.