使用环形缓冲区绘制OsCD指标的指南 - MetaTrader 5

描述

COsMAOnRingBuffer 类旨在使用环形缓冲区算法计算技术指标移动平均振荡器（Moving Average of Oscillator，简称OsMA）。

类的声明

class COsMAOnRingBuffer : public CArrayRing

文件引用

#include <IncOnRingBuffer\COsMAOnRingBuffer.mqh>

COsMAOnRingBuffer.mqh 文件应放置在 MQL5\Include\ IncOnRingBuffer 文件夹中。示例文件也附在该描述中。环形缓冲区、MACD 和移动平均类的文件也应位于此文件夹中。

类方法

//--- 初始化方法：bool Init(                                  // 如果出错返回 false，成功则返回 true
   int            fast_period   = 12,       // 快速移动平均平滑周期
   int            slow_period   = 26,       // 慢速移动平均平滑周期
   int            signal_period = 9,        // 信号移动平均平滑周期
   ENUM_MA_METHOD fast_method   = MODE_EMA, // 快速移动平均平滑方法
   ENUM_MA_METHOD slow_method   = MODE_EMA, // 慢速移动平均平滑方法
   ENUM_MA_METHOD signal_method = MODE_SMA, // 信号移动平均平滑方法
   int            size_buffer   = 256,      // 环形缓冲区大小，存储数据的数量
   bool           as_series     = false     // true 表示时间序列，false 表示常规索引输入数据
   );

//--- 基于时间序列或指标缓冲区的计算方法：int MainOnArray(                  // 返回处理的元素数量
   constint     rates_total,     // 数组的大小 array[]
   constint     prev_calculated, // 上一次调用处理的元素数量
   constdouble &array[]          // 输入值的数组
   );

//--- 基于数组的单独系列元素的计算方法double MainOnValue(              // 返回设定元素的 OsMA 值
   constint    rates_total,     // 数组的大小
   constint    prev_calculated, // 数组已经处理的元素
   constint    begin,           // 数组重要数据开始的位置
   constdouble value,           // 数组的重要元素
   constint    index            // 元素索引
   );

//--- 访问数据的方法：int    BarsRequired();   // 返回绘制指标所需的条形数量string Name()            // 返回指标名称string FastMethod()      // 返回快速线平滑方法的文字描述string SlowMethod()      // 返回慢速线平滑方法的文字描述string SignalMethod()    // 返回信号线平滑方法的文字描述int    FastPeriod()      // 返回快速线平滑周期int    SlowPeriod()      // 返回慢速线平滑周期int    SignalPeriod()      // 返回信号线平滑周期int    Size();           // 返回环形缓冲区的大小

从环形缓冲区获取计算出的指标数据与从普通数组中获取数据的方式相同。例如：

//--- 指标计算类 OsMA：#include <IncOnRingBuffer\COsMAOnRingBuffer.mqh>
COsMAOnRingBuffer osma;

...

//+------------------------------------------------------------------+//| 自定义指标迭代函数                              |//+------------------------------------------------------------------+intOnCalculate(constint    rates_total, 
                constint    prev_calculated, 
                constint    begin, 
                constdouble &price[]) 
  {
//--- 基于价格时间序列的指标计算：
   osma.MainOnArray(rates_total,prev_calculated,price);

...

//--- 使用“osma”环形缓冲区中的数据，//    将数据复制到指标缓冲区：
   for(int i=start;i<rates_total;i++)
      OsMABuffer[i]=osma[rates_total-1-i];          // 指标直方图//--- 返回下次调用的 prev_calculated 值：
   return(rates_total);
  }

请注意，环形缓冲区中的索引与时间序列中的索引相同。

示例

Test_OsMA_OnArrayRB.mq5 文件基于价格时间序列计算指标。演示了 MainOnArray() 方法的应用。
Test_OsMA_OnValueRB.mq5 文件展示了 MainOnValue() 方法的使用。首先计算并绘制 OsMA 指标。然后基于该指标的环形缓冲区绘制另一个 OsMA 指标。