readSprites
Debug sprite visibility, color, size, and positioning issues in Commodore 64 programs by reading hardware sprite states from the VICE emulator.
Instructions
Read state of all 8 hardware sprites with interpreted values.
Returns for each sprite:
Position (X, Y) with visibility check
Color (with name)
Enable status
Multicolor mode
X/Y expansion (double size)
Priority (in front of / behind background)
Data pointer address
Use this to debug sprite issues like:
"Why is my sprite invisible?" → check enabled, position, pointer
"Wrong colors?" → check multicolor mode and color registers
"Wrong size?" → check expand flags
Options:
enabledOnly: Only return enabled sprites (default: false)
Related tools: readVicState, readMemory (for sprite data)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabledOnly | No | Only return enabled sprites (default: false) |