[ AmberSkyNet VR ]

Трёхмерные предметы у нас вертятся и летают, и это, конечно, хорошо.. Но например, если мы захотим написать изометрическую игру, или даже совсем двумерную, то не обязательно в ней использовать трёхмерные модельки.. Можно вполне обойтись плоскими картинками, т.е. спрайтами. Реализацией класса, который бы отрисовывал на сцене спрайты мы сейчас и займёмся. Возможно, для двумерной или изометрической игры понадобится специализированный класс мира (интерфейс IWorld), но им мы займёмся несколько позже, если надо будет...

CNodeSprite

Сделаем класс узла сцены, который бы отрисовывал нам спрайт. Наследовать его, конечно, будем от базового класса CNode, который реализует основные функции, общие для всех узлов сцены...

Сразу предусмотрим возможность анимации, чтобы не писать отдельный класс NodeSpriteAnimate, т.к. в общем-то отрисовка анимации делается простым смещением текстурных координат.
Так же сразу предусмотрим возможность спрайта оставаться всё время повёрнутым к камере (billbord) для реализации всяких эффектов типа огня, взрывов, облаков...

class CNodeSprite: public CNode {
public:
    CNodeSprite(IEngine* engine);
    ~CNodeSprite();

virtual bool LoadResource(); // загружаем ресурсы
virtual bool Draw(); // рисуем
virtual char Update(float tms);// изменяем состояние спрайта на время tms

// "перехватываем" установку параметров, характерных только для спрайта 
virtual void SetParam(const char* param_name,const char* param_value);

protected:

    UINT current_frame; //текущий анимационный кадр

    UINT Repeat; // число повторений анимации, 0 - бесконечно
    UINT Anim_Count_X; // количество кадров, умещающихся в текстуре по X
    UINT Anim_Count_Y; // количество кадров, умещающихся в текстуре по Y

    UINT Start_Anim; // номер кадра, с которого начинается анимация
    UINT Count; // число кадров в анимации
    
    bool Billbord; // если true - всегда повёрнут к камере
    
    float lifeTime; // "время жизни" (используется для анимации)
    float *dataBuffer; // буфер точек и текстурных координат

    IDrawObject *DrawSprite; // объект для отрисовки спрайта граф.менеджером

    IMaterial *DrawMaterial; // "материал" спрайта

};

Функция LoadResource предназначена для загрузки ресурсов, которые использует класс спрайта для отрисовки. Первым делом проверяется значение параметра "Texture" (которое устанавливается извне через функцию INode::SetParam() ). Если параметр не установлен - функция возвращает true, т.к. попытка загрузки ресурсов закончилась ошибкой.
Если имя текстуры уже задано, функция обращается к графическому менеджеру с просьбой создать для неё динамический объект для отрисовки ( IDevice::AddDrawObject() ). Динамический, т.к. текстурные координаты в нём будут постоянно меняться в разные моменты времени для разных объектов.
Далее создаётся массив данных, который заполняется значениями, предназначенными для отрисовки одного прямоугольника, на который натянута текстура. Впоследствии значения текстурных координат этого массива будут изменяться в функции Update().
Потом в полученном указателе на созданный менеджером графики обьект отрисовки IDrawObject устанавливаются указатель на этот массив, смещения в нем текстурных координат, итп.. Но это не всё.. надо подготовить текстуру :)
Пытаемся получить от менеджера графики IDevice материал с именем, совпадающим с именем используемой текстуры ( IDevice->GetMaterial() ). Если такой материал уже кто-то создал - запоминаем указатель на него в переменной DrawMaterial, если нет - создаём его ( DEVICER->AddMaterial( TextureName ) ) и устанавливаем в нём текстуру и параметры...
Дальше устанавливаем начальные значения переменных отвечающих за отрисовку спрайта и вызываем функцию Update(), чтобы она расчитала нам первоначальные значения в массиве данных Возвращем false, т.е. загрузка ресурсов прошла без ошибок.

Функция Draw устанавливает матрицу вида и отрисовывает спрайт. Если установлен признак Billbord, то координаты точек в буфере dataBuffer пересчитываются так, чтобы отрисовываемый прямоугольник был всегда перпендикулярен лучу обзора, исходящему из камеры.

Функция Update увеличивает переменную LifeTime на величину tms, и если результат больше параметра "Speed", то уменьшает величиную LifeTime на Speed (т.е. возвращаемся на начало анимации) и производит пересчёт текстурных координат с учётом заданных параметров анимации и номера текущего кадра.
Если мы отрисовали полный цикл анимации положенное число раз, то происходит удаление данного класса..

Базовые объекты

В предыдущем шаге мы научили класс мира загружать и сохранять элементы сцены в виде XML-файлов. Доработаем его немного - введём возможность описания базовых объектов.
Зачем нужны базовые обьекты? Сейчас поясню... Скажем, нам надо нарисовать сцену из 10 колонн. Без базовых объектов нам придётся у каждой из них описывать размеры, текстуру, характеристики материала.. А с базовым объектом мы один раз (у базового объекта) зададим характеристики общие для всех 10 колонн, а при формировании сцены просто напишем 10 раз ссылку на базовый объект и текущее положение колонны. При этом сами базовые обьекты на сцене не рисуются! Их вообще не существует в виде экземпляров классов. Они представляют собой всего лишь что-то вроде словаря, по которому получаем полное описание обьекта при его создании.

Добавим функции для поддержки базовых объектов в наш интерфейс мира IWorld и, соответственно, в его реализацию CWorldSimple:

bool SetBaseObject(const char *ObjName, const char *InitString);
const char *GetBaseObjectParam(const char *ObjName, const char *ParamName);

Функция SetBaseObject задаёт классу IWorld имя базового объекта и его характеристики. Пока в качестве характеристики я использовал строку инициализации, но никто не мешает подвесить XML-парсер и туда.. Это позволит нам создавать группу базовых объектов вызовом одной функци createNode. Но это возможно в будущем, если возникнет такая потребность. Пока же - строка инициализации, которая выглядит так:

Параметр=Значение;Параметр=Значение;...Параметр=Значение;

Функцию LoadWorld доработаем так, чтобы она различала секции описания базовых объектов и описания самого мира. В XML-файле может быть такое содержимое:

<?xml version="1.0" ?>
<file Name="FileName" />
...
<BaseObject >
    <BaseName Type="BaseType" ParamName="ParamValue" ... >
    ...
</BaseObject >
<World>
    <NodeType ParamName="ParamValue" ... >
    ...
</World>

<LogoAmberSkyNet Type="NodeSprite" Texture="AmberSkyNet.png" 
	  Size="5 5 5" Billbord="1" Repeat="0" />

   <LogoAmberSkyNet Pos="10 10 10" />

class ISound {
public:
    virtual ~ISound(){}

    virtual bool PlayFX(const char *FxName)=0;
    virtual bool PlayMusic(const char *FxName)=0;
    virtual bool StopMusic()=0;
    

};

svn co https://svn.sourceforge.net/svnroot/ambernet/tags/AmberSkyNet-0.10 ambernet_0.10