Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tomblack.ca/llms.txt

Use this file to discover all available pages before exploring further.

Start with the Validation section in the Pixelate inspector. It shows the next setup problem Pixelate needs you to fix.

​
Capture is blocked

Check these items:
  • Target is assigned.
  • Capture Camera is assigned.
  • A PixelateProfile is assigned.
  • Export Location is inside Assets/.
  • Custom palette textures use valid import settings.
  • Animation targets have an Animator when Source Clips are assigned.
  • The atlas size is at or below 4096 x 4096.

​
Preview is empty

1

Check required fields

Assign Target, Capture Camera, and Pixelate Profile.
2

Check camera framing

Select the capture camera and confirm the target is visible.
3

Check cell size

In the profile’s Render section, make sure Cell Size values are above 0.
4

Check custom palette

If using a custom palette, fix any palette validation message first.

​
Animation capture fails

  • Add an Animator component to the target.
  • Make sure Source Clips are assigned.
  • Lower Frames Per Second if the atlas is too large.
  • Reduce Cell Size for long clips.
  • Use Source Clip Speed to sample a clip faster or slower.

​
Output is overwritten

Open Export Settings:
  • Keep Override Captures enabled to replace matching output files.
  • Disable Override Captures to create unique file names.

​
Sprite slices are wrong

Check the profile’s Render section:
  • Cell Size must match the frame size you want.
  • Pivot controls the imported sprite pivot.
  • Animation atlases are sliced from top-left to bottom-right.
If needed, open Unity’s Sprite Editor and inspect the generated slices.

​
Custom palette is rejected

Use these import settings:
SettingValue
Height1 pixel
Wrap ModeClamp
Filter ModePoint
Mip MapsOff
CompressionNone

​
Normal-map lighting looks flat

  • Set profile Normal Map > Material Pipeline to Built-in.
  • Use a material with the ToonLitSprite shader.
  • Assign the generated _NormalMap.png.
  • Add a light in the scene.
If lighting flips when the character turns around, avoid negative X scale.