> For the complete documentation index, see [llms.txt](https://astropulse.gitbook.io/retro-diffusion/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://astropulse.gitbook.io/retro-diffusion/aseprite-extension/retro-diffusion-scripts/palettize-menu.md). # Palettize Menu

## Palettize "Palettize" has several input settings, but requires at least one layer and frame for each image. It can be found in "Help" -> "Retro Diffusion Scripts" -> "Palettize," or in "Sprite" -> "Palettize." "Palettize" requires an active sprite canvas and the RGB color mode. It also uses "k-means" clustering to reduce the number of colors in an image.

## Palette Source

"Palette source" lets you pick which color palette you want applied to the selected images.

### Automatic The "Automatic" palette source analyzes the image and selects the best number of colors to reduce it to without losing detail.

New palette chosen based on least colors while retaining quality

### Best Palette The "Best Palette" palette source looks at a folder with multiple PNG palette images and decides which palette best fits the current image based on color differences. Available palettes in example: [nice31](https://lospec.com/palette-list/31), [blk-36](https://lospec.com/palette-list/blk-36), [commadore64](https://lospec.com/palette-list/commodore64), [fantasy24](https://lospec.com/palette-list/fantasy-24), and [vinik24](https://lospec.com/palette-list/vinik24).\ Commadore64 was chosen for its better coverage of all hues.

### Adaptive The "Adaptive" palette source restricts the colors to an exact number, and any new colors are derived from the original image.

### Active Palette The "Active palette" palette source uses the colors from the current sprite's palette. ### Defaults The "Defaults" palette source provides a list of the palettes that are built into Aseprite. ### File The "File" palette source lets you choose an image to use as a palette. It must be a PNG image. ### URL The "URL" palette source loads the image from the url in the text box. ## Dithering

Dithering was a technique commonly used in older art to make better use of the then limited colors. Now, it is a common practice in pixel art used to create details, gradients, and other image features. ### Matrix Size "Matix Size" can be set to "None" (no dithering), "Bayer 2x2," "Bayer 4x4," or "Bayer 8x8." #### Bayer 2x2

#### Bayer 4x4

#### Bayer 8x8

### Dither Strength

"Dither Strength" controls how much dithering is applied to the image. ## Denoising Denoising is an advanced feature and is only recommended for experienced users. Without experience, denoising often leads to poor results.

Left: Normal palettization to 24 colors | Right: Denoised to 24 colors

### Smoothness "Smoothness" (appears when the denoise box is checked) does exactly what it says-it controls an image's smoothness. This is related to kernel size. ### Strength The "Strength" slider controls how aggressively the denoising tries to remove stray pixels. ## Processing Cels This applies "Palettize" to multiple images. If both options are checked, all images in the sprite will be processed. ### All layers The "All layers" checkbox applies "Palettize" to all layers in the selected frame. ### All frames The "All frames" checkbox applies "Palettize" to all frames on the selected layer. ## Process in Background "Process in background" keeps the command line interface minimized. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://astropulse.gitbook.io/retro-diffusion/aseprite-extension/retro-diffusion-scripts/palettize-menu.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.