Simplestar Game

:::::::::::016話　Windows アプリケーション:::::::::::

どうも，星姫でーす．
今回はWindows アプリケーションということで，ウィンドウの描画までやってみようと思います．

ウィンドウだけに，窓からこんにちは（笑）

ハイ！では本題に入っていきましょうー．
さっそく皆さんに新規プロジェクトを立ち上げてもらいます．
アプリケーションの種類は次の図のように「Windows アプリケーション」にチェックを入れて下さい．

空のプロジェクトなので，新規に作成したソースファイルに次のコードを書き込んで下さい．
内容はウィンドウを描画するだけのプログラムです．
以下のテキストエリアを「Ctrl + A」で全選択し，「Ctrl + C」でコピーして利用します．

#include <windows.h> LPCWSTR clsName = L"Simplestar Window"; // ウィンドウクラス名 LPCWSTR WINDOW_NAME = L"ウィンドウ名"; // ウィンドウ名 const unsigned int CLIENT_WIDTH = 800; // クライアント領域のデフォルトの幅, フルスクリーンの場合は水平方向解像度 const unsigned int CLIENT_HEIGHT = 600; // クライアント領域のデフォルトの高さ, フルスクリーンの場合は垂直方向解像度 //メインウィンドウの初期化＆作成 int InitWindow(HINSTANCE hInstance, LPSTR lpCmdLine, int *nCmdShow, HWND hWnd, ATOM *atom); //メッセージ処理関数 LRESULT CALLBACK WindowProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam); //終了メッセージ void Quit(HWND hWnd); int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) { HWND hWnd = NULL; ATOM atom = 0; MSG msg = {NULL}; //ウィンドウの初期化＆作成 if(InitWindow(hInstance, lpCmdLine, &nCmdShow, hWnd, &atom)) return -1; //ウィンドウの初期化失敗 // メッセージ処理およびメインループ while(TRUE) { if(PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) { if(msg.message == WM_QUIT) break; else { TranslateMessage(&msg); DispatchMessage(&msg); } } Sleep(0); } DestroyWindow(hWnd); //ウィンドウの破棄 UnregisterClass(clsName, hInstance);//ウィンドウクラスの削除 return static_cast<int>(msg.wParam); } //メッセージ処理関数 LRESULT CALLBACK WindowProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { switch (msg) { case WM_CREATE: break; case WM_KEYDOWN: if(wParam == VK_ESCAPE) Quit(hWnd); break; case WM_KEYUP: break; case WM_CLOSE: Quit(hWnd); break; case WM_DESTROY: break; default: return DefWindowProc(hWnd, msg, wParam, lParam); } return 0; } //終了メッセージ void Quit(HWND hWnd) { if(IDYES == MessageBox(hWnd,L"終了しますか？",L"確認メッセージ",MB_YESNO | MB_ICONQUESTION | MB_DEFBUTTON2)) PostQuitMessage(0); return; } //ウィンドウの初期化，作成関数 int InitWindow(HINSTANCE hInstance, LPSTR lpCmdLine, int *nCmdShow, HWND hWnd, ATOM *atom) { // フルスクリーン BOOL isFullScreen = FALSE; for(int i=0;i<*nCmdShow;i++) { if(_stricmp(static_cast<char*>(&lpCmdLine[i]), "/f") == 0) { isFullScreen = TRUE; break; } } // ウィンドウクラスの初期化 WNDCLASSEX wcex = { sizeof(WNDCLASSEX), // この構造体のサイズ CS_HREDRAW | CS_VREDRAW, // ウインドウのスタイル WindowProc, // メッセージ処理関数の登録 0, // 補助メモリ 常に0 0, // 補助メモリ 常に0 hInstance, // アプリケーションインスタンスのハンドル LoadIcon(NULL, IDI_APPLICATION),// ウィンドウのアイコン LoadCursor(NULL, IDC_ARROW), // ウィンドウ内でのカーソル static_cast<HBRUSH>(GetStockObject(GRAY_BRUSH)), NULL, // 背景(GRAY)，メニュー clsName, // クラス名の指定 NULL // ウィンドウの小アイコン }; // ウィンドウクラスの登録 if(!(*atom = RegisterClassEx(&wcex))) return -1; //登録失敗 if(!isFullScreen) { // ウィンドウの作成 hWnd = CreateWindow(clsName, // 登録されているクラス名 WINDOW_NAME, // ウインドウ名 WS_OVERLAPPEDWINDOW, // ウインドウスタイル CW_USEDEFAULT, CW_USEDEFAULT, // ウインドウの横方向の位置 ウインドウの縦方向の位置 CW_USEDEFAULT, CW_USEDEFAULT, // ウインドウの幅 ウインドウの高さ NULL, NULL, // 親ウインドウのハンドル（省略）メニューや子ウインドウのハンドル hInstance, NULL); // アプリケーションインスタンスのハンドル ウインドウの作成データ // ウィンドウサイズを再設定する RECT rect; // クライアント領域の外の幅を計算 GetClientRect(hWnd, &rect); // クライアント部分のサイズの取得 int cw = rect.right - rect.left;// クライアント領域外の横幅を計算 int ch = rect.bottom - rect.top;// クライアント領域外の縦幅を計算 // ウインドウ全体の横幅の幅を計算 GetWindowRect(hWnd, &rect); // ウインドウ全体のサイズ取得 int ww = rect.right - rect.left;// ウインドウ全体の幅の横幅を計算 int wh = rect.bottom - rect.top;// ウインドウ全体の幅の縦幅を計算 ww = ww - cw; // クライアント領域以外に必要な幅 wh = wh - ch; // クライアント領域以外に必要な高さ // ウィンドウサイズの再計算 ww = CLIENT_WIDTH + ww; // 必要なウインドウの幅 wh = CLIENT_HEIGHT + wh; // 必要なウインドウの高さ // ウインドウサイズの再設定 SetWindowPos(hWnd, HWND_TOP, 0, 0, ww, wh, SWP_NOMOVE); }else { // フルスクリーン時，画面全体の幅と高さを取得 int sw = GetSystemMetrics(SM_CXSCREEN); int sh = GetSystemMetrics(SM_CYSCREEN); hWnd = CreateWindow( clsName, // 登録されているクラス名 WINDOW_NAME, // ウインドウ名 WS_POPUP, // ウインドウスタイル（ポップアップウインドウを作成） 0, // ウインドウの横方向の位置 0, // ウインドウの縦方向の位置 CLIENT_WIDTH, // ウインドウの幅 CLIENT_HEIGHT, // ウインドウの高さ NULL, // 親ウインドウのハンドル（省略） NULL, // メニューや子ウインドウのハンドル hInstance, // アプリケーションインスタンスのハンドル NULL // ウインドウの作成データ ); } if(!hWnd) return -2; //ウィンドウの作成失敗 // ウィンドウの表示 ShowWindow(hWnd, *nCmdShow); // WM_PAINTが呼ばれないようにする ValidateRect(hWnd, NULL); return 0; }

実行結果は以下のようになります．

こんな感じで灰色に塗りつぶされたウィンドウが表示されたら成功です．
終了させるには右上の閉じるボタンかEscキーを押します．

えーっとですね，これ全部説明するのは，私にはちょっと難しいです．
ここも他のサイト様にお任せしようと思います．
キーワードは「Windows API」です．
検索すると以下のサイトがヒットすると思います．

「WisdomSoft」
http://wisdom.sakura.ne.jp/

Win32 API入門について学べば，今回のコードの理解はそんなに難しくありません．
以下，私が今回のコードに抱いているイメージを示します．

説明：
プログラムを理解する上で，最初に頼るのが命令の順序です．
アプリケーションを起動した瞬間，最初にどの命令が読まれるのかを確かめます．
コンソールアプリでは int main() でしたが，Windowsアプリでは int WINAPI WinMain() になります．
アプリで最初に呼ばれる場所はエントリポイントと称されてます．
関数 InitWindow(); にてウィンドウを作成します．
ウィンドウを作成したら， while文で無限ループに入ります．
ここをメッセージループとしたのは，キー入力に対し翻訳とディスパッチ（プロシージャへ転送）を行うからです．

ウィンドウプロシージャはメッセージを受け取って，switch文でそれぞれのメッセージに対し処理する関数です．
特別なメッセージでない限り，ディフォルトのプロシージャを使って対応するように書かれています．
今回はEscキーと閉じるボタンが押された時に関して，終了メッセージを表示するように書きました．
Quit() を良く読むと PostQuitMessage(0); と書かれた命令があると思いますが，これは終了メッセージをポストすると言うことです．

ポスト？　一体何のことなのでしょうか？
ウィンドウ，アプリケーション，ディスパッチ，プロシージャ，ポストの５つのワードを使って図を描いてみます．
以下の図からメッセージの流れを感じ取ってください．

キーボードやマウスなどでモニタ上のウィンドウにメッセージを送ります．
そのウィンドウからメッセージキューにメッセージがポストされます．
順番を守ってキューはファーストイン・ファーストアウトを行います．
図でいうところの，キューからポロリと落ちてきたメッセージをアプリケーションがピークして拾います．
翻訳し，ディスパッチしてプロシージャにメッセージを送ります．
プロシージャは基本的にはウィンドウの操作（ディフォルトのプロシージャまかせ）を行いますが，特別なメッセージに対して
終了メッセージをキューにポストします．おわかりかな？ポストするとはキューにメッセージを送ることです．
終了メッセージをピークしたアプリケーションはメッセージループを抜けて，ウィンドウを破棄してアプリケーションを終了させます．

コードの解読について，おおざっぱなイメージをつかみ，プログラムの詳細を覚えないのがポイントです！
まったく読んだことがないプログラムは厄介ですが，とっかかりとして
最初に呼ばれるコードのところから順にメッセージの流れを見ていき，上記のような概念図を構築するところから始めます．
多少間違っていてもかまいません，ここのコードの塊は〜をしているーという理解の仕方を身につけましょう．
今後は，コードの解説を他サイト様に任せて，概念図を示していく形態を取ろうと思います．

次回から，今回作成したウィンドウに3D描画していきたいですね．

2009/11/08 初記．
2009/11/21 追加．

基礎を身につけることは難しかったが，基礎をもって応用を理解することは簡単だった．