mieki256's diary

YARDてのは、Rubyのスクリプトソースの中に、ある決まったフォーマットでコメントを書いておくと、そこからドキュメントを作ってくれるツール、という認識でいいのかしら。

yardoc hoge.rb

てな形で実行すると、doc/ フォルダを作ってその中にhtmlでドキュメントを生成してくれる模様。

それらしいドキュメントを出力してくれた。ありがたや。しかし、一部書き方が分からないところが。

• クラス内の定数について説明を書きたい場合はどういうコメントを書けばいいのか。
• return a, b といった形で、複数の戻り値がある場合は、Array 扱いでいいのかどうか。
• 戻り値が int、Boolean、nil 等に変わる場合は、どういう書き方をすればいいのか。「@return」を複数書くらしいけど、出力されたソレが、「int, ... 」となってしまって。「int?」になる、と巷の解説ページには書いてあるのだけど。

ググってみても、そのあたりを解説してあるページには辿り着けず。

DXRuby + tmx で地形アタリ処理の実験中。

タイル毎の補正値を得るところまではできたのだけど、問題発生。上から下までずっと床タイルが並んでる場所で床補正をしていくと、無限ループに陥ってしまう…。上に補正する → そこにも床タイルがある → 上に補正する → 床タイルがある、を繰り返すから当たり前なんだけど。補正する回数制限をつけとかないとあかんなと。

数年前に、ドラキュラシリーズでそういうバグ映像を見かけたことを思い出したり。

1. プレイヤーキャラがボス敵の上に乗れる仕様が入ってた。
2. 動いてるボス敵の上に乗り続けてると、天井の中にプレイヤーキャラが押し込まれた状態になる。
3. ジャンプボタン等を押して、ボス敵から離れた瞬間、おそらくは床補正が働いて…。
4. BGマップの天井、壁、床の中を凄い勢いで飛び回り、まったく関係ない場所に出現しちゃう。

みたいなバグで。ソレを利用して、あえて爆速クリア、とかやる人まで出てきちゃって。

件のバグは、壁の中を高速移動していくプレイヤーキャラの映像が見えた気がするので、おそらく回数制限を設けて床補正、ぐらいはしてたのではないかと想像。そうじゃないと、無限ループに入ってフリーズするはずだし。

そういう場合、どう対処すればいいんだろう…。