------------------------------------------------------------------------------- MODULE IFROMTEXT

-------------------------------------------------------------------------------

REPLACES   DAMP module TEXT2I

-------------------------------------------------------------------------------

FUNCTION

-------------------------------------------------------------------------------

FORMAT

-------------------------------------------------------------------------------

PROMPTS

--------------------------------------------------------------------------------

PARAMETERS

-------------------------------------------------------------------------------

COMMAND QUALIFIERS

-------------------------------------------------------------------------------

DESCRIPTION

MH 174 2
            0       436500       122000         1250            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0       436500       122000            0            0
           50         1250         6500            0            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0      4260880      4260880
      4260880      4260880            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880      4260880      4260880
      4260880      4260880      4260880      4260880            0            0
            0            0            0      9439170            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
            0            0            0            0            0            0
MH 0 3
  -1   0  436500  122000      50    1250       0    6500 -20   1                
           9  86   0   0   0   0   0   0   0   0   0   0   0   0   0   0   0   0
   0   0   0   0   0   0   0   0   0   0       0                   0   0   0   0
   0   0                                                                        
                                                                                
                                                                                
           0   0

IFROMTEXT AND THE /ORIGIN QUALIFIER

IFROMTEXT can read a text file containing double precision (absolute) coordinates (usually created by using the ITOTEXT/ABSOLUTE process), subtracting the supplied origin offset from all coordinate values and outputting an IFF file in local coordinates relative to this origin.

IFROMTEXT AND THE CB ENTRY

The CB entry is represented in textual form by a number of sub-entries which may be input to IFROMTEXT. A valid text form of the CB entry is as follows;-


While IFROMTEXT will produce default values if any of the sub-entries are omitted or are invalid it is important that: -

If either of these conditions is not met then the data entry in the IFF file produced may be corrupt.

Note that attribute codes may be input either by their numeric code (eg 1006), or by the attribute name (eg X) in the ACD table. ITOTEXT, however, always outputs the numeric codes.

Character attributes (maximum 4 characters) should be enclosed in double quote markers while date and time attributes should be input in the standard VMS formats. ie.

	                13-OCT-1962
	                23:11:56.2

The IFF User guide should be consulted for a detailed description of the CB entry.

IFROMTEXT AND DEFAULT PROCEDURES

The user is not expected to produce a structurally complete textual representation of an IFF file using a text editor. Any IFF entries which are out of sequence or which are missing will be defaulted and the user informed. Which features are defaulted depends on what level of feature has been input by the user. For example if only an MD entry is included in the input file then only features at map level and above will be defaulted. (MH,MD,EM,RA,EJ). The IFF user guide should be consulted for a detailed description of IFF file structure.

One potentially disruptive default is that used for a missing ST entry. This consists of a single point having the coordinates (0.0,0.0). This will clearly affect the RA (RAnge) entry of the IFF file. The inexperienced user is recommended to use the /LOG qualifier which will output more detailed messages regarding the default IFF entries generated.

If the input file contains an entry which is incomplete or contains invalid values, then a message may be output informing the user that the remainder of the entry is defaulted. In the case of the CP (Corner points) entry, 16 values are expected. The following is an example of a deficient CP entry in the input file :


After IFROMTEXT and a subsequent ITOTEXT the CP entry would appear as
follows : 

The last 8 CP values (which define the SE and NE control points) are
IFROMTEXT defaults and are not necessarly acceptable to the user. The user
should use IPATCH/WRITE to edit the CP entry.

-------------------------------------------------------------------------------

EXAMPLES

$ IFROMTEXT
_Text-File: TST1/LOG 
_IFF-File: TST1
%LSLLIB-I-IFFOPENED, DUA0:[BUREAU]TST1.IFF;2 opened for write
%IFROM-I-OPTXT, text file DUA0:[BUREAU]TST1.TXT;0 opened for input
%IFROM-W-ILLEGCUST, wrong customer in MH entry near line 5
%IFROM-I-REMMHDEF, remainder of MH entry defaulted
%IFROM-I-SKIPPING, skipping to next entry
%IFROM-I-LAYWRT, layer 1 written
%IFROM-I-LAYWRT, layer 88 written
%IFROM-I-LAYWRT, layer 66 written
%IFROM-I-LAYWRT, layer 55 written
%IFROM-I-LAYWRT, layer 44 written
%IFROM-I-LAYWRT, layer 11 written
 ELAPSED: 00:00:37.02  CPU: 0:00:08.92  BUFIO: 6  DIRIO: 199  FAULTS: 335 
$

$ IFROMTEXT RRROM.TXT/LOG ROM.IFF %LSLLIB-I-IFFOPENED, DUA0:[BUREAU]RRROM.IFF;1 opened for write %IFROM-I-OPTXT, text file DUA0:[BUREAU]RRROM.TXT;0 opened for input %IFROM-W-ILLEGRAIGN, illegal RA entry ignored at line 1 %IFROM-I-SKIPPING, skipping to next entry %IFROM-I-LAYWRT, layer 1 written %IFROM-I-LAYWRT, layer 11 written %IFROM-I-CALCRAOUT, calculated RA entry written to IFF file ELAPSED: 00:01:10.77 CPU: 0:00:16.93 BUFIO: 6 DIRIO: 252 FAULTS: 324 $

$ IFROMTEXT SYS$INPUT: TSTSYS IFF entry> NO 1 %IFROM-I-RADEFAULT, RA entry defaulted %IFROM-I-MHDEFAULT, MH entry defaulted %IFROM-I-MD2DEFAULT, type 2 MD entry defaulted %IFROM-I-NSDEFAULT, NS entry defaulted %IFROM-I-CCDEFAULT, CC entry defaulted %IFROM-I-CPDEFAULT, CP entry defaulted IFF entry> NO 1 IFF entry> NF 1 1 IFF entry> ST 1 0 IFF entry> 23.3 56.7 IFF entry> EF IFF entry> EO IFF entry> %IFROM-I-EOFEJDEF, end-of-file detected - EJ entry defaulted %IFROM-I-EMDEFAULT, EM entry defaulted %IFROM-I-CALCRAOUT, calculated RA entry written to IFF file ELAPSED: 00:02:04.09 CPU: 0:00:03.47 BUFIO: 4 DIRIO: 133 FAULTS: 189 $

See ifromtextmsg.html generated from IFROMTEXTMSG.RNO.