Update README.txt

README.txt

@@ -1,7 +1,7 @@
---ひめしツールキット v2--
+--ひめしツールキット v3--
 
 作成者：ひめし（Twitter: @himeshi_hob）
-第二版：2021年1月
+第3版：2021年4月
 対応バージョン：r9539以降（OTRP v29_2以降）
 
 1. ひめしツールキットとは？
@@ -12,10 +12,10 @@ MITライセンスとします．
 ツール配布の際に本ライブラリのファイルをそのまま同梱して配布していただいて構いません．その際，このreadmeを同梱する必要はありません．
 
 3. 導入方法
-ツールのフォルダにhm_toolkit_v2.nutおよびhm_libフォルダを配置し，tool.nutを専用の書式で記述します．
-tool.nutでは，下のようにhm_toolkit_v2をincludeした上で，hm_build()という関数のみ実装します．
+ツールのフォルダにhm_toolkit_v3.nutおよびhm_libフォルダを配置し，tool.nutを専用の書式で記述します．
+tool.nutでは，下のようにhm_toolkit_v3をincludeした上で，hm_build()という関数のみ実装します．
 
-include("hm_toolkit_v2") 
+include("hm_toolkit_v3") 
 function hm_build() {
   //ここに実行したい処理を書く．
 }
@@ -117,6 +117,23 @@ k) 関数実行ツール
 例 ... hm_exec_func_tl(((@pl, pos, str) gui.add_message_at(pl, str, pos)), "Hello, Simutrans!")
 この例では関数をラムダ式で渡しています．
 
+l) 橋建設ツール
+書式 ... hm_bridge_tl("アドオン名",[起点座標],[終点座標])
+
+線路/道路/運河など，waytypeに関わらず利用できます．
+ドラッグで橋を建設したときの挙動になります．
+
+例 ... hm_bridge_tl("np-slab-track-bridge",[4,0,0],[9,0,0])
+
+m) トンネル建設ツール
+書式 ... hm_tunnel_tl("アドオン名",[起点座標],[終点座標])
+
+線路/道路/運河など，waytypeに関わらず利用できます．
+ctrlを押しながらトンネルを建設したときの挙動になります．
+起点が坂（地上）の場合，トンネルの入口があわせて建設されます．
+
+例 ... hm_tunnel_tl("np-concrete-rail-tunnel-1",[4,0,0],[9,0,0])
+
 5. 特定範囲のオブジェクトからのアドオン名抽出
 マップ内の特定座標に軌道などを設置することで，アドオンを選択させることができます．アドオンやpakセットに依存しないため、高度の柔軟性を維持しつつ臨機応変に利用できます．
 
@@ -131,6 +148,7 @@ wayのアドオン選択を例に説明します．まず，アドオンを抽
 これで，キー"0"に対応するアドオン名が代入されます．
 
 アドオンを抽出するマップ領域を指定関数は，オブジェクトごとに次のとおりです．
+（橋とトンネルでは利用できません．）
 道路/軌道 ... hm_find_way(文字列キー, [領域開始], [領域終了])
 架線 ... hm_find_wayobj(文字列キー, [領域開始], [領域終了])
 標識/信号 ... hm_find_sign(文字列キー, [領域開始], [領域終了])
@@ -151,14 +169,15 @@ wayのアドオン選択を例に説明します．ユーザーにオブジェ
 番号は，オブジェクトの種類ごとに別で付番されます．
 
 ユーザーにオブジェクトを選択させるコマンドは，オブジェクトごとに次のとおりです．
+（橋とトンネルでは利用できません．）
 道路/軌道 ... hm_select_way("表示するテキスト")
 架線 ... hm_select_wayobj("表示するテキスト")
 標識/信号 ... hm_select_sign("表示するテキスト")
 駅 ... hm_select_station("表示するテキスト")
 オブジェクトの選択は，道路/軌道→架線→標識/信号→駅の順に要求されます．
 
 7. その他
-・v1向けに書かれたスクリプトはv2でもそのまま利用できます．
+・v1, v2向けに書かれたスクリプトはv3でもそのまま利用できます．
 ・hm_build()関数内で，ツールを実行しているplayerオブジェクトは，グローバル変数「player」で利用できます．
 ・マップ内のマーカーの値は，include("hm_lib/lib_obj_finder_v2") した上で，ObjFinder(player, [[探索起点座標], [探索終点座標]]).findLabel() で取得できます．