【MQL5】DXShaderInputsSet関数の使い方と自動売買実装コード

1. DXShaderInputsSet関数の概要と実務での活用法

DXShaderInputsSetは、MQL5でDirectXを用いた高度なグラフィックス描画を行う際、CPU（MQL5プログラム）からGPU（シェーダープログラム）へデータを渡すための関数です。具体的には、シェーダー（HLSL）内で定義された「定数バッファ」に、現在の価格データや色情報、時間といった変数を流し込む役割を担います。

実務開発において、通常のチャート描画（OBJ_CHART等）では表現できない数万ポイントのデータプロットや、ヒートマップのような複雑な視覚化を高速に行いたい場合にDirectXを利用します。その際、多くの開発者が「シェーダーに値を渡しても反映されない」という問題に直面します。これは、MQL5側の構造体とHLSL（シェーダー言語）側の構造体のメモリレイアウト（パディング）の不一致が原因であることがほとんどです。

この関数を正しく使いこなすことで、描画負荷をGPUにオフロードし、EAやインジケーターの動作を劇的に軽量化・高速化することが可能になります。

2. 構文と戻り値

DXShaderInputsSetの構文は以下の通りです。

bool  DXShaderInputsSet(
   int           shader_handle,    // シェーダーのハンドル
   const void&   inputs_data       // 入力データ（構造体）
   );

パラメーター

• shader_handle: DXShaderCreate関数で作成したシェーダーの有効なハンドルを指定します。
• inputs_data: シェーダーへ渡すデータが格納された構造体を渡します。この構造体の中身は、HLSLコード側で定義した「cbuffer（定数バッファ）」と一致している必要があります。

戻り値

• 成功した場合は true、失敗した場合は false を返します。失敗の理由は GetLastError() 関数で取得でき、主な原因はハンドルの無効化やデータサイズの不一致です。

3. 具体的な使い方・実践サンプルコード

以下は、シェーダーに「色」と「時間（オフセット）」の情報を渡し、背景色を動的に変化させるためのシンプルな実装例です。

// --- シェーダーへ渡す構造体の定義 (16バイトのアライメントに注意)
struct MyInputs
{
   float r, g, b, a;    // 色情報 (16バイト)
   float offset;        // 時間などのオフセット (4バイト)
   float reserved[3];   // 16バイト境界に合わせるためのパディング
};

// --- グローバル変数
int context = INVALID_HANDLE;
int shader  = INVALID_HANDLE;

int OnInit()
{
   // 1. DirectXコンテキストの作成
   context = DXContextCreate(800, 600);

   // 2. シェーダーの作成 (HLSLソースは事前に用意されている前提)
   string source = "cbuffer Config : register(b0) { float4 color; float offset; }; ...";
   shader = DXShaderCreate(context, DX_SHADER_PIXEL, source, "main");

   return(INIT_SUCCEEDED);
}

void OnTick()
{
   if(shader == INVALID_HANDLE) return;

   // 3. 渡すデータの準備
   MyInputs data;
   data.r = 1.0f; // 赤成分
   data.g = 0.5f; // 緑成分
   data.b = 0.0f; // 青成分
   data.a = 1.0f; // 不透明度
   data.offset = (float)GetTickCount() / 1000.0f; // 時間経過

   // 4. DXShaderInputsSetでGPUにデータを送信
   if(!DXShaderInputsSet(shader, data))
   {
      Print("データ送信失敗。エラーコード: ", GetLastError());
      return;
   }

   // この後、DXDraw等の描画関数を呼び出す
}

void OnDeinit(const int reason)
{
   // 5. リソースの解放
   DXRelease(shader);
   DXRelease(context);
}

4. 使用上の注意点とよくあるエラー

1. 16バイトアライメント（重要）:
   DirectXの定数バッファは、データを16バイト単位（float4相当）で管理します。MQL5側で定義する構造体のサイズが16バイトの倍数でない場合、データがズレたり、関数が失敗したりすることがあります。サンプルコードのように reserved 変数（パディング）を入れて調整するのが定石です。
2. 型の一致:
   MQL5の double 型は8バイトですが、HLSLの標準的な float は4バイトです。精度にこだわりがない限り、MQL5側でも float 型を使用して構造体を定義してください。
3. ハンドルのチェック:
   DXShaderInputsSet を呼び出す前に、必ずシェーダーハンドルが有効（INVALID_HANDLE ではない）であることを確認してください。ループ内で無効なハンドルにアクセスし続けると、プラットフォーム全体のパフォーマンス低下を招く恐れがあります。

5. 【重要】自動売買における約定スピードと環境の罠

クオンツエンジニアとして、高度な描画技術を習得すること以上に重要なのが「実行環境」の整備です。どんなに優れた描画アルゴリズムやシグナル判定を実装しても、自宅のPC環境からトレードを行うことは、プロの現場では致命的なリスクと見なされます。

家庭用インターネット回線やPCでは、OSのアップデートによる予期せぬ再起動や、プロバイダー起因のネットワーク遅延（レイテンシ）が避けられません。FXの自動売買において、ミリ秒単位の遅延はスリッページを増大させ、バックテストの結果とリアルの収益を乖離させる最大の要因となります。約定スピードを極限まで高め、物理的な距離による損失を防ぐには、取引サーバーの目と鼻の先に位置するデータセンター内のVPS（仮想専用サーバー）を利用することが不可欠です。安定した24時間の稼働環境と、一貫した低レイテンシを確保することこそが、エンジニアが最初に投資すべき「勝つためのインフラ」なのです。