logo

libbulletml

Library of Bullet Markup Language (forked from https://shinh.skr.jp/libbulletml/index_en.html )git clone https://hacktivis.me/git/libbulletml.git

bulletmlrunner.h (4368B)

    

  1. /// BulletML を実行する
  2. /**
  3.  * 使い方：
  4.  * BulletMLRunner を継承していくつかの純粋仮想関数を実装する。
  5.  */
  7. #ifndef BULLETRUNNER_H_
  8. #define BULLETRUNNER_H_
  10. #include "bulletmltree.h"
  11. #include "bulletmlcommon.h"
  13. #include <vector>
  14. #include <memory>
  16. class BulletMLParser;
  17. class BulletMLNode;
  18. class BulletMLRunnerImpl;
  20. typedef std::vector<double> BulletMLParameter;
  22. /// BulletMLRunner が状態伝達に使用するクラス
  23. class BulletMLState {
  24. public:
  25. 	DECLSPEC BulletMLState(BulletMLParser* bulletml,
  26. 						   const std::vector<BulletMLNode*>& node,
  27. 						   std::shared_ptr<BulletMLParameter> para)
  28. 		: bulletml_(bulletml), node_(node.begin(), node.end()), para_(para) {}
  30. 	DECLSPEC BulletMLParser* getBulletML() { return bulletml_; }
  31. 	DECLSPEC const std::vector<BulletMLNode*>& getNode() const { return node_; }
  32. 	DECLSPEC std::shared_ptr<BulletMLParameter> getParameter() { return para_; }
  34. private:
  35. 	BulletMLParser* bulletml_;
  36. 	std::vector<BulletMLNode*> node_;
  37. 	std::shared_ptr<BulletMLParameter> para_;
  39. };
  41. /// BulletML を実行するクラス
  42. /**
  43.  * <pre>
  44.  * 使い方。
  45.  *  1. これを継承して、Bullet を実際に動かせるクラスを作る。
  46.  *  2. 純粋仮想関数を全て実装する。
  47.  *  3. 必要なら、changeDirection などのために必要な仮想関数を実装する。
  48.  *  4. このクラスのオブジェクトに対して、com_->run(); などとする。
  49.  * </pre>
  50.  */
  52. class BulletMLRunner {
  53. public:
  54. 	DECLSPEC explicit BulletMLRunner(BulletMLParser* bulletml);
  55.     DECLSPEC explicit BulletMLRunner(BulletMLState* state);
  56.     DECLSPEC virtual ~BulletMLRunner();
  58. 	/// 実行する
  59.     DECLSPEC void run();
  61. public:
  62. 	/// 実行が終了しているかどうか
  63. 	DECLSPEC bool isEnd() const;
  65. public:
  66. 	// ----- 絶対実装しなければならない関数群の始まり -----
  67. 	//@{
  68. 	/// この弾の角度を求める
  69. 	/**
  70. 	 * @return 角度を度単位で、上方向 0 で時計周りで返す
  71. 	 */
  72. 	DECLSPEC virtual double getBulletDirection() =0;
  73. 	/// この弾から自機を狙う角度を求める
  74. 	/**
  75. 	 * @return 角度を度単位で、上方向 0 で時計周りで返す
  76. 	 */
  77. 	DECLSPEC virtual double getAimDirection() =0;
  78. 	/// この弾の速度を求める
  79. 	DECLSPEC virtual double getBulletSpeed() =0;
  80. 	/// デフォルトの速度を求める
  81. 	DECLSPEC virtual double getDefaultSpeed() =0;
  82. 	/// ランクを求める
  83. 	/**
  84. 	 * @return 0 から 1 までの実数
  85. 	 */
  86. 	DECLSPEC virtual double getRank() =0;
  87. 	/// action を持たない弾を作る
  88. 	DECLSPEC virtual void createSimpleBullet(double direction, double speed) =0;
  89. 	/// action を持つ弾を作る
  90. 	/**
  91. 	 * @param state
  92. 	 * 新しい弾の BulletMLRunner のコンストラクタに渡すこと。
  93. 	 * もし渡さないのであれば、delete で解放しなければならない。
  94. 	 */
  95. 	DECLSPEC virtual void createBullet(BulletMLState* state,
  96. 									   double direction, double speed) =0;
  97. 	/// 弾の基準となるターンの値を返す、通常はフレーム数
  98. 	/**
  99. 	 * @return
  100. 	 * ゲームごとの基準でオーダーは変更して構いませんが、
  101. 	 * 負数は許されません。
  102. 	 * xml データ上で、wait と term のオーダーが揃っていれば問題ありません。
  103. 	 */
  104. 	DECLSPEC virtual int getTurn() =0;
  105. 	/// 死ぬ
  106. 	DECLSPEC virtual void doVanish() =0;
  107. 	//@}
  108. 	// ----- 絶対実装しなければならない関数群の終わり -----
  110. 	// ----- 必要があれば実装する関数群の始まり -----
  111.    	//@{
  112. 	/// 弾の方向を指定した方向に変更する
  113. 	DECLSPEC virtual void doChangeDirection(double) {}
  114. 	/// 弾の速度を指定した値に変更する
  115. 	DECLSPEC virtual void doChangeSpeed(double) {}
  116. 	/// accel に対するインターフェイス
  117. 	/**
  118. 	 * @todo
  119. 	 * horizontal, vertical の type は未実装です。
  120. 	 * どれも absolute になってしまいます。
  121. 	 */
  122. 	DECLSPEC virtual void doAccelX(double) {}
  123. 	/// accel に対するインターフェイス
  124. 	/**
  125. 	 * @todo
  126. 	 * horizontal, vertical の type は未実装です。
  127. 	 * どれも absolute になってしまいます。
  128. 	 */
  129. 	DECLSPEC virtual void doAccelY(double) {}
  130. 	/// 弾の速さの X 方向成分を返します
  131. 	/**
  132. 	 * accel を使う場合はオーバーライドして下さい
  133.  	 */
  134. 	DECLSPEC virtual double getBulletSpeedX() { return 0; }
  135. 	/// 弾の速さの Y 方向成分を返します
  136. 	/**
  137. 	 * accel を使う場合はオーバーライドして下さい
  138.  	 */
  139. 	DECLSPEC virtual double getBulletSpeedY() { return 0; }
  140.     //@}
  141. 	// ----- 必要があれば実装する関数群の終わり -----
  143. 	/// 乱数を返す
  144. 	/**
  145. 	 * 見てのとおり、デフォルトでは std::rand が用いられます。
  146. 	 */
  147. 	DECLSPEC virtual double getRand() { return (double)rand() / RAND_MAX; }
  149. private:
  150. 	/// BulletMLRunnerImpl をオーバーライドする場合、これもオーバーライドする
  151. 	DECLSPEC virtual BulletMLRunnerImpl* makeImpl(BulletMLState* state);
  153. protected:
  154. 	std::vector<BulletMLRunnerImpl*> impl_;
  156. };
  158. #endif // ! BULLETRUNNER_H_