> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/video-processing/image-stack.md).

# 画像スタック

圧縮された動画フレームを固定サイズのFIFOスタックに蓄積します。

圧縮済みの動画フレームを固定サイズのスタックに蓄積し、直近の N フレームを JPEG エンコードされたバイナリ blob として返します。共有ホスティングでも安全に使えるよう設計されており、フレームは常に JPEG 圧縮され、解像度制限内に収まるようダウンサンプリングされるため、メモリ不足を防げます。

## このブロックの仕組み

1. 各ワークフローサイクルで動画フレーム（WorkflowImageData）を受け取ります。
2. 設定された解像度制限（デフォルト 1920x1080）を超える場合、アスペクト比を維持したままフレームをダウンサンプリングします。
3. フレームを品質 75 で JPEG エンコードし、生成されたバイト列を保存します。
4. カメラごとの FIFO バッファ（deque）を最大で `stack_size` 個の圧縮済みフレーム。バッファがいっぱいになると、最も古いフレームは自動的に破棄されます。
5. もし `stack_size` 呼び出し間で変化する場合（例: 動的セレクタ経由で）、バッファのサイズが変更され、既存のフレームは新しい上限まで保持されます。
6. もし `clear` 入力が True の場合、現在のフレームが追加される前にバッファがフラッシュされます。
7. JPEG バイト blob のリスト（新しいものから順）と現在のフレーム数を出力します。

## 一般的な使用例

* **アクション / 活動認識**: N フレームのクリップを蓄積し、複数画像を推論できる視覚言語モデル（例: Google Gemini、Qwen）に渡して、動作の分類、イベントの検出、またはシーンで何が起きているかの記述を行います。
* **タイムラプスのスナップショット**: 定期的な視覚比較のために直近の N フレームを収集します。
* **イベントバッファリング**: 関心のあるイベントの前後のフレームをローリングウィンドウで保持します。

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/image_stack@v1` を、ワークフローにステップとして追加します。

### プロパティ

| **名前**              | **型**  | **説明**                                                           | 参照 |
| ------------------- | ------ | ---------------------------------------------------------------- | -- |
| `name`              | `str`  | このステップの一意の識別子を入力してください。                                          | ❌  |
| `stack_size`        | `int`  | スタックに保持するフレームの最大数（1-64）。スタックがいっぱいになると最も古いフレームが破棄されます。            | ✅  |
| `resolution_width`  | `int`  | ピクセル単位の最大フレーム幅（64-1920）。これより広いフレームはアスペクト比を維持したままダウンサンプリングされます。   | ✅  |
| `resolution_height` | `int`  | ピクセル単位の最大フレーム高さ（64-1080）。これより高いフレームはアスペクト比を維持したままダウンサンプリングされます。  | ✅  |
| `clear`             | `bool` | True の場合、現在のフレームが追加される前にフレームバッファ全体がフラッシュされます。シーン変更時の状態リセットに便利です。 | ✅  |

この **参照** この列は、 `workflow` の実行時に利用可能な動的値でプロパティをパラメータ化できる可能性を示します。 *バインディング* の詳細を参照してください。

### 実行時互換性

`ソフト` - ランタイム `hosted_serverless`, `dedicated_deployment`; 実行 `リモート`; 入力 `動画` : フレームスタックは video\_identifier ごとにプロセスメモリ内に保存されます。ステートレスまたは複数レプリカの HTTP ランタイムでリモートステップ実行を行う場合、連続するフレームが別のワーカープロセスによって処理されることがあり、その結果スタックがリセットされたり、フレーム履歴の一部しか保持されないことがあります。フレーム間で安定した結果を得るには、InferencePipeline でローカルステップ実行を使用してください。

`ソフト` - 入力 `image` : このブロックは、動画または繰り返しフレームのワークフローからの時間的コンテキストに依存します。静止画像／写真では、追跡、比較、集計、可視化に意味のある履歴がないため、このブロックの利点はほとんど、またはまったくありません。

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `画像スタック` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* input
  * `image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)): スタックに追加する動画フレーム。
  * `stack_size` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): スタックに保持するフレームの最大数（1-64）。スタックがいっぱいになると最も古いフレームが破棄されます。
  * `resolution_width` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ピクセル単位の最大フレーム幅（64-1920）。これより広いフレームはアスペクト比を維持したままダウンサンプリングされます。
  * `resolution_height` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ピクセル単位の最大フレーム高さ（64-1080）。これより高いフレームはアスペクト比を維持したままダウンサンプリングされます。
  * `clear` ([*`boolean`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/boolean.md)): True の場合、現在のフレームが追加される前にフレームバッファ全体がフラッシュされます。シーン変更時の状態リセットに便利です。
* output
  * `フレーム` ([`list_of_values`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)) : 任意の型の値のリスト。
  * `frames_count` ([`integer`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)) : 整数値。

</details>

<details>

<summary>JSON定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/image_stack@v1",
	    "image": "$inputs.image",
	    "stack_size": 5,
	    "resolution_width": 640,
	    "resolution_height": 480,
	    "clear": false
	}
```

</details>
