#

以前の作り方では、記事の文字を均等に折り返して1枚の絵にし、地形は文字の量やキーワードから別に作っていました。見た目と地形が、同じ情報から作られていませんでした。

そのうえ記事は長く、画像や表も入ります。記事をまるごと1枚の絵にしようとすると、メモリも描く時間も足りません。

リンクは折り返しで2行にまたがることがあります。行ごとの矩形を全部覚えておき、いちばん大きい矩形の場所にカップを置きます。同じリンクは1つのカップにまとめます。

絵は高さ512pxずつに分けて、1回に1枚ずつ描きます。全体で3,200万画素を超えそうなときは、記事を途中で切らずに解像度を下げます。記事からうまく作れなかったときは、実行中に以前の作り方へ切り替えて、そのまま遊べるようにしています。

起きたこと

記事を読み込むロード画面が、99%のあたりで数秒止まることがありました。止まっている間は、画面の演出もすべて止まります。

原因

描画スレッドが、別のスレッドで進む読み込みの完了を待っていました。

1つめは、演出の終わらせ方です。ロードが4秒を超えると、演出を先に終わらせていました。フェードが終わった時点で読み込みが済んでいないと、future.get() が結果を待つあいだ、描画スレッドがブロックされます。

2つめは、パーの計算です。記事を組み立てる最後の手順で、目的の記事までの最短の手数をデータベースから探していました。この探索も描画スレッドの上で動いていたので、リンクの多い記事ほど、描画が長く止まりました。

直し方

描画スレッドでは、待たないようにしました。毎フレーム wait_for(0) で、完了したかどうかだけを確かめます。まだなら、演出を続けます。

パーは、すぐに出せる仮の値で先に決めます。最短の手数は別のスレッドで探し、結果が届いたら、パーと旗の色を更新します。

src/game/scenes/LoadingScene.cpp（1080〜1084行目）

if (m_isLoading && m_loadTask.valid()) {
  auto status = m_loadTask.wait_for(std::chrono::milliseconds(0));
  if (status == std::future_status::ready) {
    try {
      m_loadedData = m_loadTask.get();

直したときのコミット：38514d0（2026年6月17日）

src/game/systems/HtmlTerrainRegions.h（10〜16行目）

auto add=[&](const auto& r,HtmlRegionKind kind) {
    out.push_back({r.x/texture.width,r.y/texture.height,r.width/texture.width,r.height/texture.height,kind});
};
for(const auto& r:texture.headings) add(r,HtmlRegionKind::Heading);
for(const auto& r:texture.images) add(r,HtmlRegionKind::Body);
// 表は縦長になりやすいため、他の要素と見分けが付くようバンカー（ハザード）として扱う。
for(const auto& r:texture.tables) add(r,HtmlRegionKind::Hazard);

地面に描いた記事の絵は、見出し・画像・表がどこにあるかを四角形で覚えています。それを絵の大きさで割って0〜1の割合に直し、そのまま地形を盛り上げる範囲にします。

見た目も地形も、同じ1回のレイアウトの結果から作るので、あとからずれることがありません。表は縦に長くなりやすいので、バンカーにしています。

値を変えるたびにプログラムを直してビルドし直すと、1回の調整に何分もかかります。12人で作っていると、その値がどこに書いてあるかを探すだけでも手間になります。

調整したい値は、コードの中で ConfigVar として1行で宣言します。すると、設定ファイル config.toml にその項目が自動で並びます。

ConfigVar<float> cfg_WallHitRumbleStrength{
                  "Camera.Reaction.WallHit",   // 設定ファイルの見出し
                  "WallHitRumbleStrength",     // 項目の名前
                  0.850f,                      // 最初の値
                  "壁衝突時振動強度" };          // 説明

[Camera.Reaction.WallHit]
              WallHitRumbleStrength = 0.85

ゲームはこのファイルの更新時刻を見ていて、保存されたら読み直します。ゲームを動かしたまま、値だけが変わります。配布するときは --bake を付けて起動し、config.bin にまとめます。

場面ごとの振動の強さと長さは、どれもこの設定ファイルで変えられます。今の値は次のとおりです。

起きたこと

タイトルやステージ選択に戻るたびに、ゲームのメモリ使用量が増えていました。これを直した次の日、今度はステージに入ると、背景の空（スカイボックス）が表示されなくなりました。

原因

メモリが増えていたのは、読み込んだモデルやテクスチャを、画面が切り替わっても解放していなかったからです。そこで、タイトルとステージ選択に入るたびに、テクスチャの管理クラスを作り直すようにしました。

ところが、ゲーム画面のシーンは起動時に1回だけ作り、ずっと使い回しています。そのシーンが、作り直す前のテクスチャを指すハンドル（識別番号）を持ったままでした。ハンドルがあるので「読み込み済み」と判断し、読み直していませんでした。

直し方

タイトルとステージ選択に入るときに、リソース・テクスチャ・キャッシュをまとめて解放します。ゲーム画面に入るときは、持っているハンドルを無効な値に戻してから、スカイボックスを作ります。

解放する側を直すなら、参照を持っている側も一緒に見直す必要がありました。

include/scenes/Game.h（312〜314行目、2792〜2795行目）

skyboxTexture_ = TextureManager::INVALID_TEXTURE;
skyboxTextureApplied_ = false;
CreateSkybox(world);
…
bool EnsureSkyboxTextureLoaded() {
    if (skyboxTexture_ != TextureManager::INVALID_TEXTURE) {
        return true;
    }

直したときのコミット：ac8f827（メモリ、2026年1月28日）、5f54a77（スカイボックス、2026年1月29日）

include/config/ConfigVar.h（24〜28行目）

ConfigVar(const std::string& section, const std::string& name, const T& defaultValue,
          const std::string& comment = {})
    : m_Section(section), m_Name(name), m_Value(defaultValue), m_DefaultValue(defaultValue), m_Comment(comment) {
    ConfigManager::Instance().Register(this);
}

上の ConfigVar の宣言が1行で済むのは、このコンストラクタのおかげです。変数ができた瞬間に、自分を設定の管理役へ登録します。

管理役は、登録された値の一覧から設定ファイルを書き出し、ファイルが保存されたら読み直します。値を足す人は、設定ファイルのことを考えなくて済みます。