> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cadmium.app/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions

<AccordionGroup>
  <Accordion title="How come my frames didn't import?">
    Cadmium accepts **PNG format with alpha** only. Make sure your frames have a number sequence at the end of the file name, like `fredDog_001.png`.
  </Accordion>

  <Accordion title="My line files imported, but I can't color anything!">
    Double check that your line layer images have an **alpha channel**. Without it, the color layer won't be visible.
  </Accordion>

  <Accordion title="When I press Colorize, nothing happens or I get an error.">
    You must include a **reference image** for Cadmium to know how to color. On Windows, you may also need to allow permissions in your firewall settings.
  </Accordion>

  <Accordion title="What are the connection lines between the layers?">
    When you select an image to color, the lines show which frames are being referenced to inform how that frame should be colored. It's a visual cue showing Cadmium's prediction source.
  </Accordion>

  <Accordion title="How many reference images should I provide?">
    Any time a new object or color is introduced into your scene, you should provide a reference. The more references you provide, the better Cadmium will perform.
  </Accordion>

  <Accordion title="Why does pressing 'Analyze' give me random colors?">
    Pressing **Analyze** creates a segment map and returns a color map of how Cadmium interprets separate regions. The random colors help you quickly spot gaps in your artwork. This is necessary for the colorizer to work.
  </Accordion>

  <Accordion title="Why didn't Cadmium color it correctly?">
    You may need more reference frames, or there may be gaps in your line work (use the pen tool to close them). Check your [Analysis Settings](/analyzing-frames#analysis-settings-panel) for gap closing options.
  </Accordion>

  <Accordion title="How does Cadmium handle gap closing and segmenting?">
    You can learn more about this in the [Analyzing Frames](/analyzing-frames) section.
  </Accordion>

  <Accordion title="It's taking forever to process my frames...">
    Cadmium relies on your internet connection to process frames. On average, one HD frame takes around 5 seconds. If you're processing very large frames, consider down-resizing before import.
  </Accordion>

  <Accordion title="How do I select which layer to draw on?">
    Click on the **layer name** to select the active layer — that's where drawing will happen. The fill tool, however, always works on the color layer regardless of which layer is selected.
  </Accordion>

  <Accordion title="Why is the drawing primitive?">
    For the initial release, the focus was primarily on coloring functionality. Better drawing tools are on the roadmap.
  </Accordion>

  <Accordion title="I'm frustrated — what do I do?">
    We're sorry! Please email us at [hello@cadmium.app](mailto:hello@cadmium.app) and we'd be happy to help you troubleshoot.
  </Accordion>
</AccordionGroup>