Образец XML пользовательской анимации

В этом разделе приведен образец кода XML, созданного для пользовательской анимации. Для создания собственных анимаций необходимо хорошо разбираться в XML.

Совет: В крупных компаниях эту задачу можно назначить архитектору документации.

Важное замечание: Перед прочтением этого материала убедитесь, что вам понятны термины, изложенные в разделе О библиотеке анимации.

В данном разделе рассмотрены следующие темы:

Основные понятия

Каждой группе анимации соответствует своя подпапка в папке библиотеки анимации. В каждой папке находится несколько файлов XML, которые составляют анимации группы. Каждый файл XML определяет одну анимацию. Анимация создается в файле XML с помощью одного элемента <Step>.

Для каждого шага (анимации) можно указать:

  • разрешать ли пользователю изменять значения свойства в мастерской библиотеки анимации;
  • можно ли сделать свойства угла, оси и расстояния анимированных объектов редактируемыми в мастерской библиотеки анимации, если значения свойств нельзя изменить.
  • скрыть или показать значения свойств Время начала и Время окончания в мастерской библиотеки анимации.

Анимация (шаг) содержит одно или несколько движений. Отдельные движения предварительно определены, и каждое движение имеет набор предварительно определенных свойств.

Совет: Для удобства использования рекомендуется повторно использовать отдельные элементы <Motion> (с полным набором свойств) из предварительно определенных файлов XML, заданных по умолчанию в библиотеке анимации. Значения каждого свойства набора можно изменить. Примеры повторно используемых элементов <Motion> выделены в приведенном ниже образце кода XML.

Образец кода XML

Вот примеры кодов XML, которые можно написать для создания пользовательской анимации с именем "Просмотр" и использовать для зеркального отображения.



Описание кода

Элементы XML из приведенного выше примера кода описаны здесь.

<Step>
Создание анимации. Параметры следующие:
Name: текст, отображаемый для определения анимации в мастерской библиотеки анимации.
ReadOnly: разрешать ли пользователю изменять значения свойства в мастерской библиотеки анимации.
  • "0": разрешить пользователю изменять значения свойств.
  • "1": запретить пользователю изменять значения свойств.
(Необязательно) MakeAngleAxisDistPtEditable: сделать ли свойства угла, оси, расстояния и точки анимированных объектов редактируемыми в мастерской библиотеки анимации, когда ReadOnly установлено на "1".
  • "0": предотвращает изменение пользователем свойств угла, оси, расстояния и точки анимированных объектов.
  • "1": позволяет пользователю изменять свойства угла, оси, расстояния и точки анимированных объектов.
ShowStartEnd: для каждого движения анимации скрыть или показать значения свойств Время начала и Время окончания в мастерской библиотеки анимации.
  • "0": скрыть Время начала и Время окончания.
  • "1": показать Время начала и Время окончания.
<Modifiables>
Описывает различные движения, составляющие анимации. Автономный, обязательный элемент.
<Motions>
Описывает отдельные движения, составляющие анимацию.
<Motion>
Создает отдельное движение в анимации. Каждое движение имеет следующий параметр:
Name: текст, отображаемый для определения движения в мастерской библиотеки анимации.
(Необязательно) ApplyWhenMirrored: для каждого движения анимации определяет, игнорируется ли исходное определение анимации и используется ли определение движения, описанное в зеркальном отражении XML.
  • "0": применяет исходное определение анимации в зеркальном отражении XML.
  • "1": игнорирует исходное определение анимации и использует определение движения, описанное в зеркальном отражении XML.
(Необязательно) Defined: для Motion.Color свойства Flash и SetColor движений, определяет, меняется ли цвет выбранного объекта во время этого шага анимации.
  • "0": устанавливает значение цвета "Не определено".
  • "1": учитывает значения RGB.

Прим.: Без указания параметра Defined значения RGB учитываются.

<PropSet>
Описывает набор свойств движения.
<Motion.XXX>
Определяет каждое свойство движения с помощью одного или нескольких параметров.
<Связи>
(Необязательно) Определяет тип связи с другими анимациями.

Прим.: Если не использовать этот элемент XML, зеркальное отражение анимации не выполняется.

<Зеркальное отражение>
(Необязательно) Создает тип связи с зеркальным отражением. Параметры следующие:
FolderName: имя папки, в которой расположен файл XML с описанием анимации для зеркального отражения.
FileName: имя файла XML, описывающего анимацию для зеркального отражения.

Прим.: В обоих параметрах FolderName и FileName учитывается регистр.