【MQL5】ResourceReadImage関数について

bool  ResourceReadImage(
  const string      resource_name,       // 読まれるグラフィックリソース名
  uint&             data[],             // リソースからデータを受け取るための配列
  uint&             width,             // リソースの画像幅を受け取る
  uint&             height,             // リソースの画像の高さを受け取る
  );

//+------------------------------------------------------------------+
//| スクリプトプログラム開始関数                                      |
//+------------------------------------------------------------------+
void OnStart()
 {
  //--- グラフィックリソース名を指定する変数を定義
  //  rc_name は、後でリソースを作成し参照するために使用する名前
  string rc_name="Resource";  
  
  //--- リソース画像の幅を指定
  //  この例では、幅を100ピクセルに設定
  uint   rc_width=100;  
  
  //--- リソース画像の高さを指定
  //  この例では、高さを100ピクセルに設定
  uint   rc_height=100;
  
  //--- ピクセルデータを格納する配列を宣言
  //  グラフィックリソースの各ピクセルの色情報を保存するための配列
  uint   rc_data[];  
  
  //--- 画像全体のピクセル数を計算
  //  幅×高さの値を格納する。これが配列サイズの基準となる
  uint   rc_size=rc_width*rc_height; 
 
  //--- エラー情報をリセット
  //  以前のエラーコードをクリアすることで、新しいエラーが正確に検出できるようにする
  ResetLastError();
  
  //--- ピクセルデータ配列のサイズをリサイズ
  //  配列を画像サイズ（100x100ピクセル）にリサイズし、失敗した場合はエラーメッセージを出力
  if(ArrayResize(rc_data,rc_size)!=rc_size)
    {
    Print("ArrayResize() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- 配列全体を透明色(0x00FFFFFF)で初期化
  //  透明色で塗りつぶすことで、描画されるビットマップが最初は透明な状態になる
  ArrayInitialize(rc_data,0x00FFFFFF);
  
  //--- グラフィックリソースを作成
  //  指定した幅・高さ・色フォーマットでリソースを作成し、失敗した場合はエラーメッセージを出力
  if(!ResourceCreate(rc_name,rc_data,rc_width,rc_height,0,0,0,COLOR_FORMAT_ARGB_NORMALIZE))
    {
    Print("ResourceCreate() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- 作成されたリソース配列のサイズをエキスパートログに出力
  //  rc_data.Size()で配列のサイズを確認
  Print("Size of created recource array: ",rc_data.Size());
 
  //--- 現在のティックデータを取得
  //  シンボルの最新の価格データ（ティック）を取得し、取得に失敗した場合はエラーメッセージを出力
  MqlTick tick={};
  if(!SymbolInfoTick(Symbol(),tick))
    {
    Print("SymbolInfoTick() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- Bitmapオブジェクトを作成
  //  最後のティック価格と時刻を使用して、Bitmapオブジェクトを作成し、失敗時にはエラーメッセージを出力
  string obj_name="Bitmap";
  if(!ObjectCreate(0,obj_name,OBJ_BITMAP,0,tick.time,tick.bid))
    {
    Print("ObjectCreate() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- 作成されたビットマップオブジェクトの幅をリソースの幅に設定
  ObjectSetInteger(0,obj_name,OBJPROP_XSIZE,rc_width);
  
  //--- 作成されたビットマップオブジェクトの高さをリソースの高さに設定
  ObjectSetInteger(0,obj_name,OBJPROP_YSIZE,rc_height);
  
  //--- ビットマップオブジェクトのアンカーポイントを中央に設定
  //  オブジェクトの描画基準点を中央に配置する
  ObjectSetInteger(0,obj_name,OBJPROP_ANCHOR,ANCHOR_CENTER);
  
  //--- グラフィックリソースをオブジェクトに紐づける
  //  ここでリソース名を指定してオブジェクトに画像を適用する
  ObjectSetString(0,obj_name,OBJPROP_BMPFILE,"::"+rc_name);
 
  //--- DodgerBlue色を透明度200で設定
  //  ARGB形式で色を設定し、透明度を指定してピクセル配列全体に反映
  uint clr=ColorToARGB(clrDodgerBlue,200);
  ArrayInitialize(rc_data,clr);
  
  //--- グラフィックリソースのデータを更新し、チャートを再描画する
  //  Update関数で指定した色に基づき、リソースデータを再更新し、画面に描画
  Update(rc_name,rc_data,rc_width,rc_height,true);
 
  //--- 3秒間待機してからリソースを読み込む
  Print("Wait 3 seconds before ResourceReadImage()");
  Sleep(3000);
  
  //--- グラフィックリソースから新しいピクセル配列にデータを読み込む
  //  幅と高さを取得し、失敗した場合はエラーメッセージを出力
  uint rc_data_copy[];
  uint w=0, h=0;
  ResetLastError();
  if(!ResourceReadImage("::"+rc_name,rc_data_copy,w,h))
    {
    Print("ResourceReadImage() failed. Error code: ",GetLastError());
    return;
    }
 
  //--- OrangeRed色を透明度200で設定
  //  先ほど読み込んだピクセル配列全体をOrangeRed色で塗りつぶし、リソースを作成
  clr=ColorToARGB(clrOrangeRed,200);
  ArrayInitialize(rc_data_copy,clr);
  
  //--- 新しいグラフィックリソースを作成
  //  新しい名前でリソースを作成し、失敗した場合はエラーメッセージを出力
  if(!ResourceCreate(rc_name+"Copy",rc_data_copy,rc_width,rc_height,0,0,0,COLOR_FORMAT_ARGB_NORMALIZE))
    {
    Print("New ResourceCreate() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- 作成された新しいリソースの配列サイズをエキスパートログに出力
  Print("Size of created new recource array: ",rc_data_copy.Size());
 
  //--- グラフィックラベルオブジェクトを作成
  //  BitmapLabelオブジェクトを新しく作成し、失敗した場合はエラーメッセージを出力
  string obj_name2="BitmapLabel";
  if(!ObjectCreate(0,obj_name2,OBJ_BITMAP_LABEL,0,0,0))
    {
    Print("ObjectCreate() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- チャート上でティックの時刻と価格に基づいて画面座標を取得
  int x=0, y=0;
  if(!ChartTimePriceToXY(0,0,tick.time,tick.bid,x,y))
    {
    Print("ChartTimePriceToXY() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- グラフィックラベルオブジェクトの幅と高さを設定
  ObjectSetInteger(0,obj_name2,OBJPROP_XSIZE,rc_width);
  ObjectSetInteger(0,obj_name2,OBJPROP_YSIZE,rc_height);
  
  //--- オブジェクトのアンカーポイントを左上に設定
  ObjectSetInteger(0,obj_name2,OBJPROP_ANCHOR,ANCHOR_LEFT_UPPER);
  
  //--- オブジェクトのX座標とY座標の位置を設定
  ObjectSetInteger(0,obj_name2,OBJPROP_XDISTANCE,x);
  ObjectSetInteger(0,obj_name2,OBJPROP_YDISTANCE,y);
  
  //--- コピーされたグラフィックリソースをグラフィックラベルに適用
  ObjectSetString(0,obj_name2,OBJPROP_BMPFILE,"::"+rc_name+"Copy");
 
  //--- 3秒待機してからGreenYellow色に変更
  Print("Wait 3 seconds before changing color to GreenYellow");
  Sleep(3000);
  clr=ColorToARGB(clrGreenYellow,200);
  ArrayInitialize(rc_data_copy,clr);
  
  //--- グラフィックリソースのデータを再更新し、チャートを再描画
  Update(rc_name+"Copy",rc_data_copy,rc_width,rc_height,true);
 
  //--- リソースとオブジェクトを削除する前に3秒待機
  Print("Wait 3 seconds before deleting both objects");
  Sleep(3000);
  
  //--- 作成したリソースとオブジェクトを削除
  Print("Deleting Resource and all Bitmap objects");
  ResourceFree("::"+rc_name);
  ResourceFree("::"+rc_name+"Copy");
  ObjectDelete(0,obj_name);
  ObjectDelete(0,obj_name2);
 }
 
//+------------------------------------------------------------------+
//| グラフィックリソースデータを更新する関数                          |
//+------------------------------------------------------------------+
void Update(const string res_name,const uint &pixel_data[],const uint width,const uint height,const bool redraw)
 {
  //--- リソースの幅や高さがゼロの場合は処理を終了
  if(width==0 || height==0)
    return;
  
  //--- リソースデータを更新し、必要に応じてチャートを再描画する
  //  描画を更新し、ビジュアルに反映させる
  if(ResourceCreate(res_name,pixel_data,width,height,0,0,0,COLOR_FORMAT_ARGB_NORMALIZE) && redraw)
    ChartRedraw();
 }

//+------------------------------------------------------------------+
//| スクリプトプログラム開始関数                                      |
//+------------------------------------------------------------------+
void OnStart()
 {
  //--- グラフィックリソース名を指定する変数を定義
  //  rc_name は、後でリソースを作成し参照するために使用する名前
  string rc_name="Resource";  
  
  //--- リソース画像の幅を指定
  //  この例では、幅を100ピクセルに設定
  uint   rc_width=100;  
  
  //--- リソース画像の高さを指定
  //  この例では、高さを100ピクセルに設定
  uint   rc_height=100;
  
  //--- ピクセルデータを格納する配列を宣言
  //  グラフィックリソースの各ピクセルの色情報を保存するための配列
  uint   rc_data[];  
  
  //--- 画像全体のピクセル数を計算
  //  幅×高さの値を格納する。これが配列サイズの基準となる
  uint   rc_size=rc_width*rc_height; 
 
  //--- エラー情報をリセット
  //  以前のエラーコードをクリアすることで、新しいエラーが正確に検出できるようにする
  ResetLastError();

 //--- ピクセルデータ配列のサイズをリサイズ
  //  配列を画像サイズ（100x100ピクセル）にリサイズし、失敗した場合はエラーメッセージを出力
  if(ArrayResize(rc_data,rc_size)!=rc_size)
    {
    Print("ArrayResize() failed. Error code: ",GetLastError());
    return;
    }

  //--- 配列全体を透明色(0x00FFFFFF)で初期化
  //  透明色で塗りつぶすことで、描画されるビットマップが最初は透明な状態になる
  ArrayInitialize(rc_data,0x00FFFFFF);
  
  //--- グラフィックリソースを作成
  //  指定した幅・高さ・色フォーマットでリソースを作成し、失敗した場合はエラーメッセージを出力
  if(!ResourceCreate(rc_name,rc_data,rc_width,rc_height,0,0,0,COLOR_FORMAT_ARGB_NORMALIZE))
    {
    Print("ResourceCreate() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- 作成されたリソース配列のサイズをエキスパートログに出力
  //  rc_data.Size()で配列のサイズを確認
  Print("Size of created recource array: ",rc_data.Size());

//--- 現在のティックデータを取得
  //  シンボルの最新の価格データ（ティック）を取得し、取得に失敗した場合はエラーメッセージを出力
  MqlTick tick={};
  if(!SymbolInfoTick(Symbol(),tick))
    {
    Print("SymbolInfoTick() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- Bitmapオブジェクトを作成
  //  最後のティック価格と時刻を使用して、Bitmapオブジェクトを作成し、失敗時にはエラーメッセージを出力
  string obj_name="Bitmap";
  if(!ObjectCreate(0,obj_name,OBJ_BITMAP,0,tick.time,tick.bid))
    {
    Print("ObjectCreate() failed. Error code: ",GetLastError());
    return;
    }

 //--- 作成されたビットマップオブジェクトの幅をリソースの幅に設定
  ObjectSetInteger(0,obj_name,OBJPROP_XSIZE,rc_width);
  
  //--- 作成されたビットマップオブジェクトの高さをリソースの高さに設定
  ObjectSetInteger(0,obj_name,OBJPROP_YSIZE,rc_height);
  
  //--- ビットマップオブジェクトのアンカーポイントを中央に設定
  //  オブジェクトの描画基準点を中央に配置する
  ObjectSetInteger(0,obj_name,OBJPROP_ANCHOR,ANCHOR_CENTER);
  
  //--- グラフィックリソースをオブジェクトに紐づける
  //  ここでリソース名を指定してオブジェクトに画像を適用する
  ObjectSetString(0,obj_name,OBJPROP_BMPFILE,"::"+rc_name);

  //--- DodgerBlue色を透明度200で設定
  //  ARGB形式で色を設定し、透明度を指定してピクセル配列全体に反映
  uint clr=ColorToARGB(clrDodgerBlue,200);
  ArrayInitialize(rc_data,clr);
  
  //--- グラフィックリソースのデータを更新し、チャートを再描画する
  //  Update関数で指定した色に基づき、リソースデータを再更新し、画面に描画
  Update(rc_name,rc_data,rc_width,rc_height,true);
 
  //--- 3秒間待機してからリソースを読み込む
  Print("Wait 3 seconds before ResourceReadImage()");
  Sleep(3000);

 //--- グラフィックリソースから新しいピクセル配列にデータを読み込む
  //  幅と高さを取得し、失敗した場合はエラーメッセージを出力
  uint rc_data_copy[];
  uint w=0, h=0;
  ResetLastError();
  if(!ResourceReadImage("::"+rc_name,rc_data_copy,w,h))
    {
    Print("ResourceReadImage() failed. Error code: ",GetLastError());
    return;
    }
 
  //--- OrangeRed色を透明度200で設定
  //  先ほど読み込んだピクセル配列全体をOrangeRed色で塗りつぶし、リソースを作成
  clr=ColorToARGB(clrOrangeRed,200);
  ArrayInitialize(rc_data_copy,clr);

  //--- 新しいグラフィックリソースを作成
  //  新しい名前でリソースを作成し、失敗した場合はエラーメッセージを出力
  if(!ResourceCreate(rc_name+"Copy",rc_data_copy,rc_width,rc_height,0,0,0,COLOR_FORMAT_ARGB_NORMALIZE))
    {
    Print("New ResourceCreate() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- 作成された新しいリソースの配列サイズをエキスパートログに出力
  Print("Size of created new recource array: ",rc_data_copy.Size());
 
  //--- グラフィックラベルオブジェクトを作成
  //  BitmapLabelオブジェクトを新しく作成し、失敗した場合はエラーメッセージを出力
  string obj_name2="BitmapLabel";
  if(!ObjectCreate(0,obj_name2,OBJ_BITMAP_LABEL,0,0,0))
    {
    Print("ObjectCreate() failed. Error code: ",GetLastError());
    return;
    }

  //--- チャート上でティックの時刻と価格に基づいて画面座標を取得
  int x=0, y=0;
  if(!ChartTimePriceToXY(0,0,tick.time,tick.bid,x,y))
    {
    Print("ChartTimePriceToXY() failed. Error code: ",GetLastError());
    return;
    }
    
  //--- グラフィックラベルオブジェクトの幅と高さを設定
  ObjectSetInteger(0,obj_name2,OBJPROP_XSIZE,rc_width);
  ObjectSetInteger(0,obj_name2,OBJPROP_YSIZE,rc_height);
  
  //--- オブジェクトのアンカーポイントを左上に設定
  ObjectSetInteger(0,obj_name2,OBJPROP_ANCHOR,ANCHOR_LEFT_UPPER);
  
  //--- オブジェクトのX座標とY座標の位置を設定
  ObjectSetInteger(0,obj_name2,OBJPROP_XDISTANCE,x);
  ObjectSetInteger(0,obj_name2,OBJPROP_YDISTANCE,y);
  
  //--- コピーされたグラフィックリソースをグラフィックラベルに適用
  ObjectSetString(0,obj_name2,OBJPROP_BMPFILE,"::"+rc_name+"Copy");

 //--- 3秒待機してからGreenYellow色に変更
  Print("Wait 3 seconds before changing color to GreenYellow");
  Sleep(3000);
  clr=ColorToARGB(clrGreenYellow,200);
  ArrayInitialize(rc_data_copy,clr);
  
  //--- グラフィックリソースのデータを再更新し、チャートを再描画
  Update(rc_name+"Copy",rc_data_copy,rc_width,rc_height,true);
 
  //--- リソースとオブジェクトを削除する前に3秒待機
  Print("Wait 3 seconds before deleting both objects");
  Sleep(3000);
  
  //--- 作成したリソースとオブジェクトを削除
  Print("Deleting Resource and all Bitmap objects");
  ResourceFree("::"+rc_name);
  ResourceFree("::"+rc_name+"Copy");
  ObjectDelete(0,obj_name);
  ObjectDelete(0,obj_name2);
 }

//+------------------------------------------------------------------+
//| グラフィックリソースデータを更新する関数                          |
//+------------------------------------------------------------------+
void Update(const string res_name,const uint &pixel_data[],const uint width,const uint height,const bool redraw)
 {
  //--- リソースの幅や高さがゼロの場合は処理を終了
  if(width==0 || height==0)
    return;
  
  //--- リソースデータを更新し、必要に応じてチャートを再描画する
  //  描画を更新し、ビジュアルに反映させる
  if(ResourceCreate(res_name,pixel_data,width,height,0,0,0,COLOR_FORMAT_ARGB_NORMALIZE) && redraw)
    ChartRedraw();
 }