c++でCSVファイルを読み込む

　いま、ドラクエ風ターン制RPGの戦闘場面を作っている。モンスターの実データを自作すると大変なので、とりあえず試験的にWebの各所で公開されているドラクエ２のモンスターデータを使わせてもらっている。 　データはCSV形式でMacのローカルフォルダに置いてあり、プログラム実行時に読み込んで実際のモンスターのパラメータとして使っている。これまでc++でファイル操作をしたことがなかったが、昨今は有難いことにWebに良いサンプルが多数あるため、それらを改変して思ったより簡単に実装できた。 　なお、私のソースではクラス名の頭にcocosの"CC〜"に習って、"SS"（ShishiSan)という接頭語を付けている。 <pre class="prettyprint"> // モンスターデータCSV読込関数 bool SSBattleManager::readAllMonstersCSV() { ifstream ifs(SS_CSV_MONSTER); // 入力ストリーム string csvLine; // csv１行 if(!ifs) return false; // 読込エラー int number=1; // モンスター識別番号（画像ファイル名と連携） // １行ごとに順次読込 while ( getline(ifs, csvLine) ) { istringstream csvStream(csvLine); string csvCol; // １項目（列の項目） int cntCol=1; // 項目番号 ParamCreature tmpParam; tmpParam.number = number; number++; // １項目ごとに分解して構造体に追加 while ( getline(csvStream, csvCol, ',') ) { switch(cntCol){ case 1: tmpParam.name = csvCol; break; case 2: tmpParam.hp = atoi(csvCol.c_str()); break; case 3: tmpParam.mp = atoi(csvCol.c_str()); break; case 4: tmpParam.atk = atoi(csvCol.c_str()); break; case 5: tmpParam.def = atoi(csvCol.c_str()); break; ： // 中略 default: break; } ++cntCol; } m_AllMonsters.push_back(tmpParam); // 列の終端で１行分をvectorに追加 } return true; } </pre> 　簡単に解説。 　SS_CSV_MONSTER はcsvファイルへのフルパスです。Macなのでスラッシュ区切りでパスを書き（winなら¥）、たとえば "/Users/shishisan/monsters.csv"のようにdefineしておく。ifstream でファイルを開き、getline で１行読み込んで、さらにカンマ区切りに分割する。 　ParamCreature というのは、生物（勇者やモンスター）を表す、Creature クラスのパラメータ構造体。名前、HP、MP、攻撃力、守備力といったおなじみの属性を持たせるもので、Creature クラスのヘッダに定義されている。CSVの項目をカンマで分割し、おのおのパラメータに読み込む、というシンプルな構造。 　なお「モンスター識別番号」というのはモンスターに通し番号がふってあり、画像スプライトを表示するために使っている。画像スプライトに連番でたとえばスライムは01みたいにしてあり、表示時に使っている。 　CSVファイルで注意したいのは、文字コードをUTF-8にしておくこと。CSVファイルのみならず、アプリで日本語を使うさいにはソースの文字コードをUTF-8にしておく。

複数プロジェクトの起動時〜Workspace integrity ほか

1.cocos2d-x であるプロジェクトを開発中に、別のプロジェクトを開いたときの注意点。 Test1.xcodeproj を開いた状態で Test2.xcodeproj をコンパイルしてみたら、"Workspace integrity , coundnt load Test2 because it is already opened from another project or workspace" といったエラー。コンパイルできなくなる。Test1を閉じても同じだ。 → 対処：一旦、XCodeを終了し、Test2プロジェクトだけ再度開いてコンパイル。これで解決する。 <div class="separator" style="clear: both; text-align: center;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgJNlfXQVdqVso-NYk2FSETmsmXf3k5ZoGruHAWi_ThkWaLHX2Wk-iFM6bA9fE-00QJ5Lf_SNckMTFs_0B87a9y8wdbigfVum-jFx86AfavRPqah2-AH3W4P8nEoVwpu4QZV8d-1ADOw_o/s1600/%E5%90%8D%E7%A7%B0%E6%9C%AA%E8%A8%AD%E5%AE%9A.png" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgJNlfXQVdqVso-NYk2FSETmsmXf3k5ZoGruHAWi_ThkWaLHX2Wk-iFM6bA9fE-00QJ5Lf_SNckMTFs_0B87a9y8wdbigfVum-jFx86AfavRPqah2-AH3W4P8nEoVwpu4QZV8d-1ADOw_o/s200/%E5%90%8D%E7%A7%B0%E6%9C%AA%E8%A8%AD%E5%AE%9A.png" /></a></div> 2.新しいプロジェクトをRunした時に、iOSシミュレータが真っ黒になっているとき。 → iOSシミュレータのメニューにて、iOSシミュレータ＞コンテンツと設定をリセット これで再度Runすれば実行される。

cocos2d-xの autorelease() 関数について

　先日、けっこう困ったことがあったのでメモ。cocos2d-x のオブジェクトを継承したクラスのメモリ管理関連。 <div class="separator" style="clear: both; text-align: center;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgFvBv86lG57C3sYhxGLPb7SMX1j0AqzYHieHbSaKlSrDkjPXuZlurnMNFg0CPONwVFCOUDCx6504e_VhJF_VsmQ_8j7C6I0o1uMAbA4p3-DSLl25tsyd5htzrV_84lxXsMUol6njK0nyk/s1600/game1.png" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgFvBv86lG57C3sYhxGLPb7SMX1j0AqzYHieHbSaKlSrDkjPXuZlurnMNFg0CPONwVFCOUDCx6504e_VhJF_VsmQ_8j7C6I0o1uMAbA4p3-DSLl25tsyd5htzrV_84lxXsMUol6njK0nyk/s320/game1.png" /></a></div> 　CCLabelTTFを内包する、「メッセージボックス管理クラス」を作成してみた。（ゲーム上に出るメッセージボックスを表示したりするクラス。上の画像では「ステータス」「戦闘メッセージ」の２つです） cocos2d-x の作法に習って CCObjectクラスを継承し、CCSprite等を参考に実装。（ソースは説明のため実際より簡略化してある） <pre class="prettyprint"> // DQ風ウィンドウマネージャ "SSMsgBoxDQ.h" class SSMsgBoxDQ : public CCObject { public: SSMsgBoxDQ(void); virtual ~SSMsgBoxDQ(void); static SSMsgBoxDQ* createWithArgs(kSSMsgBoxType type, float fontSize, int cntCols, int cntRows, int cntMaxTxtLen); CCLabelTTF* getLabel(){ return m_label; }; ： protected: CCLabelTTF* m_label; // ラベル ： </pre> <pre class="prettyprint"> // DQ風ウィンドウマネージャ "SSMsgBoxDQ.cpp" SSMsgBoxDQ::SSMsgBoxDQ(void) { // コンストラクタ CCLog(__FUNCTION__); } SSMsgBoxDQ::~SSMsgBoxDQ(void) { // デストラクタ CC_SAFE_RELEASE(m_label); } SSMsgBoxDQ* SSMsgBoxDQ::createWithArgs(kSSMsgBoxType type, float fontSize, int cntCols, int cntRows, int cntMaxTxtLen) { // 初期化関数 SSMsgBoxDQ *pRet = new SSMsgBoxDQ(); if (pRet && pRet->initWithArgs(type, fontSize, cntCols, cntRows, cntMaxTxtLen)) { pRet->autorelease(); pRet->retain(); //※ 後に追加した部分 ※ return pRet; } else { CC_SAFE_DELETE(pRet); return NULL; } } </pre> 　このようにクラスを定義し、実際のゲームレイヤの初期化処理 Game::init() 内でメッセージボックスを生成。そして、たとえば画面タッチの Game::ccTouchEnded で表示内容を更新。ということを実験していたのだが、何度やっても更新されない。 <pre class="prettyprint"> void Game::Initialize() { ： // 前略 m_statusBox = SSMsgBoxDQ::createWithArgs(kSSMsgBoxTypeStatus, 13, m_cntPlayers, 3, 7); // メッセージボックス生成 ： } void Game::ccTouchEnded(cocos2d::CCTouch *pTouch, cocos2d::CCEvent *pEvent) { ： // 前略 // モンスターの HPやMPを更新 m_statusBox->updateVal(i, 1, tmpMonster->hp()); m_statusBox->updateVal(i, 2, tmpMonster->mp()); ： } </pre> そこでブレークポイントを作って動かしてみると、どうも init()内と、ccTouchEnded()内とで、ポインタ m_statusBox の指す内容が違う。というか ccTouchEnded()でオブジェクトが壊れている。ので、何日かハマった気がする。（８月末のことだが今思い出して書いています） 　今でこそ慣れたものの、当時はまだc++を思い出し思い出しだったのでさんざ調べてみたところ、やっと見つけた。英語だが、<a href="http://www.cocos2d-x.org/wiki/Reference_Count_and_AutoReleasePool_in_Cocos2d-x">こちらのサイト</a>がたいへん参考になった。いわく： <blockquote>The logic of CCAutoreleasePool is that, when you call object->autorelease(), this object is put into the autorelease pool. The pool can help you to retain this object's lifecycle till the end of current message loop. At the end of current message loop, if this object hasn't been retained by any other class/container, it will be released automaticaly. For example, layer->addChild(sprite), the sprite is added to the 'children list' of the layer, its lifecycle is retained till the release of layer, but not the end of current message loop.</blockquote> 　要点を書くと「autoreleaseによってオートリリースプールにオブジェクトが保持される。それによってオブジェクトは『今のメッセージループの終わりまで』保持され、もしこれらが他のクラスやコンテナによってリテインされなければその時に自動解放される。」たとえばレイヤーにaddChildすれば、そのライフサイクルはレイヤー解放までだが、現在のメッセージループの終わりまでではない。 　※ さらに分かりやすい解説が 上記英語記事の"An Error Sample"という項に書いてあるので具体例をご覧になれば理解が深まると思う。（まるまる引用してもアレなので割愛させて頂きます） 　私はこの「メッセージループ」という表現が聞きなれなかったのだが、ようはイベントというか、上記ゲームレイヤでいうところの init とか ccTouchEnded 関数などのことで、retain をしない／されないでいると、関数の終わりのところでオブジェクトが自動解放されてしまうよ、ということなのだ。解放されたポインタで何かしようとするとクラッシュします。 　そこで、対応として、createWithArgs 関数のクラス初期化処理に pRet->retain(); を追加したところ（最初はこの処理を入れてなかったため）、意図した通りにオブジェクトは解放されずに動いてくれた。 　なお、このことは<a href="http://www.atmarkit.co.jp/ait/articles/1304/23/news009_3.html">こちらの日本語の記事</a>、「自動解放したくない場合は」という項にも書いてあったのだが、その「根拠」がよくわからなかったので先の英語記事に辿り着いた次第。参考になれば幸いです。

cocos2d-x で自作フォントを使うときの注意（備忘録）

　いま、ドラクエの「格闘場」風ゲームを作っているので、フリーの<a href="http://ifs.nog.cc/slime4.hp.infoseek.co.jp/font/font.html">ドラクエフォント</a>を使わせて頂いている。なお、こちらのフォント（DragonQuestFCIntact のほう）は濁点・半濁点が、いわゆるドラクエ方式で表示される仕様のため、ガギグゲゴといった文字が無い。 そこで、濁点・半濁点のついた文字については自分でフォントを追加させてもらった。フォントを作ったことなど無かったので、濁点の追加とはいえ勉強になった。 　さて、cocos2d-xで自前のフォントを使う方法について。けっこう難儀したので忘れないようにメモしておこう。 <a href="http://stackoverflow.com/questions/3837965/how-to-add-custom-fonts-to-an-iphone-app">英語のサイト</a>を見る限り、cocos2d-x に限らず、XCodeでiOSアプリを作る際に、カスタムフォントを使う場合は同じようにしたらよいのではないか、と思う。 ## 手順 1. XCodeの「プロジェクトナビゲータ」上で、Resourcesに、ttfファイルを追加。（ファイル整頓のため Resources¥fonts¥ 内にした）ファイルをプロジェクトにコピーするか？という質問は、必要に応じてチェックを入れる。 2. プロジェクトナビゲータで、プロジェクト本体（画像参照）＞TARGETS＞Info＞Fonts provided by application で＋ボタン＞Item0 にフォント名を入力。 ふつうは、ここまでで手順おわり。<a href="http://study-cocos2d-x.info/mozi/152/">study cocos2dx</a>にもそう書いてある。フォントを新規に追加する場合は上の手順でできるはずだ。 <div class="separator" style="clear: both; text-align: center;"><a href="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhTUZkFI13oVWyvGungW1sd-CgUo-Cdm8aVqa4dNkiXH4ytjMCuGKAcomynDNzBpekvkrPQSm2ygESNvwAVlAdlvcd7YP-_RZUfycBIREqZlJBA5JqIV9x6_sFHUExXbIdnCGp-aMiNwW0/s1600/addfonts.png" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhTUZkFI13oVWyvGungW1sd-CgUo-Cdm8aVqa4dNkiXH4ytjMCuGKAcomynDNzBpekvkrPQSm2ygESNvwAVlAdlvcd7YP-_RZUfycBIREqZlJBA5JqIV9x6_sFHUExXbIdnCGp-aMiNwW0/s200/addfonts.png" /></a></div> 以下に、フォントファイルを何らかの理由で更新した時に自分が困ったことを書いておく。 ※ フォントファイルを修正して上書きしたときに、どうもフォントが更新されない。例えば、「パ」の半濁点の表示が気に入らない、ということでTTFファイルを修正→ XCodeに上書き、といった手順を踏むのだが、何度やってもパが「ハ」のままだ。ということで困った。ようやく解決できた。 「更新したフォントファイル」をドラッグドロップすると、古いフォントファイルがプロジェクトに残ってしまうことがある？ようなので、finderからプロジェクトを開き、確実に古いファイルを削除する。XCode側からは、ドラッグドロップで更新したフォントファイルを追加するよりは、「finderで、完全に古いフォントファイルが削除されたことを確認してから」プロジェクトに追加したほうがよい。これはXCodeのファイル管理のクセのようなものだろうか？プロジェクトナビゲータでdelete（ファイル削除）した後、新しいファイルをドラッグすると、うまく更新されてないことがあるようなので要注意。自分の環境だけだろうか？？？

XCode4.6で、Apple March-O Linker Error の対応

cocos2d-x の CCLabelTTF（テキストラベル）を管理するクラスを自作していたところ、途中からコンパイルが通らなくなって困った。何をしたかというと、
１）CCLabelTTF をメンバ変数に持つ自作クラス（SSMsgBoxDQ）を作成。
２）上記クラス内で自作関数（string 対応のprintfなど）を使用しているので、自作関数群を別ファイル（SSlib.h と SSlib.cpp）に抜き出し、SSMsgBoxからヘッダを読み込む。
３）その状態でコンパイル。

すると、ビルドが失敗し、タイトルのエラー「Apple March-O Linker Error」が出た。
linker command failed with exit code 1 (use -v to see invocation)

だそうである。正直よくわからないので、Webで調べてみると、多かったのが「プロジェクトに新規ファイル（この場合"SSlib.h"）が認識されていない。ということ。

そこでプロジェクト＞BuildPhases の、ビルド対象ファイルに SSlib.cpp が追加されていることを確認。きちんと追加されている。どうやら問題はここではないようだ。クラスからライブラリのヘッダを読み込んでいるのだが、クラスがおかしいのか、ライブラリがおかしいのか？？？

//  DQ風ウィンドウマネージャ
//  SSMsgBoxDQ.h

#include "SSlib.h"  // 関数ライブラリ

class SSMsgBoxDQ : public CCObject { ...

あれこれ修正して悩んだ結果、「ライブラリのヘッダ内に関数プロトタイプだけでなく、関数の実体を定義していた」のが原因だと判明。

それまで、「c++の関数ライブラリを作るのに、プロトタイプと関数定義を別々に書かないといかんのだろうか？面倒だから .h プロトタイプを書かないで関数定義し、.cpp は空っぽにしてみよう。」とやっていたので、そのためにコンパイルが通らなかったのだ。別々に書き直したら、エラー解消。横着はいかんなと反省。。。
以下、関数プロトタイプと関数本体をきちんと別々に記述したもの（ソースの抜粋）です。

// 関数ライブラリ "SSlib.h"
string strRepeat(const char* str, int count);

// 関数ライブラリ "SSlib.cpp"
#include "SSlib.h"

// 繰り返し文字列を得る（マルチバイト対応）
string strRepeat(const char* str, int count) {
    CCAssert(count>=0 && count<255, __FUNCTION__);
    
    string sRet;
    for(int i=0; i< count; ++i){
        sRet += str;
    }
    
    return sRet;
}

当面の目標

現在、簡単なゲームを作るため、XCode と cocos2d-xを使って色々な実験をしている。

当面の目標：

・XCode に慣れる
　新しいIDEって、慣れるまでけっこう苦労しますね。これまでVisualStudioに慣れてたので、XCodeはどうにも覚えることが多くてたいへんだ(；´Д｀)

・cocos2d-x の作法に慣れる
　新しいフレームワークに慣れるのも、少し時間がかかります。自分の場合、中途半端に難しいことをしようとしてしまうので（汎用性の高いクラスを作ろうと思ったり）、かえってややこしくなる部分があるのかもしれない。

・c++ について、いろいろ思い出す
　phpとか VBだと、型だとかメモリ管理にそこまで厳密でなくてもけっこうコードが書けてしまっていた。ので、そういた部分に非常に厳しい c 系の言語作法を思いだすのが本当に大変だ。宣言とか初期化しなくても、いきなり文字列を使えてしまう言語にくらべ、宣言、型変換、メモリ確保、などをきちんと書かなきゃならない言語は自分にとってまだ「面倒」という感じ。勉強始めて２週間くらいだが、ようやく思い出してきた。

・簡単でいいので、「ゲーム」と呼べるものを作ってみる
　iPhoneで動く「ドラクエの格闘場」めいたものを、勉強のために作ってみようかなと考えている。今は、CClabelTTF を使って、いわゆるRPGの「ステータス表示」みたいなものを作ろうと奮闘中だ。ステータス表示のための、ラベルを管理してくれるクラスを作成してます。