annotate docs/nitros9guide/go51.refentry @ 1093:4dae346c4969

Added crossreferences and lowercased synopsises
author roug
date Mon, 07 Apr 2003 21:01:46 +0000
parents b5ff125a1d60
children b00cf13c9f61
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
1 <refentry id="go51">
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
2 <refnamediv>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
3 <refname>GO51</refname>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
4 <refpurpose>The 51 Column by 24 Line Video Display</refpurpose>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
5 </refnamediv>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
6
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
7 <refsynopsisdiv>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>go51</command>
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
10 </cmdsynopsis>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
11 </refsynopsisdiv>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
12
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
13 <refsect1><title>Description</title>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
14 <para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
15 An alternative video screen device driver, which provides a 51
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
16 column by 24 line display with upper and lower case character sets,
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
17 can be incorporated into OS-9 with the command:
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
18 <screen>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
19 GO51
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
20 </screen>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
21 This command replaces the normal text screen driver with one that
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
22 uses high resolution graphics to &quot;draw&quot; the characters. As there
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
23 are fewer pixels (dots) per character in this mode more characters
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
24 can be displayed on the screen, albeit with some loss of character
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
25 definition.
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
26 </para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
27 <para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
28 Note, however, that the use of a high resolution graphics page
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
29 means that an extra 6K bytes will be needed in this mode. This
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
30 extra memory requirement is not normally a problem but in memory-critical
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
31 applications, such as the C and Pascal compilers, the user
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 648
diff changeset
32 can simply avoid the use of <command>go51</command>.
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
33 </para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
34 <para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
35 This mode of display has a set of <emphasis>escape sequences</emphasis>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
36 (commands) to
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
37 emulate commercial data terminals. In addition to the video screen
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 648
diff changeset
38 driver, <command>go51</command> provides a new keyboard driver which features auto-repeat.
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
39 The keyboard code allocation is the same as described in
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
40 section <xref linkend="sec2.4.3"/> and <xref linkend="key-definitions"/>
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
41 </para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
42 </refsect1>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
43 <refsect1>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
44 <title>The GO51 Display Functions</title>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
45 <para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
46 Like the normal 32 by 16 video display functions described in
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
47 <xref linkend="video-display"/>
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
48 the 51 by 24 mode provides many built in facilities to
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
49 control the display. These functions are activated by the use of
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
50 the various escape sequences and control characters described below:
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
51 </para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
52 <informaltable frame="none">
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
53 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 159
diff changeset
54 <colspec colwidth="1.5in"/>
f9c66ad345d1 XMLified.
roug
parents: 159
diff changeset
55 <colspec colwidth="3.5in"/>
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
56 <thead>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
57 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
58 <entry>Escape Sequence (Hex)</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
59 <entry>Name/Function</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
60 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
61 </thead>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
62
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
63 <tbody>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
64 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
65 <entry>1B 41 X Y</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
66 <entry>CURSOR XY - move cursor to column X(0-50)
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
67 and Y(0-23) where X and Y are single byte values.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
68 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
69 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
70 <entry>1B 42</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
71 <entry>CLEAR EOL - clear from cursor to the end of
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
72 line. Cursor position remains unchanged.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
73 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
74 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
75 <entry>1B 43</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
76 <entry>CURSOR RIGHT - move cursor right by one character position.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
77 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
78 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
79 <entry>1B 44</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
80 <entry>CURSOR UP - move cursor up by one line.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
81 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
82 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
83 <entry>1B 45</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
84 <entry>CURSOR DOWN - move cursor down one line.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
85 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
86 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
87 <entry>1B 46</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
88 <entry>REVERSE ON - turn reverse field on.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
89 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
90 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
91 <entry>1B 47</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
92 <entry>REVERSE OFF - turn reverse field off.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
93 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
94 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
95 <entry>1B 48</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
96 <entry>UNDERLINE ON - turn underline on.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
97 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
98 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
99 <entry>1B 49</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
100 <entry>UNDERLINE OFF - turn underline off.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
101 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
102 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
103 <entry>1B 4A</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
104 <entry>CLEAR EOS - clear from cursor to end of
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
105 screen. Cursor position remains unchanged.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
106 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
107 </tbody>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
108 </tgroup>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
109 </informaltable>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
110
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
111
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
112
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
113
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
114 <informaltable frame="none">
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
115 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 159
diff changeset
116 <colspec colwidth="1.5in"/>
f9c66ad345d1 XMLified.
roug
parents: 159
diff changeset
117 <colspec colwidth="3.5in"/>
159
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
118 <thead>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
119 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
120 <entry>Control Character (Hex)</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
121 <entry>Name/Function</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
122 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
123 </thead>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
124 <tbody>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
125 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
126 <entry>07</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
127 <entry>BELL - generates a short audible tone.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
128 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
129 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
130 <entry>08</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
131 <entry>BACKSPACE (CURSOR LEFT) - moves cursor left one character position.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
132 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
133 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
134 <entry>0A</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
135 <entry>LINE FEED - move cursor down by one line.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
136 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
137 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
138 <entry>0B</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
139 <entry>CURSOR HOME - move cursor to home position 0,0 (top left).</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
140 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
141 <row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
142 <entry>0C</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
143 <entry>CLEAR SCREEN - clears the screen and home cursor.</entry>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
144 </row>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
145 </tbody>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
146 </tgroup>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
147 </informaltable>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
148 <note><para>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
149 The GO51 device driver is only available on Dragon Computers.
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
150 </para></note>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
151 </refsect1>
828d64d27e63 Changed go51 from an appendix to a refentry
roug
parents:
diff changeset
152 </refentry>