Added vdp_clear_sprite() and vdp_add_sprite_bitmap()

README.md

@@ -420,6 +420,14 @@ In the relevant: example, test or any other directory created at the same level.
 
 - `tests/sprite` added to demonstrate sprites and keyboard handling
 
+02/08/2023
+
+- Added sprite related functions
+
+  - `vdp_clear_sprite()`
+
+  - `vdp_add_sprite_bitmap()`
+
 ### To-Do / Known Issues:
 
 - Testing / validation

include/vdp_vdu.h

@@ -43,6 +43,8 @@ int vdp_load_sprite_bitmaps( const char *fname_prefix, const char *fname_format,
 void vdp_create_sprite( int sprite, int bitmap_num, int frames );
 
 void vdp_select_sprite( int n );
+void vdp_clear_sprite( void );
+void vdp_add_sprite_bitmap( int n );
 void vdp_move_sprite_to( int x, int y );
 void vdp_move_sprite_by( int x, int y );
 void vdp_show_sprite( void );

lib/agon/vdp_vdu.c.src

@@ -983,6 +983,40 @@ _vdp_select_sprite:
 	ret
 	section	.text,"ax",@progbits
 
+	section	.text,"ax",@progbits
+	public	_vdp_clear_sprite
+_vdp_clear_sprite:
+	ld	hl, _vdu_sprite_clear
+	ld	de, 3
+	ld	bc, 0
+	push	bc
+	push	de
+	push	hl
+	call	_mos_puts
+	pop	hl
+	pop	hl
+	pop	hl
+	ret
+	section	.text,"ax",@progbits
+
+	section	.text,"ax",@progbits
+	public	_vdp_add_sprite_bitmap
+_vdp_add_sprite_bitmap:
+	call	__frameset0
+	ld	a, (ix + 6)
+	ld	hl, _vdu_sprite_add_bitmap
+	ld	de, 4
+	ld	(_vdu_sprite_add_bitmap+3), a
+	ld	bc, 0
+	push	bc
+	push	de
+	push	hl
+	call	_mos_puts
+	ld	sp, ix
+	pop	ix
+	ret
+	section	.text,"ax",@progbits
+
 	section	.text,"ax",@progbits
 	public	_vdp_move_sprite_to
 _vdp_move_sprite_to:

src/libc/vdp_vdu.c

@@ -295,6 +295,17 @@ void vdp_select_sprite( int n )
 	VDP_PUTS( vdu_sprite_select );
 }
 
+void vdp_clear_sprite( void )
+{
+	VDP_PUTS( vdu_sprite_clear );
+}
+
+void vdp_add_sprite_bitmap( int n )
+{
+	vdu_sprite_add_bitmap.n = n;
+	VDP_PUTS( vdu_sprite_add_bitmap );
+}
+
 void vdp_move_sprite_to( int x, int y )
 {
 	vdu_sprite_moveto.x = x;