Moving sprites: Difference between revisions

Latest revision as of 04:47, 26 November 2015

Sprites can be moved individually if they're not stuck together. If they are, the sprite block can be moved by only setting the driving sprite's position. The chained sprites will move accordingly.

Like every location in VRAM, these positions can be updated mid-frame to create scanline effects.

Horizontal position

The horizontal (X) position is set in VRAM, in SCB4. It's relative to the left screen border.

Example: writing $0010 to $8402, puts sprite #2 at 16 pixels from the left.

ASM routine to set the X position of a given sprite:

;D0: Sprite #
;D1: X position
SetSprX:
    addi.w  #SCB4,d0
    move.w  d0,VRAM_ADDR    ; Set VRAM address to SCB4+sprite #
    lsl.w   #7,d1           ; Put position value to the left
    move.w  d1,VRAM_RW
    rts

Vertical position

The vertical (Y) position is set in VRAM, in SCB3. It's reversed (496-Y), and relative to the top screen border. A value of $1F0 sets the sprite to Y=0, $110 sets it at 224 (right out of the visible area).

Example: writing $F100 ((496-14)<<7) at VRAM address $8205, puts sprite #5 at 14 pixels from the top.

Be aware that the vertical position word also holds the size and the sticky bit of the sprite.

ASM routine to set the Y position of a given sprite:

;D0: Sprite #
;D1: Y position
SetSprY:
    addi.w  #SCB3,d0
    move.w  d0,VRAM_ADDR    ; Set VRAM address to SCB3+sprite #
    neg.w   d1              ; Do 496-position
    addi.w  #496,d1
    lsl.w   #7,d1           ; Put position value to the left
    move.w  VRAM_RW,d2      ; Read VRAM
    andi.w  #$007F,d2       ; Preserve the sticky bit and size attributes
    or.w    d1,d2           ; Change position value
    move.w  d2,VRAM_RW
    rts

Example

Animates ~100 individual and grouped sprites.

Source and romset: nyanmvs.zip

@@ Line 1: / Line 1: @@
-Sprites can be moved individually if they're not [[Sticky bit|stuck together]], of by blocks otherwise.
+Sprites can be moved individually if they're not [[Sticky bit|stuck together]]. If they are, the sprite block can be moved by only setting the [[sprites#driving sprite|driving sprite]]'s position. The chained sprites will move accordingly.
+Like every location in [[VRAM]], these positions can be updated mid-frame to create [[scanline effects]].
 === Horizontal position ===
-Their horizontal (X) position is set in VRAM, in [[Sprites|SCB4]]. It's relative to the left screen border.
+The horizontal (X) position is set in VRAM, in [[Sprites|SCB4]]. It's relative to the left screen border.
+Example: writing $0010 to $8402, puts sprite #2 at 16 pixels from the left.
-Example: write $0010 to $8402, puts sprite n°2 at 16 pixels from the left.
+ASM routine to set the X position of a given sprite:
+<syntaxhighlight>
+;D0: Sprite #
+;D1: X position
+SetSprX:
+    addi.w  #SCB4,d0
+    move.w  d0,VRAM_ADDR    ; Set VRAM address to SCB4+sprite #
+    lsl.w   #7,d1           ; Put position value to the left
+    move.w  d1,VRAM_RW
+    rts
+</syntaxhighlight>
 === Vertical position ===
-Their vertical (Y) position is set in VRAM, in [[Sprites|SCB3]]. It's reversed (496-Y), but relative to the top screen border.
+The vertical (Y) position is set in VRAM, in [[Sprites|SCB3]]. It's reversed (496-Y), and relative to the top screen border.
-A value of $1F0 sets the sprite to Y=0, $110 sets it at 224 (out of the visible area).
+A value of $1F0 sets the sprite to Y=0, $110 sets it at 224 (right out of the visible area).
+Example: writing $F100 ((496-14)<<7) at VRAM address $8205, puts sprite #5 at 14 pixels from the top.
+Be aware that the vertical position word also holds the size and the sticky bit of the sprite.
+ASM routine to set the Y position of a given sprite:
+<syntaxhighlight>
+;D0: Sprite #
+;D1: Y position
+SetSprY:
+    addi.w  #SCB3,d0
+    move.w  d0,VRAM_ADDR    ; Set VRAM address to SCB3+sprite #
+    neg.w   d1              ; Do 496-position
+    addi.w  #496,d1
+    lsl.w   #7,d1           ; Put position value to the left
+    move.w  VRAM_RW,d2      ; Read VRAM
+    andi.w  #$007F,d2       ; Preserve the sticky bit and size attributes
+    or.w    d1,d2           ; Change position value
+    move.w  d2,VRAM_RW
+    rts
+</syntaxhighlight>
+==Example==
+[[File:nyandemo.png|right]]
-Example: write 496-14 ($1E2) to $8205, puts sprite n°5 at 14 pixels from the top.
+Animates ~100 individual and grouped sprites.
-Like every location in VRAM, these values can be updated mid-frame to create [[Scanline stretch|stretches]].
+Source and romset: [[Media:nyanmvs.zip|nyanmvs.zip]]
 [[Category: Code]]
+[[Category:Graphics Code]]

Moving sprites: Difference between revisions

Latest revision as of 04:47, 26 November 2015

Horizontal position

Vertical position

Example

Navigation menu