The TEXTFILE Statement
- Last UpdatedJan 07, 2026
- 2 minute read
TEXTFILE,<txf_name>,<file_name>
[/INTERLINESPACE=<intlin_space>]
[/POSLINES=(<start_pnt>,<first_line>,<last_line>)]
[/TEXTANGLE=<text_ang>]
[/TEXTHEIGHT=<text_hgt>]
[/TEXTFONT=<text_fnt>];
<txf_name> is the name of the text file variable and has the type TEXTFILE_2D. The maximum length of <txf_name> is 32 characters.
<file_name> is the name of the file from where the text is fetched. It has the type STRING.
INTERLINESPACE=<intlin_space>
<intlin_space> is the factor for the interline space. The interline space is defined as the factor * the text height. It has the type DECIMAL. The default factor is 1.5.
POSLINES=(<start_pnt>,<first_line>,<last_line>)
<start_pnt> is the origin of the first text line and the lower left corner of that line. It has the type POINT_2D.
<first_line> is the number of the first line to be presented. It has the type INTEGER.
<last_line> is the number of the last line to be presented. It has the type INTEGER.
TEXTANGLE=<text_ang>
<text_ang> is the text angle and has the type DECIMAL. The default angle is 0.0 but the text angle can be changed with this attribute.
TEXTHEIGHT=<text_hgt>
<text_hgt> is the next height and has the type DECIMAL. The text is given a default height value but the text height can be changed with this attribute.
TEXTFONT=<text_fnt>
<text_fnt> is the text font and has the type INTEGER. Available font numbers are 0-99. The default font number is 0.
It is possible to give both absolute and relative values of the lines to be presented. This is illustrated by the following examples:
/POSLINES=(P1,1,15) lines 1 to 15
/POSLINES=(P1,10,) next 10 lines (16 to 25)
/POSLINES=(P1,20,) next 20 lines (26 to 45)
/POSLINES=(P1,,10) previous 10 lines (16 to 25)
/POSLINES=(P1,,) the whole file
Structure:
|
FILENAME |
(STRING) |
||
|
ANGLE |
(DECIMAL) |
||
|
HEIGHT |
(DECIMAL) |
||
|
ILSP |
(DECIMAL) |
||
|
NDATA |
(INTEGER) |
||
|
DATA(1:NDATA) |
|||
|
PNT(1:2) |
(DECIMAL) |
||
|
FIRST |
(INTEGER) |
||
|
LAST |
(INTEGER) |
||
|
Example: |
|||
|
GET/STRUCTURE=(F,<txf_name>,'FILENAME' |
|||
|
/STRUCTURE=(A,<txf_name>,'ANGLE') |
|||
|
/STRUCTURE=(H,<txf_name>,'HEIGHT') |
|||
|
/STRUCTURE=(I,<txf_name>,'ILSP') |
|||
|
/STRUCTURE=(N,<txf_name>,'NDATA') |
|||
|
/STRUCTURE=(X,<txf_name>,'PNT',N,1) |
|||
|
/STRUCTURE=(S,<txf_name>,'FIRST',N) |
|||
|
/STRUCTURE=(E,<txf_name>,'LAST',N); |
|||