KDOC 29: Simutransのコードを読む

この文書のステータス

  • 作成
  • レビュー

概要

Simutransはオープンソースの鉄道会社シミュレーションゲームである。コードを読む。

Tasks

DONE 建設したときに何が起こっているか

  • simtool.ccにツール類の定義がある。建物破壊、地形改変、町の建設、スケジュール指定など
    • クリックしたときの動作がすべて関数workとして定義されているよう
  • tool_build_way_tが線路系建設クラスか
    • 構成メソッド…
      • get_desc
      • get_icon
      • get_tooltip
        • クリックしたときに出るやつ
      • get_defaultparam
      • is_selected
      • init
      • get_watype
        • get-desc()でdescを取り出し、descからget_wtyp()でwaytypeを取り出す
      • start_at
      • is_valid_pos
      • calc_route
        • 線路建設時のルート検索。線路建設時は始点と終点を指定する
        • shift押すとできるだけ直線するところを確認した
      • do_work
      • mark_tiles
    • waytype_tが交通手段を示す
    • 年月によってdescriptionが変わる
    • playerをとる関数が多いのは、プレイヤーが複数いるからか
    • grund_t *gr=welt->lookup(new_start); でクリック開始時の地面オブジェクトを取得する
      • new_startは3次元座標オブジェクト(coord3d)

Memo

https://github.com/kd-collective/simutrans/blob/bf0bd099857494ed35a5b6e210ae02eba2cdfe36/src/simutrans/tool/simmenu.h#L374-L378

/**

  • Class for tools needing two clicks (e.g. building ways).
  • Dragging is also possible.

*/ class two_click_tool_t : public tool_t { 









/**



    

  • Search a free place for a monument building
    • 

  • Im Gegensatz zum building_placefinder_t werden Strassen auf den Raendern
    • 

  • toleriert.
    • 




 */
class monument_placefinder_t : public placefinder_t {







    

  • get_tile_list でそのタイルの一覧を取っているようだ
    • 

  • レベルを取得する方法

      

    • uint16 level = gb->get_tile()->get_desc()->get_level()+1;
      • 

    • 建物がタイル、情報、高さを持っている
      • 

    • 

  • 市庁舎かを確認する方法
add_gb->get_tile()->get_desc()->is_townhall()
    • 

  • 座標のほかに、町の家リストがある
    • 






https://github.com/kd-collective/simutrans/blob/bf0bd099857494ed35a5b6e210ae02eba2cdfe36/src/simutrans/world/simcity.cc#L611-L617









// this function removes houses from the city house list
void stadt_t::remove_gebaeude_from_stadt(gebaeude_t* gb)
{
	buildings.remove(gb);
	gb->set_stadt(NULL);
	recalc_city_size();
}







    

  • 重み付けしたベクタ。要素をソートするのに役立つ

      

    • weighted_vector_tpl
      • 

    • 各要素が重みを保持している
      • 

    • 






https://github.com/kd-collective/simutrans/blob/bf0bd099857494ed35a5b6e210ae02eba2cdfe36/src/simutrans/world/simcity.cc#L739-L753









stadt_t::factory_entry_t* stadt_t::factory_set_t::get_random_entry()
{
	if(  total_remaining>0  ) {
		sint32 weight = simrand(total_remaining);
		for(factory_entry_t & entry : entries) {
			if(  entry.remaining>0  ) {
				if(  weight<entry.remaining  ) {
					return &entry;
				}
				weight -= entry.remaining;
			}
		}
	}
	return NULL;
}







    

  • entriesはイベントキューみたいな感じなのかな。各建物に対する操作を保持して、処理する
    • 






https://github.com/kd-collective/simutrans/blob/bf0bd099857494ed35a5b6e210ae02eba2cdfe36/src/simutrans/tool/simtool.cc#L431-L434









/* delete things from a tile



    

  • citycars and pedestrian first and then go up to queue to more important objects
    • 




 */
bool tool_remover_t::tool_remover_intern(player_t *player, koord3d pos, sint8 type, const char *&msg)







    

  • 三次元座標はいい感じに抽象化されている
    • 






https://github.com/kd-collective/simutrans/blob/bf0bd099857494ed35a5b6e210ae02eba2cdfe36/src/simutrans/dataobj/koord3d.h#L16-L19









/**



    

  • 3D Coordinates
    • 




 */
class koord3d