spritebox 0.4.1

Create 2D pixel art and game assets from text: sprites, tilemaps, procedural textures, UI and pixel fonts. Export PNG, sprite atlases and TTF with a zero-dependency Rust library and CLI.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173

; A static UI kit: render with --theme dark, or --theme all for both atlases.
; The font is shared with the standalone font example.
import font.spritebox

palette ui
  . transparent
  k #243645
  b #adc3cf
  f #edf5f5
  g #7e9ba8
  a #2868c4
  i #eec76c
  u #68929f
  s #10182060

palette disabled from=ui
  b #bac1c5
  f #d4dadd
  g #909ca3

theme dark of ui
  k #dce9ef
  b #365265
  f #172d3a
  g #0d202c
  a #69c3ef
  i #e1a854
  u #091722
  s #00000080

; Compact panel corners intentionally use joined outline pixels.
sprite panel 5x5 palette=ui slice=2 lint=allow(double_outline)
  .kkk.
  kbbbk
  kfffk
  kgggk
  .kkk.
sprite dialog = panel:size(160x152):shadow(s,2,2)
sprite button_frame = panel:size(112x22)

; Hover/focus add a deliberate accent to the normal corner outline.
states button lint=allow(inconsistent_outline)
  normal button_frame
  hover button_frame:outline(a)
  pressed button_frame:flip_y
  disabled button_frame:swap(disabled)
  focus button_frame:outline(i)

sprite check_frame 5x5 palette=ui lint=allow(double_outline)
  .kkk.
  kfffk
  kfffk
  kfffk
  .kkk.
; The tiny check deliberately joins several accent pixels at its bend.
sprite check_mark 5x5 palette=ui lint=allow(jaggy,double_outline)
  .....
  ...a.
  .aaa.
  ..a..
  .....
sprite checked 5x5 palette=ui
  layer frame = check_frame
  layer mark = check_mark
states checkbox lint=allow(inconsistent_outline)
  normal check_frame
  off check_frame
  on checked
  off_hover check_frame:outline(a)
  on_hover checked:outline(a)

; At 8px these compact symbols deliberately use short diagonal steps.
icons items 8x8 palette=ui outline=k margin=1 lint=allow(jaggy,double_outline)
  icon sword
    ........
    ....kk..
    ...kik..
    ..kikk..
    .kik....
    ..kkk...
    ..k.k...
    ........
  ; The accent pixel is an intentional gem, including in the dark theme.
  icon shield lint=allow(orphan_pixel)
    ........
    ..kkkk..
    .kiiiik.
    .kiaiik.
    ..kiik..
    ...kk...
    ........
    ........
  icon heart
    ........
    ..k.k...
    .kikik..
    ..kiik..
    ...kk...
    ........
    ........
    ........
  icon key
    ........
    ..kkk...
    .kiiik..
    .kikik..
    ..kkk...
    ...k....
    ...kk...
    ........
  icon potion
    ........
    ...kk...
    ..kiik..
    ...kk...
    ..kiik..
    .kiaaik.
    ..kkkk..
    ........
  icon coin
    ........
    ..kkkk..
    .kiiiik.
    .kiaaik.
    .kiaaik.
    .kiiiik.
    ..kkkk..
    ........

text title font=hud palette=ui color=k width=144 align=center
  SPRITEBOX
text pause font=hud palette=ui color=k width=144 align=center
  PAUSED
text start font=hud palette=ui color=k width=112 align=center
  START GAME
text options font=hud palette=ui color=k width=112 align=center
  OPTIONS
text resume font=hud palette=ui color=k width=112 align=center
  RESUME
text exit font=hud palette=ui color=k width=112 align=center
  EXIT
text sound font=hud palette=ui color=k
  SOUND
text footer font=hud palette=ui color=k width=144 align=center
  PIXEL UI / 0.4

screen title 320x180 palette=ui background=u grid=2
  dialog at 80,14
  title at 88,24
  button.hover at 104,54
  start at 104,60
  button.normal at 104,84
  options at 104,90
  checkbox.on at 104,116
  sound at 116,110
  items.sword at 104,132
  items.shield at 124,132
  items.heart at 144,132
  items.key at 164,132
  items.potion at 184,132
  items.coin at 204,132
  footer at 88,148

screen pause 320x180 palette=ui background=u grid=2
  dialog at 80,14
  pause at 88,24
  button.focus at 104,54
  resume at 104,60
  button.normal at 104,84
  options at 104,90
  button.disabled at 104,114
  exit:swap(disabled) at 104,120
  footer at 88,148