Материал из Скретч Вики

Значок «важно».png Внимание! Статья не завершена! Если ты хочешь помочь — отредактируй её!
Изображение файла .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 Дополнительная информация о пользователе и проекте.