Описание
MovieClip является контейнером для фигур и других экземпляров MovieClip. Каждый объект MovieClip имеет временную шкалу, на которой воспроизводится анимация. Для создания экземпляров MovieClip можно использовать SceneGraphFactory.
Расширяет
- flwebgl.event.EventDispatcher
Методы
addChild(child)
Описание
Этот метод добавляет переданный дочерний объект в качестве верхнего дочернего элемента данного экземпляра MovieClip. Дочерний объект может быть фигурой или объектом MovieClip.
Параметры
Возвращает
- Если операция осуществлена успешно
- Тип — логическое значение
| Имя | Тип | Описание |
|---|---|---|
| child | Shape или MovieClip | Объект, который требуется добавить в качестве дочернего. |
addChildAt(child, index)
Описание
Этот метод добавляет переданный дочерний объект в указанный индекс данного ролика. Дочерний объект может быть фигурой или роликом.
Параметры
Возвращает
- Если операция осуществлена успешно
- Тип — логическое значение
| Имя | Тип | Описание |
|---|---|---|
| child | Shape или MovieClip | Дочерний объект, который требуется добавить в индекс. |
| index | number | Индекс, в который требуется добавить дочерний объект. |
getBounds(targetCoordinateSpace, bFastBounds)
Описание
Этот метод возвращает ограничительный прямоугольник.
Параметры
Возвращает
- Границы экранного объекта
- Тип — flwebgl.geom.Rect
| Имя | Тип | Описание |
|---|---|---|
| targetCoordinateSpace | Shape или MovieClip | (Необязателен, значение по умолчанию = не задано) Экранный объект, задающий используемую систему координат. Если значение не задано, он возвращает локальные границы. |
| bFastBounds | булево | (Необязателен, значение по умолчанию = true) Указывает, возвращать ли исходные границы (границы по умолчанию) — для быстроты вычислений — или же преобразованные локальные границы (более точно, но сравнительно медленно). |
getChildAt(index)
Описание
Этот метод возвращает дочерний объект в указанный индекс этого ролика. Если возвращено значение «undefined», в указанном индексе отсутствует дочерний объект
Параметры
Возвращает
- Тип — Shape или MovieClip
Пример
В этом примере узел перемещен из одного объекта MovieClip в другой.
| Имя | Тип | Описание |
|---|---|---|
| index | number | Индекс, по которому запрашивается дочерний объект. |
var stage = player.getStage();
var mc1 = stage.getChildAt(0);
var mc2 = stage.getChildAt(1);
var child = mc1.getChildAt(0);
mc2.addChildAt(child, 0);
getChildByName(name)
Описание
Этот метод возвращает экземпляр дочернего экранного объекта с заданным именем. Если несколько дочерних объектов имеют одинаковое заданное имя, метод возвращает первый объект в списке дочерних объектов.
Параметры
Возвращает
- Дочерний объект с заданным именем
- Тип — число
| Имя | Тип | Описание |
|---|---|---|
| name | string | Имя дочернего объекта, который требуется найти |
getChildIndex(child)
Описание
Этот метод возвращает индекс дочернего объекта в списке дочерних объектов. Возврат значения «1» означает, что объект не найдет.
Параметры
Возвращает
- Тип — число
| Имя | Тип | Описание |
|---|---|---|
| child | Shape или MovieClip | Дочерний объект, который требуется найти. |
getChildren()
Описание
Этот метод возвращает дочерний объект ролика.
Возвращает
- Тип — массив из объектов класса Shape или MovieClip
getCurrentFrame()
Описание
Этот метод возвращает номер текущего кадра. Номера кадров начинаются с 1.
Возвращает
- Тип — число
getCurrentFrameLabel()
Описание
Этот метод возвращает метку в текущем кадре на временной шкале экземпляра MovieClip. Если у текущего кадра отсутствует метка, он возвращает значение currentLabel — «undefined».
Возвращает
- Тип — строка
Пример
В этом примере анимация MovieClip остановлена при пересечении с кадром, имеющим метку «stop_anim».
function exitHandler(e) {
var m = e.getTarget();
var curLabel = m.getCurrentFrameLabel();
if (curLabel == "stop_anim")
m.stop();
}
var stage = player.getStage();
stage.addEventListener(flwebgl.events.Event.EXIT_FRAME, exitHandler);
getCurrentLabel()
Описание
Этот метод возвращает текущую метку, в которой точка воспроизведения расположена на временной шкале экземпляра MovieClip. Если у текущего кадра отсутствует метка, getCurrentLabel() возвращает имя предыдущего кадра, имеющего метку. Если метка отсутствует как у текущего, так и у предыдущего кадра, getCurrentLabel() возвращает значение «undefined».
Возвращает
- Тип — строка
getFrameLabels()
Описание
Этот метод возвращает список всех меток в ролике или монтажном кадре. Каждую метку можно найти по свойствам «name» и «frameNum»
Возвращает
- Массив пар {frameNum: number, name: string}
getGlobalColorTransform()
Описание
Этот метод возвращает глобальное преобразование цвета экранного объекта
Возвращает
- Тип — flwebgl.geom.ColorTransform
getGlobalTransform()
Описание
Этот метод возвращает глобальное преобразование цвета экранного объекта
Возвращает
- Тип — flwebgl.geom.Matrix
getLocalColorTransform()
Описание
Этот метод возвращает глобальное преобразование цвета экранного объекта
Возвращает
- Тип — flwebgl.geom.ColorTransform
getLocalTransform()
Описание
Этот метод возвращает глобальное преобразование цвета экранного объекта
Возвращает
- Тип — flwebgl.geom.Matrix
getName()
Описание
Этот метод возвращает имя экранного объекта
Возвращает
- Тип — строка
getNumChildren()
Описание
Этот метод возвращает число дочерних объектов.
Возвращает
- Тип — число
getTotalFrames()
Описание
Этот метод возвращает общее число кадров на соответствующей временной шкале.
Возвращает
- Тип — число
gotoAndPlay(frame)
Описание
Этот метод начинает воспроизведение ролика с указанного кадра.
Параметры
Пример
В этом примере к объекту MovieClip добавляется обработчик, позволяющий перейти напрямую к кадру 15 после пересечения с кадром 5.
| Имя | Тип | Описание |
|---|---|---|
| frame | число или строка | Номер или метка требуемого кадра |
function exitHandler(e) {
var m = e.getTarget();
var curFrame = m.getCurrentFrame();
if (curFrame == 5)
m.gotoAndPlay(15);
}
var stage = player.getStage();
stage.addEventListener(flwebgl.events.Event.EXIT_FRAME, exitHandler);
gotoAndStop(frame)
Описание
Этот метод переводит точку воспроизведения в заданный кадр фильма и останавливает ее в этом кадре.
Параметры
| Имя | Тип | Описание |
|---|---|---|
| frame | число или строка | Номер или метка требуемого кадра |
isVisible()
Описание
Этот метод возвращает флаг видимости экранного объекта.
Возвращает
- Тип — логическое значение
play()
Описание
Этот метод перемещает точку воспроизведения по временной шкале фрагмента ролика.
removeChild(child)
Описание
Этот метод удаляет дочерний объект из ролика. Дочерний объект может быть фигурой или роликом.
Параметры
Возвращает
- Если операция осуществлена успешно
- Тип — логическое значение
| Имя | Тип | Описание |
|---|---|---|
| child | Shape или MovieClip | Дочерний объект, который требуется удалить |
removeChildAt(index)
Описание
Этот метод удаляет дочерний объект в указанном индексе ролика. Дочерний объект может быть фигурой или роликом.
Параметры
Возвращает
- Если операция осуществлена успешно
- Тип — логическое значение
| Имя | Тип | Описание |
|---|---|---|
| index | number | Индекс дочернего объекта, который требуется удалить |
setChildIndex(child, newIndex)
Описание
Этот метод предназначен для изменения порядка дочерних объектов экземпляра MovieClip. Если в методе setChildIndex() указывается уже занятый индекс, изменяются только индексы в промежутке между старым и новым индексами экранного объекта. Все прочие индексы остаются неизменны.
Параметры
Пример
В этом примере берется самый нижний дочерний объект в рабочей области и перемещается поверх всех прочих.
| Имя | Тип | Описание |
|---|---|---|
| child | Shape или MovieClip | Дочерний объект, который требуется переместить |
| newIndex | Number | Новый индекс дочернего экранного объекта |
var stage = player.getStage(); var n = stage.getNumChildren(); var child = stage.getChildAt(n - 1); stage.setChildIndex(child, 0);
setLocalColorTransform(colorTransform)
Описание
Этот метод задает глобальное преобразование цвета экранного объекта.
Параметры
| Имя | Тип | Описание |
|---|---|---|
| colorTransform | flwebgl.geom.ColorTransform | Преобразование цвета, которое требуется настроить |
setLocalTransform(преобразование)
Описание
Этот метод настраивает локальное преобразование экранного объекта.
Параметры
| Имя | Тип | Описание |
|---|---|---|
| transform | flwebgl.geom.Matrix | Преобразование, которое требуется настроить |
Пример
В этом примере изменено локальное преобразование экземпляра MovieClip в рабочей области: 20 пикселей по горизонтали и вертикали.
var stage = player.getStage(); var mc = stage.getChildAt(0); var mat = mc.getLocalTransform(); mat.translate(20, 20); mc.setLocalTransform(mat);
setName(name)
Описание
Этот метод задает имя экранного объекта
Параметры
| Имя | Тип | Описание |
|---|---|---|
| name | string | Имя экранного объекта |
setVisible(flag)
Описание
Этот метод задает флаг видимости экранного объекта.
Параметры
| Имя | Тип | Описание |
|---|---|---|
| флаг | булево | Флаг видимости |
Пример
В этом примере переключается флаг видимости верхнего дочернего объекта в рабочей области.
var stage = player.getStage(); var mc = stage.getChildAt(0); var visibiliity = mc.isVisible(); mc.setVisible(!visibiliity);
stop()
Описание
Этот метод останавливает точку воспроизведения во фрагменте ролика.
Вход в учетную запись