Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.2.9  The OUT file format                                         TOS

The OUT format was developed by Digital Research and, like the XIMG or 
metafile format permits data exchange between any GEM applications. 
More exactly, it permits control characters for text attributes to be 
written to a file with the suffix ".out", which are then recognized 
and taken into account by the output driver.

This makes the OUT format particularly well suited for exchanging text 
files with attributes between various applications. OUT files are 
nothing more than ASCII files, which use the control code DC2 (ASCII 
value 18) for switching between text attributes; this is followed by a 
letter that describes the switching on or off of the attribute:

Following control characters are defined:

 Code   Meaning 
 DC2 0  Bold on 
 DC2 1  Bold off 
 DC2 2  Italic on 
 DC2 3  Italic off 
 DC2 4  Underlined on 
 DC2 5  Underlined off 
 DC2 6  Superscript on 
 DC2 7  Superscript off 
 DC2 8  Subscript on 
 DC2 9  Subscript off 
 DC2 A  NLQ mode on 
 DC2 B  NLQ mode off 
 DC2 C  Expanded on 
 DC2 D  Expanded off 
 DC2 E  Light on 
 DC2 F  Light off 
 DC2 G 
 : 
 : 
 DC2 V  Reserved, is ignored 
 DC2 W  Pica font (10 cpi) 
 DC2 X  Elite font (12 cpi) 
 DC2 Y  Condensed print 
 DC2 Z  Proportional print 

Note: Naturally one can also incorporate graphics in the output file; 
the syntax in this case runs:

(ESC)(ESC)GEM,x,y,w,h,C:\pathname\filename.img

The parameters x,y,w and h here are to be specified in character units 
relative to the current cursor position.

See also: GDOS drivers   v_alpha_text   XIMG format   Metafile format