TIFF-документ

TIFF — основной формат документов WhimTex. Один файл *.tiff — одновременно обычная текстура для Unity и редактируемый документ: видимое изображение TIFF — последняя сохранённая композиция, а модель слоёв и данные Drawing находятся в добавленном контейнере WhimTex.

Что находится в файле

Сначала записано изображение TIFF, поэтому Unity импортирует его обычным Texture Importer. После изображения WhimTex добавляет бинарный контейнер с блоком модели document, отдельными блоками пикселей Drawing и небольшим блоком carrier. В каталоге для каждого блока указаны имя, сжатие и размеры; манифест integrity:sha256 обнаруживает случайное повреждение или обрезку. Это не ZIP и не второй Unity-ассет.

Для обычного результата используются 8-битные сэмплы, а для HDR или явного Precision → Float32 — Float32. Mipmaps, GPU-компрессия, нарезка спрайтов и платформенные overrides остаются настройками штатного Texture Importer Unity, а не данными слоя.

Загрузка и сохранение

При открытии сначала читаются footer, каталог блоков и модель. Блоки пикселей Drawing загружаются лениво, когда они нужны для рендера, превью, редактирования или сохранения; весь документ сразу не распаковывается. Сохранение идёт во временный соседний файл, проверяет его и атомарно заменяет предыдущий TIFF. Если исходник изменился извне, WhimTex не смешивает версии и предлагает переоткрыть документ или использовать Save As.

Совместимость

Не пересохраняй TIFF во внешнем редакторе: он может удалить добавленный контейнер и оставить только композицию. Старые документы .asset не поддерживаются. До обновления преобразуй их в TIFF через WhimTex 0.12.5. JSON-документы — редактируемая текстовая альтернатива без пикселей Drawing и текстуры Unity. PNG, JPEG, TGA и EXR содержат экспортированное изображение без редактируемых слоёв. PSD может сохранить часть слоёв и эффектов, но не заменяет исходный документ WhimTex.

Полная побайтовая схема, ограничения и правила блоков описаны в техническом описании формата TIFF.