🛡️ 📙 🤨 Duo OGRE 3DおよびSDL 🐹 🌫️ 🍃

最近、OGREエンジンに関連する記事が含まれます。簡単なプログラムの作成に関する投稿があるので、延期せずにこの記事を書くことにしました。少し前に、SDLライブラリの表面的な概要を少し書いたことがありますが、ここでは続きとして、このライブラリの具体的な使用例、つまりエンジンで動作させる方法を説明します。

イントロ

まず、質問に答えます-なぜですか？ OGRE自体は、ほとんどの一般的なプラットフォームで動作し、視覚化、およびユーザー入力の処理のためのウィンドウを作成できます。これは、オフィスでの多くのレッスンです。エンジンサイトでは、OISライブラリの使用を推奨しています。これは確かにそうであり、以前はLinuxで記述しなければならなくなるまで、このライブラリとともにエンジンを使用していました。その後、不快な瞬間が生じました。 OGREウィンドウは、私が理解していなかった理由により、ドラッグアンドドロップへの応答を拒否することが多く、しばしば画像がちらつきました（CompizまたはEmeraldとの競合の疑いがありました）。 OISを使用した入力は適切な速度を誇ることができず、マウスを数秒間使用した後、プログラムはできるだけ早く閉じたいと考えていました。次に、OISの代替としてSDLを試すことにしました。ライブラリは、割り当てられた責任に非常にうまく対処しました。ウィンドウを作成し、入力を処理しながら、適切な速度を示しました。

プログラムの枠組み

そのため、 OGRE SDKとSDL SDKが必要です。それらをインストールするプロセスについては説明しません。これはシステムによって異なるため、このトピックに関する多くの簡単なレッスンがあります。すぐにポイントを取得しましょう。最初のタスクは、SDLがウィンドウの作成と入力の処理に関与するプログラムコードを記述することです。OGREは、外部のウィンドウにのみレンダリングします。少なくともWindowsとLinux間でコードを移植できるようにします。

SDLを初期化し、それを使用してウィンドウを作成することから始めましょう。

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

#include <Ogre.h> #include <SDL.h> #ifdef _WINDOWS #include <SDL_syswm.h> #endif ... // SDL SDL_Init(SDL_INIT_VIDEO); // SDL_putenv(( char *) "SDL_VIDEO_CENTERED=true" ); // 800x600@16 OpenGL SDL_SetVideoMode(800, 600, 16, SDL_OPENGL); // SDL_WM_SetCaption( "Demo window" , NULL); * This source code was highlighted with Source Code Highlighter .

次に、OGREを構成し、ビジュアライザーをインストールする必要があります。プログラムのこの部分をどのようにコーディングするかは、すべての人にとって純粋に個人的な好みです。ここでは、最も必要なプラグインのみを手動でダウンロードし、必要なパラメーターを設定する権利を確保しました。主なことは、OGREを使用してウィンドウを作成しないことです。

//ルートオブジェクトを作成してOGREの初期化を開始します
Ogre :: Root * root = new Ogre :: Root（）;
//現在のフォルダー（または別の場所）からOpenGLビジュアライザープラグインをダウンロードします
#ifdef _WINDOWS
root-> loadPlugin（ "./RenderSystem_GL.dll" ）;
#else
root-> loadPlugin（ "./RenderSystem_GL.so" ）;
#endif
//ビジュアライザー自体を作成します
Ogre :: RenderSystem * rs = root-> getRenderSystemByName（ "OpenGL Rendering Subsystem" ）;
// ...最新のものにする
root-> setRenderSystem（rs）;
// ...そしてビデオモードを設定します
rs-> setConfigOption（ "Full Screen" 、 "no" ）;
rs-> setConfigOption（ "ビデオモード" 、 "800 x 600 16ビットカラー" ）;
// OGREを初期化しますが、ウィンドウを自動的に作成しません
root->初期化（ false ）;
*このソースコードは、ソースコードハイライターで強調表示されました。

最も興味深いのは、OpenGLコンテキストがすでに受信されていることをOGREに伝えることであり、それにレンダリングする必要があります。

// OGREウィンドウを作成するためのパラメーターを設定します。
//実際、ウィンドウは作成されません。 OGREにどこに伝えるのか
//レンダリングします
Ogre :: NameValuePairList params ;
#ifdef _WINDOWS
SDL_SysWMinfo情報;
SDL_VERSION（＆info.version）;
SDL_GetWMInfo（＆info）;
params [ "externalWindowHandle" ] = Ogre :: StringConverter :: toString（reinterpret_cast <size_t>（info.window））;
params [ "externalGLContent" ] = Ogre :: StringConverter :: toString（reinterpret_cast <size_t>（info.hglrc））;
params [ "externalGLControl" ] = Ogre :: String （ "True" ）;
#else
// Linuxでは少し簡単に
params [ "currentGLContext" ] = Ogre :: String （ "True" ）;
#endif
//選択したオプションで「仮想」ウィンドウを作成します
Ogre :: RenderWindow * wnd = root-> createRenderWindow（ "メインウィンドウ" 、800、600、 false 、＆ params ）;
wnd-> setVisible（ true ）;
*このソースコードは、ソースコードハイライターで強調表示されました。

初期化を終了して、作業部分に移動します。

//ここで、処理のために次のイベントを追加します
SDL_Event evt;
//はい、ループを継続する必要があります
bool running = true ;
//メインレンダリングサイクル
while （running）
{
//前のフレームの時間から受信したシステムイベントと入力イベントを読み取ります
while （SDL_PollEvent（＆evt））
{
//ユーザーがウィンドウを閉じた場合、ループを終了します
if （evt.type == SDL_QUIT）
running = false ;
}
//フレームを1つ描画します
root-> renderOneFrame（）;
//何らかの理由で、SDL_GL_SwapBuffers（）を呼び出す必要があります; Windowsでのみ利用可能です。
// Linuxでは、これがなくても正常に動作し、使用するとバグが発生します。
#ifdef _WINDOWS
SDL_GL_SwapBuffers（）;
#endif
}
*このソースコードは、ソースコードハイライターで強調表示されました。

プログラムの最後で、削除することを忘れないでください：

//メインOGREオブジェクトを削除して、エンジンで使用されているすべてのリソースを解放します
ルートを削除します。
// SDLを閉じます
SDL_Quit（）;
*このソースコードは、ソースコードハイライターで強調表示されました。

コードは非常に短いことが判明し、コメントはスペースの半分を占めています。プログラムをコンパイルして開始すると、理解できない内容のウィンドウが表示されます。

この段階では、OGREがレンダリングできるビューポートまたはカメラは1つも作成されていないため、これは期待される結果です。したがって、ウィンドウに表示されるものはすべて、ビデオメモリ内の任意のデータです。

入力マネージャー

ここで、イベントをキャッチしてリスナーに送信するための小さな便利なシステムを作成するとよいでしょう。最初に、リスナーインターフェイスについて説明します。

// Input.h
#include <list>
#include <SDL.h>
///キーボードイベントリスナーインターフェース
クラス KeyboardListener
{
公開：
virtual〜KeyboardListener（）{}
仮想 void onKeyboardEvent（ const SDL_KeyboardEvent＆evt）= 0;
};
///マウスイベントリスナーインターフェース
クラス MouseListener
{
公開：
virtual〜MouseListener（）{}
仮想ボイド onMouseMotion（ const SDL_MouseMotionEvent＆evt）= 0;
仮想 void onMouseBtn（ const SDL_MouseButtonEvent＆evt）= 0;
};
///他のすべてのタイプのイベントのリスナーのインターフェース
クラス EventListener
{
公開：
仮想〜EventListener（）{}
仮想 void onEvent（ const SDL_Event＆evt）= 0;
};
*このソースコードは、ソースコードハイライターで強調表示されました。

リスナーインターフェイスを定義したら、入力マネージャークラス自体を記述できます。

クラス InputManager
{
プライベート：
typedef std :: list <KeyboardListener *> KeyboardListenersList;
typedef std :: list <MouseListener *> MouseListenersList;
typedef std :: list <EventListener *> OtherEventsListenersList;
プライベート：
KeyboardListenersList kb_listeners;
MouseListenersList mouse_listeners;
OtherEventsListenersList other_listeners;
公開：
InputManager（）{}
〜InputManager（）{}
///イベントをキャプチャして処理します
ボイドキャプチャ（）;
///キーボードイベントリスナーを登録します
void regKeyboardListener（KeyboardListener * l）;
///キーボードイベントリスナーの登録を解除します
void unregKeyboardListener（KeyboardListener * l）;
///マウスイベントリスナーを登録します
void regMouseListener（MouseListener * l）;
///マウスイベントリスナーの登録を解除します
void unregMouseListener（MouseListener * l）;
///一般的なタイプのイベントのリスナーを登録します
void regEventListener（EventListener * l）;
///イベントタイプリスナーの登録を解除します
void unregEventListener（EventListener * l）;
};
*このソースコードは、ソースコードハイライターで強調表示されました。

それでは、クラスの実装に移りましょう。主な関心事はcapture（）メソッドです：

SDL_Event evt;
while （SDL_PollEvent（＆evt））
{
スイッチ（evt.type）
{
//キーボードイベント
ケース SDL_KEYUP：ケース SDL_KEYDOWN：
{
KeyboardListenersList :: const_iterator kb_it = kb_listeners.begin（）、kb_end = kb_listeners.end（）;
for （; kb_it！= kb_end; ++ kb_it）
（* kb_it）-> onKeyboardEvent（evt.key）;
休憩 ;
}
//マウスイベント
ケース SDL_MOUSEBUTTONDOWN：ケース SDL_MOUSEBUTTONUP：ケース SDL_MOUSEMOTION：
{
MouseListenersList :: const_iterator m_it = mouse_listeners.begin（）、m_end = mouse_listeners.end（）;
for （; m_it！= m_end; ++ m_it）
{
if （evt.type == SDL_MOUSEBUTTONDOWN || evt.type == SDL_MOUSEBUTTONUP）
（* m_it）-> onMouseBtn（evt.button）;
if （evt.type == SDL_MOUSEMOTION）
（* m_it）-> onMouseMotion（evt.motion）;
}
休憩 ;
}
//他のすべてのイベント
デフォルト：
OtherEventsListenersList :: const_iterator other_it = other_listeners.begin（）、other_end = other_listeners.end（）;
for （; other_it！= other_end; ++ other_it）
（* other_it）-> onEvent（evt）;
}
}
*このソースコードは、ソースコードハイライターで強調表示されました。

このメソッドは、キューからイベントを抽出し、適切なリスナーに送信します。このコードは、さまざまな特定のタイプのイベントをリッスンするように簡単に調整できます。実際、非常に多くの非常に特殊なリスナーを作成できます。この場合、マウスとキーボードのリスナーの例を示しました。

学生を登録する方法を実装するための残りはほとんどありません。ここではすべてが単純なので、キーボードリスナーの登録メソッドにのみ実装コードを提供し、残りは類推によって実装されます。

void InputManager :: regKeyboardListener（KeyboardListener * l）
{
if （l && std :: find（kb_listeners.begin（）、kb_listeners.end（）、l）== kb_listeners.end（））
kb_listeners.push_back（l）;
}
void InputManager :: unregKeyboardListener（KeyboardListener * l）
{
if （l）
kb_listeners.remove（l）;
}
*このソースコードは、ソースコードハイライターで強調表示されました。

現在、完璧な入力マネージャーはありませんが、完璧ではありませんが、さらなる改善の点で想像力の余地があります。入力マネージャーを使用して、メインプログラムループを書き換えることができます。

InputManager * imgr = new InputManager（）;
while （！stop）
{
imgr-> capture（）;
root-> renderOneFrame（）;
...
}
imgrを削除します。
*このソースコードは、ソースコードハイライターで強調表示されました。

イベントを処理するには、対応するインターフェースを実装するクラスを作成する必要があります。少なくとも、プログラムを正しく終了するには、SDL_QUITイベントをキャッチする価値があります。

最後に

私は、SDLの使用を必要とは考えていませんが、それでも、ライブラリは非常に快適に使用できます。 APIは完全にCで記述されていますが、オブジェクト指向のOISインターフェースよりも使い勝手は劣っていません。 OGREにリンクしても、特に不便なことはありません。 OGREは、極端な条件下でのパフォーマンスを再び示しました。

Duo OGRE 3DおよびSDL

イントロ

プログラムの枠組み

入力マネージャー

最後に

More articles: