# Xsheet to Drawing Project

> Compile reference-based layer timing into an editable Flipline drawing project. Paste an Xsheet project containing source drawings and independent layer exposures. Merge matching composite ticks, split long holds and download a standard Flipline drawing project. References remain editable in the original Xsheet file; compiled drawings are independent snapshots.

Part of usefulweb.site (https://usefulweb.site/). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://fliplinexsheetcompiler.usefulweb.site/ (interactive tool at https://fliplinexsheetcompiler.usefulweb.site/tool)
- JSON API: POST https://fliplinexsheetcompiler.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://fliplinexsheetcompiler.usefulweb.site/api/v1/tool)
- OpenAPI: https://fliplinexsheetcompiler.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://fliplinexsheetcompiler.usefulweb.site/mcp - tool `flipline_xsheet_compiler`

## Inputs
- project (textarea, required): Xsheet project JSON (up to 1 million characters)

## Method
- Parse the flipline-xsheet version 1 format, including a valid Flipline drawing project, equal-length exposure columns and references from zero to the source drawing count. Each source layer has exactly one column.
- Merge adjacent identical reference tuples. Split composite holds into chunks of at most ten ticks. Reject more than 24 resulting drawing frames instead of truncating timing.
- Copy each referenced source cel into the resulting drawing frame. Zero becomes an empty cel. Preserve layer order, visibility, locks, opacity, paper, canvas settings, brushes, pressure, image sources and mark transforms. The source project and exposure cells are not mutated.
- The fully expanded result must also fit the drawing-board budgets of 2000 marks, 50000 points, 240000 brush dabs and 8 million embedded source characters. Repeated image sources count each time as in ordinary Flipline projects. Input text is limited to 1 million characters; the browser Xsheet workspace accepts larger local project files up to 16 MB.