#sprite-sheet #gamedev #atari #yaml #tile #image #graphics

app sprites7800

a companion tool of cc7800 generating C sprites/tiles code

6 releases

new 0.4.3 Dec 13, 2024
0.3.2 Sep 17, 2023
0.2.1 Sep 4, 2023
0.2.0 Aug 16, 2023

#202 in Game dev

Download history 57/week @ 2024-09-28

380 downloads per month

GPL-3.0-or-later

86KB
559 lines

sprites7800

This is a tool for generating C code for Atari 7800 graphics (sprites and tiles). It processes YAML files in input, which references some sprite sheet images :

sprite_sheets:
  - image: Bubble Bobble.png
    sprites:
      - name: bb_char1
        top: 0
        left: 0
        width: 16
        holeydma: true

which generates (sprites7800 simple.yaml)

holeydma reversed scattered(16,2) char bb_char1[32] = {
	0x01, 0x00, 0x01, 0x40, 0x0a, 0x94, 0x2a, 0x90, 0x3b, 0xa0, 0xc8, 0xe5, 0xc8, 0xe4, 0xc8, 0xd0,
	0xc8, 0xe5, 0xbb, 0x84, 0x0c, 0x20, 0x2a, 0x90, 0x0e, 0x50, 0x3f, 0x94, 0x3d, 0x68, 0x5d, 0x6a
};

Note that the keywords holeydma, reversed and scattered are keywords specific to cc7800 that enable the compiler to properly lay the memory out, interlacing graphics and code as the Atari 7800 quircky architecture requires.

Default sprite height is 16 pixels. cc7800 only supports 8 and 16 pixels high scattered data at the moment.

Default graphics mode is 160A (i.e. double width pixels and 3 colors per sprite + background). Other graphic mode must be specified with the mode attribute.

Main Sprites7800 features :

  • All Maria gfx mods are supported (160A, 160B, 320A, 320B, 320C and 320D modes)
  • Supports any image format (BMP, JPEG, GIF, PNG, ICO..)
  • Palette definition can be provided to correctly map colors to C code

Note that in 160A and 160B modes, all pixels must be 2 pixels wide (fat pixels) or the image will be rejected.

Sprites7800 was written in Rust language and thus can be easily compiled and installed using Cargo (cargo install --path .).

Dependencies

~6.5MB
~129K SLoC