# \[Extension\] Sprite Analyzer

**URL:** <https://community.aseprite.org/t/extension-sprite-analyzer/13966>\
**Category:** Scripts & Extensions\
**Created:** [April 19, 2022, 8:02pm UTC](https://community.aseprite.org/t/extension-sprite-analyzer/13966 "2022-04-19T20:02:34Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![thkwznk](https://community.aseprite.org/user_avatar/community.aseprite.org/thkwznk/32/14485_2.png) [@thkwznk](https://community.aseprite.org/u/thkwznk)\
**Post date:** [April 19, 2022, 8:02pm UTC](https://community.aseprite.org/t/extension-sprite-analyzer/13966/1 "2022-04-19T20:02:34Z")

</div>

# Sprite Analyzer - [Download 🔗](https://thkaspar.itch.io/sprite-analyzer) - [Source Code 🔗](https://github.com/thkwznk/aseprite-scripts)

**Sprite Analyzer** is an extension that creates a live preview with a breakdown of a sprite, allowing you to track values, silhouette, outline, and blocked shapes of the sprites.

## How to use the extension

![sprite_analyzer_prev-export](https://community.aseprite.org/uploads/default/original/2X/5/5ec7852bc93adc6fb96ebcc60419a8373a7712ae.gif)

In order to analyze a sprite you need to:

1. Install the extension and restart Aseprite
2. Open any sprite/image
3. Select an area that you want to create a preview of - preferably with the Rectangular Marquee Tool
4. Go to the _View_ menu and click the _Sprite Analyzer_ option near the bottom

## How to add colors

_Sprite Analyzer_ can show additional previews - an **outline preview** and a **flat colors preview** - for both of these additional information about colors need to be input.

There are two sections for inputting outline colors and colors to flatten:

![](https://img.itch.zone/aW1nLzg3MDcyNzkucG5n/original/mVMc%2F0.png)

**Outline**  **Colors** has a single collection of colors that will show up as black in the preview.

**Flatten Colors** can have multiple collections/ramps of colors that will all be drawn as the first color in a collection.

You can configure collections by:

- **Add a color** - by left-clicking on the colors collection which will add the current foreground color or colors selected in the palette
- **Remove a color** - by right-clicking on a color in the collection
- **Reorder colors** - by moving colors in a collection, moving a color out of a collection removes it, the order of outline colors doesn’t matter

## How to automatically analyze a sprite

![sprite_analyzer_auto_prev-export](https://community.aseprite.org/uploads/default/original/2X/1/1164edca753e3a93b39459089a46161d55e41585.gif)

You can automatically analyze a sprite by selecting the _New Auto_ option from the top section of the dialog. This will guide you through a short process where first, you can pick outline colors used in the sprite (or lack thereof), and then all colors used will be grouped into colors ramps, you can adjust the grouping using two sliders:

![](https://img.itch.zone/aW1nLzg3MDcyODQucG5n/original/X2UVXI.png)

- **Tolerance** - which controls how big of a shift in hue is acceptable for colors to be still considered a part of the same ramp
- **Ignorance** - which controls how many pixels of a given color need to be adjacent to be considered a part of the same ramp

## How to manage presets

Any configuration consisting of outline colors, colors to flatten, and preview options can be saved and loaded as a preset. The top section of the dialog provides options for managing presets.