Формат файлов Скретч (для 2.0)

Статья не завершена! Если ты хочешь помочь — отредактируй её.

Изображение файла .sb2

Формат файлов Скретч 2.0 - это формат файла, используемый для хранения экспортированных проектов Скретч 2.0. В отличие от файлов Скретч 1.4, файлы Скретч 2.0 представляют собой ZIP-архивы, содержащие информацию о проекте, закодированную в текстовом формате, называемом JSON, и файлы проекта в отдельных файлах. Проекты обычно имеют расширение .sb2 и спрайты .sprite2.

Поскольку JSON является текстовым форматом и существует множество библиотек для чтения и записи файлов JSON, для опытных пользователей гораздо проще создавать программы, которые читают и записывают файлы Скретч, чем это было в Скретч 1.4. Пользователи также могут легко вносить изменения в проект вручную в текстовом редакторе, чтобы достичь того, чего нельзя сделать в самом Скретч; например, они могут создавать пользовательские блоки с цветными входами или размещать репортеры на входах, где их обычно нельзя вставить.

JSON

Основная статья: JSON

JSON, сокращение от JavaScript Object Notation, - это формат данных, используемый Скретч 2.0 для хранения информации и сценариев в проекте. Объект связывает имена со значениями; они написаны с синтаксисом {"name": value, …}. Массив представляет собой последовательность значений; они написаны с синтаксисом [value, …]. Значения могут быть объектами; массивами; числами; строками, которые пишутся между кавычками, например "Arkansas"; Булевыми значениями true и false; или null - специальное значение, которое представляет пустоту.

Файлы проекта

Файл .sb2 представляет собой ZIP-архив, содержащий один файл JSON project.json, который представляет сцену. Спрайты считаются дочерними элементами сцены. Спрайты, фоны, костюмы и звуки хранятся в виде отдельных файлов, имена которых начинаются с цифры, за которой следует расширение: спрайты, фоны и костюмы нумеруются последовательно, начиная с 0, и сохраняются как файлы PNG и SVG; звуки нумеруются последовательно и сохраняются в виде файлов WAVE.

Файлы спрайтов

Файлы .sprite2 такие же, как и .sb2, за исключением того, что файл JSON называется sprite.json и представляет спрайт.

Формат

Ниже приведены описания типов объектов в project.json и sprite.json.

Объекты сцены

Объект Stage является корневым объектом project.json. Содержит следующие свойства:

• objName Название сцены. Обычно это "Stage", но зависит от выбранного языка.
• variables Глобальные переменные проекта.
• lists Глобальные списки проекта.
• scripts Скрипты сцены.
• scriptComments Комментарии сцены.
• sounds Звуки сцены.
• costumes Фоны сцены.
• currentCostumeIndex Номер текущего фона.
• penLayerID Номер файла изображения в ZIP-архиве проекта, содержащего перо, на этапе сохранения проекта.
• penLayerMD5 MD5-хэш файла изображения пера с последующим его расширением файла.
• tempoBPM Темп, когда проект был сохранен.
• videoAlpha Прозрачность видео, когда проект был сохранен.
• children Спрайты.
• info Дополнительная информация о пользователе и проекте.