[ 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 с просьбой создать для неё динамический объект для отрисовки ( 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 задаёт классу World имя базового объекта и его характеристики. Пока в качестве характеристики я использовал строку инициализации, но никто не мешает подвесить 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