annotate docs/nitros9guide/display.appendix @ 2553:c5fc5e46b425

added MIDI device to becker boot
author aaronwolfe
date Wed, 16 Jun 2010 19:55:26 +0000
parents b00cf13c9f61
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1014
diff changeset
1 <appendix id="video-display">
1011
cc153d1671f7 Updated for new manuals
boisy
parents: 648
diff changeset
2 <title>VDG Display System Functions</title>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
3
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
4 <section>
1011
cc153d1671f7 Updated for new manuals
boisy
parents: 648
diff changeset
5 <title>The Video Display Generator</title>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
6 <para>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
7 NitrOS-9 allows the VDG display to be used in
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
8 alphanumeric, semigraphic, and graphics modes. There are many
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
9 built-in functions to control the display, which are activated by
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
10 used of various ASCII control character. Thus, these functions are
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
11 available for use by software written in any language using standard
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
12 output statements (such as &quot;PRINT&quot; in BASIC). The Color Computer's Basic09
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
13 language has a Graphics Interface Module that can automatically
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
14 generate these codes using Basic09 RUN statements.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
15 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
16 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
17 The display system has two display modes: Alphanumeric
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
18 (&quot;Alpha&quot;) mode and Graphics mode. The Alphanumeric mode also
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
19 includes &quot;semigraphic&quot; box-graphics. The Color Computer's display
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
20 system uses a separate - memory area for each display mode so
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
21 operations on the Alpha display do not affect the Graphics display,
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
22 and visa-versa. Either display can be selected under software
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
23 control.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
24 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
25 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
26 8-bit characters sent to the display system are interpreted
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
27 according to their numerical value, as shown in the chart below.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
28 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
29
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
30 <informaltable frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
31 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
32 <colspec colwidth="2in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
33 <colspec colwidth="3in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
34 <thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
35 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
36 <entry>Character Range (Hex)</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
37 <entry>Mode/Used For</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
38 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
39 </thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
40 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
41 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
42 <entry>00 - 0E</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
43 <entry>Alpha Mode - cursor and screen control</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
44 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
45 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
46 <entry>0F - 1B</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
47 <entry>Graphics Mode - drawing and screen control</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
48 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
49 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
50 <entry>1C - 20</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
51 <entry>Not used</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
52 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
53 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
54 <entry>20 - SF</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
55 <entry>Alpha Mode - upper case characters</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
56 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
57 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
58 <entry>60 - 7F</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
59 <entry>Alpha Mode - lower case characters</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
60 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
61 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
62 <entry>80 - FF</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
63 <entry>Alpha Mode - Semigraphic patterns</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
64 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
65 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
66 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
67 </informaltable>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
68
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
69
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
70 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
71 The graphics and alphanumeric functions are handled by the OS-9
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
72 device driver module called &quot;CCIO&quot;.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
73 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
74 </section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
75 <section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
76 <title>Alpha Mode Display</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
77 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
78 This is the &quot;standard&quot; operational mode. It is used to display
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
79 alphanumeric characters and semigraphic box graphics, and simulates
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
80 the operation of a typical computer terminal with functions for
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
81 scrolling, cursor positioning, clear screen, line delete, etc.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
82 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
83 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
84 Each 8-bit character is assumed to be an ASCII character and is
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
85 displayed if its high order bit (sign bit) is cleared. Lower case
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
86 letters are displayed in reverse video. If the high order bit of
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
87 the character is set it is assumed to be a &quot;Semigraphic 6&quot; graphics
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
88 box. See the Color Computer manual for an explanation of semigraphics
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
89 functions.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
90 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
91
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
92 <table frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
93 <title>Alpha Mode Command Codes</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
94 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
95 <colspec colwidth="0.6in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
96 <colspec colwidth="4in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
97 <thead>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
98 <row rowsep="1">
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
99 <entry>Control Code</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
100 <entry>Name/Function</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
101 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
102 </thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
103 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
104 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
105 <entry>01</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
106 <entry>HOME - return cursor to upper left hand corner of screen</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
107 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
108 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
109 <entry>02</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
110 <entry>CURSOR XY - move cursor to character X of line Y. The
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
111 binary value minus 32 of the two characters following
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
112 the control character are used as the X and Y
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
113 coordinates. For example, to position the cursor at character 5 of line 10,
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
114 you must give X=37 and Y42</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
115 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
116 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
117 <entry>03</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
118 <entry>ERASE LINE - erases all characters on the cursor's line.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
119 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
120 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
121 <entry>06</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
122 <entry>CURSOR RIGHT - move cursor right one character position</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
123 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
124 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
125 <entry>08</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
126 <entry>CURSOR LEFT - move cursor left one character position</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
127 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
128 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
129 <entry>09</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
130 <entry>CURSOR UP - move cursor up one line</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
131 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
132 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
133 <entry>10</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
134 <entry>CURSOR DOWN (linefeed) move cursor down one line</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
135 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
136 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
137 <entry>12</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
138 <entry>CLEAR SCREEN - erase entire screen and home cursor</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
139 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
140 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
141 <entry>13</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
142 <entry>RETURN - return cursor to leftmost character of line</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
143 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
144 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
145
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
146 <entry>14</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
147 <entry>DISPLAY ALPHA - switch screen from graphic mode to alpha
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
148 numeric mode</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
149 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
150 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
151 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
152 </table>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
153
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
154 </section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
155 <section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
156 <title>Graphics Mode Display</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
157 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
158 This mode is used to display high-resolution 2- or 4-color
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
159 graphics, and it includes commands to: set color; plot and erase
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
160 individual points; draw and erase lines; position the graphics
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
161 cursor; and draw circles.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
162 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
163 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
164 The DISPLAY GRAPHICS command must be executed before any other
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
165 graphics mode command is used. It causes the graphics screen to be
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
166 displayed and sets a current display format and color. The Li.u.t
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
167 time the DISPLAY GRAPHICS command is given, a 6144 byte display
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
168 memory is allocated by OS-9, so there must be at least this much
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
169 continuous free memory available (the OS-9 &quot;MFREE&quot; command can be
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
170 used to check free memory). This memory is retained until the END
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
171 GRAPHICS command is given, even if the program that initiated
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
172 Graphics mode finishes, so it important that the END GRAPHICS
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
173 command be used to give up the display memory when Graphics mode is
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
174 no longer needed.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
175 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
176 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
177 Graphics mode supports two basic formats: Two-Color which has
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
178 256 horizontal by 192 vertical points (G6R mode); and Four Color
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
179 which has 128 horizontal by 192 vertical points (G6C mode). Two
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
180 color sets are available in either mode. Regardless of the
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
181 resolution of the format selected, all Graphics mode commands use a
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
182 256 by 192 point coordinate system. The X and Y coordinates are
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
183 always positive numbers which assume that point 0,0 is the lower
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
184 lefthand corner of the screen.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
185 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
186 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
187 An invisible Graphics Cursor is used by many command to reduce
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
188 the amount of output required to generate graphics. This cursor can
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
189 be explicitly set to any point using the SET GRAPHICS CURSOR
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
190 command. Also, all other commands that include X,Y coordinates
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
191 (such as SET POINT) move the graphics cursor to the specified
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
192 position.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
193 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
194 <table frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
195 <title>Graphics Mode Selection Codes</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
196 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
197 <colspec colwidth="1in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
198 <colspec colwidth="3in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
199 <thead>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
200 <row rowsep="1">
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
201 <entry>Code</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
202 <entry>Format</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
203 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
204 </thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
205 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
206 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
207 <entry>00</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
208 <entry>256 x 192 two-color graphics</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
209 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
210 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
211 <entry>01</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
212 <entry>128 x 192 four-color graphics</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
213 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
214 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
215 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
216 </table>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
217
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
218
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
219 <table frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
220 <title>Color Set and Current Foreground Color Selection Codes</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
221 <tgroup cols="6">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
222 <colspec colname="c1" colwidth="0.5in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
223 <colspec colname="c2" colwidth="0.4in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
224 <colspec colname="c3" colwidth="1in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
225 <colspec colname="c4" colwidth="1in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
226 <colspec colname="c5" colwidth="1in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
227 <colspec colname="c6" colwidth="1in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
228 <thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
229 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
230 <entry align="center" namest="c3" nameend="c4">Two Color Format</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
231 <entry align="center" namest="c5" nameend="c6">Four Color Format</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
232 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
233 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
234 <entry align="center" namest="c2">Char</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
235 <entry namest="c3">Background</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
236 <entry namest="c4">Foreground</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
237 <entry namest="c5">Background</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
238 <entry namest="c6">Foreground</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
239 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
240 </thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
241 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
242 <row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
243 <entry morerows="3" valign="middle">Color Set 1</entry>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
244 <entry align="center">00</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
245 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
246 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
247 <entry align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
248 <entry align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
249 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
250 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
251 <entry align="center">01</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
252 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
253 <entry align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
254 <entry align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
255 <entry align="left">Yellow</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
256 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
257 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
258 <entry align="center">02</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
259 <entry namest="c5" align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
260 <entry align="left">Blue</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
261 </row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
262 <row rowsep="1">
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
263 <entry align="center">03</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
264 <entry namest="c5" align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
265 <entry align="left">Red</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
266 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
267 <row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
268 <entry morerows="3" valign="middle">Color Set 2</entry>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
269 <entry align="center">04</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
270 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
271 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
272 <entry align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
273 <entry align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
274 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
275 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
276 <entry align="center" namest="c2">05</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
277 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
278 <entry align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
279 <entry align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
280 <entry align="left">Cyan</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
281 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
282 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
283 <entry align="center" namest="c2">06</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
284 <entry namest="c5" align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
285 <entry align="left">Magenta</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
286 </row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
287 <row rowsep="1">
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
288 <entry align="center" namest="c2">07</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
289 <entry namest="c5" align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
290 <entry align="left">Orange</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
291 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
292 <row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
293 <entry morerows="3" valign="middle">Color Set 3*</entry>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
294 <entry align="center">08</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
295 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
296 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
297 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
298 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
299 <entry align="center" namest="c2">09</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
300 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
301 <entry align="left">Dark Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
302 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
303 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
304 <entry align="center" namest="c2">10</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
305 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
306 <entry align="left">Med. Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
307 </row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
308 <row rowsep="1">
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
309 <entry align="center" namest="c2">11</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
310 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
311 <entry align="left">Light Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
312 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
313 <row>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
314 <entry morerows="3" valign="middle">Color Set 4*</entry>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
315 <entry align="center">12</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
316 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
317 <entry align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
318 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
319 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
320 <entry align="center" namest="c2">13</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
321 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
322 <entry align="left">Green</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
323 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
324 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
325 <entry align="center" namest="c2">14</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
326 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
327 <entry align="left">Red</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
328 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
329 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
330 <entry align="center" namest="c2">15</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
331 <entry namest="c5" align="left">Black</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
332 <entry align="left">Buff</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
333 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
334 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
335 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
336 </table>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
337
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
338 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
339 * Color sets 3 and 4 not available on PAL video system (European)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
340 models. These color sets work only with NTSC (U.S., Canada, Japan)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
341 models.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
342 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
343
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
344 <table frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
345 <title>Graphics Mode Control Commands</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
346 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
347 <colspec colname="c1" colwidth="0.8in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
348 <colspec colname="c1" colwidth="4in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
349 <thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
350 <row rowsep="1">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
351 <entry>Control Code</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
352 <entry>Name/Function</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
353 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
354 </thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
355 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
356 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
357 <entry>15</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
358 <entry>DISPLAY GRAPHICS - switches screen to graphics mode.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
359 This command must be given before any other
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
360 graphics commands are used. The first time this command
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
361 is given, a 6K byte display buffer is assigned. If 6K of
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
362 contiguous memory is not available an error is returned.
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
363 This command is followed by two characters which specify
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
364 the graphics mode and current color/color set, respectively.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
365 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
366 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
367 <entry>16</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
368 <entry>PRESET SCREEN - presets entire screen to color code
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
369 passed in next character.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
370 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
371 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
372 <entry>17</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
373 <entry>SET COLOR - selects foreground color (and color set)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
374 passed in next character, but does not change graphics
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
375 mode.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
376 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
377 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
378 <entry>18</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
379 <entry>QUIT GRAPHICS - disables graphics mode and returns the
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
380 6K byte graphics memory area to OS-9 for other use, and
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
381 switches to alpha mode.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
382 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
383 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
384 <entry>19</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
385 <entry>ERASE GRAPHICS - erases all points to background color
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
386 and homes graphics cursor to the desired position.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
387 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
388 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
389 <entry>20</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
390 <entry>HOME GRAPHICS CURSOR - moves graphics cursor to coordinates
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
391 0,0 (lower left hand corner).</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
392 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
393 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
394 <entry>21</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
395 <entry>SET GRAPHICS CURSOR - moves graphics cursor to given
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
396 coordinates X,Y. The binary value of the two characters that immediately
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
397 follow are used as the X and Y values, respectively.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
398 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
399 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
400 <entry>22</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
401 <entry>DRAW LINE - draws a line of the current foreground
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
402 color from the current graphics cursor position to the
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
403 given X,Y coordinates. The binary value of the two
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
404 characters that immediately follow are used as the X
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
405 and Y values, respectively. The graphics cursor is
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
406 moved to the end point of the line.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
407 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
408 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
409 <entry>23</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
410 <entry>ERASE LINE - same as DRAW LINE except the line is
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
411 &quot;drawn&quot; in the current background color, thus erasing
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
412 the line.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
413 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
414 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
415 <entry>24</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
416 <entry>SET POINT - sets the pixel-at point X,Y to the current
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
417 foreground color. The binary value of the two
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
418 characters that immediately follow are used as the x
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
419 and Y values, respectively. The graphics cursor is
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
420 moved to the point Set.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
421 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
422 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
423 <entry>25</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
424 <entry>ERASE POINT - same as DRAW POINT except the point is
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
425 &quot;drawn&quot; in the current background color, thus erasing
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
426 the point.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
427 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
428 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
429 <entry>26</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
430 <entry>DRAW CIRCLE - draws a circle of the current foreground
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
431 color with its center at the current graphics cursor
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
432 position using a radius R which is obtained using the
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
433 binary value of the next character. The graphics
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
434 cursor position is not affected by this command.</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
435 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
436 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
437 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
438 </table>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
439
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
440 </section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
441 <section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
442 <title>Get Status Commands</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
443 <para>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
444 The Color Computer I/O driver includes OS-9 Get Status
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
445 commands that return the display status and joystick values,
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
446 respectively. These are accessable via the Basic09 Graphics
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
447 Interface Module, or by the assembly language system calls listed
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
448 below:
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
449 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
450 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
451 GET DISPLAY STATUS:
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
452 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
453 <informaltable frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
454 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
455 <colspec colwidth="2in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
456 <colspec colwidth="3in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
457 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
458 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
459 <entry>Calling Format</entry>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
460 <entry><literallayout class="monospaced">lda #1 (path number)
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
461 ldb #SS.DStat (Getstat code $12)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
462 os9 I$GSTT call OS-9</literallayout></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
463 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
464 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
465 <entry>Passed</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
466 <entry>nothing</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
467 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
468 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
469 <entry>Returns</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
470 <entry><literallayout>X = address of graphics display memory
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
471 Y = graphics cursor address x=MSB y =LSB
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
472 A = color code of pixel at cursor address</literallayout></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
473 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
474 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
475 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
476 </informaltable>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
477 <para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
478 GET JOYSTICK VALUES:
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
479 </para>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
480 <informaltable frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
481 <tgroup cols="2">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
482 <colspec colwidth="2in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
483 <colspec colwidth="3in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
484 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
485 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
486 <entry>Calling Format</entry>
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
487 <entry><literallayout class="monospaced">lda #1 (path number)
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
488 ldb #SS.Joy (Getstat code $13)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
489 os9 I$GSTT call OS-9</literallayout></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
490 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
491 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
492 <entry>Passed</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
493 <entry>X = 0 for right joystick; 1 for left joystick</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
494 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
495 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
496 <entry>Returns</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
497 <entry><literallayout>X = selected joystick x value (0-63)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
498 Y = selected joystick y value (0-63)
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
499 A = $FF if fire button on; $00 if off</literallayout></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
500 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
501 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
502 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
503 </informaltable>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
504
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
505 <table frame="none">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
506 <title>Display Control Codes Condensed Summary</title>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
507 <tgroup cols="4">
648
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
508 <colspec colwidth="0.9in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
509 <colspec colwidth="0.9in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
510 <colspec colwidth="0.9in"/>
f9c66ad345d1 XMLified.
roug
parents: 149
diff changeset
511 <colspec colwidth="2.5in"/>
146
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
512 <thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
513 <row rowsep="1">
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
514 <entry>1st Byte</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
515 <entry>2nd Byte</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
516 <entry>3rd Byte</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
517 <entry>Function</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
518 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
519 </thead>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
520 <tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
521 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
522 <entry>00</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
523 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
524 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
525 <entry>Null</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
526 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
527 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
528 <entry>01</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
529 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
530 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
531 <entry>Home Alpha Cursor</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
532 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
533 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
534 <entry>02</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
535 <entry>Column+32</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
536 <entry>Row+32</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
537 <entry>Position Alpha Cursor</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
538 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
539 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
540 <entry>03</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
541 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
542 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
543 <entry>Erase Line</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
544 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
545 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
546 <entry>06</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
547 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
548 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
549 <entry>Cursor Right</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
550 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
551 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
552 <entry>08</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
553 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
554 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
555 <entry>Cursor Left</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
556 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
557 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
558 <entry>09</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
559 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
560 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
561 <entry>Cursor Up</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
562 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
563 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
564 <entry>10</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
565 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
566 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
567 <entry>Cursor Down</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
568 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
569 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
570 <entry>12</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
571 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
572 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
573 <entry>Clear Screen</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
574 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
575 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
576 <entry>13</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
577 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
578 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
579 <entry>Carriage Return</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
580 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
581 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
582 <entry>14</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
583 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
584 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
585 <entry>Select Alpha Mode</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
586 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
587 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
588 <entry>15</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
589 <entry>Mode</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
590 <entry>Color Code</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
591 <entry>Select Graphics Mode</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
592 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
593 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
594 <entry>16</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
595 <entry>Color Code</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
596 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
597 <entry>Preset Screen</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
598 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
599 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
600 <entry>17</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
601 <entry>Color Code</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
602 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
603 <entry>Select Color</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
604 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
605 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
606 <entry>18</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
607 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
608 <entry>Quit Graphics Mode</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
609 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
610 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
611 <entry>19</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
612 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
613 <entry>Erase Screen</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
614 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
615 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
616 <entry>20</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
617 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
618 <entry>Home Graphics Cursor</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
619 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
620 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
621 <entry>21</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
622 <entry>X Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
623 <entry>Y Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
624 <entry>Move Graphics Cursor</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
625 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
626 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
627 <entry>22</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
628 <entry>X Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
629 <entry>Y Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
630 <entry>Draw Line to X/Y</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
631 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
632 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
633 <entry>23</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
634 <entry>X Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
635 <entry>Y Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
636 <entry>Erase Line to X/Y</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
637 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
638 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
639 <entry>24</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
640 <entry>X Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
641 <entry>Y Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
642 <entry>Set Point at X/Y</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
643 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
644 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
645 <entry>25</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
646 <entry>X Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
647 <entry>Y Coord</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
648 <entry>Clear Point at X/Y</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
649 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
650 <row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
651 <entry>26</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
652 <entry>Radius</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
653 <entry></entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
654 <entry>Draw Circle</entry>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
655 </row>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
656 </tbody>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
657 </tgroup>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
658 </table>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
659
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
660 </section>
88ae6ed51be6 More splitups.
roug
parents:
diff changeset
661 </appendix>