SpriteGrid

Developer documentation

Every color

A .sgtheme file is this, in JSON, with camelCase names. The color names follow the Gruvbox palette's, so a palette built that way maps straight on; the few SpriteGrid doesn't paint with yet say so.

Name

idstringrequired

The theme's id, different from every other theme's. Settings remember the chosen theme by it, and SpriteGrid names the file after it when it writes one (my-theme.sgtheme).

displayNamestring

The name Edit ▸ Theme lists it by.

Backgrounds

bgHardcolor

The deepest background: sunken areas. The canvas's surround is this at half brightness. Dark themes dim the window behind a dialog with it; light themes use it for the shadow under text.

bgMediumcolor

The window's background, behind the panels. It also makes a theme light or dark: light when it's brighter than fg1, and Edit ▸ Theme lists it under Light when it's brighter than mid-gray.

bgSoftcolor

The panels' bodies: the UI art is gray, and its lightest gray (the skin's tint level) becomes this color, with darker grays shading toward black (dark themes) or bg2 (light themes).

bg1color

Raised areas and alternating rows.

bg2color

Light themes only: what the UI art's black becomes, so sunken fields stay light enough for dark text. Dark themes use black.

bg3color

The outline around docked panels, and the text on disabled buttons and menu items.

bg4color

Not used by the app yet.

Text

fg0color

Not used by the app yet.

fg1color

Text and glyphs. Light themes also dim the window behind a dialog with it.

fg2color

Not used by the app yet.

fg3color

Not used by the app yet.

fg4color

Dim text: hints, captions, the status bar.

graycolor

A neutral color for things colored by kind: the 3D camera's size curve in the graph editor.

Accent

accentcolor

Hover and selection highlights, the active tool, slider fills, focus, the active canvas's frame, the playhead.

accentDarkcolor

Not used by the app yet.

Colors

redcolor

Errors and things that delete, the playhead while Auto-Key is on, and X position curves.

greencolor

Success, effect-setting tracks and markers in the timeline, and Y position curves.

yellowcolor

Visibility tracks, the keyframe button while there's a key on the current frame, and X rotation and scale curves.

bluecolor

Sprite (drawing) tracks, and Z position and 2D rotation curves.

purplecolor

Opacity tracks, and Y rotation and scale curves.

aquacolor

3D animation and linked-document tracks, linked layers in the Layers panel, and Z rotation and scale curves.

orangecolor

Warnings, transform tracks, and number curves in the graph editor (opacity, effect settings).

Dark colors

redDarkcolor

Not used by the app yet.

greenDarkcolor

Not used by the app yet.

yellowDarkcolor

Not used by the app yet.

blueDarkcolor

Not used by the app yet.

purpleDarkcolor

Not used by the app yet.

aquaDarkcolor

Not used by the app yet.

orangeDarkcolor

Not used by the app yet.

The built-in themes#

Each downloads as a .sgtheme file, ready to rename and change.