# Flickering 問題分析
## 🔍 根本原因
### 問題の症状
- 画面が点滅する
- 特に行が描画される際に見える
### コード上の原因
**src/render.rs の draw_line() 関数**:
```rust
fn draw_line(terminal: &Terminal, start_x: i32, y: i32, line: &str) -> io::Result<()> {
let y = y as u16;
for (i, ch) in line.chars().enumerate() {
let x = start_x + i as i32;
if x >= 0 && x < terminal.width() as i32 {
terminal.move_to(x as u16, y)?; // ← execute!(MoveTo) 呼び出し
terminal.write_str(&ch.to_string())?; // ← write!() 呼び出し
}
}
Ok(())
}
```
**src/terminal.rs の実装**:
```rust
pub fn move_to(&self, x: u16, y: u16) -> io::Result<()> {
let mut stdout = io::stdout();
execute!(stdout, MoveTo(x, y))?; // ← 毎回新しい stdout インスタンス
Ok(())
}
pub fn write_str(&self, s: &str) -> io::Result<()> {
let mut stdout = io::stdout();
write!(stdout, "{}", s)?; // ← flush されない
Ok(())
}
```
### Flickering メカニズム
**フレーム内での実行順序**:
```
1. clear() → execute!(Clear) + flush # 画面が空白に
2. render_d51():
- draw_line() で最初の行：
* move_to() → execute!(MoveTo)
* write_str() → write!() [flush されない]
* move_to() → execute!(MoveTo)
* write_str() → write!() [flush されない]
...
- 複数の execute!() で部分的に画面が更新される
3. flush() → 最終的に flush
問題: Clear と初描画の間に「空白画面」が見える
+ 複数の execute!() で描画が分割される
= チラつき効果
```
## ✅ 解決策
### 方針：Atomic 描画
**1つの execute!() で全コマンドを一括実行し、flush は最後に1回だけ**
```rust
render_frame() {
// 1. 全コマンドを集めておく
let commands = [
Clear(ClearType::All),
MoveTo(0, 10), Print("train_line_1"),
MoveTo(0, 11), Print("train_line_2"),
...
];
// 2. 1つの execute!() で一括実行
execute!(stdout, commands)?;
// 3. 最後に flush（これまで見えていなかった出力が確定）
stdout.flush()?;
}
```
この方式だと：
- Clear と描画が atomic（分割されない）
- Flickering がない
## 📋 実装予定
### Step 1: Terminal API 再設計
- 複数の `move_to/write_str` 呼び出しの廃止
- 代わりに `render_atomic()` メソッド追加
### Step 2: Command ビルダーパターン
```rust
pub struct FrameBuilder {
commands: Vec<...>,
}
impl FrameBuilder {
fn add_text(&mut self, x, y, text) { ... }
fn build(self) -> Vec<...> { self.commands }
}
```
### Step 3: Render ロジック改修
- `render_d51/c51/logo()` を文字列構築に変更
- MoveTo/Print コマンドをビルド
### Step 4: テスト
- Flickering 確認
- CPU/Memory チェック