MQL5 ビジュアルインジケーターパターン

カスタム MQL5 インジケーター作成のための実戦的パターン。適切な表示、バッファ管理、リアルタイム更新に対応。

自己進化型スキル: このスキルは使用を通じて改善されます。命令が間違っている、パラメータがズレた、ワークアラウンドが必要だった場合は、このファイルを直ちに修正してください。延期は避けてください。実際に再現可能な問題のみを修正対象とします。

このスキルを使うべき時

以下の場合にこのスキルを使用してください:

• MetaTrader 5 用のカスタム MQL5 インジケーターを作成する
• インジケーターの表示またはバッファの問題をデバッグする
• 適切なウォームアップ処理を伴う OnCalculate を設定する
• 新しいバー検出パターンを実装する

クイックリファレンス

必須パターン

表示スケール (小さい値 < 1.0 の場合):

IndicatorSetDouble(INDICATOR_MINIMUM, 0.0);
IndicatorSetDouble(INDICATOR_MAXIMUM, 0.1);

バッファセットアップ (表示 + 隠蔽):

SetIndexBuffer(0, BufVisible, INDICATOR_DATA);        // 表示
SetIndexBuffer(1, BufHidden, INDICATOR_CALCULATIONS); // 隠蔽

新しいバー検出 (ドリフト防止):

static int last_processed_bar = -1;
bool is_new_bar = (i > last_processed_bar);

ウォームアップ計算:

int StartCalcPosition = underlying_warmup + own_warmup;
PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, StartCalcPosition);

---

よくある落とし穴

空白表示: 明示的なスケール設定が必要です (表示スケールリファレンスを参照)

ローリングウィンドウドリフト: 隠蔽バッファを伴う新しいバー検出を使用してください (再計算リファレンスを参照)

プロット位置のズレ: 正しい PLOT_DRAW_BEGIN を計算してください (完全なテンプレートリファレンスを参照)

前方インデックス配列: 常に ArraySetAsSeries(buffer, false) を設定してください

---

キーパターン

本番用 MQL5 インジケーターの場合:

1. 小さい値 (< 1.0 範囲) に対する明示的なスケール設定
2. 再計算追跡用の隠蔽バッファ
3. 新しいバー検出がローリングウィンドウドリフトを防止
4. 静的変数が状態を効率的に保持
5. 適切なウォームアップ計算で位置ズレを防止
6. 前方インデックスでコードの明確性を実現

これらのパターンは、実際の MT5 開発で遭遇する最も一般的なインジケーター開発の問題を解決します。

---

トラブルシューティング

問題	原因	解決方法
インジケーターウィンドウが空白	小さい値のスケール未設定	INDICATOR_MINIMUM/MAXIMUM を明示的に設定する
時間経過とともに値がドリフト	ローリングウィンドウがリセットされていない	隠蔽バッファを伴う新しいバー検出を使用する
プロット開始位置がズレている	PLOT_DRAW_BEGIN が間違っている	underlying_warmup + own_warmup を計算する
配列インデックスが反転している	シリーズモード有効	ArraySetAsSeries(buffer, false) を呼び出す
バッファ値が正しくない	INDICATOR_DATA タイプが間違っている	隠蔽バッファに INDICATOR_CALCULATIONS を使用する
バッファのコンパイルエラー	バッファ数が一致していない	#property indicator_buffers を SetIndexBuffer と合わせる
インジケーターが更新されない	OnCalculate の戻り値が間違っている	rates_total を返して計算成功を通知する
パフォーマンスの問題	すべてのバーを再計算している	prev_calculated 以降のみを再計算する

---

リファレンスドキュメント

詳細情報は以下を参照してください:

• 表示スケール - 小さい値のインジケーターウィンドウ空白を修正
• バッファパターン - 表示および隠蔽バッファアーキテクチャ
• 再計算 - バー検出とローリングウィンドウ状態管理
• 完全なテンプレート - すべてのパターンを含む完全な動作例
• デバッグ - 表示問題のトラブルシューティングチェックリスト

実行後の振り返り

このスキルが完了したら、クローズ前に以下を確認してください:

1. コマンドは成功しましたか? — 成功していない場合は、失敗の原因となった命令またはエラーテーブルを修正してください。
2. パラメータまたは出力が変更されましたか? — 基盤となるツールのインターフェイスがドリフトした場合は、使用例とパラメータテーブルを更新して一致させてください。
3. ワークアラウンドが必要でしたか? — 即興で対応した場合 (異なるフラグ、追加ステップなど)、次の実行で同じワークアラウンドが必要にならないように SKILL.md を更新してください。

実際に再現可能な問題のみ更新してください — 推測ではなく。