Anthill Game Framework

Tiny framework for creating Flash games.

Инструменты пользователя

Инструменты сайта


guide:debug_monitor

Мониторинг значений

В число встроенных отладочных инструментов Anthill входит монитор (AntMonitor) который позволяет следить за изменениями значений в каких-либо переменных.

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

Работа с монитором очень проста. Чтобы добавить отображение значения в монитор, достаточно вызвать метод watch():

AntG.watch("pos x", actor.x);

Первым аргументом мы указываем имя значения которое будет идентифицировать его в мониторе, а вторым аргументом мы указываем непосредственно само значение. Обратите внимание на то, что метод watch() добавляет имя и значение в монитор и они будут отображаться там до тех пор пока не будут удалены или пока монитор не будет очищен. При изменении значения переменной следует повторно вызвать метод watch() чтобы обновить содержимое монитора. Таким образом, для регулярно обновляемых переменных, например, для тех которые определяют положение героя, следует вызывать метод watch() в методе update() или postUpdate().

Если одном месте необходимо обновить сразу несколько значений в мониторе, то перед и после вызова методов watch(), рекомендуется вызывать методы beginWatch() и endWatch(). Например:

AntG.beginWatch();
AntG.watch("hero x", myHero.x);
AntG.watch("hero y", myHero.y);
AntG.watch("hero health", myHero.health);
AntG.endWatch();

Вызов данных методов блокирует и разблокирует графическое обновление данных в мониторе, что снижает количество итераций на обновление окна монитора.

Чтобы удалить отображение какого-либо значения из монитора, необходимо вызвать метод unwatch() и передать в качестве аргумента имя значения которое было указано ранее при добавлении значения в монитор.

AntG.unwatch("hero health");

Чтобы удалить все значения из монитора, следует вызывать метод clear() непосредственно для монитора.

AntG.debugger.monitor.clear();


guide/debug_monitor.txt · Последние изменения: 30.04.2013 13:57 (внешнее изменение)