Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Frame rate on and near Earth's surface: 30–40 FPS against 60 in space

オープン
#189 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
28/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
javascript, three.js

調査の方向性

Start by measuring on the user's real GPU; the issue names AGENTS.md as the place to document the ?perf=1 overlay. Inspect the meter readback, night-lights rendering, atmosphere pass, cloud shell (#88), and galaxy and night-sky passes, then use per-pass timings and toggles to prioritize costs. Done means surface views reach 50–60 FPS on the user's machine, or each remaining cost is measured and its reason recorded.

索引モデルが issue の本文から書いたものです。

説明

track:platform

Part of #121.

The problem

Production frame rates on a real GPU (the user's Mac, Brave):

View FPS
Space about 60
On or near Earth's surface, even looking down with no sky in view 30–40
Looking at the Sun from the surface by day, with time running 18–20 (seen on PR #187)

PR #187 is fixing its own surface regression (about 20 against 30–40) separately. This issue is the headroom on main.

Known or suspected costs on the surface

  • Cesium's draws run twice. The shadow context executes every draw as well as the replay (#103, upstream in portal-netgl).
  • The night lights are a second, unlit Cesium frame plus a decode pass (#93, PR #179). Check whether it renders on the day side, or when the night side isn't in view.
  • The meter's synchronous readback every 4th frame stalls the pipeline (found on #187). Make it asynchronous: a PBO plus fenceSync/clientWaitSync polling, read a frame or two late.
  • The atmosphere pass at full resolution, the cloud shell (#88), and the galaxy and night-sky passes. Each should cost nothing when its result can't show.

The work

  1. Measure on the real GPU first. The sandbox's SwiftShader can't time GPU work. Add a ?perf=1 overlay with per-pass GPU timings (EXT_disjoint_timer_query_webgl2 where available). Where it isn't, show CPU-side timings plus per-frame counts of draws, full-screen passes, render-target switches and readbacks, and URL toggles to switch each pass off, so the user can bisect the cost on their machine. Document it in AGENTS.md.
  2. With the user's numbers, take the biggest costs in order:
    • the asynchronous meter readback;
    • skipping invisible work (night lights by day, passes whose result is under a display step);
    • the atmosphere pass's resolution;
    • #103 upstream.

Done when

On the user's machine, the surface views reach at least 50–60 FPS, or each remaining cost is measured and recorded with the reason it stays.


Generated by Claude Code

主要言語
JavaScript
スター
55
フォーク
4
平均マージ
9時間 32分
マージ済み PR(30日)
136

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

celestiary/web のほかの issue

celestiary/web の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。