ATR: chpt.15: Display Lists
From: Doug Wokoun (aa384)
Date: 01/02/90-06:55:30 PM Z
From: aa384 (Doug Wokoun)
Subject: ATR: chpt.15: Display Lists
Date: Tue Jan 2 18:55:30 1990
CHAPTER 15
DISPLAY LISTS
[some of this file was lost...]
chip also has a memory scan counter. This register scans the display
buffer for data to be interpreted and displayed. Once loaded, the
memory scan counter's 4 most significant bits are fixed. The result
is that the memory scan counter cannot cross a 4K memory boundary
(i.e. $AFFF to $B000) without being reloaded.
DISPLAY LIST INSTRUCTIONS
There are three basic instructions in the display list. The type of
instruction is determined by bits 0,1,2 and 3 of an instruction byte.
The other four bits give auxilliary parameters for the instruction.
Bit 7 always enables a display list interrupts (DLIs).
Display list instruction format
7 6 5 4 3 2 1 0
-----------------
|I|n|n|n|0|0|0|0|
-----------------
\ / \ /
--- ------
| |
| 0 = display blank lines
|
0-7 = number of blank lines (1-8)
7 6 5 4 3 2 1 0
-----------------
|I|W| | |0|0|0|1|
-----------------
| \ /
| ------
| |
| 1 = jump (3 byte instruction)
|
0 = jump and display one blank line
1 = jump and wait for vertical blank
7 6 5 4 3 2 1 0
-----------------
|I|R|H|V|M|M|M|M|
-----------------
| | | | \ /
| | | | ------
| | | | |
| | | | 2-F = display one line of graphics in
| | | | ANTIC mode 2-F
| | | 1 = horizontal scroll enabled
| | |
| | 1 = vertical scroll enabled
| |
| 1 = reload memory scan counter with next two bytes
|
1 = display list interrupt, all instructions
In the display instruction, the ANTIC mode is different from the CIO
graphics mode. However, each CIO graphics mode uses a particular
ANTIC mode. Below are descriptions of the ANTIC modes with their
associated graphics (CIO) modes.
ANTIC MODE 2 (Graphics 0)
Uses 8 pixel by 8 pixel characters, 40 characters horizontal, 8 TV
scan lines vertical. Only one color can be displayed at a time.
ANTIC MODE 3
8 X 10 pixel, Graphics 0 type characters. This mode requires a custom
character set. The advantage is that it allows true decenders. The
custom C-set is still 8 X 8 pixels. Lower-case letters with decenders
have the bottom row of pixels put on the top row.
Lower-case "y" for ANTIC mode 3
C-set Display
---------- ----------
| XXXXX | | |
| | | |
| | | |
| XX XX | | XX XX |
| XX XX | | XX XX |
| XX XX | | XX XX |
| XXXXX | | XXXXX |
| XX | | XX |
---------- | XXXXX |
| |
----------
ANTIC MODE 4 (graphics 12 on XL and XE)
This mode has characters the same size as graphics 0. However, the
characters are only 4 X 8 pixels. This gives only half the horizontal
resolution of graphics 0. The advantage is that up to four colors of
"graphics 0" characters can be displayed at once. This mode also
requires a custom C-set. Below is a comparison of the normal C-set to
one which works with the ANTIC 4 mode.
Upper-case "A" for ANTIC modes 2 and 4
mode 2 mode 4
---------- ----------
| | | |
| XX | | yy |
| XXXX | | yy |
| XX XX | |xx zz |
| XX XX | |xx zz |
| XXXXXX | |xxyyzz |
| XX XX | |xx zz |
| | | |
---------- ----------
xx, yy and zz represent two bit binary numbers, controlling one pixel
each. These numbers determine which color register a pixel is
assigned to: (COLOR0, COLOR1, COLOR2 or COLOR3).
ANTIC mode 5
Antic mode five is identical to ANTIC mode 4 except the characters are
displayed twice as tall. This makes only 12 lines on the screen.
ANTIC MODE 6 (Graphics 1)
This mode uses 8 X 8 pixel characters except they are displayed twice
as wide as in ANTIC mode 2. There are 3 colors available at once but
only one case (upper or lower) can be displayed at a time. The data
base variable CHBAS [$02F4 (756)] controls the character, [$E0 (224) =
upper-case, $E2 (226) = lower-case]
The color/character is controlled by either the color statement or the
ATASCII number of the character printed. Control characters are
controlled by COLOR0, upper-case characters by COLOR1 and lower-case
characters by COLOR2. Remember that all characters print as
upper-case alpha characters, but of different colors.
ANTIC MODE 7 (Graphics 2)
This mode is identical to mode 6 except the characters are displayed
twice as tall. This results in only 12 lines possible on the screen.
ANTIC MODE 8 (Graphics 3)
This is the first graphics (non-character) mode. This mode, as other
non-character graphics modes do, uses data in the display buffer as a
bit map to be displayed.
A command to display in mode 8 will cause the ANTIC chip to read the
next 10 bytes in the display buffer. Each pair of bits will control
one pixel as in mode 4. However, the pixels are blocks the same size
as a Graphics 0 (ANTIC 2) characters.
ANTIC MODE 9 (Graphics 4)
This is similar to ANTIC mode 8 except each byte controls 8 pixels
(instead of 4) and only one color can be displayed at a time. The
pixels are also half the size of those in ANTIC mode 8.
ANTIC MODE A (Graphics 5)
This mode uses 20 bytes per line/command. As in ANTIC mode 8, each
pair of bits controls one pixel. The result is that the pixels are
the same size as in ANTIC mode 9 but four colors can be displayed at
once.
ANTIC MODE B (Graphics 6)
As in mode A, there are 8 pixels per byte and only one color. The
pixels are half the size as in mode A.
ANTIC MODE C
Like mode B except the pixels are half as tall (only one T.V. line).
ANTIC MODE D (Graphics 7)
40 Bytes per line, each byte controls 4 pixels. The pixels are 1/4 as
large as in ANTIC mode 8 (Graphics 3).
ANTIC MODE E (Graphics 15 on XL and XE)
Like mode D except the pixels are half as tall (one T.V. line). Antic
mode E is sometimes called Graphics 7.5
ANTIC mode F (Graphics 8, 9, 10 and 11)
This is the highest resolution mode. Pixels are 1/8 the size of ANTIC
mode 8 or mode 2 characters. It uses 40 bytes per line, each byte
controlling 8 pixels, unless the GTIA chip intervenes. Only one color
can be displayed at a time.
DISPLAY LIST EXAMPLES
When CIO opens a channel to the screen, it sets up the proper display
list for the ANTIC chip. The following are the things CIO must handle
when setting up the display list.
Display list duties as used by CIO
display a certain number of blank lines at the top of the screen.
Load the memory scan counter with the address of the display data
buffer.
Display the required number of lines in the required ANTIC mode.
Set up a jump instruction if the display list crosses a 1K memory
boundary.
Set up a reload-memory-scan-counter instruction if the display data
buffer crosses a 4K memory boundary.
CIO assumes that the display data buffer will butt against an 8K
memory boundary. If a program causes the display buffer to cross a 4K
boundary (by changing RAMTOP [$006A (106)] to point to an address
which is not at an 8K boundary) the screen will be scrambled. This is
not usually a problem if the graphics mode doesn't require a large
block of memory.
SAMPLE DISPLAY LIST
Below is an example of a Graphics 0 display list as CIO would set it
up.
Display list for Graphics 0
assuming BASIC starts at $A000
address instruction explanation
Dec. Hex.
$9C20 112 $70 \
112 $70 >---- 24 blank lines (8 each command)
112 $70 /
66 $42 ----- load memory scan counter with
$9C24 64 $40 \__ next two bytes and display one line
156 $9C / \ of ANTIC 2 characters
2 $02 -\ |
2 $02 | \- address of display data buffer
2 $02 |
2 $02 \--- 2nd ANTIC 2 instruction
- ---
2 $02 ----- 24th ANTIC 2 instruction
65 $41 \
32 $20 >---- jump back to start of list
156 $9C /
$9C40 ??? ?? first byte of display data buffer
--- --
$9FFF ??? ?? last byte of buffer
$A000 start of ROM
A display list for a higher resolution graphics mode would require
more instructions and might cross a 1K boundary. It would then
include a jump instruction to cross the boundary.
MULTIPLE DISPLAYS
It is possible to set up multiple displays and use one at a time. The
technique of changing from one display to another is called page
flipping. Below is the simplest way to set up two displays.
setting up two displays
Call a graphics mode through CIO or by using a BASIC GRAPHICS
command.
Store the display list pointers, SDLSTL and SDLSTH, and the CIO screen
pointer, SAVMSC [$0058,2 (88)].
Move the start-of-ROM pointer, RAMTOP [$006A (106)] to below the
current display list. RAMTOP is a one byte pointer so it changes in
increments of one page (256 bytes).
make another graphics call as in the first step.
store the new display list pointer and CIO screen pointer.
This will set up two displays, each with it's own display list. If
the displays are in the same graphics mode, or you will not make any
changes in the displays with CIO commands, (PLOT, PRINT, etc.) you can
flip between the two simply by changing the display list pointer.
If the screens are in the same graphics mode and you want to change
which one to do CIO commands to, Change the CIO screen pointer, SAVMSC
[$0058,2 (88)]. This way, you can display one screen while drawing on
the other.
If you want to do CIO commands to screens of different graphics modes,
you will have the move RAMTOP and do a graphics call to change
screens.
If your manipulation of RAMTOP causes the display data buffer to cross
a 4K boundary, the screen may be scrambled.
DISPLAY LIST INTERRUPTS
DLIs are not used by the operating system. However, other programs
can initiate and use them. Use the following steps to set up display
list interrupts.
Setting up DLIs
Set bit 7 of the display list instruction for the line before you want
the interrupt to occur. (The interrupt routine should set WSYNC and
wait for the next line to execute.)
Set bit 7 of NMIEN [$D40E (54286)] to enable DLIs.
Set the DLI routine vector, VDSLST [$0200,2 (512)] to point to your
machine language DLI routine.
Your DLI routine should set WSYNC [$D40A (54282)]. STA WSYNC will do.
THis will cause the 6502 to wait for the next horizontal sync. This
will keep the DLI routine from changing something in the middle of a
T.V. line.
The DLI routine must end with an RTI instruction.
SCROLLING
Scrolling is controlled by a combination of scroll position registers,
and changing the memory scan counter. Basically, course scrolling is
done by reloading the memory scan counter and fine scrolling is done
by changing the scroll registers.
VERTICAL SCROLLING
Vertical scrolling is very simple. Follow the steps below to set up
vertical scrolling of graphics.
Steps to use vertical scrolling
Set bit 4 of the first byte of the display list instruction for each
line to be scrolled.
Put the number of T.V. lines to offset the graphics vertically in the
vertical scroll register, VSCROL [$D405 (54277)]
The vertical scroll register can offset the graphics upward by 0 - 7
T.V. lines in the 24 line graphics modes (ANTIC modes 2 and 4). In 12
line graphics modes (ANTIC modes 5 and 7) it can vertically offset the
graphics by 0 - 15 T.V. lines. To offset the graphics an 8th (or
16th) line, the scroll register is reset to 0 and the memory scan
counter is reloaded with the address of the next line of graphics in
the display data buffer. If the entire screen is being scrolled, the
load-memory-scan-counter command (near the beginning of the display
list) is changed to point to the address of the second line of
graphics.
HORIZONTAL SCROLLING
Horizontal scrolling works much like vertical scrolling. It is
enabled by setting bit 5 of the instruction for each line to be
scrolled. The horizontal scroll register, HSCROL [$D404 (54276)],
sets the offset. The small difference is that graphics are moved
twice as far per change (two graphics 8 pixels instead of one). Also,
when HSCROL = 0 the graphics are offset beyond the left edge of the
screen by 16 color clocks (32 Graphics 8 pixels). When HSCROL = 15,
the graphics line is shifted one color clock (2 Graphics 8 pixels) to
the left of the screen.
The big difference is that the memory scan counter gets messed up.
This means that you must use a reload-memory-scan-counter command for
each line of graphics. This is a major modification of the display
list. It will require you to move and build the list yourself.
The advantage of this is that you can have a scrolling window in a
large graphics map. The technique is to move the window by reloading
the memory scan counter, then fine scrolling to the invisible bytes
beyond the edges of the screen.
useful data base variables and OS equates
SAVMSC $0058,2 (88): pointer to current screen for CIO commands
RAMTOP $006A (106): start-of-ROM pointer (MSB only)
VDSLST $0200,2 (512): DLI vector
RAMSIZ $02E4 (740): permanent start-of-ROM pointer (MSB only)
DLISTL $D402 (54274): display list pointer low byte
DLISTH $D403 (54275): " high byte
HSCROL $D404 (54276): horizontal scroll register
VSCROL $D405 (54277): vertical scroll register
NMIEN $D40E (54286): NMI enable (DLIs)
Shadow registers
SDLSTL $0230 (560): DLISTL
SDLSTH $0231 (561): DLISTH
--
--
-----------------------------------------
Return to message index
