irrlicht & nx++ プログラミングメモ

メニュー

2011-06-23T10:55:54+09:00

**メニュー -[[トップページ]] -[[コメント板]] -[[リンク]] ---- **irrlicht 導入 -[[１. 始めに]] -[[２. 環境設定]] 基礎 -[[３. irrlicht初期化]] -[[４. 2Dグラフィック表示]] -[[５. ゲームパッド入出力]] **nx++

トップページ

2011-06-23T10:51:00+09:00

オープンソースグラフィックライブラリ、&font(cyan){irrlicht}とその派生物の&font(cyan){nx++}について学習し、その過程を記録するサイトです。対象はwindows 7となっておりますが、 windowsNTやlinux、macosxでも動く可能性はあります。合計：&counter() 今日：&counter(today) 昨日：&counter(yesterday)

４. 2Dグラフィック表示

2011-06-17T12:47:08+09:00

＊概要　　　　　　　　　　　　　　　　　　　　　　

　irrlichtで2Dグラフィックを表示します。表示しているのは、irrlichtのロゴと背景マップ、そしてインプ二匹です。インプは二枚が交互に切り替わりアニメーションしています。片方のインプには指定色の加減合成も行っています。irrlichtの2Dグラフィック機能は、色の加算合成？とクリッピング機能がありますが、回転ができないのでノベルゲームなどの静的なゲームに向いています。

サンプルで使用されている画像

・2ddemo.png

＊ソースコード　　　　　　　　　　　　　　　　　　

#include <tchar.h>
#include <irrlicht.h>

#ifdef WIN32
#include <windows.h>
#endif

using namespace irr;
using namespace core;
using namespace video;

#ifdef WIN32
int WINAPI _tWinMain( HINSTANCE,HINSTANCE,LPTSTR,int )
#else
int main( int,TCHAR* )
#endif
{
   // irrlichtを初期化。
   IrrlichtDevice *device = createDevice(EDT_OPENGL,
            dimension2d<u32>(480,360));
   IVideoDriver* driver = device->getVideoDriver();
   device->setWindowCaption(_T("2D Texture Draw Sample!"));

   // テクスチャ読み込み
   ITexture* images = driver->getTexture( _T("2ddemo.png") );
   driver->makeColorKeyTexture( images , position2d<s32>(0,0) );

   // 画像のインプ部分の領域設定
   rect<s32> imp1(349,15,385,78);
   rect<s32> imp2(387,15,423,78);

    // 描画ループ
   while(device->run() && driver)
   {
       // 時間を取得。
       u32 timecount = device->getTimer()->getTime();

       driver->beginScene(true, true, SColor(255,0,0,255));

       // テクスチャを描画
       // draw fire & dragons background world
       driver->draw2DImage(images, position2d<s32>(50,50),
               rect<s32>(0,0,342,224), 0,
               SColor(255,255,255,255), true);

       // インプを描画。
       driver->draw2DImage(images, position2d<s32>(164,125),
               (timecount/500 % 2) ? imp1 : imp2, 0,
               SColor(255,255,255,255), true);

       // 変化していく色が加算されたインプを描画。
       driver->draw2DImage(images, position2d<s32>(270,105),
               (timecount/500 % 2) ? imp1 : imp2, 0,
               SColor(255,( timecount) % 255,255,255), true);

       // irrlichtのロゴを描画。
       driver->draw2DImage(images, rect<s32>(10,10,108,48),
               rect<s32>(354,87,442,118));

       driver->endScene();
   }

   // デバイスの削除
   device->drop();
   return 0;
}

４. スプライト表示

2011-06-17T12:45:35+09:00

１. 始めに

2011-06-06T12:33:21+09:00

　このwikiは筆者がirrlichtの学習過程を残すために作成したものです。
筆者のプログラムスキルは非常に低い（謙虚とかそういうのじゃなくてホントに）し、
ハード関係の知識もないので、のでそこらへんを理解して目を通してください。

対象読者はCとC++のテンプレート機能までを、理解している。または、
わからないことを自分で調べられる読者。

コメント板ではirrlichtの質問は極力答えますが、CやC++などについては自分で勉強してください。

３. irrlicht初期化

2011-06-06T12:26:23+09:00

＊概要　　　　　　　　　　　　　　　　　　　　　　

　irrlichtを初期化して、空のウィンドウを表示します。
irrlichtは初期化と同時にウィンドウを生成してくれるので、CreateWindowなどのAPIを呼び出す必要はありません。

＊ソースコード　　　　　　　　　　　　　　　　　　

＊ソースコード解説　　　　　　　　　　　　　　　　

・ヘッダファイルのインクルード

#include <tchar.h>
#include <irrlicht.h>

#ifdef WIN32
#include <windows.h>
#endif

　まず、必要なヘッダファイルをインクルードします。UNICODEとマルチバイトに対応するためtchar.hを、
次にirrlichtを使用するためにirrlicht.hを、最後にWindows環境の場合のみwindows.hをインクルードします。
#define WIN32とはWindows上でのみ定義されるプリプロセッサで、メイン関数の部分も、環境により
main関数かWinMain関数に定義されます。

・名前空間省略設定

using namespace irr;
using namespace core;
using namespace video;

　irrlichtのクラスや定数、関数は全て名前空間に振り分けられています。
いちいちirr::video::～～と書くのは面倒なのでusing機能で省略します。

・irrlichtの名前空間の一覧表

irr	全てのクラスや関数、定数が含まれている空間。
irr::core	ベクトル、平面、配列、リストが含まれてる空間。
irr::gui	グラフィカルユーザーインターフェイスを簡単に作成するための便利なクラスが含まれている空間。
irr::io	入力/出力用のインターフェイスが含まれている空間。
irr::scene	シーン管理、メッシュ読み込みやビルボードなどの高レベル描画インターフェイスが含まれている空間。
irr::scene::quake3	quake3？関係が含まれている空間。
irr::video	ビデオドライバにアクセスする機能や２Ｄ、３Ｄのレンダリングなどの低レベル描画インターフェイスが含まれている空間。

・irrlichtの初期化

// irrlichtを初期化。
    IrrlichtDevice *device = createDevice(EDT_OPENGL,
          dimension2d<u32>(480,360));

    //ビデオドライバーを取得
    IVideoDriver* driver = device->getVideoDriver();

    // タイトルバー文字列設定
    device->setWindowCaption(_T("Hello World!"));

　irrlichtを使用するにはまず、irrlichtデバイスを作成しなければならないので、createDeviceでirrlichtのデバイスを作成します。createDeviceの引数は左から、描画エンジン、画面の大きさとなっています。描画エンジンには
Direct3D8,9、OpenGL、ソフトウェアを選べますが、今回はOpenGLにします。dimension2dは二次元座標を表すテンプレートクラスです。デバイスを作成すれば、irrlichtのエンジンにアクセスできるようになります。

次に作成したデバイスの関数getVideoDriverを使用して、irrlichtのビデオドライバーを取得します。
ビデオドライバーは基本的な描画やプリミティブ（三角形や頂点）単位の描画を行う際に使用します。

最後にsetWindowCaption関数でウィンドウのタイトル文字列をHello World!に設定しています。

createDevice()

IrrlichtDevice* createDevice(
          E_DRIVER_TYPE deviceType = EDT_SOFTWARE,
          const dimension2d< u32 > &     windowSize = (dimension2d< u32 >(640, 480)),
         u32     bits               = 16,
         bool    fullscreen     = false,
         bool        stencilbuffer = false,
         bool        vsync            = false,
         IEventReceiver *     receiver       = 0
    );

irrlichtデバイスを作成します。作成したデバイスは、様々なオブジェクトの生成に使用します。

deviceType　：　描画エンジンを設定します。これはEDT_DIRECT3D9やEDT_OPENGLなどを指定できます。
windowSize   ：　ウィンドウのサイズを指定します。
bits                   ：　フルスクリーンでのピクセルあたりのビット数を指定。ウィンドウモードでは無視されます。
fullscreen       ：　フルスクリーンモードが有効か、を指定します。
stencilbuffer ：　ステンシルバッファを有効にする場合にtrueを指定します。有効の場合、ステンシルシャドウが使用できます。
vsync               ：　垂直帰線待ちが有効か、を指定します。
receiver          ：　使用するユーザーレシーバーのポインタを指定します。　

戻り値　　　：　IrrlichtDeviceのポインタ、失敗した場合はNULLが戻ります。

getVideoDriver()

IVideoDriver* IrrlichtDevice::getVideoDriver();

2Dや3Dを描画するためのビデオドライバーを取得します。作成したビデオドライバーは低レベル描画に使用します。

戻り値　　　：　ビデオドライバーのポインタが戻ります。

setWindowCaption()

void IrrlichtDevice::setWindowCaption( const wchar_t * text );

ウィンドウキャプションを設定する。平たく言えば、ウィンドウのタイトルの事です。

text ：　新しいキャプションの文字列を指定します。

・描画ループ

    // 描画ループ
    while(device->run() && driver)
    {
        driver->beginScene(true, true, video::SColor(255,0,0,255));

        driver->endScene();
    }

　irrlichtの描画ループです。device->run()はirrlichtのウィンドウが閉じられるまでtrueを返します。
beginSceneはバックバッファや深度バッファ、ステンシルバッファなどのクリアを行い、endSceneはバックバッファをフロントバッファに表示します。irrlichtの描画命令はこのbeginSceneとendSceneの間に書きます。

run()

bool IrrlichtDevice::run();

内部でウィンドウメッセージの処理などを実行しています。

戻り値　　　　：　デバイスが動作しているならばtrueが戻ります。

beginScene()

bool IVideoDriver::beginScene(
        bool                    backBuffer = true,
      bool            zBuffer         = true,
        SColor               color           = SColor(255, 0, 0, 0),
        const SExposedVideoData &     videoData = SExposedVideoData(),
        rect< s32 > *     sourceRect = 0
    );

アプリケーションはレンダリングを実行する前にこの関数を呼び出す必要があります。
この関数ではバックバッファやZバッファがクリアされます。

backBuffer　：　trueの場合colorの色でバックバッファがクリアされます。falseの場合はバックバッファはクリアされず、colorは無視されます。
zBuffer　　　：　Zバッファをクリアするか指定します。
color　　　　：　バックバッファをクリアする色を指定します。
videoData　　：　別ウィンドウにレンダリング結果を表示したい場合に指定します。この機能は全ての描画エンジンに完全に実装されていません。
sourceRect　：　表示領域を指定します。この機能は全ての描画エンジンに完全に実装されていません。

戻り値　　　　：　失敗した場合、falseが戻る。

endScene()

bool IVideoDriver::endScene();

バックバッファをフロントバッファに表示します。アプリケーションはレンダリングを実行した後にこの関数を呼び出す必要があります。

戻り値　　　　：　失敗したらfalse、成功すればtrue。

・デバイスの破棄

// デバイスの削除
device->drop();

　irrlichtデバイスを削除します。正確には参照カウントを１減らしています。使い終わったら、”create”で始まる関数で取得したオブジェクトは、drop()で削除しましょう。

drop()

bool IReferenceCounted::drop();

”create”で作成したオブジェクトを削除します。”load”や”get”等で作成や取得したオブジェクトはdrop()を呼ぶ必要はありません。

戻り値　　　　：　オブジェクトが削除された場合、trueが戻る。

　初期化して、ウィンドウを表示しただけですがどうでしょうか？難しかったですか？irrlichtは日本語の資料が少なく、英語が苦手な人はそれだけで投げてしまいそうですね。もしわからないところがあれば、リンクにあるirrlichtの日本語サイトか、コメント板にどうぞ。Windows7でしか動作確認していないので、あしからず。
Direct3Dを触ったことがある人は、気づいたと思いますが、irrlichtの関数の形式はそっくりですね。
beginSceneとBeginScene、dropとRelease、createDeviceとDirect3DCreate9など。

では。

３. 初期化～ウィンドウ表示まで

2011-06-06T02:34:42+09:00

＊概要　　　　　　　　　　　　　　　　　　　　　　

＊ソースコード　　　　　　　　　　　　　　　　　　

＊ソースコード解説　　　　　　　　　　　　　　　　

・ヘッダファイルのインクルード

#include <tchar.h>
#include <irrlicht.h>

#ifdef WIN32
#include <windows.h>
#endif

・名前空間省略設定

using namespace irr;
using namespace core;
using namespace video;

　irrlichtのクラスや定数、関数は全て名前空間に振り分けられています。
いちいちirr::video::～～と書くのは面倒なのでusing機能で省略します。

・irrlichtの名前空間の一覧表

irr	全てのクラスや関数、定数が含まれている空間。
irr::core	ベクトル、平面、配列、リストが含まれてる空間。
irr::gui	グラフィカルユーザーインターフェイスを簡単に作成するための便利なクラスが含まれている空間。
irr::io	入力/出力用のインターフェイスが含まれている空間。
irr::scene	シーン管理、メッシュ読み込みやビルボードなどの高レベル描画インターフェイスが含まれている空間。
irr::scene::quake3	quake3？関係が含まれている空間。
irr::video	ビデオドライバにアクセスする機能や２Ｄ、３Ｄのレンダリングなどの低レベル描画インターフェイスが含まれている空間。

・irrlichtの初期化

・描画ループ

    // 描画ループ
    while(device->run() && driver)
    {
        driver->beginScene(true, true, video::SColor(255,0,0,255));

        driver->endScene();
    }

・デバイスの破棄

// デバイスの削除
device->drop();

では。

コメント/コメント板

2011-06-03T13:15:40+09:00

-test - 管理人 2011-06-03 13:15:40

コメント板

2011-06-03T13:15:25+09:00

#pcomment(reply)

リンク

2011-06-03T13:13:01+09:00

**irrlicht関係のサイトです。 [[Irrlicht A GoGo>>http://www.zgock-lab.net/irrlicht/index.htm]] 　　　　数少ない日本語のirrlichtの講座です。　　　とても分かり易く、一度目を通すことをオススメしますが、　　　現行バージョンとは互換性のないソースが一部ありますので注意してください。　　　また、nx++についての記述もあります。 [[Irrlicht Lesson>>http://lesson.ifdef.jp/]] 　　　　こちらも日本語のirrlichtの講座サイト。　　　まだ一部しか目を通していませんが、様々な情報があります。 **参考にさせてもらったサイト様。 [[DirectX9 プログラミングメモ>>http://www36.atwiki.jp/directx/]] 　　　　wikiの構成を参考にさせてもらいました。　　　また、同じ作者様のOPENGL、DirectX10はとても参考になります。