PixelFoundry Help

START HERE

Inspect and convert graphics, then export them as new files

Open a graphic from the canvas or drop it there. PixelFoundry then analyzes grid suitability, colors, and transparency, recommends a tool, and sets suitable starting values. You deliberately start the change afterward.

PixelFoundry belongs to NoAliasTools. Your account, Cloud files and plans are at noaliastools.com.

  1. Open a graphic: Choose a file or drop it in the center of the canvas. The initial view shows the complete image.
  2. Analyze image: Inspect the grid, color ramps, and transparency, then review the suggested values.
  3. Apply tool: Deliberately start Reconstruct grid, Create pixel art, or Clean up image.
  4. Review the result: Use the original, result, comparison, and diagnostic overlays.
  5. Continue working: Run more steps on the active version or select an earlier version.
  6. Export: Save the active version as a new file.

LEFT TOOL RAIL

Choose the right tool

One click selects the tool and opens its settings. A second click on the active tool hides the options panel. This changes neither the active version nor any calculated results.

Recover rebuilds the pixel grid; Cleanup works within the existing grid. The analysis distinguishes a reliable repeated scaling grid from mere subject edges. Without a reliable grid, it recommends Cleanup or Convert instead of a coarse Recover result.

What does Recover do?

Recover: softly enlarged pixel art, detected cell grid, and crisply reconstructed native pixels
Best for
Enlarged / soft
Key changes
Build grid + cell colors
Result
New native resolution

Recover reconstructs the existing pixel grid of an upscaled, softened, or slightly uneven pixel graphic. Automatic mesh detects grid lines; manual grid uses a fixed cell size and offset. For animations, the animation check reports different grid hypotheses, palettes, and alpha masks while frame 1 defines the shared grid. Recover does not invent missing subject detail. Because every detected cell is consolidated into one pixel, Recover can have a stronger effect than Cleanup on softened sources and usually changes the image dimensions.

Limits: Recover resamples the entire graphic. It needs a recognizable block grid and cannot recreate lost detail.

What does Convert do?

Convert: smooth illustration, newly selected pixel grid, and simplified pixel art
Best for
Smooth image
Key changes
Choose a new grid
Result
New pixel art

Convert creates a pixel-art baseline from photos, illustrations, and renders. Target width, source format or a fixed crop, detail and edge weighting, palette, dithering, and transparency determine the output. For animations, crop, target size, and shared palette remain constant across every frame.

Limits: Convert does not invent subject detail; the target width cannot enlarge the selected source crop.

What does Cleanup do?

Cleanup: native pixel art with isolated defects, marked findings, and the same grid after correction
Best for
Native pixel art
Key changes
Correct findings
Result
Same grid / dimensions

Cleanup expects pixel art at its native resolution. It inspects partial transparency, invisible RGB residue, isolated pixels, antialiasing intermediate colors, small color islands, and palette deviations. For animations, it also reports temporal grid, alpha, palette, and single-pixel jumps. Every correction can be enabled independently, and temporal corrections apply to the current frame, a frame selection, or the entire sequence. The analysis itself remains read-only.

Chroma key removes a flat background in a saturated key color such as magenta or green, as image generators often draw it. The key color is the most frequent color on the image border; Key tolerance sets how far a hue may differ from it. Because it compares hues, darker shadows of the key and areas enclosed by the motif go as well, while greys and pale tints stay. Color spill takes the remaining cast of the key color out of edge pixels. An animation is keyed with the border color of its first frame. Colors of the motif that share the key hue are removed too.

Gradient cleanup groups nearby shades into stable color bands within connected local color ramps. Spatially separate parts are not linked merely because their RGB values are similar. It changes neither dimensions, pixel positions, nor alpha. Off preserves every source color and remains the default without prior analysis. Cleanup does not reconstruct cells.

Limits: Cleanup changes neither the grid nor the dimensions. Recover is only appropriate when the analysis confirms a reliable repeated scaling grid.

OPTIONS PANEL

Understand shared settings

Maximum color count Limits the calculated palette; Unlimited preserves all calculated colors.
Transparency threshold Determines when pixels become fully transparent or Cleanup converts them to binary alpha.
Minimum coverage For Recover, determines how much opaque source area is required for an opaque target pixel.
Color tolerance Groups similar source colors when choosing a representative color.

Tooltips explain the current effect of a setting and, for disabled controls, the specific reason.

CANVAS TOOLBAR

Canvas, comparison, and diagnostic overlays

  • Original / Result selects the main version shown in the preview.
  • Compare reveals the other version as an adjustable split.
  • Onion places the other version semi-transparently over the main view and disables the split.
  • Workspace zoom starts with Fit to view after opening and changes only the display. The mouse wheel keeps the image point under the pointer fixed.
  • Background shows transparency as a checkerboard or over a selected solid color.
  • Pixel grid becomes visible at a sufficiently large zoom level.
  • Recover mesh shows detected lines over the corresponding original.
  • Cleanup findings marks static and temporal findings in the current result frame.
  • Processing display shows the current inspection step only in the centered dialog. The image remains visually unchanged during analysis and processing.
View options are not processing steps. Zoom, background, comparison, and overlays never become part of the exported file.

RIGHT PANEL

Work with the processing history

The original and completed steps remain available as versions. A new step always processes the currently selected version. If you select an earlier version and continue processing, a new branch is created; existing versions are not overwritten.

Undo moves to the parent version. Redo returns to the most recently undone version. Export always uses the currently selected version.

MULTI-FRAME FILES

Process animations

GIF, Animated WebP, and APNG are loaded as a shared frame sequence. Playback and frame navigation are for inspection; processing runs across all frames. Duration, order, and loop remain in the internal document.

Recover uses a shared mesh and Convert uses a shared palette for the sequence. PixelFoundry currently does not edit frame durations or order.

FILE FORMATS

Import and export

Import PNG, APNG, JPEG, WebP, Animated WebP, and GIF.
Static export RGBA PNG, indexed PNG with up to 256 colors, and lossless WebP.
Animation export GIF, APNG, and lossless Animated WebP.
Project export PNG frame sequence or PNG spritesheet with versioned JSON metadata as a ZIP, plus a validated SpriteForge project handoff.

Formats that do not apply are disabled. Every export creates a new file and never overwrites the source file. Workspace zoom does not change export dimensions.

Under Output size, the result can remain at its native size, be enlarged with an integer nearest-neighbor factor, or be set exactly to the original source dimensions. The export check shows the actual dimensions and aspect ratio. If the source dimensions do not fit equal-sized pixel blocks, it reports the unavoidable rounding before saving.

Project export contract v2 stores canvas and sprite sheet rectangles, origin, optional pivot, frame duration, loop, blend, and disposal. This makes it possible to reconstruct every frame completely from either ZIP variant.

SpriteForge project handoff v1 protects its canonical payload and every RGBA frame with SHA-256. It remains disabled whenever SpriteForge could not preserve dimensions, palette, alpha, timing, playback, composition, frame geometry, or the shared pivot without loss.

Open in SpriteForge hands the same handoff to SpriteForge in a new tab without a download. It is available whenever the SpriteForge handoff export is; if the browser blocks the new tab, the export remains.

Before saving, the export check shows the actual dimensions and lists unavoidable changes. These include GIF palette reduction, binary GIF transparency, rounded frame durations, reset blend and disposal values, and omitted EXIF, XMP, and color-profile metadata. Unsupported combinations are blocked before the encoder runs.

INSTALLABLE APP

Install PixelFoundry and start offline

If the browser supports a direct installation prompt, the action appears in the Help menu. On iPhone and iPad it opens instructions for Add to Home Screen. Other browsers show the appropriate path through their own installation menu.

The offline core stores only the application. Loaded graphics and generated results are neither written to the service-worker cache nor sent to a server. They remain in the current browser window and must be exported before an update.

An available update also appears in the Help menu. It is activated only after explicit confirmation and then reloads the application.

WHEN SOMETHING FAILS

Errors and next steps

Error messages identify the affected phase, the known or unexpected cause, and a next step. Unexpected runtime and worker errors also receive a diagnostic ID for troubleshooting.

  • File is rejected: Check the format, file size, and access permissions.
  • Automatic Recover fails: Check the grid values or switch to Manual grid.
  • Export fails: Choose a format that matches the active still image or animation.

Automatic grid detection loads about 16 MB of uncompressed program data on first use. Transfer size depends on server compression. Manual grid, Convert, and Cleanup do not need OpenCV.

CONTROLS

Keyboard and mouse

Ctrl/Cmd + OOpen a graphic.
Ctrl/Cmd + ZMove to the parent of the active version.
Ctrl/Cmd + YRedo the most recently undone version change.
Ctrl/Cmd + Shift + ZRedo on keyboards without Ctrl/Cmd + Y.
Arrow keysSwitch menus and select menu items.
EscapeClose an open menu or tooltip.
Mouse wheelZoom around the image point under the mouse pointer.
Middle mouse button + dragPan the zoomed canvas view.
Space + dragTemporarily pan the canvas view with the hand tool.
Two fingersZoom and pan the canvas view at the same time on touch devices.