|
|
| (51 intermediate revisions by 6 users not shown) |
| Line 1: |
Line 1: |
| __TOC__
| | #REDIRECT [[PPU scrolling]] |
| == Preface ==
| |
| "[http://nesdev.org/loopyppu.zip The skinny on NES scrolling]" was posted by loopy on 1999-04-13 to what eventually became the NESdev Yahoo! Group.
| |
| It was the first to publicly tell how exactly how the PPU uses addresses written to [[PPU registers|its ports]].
| |
| After over a decade, it is ''still believed accurate.''
| |
| Some people get turned off by the fact that it's provided as monospaced text inside a zipfile, that addresses have nothing to distinguish them from years, and that the diagrams of what bits get copied where are allegedly difficult to read.
| |
| What follows is this document, reformatted to web standards, with a few minor things made slightly clearer.
| |
| | |
| == PPU registers ==
| |
| | |
| If you aren't trying to split the screen, [[PPU scrolling|scrolling the background]] is as easy as writing the X and Y coordinates to $2005 and writing the high bit of both coordinates to $2000.
| |
| Programming or emulating a game that uses complex raster effects, on the other hand, requires a complete understanding of how the various address registers inside the PPU work.
| |
| Here are the related registers:
| |
| ;v: Current VRAM address (15 bits)
| |
| ;t: Temporary VRAM address (15 bits)
| |
| ;x: Fine X scroll (3 bits)
| |
| ;w: First or second write toggle (1 bit)
| |
| Registers ''v'' and ''t'' are 15 bits, but because emulators commonly store them in 16-bit machine words, they are shown with an extra bit that's never used.
| |
| | |
| The PPU uses the current VRAM address for both reading and writing PPU memory thru $2007, and for fetching nametable data to draw the background.
| |
| As it's drawing the background, it updates the address to point to the nametable data currently being drawn.
| |
| Bits 10-11 hold the base address of the nametable minus $2000.
| |
| Bits 12-14 are the Y offset of a scanline within a tile.
| |
| | |
| == Stuff that affects register contents ==
| |
| | |
| In the following, ''d'' refers to the data written to the port, and ''A'' through ''H'' to individual bits of a value.
| |
| | |
| $2005 and $2006 share a common write toggle, so that the first write has one behaviour, and the second write has another.
| |
| After the second write, the toggle is reset to the first write behaviour. This toggle may be manually reset by reading
| |
| $2002.
| |
| | |
| * $2000 write:
| |
| t: ...BA.. ........ = d: ......BA
| |
| | |
| * $2002 read:
| |
| w: = 0
| |
| | |
| * $2005 first write (''w'' is 0):
| |
| t: ....... ...HGFED = d: HGFED...
| |
| x: CBA = d: .....CBA
| |
| w: = 1
| |
| | |
| * $2005 second write (''w'' is 1):
| |
| t: .....HG FED..... = d: HGFED...
| |
| t: CBA.... ........ = d: .....CBA
| |
| w: = 0
| |
| | |
| * $2006 first write (''w'' is 0):
| |
| t: .FEDCBA ........ = d: ..FEDCBA
| |
| t: G...... ........ = 0
| |
| w: = 1
| |
| | |
| * $2006 second write (''w'' is 1):
| |
| t: ....... HGFEDCBA = d: HGFEDCBA
| |
| v = t
| |
| w: = 0
| |
| | |
| * At dot 250 of each scanline:
| |
| ::If rendering is enabled, the PPU increments the vertical position in ''v''. The effective Y scroll coordinate is incremented, which is a complex operation that will correctly skip the attribute table memory regions, and wrap to the next nametable appropriately. See [[#Wrapping around|Wrapping around]] below.
| |
| | |
| * At dot 256 of each scanline:
| |
| ::If rendering is enabled, the PPU copies all bits related to horizontal position from ''t'' to ''v'':
| |
| v: ....H.. ...EDCBA = t: ....H.. ...EDCBA
| |
| | |
| * At dot 304 of the pre-render scanline (end of vblank):
| |
| ::If rendering is enabled, the PPU copies all bits from ''t'' to ''v'':
| |
| v = t
| |
| | |
| * $2007 writes:
| |
| ::Writes to $2007 will add either 1 or 32 to ''v'' depending on the VRAM increment bit set via $2000. This is not normally useful for scrolling, or done during rendering.
| |
| | |
| | |
| All of this info agrees with the tests Loopy has run on an NES console and Quietust's [[:File:Vramaddr.jpg|analysis of a micrograph of the PPU die]].
| |
| If there's something you don't agree with, please let [http://forums.nesdev.org/viewtopic.php?t=8962 the BBS] know so that a member can verify it.
| |
| | |
| === Explanation ===
| |
| | |
| * The implementation of scrolling has two components. There are two fine offsets, specifying what part of an 8x8 tile each pixel falls on, and two coarse offsets, specifying which tile. Because each tile corresponds to a single byte addressable by the PPU, during rendering the coarse offsets reuse the same VRAM address register (''v'') that is normally used to send and receive data from the PPU. Because of this reuse, the two registers $2005 and $2006 both offer control over ''v'', but $2005 is mapped in a more obscure way, designed specifically to be convenient for scrolling.
| |
| | |
| * $2006 is simply to set the VRAM address register. This is why the second write will immediately set ''v''; it is expected you will immediately use this address to send data to the PPU via $2007. The PPU memory space is only 14 bits wide, but ''v'' has an extra bit that is used for scrolling only. The first write to $2006 will clear this extra bit (uncertain why, would it interfere with the address internally?).
| |
| | |
| * $2005 is designed to set the scroll position before the start of the frame. This is why it does not immediately set ''v'', so that it can be set at precisely the right time to start rendering the screen.
| |
| | |
| * The high 5 bits of the X and Y scroll settings sent to $2005, when combined with the 2 nametable select bits sent to $2000, make a 12 bit address for the next tile to be fetched within the nametable address space $2000-2FFF. If set before the end of vblank, this 12 bit address gets loaded directly into ''v'' precisely when it is needed to fetch the tile for the top left pixel to render.
| |
| | |
| * The low 3 bits of X and Y sent to $2005 are the fine pixel offset within the 8x8 tile. The X component goes into the separate ''x'' register, which just counts pixels until the next tile should be fetched. The Y component goes into the high 3 bits of the ''v'' register, where during rendering they are not used as part of the PPU memory address (which is being overridden to use the nametable space $2000-2FFF). Instead they count the lines until the coarse Y memory address needs to be incremented (and wrapped appropriately when nametable boundaries are crossed).
| |
| | |
| == Wrapping around ==
| |
| | |
| You can think of bits 4-0 of the VRAM address as the "coarse x scroll"(*8) that the PPU increments as it draws.
| |
| As it wraps from 31 to 0, bit 10 is switched.
| |
| You should see how this causes horizontal wrapping between nametables (0,1) and (2,3).
| |
| | |
| You can think of bits 9-5 as the "coarse y scroll"(*8).
| |
| This functions slightly different from the X.
| |
| It wraps to 0 and bit 11 is switched when it's incremented from 29 instead of 31.
| |
| There are some odd side effects from this.
| |
| If you manually set the value above 29 (from either $2005 or $2006), the wrapping from 29 won't happen, and attribute data will be used as nametable data.
| |
| The "y scroll" still wraps to 0 from 31, but without switching bit 11.
| |
| As a result, writing 240+ to 'Y' in $2005 appeared as a negative scroll value.
| |
| | |
| == Examples ==
| |
| | |
| Below is an example of 6502 code that completely sets the scroll register before the next scanline, indicating what happens to all relevant variables described above, both before and after the 6502 instructions are executed.
| |
| | |
| Individual bits written to a PPU register are colour-coded to reflect where they end up in ''t''.
| |
| | |
| Assume all 6502 code is run sequentially in the order shown, one instruction after the next.
| |
| | |
| === single scroll ===
| |
| | |
| If only one scroll setting is needed for the entire screen, this can be done by writing $2000 once, and $2005 twice before the end of vblank.
| |
| | |
| # The low two bits of $2000 select which of the four nametables to use.
| |
| # The first write to $2005 specifies the X scroll, in pixels.
| |
| # The second write to $2005 specifies the Y scroll, in pixels.
| |
| | |
| After this, do not make any writes to $2006 before the end of vblank, as they will overwrite the ''t'' register. The ''v'' register will be completely copied from ''t'' at the end of vblank, setting the scroll.
| |
| | |
| Note that the series of two writes to $2005 presumes the toggle that specifies which write is taking place. If the state of the toggle is unknown, reset it by reading from $2002 before the first write to $2005.
| |
| | |
| Instead of writing $2000, the first write to $2006 can be used to select the nametable, if this happens to be more convenient (usually it is not because it will toggle ''w'').
| |
| | |
| === Split X scroll ===
| |
| | |
| The X scroll can be changed at the end of any scanline when the horizontal components of ''v'' get reloaded from ''t'': Simply make one write to $2005 before the end of the line.
| |
| | |
| # The first write to $2005 alters the horizontal scroll position. The fine ''x'' register (sub-tile offset) gets updated immediately, but the coarse horizontal component of ''t'' (tile offset) does not get updated until the end of the line.
| |
| # An optional second write to $2005 is inconsequential; the changes it makes to ''t'' will be ignored at the end of the line. However, it will reset the write toggle ''w'' for any subsequent splits.
| |
| | |
| Like the single scroll example, reset the toggle by reading $2002 if it is in an unknown state. Since a write to $2005 and a read from $2002 are equally expensive in both bytes and time, whether you use one or the other to prepare for subsequent screen splits is up to you.
| |
| | |
| The first write to $2005 should usually be made as close to the end of the line as possible, but before the start of hblank when the coarse x scroll is copied from ''t'' to ''v''. 3 or 4 pixels of jitter are inevitable because the CPU is slower than the PPU, and to make sure that your code doesn't write after hblank starts it is best to write to $2005 a little bit early lest the entire following scanline be glitched. Any glitch could be concealed by solid pixels. To eliminate the glitch altogether, the following more advanced X/Y scroll technique could be used to update ''v'' during hblank instead.
| |
| | |
| === split X/Y scroll ===
| |
| | |
| To split both the X and Y scroll on a scanline, we must perform four writes to $2006 and $2005 alternately in order to completely reload ''v''. Without the second write to $2006, only the horizontal portion of ''v'' will loaded from ''t'' at the end of the scanline. By writing twice to $2006, the second write causes an immediate full reload of ''v'' from ''t'', allowing you to update the vertical scroll in the middle of the screen.
| |
| | |
| This is based on [http://forums.nesdev.org/viewtopic.php?p=78593#p78593 Drag's example on the nesdev forum] where writes to PPU registers are done in the order of $2006, $2005, $2005, $2006. This order of writes is important, understanding that the write toggle for $2005 is shared with $2006. As always, if the state of the toggle is unknown before beginning, read $2002 to reset it.
| |
| | |
| In this example we will perform two writes to each of $2005 and $2006. We will set the X scroll (X), Y scroll (Y), and nametable select (N) by writes to $2005 and $2006. This diagram shows where each value fits into the four register writes.
| |
| | |
| N: %01
| |
| X: %01111101 = $7D
| |
| Y: %00111110 = $3E
| |
| | |
| $2005.1 = X = %01111101 = $7D
| |
| $2005.2 = Y = %00111110 = $3E
| |
| $2006.1 = ((Y & %11000000) >> 6) | ((Y & %00000011) << 4) | (N << 2) = %00010100 = $14
| |
| $2006.2 = ((X & %11111000) >> 3) | ((Y & %00111000) << 2) = %11101111 = $EF
| |
| | |
| However, since there is a great deal of overlap between the data sent to $2005 and $2006, only the last write to any particular bit of ''t'' matters. This makes the first write to $2006 mostly redundant, we can simplify its setup significantly:
| |
| | |
| $2006.2 = N << 2 = %00000100 = $04
| |
| | |
| There are other redundancies in the writes to $2005, but since it is likely the original X and Y values already calculated, these can be left as an exercise for the reader.
| |
| | |
| {| class="wikitable"
| |
| !colspan="3" style="background-color:palegreen" | Before
| |
| !rowspan="2" | Instructions
| |
| !colspan="3" style="background-color:lightcoral" | After
| |
| !rowspan="2" | Notes
| |
| |-
| |
| !style="background-color:palegreen" | t
| |
| !style="background-color:palegreen" | v
| |
| !style="background-color:palegreen" | x
| |
| !style="background-color:lightcoral" | t
| |
| !style="background-color:lightcoral" | v
| |
| !style="background-color:lightcoral" | x
| |
| |-
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ...
| |
| |style="font-family:monospace; white-space:nowrap;" | LDA #$04 (%00<span style="background-color:lime">000100</span>)<br />STA $2006
| |
| |style="font-family:monospace; white-space:nowrap;" | 0<span style="background-color:lime">000100</span> ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ...
| |
| | Bit 14 of ''t'' set to zero
| |
| |-
| |
| |style="font-family:monospace; white-space:nowrap;" | 0000100 ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ...
| |
| |style="font-family:monospace; white-space:nowrap;" | LDA #$3E (%<span style="background-color:lime">00</span><span style="background-color:yellow">111</span><span style="background-color:cyan">110</span>)<br />STA $2005
| |
| |style="font-family:monospace; white-space:nowrap;" | <span style="background-color:cyan">110</span>01<span style="background-color:lime">00</span> <span style="background-color:yellow">111</span>.....
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ...
| |
| | Behaviour of 2nd $2005 write
| |
| |-
| |
| |style="font-family:monospace; white-space:nowrap;" | 1100100 111.....
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | ...
| |
| |style="font-family:monospace; white-space:nowrap;" | LDA #$7D (%<span style="background-color:lime">01111</span><span style="background-color:yellow">101</span>)<br />STA $2005
| |
| |style="font-family:monospace; white-space:nowrap;" | 1100100 111<span style="background-color:lime">01111</span>
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | <span style="background-color:yellow">101</span>
| |
| | Behaviour of 1st $2005 write
| |
| |-
| |
| |style="font-family:monospace; white-space:nowrap;" | 1100100 11101111
| |
| |style="font-family:monospace; white-space:nowrap;" | ....... ........
| |
| |style="font-family:monospace; white-space:nowrap;" | 101
| |
| |style="font-family:monospace; white-space:nowrap;" | LDA #$EF (%<span style="background-color:lime">11101111</span>)<br />STA $2006
| |
| |style="font-family:monospace; white-space:nowrap;" | 1100100 <span style="background-color:lime">11101111</span>
| |
| |style="font-family:monospace; white-space:nowrap;" | 1100100 11101111
| |
| |style="font-family:monospace; white-space:nowrap;" | 101
| |
| |After ''t'' is updated, contents of ''t'' copied into ''v''
| |
| |}
| |
| | |
| Timing for this series of writes is important. Because the Y scroll in ''v'' will be incremented at pixel 250, you must either set it to the intended Y-1 before pixel 250, or set it to Y after pixel 250. Many games that use split scrolling have a visible glitch at the end of the line by timing it early like this.
| |
| | |
| Alternatively you can set the intended Y after pixel 250. The last two writes ($2005.1 / $2006.2) can be timed to fall within hblank to avoid any visible glitch.
| |
| | |
| Because this method sets ''v'' immediately, it can be used to set the scroll in the middle of the line. However, because perfectly stable timing is not usually possible, it is not recommended. Depending on when tiles and attributes are fetched, it may also result in objectionable glitches that executing the scroll at the end of the scanline would hide.
| |
